summaryrefslogtreecommitdiffstats
path: root/Documentation/nfsroot.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/nfsroot.txt')
-rw-r--r--Documentation/nfsroot.txt52
1 files changed, 29 insertions, 23 deletions
diff --git a/Documentation/nfsroot.txt b/Documentation/nfsroot.txt
index 43d79a89b..1d42ec6fe 100644
--- a/Documentation/nfsroot.txt
+++ b/Documentation/nfsroot.txt
@@ -2,6 +2,7 @@ Mounting the root filesystem via NFS (nfsroot)
==============================================
Written 1996 by Gero Kuhlmann <gero@gkminix.han.de>
+Updated 1997 by Martin Mares <mj@atrey.karlin.mff.cuni.cz>
@@ -47,12 +48,12 @@ root=/dev/nfs
nfsroot=[<server-ip>:]<root-dir>[,<nfs-options>]
- If the nfsroot parameter is NOT give on the command line, the default
+ If the `nfsroot' parameter is NOT given on the command line, the default
"/tftpboot/%s" will be used.
<server-ip> Specifies the IP address of the NFS server. If this field
is not given, the default address as determined by the
- nfsaddrs variable (see below) is used. One use of this
+ `ip' variable (see below) is used. One use of this
parameter is for example to allow using different servers
for RARP and NFS. Usually you can leave this blank.
@@ -76,10 +77,16 @@ nfsroot=[<server-ip>:]<root-dir>[,<nfs-options>]
flags = hard, nointr, noposix, cto, ac
-nfsaddrs=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf>
+ip=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf>
- If this parameter is missing on the kernel command line, all fields are
- assumed to be empty, and the below mentioned defaults apply. In general
+ This parameter tells the kernel how to configure IP addresses of devices
+ and also how to set up the IP routing table. It was originally called `nfsaddrs',
+ but now the boot-time IP configuration works independently on NFS, so it
+ was renamed to `ip' and the old name remained as an alias for compatibility
+ reasons.
+
+ If this parameter is missing from the kernel command line, all fields are
+ assumed to be empty, and the defaults mentioned below apply. In general
this means that the kernel tries to configure everything using both
RARP and BOOTP (depending on what has been enabled during kernel confi-
guration, and if both what protocol answer got in first).
@@ -95,7 +102,7 @@ nfsaddrs=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf
replies from the specified server are accepted. To use
different RARP and NFS server, specify your RARP server
here (or leave it blank), and specify your NFS server in
- the nfsroot parameter (see above). If this entry is blank
+ the `nfsroot' parameter (see above). If this entry is blank
the address of the server is used which answered the RARP
or BOOTP request.
@@ -105,29 +112,26 @@ nfsaddrs=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf
value has been received by BOOTP.
<netmask> Netmask for local network interface. If this is empty,
- the netmask is derived from the client IP address, un-
- less a value has been received by BOOTP.
+ the netmask is derived from the client IP address assuming
+ classful addressing, unless overriden in BOOTP reply.
<hostname> Name of the client. If empty, the client IP address is
used in ASCII-notation, or the value received by BOOTP.
<device> Name of network device to use. If this is empty, all
- devices are used for RARP requests, and the first one
- found for BOOTP. For NFS the device is used on which
- either RARP or BOOTP replies have been received. If
- you only have one device you can safely leave this blank.
+ devices are used for RARP and BOOTP requests, and the
+ first one we receive a reply on is configured. If you have
+ only one device, you can safely leave this blank.
<autoconf> Method to use for autoconfiguration. If this is either
- 'rarp' or 'bootp' the specified protocol is being used.
+ 'rarp' or 'bootp', the specified protocol is used.
If the value is 'both' or empty, both protocols are used
so far as they have been enabled during kernel configura-
- tion. 'none' means no autoconfiguration. In this case you
- have to specify all necessary values in the fields before.
+ tion. 'off' means no autoconfiguration.
- The <autoconf> parameter can appear alone as the value to the nfsaddrs
+ The <autoconf> parameter can appear alone as the value to the `ip'
parameter (without all the ':' characters before) in which case auto-
- configuration is used. However, the 'none' value is not available in
- that case.
+ configuration is used.
@@ -196,9 +200,11 @@ depend on what facilities are available:
4.) Credits
-------
- The nfsroot code in the kernel has been written by me, Gero Kuhlmann
- <gero@gkminix.han.de>, with the BOOTP code and a couple of bug fixes
- contributed by Martin Mares <mj@k332.feld.cvut.cz>. In order to write
- the initial version of nfsroot I would like to thank Jens-Uwe Mager
- <jum@anubis.han.de> for his help.
+ The nfsroot code in the kernel and the RARP support have been written
+ by Gero Kuhlmann <gero@gkminix.han.de>.
+
+ The rest of the IP layer autoconfiguration code has been written
+ by Martin Mares <mj@atrey.karlin.mff.cuni.cz>.
+ In order to write the initial version of nfsroot I would like to thank
+ Jens-Uwe Mager <jum@anubis.han.de> for his help.