From owner-freebsd-fs@FreeBSD.ORG Mon Jul 11 23:55:24 2011 Return-Path: Delivered-To: freebsd-fs@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 33E0D1065672 for ; Mon, 11 Jul 2011 23:55:24 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-2.mit.edu (DMZ-MAILSEC-SCANNER-2.MIT.EDU [18.9.25.13]) by mx1.freebsd.org (Postfix) with ESMTP id DC20E8FC13 for ; Mon, 11 Jul 2011 23:55:23 +0000 (UTC) X-AuditID: 1209190d-b7bdeae0000004f8-9a-4e1b8d11e9f8 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-2.mit.edu (Symantec Messaging Gateway) with SMTP id E5.CC.01272.11D8B1E4; Mon, 11 Jul 2011 19:53:53 -0400 (EDT) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id p6BNtMcR013177; Mon, 11 Jul 2011 19:55:22 -0400 Received: from multics.mit.edu (MULTICS.MIT.EDU [18.187.1.73]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id p6BNtLia029488 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 11 Jul 2011 19:55:22 -0400 (EDT) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id p6BNtKu8020213; Mon, 11 Jul 2011 19:55:20 -0400 (EDT) Date: Mon, 11 Jul 2011 19:55:20 -0400 (EDT) From: Benjamin Kaduk To: Rick Macklem In-Reply-To: <10589627.445480.1310418556785.JavaMail.root@erie.cs.uoguelph.ca> Message-ID: References: <10589627.445480.1310418556785.JavaMail.root@erie.cs.uoguelph.ca> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrDIsWRmVeSWpSXmKPExsUixCmqrSvYK+1nMOGllMWxxz/ZLB4uu8bk wOQx49N8Fo/fm/cyBTBFcdmkpOZklqUW6dslcGUsOjCRtWCPRMWu9auYGhi3CHcxcnBICJhI XP1W1cXICWSKSVy4t56ti5GLQ0hgH6PEvvUvWSCcDYwSJ58eh3IOMEnsnTuNHcJpYJR4cGQe M0g/i4C2xJzL25lAbDYBFYmZbzaygdgiAuoSm1f3g9UwA9lXD/1mBLGFBYwlDm3ZxQZyBqeA n8SThwogYV4BB4lPS0+AlQgJ+Er8OTcTzBYV0JFYvX8KC0SNoMTJmU9YIEZaSvxb+4t1AqPg LCSpWUhSCxiZVjHKpuRW6eYmZuYUpybrFicn5uWlFuka6eVmluilppRuYgQHqiTvDsZ3B5UO MQpwMCrx8K6WlvYTYk0sK67MPcQoycGkJMr7qwsoxJeUn1KZkVicEV9UmpNafIhRgoNZSYQ3 pBYox5uSWFmVWpQPk5LmYFES51Xz/u8rJJCeWJKanZpakFoEk5Xh4FCS4H3RA9QoWJSanlqR lplTgpBm4uAEGc4DNHwhSA1vcUFibnFmOkT+FKOilDjvF5CEAEgiozQPrheWSF4xigO9Isz7 EaSKB5iE4LpfAQ1mAhr8WloSZHBJIkJKqoHx3OybRc2J8osjb/xZrpzy879WWczbKObVHkfr GHL3GU8zfHzkm8WiDwu2L7v9zcxA0Vnvy5p9lxsVs5yOt3ce2afw9ssmzYyZDRMbe0uC/vQ4 6cXF5797VXQs/kDOxVl777n4hH19wO61PVFT4nLc2rsnPku5lXzLU3l8dQ2P/6kzt8tZ3lX9 UmIpzkg01GIuKk4EAI2Vo1r/AgAA Cc: FreeBSD FS Subject: Re: request for review of exports.5 update X-BeenThere: freebsd-fs@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Filesystems List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 11 Jul 2011 23:55:24 -0000 Hi Rick, On Mon, 11 Jul 2011, Rick Macklem wrote: > Hi, > > I've added a few sentences to the exports.5 man page in an effort > to try and clarify how NFSv4 exports work. > > If anyone would like to comment on these changes, it would be > appreciated. Ideally, you are familiar with the FreeBSD /etc/exports > file, but not w.r.t. NFSv4. > > The diff is at: > http://people.freebsd.org/~rmacklem/exports.5.diff > > in case you can't handle looking at the following. (The email > system I use loves to mess with whitespace, etc.) > > Index: usr.sbin/mountd/exports.5 > =================================================================== > --- usr.sbin/mountd/exports.5 (revision 223937) > +++ usr.sbin/mountd/exports.5 (working copy) > @@ -28,7 +28,7 @@ > .\" @(#)exports.5 8.3 (Berkeley) 3/29/95 > .\" $FreeBSD$ > .\" > -.Dd December 3, 2009 > +.Dd July 11, 2011 > .Dt EXPORTS 5 > .Os > .Sh NAME > @@ -72,6 +72,12 @@ > There are three forms of this specification. > The first is to list all mount points as absolute > directory paths separated by whitespace. > +This list of directory paths should be considered an > +``administrative control'', since it only enforced by the This wants to be ===== .Dq administrative control , since it is only enforced by the ===== (note the "is" as well as the Dq macro) > +.Xr mountd 8 > +daemon and not the kernel. > +As such, it only applies to NFSv2, NFSv3 mounts and only w.r.t. the The comma between v2 and v3 is not really right and should be replaced by "and"; the mdoc gurus seem to want to put the trailing "the" on the next line in a case like this. > +client's use of the mount protocol. > The second is to specify the pathname of the root of the file system > followed by the > .Fl alldirs > @@ -81,8 +87,19 @@ > .Fl r > option is used on > .Xr mountd 8 . > +For NFSv4, since the ``administrative controls'' are not applied The Dq macro should be used here as well. > +because NFSv4 does not use the mount protocol, > +all of the above export line(s) should be considered to have the > +.Fl alldirs > +flag, even if the line is specified without it. > The third form has the string ``V4:'' followed by a single absolute path > name, to specify the NFSv4 tree root. > +This line does not export any file system, but simply marks where the root > +of the server's directory tree is for NFSv4 clients. > +The exported file systems for NFSv4 are specified via the other lines > +in the > +.Xr exports 5 > +file in the same way as for NFSv2, NFSv3. I must confess that this chunk leaves me slightly confused. Does the V4 server export everything starting from the root of its export, or must subdirectories/filesystems be specified as well? Thanks, Ben Kaduk > The pathnames must not have any symbolic links in them and should not have > any > .Dq Pa \&. > _______________________________________________ > freebsd-fs@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-fs > To unsubscribe, send any mail to "freebsd-fs-unsubscribe@freebsd.org" >