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> | |
26 | ||
27 | #define KMOD_PATH_LEN 256 | |
28 | ||
a1ef5adb | 29 | #ifdef CONFIG_MODULES |
1da177e4 LT |
30 | /* modprobe exit status on success, -ve on error. Return value |
31 | * usually useless though. */ | |
acae0515 AV |
32 | extern int __request_module(bool wait, const char *name, ...) \ |
33 | __attribute__((format(printf, 2, 3))); | |
34 | #define request_module(mod...) __request_module(true, mod) | |
35 | #define request_module_nowait(mod...) __request_module(false, mod) | |
36 | #define try_then_request_module(x, mod...) \ | |
97c18e2c | 37 | ((x) ?: (__request_module(true, mod), (x))) |
1da177e4 | 38 | #else |
acae0515 AV |
39 | static inline int request_module(const char *name, ...) { return -ENOSYS; } |
40 | static inline int request_module_nowait(const char *name, ...) { return -ENOSYS; } | |
df648c9f | 41 | #define try_then_request_module(x, mod...) (x) |
1da177e4 LT |
42 | #endif |
43 | ||
7888e7ff DH |
44 | |
45 | struct key; | |
0ab4dc92 JF |
46 | struct file; |
47 | struct subprocess_info; | |
48 | ||
49 | /* Allocate a subprocess_info structure */ | |
ac331d15 KM |
50 | struct subprocess_info *call_usermodehelper_setup(char *path, char **argv, |
51 | char **envp, gfp_t gfp_mask); | |
0ab4dc92 JF |
52 | |
53 | /* Set various pieces of state into the subprocess_info structure */ | |
54 | void call_usermodehelper_setkeys(struct subprocess_info *info, | |
55 | struct key *session_keyring); | |
56 | int call_usermodehelper_stdinpipe(struct subprocess_info *sub_info, | |
57 | struct file **filp); | |
58 | void call_usermodehelper_setcleanup(struct subprocess_info *info, | |
59 | void (*cleanup)(char **argv, char **envp)); | |
60 | ||
86313c48 JF |
61 | enum umh_wait { |
62 | UMH_NO_WAIT = -1, /* don't wait at all */ | |
63 | UMH_WAIT_EXEC = 0, /* wait for the exec, but not the process */ | |
64 | UMH_WAIT_PROC = 1, /* wait for the process to complete */ | |
65 | }; | |
66 | ||
0ab4dc92 | 67 | /* Actually execute the sub-process */ |
86313c48 | 68 | int call_usermodehelper_exec(struct subprocess_info *info, enum umh_wait wait); |
0ab4dc92 JF |
69 | |
70 | /* Free the subprocess_info. This is only needed if you're not going | |
71 | to call call_usermodehelper_exec */ | |
72 | void call_usermodehelper_freeinfo(struct subprocess_info *info); | |
7888e7ff DH |
73 | |
74 | static inline int | |
86313c48 | 75 | call_usermodehelper(char *path, char **argv, char **envp, enum umh_wait wait) |
7888e7ff | 76 | { |
0ab4dc92 | 77 | struct subprocess_info *info; |
ac331d15 | 78 | gfp_t gfp_mask = (wait == UMH_NO_WAIT) ? GFP_ATOMIC : GFP_KERNEL; |
0ab4dc92 | 79 | |
ac331d15 | 80 | info = call_usermodehelper_setup(path, argv, envp, gfp_mask); |
0ab4dc92 JF |
81 | if (info == NULL) |
82 | return -ENOMEM; | |
83 | return call_usermodehelper_exec(info, wait); | |
84 | } | |
85 | ||
86 | static inline int | |
87 | call_usermodehelper_keys(char *path, char **argv, char **envp, | |
86313c48 | 88 | struct key *session_keyring, enum umh_wait wait) |
0ab4dc92 JF |
89 | { |
90 | struct subprocess_info *info; | |
ac331d15 | 91 | gfp_t gfp_mask = (wait == UMH_NO_WAIT) ? GFP_ATOMIC : GFP_KERNEL; |
0ab4dc92 | 92 | |
ac331d15 | 93 | info = call_usermodehelper_setup(path, argv, envp, gfp_mask); |
0ab4dc92 JF |
94 | if (info == NULL) |
95 | return -ENOMEM; | |
96 | ||
97 | call_usermodehelper_setkeys(info, session_keyring); | |
98 | return call_usermodehelper_exec(info, wait); | |
7888e7ff DH |
99 | } |
100 | ||
1da177e4 LT |
101 | extern void usermodehelper_init(void); |
102 | ||
e239ca54 AK |
103 | struct file; |
104 | extern int call_usermodehelper_pipe(char *path, char *argv[], char *envp[], | |
105 | struct file **filp); | |
106 | ||
1bfcf130 RW |
107 | extern int usermodehelper_disable(void); |
108 | extern void usermodehelper_enable(void); | |
109 | ||
1da177e4 | 110 | #endif /* __LINUX_KMOD_H__ */ |