Blame view

include/linux/kmod.h 3.88 KB
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
  #ifndef __LINUX_KMOD_H__
  #define __LINUX_KMOD_H__
  
  /*
   *	include/linux/kmod.h
   *
   *      This program is free software; you can redistribute it and/or modify
   *      it under the terms of the GNU General Public License as published by
   *      the Free Software Foundation; either version 2 of the License, or
   *      (at your option) any later version.
   *
   *      This program is distributed in the hope that it will be useful,
   *      but WITHOUT ANY WARRANTY; without even the implied warranty of
   *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   *      GNU General Public License for more details.
   *
   *      You should have received a copy of the GNU General Public License
   *      along with this program; if not, write to the Free Software
   *      Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
   */
ac331d158   KOSAKI Motohiro   call_usermodehelp...
21
  #include <linux/gfp.h>
7888e7ff4   David Howells   [PATCH] Keys: Pas...
22
  #include <linux/stddef.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
23
24
  #include <linux/errno.h>
  #include <linux/compiler.h>
a06a4dc3a   Neil Horman   kmod: add init fu...
25
  #include <linux/workqueue.h>
17f60a7da   Eric Paris   capabilites: allo...
26
  #include <linux/sysctl.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
27
28
  
  #define KMOD_PATH_LEN 256
a1ef5adb4   Johannes Berg   remove CONFIG_KMO...
29
  #ifdef CONFIG_MODULES
5ed109103   Dave Young   sysctl extern cle...
30
  extern char modprobe_path[]; /* for sysctl */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
31
32
  /* modprobe exit status on success, -ve on error.  Return value
   * usually useless though. */
b9075fa96   Joe Perches   treewide: use __p...
33
34
  extern __printf(2, 3)
  int __request_module(bool wait, const char *name, ...);
acae05156   Arjan van de Ven   module: create a ...
35
36
37
  #define request_module(mod...) __request_module(true, mod)
  #define request_module_nowait(mod...) __request_module(false, mod)
  #define try_then_request_module(x, mod...) \
97c18e2c7   Herbert Xu   module: try_then_...
38
  	((x) ?: (__request_module(true, mod), (x)))
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
39
  #else
acae05156   Arjan van de Ven   module: create a ...
40
41
  static inline int request_module(const char *name, ...) { return -ENOSYS; }
  static inline int request_module_nowait(const char *name, ...) { return -ENOSYS; }
df648c9fb   Johannes Berg   rework try_then_r...
42
  #define try_then_request_module(x, mod...) (x)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
43
  #endif
7888e7ff4   David Howells   [PATCH] Keys: Pas...
44

879669961   David Howells   KEYS/DNS: Fix ___...
45
  struct cred;
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
46
  struct file;
a06a4dc3a   Neil Horman   kmod: add init fu...
47
48
49
50
51
52
53
54
55
56
  
  enum umh_wait {
  	UMH_NO_WAIT = -1,	/* don't wait at all */
  	UMH_WAIT_EXEC = 0,	/* wait for the exec, but not the process */
  	UMH_WAIT_PROC = 1,	/* wait for the process to complete */
  };
  
  struct subprocess_info {
  	struct work_struct work;
  	struct completion *complete;
a06a4dc3a   Neil Horman   kmod: add init fu...
57
58
59
60
61
  	char *path;
  	char **argv;
  	char **envp;
  	enum umh_wait wait;
  	int retval;
879669961   David Howells   KEYS/DNS: Fix ___...
62
  	int (*init)(struct subprocess_info *info, struct cred *new);
a06a4dc3a   Neil Horman   kmod: add init fu...
63
64
65
  	void (*cleanup)(struct subprocess_info *info);
  	void *data;
  };
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
66
67
  
  /* Allocate a subprocess_info structure */
ac331d158   KOSAKI Motohiro   call_usermodehelp...
68
69
  struct subprocess_info *call_usermodehelper_setup(char *path, char **argv,
  						  char **envp, gfp_t gfp_mask);
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
70
71
  
  /* Set various pieces of state into the subprocess_info structure */
a06a4dc3a   Neil Horman   kmod: add init fu...
72
  void call_usermodehelper_setfns(struct subprocess_info *info,
879669961   David Howells   KEYS/DNS: Fix ___...
73
  		    int (*init)(struct subprocess_info *info, struct cred *new),
a06a4dc3a   Neil Horman   kmod: add init fu...
74
75
  		    void (*cleanup)(struct subprocess_info *info),
  		    void *data);
86313c488   Jeremy Fitzhardinge   usermodehelper: T...
76

0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
77
  /* Actually execute the sub-process */
86313c488   Jeremy Fitzhardinge   usermodehelper: T...
78
  int call_usermodehelper_exec(struct subprocess_info *info, enum umh_wait wait);
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
79
80
81
82
  
  /* Free the subprocess_info. This is only needed if you're not going
     to call call_usermodehelper_exec */
  void call_usermodehelper_freeinfo(struct subprocess_info *info);
7888e7ff4   David Howells   [PATCH] Keys: Pas...
83
84
  
  static inline int
a06a4dc3a   Neil Horman   kmod: add init fu...
85
86
  call_usermodehelper_fns(char *path, char **argv, char **envp,
  			enum umh_wait wait,
879669961   David Howells   KEYS/DNS: Fix ___...
87
  			int (*init)(struct subprocess_info *info, struct cred *new),
a06a4dc3a   Neil Horman   kmod: add init fu...
88
  			void (*cleanup)(struct subprocess_info *), void *data)
7888e7ff4   David Howells   [PATCH] Keys: Pas...
89
  {
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
90
  	struct subprocess_info *info;
ac331d158   KOSAKI Motohiro   call_usermodehelp...
91
  	gfp_t gfp_mask = (wait == UMH_NO_WAIT) ? GFP_ATOMIC : GFP_KERNEL;
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
92

ac331d158   KOSAKI Motohiro   call_usermodehelp...
93
  	info = call_usermodehelper_setup(path, argv, envp, gfp_mask);
a06a4dc3a   Neil Horman   kmod: add init fu...
94

0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
95
96
  	if (info == NULL)
  		return -ENOMEM;
a06a4dc3a   Neil Horman   kmod: add init fu...
97
98
  
  	call_usermodehelper_setfns(info, init, cleanup, data);
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
99
100
101
102
  	return call_usermodehelper_exec(info, wait);
  }
  
  static inline int
a06a4dc3a   Neil Horman   kmod: add init fu...
103
104
105
106
107
  call_usermodehelper(char *path, char **argv, char **envp, enum umh_wait wait)
  {
  	return call_usermodehelper_fns(path, argv, envp, wait,
  				       NULL, NULL, NULL);
  }
17f60a7da   Eric Paris   capabilites: allo...
108
  extern struct ctl_table usermodehelper_table[];
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
109
  extern void usermodehelper_init(void);
1bfcf1304   Rafael J. Wysocki   pm: rework disabl...
110
111
  extern int usermodehelper_disable(void);
  extern void usermodehelper_enable(void);
a144c6a6c   Rafael J. Wysocki   PM: Print a warni...
112
  extern bool usermodehelper_is_disabled(void);
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
113
114
  extern void read_lock_usermodehelper(void);
  extern void read_unlock_usermodehelper(void);
1bfcf1304   Rafael J. Wysocki   pm: rework disabl...
115

1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
116
  #endif /* __LINUX_KMOD_H__ */