From owner-svn-src-head@freebsd.org Tue Jul 10 22:53:08 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 8EE33103880B; Tue, 10 Jul 2018 22:53:08 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 437B1706B3; Tue, 10 Jul 2018 22:53:08 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 24BE52451; Tue, 10 Jul 2018 22:53:08 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w6AMr7mm065734; Tue, 10 Jul 2018 22:53:07 GMT (envelope-from rmacklem@FreeBSD.org) Received: (from rmacklem@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w6AMr73t065733; Tue, 10 Jul 2018 22:53:07 GMT (envelope-from rmacklem@FreeBSD.org) Message-Id: <201807102253.w6AMr73t065733@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: rmacklem set sender to rmacklem@FreeBSD.org using -f From: Rick Macklem Date: Tue, 10 Jul 2018 22:53:07 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r336183 - head/usr.sbin/nfsd X-SVN-Group: head X-SVN-Commit-Author: rmacklem X-SVN-Commit-Paths: head/usr.sbin/nfsd X-SVN-Commit-Revision: 336183 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 10 Jul 2018 22:53:08 -0000 Author: rmacklem Date: Tue Jul 10 22:53:07 2018 New Revision: 336183 URL: https://svnweb.freebsd.org/changeset/base/336183 Log: Update the pnfs(4) man page. This is a content change. Modified: head/usr.sbin/nfsd/pnfs.4 Modified: head/usr.sbin/nfsd/pnfs.4 ============================================================================== --- head/usr.sbin/nfsd/pnfs.4 Tue Jul 10 22:00:20 2018 (r336182) +++ head/usr.sbin/nfsd/pnfs.4 Tue Jul 10 22:53:07 2018 (r336183) @@ -23,7 +23,7 @@ .\" .\" $FreeBSD$ .\" -.Dd March 26, 2018 +.Dd July 10, 2018 .Dt PNFS 4 .Os .Sh NAME @@ -67,7 +67,8 @@ It is for a byte range of a file and is either Read or For the FreeBSD server, a layout covers all bytes of a file. A layout may be recalled by the MDS using a LayoutRecall callback. When a client returns a layout via the LayoutReturn operation it can -indicate that error(s) were encountered while doing I/O on the DS. +indicate that error(s) were encountered while doing I/O on the DS, +at least for certain layout types such as the Flexible File Layout. .Pp The FreeBSD client and server supports two layout types. .Pp @@ -94,7 +95,9 @@ For a non-mirrored configuration, the FreeBSD server w layouts by default. However that default can be set to the Flexible File Layout by setting the .Xr sysctl 1 -sysctl ``vfs.nfsd.default_flexfile'' to one. +sysctl +.Dq vfs.nfsd.default_flexfile +to one. Mirrored server configurations will only issue Flexible File Layouts. .Tn pNFS clients mount the MDS as they would a single NFS server. @@ -115,14 +118,14 @@ Each of these files will also have two extended attrib attribute name space: .Bd -literal -offset indent pnfsd.dsfile - This extended attrbute stores the information that the - MDS needs to find the data file on a DS for this file. + MDS needs to find the data file on a DS(s) for this file. pnfsd.dsattr - This extended attribute stores the Size, AccessTime, ModifyTime and Change attributes for the file. .Ed .Pp For each regular (VREG) file, the MDS creates a data file on one (or on N of them for the mirrored case, where N is the mirror_level) -of the DSs where the file's data will be stored. +of the DS(s) where the file's data will be stored. The name of this file is the file handle of the file on the MDS in hexadecimal at time of file creation. The data file will have the same file ownership, mode and NFSv4 ACL @@ -143,6 +146,17 @@ For the non-pNFS aware client, the MDS will perform I/ a proxy for the non-pNFS aware client. This is also true for NFSv3 and NFSv4.0 mounts, since these are always non-pNFS aware. +.Pp +It is possible to assign a DS to an MDS exported file system so that it will +store data for files on the MDS exported file system. +If a DS is not assigned to an MDS exported file system, it will store data +for files on all exported file systems on the MDS. +.Pp +If mirroring is enabled, the pNFS service will continue to function when +DS(s) have failed, so long is there is at least one DS still operational +that stores data for files on all of the MDS exported file systems. +After a disabled mirrored DS is repaired, it is possible to recover the DS +as a mirror while the pNFS service continues to function. .Pp See .Bd -literal -offset indent