[PATCH] doc: Updated Documentation/nfsroot.txt

From: Nico Schottelius
Date: Sat Mar 18 2006 - 06:04:02 EST

Hello LKML!

What am I doing terrible wrong that I do not get any comment on this

----- Forwarded message from Arthur Othieno <apgo@xxxxxxxxxxxxx> -----

Date: Tue, 14 Feb 2006 11:05:53 -0500
To: akpm@xxxxxxxx
Cc: Nico Schottelius <nico-kernel@xxxxxxxxxxxxxxx>,
Arthur Othieno <apgo@xxxxxxxxxxxxx>
Subject: [PATCH] doc: Updated Documentation/nfsroot.txt
From: Arthur Othieno <apgo@xxxxxxxxxxxxx>

From: Nico Schottelius <nico-kernel@xxxxxxxxxxxxxxx>

I today booted the first time my embedded device using Linux,
which was booted by pxelinux, which then bootet itself from the nfsroot.

This went pretty fine, but when I was reading through
Documentation/nfsroot.txt I saw that there are some more modern versions
available of loading the kernel and passing parameters.

So I added them and the patch for that is attached to this mail.

Signed-off-by: Nico Schottelius <nico-kernel@xxxxxxxxxxxxxxx>
Signed-off-by: Arthur Othieno <apgo@xxxxxxxxxxxxx>


Documentation/nfsroot.txt | 17 ++++++++++++++---
1 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/Documentation/nfsroot.txt b/Documentation/nfsroot.txt
index a87d4af..d56dc71 100644
--- a/Documentation/nfsroot.txt
+++ b/Documentation/nfsroot.txt
@@ -3,6 +3,7 @@ Mounting the root filesystem via NFS (nf

Written 1996 by Gero Kuhlmann <gero@xxxxxxxxxxxxxx>
Updated 1997 by Martin Mares <mj@xxxxxxxxxxxxxxxxxxxxxxxx>
+Updated 2006 by Nico Schottelius <nico-kernel-nfsroot@xxxxxxxxxxxxxxx>

@@ -168,7 +169,6 @@ depend on what facilities are available:
root. If it got a BOOTP answer the directory name in that answer
is used.

3.2) Using LILO
When using LILO you can specify all necessary command line
parameters with the 'append=' command in the LILO configuration
@@ -177,7 +177,11 @@ depend on what facilities are available:
LILO and its 'append=' command please refer to the LILO

-3.3) Using loadlin
+3.3) Using GRUB
+ When you use GRUB, you simply append the parameters after the kernel
+ specification: "kernel <kernel> <parameters>" (without the quotes).
+3.4) Using loadlin
When you want to boot Linux from a DOS command prompt without
having a local hard disk to mount as root, you can use loadlin.
I was told that it works, but haven't used it myself yet. In
@@ -185,7 +189,7 @@ depend on what facilities are available:
lar to how LILO is doing it. Please refer to the loadlin docu-
mentation for further information.

-3.4) Using a boot ROM
+3.5) Using a boot ROM
This is probably the most elegant way of booting a diskless
client. With a boot ROM the kernel gets loaded using the TFTP
protocol. As far as I know, no commercial boot ROMs yet
@@ -194,6 +198,13 @@ depend on what facilities are available:
and its mirrors. They are called 'netboot-nfs' and 'etherboot'.
Both contain everything you need to boot a diskless Linux client.

+3.6) Using pxelinux
+ Using pxelinux you specify the kernel you built with
+ "kernel <relative-path-below /tftpboot>". The nfsroot parameters
+ are passed to the kernel by adding them to the "append" line.
+ You may perhaps also want to fine tune the console output,
+ see Documentation/serial-console.txt for serial console help.


----- End forwarded message -----

Please reply to nico-kernel2 (same domain as sending address).
Replying to this address needs a confirmation, but works, too.

Attachment: signature.asc
Description: Digital signature