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: 2013-03-22 01:04+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:27
26 #: build/C/man2/bdflush.2:27
32 #: build/C/man2/bdflush.2:27 build/C/man7/boot.7:15 build/C/man7/bootparam.7:30 build/C/man2/reboot.2:28 build/C/man2/sync.2:36
38 #: build/C/man2/bdflush.2:27 build/C/man7/boot.7:15 build/C/man7/bootparam.7:30 build/C/man2/reboot.2:28 build/C/man2/sync.2:36 build/C/man8/sync.8:10
40 msgid "Linux Programmer's Manual"
44 #: build/C/man2/bdflush.2:28 build/C/man7/boot.7:16 build/C/man7/bootparam.7:31 build/C/man2/reboot.2:29 build/C/man2/sync.2:37 build/C/man8/sync.8:11
50 #: build/C/man2/bdflush.2:30
51 msgid "bdflush - start, flush, or tune buffer-dirty-flush daemon"
55 #: build/C/man2/bdflush.2:30 build/C/man2/reboot.2:31 build/C/man2/sync.2:39 build/C/man8/sync.8:13
61 #: build/C/man2/bdflush.2:33
63 msgid "B<#include E<lt>sys/kdaemon.hE<gt>>\n"
67 #: build/C/man2/bdflush.2:36
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:37 build/C/man7/boot.7:18 build/C/man7/bootparam.7:33 build/C/man2/reboot.2:52 build/C/man2/sync.2:65 build/C/man8/sync.8:15
80 #. As noted in a changes in the 2.5.12 source
82 #: build/C/man2/bdflush.2:48
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:55
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:61
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:66
107 msgid "If I<func> is 1, some dirty buffers are written to disk."
111 #: build/C/man2/bdflush.2:75
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:84
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:88
129 "The set of parameters, their values, and their valid ranges are defined in "
130 "the Linux kernel source file I<fs/buffer.c>."
134 #: build/C/man2/bdflush.2:88 build/C/man2/reboot.2:151 build/C/man2/sync.2:76
140 #: build/C/man2/bdflush.2:97
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:97 build/C/man2/reboot.2:164 build/C/man2/sync.2:82
154 #: build/C/man2/bdflush.2:98
160 #: build/C/man2/bdflush.2:102
162 "An attempt was made to enter the daemon code after another process has "
167 #: build/C/man2/bdflush.2:102 build/C/man2/reboot.2:165
173 #: build/C/man2/bdflush.2:106
174 msgid "I<address> points outside your accessible address space."
178 #: build/C/man2/bdflush.2:106 build/C/man2/reboot.2:169
184 #: build/C/man2/bdflush.2:110
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:110 build/C/man2/reboot.2:172
197 #: build/C/man2/bdflush.2:115
198 msgid "Caller does not have the B<CAP_SYS_ADMIN> capability."
202 #: build/C/man2/bdflush.2:115 build/C/man2/reboot.2:179 build/C/man2/sync.2:96 build/C/man8/sync.8:65
204 msgid "CONFORMING TO"
208 #: build/C/man2/bdflush.2:119
210 "B<bdflush>() is Linux-specific and should not be used in programs intended "
215 #: build/C/man2/bdflush.2:119 build/C/man7/boot.7:202 build/C/man7/bootparam.7:1305 build/C/man2/reboot.2:183 build/C/man2/sync.2:119 build/C/man8/sync.8:84
221 #: build/C/man2/bdflush.2:124
222 msgid "B<fsync>(2), B<sync>(2), B<sync>(8), B<update>(8)"
226 #: build/C/man2/bdflush.2:124 build/C/man7/boot.7:208 build/C/man7/bootparam.7:1317 build/C/man2/reboot.2:190 build/C/man2/sync.2:125 build/C/man8/sync.8:89
232 #: build/C/man2/bdflush.2:131 build/C/man7/boot.7:215 build/C/man7/bootparam.7:1324 build/C/man2/reboot.2:197 build/C/man2/sync.2:132 build/C/man8/sync.8:96
234 "This page is part of release 3.50 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:15
246 #: build/C/man7/boot.7:15
252 #: build/C/man7/boot.7:18
253 msgid "boot-scripts - general description of boot sequence"
257 #: build/C/man7/boot.7:26
259 "The boot sequence varies in details among systems but can be roughly divided "
260 "to the following steps: (i) hardware boot, (ii) operating system (OS) "
261 "loader, (iii) kernel startup, (iv) init and inittab, (v) boot scripts. We "
262 "will describe each of these in more detail below."
266 #: build/C/man7/boot.7:26
268 msgid "Hardware-boot"
272 #: build/C/man7/boot.7:31
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:40
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:45
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:49
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:49 build/C/man7/boot.7:128
312 #: build/C/man7/boot.7:55
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:55
325 #: build/C/man7/boot.7:59
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:67
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:71
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:81
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:89
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:89
370 msgid "Kernel startup"
374 #: build/C/man7/boot.7:94
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:101
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:108
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:108
400 msgid "init and inittab"
404 #: build/C/man7/boot.7:113
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:123
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). The administrator may change the "
416 "current run-level via B<init>(8) and query the current run-level via "
421 #: build/C/man7/boot.7:127
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:127
435 #: build/C/man7/boot.7:136
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:149
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:149
460 msgid "Sequencing directories"
464 #: build/C/man7/boot.7:157
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:166
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:176
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:181
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:181
505 msgid "Boot configuration"
509 #: build/C/man7/boot.7:190
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:197
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:197
534 #: build/C/man7/boot.7:202
535 msgid "I</etc/init.d/>, I</etc/rc[S0-6].d/>, I</etc/sysconfig/>"
539 #: build/C/man7/boot.7:208
540 msgid "B<inittab>(5), B<bootparam>(7), B<init>(8), B<runlevel>(8), B<shutdown>(8)"
544 #: build/C/man7/bootparam.7:30
550 #: build/C/man7/bootparam.7:30
556 #: build/C/man7/bootparam.7:33
557 msgid "bootparam - introduction to boot time parameters of the Linux kernel"
561 #: build/C/man7/bootparam.7:40
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:50
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:60
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:65
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:74
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:74
615 msgid "The argument list"
619 #: build/C/man7/bootparam.7:78
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:80
627 msgid "name[=value_1][,value_2]...[,value_10]"
631 #: build/C/man7/bootparam.7:88
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:94
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:105
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:111
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:121
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:121
685 msgid "General non-device specific boot arguments"
689 #: build/C/man7/bootparam.7:122
691 msgid "B<'init=...'>"
695 #: build/C/man7/bootparam.7:134
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:134
706 msgid "B<'nfsaddrs=...'>"
710 #: build/C/man7/bootparam.7:138
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:138
719 msgid "B<'nfsroot=...'>"
723 #: build/C/man7/bootparam.7:145
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:145
737 #: build/C/man7/bootparam.7:158
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:158
754 #: build/C/man7/bootparam.7:171
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:171
767 msgid "B<'root=...'>"
771 #: build/C/man7/bootparam.7:183
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:199
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:203
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:208
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:208
817 msgid "B<'rootfstype=...'>"
821 #: build/C/man7/bootparam.7:216
823 "The 'rootfstype' option tells the kernel to mount the root filesystem as if "
824 "it where of the type specified. This can be useful (for example) to mount "
825 "an ext3 filesystem as ext2 and then remove the journal in the root "
826 "filesystem, in fact reverting its format from ext3 to ext2 without the need "
827 "to boot the box from alternate media."
831 #: build/C/man7/bootparam.7:216
833 msgid "B<'ro'> and B<'rw'>"
837 #: build/C/man7/bootparam.7:226
839 "The 'ro' option tells the kernel to mount the root file system as "
840 "'read-only' so that file system consistency check programs (fsck) can do "
841 "their work on a quiescent file system. No processes can write to files on "
842 "the file system in question until it is 'remounted' as read/write capable, "
843 "for example, by 'mount -w -n -o remount /'. (See also B<mount>(8).)"
847 #: build/C/man7/bootparam.7:229
849 "The 'rw' option tells the kernel to mount the root file system read/write. "
850 "This is the default."
854 #: build/C/man7/bootparam.7:232
856 "The choice between read-only and read/write can also be set using "
861 #: build/C/man7/bootparam.7:232
863 msgid "B<'reserve=...'>"
867 #: build/C/man7/bootparam.7:236
869 "This is used to protect I/O port regions from probes. The form of the "
874 #: build/C/man7/bootparam.7:238
875 msgid "B<reserve=>I<iobase,extent[,iobase,extent]...>"
879 #: build/C/man7/bootparam.7:245
881 "In some machines it may be necessary to prevent device drivers from checking "
882 "for devices (auto-probing) in a specific region. This may be because of "
883 "hardware that reacts badly to the probing, or hardware that would be "
884 "mistakenly identified, or merely hardware you don't want the kernel to "
889 #: build/C/man7/bootparam.7:250
891 "The reserve boot-time argument specifies an I/O port region that shouldn't "
892 "be probed. A device driver will not probe a reserved region, unless another "
893 "boot argument explicitly specifies that it do so."
897 #: build/C/man7/bootparam.7:252
898 msgid "For example, the boot line"
902 #: build/C/man7/bootparam.7:254
903 msgid "reserve=0x300,32 blah=0x300"
907 #: build/C/man7/bootparam.7:257
909 "keeps all device drivers except the driver for 'blah' from probing "
914 #: build/C/man7/bootparam.7:257
920 #: build/C/man7/bootparam.7:270
922 "The BIOS call defined in the PC specification that returns the amount of "
923 "installed memory was only designed to be able to report up to 64MB. Linux "
924 "uses this BIOS call at boot to determine how much memory is installed. If "
925 "you have more than 64MB of RAM installed, you can use this boot arg to tell "
926 "Linux how much memory you have. The value is in decimal or hexadecimal "
927 "(prefix 0x), and the suffixes 'k' (times 1024) or 'M' (times 1048576) can be "
928 "used. Here is a quote from Linus on usage of the 'mem=' parameter."
932 #: build/C/man7/bootparam.7:277
934 "The kernel will accept any 'mem=xx' parameter you give it, and if it turns "
935 "out that you lied to it, it will crash horribly sooner or later. The "
936 "parameter indicates the highest addressable RAM address, so "
937 "\\&'mem=0x1000000' means you have 16MB of memory, for example. For a 96MB "
938 "machine this would be 'mem=0x6000000'."
942 #: build/C/man7/bootparam.7:289
944 "B<NOTE>: some machines might use the top of memory for BIOS caching or "
945 "whatever, so you might not actually have up to the full 96MB addressable. "
946 "The reverse is also true: some chipsets will map the physical memory that is "
947 "covered by the BIOS area into the area just past the top of memory, so the "
948 "top-of-mem might actually be 96MB + 384kB for example. If you tell linux "
949 "that it has more memory than it actually does have, bad things will happen: "
950 "maybe not at once, but surely eventually."
954 #: build/C/man7/bootparam.7:294
956 "You can also use the boot argument 'mem=nopentium' to turn off 4 MB page "
957 "tables on kernels configured for IA32 systems with a pentium or newer CPU."
961 #: build/C/man7/bootparam.7:294
967 #: build/C/man7/bootparam.7:299
969 "By default the kernel will not reboot after a panic, but this option will "
970 "cause a kernel reboot after N seconds (if N is greater than zero). This "
971 "panic timeout can also be set by \"echo N E<gt> /proc/sys/kernel/panic\"."
975 #: build/C/man7/bootparam.7:299
977 msgid "B<'reboot=[warm|cold][,[bios|hard]]'>"
981 #: build/C/man7/bootparam.7:314
983 "(Only when B<CONFIG_BUGi386> is defined.) Since 2.0.22 a reboot is by "
984 "default a cold reboot. One asks for the old default with 'reboot=warm'. (A "
985 "cold reboot may be required to reset certain hardware, but might destroy not "
986 "yet written data in a disk cache. A warm reboot may be faster.) By default "
987 "a reboot is hard, by asking the keyboard controller to pulse the reset line "
988 "low, but there is at least one type of motherboard where that doesn't work. "
989 "The option 'reboot=bios' will instead jump through the BIOS."
993 #: build/C/man7/bootparam.7:314
995 msgid "B<'nosmp'> and B<'maxcpus=N'>"
999 #: build/C/man7/bootparam.7:320
1001 "(Only when __SMP__ is defined.) A command-line option of 'nosmp' or "
1002 "'maxcpus=0' will disable SMP activation entirely; an option 'maxcpus=N' "
1003 "limits the maximum number of CPUs activated in SMP mode to N."
1007 #: build/C/man7/bootparam.7:320
1009 msgid "Boot arguments for use by kernel developers"
1013 #: build/C/man7/bootparam.7:321
1019 #: build/C/man7/bootparam.7:337
1021 "Kernel messages are handed off to the kernel log daemon klogd so that they "
1022 "may be logged to disk. Messages with a priority above I<console_loglevel> "
1023 "are also printed on the console. (For these levels, see "
1024 "I<E<lt>linux/kernel.hE<gt>>.) By default this variable is set to log "
1025 "anything more important than debug messages. This boot argument will cause "
1026 "the kernel to also print the messages of DEBUG priority. The console "
1027 "loglevel can also be set at run time via an option to klogd. See "
1032 #: build/C/man7/bootparam.7:337
1034 msgid "B<'profile=N'>"
1038 #: build/C/man7/bootparam.7:355
1040 "It is possible to enable a kernel profiling function, if one wishes to find "
1041 "out where the kernel is spending its CPU cycles. Profiling is enabled by "
1042 "setting the variable I<prof_shift> to a nonzero value. This is done either "
1043 "by specifying B<CONFIG_PROFILE> at compile time, or by giving the 'profile=' "
1044 "option. Now the value that I<prof_shift> gets will be N, when given, or "
1045 "B<CONFIG_PROFILE_SHIFT>, when that is given, or 2, the default. The "
1046 "significance of this variable is that it gives the granularity of the "
1047 "profiling: each clock tick, if the system was executing kernel code, a "
1048 "counter is incremented:"
1052 #: build/C/man7/bootparam.7:357
1053 msgid "profile[address E<gt>E<gt> prof_shift]++;"
1057 #: build/C/man7/bootparam.7:364
1059 "The raw profiling information can be read from I</proc/profile>. Probably "
1060 "you'll want to use a tool such as readprofile.c to digest it. Writing to "
1061 "I</proc/profile> will clear the counters."
1065 #: build/C/man7/bootparam.7:364
1067 msgid "B<'swap=N1,N2,N3,N4,N5,N6,N7,N8'>"
1071 #: build/C/man7/bootparam.7:370
1073 "Set the eight parameters max_page_age, page_advance, page_decline, "
1074 "page_initial_age, age_cluster_fract, age_cluster_min, pageout_weight, "
1075 "bufferout_weight that control the kernel swap algorithm. For kernel tuners "
1080 #: build/C/man7/bootparam.7:370
1082 msgid "B<'buff=N1,N2,N3,N4,N5,N6'>"
1086 #: build/C/man7/bootparam.7:376
1088 "Set the six parameters max_buff_age, buff_advance, buff_decline, "
1089 "buff_initial_age, bufferout_weight, buffermem_grace that control kernel "
1090 "buffer memory management. For kernel tuners only."
1094 #: build/C/man7/bootparam.7:376
1096 msgid "Boot arguments for ramdisk use"
1100 #: build/C/man7/bootparam.7:387
1102 "(Only if the kernel was compiled with B<CONFIG_BLK_DEV_RAM>.) In general it "
1103 "is a bad idea to use a ramdisk under Linux\\(emthe system will use available "
1104 "memory more efficiently itself. But while booting (or while constructing "
1105 "boot floppies) it is often useful to load the floppy contents into a "
1106 "ramdisk. One might also have a system in which first some modules (for file "
1107 "system or hardware) must be loaded before the main disk can be accessed."
1111 #: build/C/man7/bootparam.7:399
1113 "In Linux 1.3.48, ramdisk handling was changed drastically. Earlier, the "
1114 "memory was allocated statically, and there was a 'ramdisk=N' parameter to "
1115 "tell its size. (This could also be set in the kernel image at compile time, "
1116 "or by use of B<rdev>(8).) These days ram disks use the buffer cache, and "
1117 "grow dynamically. For a lot of information (e.g., how to use B<rdev>(8) in "
1118 "conjunction with the new ramdisk setup), see "
1119 "I</usr/src/linux/Documentation/ramdisk.txt>."
1123 #: build/C/man7/bootparam.7:401
1124 msgid "There are four parameters, two boolean and two integral."
1128 #: build/C/man7/bootparam.7:401
1130 msgid "B<'load_ramdisk=N'>"
1134 #: build/C/man7/bootparam.7:406
1136 "If N=1, do load a ramdisk. If N=0, do not load a ramdisk. (This is the "
1141 #: build/C/man7/bootparam.7:406
1143 msgid "B<'prompt_ramdisk=N'>"
1147 #: build/C/man7/bootparam.7:412
1149 "If N=1, do prompt for insertion of the floppy. (This is the default.) If "
1150 "N=0, do not prompt. (Thus, this parameter is never needed.)"
1154 #: build/C/man7/bootparam.7:412
1156 msgid "B<'ramdisk_size=N'> or (obsolete) B<'ramdisk=N'>"
1160 #: build/C/man7/bootparam.7:416
1161 msgid "Set the maximal size of the ramdisk(s) to N kB. The default is 4096 (4 MB)."
1165 #: build/C/man7/bootparam.7:416
1167 msgid "B<'ramdisk_start=N'>"
1171 #: build/C/man7/bootparam.7:421
1173 "Sets the starting block number (the offset on the floppy where the ramdisk "
1174 "starts) to N. This is needed in case the ramdisk follows a kernel image."
1178 #: build/C/man7/bootparam.7:421
1180 msgid "B<'noinitrd'>"
1184 #: build/C/man7/bootparam.7:434
1186 "(Only if the kernel was compiled with B<CONFIG_BLK_DEV_RAM> and "
1187 "B<CONFIG_BLK_DEV_INITRD>.) These days it is possible to compile the kernel "
1188 "to use initrd. When this feature is enabled, the boot process will load the "
1189 "kernel and an initial ramdisk; then the kernel converts initrd into a "
1190 "\"normal\" ramdisk, which is mounted read-write as root device; then "
1191 "/linuxrc is executed; afterward the \"real\" root file system is mounted, "
1192 "and the initrd file system is moved over to /initrd; finally the usual boot "
1193 "sequence (e.g., invocation of /sbin/init) is performed."
1197 #: build/C/man7/bootparam.7:437
1199 "For a detailed description of the initrd feature, see "
1200 "I</usr/src/linux/Documentation/initrd.txt>."
1204 #: build/C/man7/bootparam.7:445
1206 "The 'noinitrd' option tells the kernel that although it was compiled for "
1207 "operation with initrd, it should not go through the above steps, but leave "
1208 "the initrd data under I</dev/initrd>. (This device can be used only once: "
1209 "the data is freed as soon as the last process that used it has closed "
1214 #: build/C/man7/bootparam.7:445
1216 msgid "Boot arguments for SCSI devices"
1220 #: build/C/man7/bootparam.7:447
1221 msgid "General notation for this section:"
1225 #: build/C/man7/bootparam.7:452
1227 "I<iobase> -- the first I/O port that the SCSI host occupies. These are "
1228 "specified in hexadecimal notation, and usually lie in the range from 0x200 "
1233 #: build/C/man7/bootparam.7:460
1235 "I<irq> -- the hardware interrupt that the card is configured to use. Valid "
1236 "values will be dependent on the card in question, but will usually be 5, 7, "
1237 "9, 10, 11, 12, and 15. The other values are usually used for common "
1238 "peripherals like IDE hard disks, floppies, serial ports, and so on."
1242 #: build/C/man7/bootparam.7:468
1244 "I<scsi-id> -- the ID that the host adapter uses to identify itself on the "
1245 "SCSI bus. Only some host adapters allow you to change this value, as most "
1246 "have it permanently specified internally. The usual default value is 7, but "
1247 "the Seagate and Future Domain TMC-950 boards use 6."
1251 #: build/C/man7/bootparam.7:476
1253 "I<parity> -- whether the SCSI host adapter expects the attached devices to "
1254 "supply a parity value with all information exchanges. Specifying a one "
1255 "indicates parity checking is enabled, and a zero disables parity checking. "
1256 "Again, not all adapters will support selection of parity behavior as a boot "
1261 #: build/C/man7/bootparam.7:476
1263 msgid "B<'max_scsi_luns=...'>"
1267 #: build/C/man7/bootparam.7:487
1269 "A SCSI device can have a number of 'subdevices' contained within itself. "
1270 "The most common example is one of the new SCSI CD-ROMs that handle more than "
1271 "one disk at a time. Each CD is addressed as a \\&'Logical Unit Number' "
1272 "(LUN) of that particular device. But most devices, such as hard disks, tape "
1273 "drives and such are only one device, and will be assigned to LUN zero."
1277 #: build/C/man7/bootparam.7:493
1279 "Some poorly designed SCSI devices cannot handle being probed for LUNs not "
1280 "equal to zero. Therefore, if the compile-time flag B<CONFIG_SCSI_MULTI_LUN> "
1281 "is not set, newer kernels will by default only probe LUN zero."
1285 #: build/C/man7/bootparam.7:499
1287 "To specify the number of probed LUNs at boot, one enters "
1288 "\\&'max_scsi_luns=n' as a boot arg, where n is a number between one and "
1289 "eight. To avoid problems as described above, one would use n=1 to avoid "
1290 "upsetting such broken devices."
1294 #: build/C/man7/bootparam.7:499
1296 msgid "B<SCSI tape configuration>"
1300 #: build/C/man7/bootparam.7:503
1302 "Some boot time configuration of the SCSI tape driver can be achieved by "
1303 "using the following:"
1307 #: build/C/man7/bootparam.7:505
1308 msgid "B<st=>I<buf_size[,write_threshold[,max_bufs]]>"
1312 #: build/C/man7/bootparam.7:518
1314 "The first two numbers are specified in units of kB. The default I<buf_size> "
1315 "is 32kB, and the maximum size that can be specified is a ridiculous "
1316 "16384kB. The I<write_threshold> is the value at which the buffer is "
1317 "committed to tape, with a default value of 30kB. The maximum number of "
1318 "buffers varies with the number of drives detected, and has a default of "
1319 "two. An example usage would be:"
1323 #: build/C/man7/bootparam.7:520
1328 #: build/C/man7/bootparam.7:526
1330 "Full details can be found in the file I<Documentation/scsi/st.txt> (or "
1331 "I<drivers/scsi/README.st> for older kernels) in the Linux kernel source."
1335 #: build/C/man7/bootparam.7:526
1337 msgid "B<Adaptec aha151x, aha152x, aic6260, aic6360, SB16-SCSI configuration>"
1341 #: build/C/man7/bootparam.7:530
1343 "The aha numbers refer to cards and the aic numbers refer to the actual SCSI "
1344 "chip on these type of cards, including the Soundblaster-16 SCSI."
1348 #: build/C/man7/bootparam.7:535
1350 "The probe code for these SCSI hosts looks for an installed BIOS, and if none "
1351 "is present, the probe will not find your card. Then you will have to use a "
1352 "boot arg of the form:"
1356 #: build/C/man7/bootparam.7:537
1357 msgid "B<aha152x=>I<iobase[,irq[,scsi-id[,reconnect[,parity]]]]>"
1361 #: build/C/man7/bootparam.7:540
1363 "If the driver was compiled with debugging enabled, a sixth value can be "
1364 "specified to set the debug level."
1368 #: build/C/man7/bootparam.7:546
1370 "All the parameters are as described at the top of this section, and the "
1371 "I<reconnect> value will allow device disconnect/reconnect if a nonzero value "
1372 "is used. An example usage is as follows:"
1376 #: build/C/man7/bootparam.7:548
1377 msgid "aha152x=0x340,11,7,1"
1381 #: build/C/man7/bootparam.7:552
1383 "Note that the parameters must be specified in order, meaning that if you "
1384 "want to specify a parity setting, then you will have to specify an iobase, "
1385 "irq, scsi-id and reconnect value as well."
1389 #: build/C/man7/bootparam.7:552
1391 msgid "B<Adaptec aha154x configuration>"
1395 #: build/C/man7/bootparam.7:560
1397 "The aha1542 series cards have an i82077 floppy controller onboard, while the "
1398 "aha1540 series cards do not. These are busmastering cards, and have "
1399 "parameters to set the \"fairness\" that is used to share the bus with other "
1400 "devices. The boot arg looks like the following."
1404 #: build/C/man7/bootparam.7:562
1405 msgid "B<aha1542=>I<iobase[,buson,busoff[,dmaspeed]]>"
1409 #: build/C/man7/bootparam.7:566
1411 "Valid iobase values are usually one of: 0x130, 0x134, 0x230, 0x234, 0x330, "
1412 "0x334. Clone cards may permit other values."
1416 #: build/C/man7/bootparam.7:574
1418 "The I<buson>, I<busoff> values refer to the number of microseconds that the "
1419 "card dominates the ISA bus. The defaults are 11us on, and 4us off, so that "
1420 "other cards (such as an ISA LANCE Ethernet card) have a chance to get access "
1425 #: build/C/man7/bootparam.7:585
1427 "The I<dmaspeed> value refers to the rate (in MB/s) at which the DMA (Direct "
1428 "Memory Access) transfers proceed. The default is 5MB/s. Newer revision "
1429 "cards allow you to select this value as part of the soft-configuration, "
1430 "older cards use jumpers. You can use values up to 10MB/s assuming that your "
1431 "motherboard is capable of handling it. Experiment with caution if using "
1432 "values over 5MB/s."
1436 #: build/C/man7/bootparam.7:585
1438 msgid "B<Adaptec aha274x, aha284x, aic7xxx configuration>"
1442 #: build/C/man7/bootparam.7:588
1443 msgid "These boards can accept an argument of the form:"
1447 #: build/C/man7/bootparam.7:590
1448 msgid "B<aic7xxx=>I<extended,no_reset>"
1452 #: build/C/man7/bootparam.7:599
1454 "The I<extended> value, if nonzero, indicates that extended translation for "
1455 "large disks is enabled. The I<no_reset> value, if nonzero, tells the driver "
1456 "not to reset the SCSI bus when setting up the host adapter at boot."
1460 #: build/C/man7/bootparam.7:599
1462 msgid "B<AdvanSys SCSI Hosts configuration ('advansys=')>"
1466 #: build/C/man7/bootparam.7:612
1468 "The AdvanSys driver can accept up to four i/o addresses that will be probed "
1469 "for an AdvanSys SCSI card. Note that these values (if used) do not effect "
1470 "EISA or PCI probing in any way. They are only used for probing ISA and VLB "
1471 "cards. In addition, if the driver has been compiled with debugging enabled, "
1472 "the level of debugging output can be set by adding an 0xdeb[0-f] parameter. "
1473 "The 0-f allows setting the level of the debugging messages to any of 16 "
1474 "levels of verbosity."
1478 #: build/C/man7/bootparam.7:612
1484 #: build/C/man7/bootparam.7:616
1485 msgid "B<AM53C974=>I<host-scsi-id,target-scsi-id,max-rate,max-offset>"
1489 #: build/C/man7/bootparam.7:616
1491 msgid "B<BusLogic SCSI Hosts configuration ('BusLogic=')>"
1495 #: build/C/man7/bootparam.7:620
1496 msgid "B<BusLogic=>I<N1,N2,N3,N4,N5,S1,S2,...>"
1500 #: build/C/man7/bootparam.7:627
1502 "For an extensive discussion of the BusLogic command line parameters, see "
1503 "I</usr/src/linux/drivers/scsi/BusLogic.c> (lines 3149-3270 in the kernel "
1504 "version I am looking at). The text below is a very much abbreviated "
1509 #: build/C/man7/bootparam.7:639
1511 "The parameters N1-N5 are integers. The parameters S1,... are strings. N1 "
1512 "is the I/O Address at which the Host Adapter is located. N2 is the Tagged "
1513 "Queue Depth to use for Target Devices that support Tagged Queuing. N3 is "
1514 "the Bus Settle Time in seconds. This is the amount of time to wait between "
1515 "a Host Adapter Hard Reset which initiates a SCSI Bus Reset and issuing any "
1516 "SCSI Commands. N4 is the Local Options (for one Host Adapter). N5 is the "
1517 "Global Options (for all Host Adapters)."
1521 #: build/C/man7/bootparam.7:645
1523 "The string options are used to provide control over Tagged Queuing "
1524 "(TQ:Default, TQ:Enable, TQ:Disable, TQ:E<lt>Per-Target-SpecE<gt>), over "
1525 "Error Recovery (ER:Default, ER:HardReset, ER:BusDeviceReset, ER:None, "
1526 "ER:E<lt>Per-Target-SpecE<gt>), and over Host Adapter Probing (NoProbe, "
1527 "NoProbeISA, NoSortPCI)."
1531 #: build/C/man7/bootparam.7:645
1533 msgid "B<EATA/DMA configuration>"
1537 #: build/C/man7/bootparam.7:648 build/C/man7/bootparam.7:755
1538 msgid "The default list of i/o ports to be probed can be changed by"
1542 #: build/C/man7/bootparam.7:650 build/C/man7/bootparam.7:757
1543 msgid "B<eata=>I<iobase,iobase,...>B<.>"
1547 #: build/C/man7/bootparam.7:650
1549 msgid "B<Future Domain TMC-16x0 configuration>"
1553 #: build/C/man7/bootparam.7:654
1554 msgid "B<fdomain=>I<iobase,irq[,adapter_id]>"
1558 #: build/C/man7/bootparam.7:654
1560 msgid "B<Great Valley Products (GVP) SCSI controller configuration>"
1564 #: build/C/man7/bootparam.7:658
1565 msgid "B<gvp11=>I<dma_transfer_bitmask>"
1569 #: build/C/man7/bootparam.7:658
1571 msgid "B<Future Domain TMC-8xx, TMC-950 configuration>"
1575 #: build/C/man7/bootparam.7:662
1576 msgid "B<tmc8xx=>I<mem_base,irq>"
1580 #: build/C/man7/bootparam.7:669 build/C/man7/bootparam.7:742
1582 "The I<mem_base> value is the value of the memory mapped I/O region that the "
1583 "card uses. This will usually be one of the following values: 0xc8000, "
1584 "0xca000, 0xcc000, 0xce000, 0xdc000, 0xde000."
1588 #: build/C/man7/bootparam.7:669
1590 msgid "B<IN2000 configuration>"
1594 #: build/C/man7/bootparam.7:673
1595 msgid "B<in2000=>I<S>"
1599 #: build/C/man7/bootparam.7:680
1601 "where S is a comma-separated string of items keyword[:value]. Recognized "
1602 "keywords (possibly with value) are: ioport:addr, noreset, nosync:x, "
1603 "period:ns, disconnect:x, debug:x, proc:x. For the function of these "
1604 "parameters, see I</usr/src/linux/drivers/scsi/in2000.c>."
1608 #: build/C/man7/bootparam.7:680
1610 msgid "B<NCR5380 and NCR53C400 configuration>"
1614 #: build/C/man7/bootparam.7:683
1615 msgid "The boot arg is of the form"
1619 #: build/C/man7/bootparam.7:685
1620 msgid "B<ncr5380=>I<iobase,irq,dma>"
1624 #: build/C/man7/bootparam.7:687
1629 #: build/C/man7/bootparam.7:689
1630 msgid "B<ncr53c400=>I<iobase,irq>"
1634 #: build/C/man7/bootparam.7:698
1636 "If the card doesn't use interrupts, then an IRQ value of 255 (0xff) will "
1637 "disable interrupts. An IRQ value of 254 means to autoprobe. More details "
1638 "can be found in the file I<Documentation/scsi/g_NCR5380.txt> (or "
1639 "I<drivers/scsi/README.g_NCR5380> for older kernels) in the Linux kernel "
1644 #: build/C/man7/bootparam.7:698
1646 msgid "B<NCR53C8xx configuration>"
1650 #: build/C/man7/bootparam.7:702
1651 msgid "B<ncr53c8xx=>I<S>"
1655 #: build/C/man7/bootparam.7:710
1657 "where S is a comma-separated string of items keyword:value. Recognized "
1658 "keywords are: mpar (master_parity), spar (scsi_parity), disc "
1659 "(disconnection), specf (special_features), ultra (ultra_scsi), fsn "
1660 "(force_sync_nego), tags (default_tags), sync (default_sync), verb (verbose), "
1661 "debug (debug), burst (burst_max). For the function of the assigned values, "
1662 "see I</usr/src/linux/drivers/scsi/ncr53c8xx.c>."
1666 #: build/C/man7/bootparam.7:710
1668 msgid "B<NCR53c406a configuration>"
1672 #: build/C/man7/bootparam.7:714
1673 msgid "B<ncr53c406a=>I<iobase[,irq[,fastpio]]>"
1677 #: build/C/man7/bootparam.7:717
1679 "Specify irq = 0 for noninterrupt driven mode. Set fastpio = 1 for fast pio "
1680 "mode, 0 for slow mode."
1684 #: build/C/man7/bootparam.7:717
1686 msgid "B<Pro Audio Spectrum configuration>"
1690 #: build/C/man7/bootparam.7:722
1692 "The PAS16 uses a NC5380 SCSI chip, and newer models support jumperless "
1693 "configuration. The boot arg is of the form:"
1697 #: build/C/man7/bootparam.7:724
1698 msgid "B<pas16=>I<iobase,irq>"
1702 #: build/C/man7/bootparam.7:729
1704 "The only difference is that you can specify an IRQ value of 255, which will "
1705 "tell the driver to work without using interrupts, albeit at a performance "
1706 "loss. The iobase is usually 0x388."
1710 #: build/C/man7/bootparam.7:729
1712 msgid "B<Seagate ST-0x configuration>"
1716 #: build/C/man7/bootparam.7:733
1718 "If your card is not detected at boot time, you will then have to use a boot "
1723 #: build/C/man7/bootparam.7:735
1724 msgid "B<st0x=>I<mem_base,irq>"
1728 #: build/C/man7/bootparam.7:742
1730 msgid "B<Trantor T128 configuration>"
1734 #: build/C/man7/bootparam.7:746
1736 "These cards are also based on the NCR5380 chip, and accept the following "
1741 #: build/C/man7/bootparam.7:748
1742 msgid "B<t128=>I<mem_base,irq>"
1746 #: build/C/man7/bootparam.7:752
1748 "The valid values for I<mem_base> are as follows: 0xcc000, 0xc8000, 0xdc000, "
1753 #: build/C/man7/bootparam.7:752
1755 msgid "B<UltraStor 14F/34F configuration>"
1759 #: build/C/man7/bootparam.7:757
1761 msgid "B<WD7000 configuration>"
1765 #: build/C/man7/bootparam.7:761
1766 msgid "B<wd7000=>I<irq,dma,iobase>"
1770 #: build/C/man7/bootparam.7:761
1772 msgid "B<Commodore Amiga A2091/590 SCSI controller configuration>"
1776 #: build/C/man7/bootparam.7:765
1777 msgid "B<wd33c93=>I<S>"
1781 #: build/C/man7/bootparam.7:772
1783 "where S is a comma-separated string of options. Recognized options are "
1784 "nosync:bitmask, nodma:x, period:ns, disconnect:x, debug:x, clock:x, next. "
1785 "For details, see I</usr/src/linux/drivers/scsi/wd33c93.c>."
1789 #: build/C/man7/bootparam.7:772
1795 #: build/C/man7/bootparam.7:773
1797 msgid "B<IDE Disk/CD-ROM Driver Parameters>"
1801 #: build/C/man7/bootparam.7:778
1803 "The IDE driver accepts a number of parameters, which range from disk "
1804 "geometry specifications, to support for broken controller chips. "
1805 "Drive-specific options are specified by using 'hdX=' with X in 'a'-'h'."
1809 #: build/C/man7/bootparam.7:782
1811 "Non-drive-specific options are specified with the prefix 'hd='. Note that "
1812 "using a drive-specific prefix for a non-drive-specific option will still "
1813 "work, and the option will just be applied as expected."
1817 #: build/C/man7/bootparam.7:792
1819 "Also note that 'hd=' can be used to refer to the next unspecified drive in "
1820 "the (a, ..., h) sequence. For the following discussions, the 'hd=' option "
1821 "will be cited for brevity. See the file I<Documentation/ide.txt> (or "
1822 "I<drivers/block/README.ide> for older kernels) in the Linux kernel source "
1827 #: build/C/man7/bootparam.7:792
1829 msgid "B<The 'hd=cyls,heads,sects[,wpcom[,irq]]' options>"
1833 #: build/C/man7/bootparam.7:803
1835 "These options are used to specify the physical geometry of the disk. Only "
1836 "the first three values are required. The cylinder/head/sectors values will "
1837 "be those used by fdisk. The write precompensation value is ignored for IDE "
1838 "disks. The IRQ value specified will be the IRQ used for the interface that "
1839 "the drive resides on, and is not really a drive-specific parameter."
1843 #: build/C/man7/bootparam.7:803
1845 msgid "B<The 'hd=serialize' option>"
1849 #: build/C/man7/bootparam.7:811
1851 "The dual IDE interface CMD-640 chip is broken as designed such that when "
1852 "drives on the secondary interface are used at the same time as drives on the "
1853 "primary interface, it will corrupt your data. Using this option tells the "
1854 "driver to make sure that both interfaces are never used at the same time."
1858 #: build/C/man7/bootparam.7:811
1860 msgid "B<The 'hd=dtc2278' option>"
1864 #: build/C/man7/bootparam.7:816
1866 "This option tells the driver that you have a DTC-2278D IDE interface. The "
1867 "driver then tries to do DTC-specific operations to enable the second "
1868 "interface and to enable faster transfer modes."
1872 #: build/C/man7/bootparam.7:816
1874 msgid "B<The 'hd=noprobe' option>"
1878 #: build/C/man7/bootparam.7:820
1879 msgid "Do not probe for this drive. For example,"
1883 #: build/C/man7/bootparam.7:822
1884 msgid "hdb=noprobe hdb=1166,7,17"
1888 #: build/C/man7/bootparam.7:826
1890 "would disable the probe, but still specify the drive geometry so that it "
1891 "would be registered as a valid block device, and hence usable."
1895 #: build/C/man7/bootparam.7:826
1897 msgid "B<The 'hd=nowerr' option>"
1901 #: build/C/man7/bootparam.7:832
1903 "Some drives apparently have the B<WRERR_STAT> bit stuck on permanently. "
1904 "This enables a work-around for these broken devices."
1908 #: build/C/man7/bootparam.7:832
1910 msgid "B<The 'hd=cdrom' option>"
1914 #: build/C/man7/bootparam.7:838
1916 "This tells the IDE driver that there is an ATAPI compatible CD-ROM attached "
1917 "in place of a normal IDE hard disk. In most cases the CD-ROM is identified "
1918 "automatically, but if it isn't then this may help."
1922 #: build/C/man7/bootparam.7:838
1924 msgid "B<Standard ST-506 Disk Driver Options ('hd=')>"
1928 #: build/C/man7/bootparam.7:847
1930 "The standard disk driver can accept geometry arguments for the disks similar "
1931 "to the IDE driver. Note however that it only expects three values (C/H/S); "
1932 "any more or any less and it will silently ignore you. Also, it only accepts "
1933 "'hd=' as an argument, that is, 'hda=' and so on are not valid here. The "
1934 "format is as follows:"
1938 #: build/C/man7/bootparam.7:849
1939 msgid "hd=cyls,heads,sects"
1943 #: build/C/man7/bootparam.7:852
1945 "If there are two disks installed, the above is repeated with the geometry "
1946 "parameters of the second disk."
1950 #: build/C/man7/bootparam.7:852
1952 msgid "B<XT Disk Driver Options ('xd=')>"
1956 #: build/C/man7/bootparam.7:857
1958 "If you are unfortunate enough to be using one of these old 8 bit cards that "
1959 "move data at a whopping 125kB/s then here is the scoop. If the card is not "
1960 "recognized, you will have to use a boot arg of the form:"
1964 #: build/C/man7/bootparam.7:859
1965 msgid "xd=type,irq,iobase,dma_chan"
1968 #. 1.1.50, 1.3.81, 1.3.99, 2.0.34, 2.1.67, 2.1.78, 2.1.127
1970 #: build/C/man7/bootparam.7:875
1972 "The type value specifies the particular manufacturer of the card, overriding "
1973 "autodetection. For the types to use, consult the I<drivers/block/xd.c> "
1974 "source file of the kernel you are using. The type is an index in the list "
1975 "I<xd_sigs> and in the course of time types have been added to or deleted "
1976 "from the middle of the list, changing all type numbers. Today (Linux 2.5.0) "
1977 "the types are 0=generic; 1=DTC 5150cx; 2,3=DTC 5150x; 4,5=Western Digital; "
1978 "6,7,8=Seagate; 9=Omti; 10=XEBEC, and where here several types are given with "
1979 "the same designation, they are equivalent."
1983 #: build/C/man7/bootparam.7:882
1985 "The xd_setup() function does no checking on the values, and assumes that you "
1986 "entered all four values. Don't disappoint it. Here is an example usage for "
1987 "a WD1002 controller with the BIOS disabled/removed, using the 'default' XT "
1988 "controller parameters:"
1992 #: build/C/man7/bootparam.7:884
1993 msgid "xd=2,5,0x320,3"
1997 #: build/C/man7/bootparam.7:884
1999 msgid "B<Syquest's EZ* removable disks>"
2003 #: build/C/man7/bootparam.7:888
2004 msgid "B<ez=>I<iobase[,irq[,rep[,nybble]]]>"
2008 #: build/C/man7/bootparam.7:888
2010 msgid "IBM MCA bus devices"
2014 #: build/C/man7/bootparam.7:891
2015 msgid "See also I</usr/src/linux/Documentation/mca.txt>."
2019 #: build/C/man7/bootparam.7:891
2021 msgid "B<PS/2 ESDI hard disks>"
2025 #: build/C/man7/bootparam.7:894
2026 msgid "It is possible to specify the desired geometry at boot time:"
2030 #: build/C/man7/bootparam.7:896
2031 msgid "B<ed=>I<cyls,heads,sectors.>"
2035 #: build/C/man7/bootparam.7:898
2036 msgid "For a ThinkPad-720, add the option"
2040 #: build/C/man7/bootparam.7:900
2045 #: build/C/man7/bootparam.7:900
2047 msgid "B<IBM Microchannel SCSI Subsystem configuration>"
2051 #: build/C/man7/bootparam.7:904
2052 msgid "B<ibmmcascsi=>I<N>"
2056 #: build/C/man7/bootparam.7:906
2057 msgid "where N is the I<pun> (SCSI ID) of the subsystem."
2061 #: build/C/man7/bootparam.7:906
2063 msgid "B<The Aztech Interface>"
2067 #: build/C/man7/bootparam.7:909 build/C/man7/bootparam.7:994 build/C/man7/bootparam.7:999 build/C/man7/bootparam.7:1010 build/C/man7/bootparam.7:1015
2068 msgid "The syntax for this type of card is:"
2072 #: build/C/man7/bootparam.7:911
2073 msgid "aztcd=iobase[,magic_number]"
2077 #: build/C/man7/bootparam.7:916
2079 "If you set the magic_number to 0x79 then the driver will try and run anyway "
2080 "in the event of an unknown firmware version. All other values are ignored."
2084 #: build/C/man7/bootparam.7:916
2086 msgid "B<Parallel port CD-ROM drives>"
2090 #: build/C/man7/bootparam.7:919 build/C/man7/bootparam.7:964 build/C/man7/bootparam.7:1161 build/C/man7/bootparam.7:1169 build/C/man7/bootparam.7:1179 build/C/man7/bootparam.7:1189 build/C/man7/bootparam.7:1222 build/C/man7/bootparam.7:1239 build/C/man7/bootparam.7:1251 build/C/man7/bootparam.7:1275
2095 #: build/C/man7/bootparam.7:921
2096 msgid "pcd.driveN=prt,pro,uni,mod,slv,dly"
2100 #: build/C/man7/bootparam.7:923
2101 msgid "pcd.nice=nice"
2105 #: build/C/man7/bootparam.7:930
2107 "where 'port' is the base address, 'pro' is the protocol number, 'uni' is the "
2108 "unit selector (for chained devices), 'mod' is the mode (or -1 to choose the "
2109 "best automatically), 'slv' is 1 if it should be a slave, and 'dly' is a "
2110 "small integer for slowing down port accesses. The 'nice' parameter controls "
2111 "the driver's use of idle CPU time, at the expense of some speed."
2115 #: build/C/man7/bootparam.7:930
2117 msgid "B<The CDU-31A and CDU-33A Sony Interface>"
2121 #: build/C/man7/bootparam.7:935
2123 "This CD-ROM interface is found on some of the Pro Audio Spectrum sound "
2124 "cards, and other Sony supplied interface cards. The syntax is as follows:"
2128 #: build/C/man7/bootparam.7:937
2129 msgid "cdu31a=iobase,[irq[,is_pas_card]]"
2133 #: build/C/man7/bootparam.7:943
2135 "Specifying an IRQ value of zero tells the driver that hardware interrupts "
2136 "aren't supported (as on some PAS cards). If your card supports interrupts, "
2137 "you should use them as it cuts down on the CPU usage of the driver."
2141 #: build/C/man7/bootparam.7:948
2143 "The I<is_pas_card> should be entered as 'PAS' if using a Pro Audio Spectrum "
2144 "card, and otherwise it should not be specified at all."
2148 #: build/C/man7/bootparam.7:948
2150 msgid "B<The CDU-535 Sony Interface>"
2154 #: build/C/man7/bootparam.7:951 build/C/man7/bootparam.7:959 build/C/man7/bootparam.7:975
2155 msgid "The syntax for this CD-ROM interface is:"
2159 #: build/C/man7/bootparam.7:953
2160 msgid "sonycd535=iobase[,irq]"
2164 #: build/C/man7/bootparam.7:956
2166 "A zero can be used for the I/O base as a 'placeholder' if one wishes to "
2167 "specify an IRQ value."
2171 #: build/C/man7/bootparam.7:956
2173 msgid "B<The GoldStar Interface>"
2177 #: build/C/man7/bootparam.7:961
2182 #: build/C/man7/bootparam.7:961
2184 msgid "B<The ISP16 CD-ROM Interface>"
2188 #: build/C/man7/bootparam.7:966
2189 msgid "isp16=[iobase[,irq[,dma[,type]]]]"
2193 #: build/C/man7/bootparam.7:972
2195 "(three integers and a string). If the type is given as 'noisp16', the "
2196 "interface will not be configured. Other recognized types are: 'Sanyo\", "
2197 "'Sony', 'Panasonic' and 'Mitsumi'."
2201 #: build/C/man7/bootparam.7:972
2203 msgid "B<The Mitsumi Standard Interface>"
2207 #: build/C/man7/bootparam.7:977
2208 msgid "mcd=iobase,[irq[,wait_value]]"
2212 #: build/C/man7/bootparam.7:985
2214 "The I<wait_value> is used as an internal timeout value for people who are "
2215 "having problems with their drive, and may or may not be implemented "
2216 "depending on a compile-time #define. The Mitsumi FX400 is an IDE/ATAPI "
2217 "CD-ROM player and does not use the mcd driver."
2221 #: build/C/man7/bootparam.7:985
2223 msgid "B<The Mitsumi XA/MultiSession Interface>"
2227 #: build/C/man7/bootparam.7:989
2229 "This is for the same hardware as above, but the driver has extended "
2234 #: build/C/man7/bootparam.7:991
2235 msgid "mcdx=iobase[,irq]"
2239 #: build/C/man7/bootparam.7:991
2241 msgid "B<The Optics Storage Interface>"
2245 #: build/C/man7/bootparam.7:996
2246 msgid "optcd=iobase"
2250 #: build/C/man7/bootparam.7:996
2252 msgid "B<The Phillips CM206 Interface>"
2256 #: build/C/man7/bootparam.7:1001
2257 msgid "cm206=[iobase][,irq]"
2261 #: build/C/man7/bootparam.7:1007
2263 "The driver assumes numbers between 3 and 11 are IRQ values, and numbers "
2264 "between 0x300 and 0x370 are I/O ports, so you can specify one, or both "
2265 "numbers, in any order. It also accepts 'cm206=auto' to enable autoprobing."
2269 #: build/C/man7/bootparam.7:1007
2271 msgid "B<The Sanyo Interface>"
2275 #: build/C/man7/bootparam.7:1012
2276 msgid "sjcd=iobase[,irq[,dma_channel]]"
2280 #: build/C/man7/bootparam.7:1012
2282 msgid "B<The SoundBlaster Pro Interface>"
2286 #: build/C/man7/bootparam.7:1017
2287 msgid "sbpcd=iobase,type"
2291 #: build/C/man7/bootparam.7:1022
2293 "where type is one of the following (case sensitive) strings: "
2294 "\\&'SoundBlaster', 'LaserMate', or 'SPEA'. The I/O base is that of the "
2295 "CD-ROM interface, and not that of the sound portion of the card."
2299 #: build/C/man7/bootparam.7:1022
2301 msgid "Ethernet devices"
2305 #: build/C/man7/bootparam.7:1026
2307 "Different drivers make use of different parameters, but they all at least "
2308 "share having an IRQ, an I/O port base value, and a name. In its most "
2309 "generic form, it looks something like this:"
2313 #: build/C/man7/bootparam.7:1028
2314 msgid "ether=irq,iobase[,param_1[,...param_8]],name"
2318 #: build/C/man7/bootparam.7:1035
2320 "The first nonnumeric argument is taken as the name. The param_n values (if "
2321 "applicable) usually have different meanings for each different card/driver. "
2322 "Typical param_n values are used to specify things like shared memory "
2323 "address, interface selection, DMA channel and the like."
2327 #: build/C/man7/bootparam.7:1039
2329 "The most common use of this parameter is to force probing for a second "
2330 "ethercard, as the default is to only probe for one. This can be "
2331 "accomplished with a simple:"
2335 #: build/C/man7/bootparam.7:1041
2336 msgid "ether=0,0,eth1"
2340 #: build/C/man7/bootparam.7:1044
2342 "Note that the values of zero for the IRQ and I/O base in the above example "
2343 "tell the driver(s) to autoprobe."
2347 #: build/C/man7/bootparam.7:1050
2349 "The Ethernet-HowTo has extensive documentation on using multiple cards and "
2350 "on the card/driver-specific implementation of the param_n values where "
2351 "used. Interested readers should refer to the section in that document on "
2352 "their particular card."
2356 #: build/C/man7/bootparam.7:1050
2358 msgid "The floppy disk driver"
2362 #: build/C/man7/bootparam.7:1058
2364 "There are many floppy driver options, and they are all listed in "
2365 "I<Documentation/floppy.txt> (or I<drivers/block/README.fd> for older "
2366 "kernels) in the Linux kernel source. This information is taken directly "
2371 #: build/C/man7/bootparam.7:1058
2373 msgid "B<floppy=mask,allowed_drive_mask>"
2377 #: build/C/man7/bootparam.7:1068
2379 "Sets the bit mask of allowed drives to mask. By default, only units 0 and 1 "
2380 "of each floppy controller are allowed. This is done because certain "
2381 "nonstandard hardware (ASUS PCI motherboards) mess up the keyboard when "
2382 "accessing units 2 or 3. This option is somewhat obsoleted by the cmos "
2387 #: build/C/man7/bootparam.7:1068
2389 msgid "B<floppy=all_drives>"
2393 #: build/C/man7/bootparam.7:1073
2395 "Sets the bit mask of allowed drives to all drives. Use this if you have "
2396 "more than two drives connected to a floppy controller."
2400 #: build/C/man7/bootparam.7:1073
2402 msgid "B<floppy=asus_pci>"
2406 #: build/C/man7/bootparam.7:1077
2407 msgid "Sets the bit mask to allow only units 0 and 1. (The default)"
2411 #: build/C/man7/bootparam.7:1077
2413 msgid "B<floppy=daring>"
2417 #: build/C/man7/bootparam.7:1084
2419 "Tells the floppy driver that you have a well behaved floppy controller. "
2420 "This allows more efficient and smoother operation, but may fail on certain "
2421 "controllers. This may speed up certain operations."
2425 #: build/C/man7/bootparam.7:1084
2427 msgid "B<floppy=0,daring>"
2431 #: build/C/man7/bootparam.7:1088
2433 "Tells the floppy driver that your floppy controller should be used with "
2438 #: build/C/man7/bootparam.7:1088
2440 msgid "B<floppy=one_fdc>"
2444 #: build/C/man7/bootparam.7:1091
2445 msgid "Tells the floppy driver that you have only floppy controller (default)"
2449 #: build/C/man7/bootparam.7:1091
2451 msgid "B<floppy=two_fdc> or B<floppy=address,two_fdc>"
2455 #: build/C/man7/bootparam.7:1097
2457 "Tells the floppy driver that you have two floppy controllers. The second "
2458 "floppy controller is assumed to be at address. If address is not given, "
2463 #: build/C/man7/bootparam.7:1097
2465 msgid "B<floppy=thinkpad>"
2469 #: build/C/man7/bootparam.7:1102
2471 "Tells the floppy driver that you have a Thinkpad. Thinkpads use an inverted "
2472 "convention for the disk change line."
2476 #: build/C/man7/bootparam.7:1102
2478 msgid "B<floppy=0,thinkpad>"
2482 #: build/C/man7/bootparam.7:1105
2483 msgid "Tells the floppy driver that you don't have a Thinkpad."
2487 #: build/C/man7/bootparam.7:1105
2489 msgid "B<floppy=drive,type,cmos>"
2493 #: build/C/man7/bootparam.7:1116
2495 "Sets the cmos type of drive to type. Additionally, this drive is allowed in "
2496 "the bit mask. This is useful if you have more than two floppy drives (only "
2497 "two can be described in the physical cmos), or if your BIOS uses nonstandard "
2498 "CMOS types. Setting the CMOS to 0 for the first two drives (default) makes "
2499 "the floppy driver read the physical cmos for those drives."
2503 #: build/C/man7/bootparam.7:1116
2505 msgid "B<floppy=unexpected_interrupts>"
2509 #: build/C/man7/bootparam.7:1120
2511 "Print a warning message when an unexpected interrupt is received (default "
2516 #: build/C/man7/bootparam.7:1120
2518 msgid "B<floppy=no_unexpected_interrupts> or B<floppy=L40SX>"
2522 #: build/C/man7/bootparam.7:1128
2524 "Don't print a message when an unexpected interrupt is received. This is "
2525 "needed on IBM L40SX laptops in certain video modes. (There seems to be an "
2526 "interaction between video and floppy. The unexpected interrupts only affect "
2527 "performance, and can safely be ignored.)"
2531 #: build/C/man7/bootparam.7:1128
2533 msgid "The sound driver"
2537 #: build/C/man7/bootparam.7:1138
2539 "The sound driver can also accept boot args to override the compiled in "
2540 "values. This is not recommended, as it is rather complex. It is described "
2541 "in the Linux kernel source file I<Documentation/sound/oss/README.OSS> "
2542 "(I<drivers/sound/Readme.linux> in older kernel versions). It accepts a boot "
2547 #: build/C/man7/bootparam.7:1140
2548 msgid "sound=device1[,device2[,device3...[,device10]]]"
2552 #: build/C/man7/bootparam.7:1143
2554 "where each deviceN value is of the following format 0xTaaaId and the bytes "
2555 "are used as follows:"
2559 #: build/C/man7/bootparam.7:1146
2560 msgid "T - device type: 1=FM, 2=SB, 3=PAS, 4=GUS, 5=MPU401, 6=SB16, 7=SB16-MPU401"
2564 #: build/C/man7/bootparam.7:1148
2565 msgid "aaa - I/O address in hex."
2569 #: build/C/man7/bootparam.7:1150
2570 msgid "I - interrupt line in hex (i.e 10=a, 11=b, ...)"
2574 #: build/C/man7/bootparam.7:1152
2575 msgid "d - DMA channel."
2579 #: build/C/man7/bootparam.7:1157
2581 "As you can see it gets pretty messy, and you are better off to compile in "
2582 "your own personal values as recommended. Using a boot arg of \\&'sound=0' "
2583 "will disable the sound driver entirely."
2587 #: build/C/man7/bootparam.7:1157
2589 msgid "ISDN drivers"
2593 #: build/C/man7/bootparam.7:1158
2595 msgid "B<The ICN ISDN driver>"
2599 #: build/C/man7/bootparam.7:1163
2600 msgid "icn=iobase,membase,icn_id1,icn_id2"
2604 #: build/C/man7/bootparam.7:1166
2606 "where icn_id1,icn_id2 are two strings used to identify the card in kernel "
2611 #: build/C/man7/bootparam.7:1166
2613 msgid "B<The PCBIT ISDN driver>"
2617 #: build/C/man7/bootparam.7:1171
2618 msgid "pcbit=membase1,irq1[,membase2,irq2]"
2622 #: build/C/man7/bootparam.7:1176
2624 "where membaseN is the shared memory base of the N'th card, and irqN is the "
2625 "interrupt setting of the N'th card. The default is IRQ 5 and membase "
2630 #: build/C/man7/bootparam.7:1176
2632 msgid "B<The Teles ISDN driver>"
2636 #: build/C/man7/bootparam.7:1181
2637 msgid "teles=iobase,irq,membase,protocol,teles_id"
2641 #: build/C/man7/bootparam.7:1185
2643 "where iobase is the i/o port address of the card, membase is the shared "
2644 "memory base address of the card, irq is the interrupt channel the card uses, "
2645 "and teles_id is the unique ASCII string identifier."
2649 #: build/C/man7/bootparam.7:1185
2651 msgid "Serial port drivers"
2655 #: build/C/man7/bootparam.7:1186
2657 msgid "B<The RISCom/8 Multiport Serial Driver ('riscom8=')>"
2661 #: build/C/man7/bootparam.7:1191
2662 msgid "riscom=iobase1[,iobase2[,iobase3[,iobase4]]]"
2666 #: build/C/man7/bootparam.7:1194
2667 msgid "More details can be found in I</usr/src/linux/Documentation/riscom8.txt>."
2671 #: build/C/man7/bootparam.7:1194
2673 msgid "B<The DigiBoard Driver ('digi=')>"
2677 #: build/C/man7/bootparam.7:1198
2678 msgid "If this option is used, it should have precisely six parameters. Syntax:"
2682 #: build/C/man7/bootparam.7:1200
2683 msgid "digi=status,type,altpin,numports,iobase,membase"
2687 #: build/C/man7/bootparam.7:1212
2689 "The parameters maybe given as integers, or as strings. If strings are used, "
2690 "then iobase and membase should be given in hexadecimal. The integer "
2691 "arguments (fewer may be given) are in order: status (Enable(1) or Disable(0) "
2692 "this card), type (PC/Xi(0), PC/Xe(1), PC/Xeve(2), PC/Xem(3)), altpin "
2693 "(Enable(1) or Disable(0) alternate pin arrangement), numports (number of "
2694 "ports on this card), iobase (I/O Port where card is configured (in HEX)), "
2695 "membase (base of memory window (in HEX)). Thus, the following two boot "
2696 "prompt arguments are equivalent:"
2700 #: build/C/man7/bootparam.7:1214
2701 msgid "digi=E,PC/Xi,D,16,200,D0000"
2705 #: build/C/man7/bootparam.7:1216
2706 msgid "digi=1,0,0,16,0x200,851968"
2710 #: build/C/man7/bootparam.7:1219
2711 msgid "More details can be found in I</usr/src/linux/Documentation/digiboard.txt>."
2715 #: build/C/man7/bootparam.7:1219
2717 msgid "B<The Baycom Serial/Parallel Radio Modem>"
2721 #: build/C/man7/bootparam.7:1224
2722 msgid "baycom=iobase,irq,modem"
2726 #: build/C/man7/bootparam.7:1236
2728 "There are precisely 3 parameters; for several cards, give several 'baycom=' "
2729 "commands. The modem parameter is a string that can take one of the values "
2730 "ser12, ser12*, par96, par96*. Here the * denotes that software DCD is to be "
2731 "used, and ser12/par96 chooses between the supported modem types. For more "
2732 "details, see the file I<Documentation/networking/baycom.txt> (or "
2733 "I<drivers/net/README.baycom> for older kernels) in the Linux kernel source."
2737 #: build/C/man7/bootparam.7:1236
2739 msgid "B<Soundcard radio modem driver>"
2743 #: build/C/man7/bootparam.7:1241
2744 msgid "soundmodem=iobase,irq,dma[,dma2[,serio[,pario]]],0,mode"
2748 #: build/C/man7/bootparam.7:1247
2750 "All parameters except the last are integers; the dummy 0 is required because "
2751 "of a bug in the setup code. The mode parameter is a string with syntax "
2752 "hw:modem, where hw is one of sbc, wss, wssfdx and modem is one of afsk1200, "
2757 #: build/C/man7/bootparam.7:1247
2759 msgid "The line printer driver"
2763 #: build/C/man7/bootparam.7:1248
2769 #: build/C/man7/bootparam.7:1253
2774 #: build/C/man7/bootparam.7:1255
2779 #: build/C/man7/bootparam.7:1257
2784 #: build/C/man7/bootparam.7:1259
2785 msgid "lp=port[,port...]"
2789 #: build/C/man7/bootparam.7:1265
2791 "You can tell the printer driver what ports to use and what ports not to "
2792 "use. The latter comes in handy if you don't want the printer driver to "
2793 "claim all available parallel ports, so that other drivers (e.g., PLIP, PPA) "
2794 "can use them instead."
2798 #: build/C/man7/bootparam.7:1272
2800 "The format of the argument is multiple port names. For example, "
2801 "lp=none,parport0 would use the first parallel port for lp1, and disable "
2802 "lp0. To disable the printer driver entirely, one can use lp=0."
2806 #: build/C/man7/bootparam.7:1272
2808 msgid "B<WDT500/501 driver>"
2812 #: build/C/man7/bootparam.7:1277
2817 #: build/C/man7/bootparam.7:1277
2819 msgid "Mouse drivers"
2823 #: build/C/man7/bootparam.7:1278
2825 msgid "B<'bmouse=irq'>"
2829 #: build/C/man7/bootparam.7:1282
2831 "The busmouse driver only accepts one parameter, that being the hardware IRQ "
2836 #: build/C/man7/bootparam.7:1282
2838 msgid "B<'msmouse=irq'>"
2842 #: build/C/man7/bootparam.7:1285
2843 msgid "And precisely the same is true for the msmouse driver."
2847 #: build/C/man7/bootparam.7:1285
2849 msgid "B<ATARI mouse setup>"
2853 #: build/C/man7/bootparam.7:1289
2854 msgid "atamouse=threshold[,y-threshold]"
2858 #: build/C/man7/bootparam.7:1295
2860 "If only one argument is given, it is used for both x-threshold and "
2861 "y-threshold. Otherwise, the first argument is the x-threshold, and the "
2862 "second the y-threshold. These values must lie between 1 and 20 (inclusive); "
2867 #: build/C/man7/bootparam.7:1295
2869 msgid "Video hardware"
2873 #: build/C/man7/bootparam.7:1296
2875 msgid "B<'no-scroll'>"
2879 #. Linus Torvalds (and many others)
2881 #: build/C/man7/bootparam.7:1305
2883 "This option tells the console driver not to use hardware scroll (where a "
2884 "scroll is effected by moving the screen origin in video memory, instead of "
2885 "moving the data). It is required by certain Braille machines."
2889 #: build/C/man7/bootparam.7:1311
2890 msgid "B<lilo.conf>(5), B<klogd>(8), B<lilo>(8), B<mount>(8), B<rdev>(8)"
2894 #: build/C/man7/bootparam.7:1317
2896 "Large parts of this man page have been derived from the Boot Parameter HOWTO "
2897 "(version 1.0.1) written by Paul Gortmaker. More information may be found in "
2898 "this (or a more recent) HOWTO. An up-to-date source of information is "
2899 "I</usr/src/linux/Documentation/kernel-parameters.txt>."
2903 #: build/C/man2/reboot.2:28
2909 #: build/C/man2/reboot.2:28
2915 #: build/C/man2/reboot.2:31
2916 msgid "reboot - reboot or enable/disable Ctrl-Alt-Del"
2920 #: build/C/man2/reboot.2:36
2923 "/* For libc4 and libc5 the library call and the system call\n"
2924 " are identical, and since kernel version 2.1.30 there are\n"
2925 " symbolic names LINUX_REBOOT_* for the constants and a\n"
2926 " fourth argument to the call: */\n"
2930 #: build/C/man2/reboot.2:38 build/C/man2/reboot.2:48 build/C/man2/sync.2:41
2931 msgid "B<#include E<lt>unistd.hE<gt>>"
2935 #: build/C/man2/reboot.2:40
2936 msgid "B<#include E<lt>linux/reboot.hE<gt>>"
2940 #: build/C/man2/reboot.2:42
2942 "B<int reboot(int >I<magic>B<, int >I<magic2>B<, int >I<cmd>B<, void "
2947 #: build/C/man2/reboot.2:46
2950 "/* Under glibc some of the constants involved have gotten\n"
2951 " symbolic names RB_*, and the library call is a 1-argument\n"
2952 " wrapper around the 3-argument system call: */\n"
2956 #: build/C/man2/reboot.2:50
2957 msgid "B<#include E<lt>sys/reboot.hE<gt>>"
2961 #: build/C/man2/reboot.2:52
2962 msgid "B<int reboot(int >I<cmd>B<);>"
2966 #: build/C/man2/reboot.2:59
2968 "The B<reboot>() call reboots the system, or enables/disables the reboot "
2969 "keystroke (abbreviated CAD, since the default is Ctrl-Alt-Delete; it can be "
2970 "changed using B<loadkeys>(1))."
2974 #: build/C/man2/reboot.2:86
2976 "This system call will fail (with B<EINVAL>) unless I<magic> equals "
2977 "B<LINUX_REBOOT_MAGIC1> (that is, 0xfee1dead) and I<magic2> equals "
2978 "B<LINUX_REBOOT_MAGIC2> (that is, 672274793). However, since 2.1.17 also "
2979 "B<LINUX_REBOOT_MAGIC2A> (that is, 85072278) and since 2.1.97 also "
2980 "B<LINUX_REBOOT_MAGIC2B> (that is, 369367448) and since 2.5.71 also "
2981 "B<LINUX_REBOOT_MAGIC2C> (that is, 537993216) are permitted as value for "
2982 "I<magic2>. (The hexadecimal values of these constants are meaningful.) The "
2983 "I<cmd> argument can have the following values:"
2987 #: build/C/man2/reboot.2:86
2989 msgid "B<LINUX_REBOOT_CMD_CAD_OFF>"
2993 #: build/C/man2/reboot.2:95
2995 "(RB_DISABLE_CAD, 0). CAD is disabled. This means that the CAD keystroke "
2996 "will cause a B<SIGINT> signal to be sent to init (process 1), whereupon this "
2997 "process may decide upon a proper action (maybe: kill all processes, sync, "
3002 #: build/C/man2/reboot.2:95
3004 msgid "B<LINUX_REBOOT_CMD_CAD_ON>"
3008 #: build/C/man2/reboot.2:102
3010 "(RB_ENABLE_CAD, 0x89abcdef). CAD is enabled. This means that the CAD "
3011 "keystroke will immediately cause the action associated with "
3012 "B<LINUX_REBOOT_CMD_RESTART>."
3016 #: build/C/man2/reboot.2:102
3018 msgid "B<LINUX_REBOOT_CMD_HALT>"
3022 #: build/C/man2/reboot.2:110
3024 "(RB_HALT_SYSTEM, 0xcdef0123; since 1.1.76). The message \"System halted.\" "
3025 "is printed, and the system is halted. Control is given to the ROM monitor, "
3026 "if there is one. If not preceded by a B<sync>(2), data will be lost."
3030 #: build/C/man2/reboot.2:110
3032 msgid "B<LINUX_REBOOT_CMD_KEXEC> (since Linux 2.6.13)"
3036 #: build/C/man2/reboot.2:116
3038 "Execute a kernel that has been loaded earlier with B<kexec_load>(2). This "
3039 "option is only available if the kernel was configured with B<CONFIG_KEXEC>."
3043 #: build/C/man2/reboot.2:116
3045 msgid "B<LINUX_REBOOT_CMD_POWER_OFF>"
3049 #: build/C/man2/reboot.2:124
3051 "(0x4321fedc; since 2.1.30). The message \"Power down.\" is printed, the "
3052 "system is stopped, and all power is removed from the system, if possible. "
3053 "If not preceded by a B<sync>(2), data will be lost."
3057 #: build/C/man2/reboot.2:124
3059 msgid "B<LINUX_REBOOT_CMD_RESTART>"
3063 #: build/C/man2/reboot.2:132
3065 "(RB_AUTOBOOT, 0x1234567). The message \"Restarting system.\" is printed, "
3066 "and a default restart is performed immediately. If not preceded by a "
3067 "B<sync>(2), data will be lost."
3071 #: build/C/man2/reboot.2:132
3073 msgid "B<LINUX_REBOOT_CMD_RESTART2>"
3077 #: build/C/man2/reboot.2:142
3079 "(0xa1b2c3d4; since 2.1.30). The message \"Restarting system with command "
3080 "\\(aq%s\\(aq\" is printed, and a restart (using the command string given in "
3081 "I<arg>) is performed immediately. If not preceded by a B<sync>(2), data "
3086 #: build/C/man2/reboot.2:145
3087 msgid "Only the superuser may call B<reboot>()."
3091 #: build/C/man2/reboot.2:151
3093 "The precise effect of the above actions depends on the architecture. For "
3094 "the i386 architecture, the additional argument does not do anything at "
3095 "present (2.1.122), but the type of reboot can be determined by kernel "
3096 "command-line arguments (\"reboot=...\") to be either warm or cold, and "
3097 "either hard or through the BIOS."
3101 #: build/C/man2/reboot.2:164
3103 "For the values of I<cmd> that stop or restart the system, a successful call "
3104 "to B<reboot>() does not return. For the other I<cmd> values, zero is "
3105 "returned on success. In all cases, -1 is returned on failure, and I<errno> "
3106 "is set appropriately."
3110 #: build/C/man2/reboot.2:169
3111 msgid "Problem with getting user-space data under B<LINUX_REBOOT_CMD_RESTART2>."
3115 #: build/C/man2/reboot.2:172
3116 msgid "Bad magic numbers or I<cmd>."
3120 #: build/C/man2/reboot.2:179
3122 "The calling process has insufficient privilege to call B<reboot>(); the "
3123 "B<CAP_SYS_BOOT> capability is required."
3127 #: build/C/man2/reboot.2:183
3129 "B<reboot>() is Linux-specific, and should not be used in programs intended "
3134 #: build/C/man2/reboot.2:190
3136 "B<sync>(2), B<bootparam>(7), B<capabilities>(7), B<ctrlaltdel>(8), "
3137 "B<halt>(8), B<reboot>(8)"
3141 #: build/C/man2/sync.2:36 build/C/man8/sync.8:10
3147 #: build/C/man2/sync.2:36
3153 #: build/C/man2/sync.2:39
3154 msgid "sync, syncfs - commit buffer cache to disk"
3158 #: build/C/man2/sync.2:43
3159 msgid "B<void sync(void);>"
3163 #: build/C/man2/sync.2:45
3164 msgid "B<int syncfs(int >I<fd>B<);>"
3168 #: build/C/man2/sync.2:49
3169 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
3173 #: build/C/man2/sync.2:52
3178 #: build/C/man2/sync.2:56
3180 "_BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE\\ &&\\ "
3181 "_XOPEN_SOURCE_EXTENDED"
3185 #: build/C/man2/sync.2:60
3186 msgid "B<syncfs>():"
3190 #: build/C/man2/sync.2:63
3195 #: build/C/man2/sync.2:69
3197 "B<sync>() causes all buffered modifications to file metadata and data to be "
3198 "written to the underlying file systems."
3202 #: build/C/man2/sync.2:76
3204 "B<syncfs>() is like B<sync>(), but synchronizes just the file system "
3205 "containing file referred to by the open file descriptor I<fd>."
3209 #: build/C/man2/sync.2:82
3211 "B<syncfs>() returns 0 on success; on error, it returns -1 and sets I<errno> "
3212 "to indicate the error."
3216 #: build/C/man2/sync.2:85
3217 msgid "B<sync>() is always successful."
3221 #: build/C/man2/sync.2:88
3222 msgid "B<syncfs>() can fail for at least the following reason:"
3226 #: build/C/man2/sync.2:88
3232 #: build/C/man2/sync.2:92
3233 msgid "I<fd> is not a valid file descriptor."
3237 #: build/C/man2/sync.2:92
3243 #: build/C/man2/sync.2:96
3245 "B<syncfs>() first appeared in Linux 2.6.39; library support was added to "
3246 "glibc in version 2.14."
3250 #: build/C/man2/sync.2:99
3251 msgid "B<sync>(): SVr4, 4.3BSD, POSIX.1-2001."
3255 #: build/C/man2/sync.2:102
3256 msgid "B<syncfs>() is Linux-specific."
3260 #: build/C/man2/sync.2:102 build/C/man8/sync.8:67
3266 #: build/C/man2/sync.2:111
3268 "Since glibc 2.2.2 the Linux prototype for B<sync>() is as listed above, "
3269 "following the various standards. In libc4, libc5, and glibc up to 2.2.1 it "
3270 "was \"int sync(void)\", and B<sync>() always returned 0."
3274 #: build/C/man2/sync.2:111
3280 #: build/C/man2/sync.2:119
3282 "According to the standard specification (e.g., POSIX.1-2001), B<sync>() "
3283 "schedules the writes, but may return before the actual writing is done. "
3284 "However, since version 1.3.20 Linux does actually wait. (This still does "
3285 "not guarantee data integrity: modern disks have large caches.)"
3289 #: build/C/man2/sync.2:125
3290 msgid "B<bdflush>(2), B<fdatasync>(2), B<fsync>(2), B<sync>(8), B<update>(8)"
3294 #: build/C/man8/sync.8:10
3300 #: build/C/man8/sync.8:10
3306 #: build/C/man8/sync.8:13
3307 msgid "sync - synchronize data on disk with memory"
3311 #: build/C/man8/sync.8:15
3312 msgid "B<sync [--help] [--version]>"
3316 #: build/C/man8/sync.8:26
3318 "B<sync> writes any data buffered in memory out to disk. This can include "
3319 "(but is not limited to) modified superblocks, modified inodes, and delayed "
3320 "reads and writes. This must be implemented by the kernel; The B<sync> "
3321 "program does nothing but exercise the B<sync>(2) system call."
3325 #: build/C/man8/sync.8:33
3327 "The kernel keeps data in memory to avoid doing (relatively slow) disk reads "
3328 "and writes. This improves performance, but if the computer crashes, data "
3329 "may be lost or the file system corrupted as a result. B<sync> ensures that "
3330 "everything in memory is written to disk."
3334 #: build/C/man8/sync.8:52
3336 "B<sync> should be called before the processor is halted in an unusual manner "
3337 "(e.g., before causing a kernel panic when debugging new kernel code). In "
3338 "general, the processor should be halted using the B<shutdown>(8) or "
3339 "B<reboot>(8) or B<halt>(8) commands, which will attempt to put the system "
3340 "in a quiescent state before calling B<sync>(2). (Various implementations of "
3341 "these commands exist; consult your documentation; on some systems one should "
3342 "not call B<reboot>(8) and B<halt>(8) directly.)"
3346 #: build/C/man8/sync.8:52
3352 #: build/C/man8/sync.8:53
3358 #: build/C/man8/sync.8:56
3359 msgid "Print a usage message on standard output and exit successfully."
3363 #: build/C/man8/sync.8:56
3365 msgid "B<--version>"
3369 #: build/C/man8/sync.8:59
3370 msgid "Print version information on standard output, then exit successfully."
3374 #: build/C/man8/sync.8:59
3380 #: build/C/man8/sync.8:62
3381 msgid "Terminate option list."
3385 #: build/C/man8/sync.8:62
3391 #: build/C/man8/sync.8:65
3393 "The variables B<LANG>, B<LC_ALL>, B<LC_CTYPE>, and B<LC_MESSAGES> have the "
3398 #: build/C/man8/sync.8:67
3403 #: build/C/man8/sync.8:79
3405 "On Linux, B<sync> is only guaranteed to schedule the dirty blocks for "
3406 "writing; it can actually take a short time before all the blocks are finally "
3407 "written. The B<reboot>(8) and B<halt>(8) commands take this into account "
3408 "by sleeping for a few seconds after calling B<sync>(2)."
3412 #: build/C/man8/sync.8:84
3414 "This page describes B<sync> as found in the file\\%utils-4.0 package; other "
3415 "versions may differ slightly."
3419 #: build/C/man8/sync.8:89
3420 msgid "B<sync>(2), B<halt>(8), B<reboot>(8), B<update>(8)"