Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 | config 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 | |
| 66 | endmenu |
| 67 | |
| 68 | menu "General setup" |
| 69 | |
| 70 | config 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 | |
| 80 | config 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 | |
| 90 | config 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 | |
| 106 | config 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 | |
| 124 | config 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 | |
| 137 | config 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 | |
| 149 | config 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 | |
| 165 | config 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 | |
| 174 | config 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 | |
| 183 | config 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 | |
| 191 | config 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 | |
| 210 | config 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 | |
| 222 | config 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 | |
| 229 | config 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 | |
| 240 | menuconfig 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 | |
| 248 | config 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 | |
| 256 | config 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 | |
| 267 | config 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 | |
Matt Mackall | c8538a7 | 2005-05-01 08:59:01 -0700 | [diff] [blame] | 278 | config BUG |
| 279 | bool "BUG() support" if EMBEDDED |
| 280 | default y |
| 281 | help |
| 282 | Disabling this option eliminates support for BUG and WARN, reducing |
| 283 | the size of your kernel image and potentially quietly ignoring |
| 284 | numerous fatal conditions. You should only consider disabling this |
| 285 | option for embedded systems with no facilities for reporting errors. |
| 286 | Just say Y. |
| 287 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 288 | config BASE_FULL |
| 289 | default y |
| 290 | bool "Enable full-sized data structures for core" if EMBEDDED |
| 291 | help |
| 292 | Disabling this option reduces the size of miscellaneous core |
| 293 | kernel data structures. This saves memory on small machines, |
| 294 | but may reduce performance. |
| 295 | |
| 296 | config FUTEX |
| 297 | bool "Enable futex support" if EMBEDDED |
| 298 | default y |
| 299 | help |
| 300 | Disabling this option will cause the kernel to be built without |
| 301 | support for "fast userspace mutexes". The resulting kernel may not |
| 302 | run glibc-based applications correctly. |
| 303 | |
| 304 | config EPOLL |
| 305 | bool "Enable eventpoll support" if EMBEDDED |
| 306 | default y |
| 307 | help |
| 308 | Disabling this option will cause the kernel to be built without |
| 309 | support for epoll family of system calls. |
| 310 | |
| 311 | config CC_OPTIMIZE_FOR_SIZE |
| 312 | bool "Optimize for size" if EMBEDDED |
| 313 | default y if ARM || H8300 |
| 314 | help |
| 315 | Enabling this option will pass "-Os" instead of "-O2" to gcc |
| 316 | resulting in a smaller kernel. |
| 317 | |
| 318 | WARNING: some versions of gcc may generate incorrect code with this |
| 319 | option. If problems are observed, a gcc upgrade may be needed. |
| 320 | |
| 321 | If unsure, say N. |
| 322 | |
| 323 | config SHMEM |
| 324 | bool "Use full shmem filesystem" if EMBEDDED |
| 325 | default y |
| 326 | depends on MMU |
| 327 | help |
| 328 | The shmem is an internal filesystem used to manage shared memory. |
| 329 | It is backed by swap and manages resource limits. It is also exported |
| 330 | to userspace as tmpfs if TMPFS is enabled. Disabling this |
| 331 | option replaces shmem and tmpfs with the much simpler ramfs code, |
| 332 | which may be appropriate on small systems without swap. |
| 333 | |
| 334 | config CC_ALIGN_FUNCTIONS |
| 335 | int "Function alignment" if EMBEDDED |
| 336 | default 0 |
| 337 | help |
| 338 | Align the start of functions to the next power-of-two greater than n, |
| 339 | skipping up to n bytes. For instance, 32 aligns functions |
| 340 | to the next 32-byte boundary, but 24 would align to the next |
| 341 | 32-byte boundary only if this can be done by skipping 23 bytes or less. |
| 342 | Zero means use compiler's default. |
| 343 | |
| 344 | config CC_ALIGN_LABELS |
| 345 | int "Label alignment" if EMBEDDED |
| 346 | default 0 |
| 347 | help |
| 348 | Align all branch targets to a power-of-two boundary, skipping |
| 349 | up to n bytes like ALIGN_FUNCTIONS. This option can easily |
| 350 | make code slower, because it must insert dummy operations for |
| 351 | when the branch target is reached in the usual flow of the code. |
| 352 | Zero means use compiler's default. |
| 353 | |
| 354 | config CC_ALIGN_LOOPS |
| 355 | int "Loop alignment" if EMBEDDED |
| 356 | default 0 |
| 357 | help |
| 358 | Align loops to a power-of-two boundary, skipping up to n bytes. |
| 359 | Zero means use compiler's default. |
| 360 | |
| 361 | config CC_ALIGN_JUMPS |
| 362 | int "Jump alignment" if EMBEDDED |
| 363 | default 0 |
| 364 | help |
| 365 | Align branch targets to a power-of-two boundary, for branch |
| 366 | targets where the targets can only be reached by jumping, |
| 367 | skipping up to n bytes like ALIGN_FUNCTIONS. In this case, |
| 368 | no dummy operations need be executed. |
| 369 | Zero means use compiler's default. |
| 370 | |
| 371 | endmenu # General setup |
| 372 | |
| 373 | config TINY_SHMEM |
| 374 | default !SHMEM |
| 375 | bool |
| 376 | |
| 377 | config BASE_SMALL |
| 378 | int |
| 379 | default 0 if BASE_FULL |
| 380 | default 1 if !BASE_FULL |
| 381 | |
| 382 | menu "Loadable module support" |
| 383 | |
| 384 | config MODULES |
| 385 | bool "Enable loadable module support" |
| 386 | help |
| 387 | Kernel modules are small pieces of compiled code which can |
| 388 | be inserted in the running kernel, rather than being |
| 389 | permanently built into the kernel. You use the "modprobe" |
| 390 | tool to add (and sometimes remove) them. If you say Y here, |
| 391 | many parts of the kernel can be built as modules (by |
| 392 | answering M instead of Y where indicated): this is most |
| 393 | useful for infrequently used options which are not required |
| 394 | for booting. For more information, see the man pages for |
| 395 | modprobe, lsmod, modinfo, insmod and rmmod. |
| 396 | |
| 397 | If you say Y here, you will need to run "make |
| 398 | modules_install" to put the modules under /lib/modules/ |
| 399 | where modprobe can find them (you may need to be root to do |
| 400 | this). |
| 401 | |
| 402 | If unsure, say Y. |
| 403 | |
| 404 | config MODULE_UNLOAD |
| 405 | bool "Module unloading" |
| 406 | depends on MODULES |
| 407 | help |
| 408 | Without this option you will not be able to unload any |
| 409 | modules (note that some modules may not be unloadable |
| 410 | anyway), which makes your kernel slightly smaller and |
| 411 | simpler. If unsure, say Y. |
| 412 | |
| 413 | config MODULE_FORCE_UNLOAD |
| 414 | bool "Forced module unloading" |
| 415 | depends on MODULE_UNLOAD && EXPERIMENTAL |
| 416 | help |
| 417 | This option allows you to force a module to unload, even if the |
| 418 | kernel believes it is unsafe: the kernel will remove the module |
| 419 | without waiting for anyone to stop using it (using the -f option to |
| 420 | rmmod). This is mainly for kernel developers and desperate users. |
| 421 | If unsure, say N. |
| 422 | |
| 423 | config OBSOLETE_MODPARM |
| 424 | bool |
| 425 | default y |
| 426 | depends on MODULES |
| 427 | help |
| 428 | You need this option to use module parameters on modules which |
| 429 | have not been converted to the new module parameter system yet. |
| 430 | If unsure, say Y. |
| 431 | |
| 432 | config MODVERSIONS |
| 433 | bool "Module versioning support (EXPERIMENTAL)" |
| 434 | depends on MODULES && EXPERIMENTAL && !UML |
| 435 | help |
| 436 | Usually, you have to use modules compiled with your kernel. |
| 437 | Saying Y here makes it sometimes possible to use modules |
| 438 | compiled for different kernels, by adding enough information |
| 439 | to the modules to (hopefully) spot any changes which would |
| 440 | make them incompatible with the kernel you are running. If |
| 441 | unsure, say N. |
| 442 | |
| 443 | config MODULE_SRCVERSION_ALL |
| 444 | bool "Source checksum for all modules" |
| 445 | depends on MODULES |
| 446 | help |
| 447 | Modules which contain a MODULE_VERSION get an extra "srcversion" |
| 448 | field inserted into their modinfo section, which contains a |
| 449 | sum of the source files which made it. This helps maintainers |
| 450 | see exactly which source was used to build a module (since |
| 451 | others sometimes change the module source without updating |
| 452 | the version). With this option, such a "srcversion" field |
| 453 | will be created for all modules. If unsure, say N. |
| 454 | |
| 455 | config KMOD |
| 456 | bool "Automatic kernel module loading" |
| 457 | depends on MODULES |
| 458 | help |
| 459 | Normally when you have selected some parts of the kernel to |
| 460 | be created as kernel modules, you must load them (using the |
| 461 | "modprobe" command) before you can use them. If you say Y |
| 462 | here, some parts of the kernel will be able to load modules |
| 463 | automatically: when a part of the kernel needs a module, it |
| 464 | runs modprobe with the appropriate arguments, thereby |
| 465 | loading the module if it is available. If unsure, say Y. |
| 466 | |
| 467 | config STOP_MACHINE |
| 468 | bool |
| 469 | default y |
| 470 | depends on (SMP && MODULE_UNLOAD) || HOTPLUG_CPU |
| 471 | help |
| 472 | Need stop_machine() primitive. |
| 473 | endmenu |