source: GPL/trunk/include/linux/moduleparam.h@ 596

Last change on this file since 596 was 305, checked in by Paul Smedley, 18 years ago

Update source to ALSA 1.0.16 level
File size: 6.2 KB
Line 
1#ifndef _LINUX_MODULE_PARAMS_H
2#define _LINUX_MODULE_PARAMS_H
3/* (C) Copyright 2001, 2002 Rusty Russell IBM Corporation */
4#include <linux/init.h>
5#include <linux/kernel.h>
6
7/* You can override this manually, but generally this should match the
8 module name. */
9#ifdef MODULE
10#define MODULE_PARAM_PREFIX /* empty */
11#else
12#define MODULE_PARAM_PREFIX __stringify(KBUILD_MODNAME) "."
13#endif
14
15struct kernel_param;
16
17/* Returns 0, or -errno. arg is in kp->arg. */
18typedef int (*param_set_fn)(const char *val, struct kernel_param *kp);
19/* Returns length written or -errno. Buffer is 4k (ie. be short!) */
20typedef int (*param_get_fn)(char *buffer, struct kernel_param *kp);
21
22struct kernel_param {
23 const char *name;
24 unsigned int perm;
25 param_set_fn set;
26 param_get_fn get;
27 void *arg;
28};
29
30/* Special one for strings we want to copy into */
31struct kparam_string {
32 unsigned int maxlen;
33 char *string;
34};
35
36/* Special one for arrays */
37struct kparam_array
38{
39 unsigned int max;
40 unsigned int *num;
41 param_set_fn set;
42 param_get_fn get;
43 unsigned int elemsize;
44 void *elem;
45};
46
47/* This is the fundamental function for registering boot/module
48 parameters. perm sets the visibility in driverfs: 000 means it's
49 not there, read bits mean it's readable, write bits mean it's
50 writable. */
51#define __module_param_call(prefix, name, set, get, arg, perm) \
52 static char __param_str_##name[] = prefix #name; \
53 static struct kernel_param const __param_##name \
54 __attribute_used__ \
55 __attribute__ ((unused,__section__ ("__param"),aligned(sizeof(void *)))) \
56 = { __param_str_##name, perm, set, get, arg }
57
58#define module_param_call(name, set, get, arg, perm) \
59 __module_param_call(MODULE_PARAM_PREFIX, name, set, get, arg, perm)
60
61/* Helper functions: type is byte, short, ushort, int, uint, long,
62 ulong, charp, bool or invbool, or XXX if you define param_get_XXX,
63 param_set_XXX and param_check_XXX. */
64#define module_param_named(name, value, type, perm) \
65 param_check_##type(name, &(value)); \
66 module_param_call(name, param_set_##type, param_get_##type, &value, perm)
67
68#ifndef TARGET_OS2
69#define module_param(name, type, perm) \
70 module_param_named(name, name, type, perm)
71#endif
72/* Actually copy string: maxlen param is usually sizeof(string). */
73#define module_param_string(name, string, len, perm) \
74 static struct kparam_string __param_string_##name \
75 = { len, string }; \
76 module_param_call(name, param_set_copystring, param_get_string, \
77 &__param_string_##name, perm)
78
79/* Called on module insert or kernel boot */
80extern int parse_args(const char *name,
81 char *args,
82 struct kernel_param *params,
83 unsigned num,
84 int (*unknown)(char *param, char *val));
85
86/* All the helper functions */
87/* The macros to do compile-time type checking stolen from Jakub
88 Jelinek, who IIRC came up with this idea for the 2.4 module init code. */
89#define __param_check(name, p, type) \
90 static inline type *__check_##name(void) { return(p); }
91
92extern int param_set_byte(const char *val, struct kernel_param *kp);
93extern int param_get_byte(char *buffer, struct kernel_param *kp);
94#define param_check_byte(name, p) __param_check(name, p, unsigned char)
95
96extern int param_set_short(const char *val, struct kernel_param *kp);
97extern int param_get_short(char *buffer, struct kernel_param *kp);
98#define param_check_short(name, p) __param_check(name, p, short)
99
100extern int param_set_ushort(const char *val, struct kernel_param *kp);
101extern int param_get_ushort(char *buffer, struct kernel_param *kp);
102#define param_check_ushort(name, p) __param_check(name, p, unsigned short)
103
104extern int param_set_int(const char *val, struct kernel_param *kp);
105extern int param_get_int(char *buffer, struct kernel_param *kp);
106#define param_check_int(name, p) __param_check(name, p, int)
107
108extern int param_set_uint(const char *val, struct kernel_param *kp);
109extern int param_get_uint(char *buffer, struct kernel_param *kp);
110#define param_check_uint(name, p) __param_check(name, p, unsigned int)
111
112extern int param_set_long(const char *val, struct kernel_param *kp);
113extern int param_get_long(char *buffer, struct kernel_param *kp);
114#define param_check_long(name, p) __param_check(name, p, long)
115
116extern int param_set_ulong(const char *val, struct kernel_param *kp);
117extern int param_get_ulong(char *buffer, struct kernel_param *kp);
118#define param_check_ulong(name, p) __param_check(name, p, unsigned long)
119
120extern int param_set_charp(const char *val, struct kernel_param *kp);
121extern int param_get_charp(char *buffer, struct kernel_param *kp);
122#define param_check_charp(name, p) __param_check(name, p, char *)
123
124extern int param_set_bool(const char *val, struct kernel_param *kp);
125extern int param_get_bool(char *buffer, struct kernel_param *kp);
126#define param_check_bool(name, p) __param_check(name, p, int)
127
128extern int param_set_invbool(const char *val, struct kernel_param *kp);
129extern int param_get_invbool(char *buffer, struct kernel_param *kp);
130#define param_check_invbool(name, p) __param_check(name, p, int)
131
132/* Comma-separated array: *nump is set to number they actually specified. */
133#define module_param_array_named(name, array, type, nump, perm) \
134 static struct kparam_array __param_arr_##name \
135 = { ARRAY_SIZE(array), nump, param_set_##type, param_get_##type,\
136 sizeof(array[0]), array }; \
137 module_param_call(name, param_array_set, param_array_get, \
138 &__param_arr_##name, perm)
139
140#ifndef TARGET_OS2
141#define module_param_array(name, type, nump, perm) \
142 module_param_array_named(name, name, type, nump, perm)
143#endif
144extern int param_array_set(const char *val, struct kernel_param *kp);
145extern int param_array_get(char *buffer, struct kernel_param *kp);
146
147extern int param_set_copystring(const char *val, struct kernel_param *kp);
148extern int param_get_string(char *buffer, struct kernel_param *kp);
149
150int param_array(const char *name,
151 const char *val,
152 unsigned int min, unsigned int max,
153 void *elem, int elemsize,
154 int (*set)(const char *, struct kernel_param *kp),
155 int *num);
156
157/* for exporting parameters in /sys/parameters */
158
159struct module;
160
161extern int module_param_sysfs_setup(struct module *mod,
162 struct kernel_param *kparam,
163 unsigned int num_params);
164
165extern void module_param_sysfs_remove(struct module *mod);
166
167#endif /* _LINUX_MODULE_PARAMS_H */
Note: See TracBrowser for help on using the repository browser.