boot(8): the method!server notation isnt usefull anymore...

- in 9front, the bootargs are in the form: method!device args
- remove redundant and wrong paragraphs regarding tcp booting
- document il boot method
- fix boot and bootrc confusions
This commit is contained in:
cinap_lenrek 2014-12-17 11:18:05 +01:00
parent 13c4b57c0c
commit b9f23248c5

View file

@ -10,7 +10,7 @@ boot, bootrc \- connect to the root file server
.BI -u username .BI -u username
] ]
[ [
.IB method ! fs-addr .IB method ! device
] ]
[ [
.I args .I args
@ -19,13 +19,13 @@ boot, bootrc \- connect to the root file server
.I Boot .I Boot
is the first program run after a kernel has been loaded. It is the first program run after a kernel has been loaded. It
mounts mounts
.B bootfs.paq, .BR bootfs.paq ,
a compressed filesystem contained in a compressed filesystem contained in
.IR root (3), .IR root (3),
sets up the sets up the
.IR rc (1) .IR rc (1)
environment and executes environment and executes
.I /boot/bootrc .I bootrc
passing on its arguments. passing on its arguments.
.I Bootrc .I Bootrc
connects to the file server that will serve the root, performs any connects to the file server that will serve the root, performs any
@ -74,20 +74,18 @@ variable with the same name and value.
The command line is The command line is
.IP .IP
.B /boot/boot .B /boot/boot
.IB method ! server .IB method ! device
.PP .PP
After After
.I boot .I boot
passed its execution to passed its execution to
.I bootrc, .I bootrc,
it must determine the file it must determine the fileserver to use and a
.I server
to use
and a
.I method .I method
with which to connect to it. with which to connect to it.
Typically this will name a file server on the network, Typically
or state that the root file system is on local disk and name the partition. .I device
will name a local disk partition or ethernet interface.
The complete list of methods is given below. The complete list of methods is given below.
.PP .PP
.I Bootrc .I Bootrc
@ -98,11 +96,11 @@ when challenged.
.I Bootrc .I Bootrc
will prompt for these. will prompt for these.
.PP .PP
Method and address are prompted for first. Method and device are prompted for first.
The prompt lists all valid methods, with the default in brackets, for example: The prompt lists all valid methods, with the default in brackets, for example:
.IP .IP
.EX .EX
bootargs is (tcp, local!device) [local!/dev/sdC0/fscache] bootargs is (tcp, il, local!device) [local!/dev/sdC0/fscache]
.EE .EE
.PP .PP
A newline picks the default. Entering A newline picks the default. Entering
@ -111,9 +109,11 @@ breaks into the
.IR rc (1) .IR rc (1)
shell. shell.
Other possible responses are Other possible responses are
.I method .IR method ,
.IB method ! device
or or
.IB method ! address\f1. .IB method ! device
.IR args .
.PP .PP
The other interactions depend on whether the system The other interactions depend on whether the system
is a is a
@ -226,6 +226,8 @@ The complete list of booting methods are listed below.
.BR tcp .BR tcp
connect via Ethernet using the TCP protocol. connect via Ethernet using the TCP protocol.
The The
.I device
and
.I args .I args
are passed to are passed to
.IR ipconfig (8) .IR ipconfig (8)
@ -236,30 +238,27 @@ variables
.B fs .B fs
and and
.BR auth .BR auth
override the file server and authentication server IP addresses override the file server and authentication servers
obtained (if any) from DHCP during obtained (if any) from DHCP during
.IR ipconfig (8). .IR ipconfig (8).
.TP 8 .TP 8
.B local .BR il
connect to the local file system. the same as
The first argument is a disk holding a file system.
.I Boot
inspects the disk.
.I Boot
will configure the IP stack by passing
.IR args ,
if any, to
.IR ipconfig (8).
.RE
.PP
For the
.B tcp .B tcp
method, but uses the IL protocol to connect to the fileserver.
the address must be a numeric IP address. .TP 8
If no address is specified, .BR local
a file server address will be found from another connect to the local file system.
system on the network using the BOOTP protocol and The
the Plan 9 vendor-specific fields. .I device
is a disk partition file holding a file system.
.I Bootrc
inspects the disk partition with
.IR fstype (1)
to determine the file system type and starts the
appropriate server with
.IR args .
.RE
.SH EXAMPLES .SH EXAMPLES
On PCs, the default arguments to boot are constructed using On PCs, the default arguments to boot are constructed using
the the