Received-SPF: pass (google.com: domain of linux-nfs-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
Date:   Tue, 7 Jul 2020 11:51:22 -0400
From:   "J. Bruce Fields" <bfields@fieldses.org>
To:     Patrick Goetz <pgoetz@math.utexas.edu>
Cc:     linux-nfs@vger.kernel.org
Subject: Re: kerberized NFSv4 client reporting operation not permitted when
 mounting with sec=sys
Message-ID: <20200707155122.GA26678@fieldses.org>
References: <0593b4af8ca3fafbec59655bbb39d2b4@kngnt.org>
 <9e25861022acb796c35d3adb392bf4c4@kngnt.org>
 <c058f370-9f7c-146d-e7e6-a3f88b62cbc4@oracle.com>
 <4097833.BOCuNxM56l@polaris>
 <20200706171804.GA31789@fieldses.org>
 <4fe2af1f-917e-c1e4-f5e6-05eb0c121511@math.utexas.edu>
 <20200706202712.GA32161@fieldses.org>
 <b96b9bdd-3fbd-2e54-c036-fb8813287ca2@math.utexas.edu>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <b96b9bdd-3fbd-2e54-c036-fb8813287ca2@math.utexas.edu>
User-Agent: Mutt/1.5.21 (2010-09-15)
Sender: linux-nfs-owner@vger.kernel.org
Precedence: bulk

On Tue, Jul 07, 2020 at 10:10:07AM -0500, Patrick Goetz wrote:
> 
> 
> On 7/6/20 3:27 PM, J. Bruce Fields wrote:
> >On Mon, Jul 06, 2020 at 02:57:52PM -0500, Patrick Goetz wrote:
> >>On 7/6/20 12:18 PM, J. Bruce Fields wrote:
> >>>
> >>>Note, by the way, that fsid=0 thing was required for nfsv4 exports years
> >>>ago, but no longer is.  It's usually better not to bother with that.
> >>
> >>Are we ever going to get some solid up-to-date NFSv4/pNFS
> >>documentation?  I'm sufficiently frustrated to write it myself, but
> >>am not 100% sure where to start.
> >
> >I guess the places I'd start would be the man pages (original source is
> >nfs-utils, git://linux-nfs.org/~steved/nfs-utils) or wiki.linux-nfs.org.
> >
> >But, I don't know, you may be in a better place to position to know what
> >gaps you want filled--where are you looking for documentation, and what
> >are you not finding?
> >
> >--b.
> >
> 
> Well, a good example is the fsid=0 thing. Where is it documented
> that this is no longer needed?  I'm 100% certain I've read through
> all the man pages I could find several times.

For man pages, this belongs in exports(5).  Looks like the description
of the "fsid" option in exports(5) is out of date.

Might also be worth googling around to see if there are some HOWTO's out
there that could be updated.

You can find out when the change was made by grepping for
"NFSEXP_V4ROOT" in kernel and nfs-utils source.  Looks like it was 2009,
kernel and nfs-utils versions 2.6.33 and 1.2.2 respectively.

--b.