1ca9fa1b7b82b6a9f8535517ef274b5b12d436c7
[linux-2.6.git] / init / Kconfig
1 menu "Code maturity level options"
2
3 config EXPERIMENTAL
4         bool "Prompt for development and/or incomplete code/drivers"
5         ---help---
6           Some of the various things that Linux supports (such as network
7           drivers, file systems, network protocols, etc.) can be in a state
8           of development where the functionality, stability, or the level of
9           testing is not yet high enough for general use. This is usually
10           known as the "alpha-test" phase among developers. If a feature is
11           currently in alpha-test, then the developers usually discourage
12           uninformed widespread use of this feature by the general public to
13           avoid "Why doesn't this work?" type mail messages. However, active
14           testing and use of these systems is welcomed. Just be aware that it
15           may not meet the normal level of reliability or it may fail to work
16           in some special cases. Detailed bug reports from people familiar
17           with the kernel internals are usually welcomed by the developers
18           (before submitting bug reports, please read the documents
19           <file:README>, <file:MAINTAINERS>, <file:REPORTING-BUGS>,
20           <file:Documentation/BUG-HUNTING>, and
21           <file:Documentation/oops-tracing.txt> in the kernel source).
22
23           This option will also make obsoleted drivers available. These are
24           drivers that have been replaced by something else, and/or are
25           scheduled to be removed in a future kernel release.
26
27           Unless you intend to help test and develop a feature or driver that
28           falls into this category, or you have a situation that requires
29           using these features, you should probably say N here, which will
30           cause the configurator to present you with fewer choices. If
31           you say Y here, you will be offered the choice of using features or
32           drivers that are currently considered to be in the alpha-test phase.
33
34 config CLEAN_COMPILE
35         bool "Select only drivers expected to compile cleanly" if EXPERIMENTAL
36         default y
37         help
38           Select this option if you don't even want to see the option
39           to configure known-broken drivers.
40
41           If unsure, say Y
42
43 config BROKEN
44         bool
45         depends on !CLEAN_COMPILE
46         default y
47
48 config BROKEN_ON_SMP
49         bool
50         depends on BROKEN || !SMP
51         default y
52
53 config LOCK_KERNEL
54         bool
55         depends on SMP || PREEMPT
56         default y
57
58 endmenu
59
60 menu "General setup"
61
62 config LOCALVERSION
63         string "Local version - append to kernel release"
64         help
65           Append an extra string to the end of your kernel version.
66           This will show up when you type uname, for example.
67           The string you set here will be appended after the contents of
68           any files with a filename matching localversion* in your
69           object and source tree, in that order.  Your total string can
70           be a maximum of 64 characters.
71
72 config SWAP
73         bool "Support for paging of anonymous memory (swap)"
74         depends on MMU
75         default y
76         help
77           This option allows you to choose whether you want to have support
78           for socalled swap devices or swap files in your kernel that are
79           used to provide more virtual memory than the actual RAM present
80           in your computer.  If unsure say Y.
81
82 config SYSVIPC
83         bool "System V IPC"
84         depends on MMU
85         ---help---
86           Inter Process Communication is a suite of library functions and
87           system calls which let processes (running programs) synchronize and
88           exchange information. It is generally considered to be a good thing,
89           and some programs won't run unless you say Y here. In particular, if
90           you want to run the DOS emulator dosemu under Linux (read the
91           DOSEMU-HOWTO, available from <http://www.tldp.org/docs.html#howto>),
92           you'll need to say Y here.
93
94           You can find documentation about IPC with "info ipc" and also in
95           section 6.4 of the Linux Programmer's Guide, available from
96           <http://www.tldp.org/guides.html>.
97
98 config POSIX_MQUEUE
99         bool "POSIX Message Queues"
100         depends on NET && EXPERIMENTAL
101         ---help---
102           POSIX variant of message queues is a part of IPC. In POSIX message
103           queues every message has a priority which decides about succession
104           of receiving it by a process. If you want to compile and run
105           programs written e.g. for Solaris with use of its POSIX message
106           queues (functions mq_*) say Y here. To use this feature you will
107           also need mqueue library, available from
108           <http://www.mat.uni.torun.pl/~wrona/posix_ipc/>
109
110           POSIX message queues are visible as a filesystem called 'mqueue'
111           and can be mounted somewhere if you want to do filesystem
112           operations on message queues.
113
114           If unsure, say Y.
115
116 config BSD_PROCESS_ACCT
117         bool "BSD Process Accounting"
118         help
119           If you say Y here, a user level program will be able to instruct the
120           kernel (via a special system call) to write process accounting
121           information to a file: whenever a process exits, information about
122           that process will be appended to the file by the kernel.  The
123           information includes things such as creation time, owning user,
124           command name, memory usage, controlling terminal etc. (the complete
125           list is in the struct acct in <file:include/linux/acct.h>).  It is
126           up to the user level program to do useful things with this
127           information.  This is generally a good idea, so say Y.
128
129 config BSD_PROCESS_ACCT_V3
130         bool "BSD Process Accounting version 3 file format"
131         depends on BSD_PROCESS_ACCT
132         default n
133         help
134           If you say Y here, the process accounting information is written
135           in a new file format that also logs the process IDs of each
136           process and it's parent. Note that this file format is incompatible
137           with previous v0/v1/v2 file formats, so you will need updated tools
138           for processing it. A preliminary version of these tools is available
139           at <http://www.physik3.uni-rostock.de/tim/kernel/utils/acct/>.
140
141 config SYSCTL
142         bool "Sysctl support"
143         ---help---
144           The sysctl interface provides a means of dynamically changing
145           certain kernel parameters and variables on the fly without requiring
146           a recompile of the kernel or reboot of the system.  The primary
147           interface consists of a system call, but if you say Y to "/proc
148           file system support", a tree of modifiable sysctl entries will be
149           generated beneath the /proc/sys directory. They are explained in the
150           files in <file:Documentation/sysctl/>.  Note that enabling this
151           option will enlarge the kernel by at least 8 KB.
152
153           As it is generally a good thing, you should say Y here unless
154           building a kernel for install/rescue disks or your system is very
155           limited in memory.
156
157 config AUDIT
158         bool "Auditing support"
159         default y if SECURITY_SELINUX
160         default n
161         help
162           Enable auditing infrastructure that can be used with another
163           kernel subsystem, such as SELinux (which requires this for
164           logging of avc messages output).  Does not do system-call
165           auditing without CONFIG_AUDITSYSCALL.
166
167 config AUDITSYSCALL
168         bool "Enable system-call auditing support"
169         depends on AUDIT && (X86 || PPC64 || ARCH_S390 || IA64)
170         default y if SECURITY_SELINUX
171         default n
172         help
173           Enable low-overhead system-call auditing infrastructure that
174           can be used independently or with another kernel subsystem,
175           such as SELinux.
176
177 config LOG_BUF_SHIFT
178         int "Kernel log buffer size (16 => 64KB, 17 => 128KB)" if DEBUG_KERNEL
179         range 12 21
180         default 17 if ARCH_S390
181         default 16 if X86_NUMAQ || IA64
182         default 15 if SMP
183         default 14
184         help
185           Select kernel log buffer size as a power of 2.
186           Defaults and Examples:
187                      17 => 128 KB for S/390
188                      16 => 64 KB for x86 NUMAQ or IA-64
189                      15 => 32 KB for SMP
190                      14 => 16 KB for uniprocessor
191                      13 =>  8 KB
192                      12 =>  4 KB
193
194 config HOTPLUG
195         bool "Support for hot-pluggable devices" if !ARCH_S390
196         default ARCH_S390
197         help
198           Say Y here if you want to plug devices into your computer while
199           the system is running, and be able to use them quickly.  In many
200           cases, the devices can likewise be unplugged at any time too.
201
202           One well known example of this is PCMCIA- or PC-cards, credit-card
203           size devices such as network cards, modems or hard drives which are
204           plugged into slots found on all modern laptop computers.  Another
205           example, used on modern desktops as well as laptops, is USB.
206
207           Enable HOTPLUG and KMOD, and build a modular kernel.  Get agent
208           software (at <http://linux-hotplug.sourceforge.net/>) and install it.
209           Then your kernel will automatically call out to a user mode "policy
210           agent" (/sbin/hotplug) to load modules and set up software needed
211           to use devices as you hotplug them.
212
213 config KOBJECT_UEVENT
214         bool "Kernel Userspace Events"
215         depends on NET
216         default y
217         help
218           This option enables the kernel userspace event layer, which is a
219           simple mechanism for kernel-to-user communication over a netlink
220           socket.
221           The goal of the kernel userspace events layer is to provide a simple
222           and efficient events system, that notifies userspace about kobject
223           state changes. This will enable applications to just listen for
224           events instead of polling system devices and files.
225           Hotplug events (kobject addition and removal) are also available on
226           the netlink socket in addition to the execution of /sbin/hotplug if
227           CONFIG_HOTPLUG is enabled.
228
229           Say Y, unless you are building a system requiring minimal memory
230           consumption.
231
232 config IKCONFIG
233         bool "Kernel .config support"
234         ---help---
235           This option enables the complete Linux kernel ".config" file
236           contents to be saved in the kernel. It provides documentation
237           of which kernel options are used in a running kernel or in an
238           on-disk kernel.  This information can be extracted from the kernel
239           image file with the script scripts/extract-ikconfig and used as
240           input to rebuild the current kernel or to build another kernel.
241           It can also be extracted from a running kernel by reading
242           /proc/config.gz if enabled (below).
243
244 config IKCONFIG_PROC
245         bool "Enable access to .config through /proc/config.gz"
246         depends on IKCONFIG && PROC_FS
247         ---help---
248           This option enables access to the kernel configuration file
249           through /proc/config.gz.
250
251 config OOM_PANIC
252         bool "OOM Panic"
253         default y
254         ---help---
255           This option enables panic() to be called when a system is out of
256           memory. This feature along with /proc/sys/kernel/panic allows a
257           different behavior on out-of-memory conditions when the standard
258           behavior (killing processes in an attempt to recover) does not
259           make sense.
260
261           If unsure, say N.
262
263 config OOM_KILL
264         bool
265         depends on !OOM_PANIC
266         default y
267
268 menuconfig EMBEDDED
269         bool "Configure standard kernel features (for small systems)"
270         help
271           This option allows certain base kernel options and settings
272           to be disabled or tweaked. This is for specialized
273           environments which can tolerate a "non-standard" kernel.
274           Only use this if you really know what you are doing.
275
276 config DELAY_ACCT
277         bool "Enable delay accounting (EXPERIMENTAL)"
278         help
279           In addition to counting frequency the total delay in ns is also
280           recorded. CPU delays are specified as cpu-wait and cpu-run. 
281           I/O delays are recorded for memory and regular I/O.
282           Information is accessible through /proc/<pid>/delay.
283
284 config KALLSYMS
285          bool "Load all symbols for debugging/kksymoops" if EMBEDDED
286          default y
287          help
288            Say Y here to let the kernel print out symbolic crash information and
289            symbolic stack backtraces. This increases the size of the kernel
290            somewhat, as all symbols have to be loaded into the kernel image.
291
292 config KALLSYMS_ALL
293         bool "Include all symbols in kallsyms"
294         depends on DEBUG_KERNEL && KALLSYMS
295         help
296            Normally kallsyms only contains the symbols of functions, for nicer
297            OOPS messages.  Some debuggers can use kallsyms for other
298            symbols too: say Y here to include all symbols, and you
299            don't care about adding 300k to the size of your kernel.
300
301            Say N.
302
303 config KALLSYMS_EXTRA_PASS
304         bool "Do an extra kallsyms pass"
305         depends on KALLSYMS
306         help
307            If kallsyms is not working correctly, the build will fail with
308            inconsistent kallsyms data.  If that occurs, log a bug report and
309            turn on KALLSYMS_EXTRA_PASS which should result in a stable build.
310            Always say N here unless you find a bug in kallsyms, which must be
311            reported.  KALLSYMS_EXTRA_PASS is only a temporary workaround while
312            you wait for kallsyms to be fixed.
313
314 config FUTEX
315         bool "Enable futex support" if EMBEDDED
316         default y
317         help
318           Disabling this option will cause the kernel to be built without
319           support for "fast userspace mutexes".  The resulting kernel may not
320           run glibc-based applications correctly.
321
322 config EPOLL
323         bool "Enable eventpoll support" if EMBEDDED
324         default y
325         help
326           Disabling this option will cause the kernel to be built without
327           support for epoll family of system calls.
328
329 config CC_OPTIMIZE_FOR_SIZE
330         bool "Optimize for size"
331         default y if ARM || H8300
332         default n
333         help
334           Enabling this option will pass "-Os" instead of "-O2" to gcc
335           resulting in a smaller kernel.
336
337           WARNING: some versions of gcc may generate incorrect code with this
338           option.  If problems are observed, a gcc upgrade may be needed.
339
340           If unsure, say N.
341
342 config SHMEM
343         default y
344         bool "Use full shmem filesystem" if EMBEDDED && MMU
345         help
346           The shmem is an internal filesystem used to manage shared memory.
347           It is backed by swap and manages resource limits. It is also exported
348           to userspace as tmpfs if TMPFS is enabled. Disabling this
349           option replaces shmem and tmpfs with the much simpler ramfs code,
350           which may be appropriate on small systems without swap.
351
352 config CC_ALIGN_FUNCTIONS
353         int "Function alignment" if EMBEDDED
354         default 0
355         help
356           Align the start of functions to the next power-of-two greater than n,
357           skipping up to n bytes.  For instance, 32 aligns functions
358           to the next 32-byte boundary, but 24 would align to the next
359           32-byte boundary only if this can be done by skipping 23 bytes or less.
360           Zero means use compiler's default.
361
362 config CC_ALIGN_LABELS
363         int "Label alignment" if EMBEDDED
364         default 0
365         help
366           Align all branch targets to a power-of-two boundary, skipping
367           up to n bytes like ALIGN_FUNCTIONS.  This option can easily
368           make code slower, because it must insert dummy operations for
369           when the branch target is reached in the usual flow of the code.
370           Zero means use compiler's default.
371
372 config CC_ALIGN_LOOPS
373         int "Loop alignment" if EMBEDDED
374         default 0
375         help
376           Align loops to a power-of-two boundary, skipping up to n bytes.
377           Zero means use compiler's default.
378
379 config CC_ALIGN_JUMPS
380         int "Jump alignment" if EMBEDDED
381         default 0
382         help
383           Align branch targets to a power-of-two boundary, for branch
384           targets where the targets can only be reached by jumping,
385           skipping up to n bytes like ALIGN_FUNCTIONS.  In this case,
386           no dummy operations need be executed.
387           Zero means use compiler's default.
388
389 endmenu         # General setup
390
391 config TINY_SHMEM
392         default !SHMEM
393         bool
394
395 menu "Loadable module support"
396
397 config MODULES
398         bool "Enable loadable module support"
399         help
400           Kernel modules are small pieces of compiled code which can
401           be inserted in the running kernel, rather than being
402           permanently built into the kernel.  You use the "modprobe"
403           tool to add (and sometimes remove) them.  If you say Y here,
404           many parts of the kernel can be built as modules (by
405           answering M instead of Y where indicated): this is most
406           useful for infrequently used options which are not required
407           for booting.  For more information, see the man pages for
408           modprobe, lsmod, modinfo, insmod and rmmod.
409
410           If you say Y here, you will need to run "make
411           modules_install" to put the modules under /lib/modules/
412           where modprobe can find them (you may need to be root to do
413           this).
414
415           If unsure, say Y.
416
417 config MODULE_UNLOAD
418         bool "Module unloading"
419         depends on MODULES
420         help
421           Without this option you will not be able to unload any
422           modules (note that some modules may not be unloadable
423           anyway), which makes your kernel slightly smaller and
424           simpler.  If unsure, say Y.
425
426 config MODULE_FORCE_UNLOAD
427         bool "Forced module unloading"
428         depends on MODULE_UNLOAD && EXPERIMENTAL
429         help
430           This option allows you to force a module to unload, even if the
431           kernel believes it is unsafe: the kernel will remove the module
432           without waiting for anyone to stop using it (using the -f option to
433           rmmod).  This is mainly for kernel developers and desperate users.
434           If unsure, say N.
435
436 config OBSOLETE_MODPARM
437         bool
438         default y
439         depends on MODULES
440         help
441           You need this option to use module parameters on modules which
442           have not been converted to the new module parameter system yet.
443           If unsure, say Y.
444
445 config MODVERSIONS
446         bool "Module versioning support (EXPERIMENTAL)"
447         depends on MODULES && EXPERIMENTAL
448         help
449           Usually, you have to use modules compiled with your kernel.
450           Saying Y here makes it sometimes possible to use modules
451           compiled for different kernels, by adding enough information
452           to the modules to (hopefully) spot any changes which would
453           make them incompatible with the kernel you are running.  If
454           unsure, say N.
455
456 config MODULE_SRCVERSION_ALL
457         bool "Source checksum for all modules"
458         depends on MODULES
459         help
460           Modules which contain a MODULE_VERSION get an extra "srcversion"
461           field inserted into their modinfo section, which contains a
462           sum of the source files which made it.  This helps maintainers
463           see exactly which source was used to build a module (since
464           others sometimes change the module source without updating
465           the version).  With this option, such a "srcversion" field
466           will be created for all modules.  If unsure, say N.
467
468 config MODULE_SIG
469         bool "Module signature verification (EXPERIMENTAL)"
470         depends on MODULES && EXPERIMENTAL
471         select CRYPTO
472         select CRYPTO_SHA1
473         select CRYPTO_SIGNATURE
474         help
475           Check modules for valid signatures upon load.
476
477 config MODULE_SIG_FORCE
478         bool "Required modules to be validly signed (EXPERIMENTAL)"
479         depends on MODULE_SIG
480         help
481           Reject unsigned modules or signed modules for which we don't have a
482           key.
483
484 config KMOD
485         bool "Automatic kernel module loading"
486         depends on MODULES
487         help
488           Normally when you have selected some parts of the kernel to
489           be created as kernel modules, you must load them (using the
490           "modprobe" command) before you can use them. If you say Y
491           here, some parts of the kernel will be able to load modules
492           automatically: when a part of the kernel needs a module, it
493           runs modprobe with the appropriate arguments, thereby
494           loading the module if it is available.  If unsure, say Y.
495
496 config STOP_MACHINE
497         bool
498         default y
499         depends on (SMP && MODULE_UNLOAD) || HOTPLUG_CPU
500         help
501           Need stop_machine() primitive.
502 endmenu