svn commit: r336147 - projects/pnfs-planb-server/usr.bin/pnfsdskill

[Rick Macklem]

Author: rmacklem
Date: Mon Jul  9 21:29:23 2018
New Revision: 336147
URL: https://svnweb.freebsd.org/changeset/base/336147

Log:
  Document the "-f" flag for pnfsdskill(1).

Modified:
  projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1

Modified: projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1
==============================================================================
--- projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1	Mon Jul  9 21:13:21 2018	(r336146)
+++ projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1	Mon Jul  9 21:29:23 2018	(r336147)
@@ -23,7 +23,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd March 9, 2018
+.Dd July 9, 2018
 .Dt PNFSDSKILL 1
 .Os
 .Sh NAME
@@ -32,6 +32,7 @@
 disables a pNFS data storage server (DS)
 .Sh SYNOPSIS
 .Nm
+.Op Fl f
 .Ar mounted-on-DS-dir
 .Sh DESCRIPTION
 The
@@ -42,7 +43,19 @@ may use this command on the metadata server (MDS) to d
 This command must be used on the MDS and the
 .Ar mounted-on-DS-dir
 must be the exact pathname used when mounting the DS on the MDS.
+Normally this command will fail if there is no valid mirror for the DS
+available.
 .Pp
+The following option is available:
+.Bl -tag -width Ds
+.It Fl f
+This option forces the DS to be disabled even if there is no valid mirror
+for the DS available.
+It should only be used to allow the
+.Xr nfsd 8
+threads to be terminated.
+.El
+.Pp
 If this command fails with
 .Dq Device not configured
 (ENXIO), it probably
@@ -61,4 +74,5 @@ operational DSs is at least as many as the level of mi
 .Sh HISTORY
 The
 .Nm
-command appeared in FreeBSD12.
+command first appeared in
+.Fx 12.0 .