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