xref: /linux/init/Kconfig (revision 1da177e4c3f41524e886b7f1b8a0c1fc7321cac2)
1menu "Code maturity level options"
2
3config 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
34config 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
43config BROKEN
44	bool
45	depends on !CLEAN_COMPILE
46	default y
47
48config BROKEN_ON_SMP
49	bool
50	depends on BROKEN || !SMP
51	default y
52
53config LOCK_KERNEL
54	bool
55	depends on SMP || PREEMPT
56	default y
57
58config INIT_ENV_ARG_LIMIT
59	int
60	default 32 if !USERMODE
61	default 128 if USERMODE
62	help
63	  This is the value of the two limits on the number of argument and of
64	  env.var passed to init from the kernel command line.
65
66endmenu
67
68menu "General setup"
69
70config LOCALVERSION
71	string "Local version - append to kernel release"
72	help
73	  Append an extra string to the end of your kernel version.
74	  This will show up when you type uname, for example.
75	  The string you set here will be appended after the contents of
76	  any files with a filename matching localversion* in your
77	  object and source tree, in that order.  Your total string can
78	  be a maximum of 64 characters.
79
80config SWAP
81	bool "Support for paging of anonymous memory (swap)"
82	depends on MMU
83	default y
84	help
85	  This option allows you to choose whether you want to have support
86	  for socalled swap devices or swap files in your kernel that are
87	  used to provide more virtual memory than the actual RAM present
88	  in your computer.  If unsure say Y.
89
90config SYSVIPC
91	bool "System V IPC"
92	depends on MMU
93	---help---
94	  Inter Process Communication is a suite of library functions and
95	  system calls which let processes (running programs) synchronize and
96	  exchange information. It is generally considered to be a good thing,
97	  and some programs won't run unless you say Y here. In particular, if
98	  you want to run the DOS emulator dosemu under Linux (read the
99	  DOSEMU-HOWTO, available from <http://www.tldp.org/docs.html#howto>),
100	  you'll need to say Y here.
101
102	  You can find documentation about IPC with "info ipc" and also in
103	  section 6.4 of the Linux Programmer's Guide, available from
104	  <http://www.tldp.org/guides.html>.
105
106config POSIX_MQUEUE
107	bool "POSIX Message Queues"
108	depends on NET && EXPERIMENTAL
109	---help---
110	  POSIX variant of message queues is a part of IPC. In POSIX message
111	  queues every message has a priority which decides about succession
112	  of receiving it by a process. If you want to compile and run
113	  programs written e.g. for Solaris with use of its POSIX message
114	  queues (functions mq_*) say Y here. To use this feature you will
115	  also need mqueue library, available from
116	  <http://www.mat.uni.torun.pl/~wrona/posix_ipc/>
117
118	  POSIX message queues are visible as a filesystem called 'mqueue'
119	  and can be mounted somewhere if you want to do filesystem
120	  operations on message queues.
121
122	  If unsure, say Y.
123
124config BSD_PROCESS_ACCT
125	bool "BSD Process Accounting"
126	help
127	  If you say Y here, a user level program will be able to instruct the
128	  kernel (via a special system call) to write process accounting
129	  information to a file: whenever a process exits, information about
130	  that process will be appended to the file by the kernel.  The
131	  information includes things such as creation time, owning user,
132	  command name, memory usage, controlling terminal etc. (the complete
133	  list is in the struct acct in <file:include/linux/acct.h>).  It is
134	  up to the user level program to do useful things with this
135	  information.  This is generally a good idea, so say Y.
136
137config BSD_PROCESS_ACCT_V3
138	bool "BSD Process Accounting version 3 file format"
139	depends on BSD_PROCESS_ACCT
140	default n
141	help
142	  If you say Y here, the process accounting information is written
143	  in a new file format that also logs the process IDs of each
144	  process and it's parent. Note that this file format is incompatible
145	  with previous v0/v1/v2 file formats, so you will need updated tools
146	  for processing it. A preliminary version of these tools is available
147	  at <http://www.physik3.uni-rostock.de/tim/kernel/utils/acct/>.
148
149config SYSCTL
150	bool "Sysctl support"
151	---help---
152	  The sysctl interface provides a means of dynamically changing
153	  certain kernel parameters and variables on the fly without requiring
154	  a recompile of the kernel or reboot of the system.  The primary
155	  interface consists of a system call, but if you say Y to "/proc
156	  file system support", a tree of modifiable sysctl entries will be
157	  generated beneath the /proc/sys directory. They are explained in the
158	  files in <file:Documentation/sysctl/>.  Note that enabling this
159	  option will enlarge the kernel by at least 8 KB.
160
161	  As it is generally a good thing, you should say Y here unless
162	  building a kernel for install/rescue disks or your system is very
163	  limited in memory.
164
165config AUDIT
166	bool "Auditing support"
167	default y if SECURITY_SELINUX
168	help
169	  Enable auditing infrastructure that can be used with another
170	  kernel subsystem, such as SELinux (which requires this for
171	  logging of avc messages output).  Does not do system-call
172	  auditing without CONFIG_AUDITSYSCALL.
173
174config AUDITSYSCALL
175	bool "Enable system-call auditing support"
176	depends on AUDIT && (X86 || PPC64 || ARCH_S390 || IA64)
177	default y if SECURITY_SELINUX
178	help
179	  Enable low-overhead system-call auditing infrastructure that
180	  can be used independently or with another kernel subsystem,
181	  such as SELinux.
182
183config HOTPLUG
184	bool "Support for hot-pluggable devices" if !ARCH_S390
185	default ARCH_S390
186	help
187	  This option is provided for the case where no in-kernel-tree
188	  modules require HOTPLUG functionality, but a module built
189	  outside the kernel tree does. Such modules require Y here.
190
191config KOBJECT_UEVENT
192	bool "Kernel Userspace Events"
193	depends on NET
194	default y
195	help
196	  This option enables the kernel userspace event layer, which is a
197	  simple mechanism for kernel-to-user communication over a netlink
198	  socket.
199	  The goal of the kernel userspace events layer is to provide a simple
200	  and efficient events system, that notifies userspace about kobject
201	  state changes. This will enable applications to just listen for
202	  events instead of polling system devices and files.
203	  Hotplug events (kobject addition and removal) are also available on
204	  the netlink socket in addition to the execution of /sbin/hotplug if
205	  CONFIG_HOTPLUG is enabled.
206
207	  Say Y, unless you are building a system requiring minimal memory
208	  consumption.
209
210config IKCONFIG
211	bool "Kernel .config support"
212	---help---
213	  This option enables the complete Linux kernel ".config" file
214	  contents to be saved in the kernel. It provides documentation
215	  of which kernel options are used in a running kernel or in an
216	  on-disk kernel.  This information can be extracted from the kernel
217	  image file with the script scripts/extract-ikconfig and used as
218	  input to rebuild the current kernel or to build another kernel.
219	  It can also be extracted from a running kernel by reading
220	  /proc/config.gz if enabled (below).
221
222config IKCONFIG_PROC
223	bool "Enable access to .config through /proc/config.gz"
224	depends on IKCONFIG && PROC_FS
225	---help---
226	  This option enables access to the kernel configuration file
227	  through /proc/config.gz.
228
229config CPUSETS
230	bool "Cpuset support"
231	depends on SMP
232	help
233	  This options will let you create and manage CPUSET's which
234	  allow dynamically partitioning a system into sets of CPUs and
235	  Memory Nodes and assigning tasks to run only within those sets.
236	  This is primarily useful on large SMP or NUMA systems.
237
238	  Say N if unsure.
239
240menuconfig EMBEDDED
241	bool "Configure standard kernel features (for small systems)"
242	help
243	  This option allows certain base kernel options and settings
244          to be disabled or tweaked. This is for specialized
245          environments which can tolerate a "non-standard" kernel.
246          Only use this if you really know what you are doing.
247
248config KALLSYMS
249	 bool "Load all symbols for debugging/kksymoops" if EMBEDDED
250	 default y
251	 help
252	   Say Y here to let the kernel print out symbolic crash information and
253	   symbolic stack backtraces. This increases the size of the kernel
254	   somewhat, as all symbols have to be loaded into the kernel image.
255
256config KALLSYMS_ALL
257	bool "Include all symbols in kallsyms"
258	depends on DEBUG_KERNEL && KALLSYMS
259	help
260	   Normally kallsyms only contains the symbols of functions, for nicer
261	   OOPS messages.  Some debuggers can use kallsyms for other
262	   symbols too: say Y here to include all symbols, and you
263	   don't care about adding 300k to the size of your kernel.
264
265	   Say N.
266
267config KALLSYMS_EXTRA_PASS
268	bool "Do an extra kallsyms pass"
269	depends on KALLSYMS
270	help
271	   If kallsyms is not working correctly, the build will fail with
272	   inconsistent kallsyms data.  If that occurs, log a bug report and
273	   turn on KALLSYMS_EXTRA_PASS which should result in a stable build.
274	   Always say N here unless you find a bug in kallsyms, which must be
275	   reported.  KALLSYMS_EXTRA_PASS is only a temporary workaround while
276	   you wait for kallsyms to be fixed.
277
278config BASE_FULL
279	default y
280	bool "Enable full-sized data structures for core" if EMBEDDED
281	help
282	  Disabling this option reduces the size of miscellaneous core
283	  kernel data structures. This saves memory on small machines,
284	  but may reduce performance.
285
286config FUTEX
287	bool "Enable futex support" if EMBEDDED
288	default y
289	help
290	  Disabling this option will cause the kernel to be built without
291	  support for "fast userspace mutexes".  The resulting kernel may not
292	  run glibc-based applications correctly.
293
294config EPOLL
295	bool "Enable eventpoll support" if EMBEDDED
296	default y
297	help
298	  Disabling this option will cause the kernel to be built without
299	  support for epoll family of system calls.
300
301config CC_OPTIMIZE_FOR_SIZE
302	bool "Optimize for size" if EMBEDDED
303	default y if ARM || H8300
304	help
305	  Enabling this option will pass "-Os" instead of "-O2" to gcc
306	  resulting in a smaller kernel.
307
308	  WARNING: some versions of gcc may generate incorrect code with this
309	  option.  If problems are observed, a gcc upgrade may be needed.
310
311	  If unsure, say N.
312
313config SHMEM
314	bool "Use full shmem filesystem" if EMBEDDED
315	default y
316	depends on MMU
317	help
318	  The shmem is an internal filesystem used to manage shared memory.
319	  It is backed by swap and manages resource limits. It is also exported
320	  to userspace as tmpfs if TMPFS is enabled. Disabling this
321	  option replaces shmem and tmpfs with the much simpler ramfs code,
322	  which may be appropriate on small systems without swap.
323
324config CC_ALIGN_FUNCTIONS
325	int "Function alignment" if EMBEDDED
326	default 0
327	help
328	  Align the start of functions to the next power-of-two greater than n,
329	  skipping up to n bytes.  For instance, 32 aligns functions
330	  to the next 32-byte boundary, but 24 would align to the next
331	  32-byte boundary only if this can be done by skipping 23 bytes or less.
332	  Zero means use compiler's default.
333
334config CC_ALIGN_LABELS
335	int "Label alignment" if EMBEDDED
336	default 0
337	help
338	  Align all branch targets to a power-of-two boundary, skipping
339	  up to n bytes like ALIGN_FUNCTIONS.  This option can easily
340	  make code slower, because it must insert dummy operations for
341	  when the branch target is reached in the usual flow of the code.
342	  Zero means use compiler's default.
343
344config CC_ALIGN_LOOPS
345	int "Loop alignment" if EMBEDDED
346	default 0
347	help
348	  Align loops to a power-of-two boundary, skipping up to n bytes.
349	  Zero means use compiler's default.
350
351config CC_ALIGN_JUMPS
352	int "Jump alignment" if EMBEDDED
353	default 0
354	help
355	  Align branch targets to a power-of-two boundary, for branch
356	  targets where the targets can only be reached by jumping,
357	  skipping up to n bytes like ALIGN_FUNCTIONS.  In this case,
358	  no dummy operations need be executed.
359	  Zero means use compiler's default.
360
361endmenu		# General setup
362
363config TINY_SHMEM
364	default !SHMEM
365	bool
366
367config BASE_SMALL
368	int
369	default 0 if BASE_FULL
370	default 1 if !BASE_FULL
371
372menu "Loadable module support"
373
374config MODULES
375	bool "Enable loadable module support"
376	help
377	  Kernel modules are small pieces of compiled code which can
378	  be inserted in the running kernel, rather than being
379	  permanently built into the kernel.  You use the "modprobe"
380	  tool to add (and sometimes remove) them.  If you say Y here,
381	  many parts of the kernel can be built as modules (by
382	  answering M instead of Y where indicated): this is most
383	  useful for infrequently used options which are not required
384	  for booting.  For more information, see the man pages for
385	  modprobe, lsmod, modinfo, insmod and rmmod.
386
387	  If you say Y here, you will need to run "make
388	  modules_install" to put the modules under /lib/modules/
389	  where modprobe can find them (you may need to be root to do
390	  this).
391
392	  If unsure, say Y.
393
394config MODULE_UNLOAD
395	bool "Module unloading"
396	depends on MODULES
397	help
398	  Without this option you will not be able to unload any
399	  modules (note that some modules may not be unloadable
400	  anyway), which makes your kernel slightly smaller and
401	  simpler.  If unsure, say Y.
402
403config MODULE_FORCE_UNLOAD
404	bool "Forced module unloading"
405	depends on MODULE_UNLOAD && EXPERIMENTAL
406	help
407	  This option allows you to force a module to unload, even if the
408	  kernel believes it is unsafe: the kernel will remove the module
409	  without waiting for anyone to stop using it (using the -f option to
410	  rmmod).  This is mainly for kernel developers and desperate users.
411	  If unsure, say N.
412
413config OBSOLETE_MODPARM
414	bool
415	default y
416	depends on MODULES
417	help
418	  You need this option to use module parameters on modules which
419	  have not been converted to the new module parameter system yet.
420	  If unsure, say Y.
421
422config MODVERSIONS
423	bool "Module versioning support (EXPERIMENTAL)"
424	depends on MODULES && EXPERIMENTAL && !UML
425	help
426	  Usually, you have to use modules compiled with your kernel.
427	  Saying Y here makes it sometimes possible to use modules
428	  compiled for different kernels, by adding enough information
429	  to the modules to (hopefully) spot any changes which would
430	  make them incompatible with the kernel you are running.  If
431	  unsure, say N.
432
433config MODULE_SRCVERSION_ALL
434	bool "Source checksum for all modules"
435	depends on MODULES
436	help
437	  Modules which contain a MODULE_VERSION get an extra "srcversion"
438	  field inserted into their modinfo section, which contains a
439    	  sum of the source files which made it.  This helps maintainers
440	  see exactly which source was used to build a module (since
441	  others sometimes change the module source without updating
442	  the version).  With this option, such a "srcversion" field
443	  will be created for all modules.  If unsure, say N.
444
445config KMOD
446	bool "Automatic kernel module loading"
447	depends on MODULES
448	help
449	  Normally when you have selected some parts of the kernel to
450	  be created as kernel modules, you must load them (using the
451	  "modprobe" command) before you can use them. If you say Y
452	  here, some parts of the kernel will be able to load modules
453	  automatically: when a part of the kernel needs a module, it
454	  runs modprobe with the appropriate arguments, thereby
455	  loading the module if it is available.  If unsure, say Y.
456
457config STOP_MACHINE
458	bool
459	default y
460	depends on (SMP && MODULE_UNLOAD) || HOTPLUG_CPU
461	help
462	  Need stop_machine() primitive.
463endmenu
464