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>
next 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.
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20001216165305.A88791>