a7dcb3ab376d5863f5b50778725fbbf12a2f4bfe
[external/busybox.git] / util-linux / modutils / Config.src
1 #
2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
4 #
5
6 menu "Linux Module Utilities"
7
8 INSERT
9
10 config MODPROBE_SMALL
11         bool "Simplified modutils"
12         default y
13         help
14           Simplified modutils.
15
16           With this option modprobe does not require modules.dep file
17           and does not use /etc/modules.conf file.
18           It scans module files in /lib/modules/`uname -r` and
19           determines dependencies and module alias names on the fly.
20           This may make module loading slower, most notably
21           when one needs to load module by alias (this requires
22           scanning through module _bodies_).
23
24           At the first attempt to load a module by alias modprobe
25           will try to generate modules.dep.bb file in order to speed up
26           future loads by alias. Failure to do so (read-only /lib/modules,
27           etc) is not reported, and future modprobes will be slow too.
28
29           NB: modules.dep.bb file format is not compatible
30           with modules.dep file as created/used by standard module tools.
31
32           Additional module parameters can be stored in
33           /etc/modules/$module_name files.
34
35           Apart from modprobe, other utilities are also provided:
36           - insmod is an alias to modprobe
37           - rmmod is an alias to modprobe -r
38           - depmod generates modules.dep.bb
39
40           As of 2008-07, this code is experimental. It is 14kb smaller
41           than "non-small" modutils.
42
43 config FEATURE_MODPROBE_SMALL_OPTIONS_ON_CMDLINE
44         bool "Accept module options on modprobe command line"
45         default y
46         depends on MODPROBE_SMALL
47         help
48           Allow insmod and modprobe take module options from command line.
49
50 config FEATURE_MODPROBE_SMALL_CHECK_ALREADY_LOADED
51         bool "Skip loading of already loaded modules"
52         default y
53         depends on MODPROBE_SMALL
54         help
55           Check if the module is already loaded.
56
57 config INSMOD
58         bool "insmod"
59         default n
60         depends on !MODPROBE_SMALL
61         help
62           insmod is used to load specified modules in the running kernel.
63
64 config RMMOD
65         bool "rmmod"
66         default n
67         depends on !MODPROBE_SMALL
68         help
69           rmmod is used to unload specified modules from the kernel.
70
71 config LSMOD
72         bool "lsmod"
73         default n
74         depends on !MODPROBE_SMALL
75         help
76           lsmod is used to display a list of loaded modules.
77
78 config FEATURE_LSMOD_PRETTY_2_6_OUTPUT
79         bool "Pretty output"
80         default n
81         depends on LSMOD
82         help
83           This option makes output format of lsmod adjusted to
84           the format of module-init-tools for Linux kernel 2.6.
85           Increases size somewhat.
86
87 config MODPROBE
88         bool "modprobe"
89         default n
90         depends on !MODPROBE_SMALL
91         help
92           Handle the loading of modules, and their dependencies on a high
93           level.
94
95 config FEATURE_MODPROBE_BLACKLIST
96         bool "Blacklist support"
97         default n
98         depends on MODPROBE
99         help
100           Say 'y' here to enable support for the 'blacklist' command in
101           modprobe.conf. This prevents the alias resolver to resolve
102           blacklisted modules. This is useful if you want to prevent your
103           hardware autodetection scripts to load modules like evdev, frame
104           buffer drivers etc.
105
106 config DEPMOD
107         bool "depmod"
108         default n
109         depends on !MODPROBE_SMALL
110         help
111           depmod generates modules.dep (and potentially modules.alias
112           and modules.symbols) that contain dependency information
113           for modprobe.
114
115 comment "Options common to multiple modutils"
116
117 config FEATURE_2_4_MODULES
118         bool "Support version 2.2/2.4 Linux kernels"
119         default n
120         depends on INSMOD || RMMOD || LSMOD
121         help
122           Support module loading for 2.2.x and 2.4.x Linux kernels.
123           This increases size considerably. Say N unless you plan
124           to run ancient kernels.
125
126 config FEATURE_INSMOD_TRY_MMAP
127         bool "Try to load module from a mmap'ed area"
128         default n
129         depends on INSMOD || MODPROBE_SMALL
130         help
131           This option causes module loading code to try to mmap
132           module first. If it does not work (for example,
133           it does not work for compressed modules), module will be read
134           (and unpacked if needed) into a memory block allocated by malloc.
135
136           The only case when mmap works but malloc does not is when
137           you are trying to load a big module on a very memory-constrained
138           machine. Malloc will momentarily need 2x as much memory as mmap.
139
140           Choosing N saves about 250 bytes of code (on 32-bit x86).
141
142 config FEATURE_INSMOD_VERSION_CHECKING
143         bool "Enable module version checking"
144         default n
145         depends on FEATURE_2_4_MODULES && (INSMOD || MODPROBE)
146         help
147           Support checking of versions for modules. This is used to
148           ensure that the kernel and module are made for each other.
149
150 config FEATURE_INSMOD_KSYMOOPS_SYMBOLS
151         bool "Add module symbols to kernel symbol table"
152         default n
153         depends on FEATURE_2_4_MODULES && (INSMOD || MODPROBE)
154         help
155           By adding module symbols to the kernel symbol table, Oops messages
156           occuring within kernel modules can be properly debugged. By enabling
157           this feature, module symbols will always be added to the kernel symbol
158           table for proper debugging support. If you are not interested in
159           Oops messages from kernel modules, say N.
160
161 config FEATURE_INSMOD_LOADINKMEM
162         bool "In kernel memory optimization (uClinux only)"
163         default n
164         depends on FEATURE_2_4_MODULES && (INSMOD || MODPROBE)
165         help
166           This is a special uClinux only memory optimization that lets insmod
167           load the specified kernel module directly into kernel space, reducing
168           memory usage by preventing the need for two copies of the module
169           being loaded into memory.
170
171 config FEATURE_INSMOD_LOAD_MAP
172         bool "Enable insmod load map (-m) option"
173         default n
174         depends on FEATURE_2_4_MODULES && INSMOD
175         help
176           Enabling this, one would be able to get a load map
177           output on stdout. This makes kernel module debugging
178           easier.
179           If you don't plan to debug kernel modules, you
180           don't need this option.
181
182 config FEATURE_INSMOD_LOAD_MAP_FULL
183         bool "Symbols in load map"
184         default y
185         depends on FEATURE_INSMOD_LOAD_MAP && !MODPROBE_SMALL
186         help
187           Without this option, -m will only output section
188           load map. With this option, -m will also output
189           symbols load map.
190
191 config FEATURE_CHECK_TAINTED_MODULE
192         bool "Support tainted module checking with new kernels"
193         default y
194         depends on (LSMOD || FEATURE_2_4_MODULES) && !MODPROBE_SMALL
195         help
196           Support checking for tainted modules. These are usually binary
197           only modules that will make the linux-kernel list ignore your
198           support request.
199           This option is required to support GPLONLY modules.
200
201 config FEATURE_MODUTILS_ALIAS
202         bool "Support for module.aliases file"
203         default y
204         depends on DEPMOD || MODPROBE
205         help
206           Generate and parse modules.alias containing aliases for bus
207           identifiers:
208             alias pcmcia:m*c*f03fn*pfn*pa*pb*pc*pd* parport_cs
209
210           and aliases for logical modules names e.g.:
211             alias padlock_aes aes
212             alias aes_i586 aes
213             alias aes_generic aes
214
215           Say Y if unsure.
216
217 config FEATURE_MODUTILS_SYMBOLS
218         bool "Support for module.symbols file"
219         default y
220         depends on DEPMOD || MODPROBE
221         help
222           Generate and parse modules.symbols containing aliases for
223           symbol_request() kernel calls, such as:
224             alias symbol:usb_sg_init usbcore
225
226           Say Y if unsure.
227
228 config DEFAULT_MODULES_DIR
229         string "Default directory containing modules"
230         default "/lib/modules"
231         depends on DEPMOD || MODPROBE || MODPROBE_SMALL || MODINFO
232         help
233           Directory that contains kernel modules.
234           Defaults to "/lib/modules"
235
236 config DEFAULT_DEPMOD_FILE
237         string "Default name of modules.dep"
238         default "modules.dep"
239         depends on DEPMOD || MODPROBE || MODPROBE_SMALL || MODINFO
240         help
241           Filename that contains kernel modules dependencies.
242           Defaults to "modules.dep"
243
244 endmenu