misc/126806: exports documentation incorrect or

[Garrett Cooper]

On Aug 24, 2008, at 3:30 PM, Manolis Kiagias wrote:

> The following reply was made to PR misc/126806; it has been noted by  
> GNATS.
>
> From: Manolis Kiagias <sonic2000gr at gmail.com>
> To: Garrett Cooper <gcooper at FreeBSD.org>
> Cc: freebsd-gnats-submit at FreeBSD.org
> Subject: Re: misc/126806: exports documentation incorrect or
> Date: Mon, 25 Aug 2008 01:05:53 +0300
>
> Garrett Cooper wrote:
>>
>> optimus# cat /etc/exports
>> /scratch	-alldirs -maproot=nobody
>> /store		-alldirs -maproot=nobody
>> /var /usr	-alldirs -maproot=nobody
>>
>> What I got however was /var and /usr aren't being exported:
>>
>> optimus# showmount -e
>> Exports list on localhost:
>> /store                             Everyone
>> /scratch                           Everyone
>>
>> According to /var/log/messages from syslog it was a bad "line" in  
>> exports:
>>
>> Aug 24 14:28:00 optimus mountd[686]: bad exports list line /var /usr
>>
>>
> The problem is that you are trying to export *two different*  
> filesystems
> in one line:
>
> /var /usr    -alldirs -maproot=nobody
>
> Have a better look at  the man page:
>
> "In a mount entry, the first field(s) specify the directory path(s)  
> within
>  a server file system that can be mounted on by the corresponding
>  client(s)"
>
> The above would not work on a typical FreeBSD setup, where /usr and / 
> var
> are different filesystems
> The example in the man page correctly shows two different mount points
> inside the *same* filesystem:
>
> /usr  /usr/local  -maproot=0:10 friends
>
> If you were to write this as two different lines, it would work:
>
> /var   -alldirs -maproot=nobody
> /usr  -alldirs  -maproot=nobody
>
> I don't see a documentation problem here.

Ok, now I see what you / the manpage meant. Trying my experiment again:

optimus# cat /etc/exports
/scratch	-alldirs -maproot=nobody
/store		-alldirs -maproot=nobody
/boot /etc	-maproot=nobody
optimus# killall -HUP mountd
optimus# showmount -e
Exports list on localhost:
/store                             Everyone
/scratch                           Everyone
/etc                               Everyone
/boot                              Everyone

Things work as expected. Maybe something should be mentioned in the  
manpage (comment to the EXAMPLES section under that item).

Sometimes people go straight to the examples without reading the full  
text.

Posting a diff with comments soon.

-Garrett