From owner-freebsd-bugs  Mon Feb 12 20:10:05 1996
Return-Path: owner-bugs
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.3/8.7.3) id UAA29404
          for bugs-outgoing; Mon, 12 Feb 1996 20:10:05 -0800 (PST)
Received: (from gnats@localhost)
          by freefall.freebsd.org (8.7.3/8.7.3) id UAA29380
          Mon, 12 Feb 1996 20:10:02 -0800 (PST)
Resent-Date: Mon, 12 Feb 1996 20:10:02 -0800 (PST)
Resent-Message-Id: <199602130410.UAA29380@freefall.freebsd.org>
Resent-From: gnats (GNATS Management)
Resent-To: freebsd-bugs
Resent-Reply-To: FreeBSD-gnats@freefall.FreeBSD.org,
        jdowdal@destiny.dorm.umd.edu
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
X-Send-Pr-Version: 3.2
Subject: docs/1023: Error in handbook wrt creating NFS swap 
Sender: owner-bugs@freebsd.org
Precedence: bulk


>Number:         1023
>Category:       docs
>Synopsis:       using touch to create swap file for NFS doesn't work
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          open
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Feb 12 20:10:01 PST 1996
>Last-Modified:
>Originator:     John Dowdal
>Organization:
UMD
>Release:        FreeBSD 2.1.0-STABLE i386
>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
	
	

>Audit-Trail:
>Unformatted: