From jdowdal@destiny.dorm.umd.edu  Mon Feb 12 20:08:41 1996
Received: from destiny.dorm.umd.edu (destiny.dorm.umd.edu [129.2.152.36])
          by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id UAA29318
          for <FreeBSD-gnats-submit@freebsd.org>; Mon, 12 Feb 1996 20:08:40 -0800 (PST)
Received: (from root@localhost) by destiny.dorm.umd.edu (8.6.12/8.6.12) id XAA15124; Mon, 12 Feb 1996 23:07:45 -0500
Message-Id: <199602130407.XAA15124@destiny.dorm.umd.edu>
Date: Mon, 12 Feb 1996 23:07:45 -0500
From: John Dowdal <jdowdal@destiny.dorm.umd.edu>
Reply-To: jdowdal@destiny.dorm.umd.edu
To: FreeBSD-gnats-submit@freebsd.org
Subject: Error in handbook wrt creating NFS swap 
X-Send-Pr-Version: 3.2

>Number:         1023
>Category:       docs
>Synopsis:       using touch to create swap file for NFS doesn't work
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    steve
>State:          closed
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Feb 12 20:10:01 PST 1996
>Closed-Date:    Sat Aug 16 16:16:19 PDT 1997
>Last-Modified:  Sat Aug 16 16:19:55 PDT 1997
>Originator:     John Dowdal
>Release:        FreeBSD 2.1.0-STABLE i386
>Organization:
UMD
>Environment:

FreeBSD destiny.dorm.umd.edu 2.1-STABLE FreeBSD 2.1-STABLE #1: Thu Feb  8 17:59:06 EST 1996     jdowdal@destiny.dorm.umd.edu:/usr/src/sys/compile/DESTINY  i386

File: /usr/share/doc/handbook/handbook.ascii
Supped on 2-3-96

The following URL also contains the problem:
http://www.freebsd.org/handbook/handbook180.html#311

>Description:

The following text is incorrect:
  5. If you are swapping over NFS (completely diskless configuration)
     create a swap file for your client using touch.  If your swapfs
     command has the argument /swapfs as in the example above, the
     swapfile for myclient will be called /swapfs/swap.X.X.X.X where
     X.X.X.X is the client's IP addr, eg:

  # touch /swapfs/swap.192.1.2.4


A zero byte swapfile will lead to a spontaneous reboot when the machine
attempts to swap.  This should be:

  # dd if=/dev/zero of=/swapfs/swap.192.1.2.4 bs=1k count=swapsize
(where swapsize is the value given in the bootptab)


Other bugs in the netbooting section are:
Update supported ethernet cards to include 3c509 (using nb3c509.com)
Make it clear that FreeBSD can be used as a server OS for netbooting
   (currently indicates only HPUX and Slowaris can be used)
Perhaps add some details for creating the NFS root filesystem.

>How-To-Repeat:

   N/A
>Fix:

   Update the documentation as indicated above
	
	

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->mpp 
Responsible-Changed-By: phk 
Responsible-Changed-When: Thu May 9 04:11:44 PDT 1996 
Responsible-Changed-Why:  
Hi Mike, this looks like the man is right, care to deal with it ? 
Responsible-Changed-From-To: mpp->freebsd-bugs 
Responsible-Changed-By: steve 
Responsible-Changed-When: Sat Aug 16 16:12:23 PDT 1997 
Responsible-Changed-Why:  
It seems mp is no longer going to work on this one. 
State-Changed-From-To: open->closed 
State-Changed-By: steve 
State-Changed-When: Sat Aug 16 16:16:19 PDT 1997 
State-Changed-Why:  
Fixed by joerg in hardware.sgml revision 1.7. 
>Unformatted:
