From molter@tin.it  Tue Aug 27 05:15:18 2002
Return-Path: <molter@tin.it>
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: diskless.8 man page unsafe example

>Number:         42076
>Category:       docs
>Synopsis:       diskless.8 man page unsafe example
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Aug 27 05:20:01 PDT 2002
>Closed-Date:    Tue Oct 01 19:07:52 PDT 2002
>Last-Modified:  Tue Oct 01 19:07:52 PDT 2002
>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:
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Tue Oct 1 19:07:11 PDT 2002 
State-Changed-Why:  
Committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=42076 
>Unformatted:
