>Number:         29858
>Category:       misc
>Synopsis:       diskless(8) man page is wrong about 'option swap-server'
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Apr 01 17:46:00 +0000 2005
>Originator:     Miles Nordin
>Release:        NetBSD 2.0_RC5
>Organization:
Ivy Ministries
>Environment:
System: NetBSD castrovalva 2.0_RC5 NetBSD 2.0_RC5 (CASTROVALVA-$Revision: 1.8 $) #2: Tue Feb 15 19:00:10 EST 2005 carton@castrovalva:/scratch/src/sys/arch/alpha/compile/CASTROVALVA alpha
Machine: macppc
>Description:
the diskless man page says the dhcp 'next-server' option is used for finding 
the root filesystem NFS server.  I believe NetBSD will fall back to this 
config, but it will prefer to use the 'option swap-server' as the NFS 
root filesystem server if that option is set.

I've verified on macppc I can use two different machines for TFTP and NFS 
server by setting the DHCP options this way.  Both the second-stage 
bootloader and the kernel will obey 'option swap-server'.
>How-To-Repeat:
>Fix:
Index: share/man/man8/diskless.8
===================================================================
RCS file: /scratch/cvsroot/netbsd/src/share/man/man8/diskless.8,v
retrieving revision 1.1.1.5
diff -u -r1.1.1.5 diskless.8
--- share/man/man8/diskless.8	12 Dec 2003 11:30:07 -0000	1.1.1.5
+++ share/man/man8/diskless.8	1 Apr 2005 17:39:23 -0000
@@ -511,8 +511,8 @@
 	hardware ethernet 8:0:20:7:c5:c7;
 	fixed-address myclient;		# client's assigned IP address
 	filename "myclient.netboot";	# secondary bootstrap
-	next-server myserver;		# NFS server
-	option swap-server myserver;
+	next-server myserver;		# TFTP server for secondary bootstrap
+	option swap-server myserver;	# NFS server for root filesystem
 	option root-path "/export/myclient/root";
 }
 .Ed