Date: Sat, 16 Dec 2000 18:33:32 -0800 From: Dima Dorfman <dima@bazooka.unixfreak.org> To: cjclark@alum.mit.edu Cc: doc@freebsd.org Subject: Re: NFS FAQ Entry Message-ID: <20001217023337.7742C3E09@bazooka.unixfreak.org> In-Reply-To: Message from "Crist J. Clark" <cjclark@reflexnet.net> of "Sat, 16 Dec 2000 16:53:05 PST." <20001216165305.A88791@rfx-64-6-211-149.users.reflexco>
next in thread | previous in thread | raw e-mail | index | archive | help
> 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. > <snip faq entry> > > 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 I do. In fact, I even took the time to mark it up! You can find the patch against book.sgml at the bottom of the message, and the preview of the rendered output at http://www.unixfreak.org/~dima/home/freebsd/data/FAQ/networking.html#EXPORTS-ERRORS > -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? Submitting a PR with the marked up version (see below) should speed up the commit process. And now, without further ado, here's the patch. The only modifications I made were to add the SGML markup, and to move around a few words to make it look a little better in a web browser. Regards -- Dima Dorfman <dima@unixfreak.org> Finger dima@unixfreak.org for PGP public key. Index: book.sgml =================================================================== RCS file: /st/src/FreeBSD/doc/en_US.ISO_8859-1/books/faq/book.sgml,v retrieving revision 1.129 diff -u -r1.129 book.sgml --- book.sgml 2000/12/05 13:18:16 1.129 +++ book.sgml 2000/12/17 02:20:16 @@ -7701,6 +7701,66 @@ </qandaentry> <qandaentry> + <question id="exports-errors"> + <para>Why does <command>mountd</command> keep telling me it + <quote>can't change attributes</quote> and that I have a + <quote>bad exports list</quote> on my FreeBSD NFS + server?</para> + </question> + + <answer> + <para>The most frequent problem is not understanding this + passage from the &man.exports.5 manual page + correctly:</para> + + <programlisting>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 entry for each server filesystem that applies to all other +hosts.</programlisting> + + <para>This is made more clear by an example of a common + mistake. If everything above <filename>/usr</filename> is + part of one filesystem (there are no mounts above + <filename>/usr</filename>) the following exports list is + not valid:</para> + + <programlisting>/usr/src client +/usr/ports client</programlisting> + + <para>There are two lines specifying properties for one + filesystem, <filename>/usr</filename>, exported to the + same host, <hostid>client</hostid>. The correct format + is:</para> + + <programlisting>/usr/src /usr/ports client</programlisting> + + <para>To rephrase the passage from the manual page, 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.</para> + + <para>The following is an example of a valid export list, + where <filename>/usr</filename> and + <filename>/exports</filename> are local + filesystems:</para> + + <programlisting># 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</programlisting> + </answer> + </qandaentry> + + <qandaentry> <question id="ppp-nextstep"> <para>I'm having problems talking PPP to NeXTStep machines.</para> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20001217023337.7742C3E09>