From owner-svn-src-projects@freebsd.org Fri Jun 16 22:05:31 2017 Return-Path: Delivered-To: svn-src-projects@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 34E40D8A47A for ; Fri, 16 Jun 2017 22:05:31 +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 mx1.freebsd.org (Postfix) with ESMTPS id EBD7571CD5; Fri, 16 Jun 2017 22:05:30 +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 v5GM5UM1088465; Fri, 16 Jun 2017 22:05:30 GMT (envelope-from rmacklem@FreeBSD.org) Received: (from rmacklem@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v5GM5UFU088464; Fri, 16 Jun 2017 22:05:30 GMT (envelope-from rmacklem@FreeBSD.org) Message-Id: <201706162205.v5GM5UFU088464@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: rmacklem set sender to rmacklem@FreeBSD.org using -f From: Rick Macklem Date: Fri, 16 Jun 2017 22:05:30 +0000 (UTC) To: src-committers@freebsd.org, svn-src-projects@freebsd.org Subject: svn commit: r320031 - projects/pnfs-planb-server-stable11/usr.bin/pnfsdsfile X-SVN-Group: projects 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.23 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: Fri, 16 Jun 2017 22:05:31 -0000 Author: rmacklem Date: Fri Jun 16 22:05:29 2017 New Revision: 320031 URL: https://svnweb.freebsd.org/changeset/base/320031 Log: Document the arguments added to pnfsdsfile. Modified: projects/pnfs-planb-server-stable11/usr.bin/pnfsdsfile/pnfsdsfile.1 Modified: projects/pnfs-planb-server-stable11/usr.bin/pnfsdsfile/pnfsdsfile.1 ============================================================================== --- projects/pnfs-planb-server-stable11/usr.bin/pnfsdsfile/pnfsdsfile.1 Fri Jun 16 21:48:42 2017 (r320030) +++ projects/pnfs-planb-server-stable11/usr.bin/pnfsdsfile/pnfsdsfile.1 Fri Jun 16 22:05:29 2017 (r320031) @@ -30,21 +30,41 @@ .Sh NAME .Nm pnfsdsfile .Nd display -a pNFS data storage file location +a pNFS data storage file location and/or modify the pnfsd.dsfile extended attribute for it .Sh SYNOPSIS .Nm +.Op Fl qz +.Op Fl s Ar dshostname .Ar metadata_file .Sh DESCRIPTION The .Nm -command displays the location of a data storage file for a pNFS service. +command displays the location of a data storage file for a pNFS service and/or +modifies the pnfsd.dsfile extended attribute on the file. A pNFS service maintains a data storage file for each regular file on the MetaData Server (MDS) on one of the Data Storage (DS) servers. -This command can be used on the MDS to find out where that data storage -file is. +Unless command options are specified, this command displays the location +of the DS file for the MDS file specified by the last command line argument. It must be used on the MDS and the .Ar metadata_file must be a file on the exported local file system and not an NFSv4.1 mount. +.Pp +The following options are available: +.Bl -tag -width Ds +.It Fl q +This option suppresses printing of the DS file's location. +.It Fl z +This option specifies that the file handle field of the pnfsd.dsfile +extended attribute is to filled with all zero bits. +This forces the pNFS MDS to do a Lookup RPC against the DS to acquire the file +handle to update it. +Normally this will only be necessary after the DS file has been recovered +from a backup, causing the file handle to change. +.It Fl s Ar dshostname +This option can be used with +.Fl z +so that the zeroing out of the file handle is only done if the DS server +is the one specified by this option. .El .Sh SEE ALSO .Xr nfsv4 4 ,