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

Last change on this file was 695, checked in by David Azarewicz, 4 years ago

Merge changes from next branch.
File size: 6.8 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
66#ifndef TARGET_OS2
67#define module_param(name, type, perm) \
68 module_param_named(name, name, type, perm)
69#endif
70/* Actually copy string: maxlen param is usually sizeof(string). */
71#define module_param_string(name, string, len, perm) \
72 static struct kparam_string __param_string_##name \
73 = { len, string }; \
74 module_param_call(name, param_set_copystring, param_get_string, \
75 &__param_string_##name, perm)
76
77/* Called on module insert or kernel boot */
78extern int parse_args(const char *name,
79 char *args,
80 struct kernel_param *params,
81 unsigned num,
82 int (*unknown)(char *param, char *val));
83
84/* All the helper functions */
85/* The macros to do compile-time type checking stolen from Jakub
86 Jelinek, who IIRC came up with this idea for the 2.4 module init code. */
87#define __param_check(name, p, type) \
88 static inline type *__check_##name(void) { return(p); }
89
90extern int param_set_byte(const char *val, struct kernel_param *kp);
91extern int param_get_byte(char *buffer, struct kernel_param *kp);
92#define param_check_byte(name, p) __param_check(name, p, unsigned char)
93
94extern int param_set_short(const char *val, struct kernel_param *kp);
95extern int param_get_short(char *buffer, struct kernel_param *kp);
96#define param_check_short(name, p) __param_check(name, p, short)
97
98extern int param_set_ushort(const char *val, struct kernel_param *kp);
99extern int param_get_ushort(char *buffer, struct kernel_param *kp);
100#define param_check_ushort(name, p) __param_check(name, p, unsigned short)
101
102static inline int param_set_int(const char *val, const struct kernel_param *kp) {return 0;};
103static inline int param_get_int(char *buffer, const struct kernel_param *kp) {return 0;};
104#define param_check_int(name, p) __param_check(name, p, int)
105
106extern int param_set_uint(const char *val, struct kernel_param *kp);
107extern int param_get_uint(char *buffer, struct kernel_param *kp);
108#define param_check_uint(name, p) __param_check(name, p, unsigned int)
109
110extern int param_set_long(const char *val, struct kernel_param *kp);
111extern int param_get_long(char *buffer, struct kernel_param *kp);
112#define param_check_long(name, p) __param_check(name, p, long)
113
114extern int param_set_ulong(const char *val, struct kernel_param *kp);
115extern int param_get_ulong(char *buffer, struct kernel_param *kp);
116#define param_check_ulong(name, p) __param_check(name, p, unsigned long)
117
118extern int param_set_charp(const char *val, struct kernel_param *kp);
119extern int param_get_charp(char *buffer, struct kernel_param *kp);
120#define param_check_charp(name, p) __param_check(name, p, char *)
121
122extern int param_set_bool(const char *val, struct kernel_param *kp);
123extern int param_get_bool(char *buffer, struct kernel_param *kp);
124#define param_check_bool(name, p) __param_check(name, p, int)
125
126extern int param_set_invbool(const char *val, struct kernel_param *kp);
127extern int param_get_invbool(char *buffer, struct kernel_param *kp);
128#define param_check_invbool(name, p) __param_check(name, p, int)
129
130/* Comma-separated array: *nump is set to number they actually specified. */
131#define module_param_array_named(name, array, type, nump, perm) \
132 static struct kparam_array __param_arr_##name \
133 = { ARRAY_SIZE(array), nump, param_set_##type, param_get_##type,\
134 sizeof(array[0]), array }; \
135 module_param_call(name, param_array_set, param_array_get, \
136 &__param_arr_##name, perm)
137
138#define module_param_array(name, type, nump, perm)
139#define module_param(name, type, perm)
140extern int param_array_set(const char *val, struct kernel_param *kp);
141extern int param_array_get(char *buffer, struct kernel_param *kp);
142
143extern int param_set_copystring(const char *val, struct kernel_param *kp);
144extern int param_get_string(char *buffer, struct kernel_param *kp);
145
146int param_array(const char *name,
147 const char *val,
148 unsigned int min, unsigned int max,
149 void *elem, int elemsize,
150 int (*set)(const char *, struct kernel_param *kp),
151 int *num);
152
153/* for exporting parameters in /sys/parameters */
154
155struct module;
156
157extern int module_param_sysfs_setup(struct module *mod,
158 struct kernel_param *kparam,
159 unsigned int num_params);
160
161extern void module_param_sysfs_remove(struct module *mod);
162
163struct kernel_param_ops {
164 /* Returns 0, or -errno. arg is in kp->arg. */
165 int (*set)(const char *val, const struct kernel_param *kp);
166 /* Returns length written or -errno. Buffer is 4k (ie. be short!) */
167 int (*get)(char *buffer, const struct kernel_param *kp);
168 /* Optional function to free kp->arg when module unloaded. */
169 void (*free)(void *arg);
170};
171
172#define module_param_hw_array(name, type, hwtype, nump, perm)
173#define module_param_hw(name, type, hwtype, perm)
174#define MODULE_PARM(var,type)
175#define MODULE_PARM_DESC(var,desc)
176
177#endif /* _LINUX_MODULE_PARAMS_H */
Note: See TracBrowser for help on using the repository browser.