From owner-freebsd-doc  Tue Aug 27  5:20:20 2002
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id C260637B405
	for <freebsd-doc@hub.freebsd.org>; Tue, 27 Aug 2002 05:20:08 -0700 (PDT)
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E634543E6A
	for <freebsd-doc@hub.freebsd.org>; Tue, 27 Aug 2002 05:20:02 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.4/8.12.4) with ESMTP id g7RCK2JU080499
	for <freebsd-doc@freefall.freebsd.org>; Tue, 27 Aug 2002 05:20:02 -0700 (PDT)
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.4/8.12.4/Submit) id g7RCK2ch080498;
	Tue, 27 Aug 2002 05:20:02 -0700 (PDT)
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id A2AB237B400
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 27 Aug 2002 05:15:18 -0700 (PDT)
Received: from www.example.org (dhcp-nic-val-26-61.cisco.com [64.103.26.61])
	by mx1.FreeBSD.org (Postfix) with SMTP id 3334A43E6E
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 27 Aug 2002 05:15:12 -0700 (PDT)
	(envelope-from molter@tin.it)
Received: (qmail 2519 invoked by uid 1000); 27 Aug 2002 12:15:05 -0000
Message-Id: <20020827121505.2518.qmail@cobweb.example.org>
Date: Tue, 27 Aug 2002 14:15:05 +0200
From: Marco Molteni <molter@tin.it>
To: FreeBSD-gnats-submit@FreeBSD.org
Subject: docs/42076: diskless.8 man page unsafe example
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


>Number:         42076
>Category:       docs
>Synopsis:       diskless.8 man page unsafe example
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Aug 27 05:20:01 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator:     Marco Molteni
>Release:        FreeBSD 4.6-RELEASE i386
>Organization:
Citello Networks
>Environment:
System: FreeBSD cobweb.example.org 4.6-RELEASE

>Description:

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

   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.


>How-To-Repeat:
	man diskless

>Fix:

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


--- 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
>Release-Note:
>Audit-Trail:
>Unformatted:

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