Index: projects/pnfs-planb-server-stable11/usr.bin/pnfsdsfile/pnfsdsfile.1
===================================================================
--- projects/pnfs-planb-server-stable11/usr.bin/pnfsdsfile/pnfsdsfile.1	(revision 320030)
+++ projects/pnfs-planb-server-stable11/usr.bin/pnfsdsfile/pnfsdsfile.1	(revision 320031)
@@ -1,55 +1,75 @@
 .\" Copyright (c) 2017 Rick Macklem
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd April 1, 2017
 .Dt PNFSDSFILE 1
 .Os
 .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 ,
 .Xr nfsd 8
 .Sh HISTORY
 The
 .Nm
 command appeared in FreeBSD12.