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

[Rick Macklem]

Author: rmacklem
Date: Fri Apr 20 22:41:40 2018
New Revision: 332847
URL: https://svnweb.freebsd.org/changeset/base/332847

Log:
  Add the pnfsdskill command that can be used on the MDS to disable a mirrored
  DS.

Added:
  projects/pnfs-planb-server/usr.bin/pnfsdskill/
  projects/pnfs-planb-server/usr.bin/pnfsdskill/Makefile   (contents, props changed)
  projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1   (contents, props changed)
  projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.c   (contents, props changed)

Added: projects/pnfs-planb-server/usr.bin/pnfsdskill/Makefile
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ projects/pnfs-planb-server/usr.bin/pnfsdskill/Makefile	Fri Apr 20 22:41:40 2018	(r332847)
@@ -0,0 +1,5 @@
+# $FreeBSD$
+
+PROG=	pnfsdskill
+
+.include <bsd.prog.mk>

Added: projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.1	Fri Apr 20 22:41:40 2018	(r332847)
@@ -0,0 +1,61 @@
+.\" Copyright (c) 2018 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 March 9, 2018
+.Dt PNFSDSKILL 1
+.Os
+.Sh NAME
+.Nm pnfsdskill
+.Nd
+disables a pNFS data storage server (DS)
+.Sh SYNOPSIS
+.Nm
+.Ar mounted_on_path_of_DS
+.Sh DESCRIPTION
+The
+.Nm
+command disables one mirror of a mirrored set of DSs.
+Two or more DSs may be configured as a mirrored set.
+If one of these mirrored DSs is malfunctioning, a system administrator
+may use this command on the metadata server (MDS) to disable use of this mirror.
+This command must be used on the MDS and the
+.Ar mounted_on_path_of_DS
+must be the exact pathname used when mounting the DS on the MDS.
+.Pp
+If this command fails with ``Device not configured'' (ENXIO), it probably
+means that the DS has already been disabled due to an error either detected
+by the MDS or reported to the MDS by a client.
+.El
+.Sh SEE ALSO
+.Xr pnfsdscopymr 1 ,
+.Xr pnfsdsfile 1 ,
+.Xr nfsv4 4 ,
+.Xr pnfs 4
+.Xr nfsd 8
+.Sh HISTORY
+The
+.Nm
+command appeared in FreeBSD12.

Added: projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.c
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ projects/pnfs-planb-server/usr.bin/pnfsdskill/pnfsdskill.c	Fri Apr 20 22:41:40 2018	(r332847)
@@ -0,0 +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.
+ *
+ */
+
+#include <sys/cdefs.h>
+__FBSDID("$FreeBSD$");
+
+#include <err.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <netdb.h>
+#include <arpa/inet.h>
+#include <netinet/in.h>
+#include <nfs/nfssvc.h>
+
+#include <fs/nfs/nfsproto.h>
+#include <fs/nfs/nfskpiport.h>
+#include <fs/nfs/nfs.h>
+
+static void usage(void);
+
+/*
+ * This program disables use of a DS mirror.  The "dspath" command line
+ * argument must be an exact match for the mounted-on path of the DS.
+ * It should be done before any forced dismount is performed on the path
+ * and should work even when the mount point is hung.
+ */
+int
+main(int argc, char *argv[])
+{
+	struct nfsd_pnfsd_args pnfsdarg;
+
+	if (argc != 2)
+		usage();
+	if (geteuid() != 0)
+		errx(1, "Must be run as root/su");
+
+	pnfsdarg.op = PNFSDOP_DELDSSERVER;
+	pnfsdarg.dspath = argv[1];
+	if (nfssvc(NFSSVC_PNFSDS, &pnfsdarg) < 0)
+		err(1, "Can't kill %s", argv[1]);
+}
+
+static void
+usage(void)
+{
+
+	fprintf(stderr, "pnfsdsfile [filepath]\n");
+	exit(1);
+}
+