Documentation/kernel-parameters.txt

   1 July 2000                 Kernel Parameters                     v2.4.0
   2                           ~~~~~~~~~~~~~~~~~
   3
   4 The following is a consolidated list of the kernel parameters as implemented
   5 by the __setup() macro and sorted into English Dictionary order (defined
   6 as ignoring all punctuation and sorting digits before letters in a case
   7 insensitive manner), and with descriptions where known.
   8
   9 The text in square brackets at the beginning of the description state the
  10 restrictions on the kernel for the said kernel parameter to be valid. The
  11 restrictions referred to are that the relevant option is valid if:
  12
  13         ACPI    ACPI support is enabled.
  14         APIC    APIC support is enabled.
  15         APM     Advanced Power Management support is enabled.
  16         AX25    Appropriate AX.25 support is enabled.
  17         CD      Appropriate CD support is enabled.
  18         DEVFS   devfs support is enabled.
  19         DRM     Direct Rendering Management support is enabled.
  20         EIDE    EIDE/ATAPI support is enabled.
  21         FB      The frame buffer device is enabled.
  22         HW      Appropriate hardware is enabled.
  23         IA-32   IA-32 aka i386 architecture is enabled.
  24         IA-64   IA-64 architecture is enabled.
  25         ISDN    Appropriate ISDN support is enabled.
  26         JOY     Appropriate joystick support is enabled.
  27         LP      Printer support is enabled.
  28         LOOP    Loopback device support is enabled.
  29         M68k    M68k architecture is enabled.
  30         MCA     MCA bus support is enabled.
  31         MDA     MDA console support is enabled.
  32         MOUSE   Appropriate mouse support is enabled.
  33         NET     Appropriate network support is enabled.
  34         NFS     Appropriate NFS support is enabled.
  35         PARIDE  The ParIDE subsystem is enabled.
  36         PCI     PCI bus support is enabled.
  37         PCMCIA  The PCMCIA subsystem is enabled.
  38         PNP     Plug & Play support is enabled.
  39         PPT     Parallel port support is enabled.
  40         PS2     Appropriate PS/2 support is enabled.
  41         RAM     RAM disk support is enabled.
  42         SCSI    Appropriate SCSI support is enabled.
  43         SERIAL  Serial support is enabled.
  44         SMP     The kernel is an SMP kernel.
  45         SOUND   Appropriate sound system support is enabled.
  46         VGA     The VGA console has been enabled.
  47         VT      Virtual terminal support is enabled.
  48         XT      IBM PC/XT MFM hard disk support is enabled.
  49
  50 In addition, the following text indicates that the option:
  51
  52         BUGS=   Relates to possible processor bugs on the said processor.
  53         KNL     Is a kernel start-up parameter.
  54         BOOT    Is a boot loader parameter.
  55
  56 Parameters denoted with BOOT are actually interpreted by the boot
  57 loader, and have no meaning to the kernel directly.
  58
  59 Note that ALL kernel parameters listed below are CASE SENSITIVE, and that
  60 a trailing = on the name of any parameter states that that parameter will
  61 be entered as an environment variable, whereas its absence indicates that
  62 it will appear as a kernel argument readable via /proc/cmdline by programs
  63 running once the system is up.
  64
  65         53c7xx=         [HW,SCSI] Amiga SCSI controllers.
  66
  67         acpi=           [HW,ACPI] Advanced Configuration and Power Interface
  68
  69         ad1816=         [HW,SOUND]
  70
  71         ad1848=         [HW,SOUND]
  72
  73         adb_buttons=    [HW,MOUSE]
  74
  75         adlib=          [HW,SOUND]
  76
  77         advansys=       [HW,SCSI]
  78
  79         aedsp16=        [HW,SOUND]
  80
  81         aha152x=        [HW,SCSI]
  82
  83         aha1542=        [HW,SCSI]
  84
  85         aic7xxx=        [HW,SCSI]
  86
  87         AM53C974=       [HW,SCSI]
  88
  89         amijoy=         [HW,JOY] Amiga joystick support
  90
  91         apm=            [APM] Advanced Power Management.
  92
  93         applicom=       [HW]
  94
  95         arcrimi=        [HW,NET]
  96
  97         ataflop=        [HW,M68k]
  98
  99         atarimouse=     [HW,MOUSE] Atari Mouse.
 100
 101         atascsi=        [HW,SCSI] Atari SCSI.
 102
 103         awe=            [HW,SOUND]
 104
 105         aztcd=          [HW,CD] Aztec CD driver.
 106
 107         baycom_epp=     [HW,AX25]
 108
 109         baycom_par=     [HW,AX25] BayCom Parallel Port AX.25 Modem.
 110
 111         baycom_ser_fdx= [HW,AX25] BayCom Serial Port AX.25 Modem in Full
 112                         Duplex Mode.
 113
 114         baycom_ser_hdx= [HW,AX25] BayCom Serial Port AX.25 Modem in Half
 115                         Duplex Mode.
 116
 117         bmouse=         [HW,MOUSE,PS2] Bus mouse.
 118
 119         BusLogic=       [HW,SCSI]
 120
 121         cdu31a=         [HW,CD]
 122
 123         chandev=        [HW,NET]
 124
 125         cm206=          [HW,CD]
 126
 127         com20020=       [HW,NET]
 128
 129         com90io=        [HW,NET]
 130
 131         com90xx=        [HW,NET]
 132
 133         condev=         [HW]
 134
 135         console=        [KNL] output console + comm spec (speed, control,
 136                         parity).
 137
 138         cpia_pp=        [HW,PPT]
 139
 140         cs4232=         [HW,SOUND]
 141
 142         cs89x0_dma=     [HW,NET]
 143
 144         ctc=            [HW,NET]
 145
 146         cyclades=       [HW,SERIAL] Cyclades multi-serial port adapter.
 147
 148         dasd=           [HW,NET]
 149
 150         db9=            [HW,JOY]
 151
 152         db9_2=          [HW,JOY]
 153
 154         db9_3=          [HW,JOY]
 155
 156         debug           [KNL] Enable kernel debugging (events log level).
 157
 158         decnet=         [HW,NET]
 159
 160         devfs=          [DEVFS]
 161
 162         digi=           [HW,SERIAL] io parameters + enable/disable command.
 163
 164         digiepca=       [HW,SERIAL]
 165
 166         dmascc=         [HW,AX25,SERIAL] AX.25 Z80SCC driver with DMA
 167                         support available.
 168
 169         dmasound=       [HW,SOUND] (sound subsystem buffers).
 170
 171         dtc3181e=       [HW,SCSI]
 172
 173         eata=           [HW,SCSI]
 174
 175         eda=            [HW,PS2]
 176
 177         edb=            [HW,PS2]
 178
 179         eicon=          [HW,ISDN]
 180
 181         es1370=         [HW,SOUND]
 182
 183         es1371=         [HW,SOUND]
 184
 185         ether=          [HW,NET] Ethernet cards parameters (iomem, irq,
 186                         dev_name).
 187
 188         fd_mcs=         [HW,SCSI]
 189
 190         fdomain=        [HW,SCSI]
 191
 192         floppy=         [HW]
 193
 194         ftape=          [HW] Floppy Tape subsystem debugging options.
 195
 196         gamma=          [HW,DRM]
 197
 198         gc=             [HW,JOY]
 199
 200         gc_2=           [HW,JOY]
 201
 202         gc_3=           [HW,JOY]
 203
 204         gdth=           [HW,SCSI]
 205
 206         gscd=           [HW,CD]
 207
 208         gus=            [HW,SOUND]
 209
 210         gvp11=          [HW,SCSI]
 211
 212         hd=             [EIDE] (E)IDE hard drive subsystem geometry
 213                         (Cyl/heads/sectors) or tune parameters.
 214
 215         hfmodem=        [HW,AX25]
 216
 217         hisax=          [HW,ISDN]
 218
 219         i810=           [HW,DRM]
 220
 221         ibmmcascsi=     [HW,MCA,SCSI] IBM MicroChannel SCSI adapter.
 222
 223         icn=            [HW,ISDN]
 224
 225         ide?=           [HW] (E)IDE subsystem : config (iomem/irq), tuning or
 226                         debugging (serialize,reset,no{dma,tune,probe}) or
 227                         chipset specific parameters.
 228
 229         idebus=         [HW] (E)IDE subsystem : VLB/PCI bus speed.
 230
 231         idle=           [HW]
 232
 233         in2000=         [HW,SCSI]
 234
 235         init=           [KNL]
 236
 237         initrd=         [BOOT] Specify the location of the initial ramdisk.
 238
 239         ip=             [PNP]
 240
 241         isp16=          [HW,CD]
 242
 243         iucv=           [HW,NET]
 244
 245         js=             [HW,JOY] Analog joystick
 246
 247         kbd-reset       [VT]
 248
 249         keep_initrd     [HW, ARM]
 250
 251         load_ramdisk=   [RAM] List of ramdisks to load from floppy.
 252
 253         logi_busmouse=  [HW, MOUSE]
 254
 255         lp=0            [LP]    Specify parallel ports to use, e.g,
 256         lp=port[,port...]       lp=none,parport0 (lp0 not configured, lp1 uses
 257         lp=reset                first parallel port). 'lp=0' disables the
 258         lp=auto                 printer driver. 'lp=reset' (which can be
 259                                 specified in addition to the ports) causes
 260                                 attached printers to be reset. Using
 261                                 lp=port1,port2,... specifies the parallel ports
 262                                 to associate lp devices with, starting with
 263                                 lp0. A port specification may be 'none' to skip
 264                                 that lp device, or a parport name such as
 265                                 'parport0'. Specifying 'lp=auto' instead of a
 266                                 port specification list means that device IDs
 267                                 from each port should be examined, to see if
 268                                 an IEEE 1284-compliant printer is attached; if
 269                                 so, the driver will manage that printer.
 270
 271         ltpc=           [HW]
 272
 273         mac5380=        [HW,SCSI]
 274
 275         mac53c9x=       [HW,SCSI]
 276
 277         mad16=          [HW,SOUND]
 278
 279         maui=           [HW,SOUND]
 280
 281         max_loop=[0-255] [LOOP] Set the maximum number of loopback devices
 282                                 that can be mounted.
 283
 284         maxcpus=        [SMP] States the maximum number of processors that
 285                         an SMP kernel should make use of.
 286
 287         max_scsi_luns=  [SCSI]
 288
 289         mca-pentium     [BUGS=ix86]
 290
 291         mcd=            [HW,CD]
 292
 293         mcdx=           [HW,CD]
 294
 295         md=             [HW] RAID subsystems devices and level.
 296
 297         mdisk=          [HW]
 298
 299         mdacon=         [MDA]
 300
 301         megaraid=       [HW,SCSI]
 302
 303         mem=nn[KMG]     [KNL,BOOT] force use of a specific amount of
 304                         memory; to be used when the kernel is not able
 305                         to see the whole system memory or for test.
 306
 307         memfrac=        [KNL]
 308
 309         mga=            [HW,DRM]
 310
 311         mpu401=         [HW,SOUND]
 312
 313         msmouse=        [HW,MOUSE] Microsoft Mouse.
 314
 315         ncr5380=        [HW,SCSI]
 316
 317         ncr53c400=      [HW,SCSI]
 318
 319         ncr53c400a=     [HW,SCSI]
 320
 321         ncr53c406a=     [HW,SCSI]
 322
 323         ncr53c8xx=      [HW,SCSI]
 324
 325         netdev=         [NET]
 326
 327         nfsaddrs=       [NFS]
 328
 329         nfsroot=        [NFS] nfs root filesystem for disk-less boxes.
 330
 331         nmi_watchdog=   [KNL,BUGS=ix86] debugging features for SMP kernels.
 332
 333         no387           [BUGS=ix86] Tells the kernel to use the 387 maths
 334                         emulation library even if a 387 maths coprocessor
 335                         is present.
 336
 337         noalign         [KNL,ARM]
 338
 339         noapic          [SMP,APIC] Tells the kernel not to make use of any
 340                         APIC that may be present on the system.
 341
 342         noasync         [HW, M68K] Disables async and sync negotiation for
 343                         all devices.
 344
 345         nocache         [ARM]
 346
 347         nodisconnect    [HW,SCSI, M68K] Disables SCSI disconnects.
 348
 349         nohlt           [BUGS=ARM]
 350
 351         no-hlt          [BUGS=ix86]
 352
 353         noinitrd        [RAM] Tells the kernel not to load any configured
 354                         initial RAM disk.
 355
 356         nointroute      [IA-64]
 357
 358         no-scroll       [VGA]
 359
 360         nosmp           [SMP] Tells an SMP kernel to act as a UP kernel.
 361
 362         nosync          [HW, M68K] Disables sync negotiation for all devices.
 363
 364         notsc           [BUGS=ix86] Disable Time Stamp Counter
 365
 366         nowb            [ARM]
 367
 368         opl3=           [HW,SOUND]
 369
 370         opl3sa=         [HW,SOUND]
 371
 372         opl3sa2=        [HW,SOUND]
 373
 374         optcd=          [HW,CD]
 375
 376         panic=          [KNL] kernel behaviour on panic.
 377
 378         parport=0       [HW,PPT]        Specify parallel ports. 0 disables.
 379         parport=auto                    Use 'auto' to force the driver to use
 380         parport=0xBBB[,IRQ[,DMA]]       any IRQ/DMA settings detected (the
 381                                         default is to ignore detected IRQ/DMA
 382                                         settings because of possible
 383                                         conflicts). You can specify the base
 384                                         address, IRQ, and DMA settings; IRQ and
 385                                         DMA should be numbers, or 'auto' (for
 386                                         using detected settings on that
 387                                         particular port), or 'nofifo' (to avoid
 388                                         using a FIFO even if it is detected).
 389                                         Parallel ports are assigned in the
 390                                         order they are specified on the command
 391                                         line, starting with parport0.
 392
 393         pas2=           [HW,SOUND]
 394
 395         pas16=          [HW,SCSI]
 396
 397         pcbit=          [HW,ISDN]
 398
 399         pcd.            [PARIDE]
 400
 401         pci=option[,option...]          [PCI] various PCI subsystem options:
 402                 off                     [IA-32] don't probe for the PCI bus
 403                 bios                    [IA-32] force use of PCI BIOS, don't access
 404                                         the hardware directly. Use this if your machine
 405                                         has a non-standard PCI host bridge.
 406                 nobios                  [IA-32] disallow use of PCI BIOS, only direct
 407                                         hardware access methods are allowed. Use this
 408                                         if you experience crashes upon bootup and you
 409                                         suspect they are caused by the BIOS.
 410                 conf1                   [IA-32] Force use of PCI Configuration Mechanism 1.
 411                 conf2                   [IA-32] Force use of PCI Configuration Mechanism 2.
 412                 nosort                  [IA-32] Don't sort PCI devices according to
 413                                         order given by the PCI BIOS. This sorting is done
 414                                         to get a device order compatible with older kernels.
 415                 biosirq                 [IA-32] Use PCI BIOS calls to get the interrupt
 416                                         routing table. These calls are known to be buggy
 417                                         on several machines and they hang the machine when used,
 418                                         but on other computers it's the only way to get the
 419                                         interrupt routing table. Try this option if the kernel
 420                                         is unable to allocate IRQs or discover secondary PCI
 421                                         buses on your motherboard.
 422                 rom                     [IA-32] Assign address space to expansion ROMs.
 423                                         Use with caution as certain devices share address
 424                                         decoders between ROMs and other resources.
 425                 irqmask=0xMMMM          [IA-32] Set a bit mask of IRQs allowed to be assigned
 426                                         automatically to PCI devices. You can make the kernel
 427                                         exclude IRQs of your ISA cards this way.
 428                 lastbus=N               [IA-32] Scan all buses till bus #N. Can be useful
 429                                         if the kernel is unable to find your secondary buses
 430                                         and you want to tell it explicitly which ones they are.
 431
 432         pd.             [PARIDE]
 433
 434         pf.             [PARIDE]
 435
 436         pg.             [PARIDE]
 437
 438         pirq=           [SMP,APIC] mp-table.
 439
 440         plip=           [PPT,NET] Parallel port network link.
 441
 442         profile=        [KNL] enable kernel profiling via /proc/profile
 443                         (param:log level).
 444
 445         prompt_ramdisk= [RAM] List of RAM disks to prompt for floppy disk
 446                         before loading.
 447
 448         pss=            [HW,SOUND]
 449
 450         pt.             [PARIDE]
 451
 452         quiet=          [KNL] Disable log messages.
 453
 454         r128=           [HW,DRM]
 455
 456         raid=           [HW,RAID]
 457
 458         ramdisk=        [RAM] Sizes of RAM disks in kilobytes [deprecated].
 459
 460         ramdisk_blocksize=
 461                         [RAM]
 462
 463         ramdisk_size=   [RAM] New name for the ramdisk parameter.
 464
 465         ramdisk_start=  [RAM] Starting block of RAM disk image (so you can
 466                         place it after the kernel image on a boot floppy).
 467
 468         reboot=         [BUGS=ix86]
 469
 470         reserve=        [KNL,BUGS] force the kernel to ignore some iomem area.
 471
 472         riscom8=        [HW,SERIAL]
 473
 474         ro              [KNL] Mount root device read-only on boot.
 475
 476         root=           [KNL] root filesystem.
 477
 478         rw              [KNL] Mount root device read-write on boot.
 479
 480         S               [KNL] run init in single mode.
 481
 482         sb=             [HW,SOUND]
 483
 484         sbpcd=          [HW,CD] Soundblaster CD adapter.
 485
 486         scsi_logging=   [SCSI]
 487
 488         scsihosts=      [SCSI]
 489
 490         sg_def_reserved_size=
 491                         [SCSI]
 492
 493         sgalaxy=        [HW,SOUND]
 494
 495         sim710=         [SCSI,HW]
 496
 497         sjcd=           [HW,CD]
 498
 499         smart2=         [HW]
 500
 501         sonicvibes=     [HW,SOUND]
 502
 503         sonycd535=      [HW,CD]
 504
 505         sound=          [SOUND]
 506
 507         soundmodem=     [HW,AX25,SOUND] Use sound card as packet radio modem.
 508
 509         specialix=      [HW,SERIAL] Specialix multi-serial port adapter.
 510
 511         sscape=         [HW,SOUND]
 512
 513         st=             [HW,SCSI] SCSI tape parameters (buffers, etc.).
 514
 515         st0x=           [HW,SCSI]
 516
 517         stram_swap=     [HW]
 518
 519         swiotlb=        [IA-64] Number of I/O TLB slabs.
 520
 521         switches=       [HW, M68K]
 522
 523         sym53c416=      [HW,SCSI]
 524
 525         sym53c8xx=      [HW,SCSI]
 526
 527         t128=           [HW,SCSI]
 528
 529         tdfx=           [HW,DRM]
 530
 531         tgfx=           [HW,JOY]
 532
 533         tgfx_2=         [HW,JOY]
 534
 535         tgfx_3=         [HW,JOY]
 536
 537         tmc8xx=         [HW,SCSI]
 538
 539         tmscsim=        [HW,SCSI]
 540
 541         tp720=          [HW,PS2]
 542
 543         trix=           [HW,SOUND]
 544
 545         u14-34f=        [HW,SCSI]
 546
 547         uart401=        [HW,SOUND]
 548
 549         uart6850=       [HW,SOUND]
 550
 551         usbfix          [BUGS=IA-64]
 552
 553         video=          [FB] frame buffer configuration.
 554
 555         vga=            [BOOT] on ix386, select a particular video mode
 556                         (use vga=ask for menu).  This is actually a
 557                         boot loader parameter; the value is passed to
 558                         the kernel using a special protocol.  See
 559                         linux/Documentation/i386/boot.txt for information.
 560
 561         vmhalt=         [KNL,S390]
 562
 563         vmpoff=         [KNL,S390]
 564
 565         waveartist=     [HW,SOUND]
 566
 567         wd33c93=        [HW,SCSI]
 568
 569         wd7000=         [HW,SCSI]
 570
 571         wdt=            [HW]
 572
 573         xd=             [HW,XT] Original XT pre-IDE (RLL encoded) disks.
 574
 575         xd_geo=         [HW,XT]