From owner-freebsd-doc  Fri Aug 16  7:15:19 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 8B95E37B405
	for <freebsd-doc@freebsd.org>; Fri, 16 Aug 2002 07:15:15 -0700 (PDT)
Received: from www.example.org (dhcp-nic-val-26-81.cisco.com [64.103.26.81])
	by mx1.FreeBSD.org (Postfix) with SMTP id E5DDB43E70
	for <freebsd-doc@freebsd.org>; Fri, 16 Aug 2002 07:15:08 -0700 (PDT)
	(envelope-from molter@tin.it)
Received: (qmail 33144 invoked by uid 1000); 16 Aug 2002 14:15:04 -0000
Message-ID: <20020816141504.33143.qmail@cobweb.example.org>
Date: Fri, 16 Aug 2002 16:15:04 +0200
From: Marco Molteni <molter@tin.it>
To: freebsd-doc@freebsd.org
Subject: diskless.8 manpage unsafe example
X-Mailer: Sylpheed version 0.8.1 (GTK+ 1.2.10; i386-portbld-freebsd4.6)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

[Please keep me in the CC list as I am not subscribed to -doc]

In the diskless.8 man page there is an example that contradicts the text:

     o   an NFS server which exports a root and /usr partition with appropri-
         ate permissions.  The rc.diskless{1,2} scripts work with readonly
         partitions, as long as root is exported with -maproot=0 so that some
         system files can be accessed.  As an example, /etc/exports can con-
         tain the following lines:

               <ROOT> -maproot=0 -alldirs <list of diskless clients>
               /usr -alldirs <list of diskless clients>


you see? It says to export the partitions readonly, but the example
exports them read-write! The manpage is the same on stable and current.

Following patch fixes this. Checked with the various docs in
/usr/share/examples/diskless/

marco

--- diskless.8.orig     Fri Aug 16 16:09:16 2002
+++ diskless.8  Fri Aug 16 16:09:55 2002
@@ -101,8 +101,8 @@
 .Pa /etc/exports
 can contain the following lines:
 .Bd -literal -offset indent
-<ROOT> -maproot=0 -alldirs <list of diskless clients>
-/usr -alldirs <list of diskless clients>
+<ROOT> -ro -maproot=0 -alldirs <list of diskless clients>
+/usr -ro -alldirs <list of diskless clients>
 .Ed
 .Pp
 where

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message