From owner-svn-src-projects@freebsd.org Sun Jun 3 18:17:12 2018 Return-Path: Delivered-To: svn-src-projects@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 1AE21FE87B3 for ; Sun, 3 Jun 2018 18:17:12 +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 DF5E873131; Sun, 3 Jun 2018 18:17: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 0103F221FB; Sun, 3 Jun 2018 18:17:07 +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 w53IH76u037661; Sun, 3 Jun 2018 18:17:07 GMT (envelope-from rmacklem@FreeBSD.org) Received: (from rmacklem@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w53IH7SS037660; Sun, 3 Jun 2018 18:17:07 GMT (envelope-from rmacklem@FreeBSD.org) Message-Id: <201806031817.w53IH7SS037660@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: rmacklem set sender to rmacklem@FreeBSD.org using -f From: Rick Macklem Date: Sun, 3 Jun 2018 18:17:07 +0000 (UTC) To: src-committers@freebsd.org, svn-src-projects@freebsd.org Subject: svn commit: r334575 - projects/pnfs-planb-server/usr.bin/pnfsdsfile X-SVN-Group: projects X-SVN-Commit-Author: rmacklem X-SVN-Commit-Paths: projects/pnfs-planb-server/usr.bin/pnfsdsfile X-SVN-Commit-Revision: 334575 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-projects@freebsd.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: "SVN commit messages for the src " projects" tree" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 03 Jun 2018 18:17:12 -0000 Author: rmacklem Date: Sun Jun 3 18:17:07 2018 New Revision: 334575 URL: https://svnweb.freebsd.org/changeset/base/334575 Log: Update the pnfsdsfile.1 man page to use the.Dq macro and to try and improve the description of what it does. Modified: projects/pnfs-planb-server/usr.bin/pnfsdsfile/pnfsdsfile.1 Modified: projects/pnfs-planb-server/usr.bin/pnfsdsfile/pnfsdsfile.1 ============================================================================== --- projects/pnfs-planb-server/usr.bin/pnfsdsfile/pnfsdsfile.1 Sun Jun 3 17:55:50 2018 (r334574) +++ projects/pnfs-planb-server/usr.bin/pnfsdsfile/pnfsdsfile.1 Sun Jun 3 18:17:07 2018 (r334575) @@ -30,30 +30,40 @@ .Sh NAME .Nm pnfsdsfile .Nd display -a pNFS data storage file's location(s) and/or modify the pnfsd.dsfile extended attribute for them +a pNFS data storage file's location(s) and/or modify the +.Dq pnfsd.dsfile +extended attribute for them .Sh SYNOPSIS .Nm .Op Fl qz .Op Fl s Ar dshostname .Op Fl c Ar old-dshostname,new-dshostname .Op Fl r Ar dshostname -.Ar file_on_MDS +.Ar mdsfile .Sh DESCRIPTION The .Nm command displays the data storage file's location(s) for a pNFS service and/or -modifies the pnfsd.dsfile extended attribute on the file. +modifies the +.Dq pnfsd.dsfile +extended attribute on the +.Ar mdsfile . A pNFS service maintains a data storage file for each regular file on -the MetaData Server(s) (MDS) on one or more of the Data Storage servers (DS). -If there is more than one DS, the DSs are a mirrored set and all of these -DSs should have copies of the -.Ar file_on_MDS -file's data. +the MetaData Server (MDS) on one or more of the Data Servers (DS). +If mirroring is enabled, the data storage file will be on more that one of the DSs. Unless command options are specified, this command displays the location(s) -of the DS file for the MDS file specified by the last command line argument. +of the data storage file for the MDS file +.Ar mdsfile . It must be used on the MDS and the -.Ar file_on_MDS +.Ar mdsfile must be a file on the exported local file system and not an NFSv4.1 mount. +This information is stored in the +.Dq pnfsd.dsfile +extended attribute for this +.Ar mdsfile . +The command line options allow the information in the +.Dq pnfsd.dsfile +extended attribute to be changed. .Pp The following options are available: .Bl -tag -width Ds @@ -87,14 +97,18 @@ This option sets the IP address of the extended attrib .Ar dshostname to 0.0.0.0 so that it will no longer be used. .Pp -This is meant to be used when one of a mirrored set of DSs has been -disabled so that this DS will not be used when it is re-enabled. +This is meant to be used when mirroring is enabled and the +.Ar dshostname +DS is disabled, so that it can be re-enabled once it is repaired. This needs to be done for all files in the exported MDS tree where -the data may not be up-to-date on the recovered DS when it is re-enabled. +the data may not be up-to-date on the repaired DS when it is re-enabled. After being re-enabled, the command .Xr pnfsdscopymr 1 -will be used to copy the the file's data to this DS and then update the extended -attribute to use it. +with the +.Dq -r +option +will be used to copy the the file's data to this repaired DS and then update the +extended attribute to use it. .Pp A typical use of this will be within a .Xr find 1