From owner-svn-src-projects@freebsd.org Mon Jul 9 21:29:24 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 4191A1032552 for ; Mon, 9 Jul 2018 21:29:24 +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 E68FF88AD4; Mon, 9 Jul 2018 21:29:23 +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 C2F7A1A754; Mon, 9 Jul 2018 21:29:23 +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 w69LTNMg071535; Mon, 9 Jul 2018 21:29:23 GMT (envelope-from rmacklem@FreeBSD.org) Received: (from rmacklem@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w69LTN93071534; Mon, 9 Jul 2018 21:29:23 GMT (envelope-from rmacklem@FreeBSD.org) Message-Id: <201807092129.w69LTN93071534@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: rmacklem set sender to rmacklem@FreeBSD.org using -f From: Rick Macklem Date: Mon, 9 Jul 2018 21:29:23 +0000 (UTC) To: src-committers@freebsd.org, svn-src-projects@freebsd.org Subject: svn commit: r336147 - projects/pnfs-planb-server/usr.bin/pnfsdskill X-SVN-Group: projects X-SVN-Commit-Author: rmacklem X-SVN-Commit-Paths: projects/pnfs-planb-server/usr.bin/pnfsdskill X-SVN-Commit-Revision: 336147 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.27 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: Mon, 09 Jul 2018 21:29:24 -0000 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 .