module: make perm const
[linux-2.6-block.git] / kernel / params.c
CommitLineData
1da177e4
LT
1/* Helpers for initial module or kernel cmdline parsing
2 Copyright (C) 2001 Rusty Russell.
3
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
8
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
13
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17*/
1da177e4
LT
18#include <linux/kernel.h>
19#include <linux/string.h>
20#include <linux/errno.h>
21#include <linux/module.h>
63a12d9d 22#include <linux/moduleparam.h>
1da177e4
LT
23#include <linux/device.h>
24#include <linux/err.h>
4e57b681 25#include <linux/slab.h>
26d052bf 26#include <linux/ctype.h>
1da177e4 27
907b29eb
RR
28/* Protects all parameters, and incidentally kmalloced_param list. */
29static DEFINE_MUTEX(param_lock);
30
a1054322
RR
31/* This just allows us to keep track of which parameters are kmalloced. */
32struct kmalloced_param {
33 struct list_head list;
34 char val[];
35};
a1054322
RR
36static LIST_HEAD(kmalloced_params);
37
38static void *kmalloc_parameter(unsigned int size)
39{
40 struct kmalloced_param *p;
41
42 p = kmalloc(sizeof(*p) + size, GFP_KERNEL);
43 if (!p)
44 return NULL;
45
a1054322 46 list_add(&p->list, &kmalloced_params);
a1054322
RR
47 return p->val;
48}
49
50/* Does nothing if parameter wasn't kmalloced above. */
51static void maybe_kfree_parameter(void *param)
52{
53 struct kmalloced_param *p;
54
a1054322
RR
55 list_for_each_entry(p, &kmalloced_params, list) {
56 if (p->val == param) {
57 list_del(&p->list);
58 kfree(p);
59 break;
60 }
61 }
a1054322
RR
62}
63
b1e4d20c 64static char dash2underscore(char c)
1da177e4
LT
65{
66 if (c == '-')
67 return '_';
68 return c;
69}
70
b1e4d20c 71bool parameqn(const char *a, const char *b, size_t n)
1da177e4 72{
b1e4d20c
MS
73 size_t i;
74
75 for (i = 0; i < n; i++) {
76 if (dash2underscore(a[i]) != dash2underscore(b[i]))
77 return false;
78 }
79 return true;
80}
81
82bool parameq(const char *a, const char *b)
83{
84 return parameqn(a, b, strlen(a)+1);
1da177e4
LT
85}
86
7a486d37
RR
87static void param_check_unsafe(const struct kernel_param *kp)
88{
89 if (kp->flags & KERNEL_PARAM_FL_UNSAFE) {
90 pr_warn("Setting dangerous option %s - tainting kernel\n",
91 kp->name);
92 add_taint(TAINT_USER, LOCKDEP_STILL_OK);
93 }
94}
95
1da177e4
LT
96static int parse_one(char *param,
97 char *val,
9fb48c74 98 const char *doing,
914dcaa8 99 const struct kernel_param *params,
1da177e4 100 unsigned num_params,
026cee00
PM
101 s16 min_level,
102 s16 max_level,
9fb48c74
JC
103 int (*handle_unknown)(char *param, char *val,
104 const char *doing))
1da177e4
LT
105{
106 unsigned int i;
907b29eb 107 int err;
1da177e4
LT
108
109 /* Find parameter */
110 for (i = 0; i < num_params; i++) {
111 if (parameq(param, params[i].name)) {
026cee00
PM
112 if (params[i].level < min_level
113 || params[i].level > max_level)
114 return 0;
25985edc 115 /* No one handled NULL, so do it here. */
ab013c5f 116 if (!val &&
6a4c2643 117 !(params[i].ops->flags & KERNEL_PARAM_OPS_FL_NOARG))
2e9fb995 118 return -EINVAL;
9fb48c74
JC
119 pr_debug("handling %s with %p\n", param,
120 params[i].ops->set);
907b29eb 121 mutex_lock(&param_lock);
7a486d37 122 param_check_unsafe(&params[i]);
907b29eb
RR
123 err = params[i].ops->set(val, &params[i]);
124 mutex_unlock(&param_lock);
125 return err;
1da177e4
LT
126 }
127 }
128
129 if (handle_unknown) {
9fb48c74
JC
130 pr_debug("doing %s: %s='%s'\n", doing, param, val);
131 return handle_unknown(param, val, doing);
1da177e4
LT
132 }
133
9fb48c74 134 pr_debug("Unknown argument '%s'\n", param);
1da177e4
LT
135 return -ENOENT;
136}
137
138/* You can use " around spaces, but can't escape ". */
139/* Hyphens and underscores equivalent in parameter names. */
140static char *next_arg(char *args, char **param, char **val)
141{
142 unsigned int i, equals = 0;
143 int in_quote = 0, quoted = 0;
144 char *next;
145
1da177e4
LT
146 if (*args == '"') {
147 args++;
148 in_quote = 1;
149 quoted = 1;
150 }
151
152 for (i = 0; args[i]; i++) {
26d052bf 153 if (isspace(args[i]) && !in_quote)
1da177e4
LT
154 break;
155 if (equals == 0) {
156 if (args[i] == '=')
157 equals = i;
158 }
159 if (args[i] == '"')
160 in_quote = !in_quote;
161 }
162
163 *param = args;
164 if (!equals)
165 *val = NULL;
166 else {
167 args[equals] = '\0';
168 *val = args + equals + 1;
169
170 /* Don't include quotes in value. */
171 if (**val == '"') {
172 (*val)++;
173 if (args[i-1] == '"')
174 args[i-1] = '\0';
175 }
1da177e4 176 }
b9cc4489
RR
177 if (quoted && args[i-1] == '"')
178 args[i-1] = '\0';
1da177e4
LT
179
180 if (args[i]) {
181 args[i] = '\0';
182 next = args + i + 1;
183 } else
184 next = args + i;
f36462f0
RR
185
186 /* Chew up trailing spaces. */
e7d2860b 187 return skip_spaces(next);
1da177e4
LT
188}
189
190/* Args looks like "foo=bar,bar2 baz=fuz wiz". */
51e158c1
RR
191char *parse_args(const char *doing,
192 char *args,
193 const struct kernel_param *params,
194 unsigned num,
195 s16 min_level,
196 s16 max_level,
197 int (*unknown)(char *param, char *val, const char *doing))
1da177e4
LT
198{
199 char *param, *val;
200
f36462f0 201 /* Chew leading spaces */
e7d2860b 202 args = skip_spaces(args);
f36462f0 203
1ef9eaf2 204 if (*args)
9fb48c74
JC
205 pr_debug("doing %s, parsing ARGS: '%s'\n", doing, args);
206
1da177e4
LT
207 while (*args) {
208 int ret;
a416aba6 209 int irq_was_disabled;
1da177e4
LT
210
211 args = next_arg(args, &param, &val);
51e158c1
RR
212 /* Stop at -- */
213 if (!val && strcmp(param, "--") == 0)
214 return args;
a416aba6 215 irq_was_disabled = irqs_disabled();
9fb48c74 216 ret = parse_one(param, val, doing, params, num,
026cee00 217 min_level, max_level, unknown);
b5f3abf9
JC
218 if (irq_was_disabled && !irqs_disabled())
219 pr_warn("%s: option '%s' enabled irq's!\n",
220 doing, param);
221
1da177e4
LT
222 switch (ret) {
223 case -ENOENT:
b5f3abf9 224 pr_err("%s: Unknown parameter `%s'\n", doing, param);
51e158c1 225 return ERR_PTR(ret);
1da177e4 226 case -ENOSPC:
b5f3abf9 227 pr_err("%s: `%s' too large for parameter `%s'\n",
9fb48c74 228 doing, val ?: "", param);
51e158c1 229 return ERR_PTR(ret);
1da177e4
LT
230 case 0:
231 break;
232 default:
b5f3abf9 233 pr_err("%s: `%s' invalid for parameter `%s'\n",
9fb48c74 234 doing, val ?: "", param);
51e158c1 235 return ERR_PTR(ret);
1da177e4
LT
236 }
237 }
238
239 /* All parsed OK. */
51e158c1 240 return NULL;
1da177e4
LT
241}
242
243/* Lazy bastard, eh? */
88a88b32 244#define STANDARD_PARAM_DEF(name, type, format, strtolfn) \
9bbb9e5a 245 int param_set_##name(const char *val, const struct kernel_param *kp) \
1da177e4 246 { \
88a88b32 247 return strtolfn(val, 0, (type *)kp->arg); \
1da177e4 248 } \
9bbb9e5a 249 int param_get_##name(char *buffer, const struct kernel_param *kp) \
1da177e4 250 { \
f4940ab7
CG
251 return scnprintf(buffer, PAGE_SIZE, format, \
252 *((type *)kp->arg)); \
a14fe249 253 } \
9c27847d 254 const struct kernel_param_ops param_ops_##name = { \
9bbb9e5a
RR
255 .set = param_set_##name, \
256 .get = param_get_##name, \
257 }; \
a14fe249 258 EXPORT_SYMBOL(param_set_##name); \
9bbb9e5a
RR
259 EXPORT_SYMBOL(param_get_##name); \
260 EXPORT_SYMBOL(param_ops_##name)
261
1da177e4 262
88a88b32
FC
263STANDARD_PARAM_DEF(byte, unsigned char, "%hhu", kstrtou8);
264STANDARD_PARAM_DEF(short, short, "%hi", kstrtos16);
265STANDARD_PARAM_DEF(ushort, unsigned short, "%hu", kstrtou16);
266STANDARD_PARAM_DEF(int, int, "%i", kstrtoint);
267STANDARD_PARAM_DEF(uint, unsigned int, "%u", kstrtouint);
268STANDARD_PARAM_DEF(long, long, "%li", kstrtol);
269STANDARD_PARAM_DEF(ulong, unsigned long, "%lu", kstrtoul);
b4210b81 270STANDARD_PARAM_DEF(ullong, unsigned long long, "%llu", kstrtoull);
1da177e4 271
9bbb9e5a 272int param_set_charp(const char *val, const struct kernel_param *kp)
1da177e4 273{
1da177e4 274 if (strlen(val) > 1024) {
b5f3abf9 275 pr_err("%s: string parameter too long\n", kp->name);
1da177e4
LT
276 return -ENOSPC;
277 }
278
a1054322
RR
279 maybe_kfree_parameter(*(char **)kp->arg);
280
281 /* This is a hack. We can't kmalloc in early boot, and we
e180a6b7
RR
282 * don't need to; this mangled commandline is preserved. */
283 if (slab_is_available()) {
a1054322 284 *(char **)kp->arg = kmalloc_parameter(strlen(val)+1);
d553ad86 285 if (!*(char **)kp->arg)
e180a6b7 286 return -ENOMEM;
a1054322 287 strcpy(*(char **)kp->arg, val);
e180a6b7
RR
288 } else
289 *(const char **)kp->arg = val;
290
1da177e4
LT
291 return 0;
292}
a14fe249 293EXPORT_SYMBOL(param_set_charp);
1da177e4 294
9bbb9e5a 295int param_get_charp(char *buffer, const struct kernel_param *kp)
1da177e4 296{
f4940ab7 297 return scnprintf(buffer, PAGE_SIZE, "%s", *((char **)kp->arg));
1da177e4 298}
a14fe249 299EXPORT_SYMBOL(param_get_charp);
1da177e4 300
a1054322
RR
301static void param_free_charp(void *arg)
302{
303 maybe_kfree_parameter(*((char **)arg));
304}
305
9c27847d 306const struct kernel_param_ops param_ops_charp = {
9bbb9e5a
RR
307 .set = param_set_charp,
308 .get = param_get_charp,
a1054322 309 .free = param_free_charp,
9bbb9e5a
RR
310};
311EXPORT_SYMBOL(param_ops_charp);
312
fddd5201 313/* Actually could be a bool or an int, for historical reasons. */
9bbb9e5a 314int param_set_bool(const char *val, const struct kernel_param *kp)
1da177e4
LT
315{
316 /* No equals means "set"... */
317 if (!val) val = "1";
318
319 /* One of =[yYnN01] */
8b825281 320 return strtobool(val, kp->arg);
1da177e4 321}
a14fe249 322EXPORT_SYMBOL(param_set_bool);
1da177e4 323
9bbb9e5a 324int param_get_bool(char *buffer, const struct kernel_param *kp)
1da177e4
LT
325{
326 /* Y and N chosen as being relatively non-coder friendly */
8b825281 327 return sprintf(buffer, "%c", *(bool *)kp->arg ? 'Y' : 'N');
1da177e4 328}
a14fe249 329EXPORT_SYMBOL(param_get_bool);
1da177e4 330
9c27847d 331const struct kernel_param_ops param_ops_bool = {
6a4c2643 332 .flags = KERNEL_PARAM_OPS_FL_NOARG,
9bbb9e5a
RR
333 .set = param_set_bool,
334 .get = param_get_bool,
335};
336EXPORT_SYMBOL(param_ops_bool);
337
d19f05d8
LR
338int param_set_bool_enable_only(const char *val, const struct kernel_param *kp)
339{
340 int err = 0;
341 bool new_value;
342 bool orig_value = *(bool *)kp->arg;
343 struct kernel_param dummy_kp = *kp;
344
345 dummy_kp.arg = &new_value;
346
347 err = param_set_bool(val, &dummy_kp);
348 if (err)
349 return err;
350
351 /* Don't let them unset it once it's set! */
352 if (!new_value && orig_value)
353 return -EROFS;
354
355 if (new_value)
356 err = param_set_bool(val, kp);
357
358 return err;
359}
360EXPORT_SYMBOL_GPL(param_set_bool_enable_only);
361
362const struct kernel_param_ops param_ops_bool_enable_only = {
363 .flags = KERNEL_PARAM_OPS_FL_NOARG,
364 .set = param_set_bool_enable_only,
365 .get = param_get_bool,
366};
154be21c 367EXPORT_SYMBOL_GPL(param_ops_bool_enable_only);
d19f05d8 368
fddd5201 369/* This one must be bool. */
9bbb9e5a 370int param_set_invbool(const char *val, const struct kernel_param *kp)
1da177e4 371{
fddd5201
RR
372 int ret;
373 bool boolval;
22e48eaf 374 struct kernel_param dummy;
1da177e4 375
22e48eaf 376 dummy.arg = &boolval;
1da177e4
LT
377 ret = param_set_bool(val, &dummy);
378 if (ret == 0)
9a71af2c 379 *(bool *)kp->arg = !boolval;
1da177e4
LT
380 return ret;
381}
a14fe249 382EXPORT_SYMBOL(param_set_invbool);
1da177e4 383
9bbb9e5a 384int param_get_invbool(char *buffer, const struct kernel_param *kp)
1da177e4 385{
9a71af2c 386 return sprintf(buffer, "%c", (*(bool *)kp->arg) ? 'N' : 'Y');
1da177e4 387}
a14fe249 388EXPORT_SYMBOL(param_get_invbool);
1da177e4 389
9c27847d 390const struct kernel_param_ops param_ops_invbool = {
9bbb9e5a
RR
391 .set = param_set_invbool,
392 .get = param_get_invbool,
393};
394EXPORT_SYMBOL(param_ops_invbool);
395
69116f27
RR
396int param_set_bint(const char *val, const struct kernel_param *kp)
397{
5104b7d7
DS
398 /* Match bool exactly, by re-using it. */
399 struct kernel_param boolkp = *kp;
69116f27
RR
400 bool v;
401 int ret;
402
69116f27 403 boolkp.arg = &v;
69116f27
RR
404
405 ret = param_set_bool(val, &boolkp);
406 if (ret == 0)
407 *(int *)kp->arg = v;
408 return ret;
409}
410EXPORT_SYMBOL(param_set_bint);
411
9c27847d 412const struct kernel_param_ops param_ops_bint = {
6a4c2643 413 .flags = KERNEL_PARAM_OPS_FL_NOARG,
69116f27
RR
414 .set = param_set_bint,
415 .get = param_get_int,
416};
417EXPORT_SYMBOL(param_ops_bint);
418
9730b5b0 419/* We break the rule and mangle the string. */
9871728b
AB
420static int param_array(const char *name,
421 const char *val,
422 unsigned int min, unsigned int max,
423 void *elem, int elemsize,
9bbb9e5a 424 int (*set)(const char *, const struct kernel_param *kp),
026cee00 425 s16 level,
eb38a996 426 unsigned int *num)
1da177e4
LT
427{
428 int ret;
429 struct kernel_param kp;
430 char save;
431
432 /* Get the name right for errors. */
433 kp.name = name;
434 kp.arg = elem;
026cee00 435 kp.level = level;
1da177e4 436
1da177e4
LT
437 *num = 0;
438 /* We expect a comma-separated list of values. */
439 do {
440 int len;
441
442 if (*num == max) {
b5f3abf9 443 pr_err("%s: can only take %i arguments\n", name, max);
1da177e4
LT
444 return -EINVAL;
445 }
446 len = strcspn(val, ",");
447
448 /* nul-terminate and parse */
449 save = val[len];
450 ((char *)val)[len] = '\0';
907b29eb 451 BUG_ON(!mutex_is_locked(&param_lock));
1da177e4
LT
452 ret = set(val, &kp);
453
454 if (ret != 0)
455 return ret;
456 kp.arg += elemsize;
457 val += len+1;
458 (*num)++;
459 } while (save == ',');
460
461 if (*num < min) {
b5f3abf9 462 pr_err("%s: needs at least %i arguments\n", name, min);
1da177e4
LT
463 return -EINVAL;
464 }
465 return 0;
466}
467
9bbb9e5a 468static int param_array_set(const char *val, const struct kernel_param *kp)
1da177e4 469{
22e48eaf 470 const struct kparam_array *arr = kp->arr;
31143a12 471 unsigned int temp_num;
1da177e4
LT
472
473 return param_array(kp->name, val, 1, arr->max, arr->elem,
026cee00 474 arr->elemsize, arr->ops->set, kp->level,
3c7d76e3 475 arr->num ?: &temp_num);
1da177e4
LT
476}
477
9bbb9e5a 478static int param_array_get(char *buffer, const struct kernel_param *kp)
1da177e4
LT
479{
480 int i, off, ret;
22e48eaf 481 const struct kparam_array *arr = kp->arr;
5104b7d7 482 struct kernel_param p = *kp;
1da177e4 483
1da177e4
LT
484 for (i = off = 0; i < (arr->num ? *arr->num : arr->max); i++) {
485 if (i)
486 buffer[off++] = ',';
487 p.arg = arr->elem + arr->elemsize * i;
907b29eb 488 BUG_ON(!mutex_is_locked(&param_lock));
9bbb9e5a 489 ret = arr->ops->get(buffer + off, &p);
1da177e4
LT
490 if (ret < 0)
491 return ret;
492 off += ret;
493 }
494 buffer[off] = '\0';
495 return off;
496}
497
e6df34a4
RR
498static void param_array_free(void *arg)
499{
500 unsigned int i;
501 const struct kparam_array *arr = arg;
502
503 if (arr->ops->free)
504 for (i = 0; i < (arr->num ? *arr->num : arr->max); i++)
505 arr->ops->free(arr->elem + arr->elemsize * i);
506}
507
9c27847d 508const struct kernel_param_ops param_array_ops = {
9bbb9e5a
RR
509 .set = param_array_set,
510 .get = param_array_get,
e6df34a4 511 .free = param_array_free,
9bbb9e5a
RR
512};
513EXPORT_SYMBOL(param_array_ops);
514
515int param_set_copystring(const char *val, const struct kernel_param *kp)
1da177e4 516{
22e48eaf 517 const struct kparam_string *kps = kp->str;
1da177e4
LT
518
519 if (strlen(val)+1 > kps->maxlen) {
b5f3abf9 520 pr_err("%s: string doesn't fit in %u chars.\n",
1da177e4
LT
521 kp->name, kps->maxlen-1);
522 return -ENOSPC;
523 }
524 strcpy(kps->string, val);
525 return 0;
526}
a14fe249 527EXPORT_SYMBOL(param_set_copystring);
1da177e4 528
9bbb9e5a 529int param_get_string(char *buffer, const struct kernel_param *kp)
1da177e4 530{
22e48eaf 531 const struct kparam_string *kps = kp->str;
1da177e4
LT
532 return strlcpy(buffer, kps->string, kps->maxlen);
533}
a14fe249 534EXPORT_SYMBOL(param_get_string);
1da177e4 535
9c27847d 536const struct kernel_param_ops param_ops_string = {
9bbb9e5a
RR
537 .set = param_set_copystring,
538 .get = param_get_string,
539};
540EXPORT_SYMBOL(param_ops_string);
541
1da177e4 542/* sysfs output in /sys/modules/XYZ/parameters/ */
350f8258
EY
543#define to_module_attr(n) container_of(n, struct module_attribute, attr)
544#define to_module_kobject(n) container_of(n, struct module_kobject, kobj)
1da177e4 545
1da177e4
LT
546struct param_attribute
547{
548 struct module_attribute mattr;
9bbb9e5a 549 const struct kernel_param *param;
1da177e4
LT
550};
551
552struct module_param_attrs
553{
9b473de8 554 unsigned int num;
1da177e4
LT
555 struct attribute_group grp;
556 struct param_attribute attrs[0];
557};
558
ef665c1a 559#ifdef CONFIG_SYSFS
350f8258 560#define to_param_attr(n) container_of(n, struct param_attribute, mattr)
1da177e4
LT
561
562static ssize_t param_attr_show(struct module_attribute *mattr,
4befb026 563 struct module_kobject *mk, char *buf)
1da177e4
LT
564{
565 int count;
566 struct param_attribute *attribute = to_param_attr(mattr);
567
9bbb9e5a 568 if (!attribute->param->ops->get)
1da177e4
LT
569 return -EPERM;
570
907b29eb 571 mutex_lock(&param_lock);
9bbb9e5a 572 count = attribute->param->ops->get(buf, attribute->param);
907b29eb 573 mutex_unlock(&param_lock);
1da177e4
LT
574 if (count > 0) {
575 strcat(buf, "\n");
576 ++count;
577 }
578 return count;
579}
580
581/* sysfs always hands a nul-terminated string in buf. We rely on that. */
582static ssize_t param_attr_store(struct module_attribute *mattr,
4befb026 583 struct module_kobject *km,
1da177e4
LT
584 const char *buf, size_t len)
585{
586 int err;
587 struct param_attribute *attribute = to_param_attr(mattr);
588
9bbb9e5a 589 if (!attribute->param->ops->set)
1da177e4
LT
590 return -EPERM;
591
907b29eb 592 mutex_lock(&param_lock);
7a486d37 593 param_check_unsafe(attribute->param);
9bbb9e5a 594 err = attribute->param->ops->set(buf, attribute->param);
907b29eb 595 mutex_unlock(&param_lock);
1da177e4
LT
596 if (!err)
597 return len;
598 return err;
599}
ef665c1a 600#endif
1da177e4
LT
601
602#ifdef CONFIG_MODULES
603#define __modinit
604#else
605#define __modinit __init
606#endif
607
ef665c1a 608#ifdef CONFIG_SYSFS
907b29eb
RR
609void __kernel_param_lock(void)
610{
611 mutex_lock(&param_lock);
612}
613EXPORT_SYMBOL(__kernel_param_lock);
614
615void __kernel_param_unlock(void)
616{
617 mutex_unlock(&param_lock);
618}
619EXPORT_SYMBOL(__kernel_param_unlock);
620
1da177e4 621/*
9b473de8
RR
622 * add_sysfs_param - add a parameter to sysfs
623 * @mk: struct module_kobject
624 * @kparam: the actual parameter definition to add to sysfs
625 * @name: name of parameter
1da177e4 626 *
9b473de8
RR
627 * Create a kobject if for a (per-module) parameter if mp NULL, and
628 * create file in sysfs. Returns an error on out of memory. Always cleans up
629 * if there's an error.
1da177e4 630 */
9b473de8 631static __modinit int add_sysfs_param(struct module_kobject *mk,
9bbb9e5a 632 const struct kernel_param *kp,
9b473de8 633 const char *name)
1da177e4 634{
18eb74fa
RR
635 struct module_param_attrs *new_mp;
636 struct attribute **new_attrs;
637 unsigned int i;
9b473de8
RR
638
639 /* We don't bother calling this with invisible parameters. */
640 BUG_ON(!kp->perm);
641
642 if (!mk->mp) {
18eb74fa
RR
643 /* First allocation. */
644 mk->mp = kzalloc(sizeof(*mk->mp), GFP_KERNEL);
645 if (!mk->mp)
646 return -ENOMEM;
647 mk->mp->grp.name = "parameters";
648 /* NULL-terminated attribute array. */
649 mk->mp->grp.attrs = kzalloc(sizeof(mk->mp->grp.attrs[0]),
650 GFP_KERNEL);
651 /* Caller will cleanup via free_module_param_attrs */
652 if (!mk->mp->grp.attrs)
653 return -ENOMEM;
9b473de8 654 }
1da177e4 655
18eb74fa
RR
656 /* Enlarge allocations. */
657 new_mp = krealloc(mk->mp,
658 sizeof(*mk->mp) +
659 sizeof(mk->mp->attrs[0]) * (mk->mp->num + 1),
660 GFP_KERNEL);
661 if (!new_mp)
662 return -ENOMEM;
663 mk->mp = new_mp;
664
665 /* Extra pointer for NULL terminator */
666 new_attrs = krealloc(mk->mp->grp.attrs,
667 sizeof(mk->mp->grp.attrs[0]) * (mk->mp->num + 2),
668 GFP_KERNEL);
669 if (!new_attrs)
670 return -ENOMEM;
671 mk->mp->grp.attrs = new_attrs;
9b473de8
RR
672
673 /* Tack new one on the end. */
c772be52 674 memset(&mk->mp->attrs[mk->mp->num], 0, sizeof(mk->mp->attrs[0]));
18eb74fa
RR
675 sysfs_attr_init(&mk->mp->attrs[mk->mp->num].mattr.attr);
676 mk->mp->attrs[mk->mp->num].param = kp;
677 mk->mp->attrs[mk->mp->num].mattr.show = param_attr_show;
b0a65b0c
KC
678 /* Do not allow runtime DAC changes to make param writable. */
679 if ((kp->perm & (S_IWUSR | S_IWGRP | S_IWOTH)) != 0)
680 mk->mp->attrs[mk->mp->num].mattr.store = param_attr_store;
574732c7
RR
681 else
682 mk->mp->attrs[mk->mp->num].mattr.store = NULL;
18eb74fa
RR
683 mk->mp->attrs[mk->mp->num].mattr.attr.name = (char *)name;
684 mk->mp->attrs[mk->mp->num].mattr.attr.mode = kp->perm;
685 mk->mp->num++;
9b473de8
RR
686
687 /* Fix up all the pointers, since krealloc can move us */
18eb74fa
RR
688 for (i = 0; i < mk->mp->num; i++)
689 mk->mp->grp.attrs[i] = &mk->mp->attrs[i].mattr.attr;
690 mk->mp->grp.attrs[mk->mp->num] = NULL;
9b473de8 691 return 0;
9b473de8 692}
1da177e4 693
d2441183 694#ifdef CONFIG_MODULES
9b473de8
RR
695static void free_module_param_attrs(struct module_kobject *mk)
696{
18eb74fa
RR
697 if (mk->mp)
698 kfree(mk->mp->grp.attrs);
9b473de8
RR
699 kfree(mk->mp);
700 mk->mp = NULL;
1da177e4
LT
701}
702
1da177e4
LT
703/*
704 * module_param_sysfs_setup - setup sysfs support for one module
705 * @mod: module
706 * @kparam: module parameters (array)
707 * @num_params: number of module parameters
708 *
9b473de8
RR
709 * Adds sysfs entries for module parameters under
710 * /sys/module/[mod->name]/parameters/
1da177e4
LT
711 */
712int module_param_sysfs_setup(struct module *mod,
9bbb9e5a 713 const struct kernel_param *kparam,
1da177e4
LT
714 unsigned int num_params)
715{
9b473de8
RR
716 int i, err;
717 bool params = false;
718
719 for (i = 0; i < num_params; i++) {
720 if (kparam[i].perm == 0)
721 continue;
722 err = add_sysfs_param(&mod->mkobj, &kparam[i], kparam[i].name);
18eb74fa
RR
723 if (err) {
724 free_module_param_attrs(&mod->mkobj);
9b473de8 725 return err;
18eb74fa 726 }
9b473de8
RR
727 params = true;
728 }
1da177e4 729
9b473de8
RR
730 if (!params)
731 return 0;
1da177e4 732
9b473de8
RR
733 /* Create the param group. */
734 err = sysfs_create_group(&mod->mkobj.kobj, &mod->mkobj.mp->grp);
735 if (err)
736 free_module_param_attrs(&mod->mkobj);
737 return err;
1da177e4
LT
738}
739
740/*
741 * module_param_sysfs_remove - remove sysfs support for one module
742 * @mod: module
743 *
744 * Remove sysfs entries for module parameters and the corresponding
745 * kobject.
746 */
747void module_param_sysfs_remove(struct module *mod)
748{
9b473de8
RR
749 if (mod->mkobj.mp) {
750 sysfs_remove_group(&mod->mkobj.kobj, &mod->mkobj.mp->grp);
1da177e4
LT
751 /* We are positive that no one is using any param
752 * attrs at this point. Deallocate immediately. */
9b473de8 753 free_module_param_attrs(&mod->mkobj);
1da177e4
LT
754 }
755}
756#endif
757
e180a6b7
RR
758void destroy_params(const struct kernel_param *params, unsigned num)
759{
e6df34a4
RR
760 unsigned int i;
761
762 for (i = 0; i < num; i++)
763 if (params[i].ops->free)
764 params[i].ops->free(params[i].arg);
e180a6b7
RR
765}
766
e94965ed 767static struct module_kobject * __init locate_module_kobject(const char *name)
1da177e4
LT
768{
769 struct module_kobject *mk;
9b473de8
RR
770 struct kobject *kobj;
771 int err;
1da177e4 772
9b473de8
RR
773 kobj = kset_find_obj(module_kset, name);
774 if (kobj) {
9b473de8 775 mk = to_module_kobject(kobj);
9b473de8
RR
776 } else {
777 mk = kzalloc(sizeof(struct module_kobject), GFP_KERNEL);
778 BUG_ON(!mk);
779
780 mk->mod = THIS_MODULE;
781 mk->kobj.kset = module_kset;
782 err = kobject_init_and_add(&mk->kobj, &module_ktype, NULL,
783 "%s", name);
88bfa324
KS
784#ifdef CONFIG_MODULES
785 if (!err)
786 err = sysfs_create_file(&mk->kobj, &module_uevent.attr);
787#endif
9b473de8
RR
788 if (err) {
789 kobject_put(&mk->kobj);
b5f3abf9 790 pr_crit("Adding module '%s' to sysfs failed (%d), the system may be unstable.\n",
e94965ed 791 name, err);
e94965ed 792 return NULL;
9b473de8 793 }
e94965ed
DT
794
795 /* So that we hold reference in both cases. */
9b473de8 796 kobject_get(&mk->kobj);
74c5b597 797 }
9b473de8 798
e94965ed
DT
799 return mk;
800}
801
802static void __init kernel_add_sysfs_param(const char *name,
63a12d9d 803 const struct kernel_param *kparam,
e94965ed
DT
804 unsigned int name_skip)
805{
806 struct module_kobject *mk;
807 int err;
808
809 mk = locate_module_kobject(name);
810 if (!mk)
811 return;
812
813 /* We need to remove old parameters before adding more. */
814 if (mk->mp)
815 sysfs_remove_group(&mk->kobj, &mk->mp->grp);
816
9b473de8
RR
817 /* These should not fail at boot. */
818 err = add_sysfs_param(mk, kparam, kparam->name + name_skip);
819 BUG_ON(err);
820 err = sysfs_create_group(&mk->kobj, &mk->mp->grp);
821 BUG_ON(err);
f30c53a8 822 kobject_uevent(&mk->kobj, KOBJ_ADD);
9b473de8 823 kobject_put(&mk->kobj);
1da177e4
LT
824}
825
826/*
b634d130 827 * param_sysfs_builtin - add sysfs parameters for built-in modules
1da177e4
LT
828 *
829 * Add module_parameters to sysfs for "modules" built into the kernel.
830 *
831 * The "module" name (KBUILD_MODNAME) is stored before a dot, the
832 * "parameter" name is stored behind a dot in kernel_param->name. So,
833 * extract the "module" name for all built-in kernel_param-eters,
9b473de8 834 * and for all who have the same, call kernel_add_sysfs_param.
1da177e4
LT
835 */
836static void __init param_sysfs_builtin(void)
837{
63a12d9d 838 const struct kernel_param *kp;
9b473de8
RR
839 unsigned int name_len;
840 char modname[MODULE_NAME_LEN];
1da177e4 841
9b473de8 842 for (kp = __start___param; kp < __stop___param; kp++) {
1da177e4
LT
843 char *dot;
844
9b473de8
RR
845 if (kp->perm == 0)
846 continue;
1da177e4 847
730b69d2 848 dot = strchr(kp->name, '.');
1da177e4 849 if (!dot) {
67e67cea
RR
850 /* This happens for core_param() */
851 strcpy(modname, "kernel");
852 name_len = 0;
853 } else {
854 name_len = dot - kp->name + 1;
855 strlcpy(modname, kp->name, name_len);
1da177e4 856 }
67e67cea 857 kernel_add_sysfs_param(modname, kp, name_len);
1da177e4 858 }
1da177e4
LT
859}
860
e94965ed 861ssize_t __modver_version_show(struct module_attribute *mattr,
4befb026 862 struct module_kobject *mk, char *buf)
e94965ed
DT
863{
864 struct module_version_attribute *vattr =
865 container_of(mattr, struct module_version_attribute, mattr);
866
f4940ab7 867 return scnprintf(buf, PAGE_SIZE, "%s\n", vattr->version);
e94965ed
DT
868}
869
b4bc8428
DT
870extern const struct module_version_attribute *__start___modver[];
871extern const struct module_version_attribute *__stop___modver[];
e94965ed
DT
872
873static void __init version_sysfs_builtin(void)
874{
b4bc8428 875 const struct module_version_attribute **p;
e94965ed
DT
876 struct module_kobject *mk;
877 int err;
878
b4bc8428
DT
879 for (p = __start___modver; p < __stop___modver; p++) {
880 const struct module_version_attribute *vattr = *p;
881
e94965ed
DT
882 mk = locate_module_kobject(vattr->module_name);
883 if (mk) {
884 err = sysfs_create_file(&mk->kobj, &vattr->mattr.attr);
74c3dea3 885 WARN_ON_ONCE(err);
e94965ed
DT
886 kobject_uevent(&mk->kobj, KOBJ_ADD);
887 kobject_put(&mk->kobj);
888 }
889 }
890}
1da177e4
LT
891
892/* module-related sysfs stuff */
1da177e4 893
1da177e4
LT
894static ssize_t module_attr_show(struct kobject *kobj,
895 struct attribute *attr,
896 char *buf)
897{
898 struct module_attribute *attribute;
899 struct module_kobject *mk;
900 int ret;
901
902 attribute = to_module_attr(attr);
903 mk = to_module_kobject(kobj);
904
905 if (!attribute->show)
70f2817a 906 return -EIO;
1da177e4 907
4befb026 908 ret = attribute->show(attribute, mk, buf);
1da177e4 909
1da177e4
LT
910 return ret;
911}
912
913static ssize_t module_attr_store(struct kobject *kobj,
914 struct attribute *attr,
915 const char *buf, size_t len)
916{
917 struct module_attribute *attribute;
918 struct module_kobject *mk;
919 int ret;
920
921 attribute = to_module_attr(attr);
922 mk = to_module_kobject(kobj);
923
924 if (!attribute->store)
70f2817a 925 return -EIO;
1da177e4 926
4befb026 927 ret = attribute->store(attribute, mk, buf, len);
1da177e4 928
1da177e4
LT
929 return ret;
930}
931
52cf25d0 932static const struct sysfs_ops module_sysfs_ops = {
1da177e4
LT
933 .show = module_attr_show,
934 .store = module_attr_store,
935};
936
270a6c4c
KS
937static int uevent_filter(struct kset *kset, struct kobject *kobj)
938{
939 struct kobj_type *ktype = get_ktype(kobj);
940
941 if (ktype == &module_ktype)
942 return 1;
943 return 0;
944}
945
9cd43611 946static const struct kset_uevent_ops module_uevent_ops = {
270a6c4c
KS
947 .filter = uevent_filter,
948};
949
7405c1e1 950struct kset *module_kset;
823bccfc 951int module_sysfs_initialized;
1da177e4 952
942e4431
LZ
953static void module_kobj_release(struct kobject *kobj)
954{
955 struct module_kobject *mk = to_module_kobject(kobj);
956 complete(mk->kobj_completion);
957}
958
7405c1e1 959struct kobj_type module_ktype = {
942e4431 960 .release = module_kobj_release,
1da177e4
LT
961 .sysfs_ops = &module_sysfs_ops,
962};
963
1da177e4
LT
964/*
965 * param_sysfs_init - wrapper for built-in params support
966 */
967static int __init param_sysfs_init(void)
968{
7405c1e1
GKH
969 module_kset = kset_create_and_add("module", &module_uevent_ops, NULL);
970 if (!module_kset) {
971 printk(KERN_WARNING "%s (%d): error creating kset\n",
972 __FILE__, __LINE__);
973 return -ENOMEM;
d8c7649e 974 }
823bccfc 975 module_sysfs_initialized = 1;
1da177e4 976
e94965ed 977 version_sysfs_builtin();
1da177e4
LT
978 param_sysfs_builtin();
979
980 return 0;
981}
d10be6d1 982subsys_initcall(param_sysfs_init);
1da177e4 983
7405c1e1 984#endif /* CONFIG_SYSFS */