From owner-freebsd-doc  Sat Dec 16 16:53:18 2000
From owner-freebsd-doc@FreeBSD.ORG  Sat Dec 16 16:53:15 2000
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mailhost01.reflexnet.net (mailhost01.reflexnet.net [64.6.192.82])
	by hub.freebsd.org (Postfix) with ESMTP id 8F5EF37B400
	for <doc@freebsd.org>; Sat, 16 Dec 2000 16:53:15 -0800 (PST)
Received: from rfx-64-6-211-149.users.reflexcom.com ([64.6.211.149]) by mailhost01.reflexnet.net  with Microsoft SMTPSVC(5.5.1877.197.19);
	 Sat, 16 Dec 2000 16:51:35 -0800
Received: (from cjc@localhost)
	by rfx-64-6-211-149.users.reflexcom.com (8.11.0/8.11.0) id eBH0r6c88910
	for doc@freebsd.org; Sat, 16 Dec 2000 16:53:06 -0800 (PST)
	(envelope-from cjc)
Date: Sat, 16 Dec 2000 16:53:05 -0800
From: "Crist J. Clark" <cjclark@reflexnet.net>
To: doc@freebsd.org
Subject: NFS FAQ Entry
Message-ID: <20001216165305.A88791@rfx-64-6-211-149.users.reflexco>
Reply-To: cjclark@alum.mit.edu
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 1.0i
Sender: cjc@rfx-64-6-211-149.users.reflexcom.com
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

I recently answered an NFS question on the -questions list that I have
responded to what seems like about, oh, 50 times, in the last two
years. Someone suggested a FAQ entry might be in order. I don't
have the doc sources, but here is a plain-text stab at an entry. I
think it would fit well in with FAQ items, 9.10, 9.11, and 9.12.

9.12 1/2. Why does mountd keep telling me it "can't change attributes"
          and that I have a "bad exports list" on my FreeBSD NFS
          server?

  The most frequent problem is not understanding this,

       Each line in the file (other than comment lines that begin with a #)
       specifies the mount point(s) and export flags within one local server
       filesystem for one or more hosts.  A host may be specified only once for
       each local filesystem on the server and there may be only one default en-
       try for each server filesystem that applies to all other hosts.

  Passage from the exports(5) manpage correctly.

  This is made more clear by an example of a common mistake. If
  everything above /usr is part of one filesystem (there are no mounts
  above /usr) the following exports list,

    /usr/src   client
    /usr/ports client

  Is not valid. There are two lines specifying properties for one
  filesystem, /usr, exported to the same host, client. The correct 
  format is,

    /usr/src /usr/ports  client

  To rephrase the passage from the manpage, the properties of one
  filesystem exported to a given host (world-wide exports are treated
  like another unique host) must all occur on one line. And yes, this
  does cause limitiation in how you can export filesystems without
  ugly workarounds, but for most people, this is not an issue.

  The following is an example of a valid export list (where /usr and
  /exports are local, server filesystems),

    # Export src and ports to client01 and client02, but only
    # client01 has root privileges on it
    /usr/src /usr/ports -maproot=0	client01
    /usr/src /usr/ports			client02
    # The "client" machines have root and can mount anywhere
    # up /exports. The world can mount /exports/obj read-only 
    /exports -alldirs -maproot=0	client01 client02
    /exports/obj -ro

It's kind of long, and I have no problem adding more.

Anyone think this is worth a FAQ entry? Been a while since I followed
-doc, this is the right place to discuss this? What do I need to do to
get it added? Anyone have an opinion of whether it is worth including?
Any editorial comments?

Thanks.
-- 
Crist J. Clark                           cjclark@alum.mit.edu


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