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:
parent
13c4b57c0c
commit
b9f23248c5
1 changed files with 33 additions and 34 deletions
|
@ -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
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue