diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2013-06-08 05:17:34 +0200 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2013-06-12 14:56:28 +0200 |
| commit | e57fca5af6cf061a2db6017abd79c366d37a6d8d (patch) | |
| tree | e4d41119f5d23528b9c7a2ba44985233e5bc58e6 | |
| parent | 421405f915675fb15460d2b91439f90839b9988e (diff) | |
| download | man-pages-e57fca5af6cf061a2db6017abd79c366d37a6d8d.tar.gz | |
bootparam.7: Minor formatting fixes + fixes to kernel source file paths
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
| -rw-r--r-- | man7/bootparam.7 | 78 |
1 files changed, 46 insertions, 32 deletions
diff --git a/man7/bootparam.7 b/man7/bootparam.7 index f98ac730d1..30611d8254 100644 --- a/man7/bootparam.7 +++ b/man7/bootparam.7 @@ -82,7 +82,8 @@ separated parameters per keyword. keyword with up to an additional 10 parameters in unusually complicated situations, assuming the setup function supports it.) -Most of the sorting goes on in linux/init/main.c. +Most of the sorting is coded in the kernel source file +.IR init/main.c . First, the kernel checks to see if the argument is any of the special arguments 'root=', \&'nfsroot=', 'nfsaddrs=', 'ro', 'rw', 'debug' or 'init'. @@ -176,7 +177,9 @@ select the second floppy drive as the root device, one would use 'root=/dev/fd1'. The root device can be specified symbolically or numerically. -A symbolic specification has the form /dev/XXYN, where XX designates +A symbolic specification has the form +.I /dev/XXYN, +where XX designates the device type ('hd' for ST-506 compatible hard disk, with Y in \&'a'-'d'; 'sd' for SCSI compatible disk, with Y in 'a'-'e'; \&'ad' for Atari ACSI disk, with Y in 'a'-'e', @@ -197,7 +200,9 @@ The '/dev/' part is purely conventional. The more awkward and less portable numeric specification of the above possible root devices in major/minor format is also accepted. -(E.g., /dev/sda3 is major 8, minor 3, so you could use 'root=0x803' as an +(E.g., +.I /dev/sda3 +is major 8, minor 3, so you could use 'root=0x803' as an alternative.) .TP .BR "'rootfstype=...'" @@ -323,7 +328,8 @@ may be logged to disk. Messages with a priority above .I console_loglevel are also printed on the console. -(For these levels, see \fI<linux/kernel.h>\fP.) +(For these levels, see +.IR <linux/kernel.h> .) By default this variable is set to log anything more important than debug messages. This boot argument will cause the kernel to also @@ -389,8 +395,10 @@ a 'ramdisk=N' parameter to tell its size. (This could also be set in the kernel image at compile time.) These days ram disks use the buffer cache, and grow dynamically. For a lot of information in conjunction with the new ramdisk -setup), see -.IR /usr/src/linux/Documentation/ramdisk.txt . +setup), see the kernel source file +.IR Documentation/blockdev/ramdisk.txt +.RI ( Documentation/ramdisk.txt +in older kernels). There are four parameters, two boolean and two integral. .TP @@ -423,12 +431,18 @@ These days it is possible to compile the kernel to use initrd. When this feature is enabled, the boot process will load the kernel and an initial ramdisk; then the kernel converts initrd into a "normal" ramdisk, which is mounted read-write as root device; -then /linuxrc is executed; afterward the "real" root file system is mounted, -and the initrd file system is moved over to /initrd; finally -the usual boot sequence (e.g., invocation of /sbin/init) is performed. +then +.I /linuxrc +is executed; afterward the "real" root file system is mounted, +and the initrd file system is moved over tocw +.IR /initrd ; +finally +the usual boot sequence (e.g., invocation of +.IR /sbin/init ) +is performed. -For a detailed description of the initrd feature, see -.IR /usr/src/linux/Documentation/initrd.txt . +For a detailed description of the initrd feature, see the kernel source file +.IR Documentation/initrd.txt . The 'noinitrd' option tells the kernel that although it was compiled for operation with initrd, it should not go through the above steps, but @@ -593,7 +607,7 @@ value, if nonzero, tells the driver not to reset the SCSI bus when setting up the host adapter at boot. .TP .B "AdvanSys SCSI Hosts configuration ('advansys=')" -The AdvanSys driver can accept up to four i/o addresses that will be +The AdvanSys driver can accept up to four I/O addresses that will be probed for an AdvanSys SCSI card. Note that these values (if used) do not effect EISA or PCI probing in any way. @@ -614,9 +628,9 @@ level of the debugging messages to any of 16 levels of verbosity. .BI BusLogic= N1,N2,N3,N4,N5,S1,S2,... .IP For an extensive discussion of the BusLogic command line parameters, -see -.I /usr/src/linux/drivers/scsi/BusLogic.c -(lines 3149-3270 in the kernel version I am looking at). +see the kernel source file +.IR drivers/scsi/BusLogic.c . +.\" (lines 3149-3270 in the kernel version I am looking at). The text below is a very much abbreviated extract. @@ -639,7 +653,7 @@ ER:None, ER:<Per-Target-Spec>), and over Host Adapter Probing (NoProbe, NoProbeISA, NoSortPCI). .TP .B "EATA/DMA configuration" -The default list of i/o ports to be probed can be changed by +The default list of I/O ports to be probed can be changed by .IP .BI eata= iobase,iobase,...\fP. .TP @@ -670,8 +684,8 @@ where S is a comma-separated string of items keyword[:value]. Recognized keywords (possibly with value) are: ioport:addr, noreset, nosync:x, period:ns, disconnect:x, debug:x, proc:x. -For the function of these parameters, see -.IR /usr/src/linux/drivers/scsi/in2000.c . +For the function of these parameters, see the kernel source file +.IR drivers/scsi/in2000.c . .TP .B "NCR5380 and NCR53C400 configuration" The boot arg is of the form @@ -700,8 +714,8 @@ Recognized keywords are: mpar (master_parity), spar (scsi_parity), disc (disconnection), specf (special_features), ultra (ultra_scsi), fsn (force_sync_nego), tags (default_tags), sync (default_sync), verb (verbose), debug (debug), burst (burst_max). -For the function of the assigned values, see -.IR /usr/src/linux/drivers/scsi/ncr53c8xx.c . +For the function of the assigned values, see the kernel source file +.IR drivers/scsi/ncr53c8xx.c . .TP .B "NCR53c406a configuration" .IP @@ -746,7 +760,7 @@ The valid values for are as follows: 0xcc000, 0xc8000, 0xdc000, 0xd8000. .TP .B "UltraStor 14F/34F configuration" -The default list of i/o ports to be probed can be changed by +The default list of I/O ports to be probed can be changed by .IP .BI eata= iobase,iobase,... . .TP @@ -762,8 +776,8 @@ where S is a comma-separated string of options. Recognized options are nosync:bitmask, nodma:x, period:ns, disconnect:x, debug:x, clock:x, next. -For details, see -.IR /usr/src/linux/drivers/scsi/wd33c93.c . +For details, see the kernel source file +.IR drivers/scsi/wd33c93.c . .SS Hard disks .TP .B "IDE Disk/CD-ROM Driver Parameters" @@ -881,8 +895,8 @@ xd=2,5,0x320,3 .IP .BI ez= iobase[,irq[,rep[,nybble]]] .SS IBM MCA bus devices -See also -.IR /usr/src/linux/Documentation/mca.txt . +See also the kernel source file +.IR Documentation/mca.txt . .TP .B "PS/2 ESDI hard disks" It is possible to specify the desired geometry at boot time: @@ -1174,7 +1188,7 @@ Syntax: .IP teles=iobase,irq,membase,protocol,teles_id .IP -where iobase is the i/o port address of the card, membase is the +where iobase is the I/O port address of the card, membase is the shared memory base address of the card, irq is the interrupt channel the card uses, and teles_id is the unique ASCII string identifier. .SS Serial port drivers @@ -1184,8 +1198,8 @@ Syntax: .IP riscom=iobase1[,iobase2[,iobase3[,iobase4]]] .IP -More details can be found in -.IR /usr/src/linux/Documentation/riscom8.txt . +More details can be found in the kernel source file +.IR Documentation/riscom8.txt . .TP .B "The DigiBoard Driver ('digi=')" If this option is used, it should have precisely six parameters. @@ -1209,8 +1223,8 @@ digi=E,PC/Xi,D,16,200,D0000 .br digi=1,0,0,16,0x200,851968 .IP -More details can be found in -.IR /usr/src/linux/Documentation/digiboard.txt . +More details can be found in the kernel source file +.IR Documentation/digiboard.txt . .TP .B "The Baycom Serial/Parallel Radio Modem" Syntax: @@ -1306,5 +1320,5 @@ Braille machines. Large parts of this man page have been derived from the Boot Parameter HOWTO (version 1.0.1) written by Paul Gortmaker. More information may be found in this (or a more recent) HOWTO. -An up-to-date source of information is -.IR /usr/src/linux/Documentation/kernel-parameters.txt . +An up-to-date source of information is the kernel source file +.IR Documentation/kernel-parameters.txt . |