From owner-svn-src-all@FreeBSD.ORG Tue Jul 26 20:51:59 2011 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 689531065670; Tue, 26 Jul 2011 20:51:59 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 3DC1F8FC12; Tue, 26 Jul 2011 20:51:59 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id p6QKpx7R025930; Tue, 26 Jul 2011 20:51:59 GMT (envelope-from rmacklem@svn.freebsd.org) Received: (from rmacklem@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id p6QKpxm8025928; Tue, 26 Jul 2011 20:51:59 GMT (envelope-from rmacklem@svn.freebsd.org) Message-Id: <201107262051.p6QKpxm8025928@svn.freebsd.org> From: Rick Macklem Date: Tue, 26 Jul 2011 20:51:59 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-8@freebsd.org X-SVN-Group: stable-8 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r224461 - stable/8/usr.sbin/mountd X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 26 Jul 2011 20:51:59 -0000 Author: rmacklem Date: Tue Jul 26 20:51:58 2011 New Revision: 224461 URL: http://svn.freebsd.org/changeset/base/224461 Log: MFC: r223954 Try and fix the exports.5 man page so that it clarifies how NFSv4 exports are handled. Improved by comments from mckusick, kudak at mit.edu and bde. This is a content change. Modified: stable/8/usr.sbin/mountd/exports.5 Directory Properties: stable/8/usr.sbin/mountd/ (props changed) Modified: stable/8/usr.sbin/mountd/exports.5 ============================================================================== --- stable/8/usr.sbin/mountd/exports.5 Tue Jul 26 19:05:59 2011 (r224460) +++ stable/8/usr.sbin/mountd/exports.5 Tue Jul 26 20:51:58 2011 (r224461) @@ -28,7 +28,7 @@ .\" @(#)exports.5 8.3 (Berkeley) 3/29/95 .\" $FreeBSD$ .\" -.Dd June 30, 2008 +.Dd July 12, 2011 .Dt EXPORTS 5 .Os .Sh NAME @@ -72,6 +72,13 @@ that can be mounted on by the correspond 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 +.Dq administrative control , +since it is only enforced by the +.Xr mountd 8 +daemon and not the kernel. +As such, it only applies to NFSv2 and NFSv3 mounts and only +with respect to the 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 +88,21 @@ including regular files if the .Fl r option is used on .Xr mountd 8 . +Because NFSv4 does not use the mount protocol, +the +.Dq administrative controls +are not applied. +Thus, all 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 and NFSv3. The pathnames must not have any symbolic links in them and should not have any .Dq Pa \&.