1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2012-05-01 04:37+0900\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
16 "Content-Type: text/plain; charset=CHARSET\n"
17 "Content-Transfer-Encoding: 8bit\n"
20 #: build/C/man2/bdflush.2:28
26 #: build/C/man2/bdflush.2:28
32 #: build/C/man2/bdflush.2:28 build/C/man7/boot.7:12 build/C/man7/bootparam.7:29 build/C/man2/reboot.2:25 build/C/man2/sync.2:36
38 #: build/C/man2/bdflush.2:28 build/C/man7/boot.7:12 build/C/man7/bootparam.7:29 build/C/man2/reboot.2:25 build/C/man2/sync.2:36 build/C/man8/sync.8:6
40 msgid "Linux Programmer's Manual"
44 #: build/C/man2/bdflush.2:29 build/C/man7/boot.7:13 build/C/man7/bootparam.7:30 build/C/man2/reboot.2:26 build/C/man2/sync.2:37 build/C/man8/sync.8:7
50 #: build/C/man2/bdflush.2:31
51 msgid "bdflush - start, flush, or tune buffer-dirty-flush daemon"
55 #: build/C/man2/bdflush.2:31 build/C/man2/reboot.2:28 build/C/man2/sync.2:39 build/C/man8/sync.8:9
61 #: build/C/man2/bdflush.2:34
63 msgid "B<#include E<lt>sys/kdaemon.hE<gt>>\n"
67 #: build/C/man2/bdflush.2:37
70 "B<int bdflush(int >I<func>B<, long *>I<address>B<);>\n"
71 "B<int bdflush(int >I<func>B<, long >I<data>B<);>\n"
75 #: build/C/man2/bdflush.2:38 build/C/man7/boot.7:15 build/C/man7/bootparam.7:32 build/C/man2/reboot.2:49 build/C/man2/sync.2:65 build/C/man8/sync.8:11
80 #. As noted in a changes in the 2.5.12 source
82 #: build/C/man2/bdflush.2:49
84 "I<Note>: Since Linux 2.6, this system call is deprecated and does nothing. "
85 "It is likely to disappear altogether in a future kernel release. Nowadays, "
86 "the task performed by B<bdflush>() is handled by the kernel I<pdflush> "
91 #: build/C/man2/bdflush.2:56
93 "B<bdflush>() starts, flushes, or tunes the buffer-dirty-flush daemon. Only "
94 "a privileged process (one with the B<CAP_SYS_ADMIN> capability) may call "
99 #: build/C/man2/bdflush.2:62
101 "If I<func> is negative or 0, and no daemon has been started, then "
102 "B<bdflush>() enters the daemon code and never returns."
106 #: build/C/man2/bdflush.2:67
107 msgid "If I<func> is 1, some dirty buffers are written to disk."
111 #: build/C/man2/bdflush.2:76
113 "If I<func> is 2 or more and is even (low bit is 0), then I<address> is the "
114 "address of a long word, and the tuning parameter numbered (I<func>-2)/2 is "
115 "returned to the caller in that address."
119 #: build/C/man2/bdflush.2:85
121 "If I<func> is 3 or more and is odd (low bit is 1), then I<data> is a long "
122 "word, and the kernel sets tuning parameter numbered (I<func>-3)/2 to that "
127 #: build/C/man2/bdflush.2:89
129 "The set of parameters, their values, and their valid ranges are defined in "
130 "the kernel source file I<fs/buffer.c>."
134 #: build/C/man2/bdflush.2:89 build/C/man2/reboot.2:148 build/C/man2/sync.2:76
140 #: build/C/man2/bdflush.2:98
142 "If I<func> is negative or 0 and the daemon successfully starts, B<bdflush>() "
143 "never returns. Otherwise, the return value is 0 on success and -1 on "
144 "failure, with I<errno> set to indicate the error."
148 #: build/C/man2/bdflush.2:98 build/C/man2/reboot.2:161 build/C/man2/sync.2:82
154 #: build/C/man2/bdflush.2:99
160 #: build/C/man2/bdflush.2:103
162 "An attempt was made to enter the daemon code after another process has "
167 #: build/C/man2/bdflush.2:103 build/C/man2/reboot.2:162
173 #: build/C/man2/bdflush.2:107
174 msgid "I<address> points outside your accessible address space."
178 #: build/C/man2/bdflush.2:107 build/C/man2/reboot.2:166
184 #: build/C/man2/bdflush.2:111
186 "An attempt was made to read or write an invalid parameter number, or to "
187 "write an invalid value to a parameter."
191 #: build/C/man2/bdflush.2:111 build/C/man2/reboot.2:169
197 #: build/C/man2/bdflush.2:116
198 msgid "Caller does not have the B<CAP_SYS_ADMIN> capability."
202 #: build/C/man2/bdflush.2:116 build/C/man2/reboot.2:176 build/C/man2/sync.2:95 build/C/man8/sync.8:61
204 msgid "CONFORMING TO"
208 #: build/C/man2/bdflush.2:120
210 "B<bdflush>() is Linux-specific and should not be used in programs intended "
215 #: build/C/man2/bdflush.2:120 build/C/man7/boot.7:200 build/C/man7/bootparam.7:1296 build/C/man2/reboot.2:180 build/C/man2/sync.2:118 build/C/man8/sync.8:80
221 #: build/C/man2/bdflush.2:125
222 msgid "B<fsync>(2), B<sync>(2), B<sync>(8), B<update>(8)"
226 #: build/C/man2/bdflush.2:125 build/C/man7/boot.7:206 build/C/man7/bootparam.7:1308 build/C/man2/reboot.2:187 build/C/man2/sync.2:124 build/C/man8/sync.8:85
232 #: build/C/man2/bdflush.2:132 build/C/man7/boot.7:213 build/C/man7/bootparam.7:1315 build/C/man2/reboot.2:194 build/C/man2/sync.2:131 build/C/man8/sync.8:92
234 "This page is part of release 3.40 of the Linux I<man-pages> project. A "
235 "description of the project, and information about reporting bugs, can be "
236 "found at http://www.kernel.org/doc/man-pages/."
240 #: build/C/man7/boot.7:12
246 #: build/C/man7/boot.7:12
252 #: build/C/man7/boot.7:15
253 msgid "boot-scripts - General description of boot sequence"
257 #: build/C/man7/boot.7:23
259 "The boot sequence varies in details among systems but can be roughly divided "
260 "to the following steps: (i) hardware boot, (ii) OS loader, (iii) kernel "
261 "startup, (iv) init and inittab, (v) boot scripts. We will describe each of "
262 "these in more detail below."
266 #: build/C/man7/boot.7:23
268 msgid "Hardware-boot"
272 #: build/C/man7/boot.7:28
274 "After power-on or hard reset, control is given to a program stored on "
275 "read-only memory (normally PROM). In PC we usually call this program the "
280 #: build/C/man7/boot.7:37
282 "This program normally makes a basic self-test of the machine and accesses "
283 "nonvolatile memory to read further parameters. This memory in the PC is "
284 "battery-backed CMOS memory, so most people refer to it as the B<CMOS>, "
285 "although outside of the PC world, it is usually called B<nvram> (nonvolatile "
290 #: build/C/man7/boot.7:42
292 "The parameters stored in the nvram vary between systems, but as a minimum, "
293 "the hardware boot program should know what is the boot device, or which "
294 "devices to probe as possible boot devices."
298 #: build/C/man7/boot.7:46
300 "Then the hardware boot stage accesses the boot device, loads the OS Loader, "
301 "which is located on a fixed position on the boot device, and transfers "
306 #: build/C/man7/boot.7:46 build/C/man7/boot.7:126
312 #: build/C/man7/boot.7:52
314 "We do not cover here booting from network. Those who want to investigate "
315 "this subject may want to research: DHCP, TFTP, PXE, Etherboot."
319 #: build/C/man7/boot.7:52
325 #: build/C/man7/boot.7:56
327 "In PC, the OS Loader is located in the first sector of the boot device - "
328 "this is the B<MBR> (Master Boot Record)."
332 #: build/C/man7/boot.7:64
334 "In most systems, this primary loader is very limited due to various "
335 "constraints. Even on non-PC systems there are some limitations to the size "
336 "and complexity of this loader, but the size limitation of the PC MBR (512 "
337 "bytes including the partition table) makes it almost impossible to squeeze a "
338 "full OS Loader into it."
342 #: build/C/man7/boot.7:68
344 "Therefore, most operating systems make the primary loader call a secondary "
345 "OS loader which may be located on a specified disk partition."
349 #: build/C/man7/boot.7:78
351 "In Linux the OS loader is normally B<lilo>(8) or B<grub>(8). Both of them "
352 "may install either as secondary loaders (where the DOS installed MBR points "
353 "to them), or as a two part loader where they provide special MBR containing "
354 "the bootstrap code to load the second part of the loader from the root "
359 #: build/C/man7/boot.7:86
361 "The main job of the OS Loader is to locate the kernel on the disk, load it "
362 "and run it. Most OS loaders allow interactive use, to enable specification "
363 "of alternative kernel (maybe a backup in case the last compiled one isn't "
364 "functioning) and to pass optional parameters to the kernel."
368 #: build/C/man7/boot.7:86
370 msgid "Kernel Startup"
374 #: build/C/man7/boot.7:91
376 "When the kernel is loaded, it initializes the devices (via their drivers), "
377 "starts the swapper (it is a \"kernel process\", called kswapd in modern "
378 "Linux kernels), and mounts the root file system (/)."
382 #: build/C/man7/boot.7:98
384 "Some of the parameters that may be passed to the kernel relate to these "
385 "activities (e.g: You can override the default root file system). For "
386 "further information on Linux kernel parameters read B<bootparam>(7)."
390 #: build/C/man7/boot.7:105
392 "Only then the kernel creates the first (user land) process which is "
393 "numbered 1. This process executes the program I</sbin/init>, passing any "
394 "parameters that weren't handled by the kernel already."
398 #: build/C/man7/boot.7:105
400 msgid "init and inittab"
404 #: build/C/man7/boot.7:110
406 "When init starts it reads I</etc/inittab> for further instructions. This "
407 "file defines what should be run in different I<run-levels>."
411 #: build/C/man7/boot.7:120
413 "This gives the system administrator an easy management scheme, where each "
414 "run-level is associated with a set of services (e.g: B<S> is I<single-user>, "
415 "on B<2> most network services start, etc.). The administrator may change "
416 "the current run-level via B<init>(8) and query the current run-level via "
421 #: build/C/man7/boot.7:124
423 "However, since it is not convenient to manage individual services by editing "
424 "this file, inittab only bootstraps a set of scripts that actually start/stop "
425 "the individual services."
429 #: build/C/man7/boot.7:124
435 #: build/C/man7/boot.7:134
437 "The following description applies to System V release 4-based systems, which "
438 "currently covers most commercial UNIX systems (Solaris, HP-UX, Irix, Tru64) "
439 "as well as the major Linux distributions (Red Hat, Debian, Mandriva, SUSE, "
440 "Ubuntu). Some systems (Slackware Linux, FreeBSD, OpenBSD) have a somewhat "
441 "different scheme of boot scripts."
445 #: build/C/man7/boot.7:147
447 "For each managed service (mail, nfs server, cron, etc.) there is a single "
448 "startup script located in a specific directory (I</etc/init.d> in most "
449 "versions of Linux). Each of these scripts accepts as a single argument the "
450 "word \"start\" -- causing it to start the service, or the word \\&\"stop\" "
451 "-- causing it to stop the service. The script may optionally accept other "
452 "\"convenience\" parameters (e.g: \"restart\", to stop and then start, "
453 "\"status\" do display the service status). Running the script without "
454 "parameters displays the possible arguments."
458 #: build/C/man7/boot.7:147
460 msgid "Sequencing Directories"
464 #: build/C/man7/boot.7:155
466 "To make specific scripts start/stop at specific run-levels and in specific "
467 "order, there are I<sequencing directories>. These are normally in "
468 "I</etc/rc[0-6S].d>. In each of these directories there are links (usually "
469 "symbolic) to the scripts in the I</etc/init.d> directory."
473 #: build/C/man7/boot.7:164
475 "A primary script (usually I</etc/rc>) is called from B<inittab>(5) and "
476 "calls the services scripts via the links in the sequencing directories. All "
477 "links with names that begin with \\(aqS\\(aq are being called with the "
478 "argument \"start\" (thereby starting the service). All links with names "
479 "that begin with \\(aqK\\(aq are being called with the argument \"stop\" "
480 "(thereby stopping the service)."
484 #: build/C/man7/boot.7:174
486 "To define the starting or stopping order within the same run-level, the "
487 "names of the links contain order-numbers. Also, to make the names clearer, "
488 "they usually end with the name of the service they refer to. Example: the "
489 "link I</etc/rc2.d/S80sendmail> starts the sendmail service on runlevel 2. "
490 "This happens after I</etc/rc2.d/S12syslog> is run but before "
491 "I</etc/rc2.d/S90xfs> is run."
495 #: build/C/man7/boot.7:179
497 "To manage the boot order and run-levels, we have to manage these links. "
498 "However, on many versions of Linux, there are tools to help with this task "
499 "(e.g: B<chkconfig>(8))."
503 #: build/C/man7/boot.7:179
505 msgid "Boot Configuration"
509 #: build/C/man7/boot.7:188
511 "Usually the daemons started may optionally receive command-line options and "
512 "parameters. To allow system administrators to change these parameters "
513 "without editing the boot scripts themselves, configuration files are used. "
514 "These are located in a specific directory (I</etc/sysconfig> on Red Hat "
515 "systems) and are used by the boot scripts."
519 #: build/C/man7/boot.7:195
521 "In older UNIX systems, these files contained the actual command line options "
522 "for the daemons, but in modern Linux systems (and also in HP-UX), these "
523 "files just contain shell variables. The boot scripts in I</etc/init.d> "
524 "B<source> the configuration files, and then use the variable values."
528 #: build/C/man7/boot.7:195
534 #: build/C/man7/boot.7:200
535 msgid "I</etc/init.d/>, I</etc/rc[S0-6].d/>, I</etc/sysconfig/>"
539 #: build/C/man7/boot.7:206
540 msgid "B<inittab>(5), B<bootparam>(7), B<init>(8), B<runlevel>(8), B<shutdown>(8)"
544 #: build/C/man7/bootparam.7:29
550 #: build/C/man7/bootparam.7:29
556 #: build/C/man7/bootparam.7:32
557 msgid "bootparam - Introduction to boot time parameters of the Linux kernel"
561 #: build/C/man7/bootparam.7:39
563 "The Linux kernel accepts certain 'command-line options' or 'boot time "
564 "parameters' at the moment it is started. In general this is used to supply "
565 "the kernel with information about hardware parameters that the kernel would "
566 "not be able to determine on its own, or to avoid/override the values that "
567 "the kernel would otherwise detect."
571 #: build/C/man7/bootparam.7:49
573 "When the kernel is booted directly by the BIOS (say from a floppy to which "
574 "you copied a kernel using 'cp zImage /dev/fd0'), you have no opportunity to "
575 "specify any parameters. So, in order to take advantage of this possibility "
576 "you have to use software that is able to pass parameters, like LILO or "
577 "loadlin. For a few parameters one can also modify the kernel image itself, "
578 "using rdev, see B<rdev>(8) for further details."
582 #: build/C/man7/bootparam.7:59
584 "The LILO program (LInux LOader) written by Werner Almesberger is the most "
585 "commonly used. It has the ability to boot various kernels, and stores the "
586 "configuration information in a plain text file. (See B<lilo>(8) and "
587 "B<lilo.conf>(5).) LILO can boot DOS, OS/2, Linux, FreeBSD, UnixWare, etc., "
588 "and is quite flexible."
592 #: build/C/man7/bootparam.7:64
594 "The other commonly used Linux loader is 'LoadLin' which is a DOS program "
595 "that has the capability to launch a Linux kernel from the DOS prompt (with "
596 "boot-args) assuming that certain resources are available. This is good for "
597 "people that want to launch Linux from DOS."
601 #: build/C/man7/bootparam.7:73
603 "It is also very useful if you have certain hardware which relies on the "
604 "supplied DOS driver to put the hardware into a known state. A common "
605 "example is 'SoundBlaster Compatible' sound cards that require the DOS driver "
606 "to twiddle a few mystical registers to put the card into a SB compatible "
607 "mode. Booting DOS with the supplied driver, and then loading Linux from the "
608 "DOS prompt with loadlin avoids the reset of the card that happens if one "
613 #: build/C/man7/bootparam.7:73
615 msgid "The Argument List"
619 #: build/C/man7/bootparam.7:77
621 "The kernel command line is parsed into a list of strings (boot arguments) "
622 "separated by spaces. Most of the boot args take the form of:"
626 #: build/C/man7/bootparam.7:79
627 msgid "name[=value_1][,value_2]...[,value_10]"
631 #: build/C/man7/bootparam.7:87
633 "where 'name' is a unique keyword that is used to identify what part of the "
634 "kernel the associated values (if any) are to be given to. Note the limit of "
635 "10 is real, as the present code only handles 10 comma separated parameters "
636 "per keyword. (However, you can reuse the same keyword with up to an "
637 "additional 10 parameters in unusually complicated situations, assuming the "
638 "setup function supports it.)"
642 #: build/C/man7/bootparam.7:93
644 "Most of the sorting goes on in linux/init/main.c. First, the kernel checks "
645 "to see if the argument is any of the special arguments 'root=', "
646 "\\&'nfsroot=', 'nfsaddrs=', 'ro', 'rw', 'debug' or 'init'. The meaning of "
647 "these special arguments is described below."
651 #: build/C/man7/bootparam.7:104
653 "Then it walks a list of setup functions (contained in the bootsetups array) "
654 "to see if the specified argument string (such as 'foo') has been associated "
655 "with a setup function ('foo_setup()') for a particular device or part of the "
656 "kernel. If you passed the kernel the line foo=3,4,5,6 then the kernel would "
657 "search the bootsetups array to see if 'foo' was registered. If it was, then "
658 "it would call the setup function associated with 'foo' (foo_setup()) and "
659 "hand it the arguments 3, 4, 5 and 6 as given on the kernel command line."
663 #: build/C/man7/bootparam.7:110
665 "Anything of the form 'foo=bar' that is not accepted as a setup function as "
666 "described above is then interpreted as an environment variable to be set. A "
667 "(useless?) example would be to use 'TERM=vt100' as a boot argument."
671 #: build/C/man7/bootparam.7:120
673 "Any remaining arguments that were not picked up by the kernel and were not "
674 "interpreted as environment variables are then passed onto process one, which "
675 "is usually the init program. The most common argument that is passed to the "
676 "init process is the word 'single' which instructs init to boot the computer "
677 "in single user mode, and not launch all the usual daemons. Check the manual "
678 "page for the version of init installed on your system to see what arguments "
683 #: build/C/man7/bootparam.7:120
685 msgid "General Non-device Specific Boot Arguments"
689 #: build/C/man7/bootparam.7:121
691 msgid "B<'init=...'>"
695 #: build/C/man7/bootparam.7:133
697 "This sets the initial command to be executed by the kernel. If this is not "
698 "set, or cannot be found, the kernel will try I</sbin/init>, then "
699 "I</etc/init>, then I</bin/init>, then I</bin/sh> and panic if all of this "
704 #: build/C/man7/bootparam.7:133
706 msgid "B<'nfsaddrs=...'>"
710 #: build/C/man7/bootparam.7:137
712 "This sets the nfs boot address to the given string. This boot address is "
713 "used in case of a net boot."
717 #: build/C/man7/bootparam.7:137
719 msgid "B<'nfsroot=...'>"
723 #: build/C/man7/bootparam.7:144
725 "This sets the nfs root name to the given string. If this string does not "
726 "begin with '/' or ',' or a digit, then it is prefixed by \\&'/tftpboot/'. "
727 "This root name is used in case of a net boot."
731 #: build/C/man7/bootparam.7:144
737 #: build/C/man7/bootparam.7:157
739 "(Only when B<CONFIG_BUGi386> is defined.) Some i387 coprocessor chips have "
740 "bugs that show up when used in 32 bit protected mode. For example, some of "
741 "the early ULSI-387 chips would cause solid lockups while performing "
742 "floating-point calculations. Using the 'no387' boot arg causes Linux to "
743 "ignore the maths coprocessor even if you have one. Of course you must then "
744 "have your kernel compiled with math emulation support!"
748 #: build/C/man7/bootparam.7:157
754 #: build/C/man7/bootparam.7:170
756 "(Only when B<CONFIG_BUGi386> is defined.) Some of the early i486DX-100 "
757 "chips have a problem with the 'hlt' instruction, in that they can't reliably "
758 "return to operating mode after this instruction is used. Using the 'no-hlt' "
759 "instruction tells Linux to just run an infinite loop when there is nothing "
760 "else to do, and to not halt the CPU. This allows people with these broken "
761 "chips to use Linux."
765 #: build/C/man7/bootparam.7:170
767 msgid "B<'root=...'>"
771 #: build/C/man7/bootparam.7:182
773 "This argument tells the kernel what device is to be used as the root file "
774 "system while booting. The default of this setting is determined at compile "
775 "time, and usually is the value of the root device of the system that the "
776 "kernel was built on. To override this value, and select the second floppy "
777 "drive as the root device, one would use 'root=/dev/fd1'. (The root device "
778 "can also be set using B<rdev>(8).)"
782 #: build/C/man7/bootparam.7:198
784 "The root device can be specified symbolically or numerically. A symbolic "
785 "specification has the form /dev/XXYN, where XX designates the device type "
786 "('hd' for ST-506 compatible hard disk, with Y in \\&'a'-'d'; 'sd' for SCSI "
787 "compatible disk, with Y in 'a'-'e'; \\&'ad' for Atari ACSI disk, with Y in "
788 "'a'-'e', \\&'ez' for a Syquest EZ135 parallel port removable drive, with "
789 "Y='a', \\&'xd' for XT compatible disk, with Y either 'a' or 'b'; 'fd' for "
790 "floppy disk, with Y the floppy drive number\\(emfd0 would be the DOS 'A:' "
791 "drive, and fd1 would be 'B:'), Y the driver letter or number, and N the "
792 "number (in decimal) of the partition on this device (absent in the case of "
793 "floppies). Recent kernels allow many other types, mostly for CD-ROMs: nfs, "
794 "ram, scd, mcd, cdu535, aztcd, cm206cd, gscd, sbpcd, sonycd, bpcd. (The type "
795 "nfs specifies a net boot; ram refers to a ram disk.)"
799 #: build/C/man7/bootparam.7:202
801 "Note that this has nothing to do with the designation of these devices on "
802 "your file system. The '/dev/' part is purely conventional."
806 #: build/C/man7/bootparam.7:207
808 "The more awkward and less portable numeric specification of the above "
809 "possible root devices in major/minor format is also accepted. (E.g., "
810 "/dev/sda3 is major 8, minor 3, so you could use 'root=0x803' as an "
815 #: build/C/man7/bootparam.7:207
817 msgid "B<'ro'> and B<'rw'>"
821 #: build/C/man7/bootparam.7:217
823 "The 'ro' option tells the kernel to mount the root file system as "
824 "'read-only' so that file system consistency check programs (fsck) can do "
825 "their work on a quiescent file system. No processes can write to files on "
826 "the file system in question until it is 'remounted' as read/write capable, "
827 "for example, by 'mount -w -n -o remount /'. (See also B<mount>(8).)"
831 #: build/C/man7/bootparam.7:220
833 "The 'rw' option tells the kernel to mount the root file system read/write. "
834 "This is the default."
838 #: build/C/man7/bootparam.7:223
840 "The choice between read-only and read/write can also be set using "
845 #: build/C/man7/bootparam.7:223
847 msgid "B<'reserve=...'>"
851 #: build/C/man7/bootparam.7:227
853 "This is used to protect I/O port regions from probes. The form of the "
858 #: build/C/man7/bootparam.7:229
859 msgid "B<reserve=>I<iobase,extent[,iobase,extent]...>"
863 #: build/C/man7/bootparam.7:236
865 "In some machines it may be necessary to prevent device drivers from checking "
866 "for devices (auto-probing) in a specific region. This may be because of "
867 "hardware that reacts badly to the probing, or hardware that would be "
868 "mistakenly identified, or merely hardware you don't want the kernel to "
873 #: build/C/man7/bootparam.7:241
875 "The reserve boot-time argument specifies an I/O port region that shouldn't "
876 "be probed. A device driver will not probe a reserved region, unless another "
877 "boot argument explicitly specifies that it do so."
881 #: build/C/man7/bootparam.7:243
882 msgid "For example, the boot line"
886 #: build/C/man7/bootparam.7:245
887 msgid "reserve=0x300,32 blah=0x300"
891 #: build/C/man7/bootparam.7:248
893 "keeps all device drivers except the driver for 'blah' from probing "
898 #: build/C/man7/bootparam.7:248
904 #: build/C/man7/bootparam.7:261
906 "The BIOS call defined in the PC specification that returns the amount of "
907 "installed memory was only designed to be able to report up to 64MB. Linux "
908 "uses this BIOS call at boot to determine how much memory is installed. If "
909 "you have more than 64MB of RAM installed, you can use this boot arg to tell "
910 "Linux how much memory you have. The value is in decimal or hexadecimal "
911 "(prefix 0x), and the suffixes 'k' (times 1024) or 'M' (times 1048576) can be "
912 "used. Here is a quote from Linus on usage of the 'mem=' parameter."
916 #: build/C/man7/bootparam.7:268
918 "The kernel will accept any 'mem=xx' parameter you give it, and if it turns "
919 "out that you lied to it, it will crash horribly sooner or later. The "
920 "parameter indicates the highest addressable RAM address, so "
921 "\\&'mem=0x1000000' means you have 16MB of memory, for example. For a 96MB "
922 "machine this would be 'mem=0x6000000'."
926 #: build/C/man7/bootparam.7:280
928 "B<NOTE>: some machines might use the top of memory for BIOS caching or "
929 "whatever, so you might not actually have up to the full 96MB addressable. "
930 "The reverse is also true: some chipsets will map the physical memory that is "
931 "covered by the BIOS area into the area just past the top of memory, so the "
932 "top-of-mem might actually be 96MB + 384kB for example. If you tell linux "
933 "that it has more memory than it actually does have, bad things will happen: "
934 "maybe not at once, but surely eventually."
938 #: build/C/man7/bootparam.7:285
940 "You can also use the boot argument 'mem=nopentium' to turn off 4 MB page "
941 "tables on kernels configured for IA32 systems with a pentium or newer CPU."
945 #: build/C/man7/bootparam.7:285
951 #: build/C/man7/bootparam.7:290
953 "By default the kernel will not reboot after a panic, but this option will "
954 "cause a kernel reboot after N seconds (if N is greater than zero). This "
955 "panic timeout can also be set by \"echo N E<gt> /proc/sys/kernel/panic\"."
959 #: build/C/man7/bootparam.7:290
961 msgid "B<'reboot=[warm|cold][,[bios|hard]]'>"
965 #: build/C/man7/bootparam.7:305
967 "(Only when B<CONFIG_BUGi386> is defined.) Since 2.0.22 a reboot is by "
968 "default a cold reboot. One asks for the old default with 'reboot=warm'. (A "
969 "cold reboot may be required to reset certain hardware, but might destroy not "
970 "yet written data in a disk cache. A warm reboot may be faster.) By default "
971 "a reboot is hard, by asking the keyboard controller to pulse the reset line "
972 "low, but there is at least one type of motherboard where that doesn't work. "
973 "The option 'reboot=bios' will instead jump through the BIOS."
977 #: build/C/man7/bootparam.7:305
979 msgid "B<'nosmp'> and B<'maxcpus=N'>"
983 #: build/C/man7/bootparam.7:311
985 "(Only when __SMP__ is defined.) A command-line option of 'nosmp' or "
986 "'maxcpus=0' will disable SMP activation entirely; an option 'maxcpus=N' "
987 "limits the maximum number of CPUs activated in SMP mode to N."
991 #: build/C/man7/bootparam.7:311
993 msgid "Boot Arguments for Use by Kernel Developers"
997 #: build/C/man7/bootparam.7:312
1003 #: build/C/man7/bootparam.7:328
1005 "Kernel messages are handed off to the kernel log daemon klogd so that they "
1006 "may be logged to disk. Messages with a priority above I<console_loglevel> "
1007 "are also printed on the console. (For these levels, see "
1008 "I<E<lt>linux/kernel.hE<gt>>.) By default this variable is set to log "
1009 "anything more important than debug messages. This boot argument will cause "
1010 "the kernel to also print the messages of DEBUG priority. The console "
1011 "loglevel can also be set at run time via an option to klogd. See "
1016 #: build/C/man7/bootparam.7:328
1018 msgid "B<'profile=N'>"
1022 #: build/C/man7/bootparam.7:346
1024 "It is possible to enable a kernel profiling function, if one wishes to find "
1025 "out where the kernel is spending its CPU cycles. Profiling is enabled by "
1026 "setting the variable I<prof_shift> to a nonzero value. This is done either "
1027 "by specifying B<CONFIG_PROFILE> at compile time, or by giving the 'profile=' "
1028 "option. Now the value that I<prof_shift> gets will be N, when given, or "
1029 "B<CONFIG_PROFILE_SHIFT>, when that is given, or 2, the default. The "
1030 "significance of this variable is that it gives the granularity of the "
1031 "profiling: each clock tick, if the system was executing kernel code, a "
1032 "counter is incremented:"
1036 #: build/C/man7/bootparam.7:348
1037 msgid "profile[address E<gt>E<gt> prof_shift]++;"
1041 #: build/C/man7/bootparam.7:355
1043 "The raw profiling information can be read from I</proc/profile>. Probably "
1044 "you'll want to use a tool such as readprofile.c to digest it. Writing to "
1045 "I</proc/profile> will clear the counters."
1049 #: build/C/man7/bootparam.7:355
1051 msgid "B<'swap=N1,N2,N3,N4,N5,N6,N7,N8'>"
1055 #: build/C/man7/bootparam.7:361
1057 "Set the eight parameters max_page_age, page_advance, page_decline, "
1058 "page_initial_age, age_cluster_fract, age_cluster_min, pageout_weight, "
1059 "bufferout_weight that control the kernel swap algorithm. For kernel tuners "
1064 #: build/C/man7/bootparam.7:361
1066 msgid "B<'buff=N1,N2,N3,N4,N5,N6'>"
1070 #: build/C/man7/bootparam.7:367
1072 "Set the six parameters max_buff_age, buff_advance, buff_decline, "
1073 "buff_initial_age, bufferout_weight, buffermem_grace that control kernel "
1074 "buffer memory management. For kernel tuners only."
1078 #: build/C/man7/bootparam.7:367
1080 msgid "Boot Arguments for Ramdisk Use"
1084 #: build/C/man7/bootparam.7:378
1086 "(Only if the kernel was compiled with B<CONFIG_BLK_DEV_RAM>.) In general it "
1087 "is a bad idea to use a ramdisk under Linux\\(emthe system will use available "
1088 "memory more efficiently itself. But while booting (or while constructing "
1089 "boot floppies) it is often useful to load the floppy contents into a "
1090 "ramdisk. One might also have a system in which first some modules (for file "
1091 "system or hardware) must be loaded before the main disk can be accessed."
1095 #: build/C/man7/bootparam.7:390
1097 "In Linux 1.3.48, ramdisk handling was changed drastically. Earlier, the "
1098 "memory was allocated statically, and there was a 'ramdisk=N' parameter to "
1099 "tell its size. (This could also be set in the kernel image at compile time, "
1100 "or by use of B<rdev>(8).) These days ram disks use the buffer cache, and "
1101 "grow dynamically. For a lot of information (e.g., how to use B<rdev>(8) in "
1102 "conjunction with the new ramdisk setup), see "
1103 "I</usr/src/linux/Documentation/ramdisk.txt>."
1107 #: build/C/man7/bootparam.7:392
1108 msgid "There are four parameters, two boolean and two integral."
1112 #: build/C/man7/bootparam.7:392
1114 msgid "B<'load_ramdisk=N'>"
1118 #: build/C/man7/bootparam.7:397
1120 "If N=1, do load a ramdisk. If N=0, do not load a ramdisk. (This is the "
1125 #: build/C/man7/bootparam.7:397
1127 msgid "B<'prompt_ramdisk=N'>"
1131 #: build/C/man7/bootparam.7:403
1133 "If N=1, do prompt for insertion of the floppy. (This is the default.) If "
1134 "N=0, do not prompt. (Thus, this parameter is never needed.)"
1138 #: build/C/man7/bootparam.7:403
1140 msgid "B<'ramdisk_size=N'> or (obsolete) B<'ramdisk=N'>"
1144 #: build/C/man7/bootparam.7:407
1145 msgid "Set the maximal size of the ramdisk(s) to N kB. The default is 4096 (4 MB)."
1149 #: build/C/man7/bootparam.7:407
1151 msgid "B<'ramdisk_start=N'>"
1155 #: build/C/man7/bootparam.7:412
1157 "Sets the starting block number (the offset on the floppy where the ramdisk "
1158 "starts) to N. This is needed in case the ramdisk follows a kernel image."
1162 #: build/C/man7/bootparam.7:412
1164 msgid "B<'noinitrd'>"
1168 #: build/C/man7/bootparam.7:425
1170 "(Only if the kernel was compiled with B<CONFIG_BLK_DEV_RAM> and "
1171 "B<CONFIG_BLK_DEV_INITRD>.) These days it is possible to compile the kernel "
1172 "to use initrd. When this feature is enabled, the boot process will load the "
1173 "kernel and an initial ramdisk; then the kernel converts initrd into a "
1174 "\"normal\" ramdisk, which is mounted read-write as root device; then "
1175 "/linuxrc is executed; afterward the \"real\" root file system is mounted, "
1176 "and the initrd file system is moved over to /initrd; finally the usual boot "
1177 "sequence (e.g., invocation of /sbin/init) is performed."
1181 #: build/C/man7/bootparam.7:428
1183 "For a detailed description of the initrd feature, see "
1184 "I</usr/src/linux/Documentation/initrd.txt>."
1188 #: build/C/man7/bootparam.7:436
1190 "The 'noinitrd' option tells the kernel that although it was compiled for "
1191 "operation with initrd, it should not go through the above steps, but leave "
1192 "the initrd data under I</dev/initrd>. (This device can be used only once: "
1193 "the data is freed as soon as the last process that used it has closed "
1198 #: build/C/man7/bootparam.7:436
1200 msgid "Boot Arguments for SCSI Devices"
1204 #: build/C/man7/bootparam.7:438
1205 msgid "General notation for this section:"
1209 #: build/C/man7/bootparam.7:443
1211 "I<iobase> -- the first I/O port that the SCSI host occupies. These are "
1212 "specified in hexadecimal notation, and usually lie in the range from 0x200 "
1217 #: build/C/man7/bootparam.7:451
1219 "I<irq> -- the hardware interrupt that the card is configured to use. Valid "
1220 "values will be dependent on the card in question, but will usually be 5, 7, "
1221 "9, 10, 11, 12, and 15. The other values are usually used for common "
1222 "peripherals like IDE hard disks, floppies, serial ports, etc."
1226 #: build/C/man7/bootparam.7:459
1228 "I<scsi-id> -- the ID that the host adapter uses to identify itself on the "
1229 "SCSI bus. Only some host adapters allow you to change this value, as most "
1230 "have it permanently specified internally. The usual default value is 7, but "
1231 "the Seagate and Future Domain TMC-950 boards use 6."
1235 #: build/C/man7/bootparam.7:467
1237 "I<parity> -- whether the SCSI host adapter expects the attached devices to "
1238 "supply a parity value with all information exchanges. Specifying a one "
1239 "indicates parity checking is enabled, and a zero disables parity checking. "
1240 "Again, not all adapters will support selection of parity behavior as a boot "
1245 #: build/C/man7/bootparam.7:467
1247 msgid "B<'max_scsi_luns=...'>"
1251 #: build/C/man7/bootparam.7:478
1253 "A SCSI device can have a number of 'subdevices' contained within itself. "
1254 "The most common example is one of the new SCSI CD-ROMs that handle more than "
1255 "one disk at a time. Each CD is addressed as a \\&'Logical Unit Number' "
1256 "(LUN) of that particular device. But most devices, such as hard disks, tape "
1257 "drives and such are only one device, and will be assigned to LUN zero."
1261 #: build/C/man7/bootparam.7:484
1263 "Some poorly designed SCSI devices cannot handle being probed for LUNs not "
1264 "equal to zero. Therefore, if the compile-time flag B<CONFIG_SCSI_MULTI_LUN> "
1265 "is not set, newer kernels will by default only probe LUN zero."
1269 #: build/C/man7/bootparam.7:490
1271 "To specify the number of probed LUNs at boot, one enters "
1272 "\\&'max_scsi_luns=n' as a boot arg, where n is a number between one and "
1273 "eight. To avoid problems as described above, one would use n=1 to avoid "
1274 "upsetting such broken devices."
1278 #: build/C/man7/bootparam.7:490
1280 msgid "B<SCSI tape configuration>"
1284 #: build/C/man7/bootparam.7:494
1286 "Some boot time configuration of the SCSI tape driver can be achieved by "
1287 "using the following:"
1291 #: build/C/man7/bootparam.7:496
1292 msgid "B<st=>I<buf_size[,write_threshold[,max_bufs]]>"
1296 #: build/C/man7/bootparam.7:509
1298 "The first two numbers are specified in units of kB. The default I<buf_size> "
1299 "is 32kB, and the maximum size that can be specified is a ridiculous "
1300 "16384kB. The I<write_threshold> is the value at which the buffer is "
1301 "committed to tape, with a default value of 30kB. The maximum number of "
1302 "buffers varies with the number of drives detected, and has a default of "
1303 "two. An example usage would be:"
1307 #: build/C/man7/bootparam.7:511
1312 #: build/C/man7/bootparam.7:517
1314 "Full details can be found in the file I<Documentation/scsi/st.txt> (or "
1315 "I<drivers/scsi/README.st> for older kernels) in the kernel source."
1319 #: build/C/man7/bootparam.7:517
1321 msgid "B<Adaptec aha151x, aha152x, aic6260, aic6360, SB16-SCSI configuration>"
1325 #: build/C/man7/bootparam.7:521
1327 "The aha numbers refer to cards and the aic numbers refer to the actual SCSI "
1328 "chip on these type of cards, including the Soundblaster-16 SCSI."
1332 #: build/C/man7/bootparam.7:526
1334 "The probe code for these SCSI hosts looks for an installed BIOS, and if none "
1335 "is present, the probe will not find your card. Then you will have to use a "
1336 "boot arg of the form:"
1340 #: build/C/man7/bootparam.7:528
1341 msgid "B<aha152x=>I<iobase[,irq[,scsi-id[,reconnect[,parity]]]]>"
1345 #: build/C/man7/bootparam.7:531
1347 "If the driver was compiled with debugging enabled, a sixth value can be "
1348 "specified to set the debug level."
1352 #: build/C/man7/bootparam.7:537
1354 "All the parameters are as described at the top of this section, and the "
1355 "I<reconnect> value will allow device disconnect/reconnect if a nonzero value "
1356 "is used. An example usage is as follows:"
1360 #: build/C/man7/bootparam.7:539
1361 msgid "aha152x=0x340,11,7,1"
1365 #: build/C/man7/bootparam.7:543
1367 "Note that the parameters must be specified in order, meaning that if you "
1368 "want to specify a parity setting, then you will have to specify an iobase, "
1369 "irq, scsi-id and reconnect value as well."
1373 #: build/C/man7/bootparam.7:543
1375 msgid "B<Adaptec aha154x configuration>"
1379 #: build/C/man7/bootparam.7:551
1381 "The aha1542 series cards have an i82077 floppy controller onboard, while the "
1382 "aha1540 series cards do not. These are busmastering cards, and have "
1383 "parameters to set the \"fairness\" that is used to share the bus with other "
1384 "devices. The boot arg looks like the following."
1388 #: build/C/man7/bootparam.7:553
1389 msgid "B<aha1542=>I<iobase[,buson,busoff[,dmaspeed]]>"
1393 #: build/C/man7/bootparam.7:557
1395 "Valid iobase values are usually one of: 0x130, 0x134, 0x230, 0x234, 0x330, "
1396 "0x334. Clone cards may permit other values."
1400 #: build/C/man7/bootparam.7:565
1402 "The I<buson>, I<busoff> values refer to the number of microseconds that the "
1403 "card dominates the ISA bus. The defaults are 11us on, and 4us off, so that "
1404 "other cards (such as an ISA LANCE Ethernet card) have a chance to get access "
1409 #: build/C/man7/bootparam.7:576
1411 "The I<dmaspeed> value refers to the rate (in MB/s) at which the DMA (Direct "
1412 "Memory Access) transfers proceed. The default is 5MB/s. Newer revision "
1413 "cards allow you to select this value as part of the soft-configuration, "
1414 "older cards use jumpers. You can use values up to 10MB/s assuming that your "
1415 "motherboard is capable of handling it. Experiment with caution if using "
1416 "values over 5MB/s."
1420 #: build/C/man7/bootparam.7:576
1422 msgid "B<Adaptec aha274x, aha284x, aic7xxx configuration>"
1426 #: build/C/man7/bootparam.7:579
1427 msgid "These boards can accept an argument of the form:"
1431 #: build/C/man7/bootparam.7:581
1432 msgid "B<aic7xxx=>I<extended,no_reset>"
1436 #: build/C/man7/bootparam.7:590
1438 "The I<extended> value, if nonzero, indicates that extended translation for "
1439 "large disks is enabled. The I<no_reset> value, if nonzero, tells the driver "
1440 "not to reset the SCSI bus when setting up the host adapter at boot."
1444 #: build/C/man7/bootparam.7:590
1446 msgid "B<AdvanSys SCSI Hosts configuration ('advansys=')>"
1450 #: build/C/man7/bootparam.7:603
1452 "The AdvanSys driver can accept up to four i/o addresses that will be probed "
1453 "for an AdvanSys SCSI card. Note that these values (if used) do not effect "
1454 "EISA or PCI probing in any way. They are only used for probing ISA and VLB "
1455 "cards. In addition, if the driver has been compiled with debugging enabled, "
1456 "the level of debugging output can be set by adding an 0xdeb[0-f] parameter. "
1457 "The 0-f allows setting the level of the debugging messages to any of 16 "
1458 "levels of verbosity."
1462 #: build/C/man7/bootparam.7:603
1468 #: build/C/man7/bootparam.7:607
1469 msgid "B<AM53C974=>I<host-scsi-id,target-scsi-id,max-rate,max-offset>"
1473 #: build/C/man7/bootparam.7:607
1475 msgid "B<BusLogic SCSI Hosts configuration ('BusLogic=')>"
1479 #: build/C/man7/bootparam.7:611
1480 msgid "B<BusLogic=>I<N1,N2,N3,N4,N5,S1,S2,...>"
1484 #: build/C/man7/bootparam.7:618
1486 "For an extensive discussion of the BusLogic command line parameters, see "
1487 "I</usr/src/linux/drivers/scsi/BusLogic.c> (lines 3149-3270 in the kernel "
1488 "version I am looking at). The text below is a very much abbreviated "
1493 #: build/C/man7/bootparam.7:630
1495 "The parameters N1-N5 are integers. The parameters S1,... are strings. N1 "
1496 "is the I/O Address at which the Host Adapter is located. N2 is the Tagged "
1497 "Queue Depth to use for Target Devices that support Tagged Queuing. N3 is "
1498 "the Bus Settle Time in seconds. This is the amount of time to wait between "
1499 "a Host Adapter Hard Reset which initiates a SCSI Bus Reset and issuing any "
1500 "SCSI Commands. N4 is the Local Options (for one Host Adapter). N5 is the "
1501 "Global Options (for all Host Adapters)."
1505 #: build/C/man7/bootparam.7:636
1507 "The string options are used to provide control over Tagged Queuing "
1508 "(TQ:Default, TQ:Enable, TQ:Disable, TQ:E<lt>Per-Target-SpecE<gt>), over "
1509 "Error Recovery (ER:Default, ER:HardReset, ER:BusDeviceReset, ER:None, "
1510 "ER:E<lt>Per-Target-SpecE<gt>), and over Host Adapter Probing (NoProbe, "
1511 "NoProbeISA, NoSortPCI)."
1515 #: build/C/man7/bootparam.7:636
1517 msgid "B<EATA/DMA configuration>"
1521 #: build/C/man7/bootparam.7:639 build/C/man7/bootparam.7:746
1522 msgid "The default list of i/o ports to be probed can be changed by"
1526 #: build/C/man7/bootparam.7:641 build/C/man7/bootparam.7:748
1527 msgid "B<eata=>I<iobase,iobase,...>B<.>"
1531 #: build/C/man7/bootparam.7:641
1533 msgid "B<Future Domain TMC-16x0 configuration>"
1537 #: build/C/man7/bootparam.7:645
1538 msgid "B<fdomain=>I<iobase,irq[,adapter_id]>"
1542 #: build/C/man7/bootparam.7:645
1544 msgid "B<Great Valley Products (GVP) SCSI controller configuration>"
1548 #: build/C/man7/bootparam.7:649
1549 msgid "B<gvp11=>I<dma_transfer_bitmask>"
1553 #: build/C/man7/bootparam.7:649
1555 msgid "B<Future Domain TMC-8xx, TMC-950 configuration>"
1559 #: build/C/man7/bootparam.7:653
1560 msgid "B<tmc8xx=>I<mem_base,irq>"
1564 #: build/C/man7/bootparam.7:660 build/C/man7/bootparam.7:733
1566 "The I<mem_base> value is the value of the memory mapped I/O region that the "
1567 "card uses. This will usually be one of the following values: 0xc8000, "
1568 "0xca000, 0xcc000, 0xce000, 0xdc000, 0xde000."
1572 #: build/C/man7/bootparam.7:660
1574 msgid "B<IN2000 configuration>"
1578 #: build/C/man7/bootparam.7:664
1579 msgid "B<in2000=>I<S>"
1583 #: build/C/man7/bootparam.7:671
1585 "where S is a comma-separated string of items keyword[:value]. Recognized "
1586 "keywords (possibly with value) are: ioport:addr, noreset, nosync:x, "
1587 "period:ns, disconnect:x, debug:x, proc:x. For the function of these "
1588 "parameters, see I</usr/src/linux/drivers/scsi/in2000.c>."
1592 #: build/C/man7/bootparam.7:671
1594 msgid "B<NCR5380 and NCR53C400 configuration>"
1598 #: build/C/man7/bootparam.7:674
1599 msgid "The boot arg is of the form"
1603 #: build/C/man7/bootparam.7:676
1604 msgid "B<ncr5380=>I<iobase,irq,dma>"
1608 #: build/C/man7/bootparam.7:678
1613 #: build/C/man7/bootparam.7:680
1614 msgid "B<ncr53c400=>I<iobase,irq>"
1618 #: build/C/man7/bootparam.7:689
1620 "If the card doesn't use interrupts, then an IRQ value of 255 (0xff) will "
1621 "disable interrupts. An IRQ value of 254 means to autoprobe. More details "
1622 "can be found in the file I<Documentation/scsi/g_NCR5380.txt> (or "
1623 "I<drivers/scsi/README.g_NCR5380> for older kernels) in the kernel source."
1627 #: build/C/man7/bootparam.7:689
1629 msgid "B<NCR53C8xx configuration>"
1633 #: build/C/man7/bootparam.7:693
1634 msgid "B<ncr53c8xx=>I<S>"
1638 #: build/C/man7/bootparam.7:701
1640 "where S is a comma-separated string of items keyword:value. Recognized "
1641 "keywords are: mpar (master_parity), spar (scsi_parity), disc "
1642 "(disconnection), specf (special_features), ultra (ultra_scsi), fsn "
1643 "(force_sync_nego), tags (default_tags), sync (default_sync), verb (verbose), "
1644 "debug (debug), burst (burst_max). For the function of the assigned values, "
1645 "see I</usr/src/linux/drivers/scsi/ncr53c8xx.c>."
1649 #: build/C/man7/bootparam.7:701
1651 msgid "B<NCR53c406a configuration>"
1655 #: build/C/man7/bootparam.7:705
1656 msgid "B<ncr53c406a=>I<iobase[,irq[,fastpio]]>"
1660 #: build/C/man7/bootparam.7:708
1662 "Specify irq = 0 for noninterrupt driven mode. Set fastpio = 1 for fast pio "
1663 "mode, 0 for slow mode."
1667 #: build/C/man7/bootparam.7:708
1669 msgid "B<Pro Audio Spectrum configuration>"
1673 #: build/C/man7/bootparam.7:713
1675 "The PAS16 uses a NC5380 SCSI chip, and newer models support jumperless "
1676 "configuration. The boot arg is of the form:"
1680 #: build/C/man7/bootparam.7:715
1681 msgid "B<pas16=>I<iobase,irq>"
1685 #: build/C/man7/bootparam.7:720
1687 "The only difference is that you can specify an IRQ value of 255, which will "
1688 "tell the driver to work without using interrupts, albeit at a performance "
1689 "loss. The iobase is usually 0x388."
1693 #: build/C/man7/bootparam.7:720
1695 msgid "B<Seagate ST-0x configuration>"
1699 #: build/C/man7/bootparam.7:724
1701 "If your card is not detected at boot time, you will then have to use a boot "
1706 #: build/C/man7/bootparam.7:726
1707 msgid "B<st0x=>I<mem_base,irq>"
1711 #: build/C/man7/bootparam.7:733
1713 msgid "B<Trantor T128 configuration>"
1717 #: build/C/man7/bootparam.7:737
1719 "These cards are also based on the NCR5380 chip, and accept the following "
1724 #: build/C/man7/bootparam.7:739
1725 msgid "B<t128=>I<mem_base,irq>"
1729 #: build/C/man7/bootparam.7:743
1731 "The valid values for I<mem_base> are as follows: 0xcc000, 0xc8000, 0xdc000, "
1736 #: build/C/man7/bootparam.7:743
1738 msgid "B<UltraStor 14F/34F configuration>"
1742 #: build/C/man7/bootparam.7:748
1744 msgid "B<WD7000 configuration>"
1748 #: build/C/man7/bootparam.7:752
1749 msgid "B<wd7000=>I<irq,dma,iobase>"
1753 #: build/C/man7/bootparam.7:752
1755 msgid "B<Commodore Amiga A2091/590 SCSI controller configuration>"
1759 #: build/C/man7/bootparam.7:756
1760 msgid "B<wd33c93=>I<S>"
1764 #: build/C/man7/bootparam.7:763
1766 "where S is a comma-separated string of options. Recognized options are "
1767 "nosync:bitmask, nodma:x, period:ns, disconnect:x, debug:x, clock:x, next. "
1768 "For details, see I</usr/src/linux/drivers/scsi/wd33c93.c>."
1772 #: build/C/man7/bootparam.7:763
1778 #: build/C/man7/bootparam.7:764
1780 msgid "B<IDE Disk/CD-ROM Driver Parameters>"
1784 #: build/C/man7/bootparam.7:769
1786 "The IDE driver accepts a number of parameters, which range from disk "
1787 "geometry specifications, to support for broken controller chips. "
1788 "Drive-specific options are specified by using 'hdX=' with X in 'a'-'h'."
1792 #: build/C/man7/bootparam.7:773
1794 "Non-drive-specific options are specified with the prefix 'hd='. Note that "
1795 "using a drive-specific prefix for a non-drive-specific option will still "
1796 "work, and the option will just be applied as expected."
1800 #: build/C/man7/bootparam.7:783
1802 "Also note that 'hd=' can be used to refer to the next unspecified drive in "
1803 "the (a, ..., h) sequence. For the following discussions, the 'hd=' option "
1804 "will be cited for brevity. See the file I<Documentation/ide.txt> (or "
1805 "I<drivers/block/README.ide> for older kernels) in the kernel source for more "
1810 #: build/C/man7/bootparam.7:783
1812 msgid "B<The 'hd=cyls,heads,sects[,wpcom[,irq]]' options>"
1816 #: build/C/man7/bootparam.7:794
1818 "These options are used to specify the physical geometry of the disk. Only "
1819 "the first three values are required. The cylinder/head/sectors values will "
1820 "be those used by fdisk. The write precompensation value is ignored for IDE "
1821 "disks. The IRQ value specified will be the IRQ used for the interface that "
1822 "the drive resides on, and is not really a drive-specific parameter."
1826 #: build/C/man7/bootparam.7:794
1828 msgid "B<The 'hd=serialize' option>"
1832 #: build/C/man7/bootparam.7:802
1834 "The dual IDE interface CMD-640 chip is broken as designed such that when "
1835 "drives on the secondary interface are used at the same time as drives on the "
1836 "primary interface, it will corrupt your data. Using this option tells the "
1837 "driver to make sure that both interfaces are never used at the same time."
1841 #: build/C/man7/bootparam.7:802
1843 msgid "B<The 'hd=dtc2278' option>"
1847 #: build/C/man7/bootparam.7:807
1849 "This option tells the driver that you have a DTC-2278D IDE interface. The "
1850 "driver then tries to do DTC-specific operations to enable the second "
1851 "interface and to enable faster transfer modes."
1855 #: build/C/man7/bootparam.7:807
1857 msgid "B<The 'hd=noprobe' option>"
1861 #: build/C/man7/bootparam.7:811
1862 msgid "Do not probe for this drive. For example,"
1866 #: build/C/man7/bootparam.7:813
1867 msgid "hdb=noprobe hdb=1166,7,17"
1871 #: build/C/man7/bootparam.7:817
1873 "would disable the probe, but still specify the drive geometry so that it "
1874 "would be registered as a valid block device, and hence usable."
1878 #: build/C/man7/bootparam.7:817
1880 msgid "B<The 'hd=nowerr' option>"
1884 #: build/C/man7/bootparam.7:823
1886 "Some drives apparently have the B<WRERR_STAT> bit stuck on permanently. "
1887 "This enables a work-around for these broken devices."
1891 #: build/C/man7/bootparam.7:823
1893 msgid "B<The 'hd=cdrom' option>"
1897 #: build/C/man7/bootparam.7:829
1899 "This tells the IDE driver that there is an ATAPI compatible CD-ROM attached "
1900 "in place of a normal IDE hard disk. In most cases the CD-ROM is identified "
1901 "automatically, but if it isn't then this may help."
1905 #: build/C/man7/bootparam.7:829
1907 msgid "B<Standard ST-506 Disk Driver Options ('hd=')>"
1911 #: build/C/man7/bootparam.7:838
1913 "The standard disk driver can accept geometry arguments for the disks similar "
1914 "to the IDE driver. Note however that it only expects three values (C/H/S); "
1915 "any more or any less and it will silently ignore you. Also, it only accepts "
1916 "'hd=' as an argument, that is, 'hda=' and so on are not valid here. The "
1917 "format is as follows:"
1921 #: build/C/man7/bootparam.7:840
1922 msgid "hd=cyls,heads,sects"
1926 #: build/C/man7/bootparam.7:843
1928 "If there are two disks installed, the above is repeated with the geometry "
1929 "parameters of the second disk."
1933 #: build/C/man7/bootparam.7:843
1935 msgid "B<XT Disk Driver Options ('xd=')>"
1939 #: build/C/man7/bootparam.7:848
1941 "If you are unfortunate enough to be using one of these old 8 bit cards that "
1942 "move data at a whopping 125kB/s then here is the scoop. If the card is not "
1943 "recognized, you will have to use a boot arg of the form:"
1947 #: build/C/man7/bootparam.7:850
1948 msgid "xd=type,irq,iobase,dma_chan"
1951 #. 1.1.50, 1.3.81, 1.3.99, 2.0.34, 2.1.67, 2.1.78, 2.1.127
1953 #: build/C/man7/bootparam.7:866
1955 "The type value specifies the particular manufacturer of the card, overriding "
1956 "autodetection. For the types to use, consult the I<drivers/block/xd.c> "
1957 "source file of the kernel you are using. The type is an index in the list "
1958 "I<xd_sigs> and in the course of time types have been added to or deleted "
1959 "from the middle of the list, changing all type numbers. Today (Linux 2.5.0) "
1960 "the types are 0=generic; 1=DTC 5150cx; 2,3=DTC 5150x; 4,5=Western Digital; "
1961 "6,7,8=Seagate; 9=Omti; 10=XEBEC, and where here several types are given with "
1962 "the same designation, they are equivalent."
1966 #: build/C/man7/bootparam.7:873
1968 "The xd_setup() function does no checking on the values, and assumes that you "
1969 "entered all four values. Don't disappoint it. Here is an example usage for "
1970 "a WD1002 controller with the BIOS disabled/removed, using the 'default' XT "
1971 "controller parameters:"
1975 #: build/C/man7/bootparam.7:875
1976 msgid "xd=2,5,0x320,3"
1980 #: build/C/man7/bootparam.7:875
1982 msgid "B<Syquest's EZ* removable disks>"
1986 #: build/C/man7/bootparam.7:879
1987 msgid "B<ez=>I<iobase[,irq[,rep[,nybble]]]>"
1991 #: build/C/man7/bootparam.7:879
1993 msgid "IBM MCA Bus Devices"
1997 #: build/C/man7/bootparam.7:882
1998 msgid "See also I</usr/src/linux/Documentation/mca.txt>."
2002 #: build/C/man7/bootparam.7:882
2004 msgid "B<PS/2 ESDI hard disks>"
2008 #: build/C/man7/bootparam.7:885
2009 msgid "It is possible to specify the desired geometry at boot time:"
2013 #: build/C/man7/bootparam.7:887
2014 msgid "B<ed=>I<cyls,heads,sectors.>"
2018 #: build/C/man7/bootparam.7:889
2019 msgid "For a ThinkPad-720, add the option"
2023 #: build/C/man7/bootparam.7:891
2028 #: build/C/man7/bootparam.7:891
2030 msgid "B<IBM Microchannel SCSI Subsystem configuration>"
2034 #: build/C/man7/bootparam.7:895
2035 msgid "B<ibmmcascsi=>I<N>"
2039 #: build/C/man7/bootparam.7:897
2040 msgid "where N is the I<pun> (SCSI ID) of the subsystem."
2044 #: build/C/man7/bootparam.7:897
2046 msgid "B<The Aztech Interface>"
2050 #: build/C/man7/bootparam.7:900 build/C/man7/bootparam.7:985 build/C/man7/bootparam.7:990 build/C/man7/bootparam.7:1001 build/C/man7/bootparam.7:1006
2051 msgid "The syntax for this type of card is:"
2055 #: build/C/man7/bootparam.7:902
2056 msgid "aztcd=iobase[,magic_number]"
2060 #: build/C/man7/bootparam.7:907
2062 "If you set the magic_number to 0x79 then the driver will try and run anyway "
2063 "in the event of an unknown firmware version. All other values are ignored."
2067 #: build/C/man7/bootparam.7:907
2069 msgid "B<Parallel port CD-ROM drives>"
2073 #: build/C/man7/bootparam.7:910 build/C/man7/bootparam.7:955 build/C/man7/bootparam.7:1152 build/C/man7/bootparam.7:1160 build/C/man7/bootparam.7:1170 build/C/man7/bootparam.7:1180 build/C/man7/bootparam.7:1213 build/C/man7/bootparam.7:1230 build/C/man7/bootparam.7:1242 build/C/man7/bootparam.7:1266
2078 #: build/C/man7/bootparam.7:912
2079 msgid "pcd.driveN=prt,pro,uni,mod,slv,dly"
2083 #: build/C/man7/bootparam.7:914
2084 msgid "pcd.nice=nice"
2088 #: build/C/man7/bootparam.7:921
2090 "where 'port' is the base address, 'pro' is the protocol number, 'uni' is the "
2091 "unit selector (for chained devices), 'mod' is the mode (or -1 to choose the "
2092 "best automatically), 'slv' is 1 if it should be a slave, and 'dly' is a "
2093 "small integer for slowing down port accesses. The 'nice' parameter controls "
2094 "the driver's use of idle CPU time, at the expense of some speed."
2098 #: build/C/man7/bootparam.7:921
2100 msgid "B<The CDU-31A and CDU-33A Sony Interface>"
2104 #: build/C/man7/bootparam.7:926
2106 "This CD-ROM interface is found on some of the Pro Audio Spectrum sound "
2107 "cards, and other Sony supplied interface cards. The syntax is as follows:"
2111 #: build/C/man7/bootparam.7:928
2112 msgid "cdu31a=iobase,[irq[,is_pas_card]]"
2116 #: build/C/man7/bootparam.7:934
2118 "Specifying an IRQ value of zero tells the driver that hardware interrupts "
2119 "aren't supported (as on some PAS cards). If your card supports interrupts, "
2120 "you should use them as it cuts down on the CPU usage of the driver."
2124 #: build/C/man7/bootparam.7:939
2126 "The I<is_pas_card> should be entered as 'PAS' if using a Pro Audio Spectrum "
2127 "card, and otherwise it should not be specified at all."
2131 #: build/C/man7/bootparam.7:939
2133 msgid "B<The CDU-535 Sony Interface>"
2137 #: build/C/man7/bootparam.7:942 build/C/man7/bootparam.7:950 build/C/man7/bootparam.7:966
2138 msgid "The syntax for this CD-ROM interface is:"
2142 #: build/C/man7/bootparam.7:944
2143 msgid "sonycd535=iobase[,irq]"
2147 #: build/C/man7/bootparam.7:947
2149 "A zero can be used for the I/O base as a 'placeholder' if one wishes to "
2150 "specify an IRQ value."
2154 #: build/C/man7/bootparam.7:947
2156 msgid "B<The GoldStar Interface>"
2160 #: build/C/man7/bootparam.7:952
2165 #: build/C/man7/bootparam.7:952
2167 msgid "B<The ISP16 CD-ROM Interface>"
2171 #: build/C/man7/bootparam.7:957
2172 msgid "isp16=[iobase[,irq[,dma[,type]]]]"
2176 #: build/C/man7/bootparam.7:963
2178 "(three integers and a string). If the type is given as 'noisp16', the "
2179 "interface will not be configured. Other recognized types are: 'Sanyo\", "
2180 "'Sony', 'Panasonic' and 'Mitsumi'."
2184 #: build/C/man7/bootparam.7:963
2186 msgid "B<The Mitsumi Standard Interface>"
2190 #: build/C/man7/bootparam.7:968
2191 msgid "mcd=iobase,[irq[,wait_value]]"
2195 #: build/C/man7/bootparam.7:976
2197 "The I<wait_value> is used as an internal timeout value for people who are "
2198 "having problems with their drive, and may or may not be implemented "
2199 "depending on a compile-time #define. The Mitsumi FX400 is an IDE/ATAPI "
2200 "CD-ROM player and does not use the mcd driver."
2204 #: build/C/man7/bootparam.7:976
2206 msgid "B<The Mitsumi XA/MultiSession Interface>"
2210 #: build/C/man7/bootparam.7:980
2212 "This is for the same hardware as above, but the driver has extended "
2217 #: build/C/man7/bootparam.7:982
2218 msgid "mcdx=iobase[,irq]"
2222 #: build/C/man7/bootparam.7:982
2224 msgid "B<The Optics Storage Interface>"
2228 #: build/C/man7/bootparam.7:987
2229 msgid "optcd=iobase"
2233 #: build/C/man7/bootparam.7:987
2235 msgid "B<The Phillips CM206 Interface>"
2239 #: build/C/man7/bootparam.7:992
2240 msgid "cm206=[iobase][,irq]"
2244 #: build/C/man7/bootparam.7:998
2246 "The driver assumes numbers between 3 and 11 are IRQ values, and numbers "
2247 "between 0x300 and 0x370 are I/O ports, so you can specify one, or both "
2248 "numbers, in any order. It also accepts 'cm206=auto' to enable autoprobing."
2252 #: build/C/man7/bootparam.7:998
2254 msgid "B<The Sanyo Interface>"
2258 #: build/C/man7/bootparam.7:1003
2259 msgid "sjcd=iobase[,irq[,dma_channel]]"
2263 #: build/C/man7/bootparam.7:1003
2265 msgid "B<The SoundBlaster Pro Interface>"
2269 #: build/C/man7/bootparam.7:1008
2270 msgid "sbpcd=iobase,type"
2274 #: build/C/man7/bootparam.7:1013
2276 "where type is one of the following (case sensitive) strings: "
2277 "\\&'SoundBlaster', 'LaserMate', or 'SPEA'. The I/O base is that of the "
2278 "CD-ROM interface, and not that of the sound portion of the card."
2282 #: build/C/man7/bootparam.7:1013
2284 msgid "Ethernet Devices"
2288 #: build/C/man7/bootparam.7:1017
2290 "Different drivers make use of different parameters, but they all at least "
2291 "share having an IRQ, an I/O port base value, and a name. In its most "
2292 "generic form, it looks something like this:"
2296 #: build/C/man7/bootparam.7:1019
2297 msgid "ether=irq,iobase[,param_1[,...param_8]],name"
2301 #: build/C/man7/bootparam.7:1026
2303 "The first nonnumeric argument is taken as the name. The param_n values (if "
2304 "applicable) usually have different meanings for each different card/driver. "
2305 "Typical param_n values are used to specify things like shared memory "
2306 "address, interface selection, DMA channel and the like."
2310 #: build/C/man7/bootparam.7:1030
2312 "The most common use of this parameter is to force probing for a second "
2313 "ethercard, as the default is to only probe for one. This can be "
2314 "accomplished with a simple:"
2318 #: build/C/man7/bootparam.7:1032
2319 msgid "ether=0,0,eth1"
2323 #: build/C/man7/bootparam.7:1035
2325 "Note that the values of zero for the IRQ and I/O base in the above example "
2326 "tell the driver(s) to autoprobe."
2330 #: build/C/man7/bootparam.7:1041
2332 "The Ethernet-HowTo has extensive documentation on using multiple cards and "
2333 "on the card/driver-specific implementation of the param_n values where "
2334 "used. Interested readers should refer to the section in that document on "
2335 "their particular card."
2339 #: build/C/man7/bootparam.7:1041
2341 msgid "The Floppy Disk Driver"
2345 #: build/C/man7/bootparam.7:1049
2347 "There are many floppy driver options, and they are all listed in "
2348 "I<Documentation/floppy.txt> (or I<drivers/block/README.fd> for older "
2349 "kernels) in the kernel source. This information is taken directly from that "
2354 #: build/C/man7/bootparam.7:1049
2356 msgid "B<floppy=mask,allowed_drive_mask>"
2360 #: build/C/man7/bootparam.7:1059
2362 "Sets the bit mask of allowed drives to mask. By default, only units 0 and 1 "
2363 "of each floppy controller are allowed. This is done because certain "
2364 "nonstandard hardware (ASUS PCI motherboards) mess up the keyboard when "
2365 "accessing units 2 or 3. This option is somewhat obsoleted by the cmos "
2370 #: build/C/man7/bootparam.7:1059
2372 msgid "B<floppy=all_drives>"
2376 #: build/C/man7/bootparam.7:1064
2378 "Sets the bit mask of allowed drives to all drives. Use this if you have "
2379 "more than two drives connected to a floppy controller."
2383 #: build/C/man7/bootparam.7:1064
2385 msgid "B<floppy=asus_pci>"
2389 #: build/C/man7/bootparam.7:1068
2390 msgid "Sets the bit mask to allow only units 0 and 1. (The default)"
2394 #: build/C/man7/bootparam.7:1068
2396 msgid "B<floppy=daring>"
2400 #: build/C/man7/bootparam.7:1075
2402 "Tells the floppy driver that you have a well behaved floppy controller. "
2403 "This allows more efficient and smoother operation, but may fail on certain "
2404 "controllers. This may speed up certain operations."
2408 #: build/C/man7/bootparam.7:1075
2410 msgid "B<floppy=0,daring>"
2414 #: build/C/man7/bootparam.7:1079
2416 "Tells the floppy driver that your floppy controller should be used with "
2421 #: build/C/man7/bootparam.7:1079
2423 msgid "B<floppy=one_fdc>"
2427 #: build/C/man7/bootparam.7:1082
2428 msgid "Tells the floppy driver that you have only floppy controller (default)"
2432 #: build/C/man7/bootparam.7:1082
2434 msgid "B<floppy=two_fdc> or B<floppy=address,two_fdc>"
2438 #: build/C/man7/bootparam.7:1088
2440 "Tells the floppy driver that you have two floppy controllers. The second "
2441 "floppy controller is assumed to be at address. If address is not given, "
2446 #: build/C/man7/bootparam.7:1088
2448 msgid "B<floppy=thinkpad>"
2452 #: build/C/man7/bootparam.7:1093
2454 "Tells the floppy driver that you have a Thinkpad. Thinkpads use an inverted "
2455 "convention for the disk change line."
2459 #: build/C/man7/bootparam.7:1093
2461 msgid "B<floppy=0,thinkpad>"
2465 #: build/C/man7/bootparam.7:1096
2466 msgid "Tells the floppy driver that you don't have a Thinkpad."
2470 #: build/C/man7/bootparam.7:1096
2472 msgid "B<floppy=drive,type,cmos>"
2476 #: build/C/man7/bootparam.7:1107
2478 "Sets the cmos type of drive to type. Additionally, this drive is allowed in "
2479 "the bit mask. This is useful if you have more than two floppy drives (only "
2480 "two can be described in the physical cmos), or if your BIOS uses nonstandard "
2481 "CMOS types. Setting the CMOS to 0 for the first two drives (default) makes "
2482 "the floppy driver read the physical cmos for those drives."
2486 #: build/C/man7/bootparam.7:1107
2488 msgid "B<floppy=unexpected_interrupts>"
2492 #: build/C/man7/bootparam.7:1111
2494 "Print a warning message when an unexpected interrupt is received (default "
2499 #: build/C/man7/bootparam.7:1111
2501 msgid "B<floppy=no_unexpected_interrupts> or B<floppy=L40SX>"
2505 #: build/C/man7/bootparam.7:1119
2507 "Don't print a message when an unexpected interrupt is received. This is "
2508 "needed on IBM L40SX laptops in certain video modes. (There seems to be an "
2509 "interaction between video and floppy. The unexpected interrupts only affect "
2510 "performance, and can safely be ignored.)"
2514 #: build/C/man7/bootparam.7:1119
2516 msgid "The Sound Driver"
2520 #: build/C/man7/bootparam.7:1129
2522 "The sound driver can also accept boot args to override the compiled in "
2523 "values. This is not recommended, as it is rather complex. It is described "
2524 "in the kernel source file I<Documentation/sound/oss/README.OSS> "
2525 "(I<drivers/sound/Readme.linux> in older kernel versions). It accepts a boot "
2530 #: build/C/man7/bootparam.7:1131
2531 msgid "sound=device1[,device2[,device3...[,device10]]]"
2535 #: build/C/man7/bootparam.7:1134
2537 "where each deviceN value is of the following format 0xTaaaId and the bytes "
2538 "are used as follows:"
2542 #: build/C/man7/bootparam.7:1137
2543 msgid "T - device type: 1=FM, 2=SB, 3=PAS, 4=GUS, 5=MPU401, 6=SB16, 7=SB16-MPU401"
2547 #: build/C/man7/bootparam.7:1139
2548 msgid "aaa - I/O address in hex."
2552 #: build/C/man7/bootparam.7:1141
2553 msgid "I - interrupt line in hex (i.e 10=a, 11=b, ...)"
2557 #: build/C/man7/bootparam.7:1143
2558 msgid "d - DMA channel."
2562 #: build/C/man7/bootparam.7:1148
2564 "As you can see it gets pretty messy, and you are better off to compile in "
2565 "your own personal values as recommended. Using a boot arg of \\&'sound=0' "
2566 "will disable the sound driver entirely."
2570 #: build/C/man7/bootparam.7:1148
2572 msgid "ISDN Drivers"
2576 #: build/C/man7/bootparam.7:1149
2578 msgid "B<The ICN ISDN driver>"
2582 #: build/C/man7/bootparam.7:1154
2583 msgid "icn=iobase,membase,icn_id1,icn_id2"
2587 #: build/C/man7/bootparam.7:1157
2589 "where icn_id1,icn_id2 are two strings used to identify the card in kernel "
2594 #: build/C/man7/bootparam.7:1157
2596 msgid "B<The PCBIT ISDN driver>"
2600 #: build/C/man7/bootparam.7:1162
2601 msgid "pcbit=membase1,irq1[,membase2,irq2]"
2605 #: build/C/man7/bootparam.7:1167
2607 "where membaseN is the shared memory base of the N'th card, and irqN is the "
2608 "interrupt setting of the N'th card. The default is IRQ 5 and membase "
2613 #: build/C/man7/bootparam.7:1167
2615 msgid "B<The Teles ISDN driver>"
2619 #: build/C/man7/bootparam.7:1172
2620 msgid "teles=iobase,irq,membase,protocol,teles_id"
2624 #: build/C/man7/bootparam.7:1176
2626 "where iobase is the i/o port address of the card, membase is the shared "
2627 "memory base address of the card, irq is the interrupt channel the card uses, "
2628 "and teles_id is the unique ASCII string identifier."
2632 #: build/C/man7/bootparam.7:1176
2634 msgid "Serial Port Drivers"
2638 #: build/C/man7/bootparam.7:1177
2640 msgid "B<The RISCom/8 Multiport Serial Driver ('riscom8=')>"
2644 #: build/C/man7/bootparam.7:1182
2645 msgid "riscom=iobase1[,iobase2[,iobase3[,iobase4]]]"
2649 #: build/C/man7/bootparam.7:1185
2650 msgid "More details can be found in I</usr/src/linux/Documentation/riscom8.txt>."
2654 #: build/C/man7/bootparam.7:1185
2656 msgid "B<The DigiBoard Driver ('digi=')>"
2660 #: build/C/man7/bootparam.7:1189
2661 msgid "If this option is used, it should have precisely six parameters. Syntax:"
2665 #: build/C/man7/bootparam.7:1191
2666 msgid "digi=status,type,altpin,numports,iobase,membase"
2670 #: build/C/man7/bootparam.7:1203
2672 "The parameters maybe given as integers, or as strings. If strings are used, "
2673 "then iobase and membase should be given in hexadecimal. The integer "
2674 "arguments (fewer may be given) are in order: status (Enable(1) or Disable(0) "
2675 "this card), type (PC/Xi(0), PC/Xe(1), PC/Xeve(2), PC/Xem(3)), altpin "
2676 "(Enable(1) or Disable(0) alternate pin arrangement), numports (number of "
2677 "ports on this card), iobase (I/O Port where card is configured (in HEX)), "
2678 "membase (base of memory window (in HEX)). Thus, the following two boot "
2679 "prompt arguments are equivalent:"
2683 #: build/C/man7/bootparam.7:1205
2684 msgid "digi=E,PC/Xi,D,16,200,D0000"
2688 #: build/C/man7/bootparam.7:1207
2689 msgid "digi=1,0,0,16,0x200,851968"
2693 #: build/C/man7/bootparam.7:1210
2694 msgid "More details can be found in I</usr/src/linux/Documentation/digiboard.txt>."
2698 #: build/C/man7/bootparam.7:1210
2700 msgid "B<The Baycom Serial/Parallel Radio Modem>"
2704 #: build/C/man7/bootparam.7:1215
2705 msgid "baycom=iobase,irq,modem"
2709 #: build/C/man7/bootparam.7:1227
2711 "There are precisely 3 parameters; for several cards, give several 'baycom=' "
2712 "commands. The modem parameter is a string that can take one of the values "
2713 "ser12, ser12*, par96, par96*. Here the * denotes that software DCD is to be "
2714 "used, and ser12/par96 chooses between the supported modem types. For more "
2715 "details, see the file I<Documentation/networking/baycom.txt> (or "
2716 "I<drivers/net/README.baycom> for older kernels) in the kernel source."
2720 #: build/C/man7/bootparam.7:1227
2722 msgid "B<Soundcard radio modem driver>"
2726 #: build/C/man7/bootparam.7:1232
2727 msgid "soundmodem=iobase,irq,dma[,dma2[,serio[,pario]]],0,mode"
2731 #: build/C/man7/bootparam.7:1238
2733 "All parameters except the last are integers; the dummy 0 is required because "
2734 "of a bug in the setup code. The mode parameter is a string with syntax "
2735 "hw:modem, where hw is one of sbc, wss, wssfdx and modem is one of afsk1200, "
2740 #: build/C/man7/bootparam.7:1238
2742 msgid "The Line Printer Driver"
2746 #: build/C/man7/bootparam.7:1239
2752 #: build/C/man7/bootparam.7:1244
2757 #: build/C/man7/bootparam.7:1246
2762 #: build/C/man7/bootparam.7:1248
2767 #: build/C/man7/bootparam.7:1250
2768 msgid "lp=port[,port...]"
2772 #: build/C/man7/bootparam.7:1256
2774 "You can tell the printer driver what ports to use and what ports not to "
2775 "use. The latter comes in handy if you don't want the printer driver to "
2776 "claim all available parallel ports, so that other drivers (e.g., PLIP, PPA) "
2777 "can use them instead."
2781 #: build/C/man7/bootparam.7:1263
2783 "The format of the argument is multiple port names. For example, "
2784 "lp=none,parport0 would use the first parallel port for lp1, and disable "
2785 "lp0. To disable the printer driver entirely, one can use lp=0."
2789 #: build/C/man7/bootparam.7:1263
2791 msgid "B<WDT500/501 driver>"
2795 #: build/C/man7/bootparam.7:1268
2800 #: build/C/man7/bootparam.7:1268
2802 msgid "Mouse Drivers"
2806 #: build/C/man7/bootparam.7:1269
2808 msgid "B<'bmouse=irq'>"
2812 #: build/C/man7/bootparam.7:1273
2814 "The busmouse driver only accepts one parameter, that being the hardware IRQ "
2819 #: build/C/man7/bootparam.7:1273
2821 msgid "B<'msmouse=irq'>"
2825 #: build/C/man7/bootparam.7:1276
2826 msgid "And precisely the same is true for the msmouse driver."
2830 #: build/C/man7/bootparam.7:1276
2832 msgid "B<ATARI mouse setup>"
2836 #: build/C/man7/bootparam.7:1280
2837 msgid "atamouse=threshold[,y-threshold]"
2841 #: build/C/man7/bootparam.7:1286
2843 "If only one argument is given, it is used for both x-threshold and "
2844 "y-threshold. Otherwise, the first argument is the x-threshold, and the "
2845 "second the y-threshold. These values must lie between 1 and 20 (inclusive); "
2850 #: build/C/man7/bootparam.7:1286
2852 msgid "Video Hardware"
2856 #: build/C/man7/bootparam.7:1287
2858 msgid "B<'no-scroll'>"
2862 #. Linus Torvalds (and many others)
2864 #: build/C/man7/bootparam.7:1296
2866 "This option tells the console driver not to use hardware scroll (where a "
2867 "scroll is effected by moving the screen origin in video memory, instead of "
2868 "moving the data). It is required by certain Braille machines."
2872 #: build/C/man7/bootparam.7:1302
2873 msgid "B<lilo.conf>(5), B<klogd>(8), B<lilo>(8), B<mount>(8), B<rdev>(8)"
2877 #: build/C/man7/bootparam.7:1308
2879 "Large parts of this man page have been derived from the Boot Parameter HOWTO "
2880 "(version 1.0.1) written by Paul Gortmaker. More information may be found in "
2881 "this (or a more recent) HOWTO. An up-to-date source of information is "
2882 "I</usr/src/linux/Documentation/kernel-parameters.txt>."
2886 #: build/C/man2/reboot.2:25
2892 #: build/C/man2/reboot.2:25
2898 #: build/C/man2/reboot.2:28
2899 msgid "reboot - reboot or enable/disable Ctrl-Alt-Del"
2903 #: build/C/man2/reboot.2:33
2906 "/* For libc4 and libc5 the library call and the system call\n"
2907 " are identical, and since kernel version 2.1.30 there are\n"
2908 " symbolic names LINUX_REBOOT_* for the constants and a\n"
2909 " fourth argument to the call: */\n"
2913 #: build/C/man2/reboot.2:35 build/C/man2/reboot.2:45 build/C/man2/sync.2:41
2914 msgid "B<#include E<lt>unistd.hE<gt>>"
2918 #: build/C/man2/reboot.2:37
2919 msgid "B<#include E<lt>linux/reboot.hE<gt>>"
2923 #: build/C/man2/reboot.2:39
2925 "B<int reboot(int >I<magic>B<, int >I<magic2>B<, int >I<cmd>B<, void "
2930 #: build/C/man2/reboot.2:43
2933 "/* Under glibc some of the constants involved have gotten\n"
2934 " symbolic names RB_*, and the library call is a 1-argument\n"
2935 " wrapper around the 3-argument system call: */\n"
2939 #: build/C/man2/reboot.2:47
2940 msgid "B<#include E<lt>sys/reboot.hE<gt>>"
2944 #: build/C/man2/reboot.2:49
2945 msgid "B<int reboot(int >I<cmd>B<);>"
2949 #: build/C/man2/reboot.2:56
2951 "The B<reboot>() call reboots the system, or enables/disables the reboot "
2952 "keystroke (abbreviated CAD, since the default is Ctrl-Alt-Delete; it can be "
2953 "changed using B<loadkeys>(1))."
2957 #: build/C/man2/reboot.2:83
2959 "This system call will fail (with B<EINVAL>) unless I<magic> equals "
2960 "B<LINUX_REBOOT_MAGIC1> (that is, 0xfee1dead) and I<magic2> equals "
2961 "B<LINUX_REBOOT_MAGIC2> (that is, 672274793). However, since 2.1.17 also "
2962 "B<LINUX_REBOOT_MAGIC2A> (that is, 85072278) and since 2.1.97 also "
2963 "B<LINUX_REBOOT_MAGIC2B> (that is, 369367448) and since 2.5.71 also "
2964 "B<LINUX_REBOOT_MAGIC2C> (that is, 537993216) are permitted as value for "
2965 "I<magic2>. (The hexadecimal values of these constants are meaningful.) The "
2966 "I<cmd> argument can have the following values:"
2970 #: build/C/man2/reboot.2:83
2972 msgid "B<LINUX_REBOOT_CMD_CAD_OFF>"
2976 #: build/C/man2/reboot.2:92
2978 "(RB_DISABLE_CAD, 0). CAD is disabled. This means that the CAD keystroke "
2979 "will cause a B<SIGINT> signal to be sent to init (process 1), whereupon this "
2980 "process may decide upon a proper action (maybe: kill all processes, sync, "
2985 #: build/C/man2/reboot.2:92
2987 msgid "B<LINUX_REBOOT_CMD_CAD_ON>"
2991 #: build/C/man2/reboot.2:99
2993 "(RB_ENABLE_CAD, 0x89abcdef). CAD is enabled. This means that the CAD "
2994 "keystroke will immediately cause the action associated with "
2995 "B<LINUX_REBOOT_CMD_RESTART>."
2999 #: build/C/man2/reboot.2:99
3001 msgid "B<LINUX_REBOOT_CMD_HALT>"
3005 #: build/C/man2/reboot.2:107
3007 "(RB_HALT_SYSTEM, 0xcdef0123; since 1.1.76). The message \"System halted.\" "
3008 "is printed, and the system is halted. Control is given to the ROM monitor, "
3009 "if there is one. If not preceded by a B<sync>(2), data will be lost."
3013 #: build/C/man2/reboot.2:107
3015 msgid "B<LINUX_REBOOT_CMD_KEXEC> (since Linux 2.6.13)"
3019 #: build/C/man2/reboot.2:113
3021 "Execute a kernel that has been loaded earlier with B<kexec_load>(2). This "
3022 "option is only available if the kernel was configured with B<CONFIG_KEXEC>."
3026 #: build/C/man2/reboot.2:113
3028 msgid "B<LINUX_REBOOT_CMD_POWER_OFF>"
3032 #: build/C/man2/reboot.2:121
3034 "(0x4321fedc; since 2.1.30). The message \"Power down.\" is printed, the "
3035 "system is stopped, and all power is removed from the system, if possible. "
3036 "If not preceded by a B<sync>(2), data will be lost."
3040 #: build/C/man2/reboot.2:121
3042 msgid "B<LINUX_REBOOT_CMD_RESTART>"
3046 #: build/C/man2/reboot.2:129
3048 "(RB_AUTOBOOT, 0x1234567). The message \"Restarting system.\" is printed, "
3049 "and a default restart is performed immediately. If not preceded by a "
3050 "B<sync>(2), data will be lost."
3054 #: build/C/man2/reboot.2:129
3056 msgid "B<LINUX_REBOOT_CMD_RESTART2>"
3060 #: build/C/man2/reboot.2:139
3062 "(0xa1b2c3d4; since 2.1.30). The message \"Restarting system with command "
3063 "\\(aq%s\\(aq\" is printed, and a restart (using the command string given in "
3064 "I<arg>) is performed immediately. If not preceded by a B<sync>(2), data "
3069 #: build/C/man2/reboot.2:142
3070 msgid "Only the superuser may call B<reboot>()."
3074 #: build/C/man2/reboot.2:148
3076 "The precise effect of the above actions depends on the architecture. For "
3077 "the i386 architecture, the additional argument does not do anything at "
3078 "present (2.1.122), but the type of reboot can be determined by kernel "
3079 "command-line arguments (\"reboot=...\") to be either warm or cold, and "
3080 "either hard or through the BIOS."
3084 #: build/C/man2/reboot.2:161
3086 "For the values of I<cmd> that stop or restart the system, a successful call "
3087 "to B<reboot>() does not return. For the other I<cmd> values, zero is "
3088 "returned on success. In all cases, -1 is returned on failure, and I<errno> "
3089 "is set appropriately."
3093 #: build/C/man2/reboot.2:166
3094 msgid "Problem with getting userspace data under B<LINUX_REBOOT_CMD_RESTART2>."
3098 #: build/C/man2/reboot.2:169
3099 msgid "Bad magic numbers or I<cmd>."
3103 #: build/C/man2/reboot.2:176
3105 "The calling process has insufficient privilege to call B<reboot>(); the "
3106 "B<CAP_SYS_BOOT> capability is required."
3110 #: build/C/man2/reboot.2:180
3112 "B<reboot>() is Linux-specific, and should not be used in programs intended "
3117 #: build/C/man2/reboot.2:187
3119 "B<sync>(2), B<bootparam>(7), B<capabilities>(7), B<ctrlaltdel>(8), "
3120 "B<halt>(8), B<reboot>(8)"
3124 #: build/C/man2/sync.2:36 build/C/man8/sync.8:6
3130 #: build/C/man2/sync.2:36
3136 #: build/C/man2/sync.2:39
3137 msgid "sync, syncfs - commit buffer cache to disk"
3141 #: build/C/man2/sync.2:43
3142 msgid "B<void sync(void);>"
3146 #: build/C/man2/sync.2:45
3147 msgid "B<int syncfs(int >I<fd>B<);>"
3151 #: build/C/man2/sync.2:49
3152 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
3156 #: build/C/man2/sync.2:52
3161 #: build/C/man2/sync.2:56
3163 "_BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE\\ &&\\ "
3164 "_XOPEN_SOURCE_EXTENDED"
3168 #: build/C/man2/sync.2:60
3169 msgid "B<syncfs>():"
3173 #: build/C/man2/sync.2:63
3178 #: build/C/man2/sync.2:69
3180 "B<sync>() causes all buffered modifications to file metadata and data to be "
3181 "written to the underlying file systems."
3185 #: build/C/man2/sync.2:76
3187 "B<syncfs>() is like B<sync>(), but synchronizes just the file system "
3188 "containing file referred to by the open file descriptor I<fd>."
3192 #: build/C/man2/sync.2:82
3194 "B<syncfs>() returns 0 on success; on error, it returns -1 and sets I<errno> "
3195 "to indicate the error."
3199 #: build/C/man2/sync.2:85
3200 msgid "B<sync>() is always successful."
3204 #: build/C/man2/sync.2:88
3205 msgid "B<syncfs>() can fail for at least the following reason:"
3209 #: build/C/man2/sync.2:88
3215 #: build/C/man2/sync.2:92
3216 msgid "I<fd> is not a valid file descriptor."
3220 #: build/C/man2/sync.2:92
3226 #: build/C/man2/sync.2:95
3227 msgid "B<syncfs>() first appeared in Linux 2.6.39."
3231 #: build/C/man2/sync.2:98
3232 msgid "B<sync>(): SVr4, 4.3BSD, POSIX.1-2001."
3236 #: build/C/man2/sync.2:101
3237 msgid "B<syncfs>() is Linux-specific."
3241 #: build/C/man2/sync.2:101 build/C/man8/sync.8:63
3247 #: build/C/man2/sync.2:110
3249 "Since glibc 2.2.2 the Linux prototype for B<sync>() is as listed above, "
3250 "following the various standards. In libc4, libc5, and glibc up to 2.2.1 it "
3251 "was \"int sync(void)\", and B<sync>() always returned 0."
3255 #: build/C/man2/sync.2:110
3261 #: build/C/man2/sync.2:118
3263 "According to the standard specification (e.g., POSIX.1-2001), B<sync>() "
3264 "schedules the writes, but may return before the actual writing is done. "
3265 "However, since version 1.3.20 Linux does actually wait. (This still does "
3266 "not guarantee data integrity: modern disks have large caches.)"
3270 #: build/C/man2/sync.2:124
3271 msgid "B<bdflush>(2), B<fdatasync>(2), B<fsync>(2), B<sync>(8), B<update>(8)"
3275 #: build/C/man8/sync.8:6
3281 #: build/C/man8/sync.8:6
3287 #: build/C/man8/sync.8:9
3288 msgid "sync - synchronize data on disk with memory"
3292 #: build/C/man8/sync.8:11
3293 msgid "B<sync [--help] [--version]>"
3297 #: build/C/man8/sync.8:22
3299 "B<sync> writes any data buffered in memory out to disk. This can include "
3300 "(but is not limited to) modified superblocks, modified inodes, and delayed "
3301 "reads and writes. This must be implemented by the kernel; The B<sync> "
3302 "program does nothing but exercise the B<sync>(2) system call."
3306 #: build/C/man8/sync.8:29
3308 "The kernel keeps data in memory to avoid doing (relatively slow) disk reads "
3309 "and writes. This improves performance, but if the computer crashes, data "
3310 "may be lost or the file system corrupted as a result. B<sync> ensures that "
3311 "everything in memory is written to disk."
3315 #: build/C/man8/sync.8:48
3317 "B<sync> should be called before the processor is halted in an unusual manner "
3318 "(e.g., before causing a kernel panic when debugging new kernel code). In "
3319 "general, the processor should be halted using the B<shutdown>(8) or "
3320 "B<reboot>(8) or B<halt>(8) commands, which will attempt to put the system "
3321 "in a quiescent state before calling B<sync>(2). (Various implementations of "
3322 "these commands exist; consult your documentation; on some systems one should "
3323 "not call B<reboot>(8) and B<halt>(8) directly.)"
3327 #: build/C/man8/sync.8:48
3333 #: build/C/man8/sync.8:49
3339 #: build/C/man8/sync.8:52
3340 msgid "Print a usage message on standard output and exit successfully."
3344 #: build/C/man8/sync.8:52
3346 msgid "B<--version>"
3350 #: build/C/man8/sync.8:55
3351 msgid "Print version information on standard output, then exit successfully."
3355 #: build/C/man8/sync.8:55
3361 #: build/C/man8/sync.8:58
3362 msgid "Terminate option list."
3366 #: build/C/man8/sync.8:58
3372 #: build/C/man8/sync.8:61
3374 "The variables B<LANG>, B<LC_ALL>, B<LC_CTYPE>, and B<LC_MESSAGES> have the "
3379 #: build/C/man8/sync.8:63
3384 #: build/C/man8/sync.8:75
3386 "On Linux, B<sync> is only guaranteed to schedule the dirty blocks for "
3387 "writing; it can actually take a short time before all the blocks are finally "
3388 "written. The B<reboot>(8) and B<halt>(8) commands take this into account "
3389 "by sleeping for a few seconds after calling B<sync>(2)."
3393 #: build/C/man8/sync.8:80
3395 "This page describes B<sync> as found in the file\\%utils-4.0 package; other "
3396 "versions may differ slightly."
3400 #: build/C/man8/sync.8:85
3401 msgid "B<sync>(2), B<halt>(8), B<reboot>(8), B<update>(8)"