Blame view

kernel/kmod.c 19.2 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
  /*
  	kmod, the new module loader (replaces kerneld)
  	Kirk Petersen
  
  	Reorganized not to be a daemon by Adam Richter, with guidance
  	from Greg Zornetzer.
  
  	Modified to avoid chroot and file sharing problems.
  	Mikael Pettersson
  
  	Limit the concurrent number of kmod modprobes to catch loops from
  	"modprobe needs a service that is in a module".
  	Keith Owens <kaos@ocs.com.au> December 1999
  
  	Unblock all signals when we exec a usermode process.
  	Shuu Yamaguchi <shuu@wondernetworkresources.com> December 2000
  
  	call_usermodehelper wait flag, and remove exec_usermodehelper.
  	Rusty Russell <rusty@rustcorp.com.au>  Jan 2003
  */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
21
22
23
24
25
  #include <linux/module.h>
  #include <linux/sched.h>
  #include <linux/syscalls.h>
  #include <linux/unistd.h>
  #include <linux/kmod.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
26
  #include <linux/slab.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
27
  #include <linux/completion.h>
17f60a7da   Eric Paris   capabilites: allo...
28
  #include <linux/cred.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
29
  #include <linux/file.h>
9f3acc314   Al Viro   [PATCH] split lin...
30
  #include <linux/fdtable.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
31
32
33
34
35
  #include <linux/workqueue.h>
  #include <linux/security.h>
  #include <linux/mount.h>
  #include <linux/kernel.h>
  #include <linux/init.h>
d025c9db7   Andi Kleen   [PATCH] Support p...
36
  #include <linux/resource.h>
8cdd4936c   Rafael J. Wysocki   PM: disable userm...
37
38
  #include <linux/notifier.h>
  #include <linux/suspend.h>
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
39
  #include <linux/rwsem.h>
a74fb73c1   Al Viro   infrastructure fo...
40
  #include <linux/ptrace.h>
0fdff3ec6   Tejun Heo   async, kmod: warn...
41
  #include <linux/async.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
42
  #include <asm/uaccess.h>
7ead8b831   Li Zefan   tracing/events: A...
43
  #include <trace/events/module.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
44
45
46
  extern int max_threads;
  
  static struct workqueue_struct *khelper_wq;
0f20784d4   Tetsuo Handa   kmod: avoid deadl...
47
48
49
50
51
52
  /*
   * kmod_thread_locker is used for deadlock avoidance.  There is no explicit
   * locking to protect this global - it is private to the singleton khelper
   * thread and should only ever be modified by that thread.
   */
  static const struct task_struct *kmod_thread_locker;
17f60a7da   Eric Paris   capabilites: allo...
53
54
55
56
57
58
  #define CAP_BSET	(void *)1
  #define CAP_PI		(void *)2
  
  static kernel_cap_t usermodehelper_bset = CAP_FULL_SET;
  static kernel_cap_t usermodehelper_inheritable = CAP_FULL_SET;
  static DEFINE_SPINLOCK(umh_sysctl_lock);
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
59
  static DECLARE_RWSEM(umhelper_sem);
17f60a7da   Eric Paris   capabilites: allo...
60

a1ef5adb4   Johannes Berg   remove CONFIG_KMO...
61
  #ifdef CONFIG_MODULES
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
62
63
64
65
66
  
  /*
  	modprobe_path is set via /proc/sys.
  */
  char modprobe_path[KMOD_PATH_LEN] = "/sbin/modprobe";
1cc684ab7   Oleg Nesterov   kmod: make __requ...
67
68
69
70
71
  static void free_modprobe_argv(struct subprocess_info *info)
  {
  	kfree(info->argv[3]); /* check call_modprobe() */
  	kfree(info->argv);
  }
3e63a93b9   Oleg Nesterov   kmod: introduce c...
72
73
74
75
76
77
78
79
  static int call_modprobe(char *module_name, int wait)
  {
  	static char *envp[] = {
  		"HOME=/",
  		"TERM=linux",
  		"PATH=/sbin:/usr/sbin:/bin:/usr/bin",
  		NULL
  	};
1cc684ab7   Oleg Nesterov   kmod: make __requ...
80
81
82
83
84
85
86
87
88
89
90
91
92
  	char **argv = kmalloc(sizeof(char *[5]), GFP_KERNEL);
  	if (!argv)
  		goto out;
  
  	module_name = kstrdup(module_name, GFP_KERNEL);
  	if (!module_name)
  		goto free_argv;
  
  	argv[0] = modprobe_path;
  	argv[1] = "-q";
  	argv[2] = "--";
  	argv[3] = module_name;	/* check free_modprobe_argv() */
  	argv[4] = NULL;
3e63a93b9   Oleg Nesterov   kmod: introduce c...
93
94
  
  	return call_usermodehelper_fns(modprobe_path, argv, envp,
1cc684ab7   Oleg Nesterov   kmod: make __requ...
95
96
97
98
99
  		wait | UMH_KILLABLE, NULL, free_modprobe_argv, NULL);
  free_argv:
  	kfree(argv);
  out:
  	return -ENOMEM;
3e63a93b9   Oleg Nesterov   kmod: introduce c...
100
  }
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
101
  /**
acae05156   Arjan van de Ven   module: create a ...
102
103
   * __request_module - try to load a kernel module
   * @wait: wait (or not) for the operation to complete
bd4207c90   Randy Dunlap   kmod: fix varargs...
104
105
   * @fmt: printf style format string for the name of the module
   * @...: arguments as specified in the format string
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
106
107
108
109
110
111
112
113
114
115
   *
   * Load a module using the user mode module loader. The function returns
   * zero on success or a negative errno code on failure. Note that a
   * successful module load does not mean the module did not then unload
   * and exit on an error of its own. Callers must check that the service
   * they requested is now available not blindly invoke it.
   *
   * If module auto-loading support is disabled then this function
   * becomes a no-operation.
   */
acae05156   Arjan van de Ven   module: create a ...
116
  int __request_module(bool wait, const char *fmt, ...)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
117
118
119
120
121
  {
  	va_list args;
  	char module_name[MODULE_NAME_LEN];
  	unsigned int max_modprobes;
  	int ret;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
122
123
124
  	static atomic_t kmod_concurrent = ATOMIC_INIT(0);
  #define MAX_KMOD_CONCURRENT 50	/* Completely arbitrary value - KAO */
  	static int kmod_loop_msg;
0fdff3ec6   Tejun Heo   async, kmod: warn...
125
126
127
128
129
130
131
  	/*
  	 * We don't allow synchronous module loading from async.  Module
  	 * init may invoke async_synchronize_full() which will end up
  	 * waiting for this task which already is waiting for the module
  	 * loading to complete, leading to a deadlock.
  	 */
  	WARN_ON_ONCE(wait && current_is_async());
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
132
133
134
135
136
  	va_start(args, fmt);
  	ret = vsnprintf(module_name, MODULE_NAME_LEN, fmt, args);
  	va_end(args);
  	if (ret >= MODULE_NAME_LEN)
  		return -ENAMETOOLONG;
dd8dbf2e6   Eric Paris   security: report ...
137
138
139
  	ret = security_kernel_module_request(module_name);
  	if (ret)
  		return ret;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
  	/* If modprobe needs a service that is in a module, we get a recursive
  	 * loop.  Limit the number of running kmod threads to max_threads/2 or
  	 * MAX_KMOD_CONCURRENT, whichever is the smaller.  A cleaner method
  	 * would be to run the parents of this process, counting how many times
  	 * kmod was invoked.  That would mean accessing the internals of the
  	 * process tables to get the command line, proc_pid_cmdline is static
  	 * and it is not worth changing the proc code just to handle this case. 
  	 * KAO.
  	 *
  	 * "trace the ppid" is simple, but will fail if someone's
  	 * parent exits.  I think this is as good as it gets. --RR
  	 */
  	max_modprobes = min(max_threads/2, MAX_KMOD_CONCURRENT);
  	atomic_inc(&kmod_concurrent);
  	if (atomic_read(&kmod_concurrent) > max_modprobes) {
  		/* We may be blaming an innocent here, but unlikely */
37252db6a   Jiri Kosina   kmod: prevent kmo...
156
  		if (kmod_loop_msg < 5) {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
157
158
159
160
  			printk(KERN_ERR
  			       "request_module: runaway loop modprobe %s
  ",
  			       module_name);
37252db6a   Jiri Kosina   kmod: prevent kmo...
161
162
  			kmod_loop_msg++;
  		}
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
163
164
165
  		atomic_dec(&kmod_concurrent);
  		return -ENOMEM;
  	}
7ead8b831   Li Zefan   tracing/events: A...
166
  	trace_module_request(module_name, wait, _RET_IP_);
3e63a93b9   Oleg Nesterov   kmod: introduce c...
167
  	ret = call_modprobe(module_name, wait ? UMH_WAIT_PROC : UMH_WAIT_EXEC);
a06a4dc3a   Neil Horman   kmod: add init fu...
168

1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
169
170
171
  	atomic_dec(&kmod_concurrent);
  	return ret;
  }
acae05156   Arjan van de Ven   module: create a ...
172
  EXPORT_SYMBOL(__request_module);
118a9069f   Rusty Russell   module: remove CO...
173
  #endif /* CONFIG_MODULES */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
174

1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
175
176
177
178
179
180
  /*
   * This is the task which runs the usermode application
   */
  static int ____call_usermodehelper(void *data)
  {
  	struct subprocess_info *sub_info = data;
17f60a7da   Eric Paris   capabilites: allo...
181
  	struct cred *new;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
182
  	int retval;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
183
184
  	spin_lock_irq(&current->sighand->siglock);
  	flush_signal_handlers(current, 1);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
185
186
187
  	spin_unlock_irq(&current->sighand->siglock);
  
  	/* We can run anywhere, unlike our parent keventd(). */
1a2142afa   Rusty Russell   cpumask: remove d...
188
  	set_cpus_allowed_ptr(current, cpu_all_mask);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
189

b73a7e76c   Jan Engelhardt   Fix kevent's chil...
190
191
192
193
194
  	/*
  	 * Our parent is keventd, which runs with elevated scheduling priority.
  	 * Avoid propagating that into the userspace child.
  	 */
  	set_user_nice(current, 0);
17f60a7da   Eric Paris   capabilites: allo...
195
196
197
198
199
200
201
202
203
204
  	retval = -ENOMEM;
  	new = prepare_kernel_cred(current);
  	if (!new)
  		goto fail;
  
  	spin_lock(&umh_sysctl_lock);
  	new->cap_bset = cap_intersect(usermodehelper_bset, new->cap_bset);
  	new->cap_inheritable = cap_intersect(usermodehelper_inheritable,
  					     new->cap_inheritable);
  	spin_unlock(&umh_sysctl_lock);
879669961   David Howells   KEYS/DNS: Fix ___...
205
206
207
208
209
210
211
  	if (sub_info->init) {
  		retval = sub_info->init(sub_info, new);
  		if (retval) {
  			abort_creds(new);
  			goto fail;
  		}
  	}
17f60a7da   Eric Paris   capabilites: allo...
212
  	commit_creds(new);
ae903caae   Al Viro   Bury the conditio...
213
214
215
  	retval = do_execve(sub_info->path,
  			   (const char __user *const __user *)sub_info->argv,
  			   (const char __user *const __user *)sub_info->envp);
a74fb73c1   Al Viro   infrastructure fo...
216
217
  	if (!retval)
  		return 0;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
218
219
  
  	/* Exec failed? */
a06a4dc3a   Neil Horman   kmod: add init fu...
220
  fail:
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
221
  	sub_info->retval = retval;
fb45550d7   Al Viro   make sure that ke...
222
  	do_exit(0);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
223
  }
0f20784d4   Tetsuo Handa   kmod: avoid deadl...
224
225
226
227
228
229
  static int call_helper(void *data)
  {
  	/* Worker thread started blocking khelper thread. */
  	kmod_thread_locker = current;
  	return ____call_usermodehelper(data);
  }
ae3cef730   Boaz Harrosh   kmod: unexport ca...
230
  static void call_usermodehelper_freeinfo(struct subprocess_info *info)
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
231
232
  {
  	if (info->cleanup)
a06a4dc3a   Neil Horman   kmod: add init fu...
233
  		(*info->cleanup)(info);
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
234
235
  	kfree(info);
  }
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
236

b34499225   Oleg Nesterov   usermodehelper: i...
237
238
  static void umh_complete(struct subprocess_info *sub_info)
  {
d0bd587a8   Oleg Nesterov   usermodehelper: i...
239
240
241
242
243
244
245
246
247
  	struct completion *comp = xchg(&sub_info->complete, NULL);
  	/*
  	 * See call_usermodehelper_exec(). If xchg() returns NULL
  	 * we own sub_info, the UMH_KILLABLE caller has gone away.
  	 */
  	if (comp)
  		complete(comp);
  	else
  		call_usermodehelper_freeinfo(sub_info);
b34499225   Oleg Nesterov   usermodehelper: i...
248
  }
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
249
250
251
252
253
  /* Keventd can't block, but this (a child) can. */
  static int wait_for_helper(void *data)
  {
  	struct subprocess_info *sub_info = data;
  	pid_t pid;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
254

7d6422421   Oleg Nesterov   wait_for_helper: ...
255
256
257
258
  	/* If SIGCLD is ignored sys_wait4 won't populate the status. */
  	spin_lock_irq(&current->sighand->siglock);
  	current->sighand->action[SIGCHLD-1].sa.sa_handler = SIG_DFL;
  	spin_unlock_irq(&current->sighand->siglock);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
259
260
261
262
263
  
  	pid = kernel_thread(____call_usermodehelper, sub_info, SIGCHLD);
  	if (pid < 0) {
  		sub_info->retval = pid;
  	} else {
7d6422421   Oleg Nesterov   wait_for_helper: ...
264
  		int ret = -ECHILD;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
265
266
267
268
269
270
271
272
273
  		/*
  		 * Normally it is bogus to call wait4() from in-kernel because
  		 * wait4() wants to write the exit code to a userspace address.
  		 * But wait_for_helper() always runs as keventd, and put_user()
  		 * to a kernel address works OK for kernel threads, due to their
  		 * having an mm_segment_t which spans the entire address space.
  		 *
  		 * Thus the __user pointer cast is valid here.
  		 */
111dbe0c8   Björn Steinbrink   [PATCH] Fix ____c...
274
275
276
277
278
279
280
281
282
  		sys_wait4(pid, (int __user *)&ret, 0, NULL);
  
  		/*
  		 * If ret is 0, either ____call_usermodehelper failed and the
  		 * real error code is already in sub_info->retval or
  		 * sub_info->retval is 0 anyway, so don't mess with it then.
  		 */
  		if (ret)
  			sub_info->retval = ret;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
283
  	}
b34499225   Oleg Nesterov   usermodehelper: i...
284
  	umh_complete(sub_info);
fb45550d7   Al Viro   make sure that ke...
285
  	do_exit(0);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
286
287
288
  }
  
  /* This is run by khelper thread  */
65f27f384   David Howells   WorkStruct: Pass ...
289
  static void __call_usermodehelper(struct work_struct *work)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
290
  {
65f27f384   David Howells   WorkStruct: Pass ...
291
292
  	struct subprocess_info *sub_info =
  		container_of(work, struct subprocess_info, work);
9d944ef32   Oleg Nesterov   usermodehelper: k...
293
  	int wait = sub_info->wait & ~UMH_KILLABLE;
d47419cd9   Oleg Nesterov   call_usermodehelp...
294
  	pid_t pid;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
295
296
297
298
  
  	/* CLONE_VFORK: wait until the usermode helper has execve'd
  	 * successfully We need the data structures to stay around
  	 * until that is done.  */
d47419cd9   Oleg Nesterov   call_usermodehelp...
299
  	if (wait == UMH_WAIT_PROC)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
300
301
  		pid = kernel_thread(wait_for_helper, sub_info,
  				    CLONE_FS | CLONE_FILES | SIGCHLD);
0f20784d4   Tetsuo Handa   kmod: avoid deadl...
302
303
  	else {
  		pid = kernel_thread(call_helper, sub_info,
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
304
  				    CLONE_VFORK | SIGCHLD);
0f20784d4   Tetsuo Handa   kmod: avoid deadl...
305
306
307
  		/* Worker thread stopped blocking khelper thread. */
  		kmod_thread_locker = NULL;
  	}
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
308

86313c488   Jeremy Fitzhardinge   usermodehelper: T...
309
310
  	switch (wait) {
  	case UMH_NO_WAIT:
d47419cd9   Oleg Nesterov   call_usermodehelp...
311
  		call_usermodehelper_freeinfo(sub_info);
86313c488   Jeremy Fitzhardinge   usermodehelper: T...
312
  		break;
a98f0dd34   Andi Kleen   [PATCH] x86-64: A...
313

86313c488   Jeremy Fitzhardinge   usermodehelper: T...
314
315
316
  	case UMH_WAIT_PROC:
  		if (pid > 0)
  			break;
86313c488   Jeremy Fitzhardinge   usermodehelper: T...
317
  		/* FALLTHROUGH */
86313c488   Jeremy Fitzhardinge   usermodehelper: T...
318
  	case UMH_WAIT_EXEC:
04b1c384f   Oleg Nesterov   call_usermodehelp...
319
320
  		if (pid < 0)
  			sub_info->retval = pid;
b34499225   Oleg Nesterov   usermodehelper: i...
321
  		umh_complete(sub_info);
86313c488   Jeremy Fitzhardinge   usermodehelper: T...
322
  	}
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
323
  }
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
324
325
326
327
  /*
   * If set, call_usermodehelper_exec() will exit immediately returning -EBUSY
   * (used for preventing user land processes from being created after the user
   * land has been frozen during a system-wide hibernation or suspend operation).
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
328
   * Should always be manipulated under umhelper_sem acquired for write.
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
329
   */
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
330
  static enum umh_disable_depth usermodehelper_disabled = UMH_DISABLED;
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
331
332
333
334
335
  
  /* Number of helpers running */
  static atomic_t running_helpers = ATOMIC_INIT(0);
  
  /*
5307427a3   Srivatsa S. Bhat   PM / Usermodehelp...
336
   * Wait queue head used by usermodehelper_disable() to wait for all running
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
337
338
339
340
341
   * helpers to finish.
   */
  static DECLARE_WAIT_QUEUE_HEAD(running_helpers_waitq);
  
  /*
9b78c1da6   Rafael J. Wysocki   firmware_class: D...
342
343
344
345
346
347
   * Used by usermodehelper_read_lock_wait() to wait for usermodehelper_disabled
   * to become 'false'.
   */
  static DECLARE_WAIT_QUEUE_HEAD(usermodehelper_disabled_waitq);
  
  /*
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
348
   * Time to wait for running_helpers to become zero before the setting of
5307427a3   Srivatsa S. Bhat   PM / Usermodehelp...
349
   * usermodehelper_disabled in usermodehelper_disable() fails
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
350
351
   */
  #define RUNNING_HELPERS_TIMEOUT	(5 * HZ)
fe2e39d87   Rafael J. Wysocki   firmware_class: R...
352
  int usermodehelper_read_trylock(void)
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
353
  {
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
354
  	DEFINE_WAIT(wait);
fe2e39d87   Rafael J. Wysocki   firmware_class: R...
355
  	int ret = 0;
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
356
  	down_read(&umhelper_sem);
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
357
358
359
360
361
362
363
364
  	for (;;) {
  		prepare_to_wait(&usermodehelper_disabled_waitq, &wait,
  				TASK_INTERRUPTIBLE);
  		if (!usermodehelper_disabled)
  			break;
  
  		if (usermodehelper_disabled == UMH_DISABLED)
  			ret = -EAGAIN;
fe2e39d87   Rafael J. Wysocki   firmware_class: R...
365
  		up_read(&umhelper_sem);
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
366
367
368
369
370
371
372
373
  
  		if (ret)
  			break;
  
  		schedule();
  		try_to_freeze();
  
  		down_read(&umhelper_sem);
fe2e39d87   Rafael J. Wysocki   firmware_class: R...
374
  	}
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
375
  	finish_wait(&usermodehelper_disabled_waitq, &wait);
fe2e39d87   Rafael J. Wysocki   firmware_class: R...
376
  	return ret;
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
377
  }
fe2e39d87   Rafael J. Wysocki   firmware_class: R...
378
  EXPORT_SYMBOL_GPL(usermodehelper_read_trylock);
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
379

9b78c1da6   Rafael J. Wysocki   firmware_class: D...
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
  long usermodehelper_read_lock_wait(long timeout)
  {
  	DEFINE_WAIT(wait);
  
  	if (timeout < 0)
  		return -EINVAL;
  
  	down_read(&umhelper_sem);
  	for (;;) {
  		prepare_to_wait(&usermodehelper_disabled_waitq, &wait,
  				TASK_UNINTERRUPTIBLE);
  		if (!usermodehelper_disabled)
  			break;
  
  		up_read(&umhelper_sem);
  
  		timeout = schedule_timeout(timeout);
  		if (!timeout)
  			break;
  
  		down_read(&umhelper_sem);
  	}
  	finish_wait(&usermodehelper_disabled_waitq, &wait);
  	return timeout;
  }
  EXPORT_SYMBOL_GPL(usermodehelper_read_lock_wait);
fe2e39d87   Rafael J. Wysocki   firmware_class: R...
406
  void usermodehelper_read_unlock(void)
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
407
408
409
  {
  	up_read(&umhelper_sem);
  }
fe2e39d87   Rafael J. Wysocki   firmware_class: R...
410
  EXPORT_SYMBOL_GPL(usermodehelper_read_unlock);
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
411

1bfcf1304   Rafael J. Wysocki   pm: rework disabl...
412
  /**
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
413
   * __usermodehelper_set_disable_depth - Modify usermodehelper_disabled.
9b3c98cd6   Randy Dunlap   kmod.c: fix kerne...
414
   * @depth: New value to assign to usermodehelper_disabled.
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
415
416
417
   *
   * Change the value of usermodehelper_disabled (under umhelper_sem locked for
   * writing) and wakeup tasks waiting for it to change.
9b78c1da6   Rafael J. Wysocki   firmware_class: D...
418
   */
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
419
  void __usermodehelper_set_disable_depth(enum umh_disable_depth depth)
9b78c1da6   Rafael J. Wysocki   firmware_class: D...
420
421
  {
  	down_write(&umhelper_sem);
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
422
  	usermodehelper_disabled = depth;
9b78c1da6   Rafael J. Wysocki   firmware_class: D...
423
424
425
426
427
  	wake_up(&usermodehelper_disabled_waitq);
  	up_write(&umhelper_sem);
  }
  
  /**
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
428
429
430
431
   * __usermodehelper_disable - Prevent new helpers from being started.
   * @depth: New value to assign to usermodehelper_disabled.
   *
   * Set usermodehelper_disabled to @depth and wait for running helpers to exit.
1bfcf1304   Rafael J. Wysocki   pm: rework disabl...
432
   */
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
433
  int __usermodehelper_disable(enum umh_disable_depth depth)
8cdd4936c   Rafael J. Wysocki   PM: disable userm...
434
  {
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
435
  	long retval;
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
436
437
  	if (!depth)
  		return -EINVAL;
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
438
  	down_write(&umhelper_sem);
247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
439
  	usermodehelper_disabled = depth;
b298d289c   Srivatsa S. Bhat   PM / Sleep: Fix f...
440
  	up_write(&umhelper_sem);
1bfcf1304   Rafael J. Wysocki   pm: rework disabl...
441
442
443
444
445
446
447
  	/*
  	 * From now on call_usermodehelper_exec() won't start any new
  	 * helpers, so it is sufficient if running_helpers turns out to
  	 * be zero at one point (it may be increased later, but that
  	 * doesn't matter).
  	 */
  	retval = wait_event_timeout(running_helpers_waitq,
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
448
449
  					atomic_read(&running_helpers) == 0,
  					RUNNING_HELPERS_TIMEOUT);
1bfcf1304   Rafael J. Wysocki   pm: rework disabl...
450
451
  	if (retval)
  		return 0;
8cdd4936c   Rafael J. Wysocki   PM: disable userm...
452

247bc0374   Rafael J. Wysocki   PM / Sleep: Mitig...
453
  	__usermodehelper_set_disable_depth(UMH_ENABLED);
1bfcf1304   Rafael J. Wysocki   pm: rework disabl...
454
455
  	return -EAGAIN;
  }
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
456
457
458
459
460
461
462
463
464
465
466
  static void helper_lock(void)
  {
  	atomic_inc(&running_helpers);
  	smp_mb__after_atomic_inc();
  }
  
  static void helper_unlock(void)
  {
  	if (atomic_dec_and_test(&running_helpers))
  		wake_up(&running_helpers_waitq);
  }
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
467

1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
468
  /**
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
469
   * call_usermodehelper_setup - prepare to call a usermode helper
61df47c8d   Randy Dunlap   kernel-doc fix fo...
470
471
472
   * @path: path to usermode executable
   * @argv: arg vector for process
   * @envp: environment for process
ac331d158   KOSAKI Motohiro   call_usermodehelp...
473
   * @gfp_mask: gfp mask for memory allocation
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
474
   *
61df47c8d   Randy Dunlap   kernel-doc fix fo...
475
   * Returns either %NULL on allocation failure, or a subprocess_info
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
476
477
478
   * structure.  This should be passed to call_usermodehelper_exec to
   * exec the process and free the structure.
   */
785042f2e   Boaz Harrosh   kmod: move call_u...
479
  static
ac331d158   KOSAKI Motohiro   call_usermodehelp...
480
481
  struct subprocess_info *call_usermodehelper_setup(char *path, char **argv,
  						  char **envp, gfp_t gfp_mask)
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
482
483
  {
  	struct subprocess_info *sub_info;
ac331d158   KOSAKI Motohiro   call_usermodehelp...
484
  	sub_info = kzalloc(sizeof(struct subprocess_info), gfp_mask);
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
485
486
487
488
489
490
491
  	if (!sub_info)
  		goto out;
  
  	INIT_WORK(&sub_info->work, __call_usermodehelper);
  	sub_info->path = path;
  	sub_info->argv = argv;
  	sub_info->envp = envp;
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
492
493
494
    out:
  	return sub_info;
  }
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
495
496
  
  /**
a06a4dc3a   Neil Horman   kmod: add init fu...
497
   * call_usermodehelper_setfns - set a cleanup/init function
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
498
499
   * @info: a subprocess_info returned by call_usermodehelper_setup
   * @cleanup: a cleanup function
a06a4dc3a   Neil Horman   kmod: add init fu...
500
501
502
503
504
505
   * @init: an init function
   * @data: arbitrary context sensitive data
   *
   * The init function is used to customize the helper process prior to
   * exec.  A non-zero return code causes the process to error out, exit,
   * and return the failure to the calling process
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
506
   *
a06a4dc3a   Neil Horman   kmod: add init fu...
507
   * The cleanup function is just before ethe subprocess_info is about to
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
508
509
510
511
   * be freed.  This can be used for freeing the argv and envp.  The
   * Function must be runnable in either a process context or the
   * context in which call_usermodehelper_exec is called.
   */
785042f2e   Boaz Harrosh   kmod: move call_u...
512
  static
a06a4dc3a   Neil Horman   kmod: add init fu...
513
  void call_usermodehelper_setfns(struct subprocess_info *info,
879669961   David Howells   KEYS/DNS: Fix ___...
514
  		    int (*init)(struct subprocess_info *info, struct cred *new),
a06a4dc3a   Neil Horman   kmod: add init fu...
515
516
  		    void (*cleanup)(struct subprocess_info *info),
  		    void *data)
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
517
518
  {
  	info->cleanup = cleanup;
a06a4dc3a   Neil Horman   kmod: add init fu...
519
520
  	info->init = init;
  	info->data = data;
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
521
  }
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
522
523
  
  /**
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
524
525
   * call_usermodehelper_exec - start a usermode application
   * @sub_info: information about the subprocessa
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
526
   * @wait: wait for the application to finish and return status.
a98f0dd34   Andi Kleen   [PATCH] x86-64: A...
527
528
529
   *        when -1 don't wait at all, but you get no useful error back when
   *        the program couldn't be exec'ed. This makes it safe to call
   *        from interrupt context.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
530
531
532
533
   *
   * Runs a user-space application.  The application is started
   * asynchronously if wait is not set, and runs as a child of keventd.
   * (ie. it runs with full root capabilities).
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
534
   */
785042f2e   Boaz Harrosh   kmod: move call_u...
535
  static
9d944ef32   Oleg Nesterov   usermodehelper: k...
536
  int call_usermodehelper_exec(struct subprocess_info *sub_info, int wait)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
537
  {
60be6b9a4   Ingo Molnar   [PATCH] lockdep: ...
538
  	DECLARE_COMPLETION_ONSTACK(done);
784680336   Nigel Cunningham   Fix unbalanced he...
539
  	int retval = 0;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
540

ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
541
  	helper_lock();
784680336   Nigel Cunningham   Fix unbalanced he...
542
  	if (sub_info->path[0] == '\0')
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
543
  		goto out;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
544

8cdd4936c   Rafael J. Wysocki   PM: disable userm...
545
  	if (!khelper_wq || usermodehelper_disabled) {
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
546
547
548
  		retval = -EBUSY;
  		goto out;
  	}
0f20784d4   Tetsuo Handa   kmod: avoid deadl...
549
550
551
552
553
554
555
556
557
558
  	/*
  	 * Worker thread must not wait for khelper thread at below
  	 * wait_for_completion() if the thread was created with CLONE_VFORK
  	 * flag, for khelper thread is already waiting for the thread at
  	 * wait_for_completion() in do_fork().
  	 */
  	if (wait != UMH_NO_WAIT && current == kmod_thread_locker) {
  		retval = -EBUSY;
  		goto out;
  	}
a98f0dd34   Andi Kleen   [PATCH] x86-64: A...
559

a98f0dd34   Andi Kleen   [PATCH] x86-64: A...
560
  	sub_info->complete = &done;
a98f0dd34   Andi Kleen   [PATCH] x86-64: A...
561
562
563
  	sub_info->wait = wait;
  
  	queue_work(khelper_wq, &sub_info->work);
784680336   Nigel Cunningham   Fix unbalanced he...
564
565
  	if (wait == UMH_NO_WAIT)	/* task has freed sub_info */
  		goto unlock;
d0bd587a8   Oleg Nesterov   usermodehelper: i...
566
567
568
569
570
571
572
573
574
575
576
  
  	if (wait & UMH_KILLABLE) {
  		retval = wait_for_completion_killable(&done);
  		if (!retval)
  			goto wait_done;
  
  		/* umh_complete() will see NULL and free sub_info */
  		if (xchg(&sub_info->complete, NULL))
  			goto unlock;
  		/* fallthrough, umh_complete() was already called */
  	}
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
577
  	wait_for_completion(&done);
d0bd587a8   Oleg Nesterov   usermodehelper: i...
578
  wait_done:
a98f0dd34   Andi Kleen   [PATCH] x86-64: A...
579
  	retval = sub_info->retval;
784680336   Nigel Cunningham   Fix unbalanced he...
580
  out:
0ab4dc922   Jeremy Fitzhardinge   usermodehelper: s...
581
  	call_usermodehelper_freeinfo(sub_info);
784680336   Nigel Cunningham   Fix unbalanced he...
582
  unlock:
ccd4b65ae   Rafael J. Wysocki   PM: prevent froze...
583
  	helper_unlock();
a98f0dd34   Andi Kleen   [PATCH] x86-64: A...
584
  	return retval;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
585
  }
785042f2e   Boaz Harrosh   kmod: move call_u...
586

79c743dd1   Andrew Morton   kernel/kmod.c: do...
587
588
589
590
591
592
  /*
   * call_usermodehelper_fns() will not run the caller-provided cleanup function
   * if a memory allocation failure is experienced.  So the caller might need to
   * check the call_usermodehelper_fns() return value: if it is -ENOMEM, perform
   * the necessaary cleanup within the caller.
   */
785042f2e   Boaz Harrosh   kmod: move call_u...
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
  int call_usermodehelper_fns(
  	char *path, char **argv, char **envp, int wait,
  	int (*init)(struct subprocess_info *info, struct cred *new),
  	void (*cleanup)(struct subprocess_info *), void *data)
  {
  	struct subprocess_info *info;
  	gfp_t gfp_mask = (wait == UMH_NO_WAIT) ? GFP_ATOMIC : GFP_KERNEL;
  
  	info = call_usermodehelper_setup(path, argv, envp, gfp_mask);
  
  	if (info == NULL)
  		return -ENOMEM;
  
  	call_usermodehelper_setfns(info, init, cleanup, data);
  
  	return call_usermodehelper_exec(info, wait);
  }
  EXPORT_SYMBOL(call_usermodehelper_fns);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
611

17f60a7da   Eric Paris   capabilites: allo...
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
  static int proc_cap_handler(struct ctl_table *table, int write,
  			 void __user *buffer, size_t *lenp, loff_t *ppos)
  {
  	struct ctl_table t;
  	unsigned long cap_array[_KERNEL_CAPABILITY_U32S];
  	kernel_cap_t new_cap;
  	int err, i;
  
  	if (write && (!capable(CAP_SETPCAP) ||
  		      !capable(CAP_SYS_MODULE)))
  		return -EPERM;
  
  	/*
  	 * convert from the global kernel_cap_t to the ulong array to print to
  	 * userspace if this is a read.
  	 */
  	spin_lock(&umh_sysctl_lock);
  	for (i = 0; i < _KERNEL_CAPABILITY_U32S; i++)  {
  		if (table->data == CAP_BSET)
  			cap_array[i] = usermodehelper_bset.cap[i];
  		else if (table->data == CAP_PI)
  			cap_array[i] = usermodehelper_inheritable.cap[i];
  		else
  			BUG();
  	}
  	spin_unlock(&umh_sysctl_lock);
  
  	t = *table;
  	t.data = &cap_array;
  
  	/*
  	 * actually read or write and array of ulongs from userspace.  Remember
  	 * these are least significant 32 bits first
  	 */
  	err = proc_doulongvec_minmax(&t, write, buffer, lenp, ppos);
  	if (err < 0)
  		return err;
  
  	/*
  	 * convert from the sysctl array of ulongs to the kernel_cap_t
  	 * internal representation
  	 */
  	for (i = 0; i < _KERNEL_CAPABILITY_U32S; i++)
  		new_cap.cap[i] = cap_array[i];
  
  	/*
  	 * Drop everything not in the new_cap (but don't add things)
  	 */
  	spin_lock(&umh_sysctl_lock);
  	if (write) {
  		if (table->data == CAP_BSET)
  			usermodehelper_bset = cap_intersect(usermodehelper_bset, new_cap);
  		if (table->data == CAP_PI)
  			usermodehelper_inheritable = cap_intersect(usermodehelper_inheritable, new_cap);
  	}
  	spin_unlock(&umh_sysctl_lock);
  
  	return 0;
  }
  
  struct ctl_table usermodehelper_table[] = {
  	{
  		.procname	= "bset",
  		.data		= CAP_BSET,
  		.maxlen		= _KERNEL_CAPABILITY_U32S * sizeof(unsigned long),
  		.mode		= 0600,
  		.proc_handler	= proc_cap_handler,
  	},
  	{
  		.procname	= "inheritable",
  		.data		= CAP_PI,
  		.maxlen		= _KERNEL_CAPABILITY_U32S * sizeof(unsigned long),
  		.mode		= 0600,
  		.proc_handler	= proc_cap_handler,
  	},
  	{ }
  };
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
689
690
691
692
693
  void __init usermodehelper_init(void)
  {
  	khelper_wq = create_singlethread_workqueue("khelper");
  	BUG_ON(!khelper_wq);
  }