[Midnightbsd-cvs] src [10334] trunk/usr.sbin/sesutil: add sesutil(8)

laffer1 at midnightbsd.org laffer1 at midnightbsd.org
Sun Jun 3 15:55:32 EDT 2018


Revision: 10334
          http://svnweb.midnightbsd.org/src/?rev=10334
Author:   laffer1
Date:     2018-06-03 15:55:32 -0400 (Sun, 03 Jun 2018)
Log Message:
-----------
add sesutil(8)

Added Paths:
-----------
    trunk/usr.sbin/sesutil/
    trunk/usr.sbin/sesutil/Makefile
    trunk/usr.sbin/sesutil/eltsub.c
    trunk/usr.sbin/sesutil/eltsub.h
    trunk/usr.sbin/sesutil/sesutil.8
    trunk/usr.sbin/sesutil/sesutil.c

Added: trunk/usr.sbin/sesutil/Makefile
===================================================================
--- trunk/usr.sbin/sesutil/Makefile	                        (rev 0)
+++ trunk/usr.sbin/sesutil/Makefile	2018-06-03 19:55:32 UTC (rev 10334)
@@ -0,0 +1,11 @@
+# $MidnightBSD$
+# $FreeBSD: stable/10/usr.sbin/sesutil/Makefile 293876 2016-01-14 04:25:29Z allanjude $
+
+PROG=	sesutil
+SRCS=	sesutil.c eltsub.c
+MAN=	sesutil.8
+
+DPADD=	${LIBSBUF}
+LDADD=	-lsbuf
+
+.include <bsd.prog.mk>


Property changes on: trunk/usr.sbin/sesutil/Makefile
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+MidnightBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/plain
\ No newline at end of property
Added: trunk/usr.sbin/sesutil/eltsub.c
===================================================================
--- trunk/usr.sbin/sesutil/eltsub.c	                        (rev 0)
+++ trunk/usr.sbin/sesutil/eltsub.c	2018-06-03 19:55:32 UTC (rev 10334)
@@ -0,0 +1,236 @@
+/* $MidnightBSD$ */
+/* $FreeBSD: stable/10/usr.sbin/sesutil/eltsub.c 293865 2016-01-14 01:42:09Z allanjude $ */
+/*
+ * Copyright (c) 2000 by Matthew Jacob
+ * 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,
+ *    without modification, immediately at the beginning of the file.
+ * 2. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * Alternatively, this software may be distributed under the terms of the
+ * the GNU Public License ("GPL").
+ *
+ * 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.
+ * 
+ * Matthew Jacob
+ * Feral Software
+ * mjacob at feral.com
+ */
+
+#include <sys/endian.h>
+#include <sys/types.h>
+#include <sys/sbuf.h>
+
+#include <err.h>
+#include <unistd.h>
+#include <stddef.h>
+#include <stdint.h>
+#include <stdlib.h>
+#include <stdio.h>
+#include <sys/ioctl.h>
+#include <cam/scsi/scsi_all.h>
+#include <cam/scsi/scsi_enc.h>
+
+#include "eltsub.h"
+
+/*
+ * offset by +20 degrees.
+ * The range of the value expresses a temperature between -19 and +235 degrees
+ * Celsius. A value of 00h is reserved.
+ */
+#define TEMPERATURE_OFFSET 20
+
+char *
+geteltnm(int type)
+{
+	static char rbuf[132];
+
+	switch (type) {
+	case ELMTYP_UNSPECIFIED:
+		sprintf(rbuf, "Unspecified");
+		break;
+	case ELMTYP_DEVICE:
+		sprintf(rbuf, "Device Slot");
+		break;
+	case ELMTYP_POWER:
+		sprintf(rbuf, "Power Supply");
+		break;
+	case ELMTYP_FAN:
+		sprintf(rbuf, "Cooling");
+		break;
+	case ELMTYP_THERM:
+		sprintf(rbuf, "Temperature Sensors");
+		break;
+	case ELMTYP_DOORLOCK:
+		sprintf(rbuf, "Door Lock");
+		break;
+	case ELMTYP_ALARM:
+		sprintf(rbuf, "Audible alarm");
+		break;
+	case ELMTYP_ESCC:
+		sprintf(rbuf, "Enclosure Services Controller Electronics");
+		break;
+	case ELMTYP_SCC:
+		sprintf(rbuf, "SCC Controller Electronics");
+		break;
+	case ELMTYP_NVRAM:
+		sprintf(rbuf, "Nonvolatile Cache");
+		break;
+	case ELMTYP_INV_OP_REASON:
+		sprintf(rbuf, "Invalid Operation Reason");
+		break;
+	case ELMTYP_UPS:
+		sprintf(rbuf, "Uninterruptible Power Supply");
+		break;
+	case ELMTYP_DISPLAY:
+		sprintf(rbuf, "Display");
+		break;
+	case ELMTYP_KEYPAD:
+		sprintf(rbuf, "Key Pad Entry");
+		break;
+	case ELMTYP_ENCLOSURE:
+		sprintf(rbuf, "Enclosure");
+		break;
+	case ELMTYP_SCSIXVR:
+		sprintf(rbuf, "SCSI Port/Transceiver");
+		break;
+	case ELMTYP_LANGUAGE:
+		sprintf(rbuf, "Language");
+		break;
+	case ELMTYP_COMPORT:
+		sprintf(rbuf, "Communication Port");
+		break;
+	case ELMTYP_VOM:
+		sprintf(rbuf, "Voltage Sensor");
+		break;
+	case ELMTYP_AMMETER:
+		sprintf(rbuf, "Current Sensor");
+		break;
+	case ELMTYP_SCSI_TGT:
+		sprintf(rbuf, "SCSI Target Port");
+		break;
+	case ELMTYP_SCSI_INI:
+		sprintf(rbuf, "SCSI Initiator Port");
+		break;
+	case ELMTYP_SUBENC:
+		sprintf(rbuf, "Simple Subenclosure");
+		break;
+	case ELMTYP_ARRAY_DEV:
+		sprintf(rbuf, "Array Device Slot");
+		break;
+	case ELMTYP_SAS_EXP:
+		sprintf(rbuf, "SAS Expander");
+		break;
+	case ELMTYP_SAS_CONN:
+		sprintf(rbuf, "SAS Connector");
+		break;
+	default:
+		(void) sprintf(rbuf, "<Type 0x%x>", type);
+		break;
+	}
+	return (rbuf);
+}
+
+char *
+scode2ascii(u_char code)
+{
+	static char rbuf[32];
+	switch (code & 0xf) {
+	case SES_OBJSTAT_UNSUPPORTED:
+		sprintf(rbuf, "Unsupported");
+		break;
+	case SES_OBJSTAT_OK:
+		sprintf(rbuf, "OK");
+		break;
+	case SES_OBJSTAT_CRIT:
+		sprintf(rbuf, "Critical");
+		break;
+	case SES_OBJSTAT_NONCRIT:
+		sprintf(rbuf, "Noncritical");
+		break;
+	case SES_OBJSTAT_UNRECOV:
+		sprintf(rbuf, "Unrecoverable");
+		break;
+	case SES_OBJSTAT_NOTINSTALLED:
+		sprintf(rbuf, "Not Installed");
+		break;
+	case SES_OBJSTAT_UNKNOWN:
+		sprintf(rbuf, "Unknown");
+		break;
+	case SES_OBJSTAT_NOTAVAIL:
+		sprintf(rbuf, "Not Available");
+		break;
+	case SES_OBJSTAT_NOACCESS:
+		sprintf(rbuf, "No Access Allowed");
+		break;
+	default:
+		sprintf(rbuf, "<Status 0x%x>", code & 0xf);
+		break;
+	}
+	return (rbuf);
+}
+
+struct sbuf *
+stat2sbuf(int eletype, u_char *cstat)
+{
+	struct sbuf *buf;
+
+	buf = sbuf_new_auto();
+	if (buf == NULL)
+		err(EXIT_FAILURE, "sbuf_new_auto()");
+
+	if (cstat[0] & 0x40)
+		sbuf_printf(buf, "\t\t- Predicted Failure\n");
+	if (cstat[0] & 0x20)
+		sbuf_printf(buf, "\t\t- Disabled\n");
+	if (cstat[0] & 0x10)
+		sbuf_printf(buf, "\t\t- Swapped\n");
+	switch (eletype) {
+	case ELMTYP_DEVICE:
+		if (cstat[2] & 0x02)
+			sbuf_printf(buf, "\t\t- LED=locate\n");
+		if (cstat[2] & 0x20)
+			sbuf_printf(buf, "\t\t- LED=fault\n");
+		break;
+	case ELMTYP_ARRAY_DEV:
+		if (cstat[2] & 0x02)
+			sbuf_printf(buf, "\t\t- LED=locate\n");
+		if (cstat[2] & 0x20)
+			sbuf_printf(buf, "\t\t- LED=fault\n");
+		break;
+	case ELMTYP_FAN:
+		sbuf_printf(buf, "\t\t- Speed: %d rpm\n",
+		    (((0x7 & cstat[1]) << 8) + cstat[2]) * 10);
+		break;
+	case ELMTYP_THERM:
+		if (cstat[2]) {
+			sbuf_printf(buf, "\t\t- Temperature: %d C\n",
+			    cstat[2] - TEMPERATURE_OFFSET);
+		} else {
+			sbuf_printf(buf, "\t\t- Temperature: -reserved-\n");
+		}
+		break;
+	case ELMTYP_VOM:
+		sbuf_printf(buf, "\t\t- Voltage: %.2f V\n",
+		    be16dec(cstat + 2) / 100.0);
+		break;
+	}
+	sbuf_finish(buf);
+	return (buf);
+}


Property changes on: trunk/usr.sbin/sesutil/eltsub.c
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+MidnightBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/plain
\ No newline at end of property
Added: trunk/usr.sbin/sesutil/eltsub.h
===================================================================
--- trunk/usr.sbin/sesutil/eltsub.h	                        (rev 0)
+++ trunk/usr.sbin/sesutil/eltsub.h	2018-06-03 19:55:32 UTC (rev 10334)
@@ -0,0 +1,38 @@
+/* $MidnightBSD$ */
+/* $FreeBSD: stable/10/usr.sbin/sesutil/eltsub.h 293865 2016-01-14 01:42:09Z allanjude $ */
+/*
+ * Copyright (c) 2000 by Matthew Jacob
+ * 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,
+ *    without modification, immediately at the beginning of the file.
+ * 2. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * Alternatively, this software may be distributed under the terms of the
+ * the GNU Public License ("GPL").
+ *
+ * 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.
+ * 
+ * Matthew Jacob
+ * Feral Software
+ * mjacob at feral.com
+ */
+
+char *geteltnm(int);
+char *scode2ascii(u_char);
+struct sbuf *stat2sbuf(int, u_char *);


Property changes on: trunk/usr.sbin/sesutil/eltsub.h
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+MidnightBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/plain
\ No newline at end of property
Added: trunk/usr.sbin/sesutil/sesutil.8
===================================================================
--- trunk/usr.sbin/sesutil/sesutil.8	                        (rev 0)
+++ trunk/usr.sbin/sesutil/sesutil.8	2018-06-03 19:55:32 UTC (rev 10334)
@@ -0,0 +1,131 @@
+.\" $MidnightBSD$
+.\" Copyright (c) 2015 Baptiste Daroussin <bapt at FreeBSD.org>
+.\" 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: stable/10/usr.sbin/sesutil/sesutil.8 293865 2016-01-14 01:42:09Z allanjude $
+.\"
+.Dd September 6, 2015
+.Dt SESUTIL 8
+.Os
+.Sh NAME
+.Nm sesutil
+.Nd Utility for managing SCSI Enclosure Services (SES) device
+.Sh SYNOPSIS
+.Nm
+.Cm fault
+.Op Fl u Ar /dev/sesN
+.Aq Ar disk | Ar sesid | Li all
+.Op on | off
+.Nm
+.Cm locate
+.Op Fl u Ar /dev/sesN
+.Aq Ar disk | Ar sesid | Li all
+.Op on | off
+.Nm
+.Cm map
+.Op Fl u Ar /dev/sesN
+.Nm
+.Cm status
+.Op Fl u Ar /dev/sesN
+.Sh DESCRIPTION
+The
+.Nm
+utility can be used to query and modify various parameter of SCSI Enclosure
+Services (SES) devices.
+.Pp
+List of supported commands:
+.Bl -tag -width indent
+.It Cm fault Oo Fl u Ar /dev/sesN Oc Ao Ar disk | Li all Ac Op on | off
+Change the state of the external fault LED associated with
+.Ar disk .
+.Ar disk
+can be the device name of the disk, like
+.Cm da12 ,
+or
+.Ql all .
+to indicate all disks attached to SES controllers.
+.It Cm fault Fl u Ar /dev/sesN Ar sesid Op on | off
+Change the state of the external fault LED associated with an element
+connected to the SES controller.
+.Ar sesid
+must be the element ID of a valid item attached to the controller.
+Use the
+.Cm map
+command to list the elements attached to a controller.
+.It Cm locate Oo Fl u Ar /dev/sesN Oc Ao Ar disk | Li all Ac Op on | off
+Change the state of the external locate LED associated with
+.Ar disk .
+.Ar disk
+can be the device name of the disk, like
+.Cm da12 ,
+or
+.Ql all .
+to indicate all disks attached to SES controllers.
+.It Cm locate Fl u Ar /dev/sesN Ar sesid Op on | off
+Change the state of the external locate LED associated with an element
+connected to the SES controller.
+.Ar sesid
+must be the element ID of a valid item attached to the controller.
+Use the
+.Cm map
+command to list the elements attached to a controller.
+.It Cm map Op Fl u Ar /dev/sesN
+Display a map of all elements connected to the specified
+.Xr ses 4
+controller.
+If no controller is specified, all controllers are mapped.
+.It Cm status Op Fl u Ar /dev/sesN
+Display the status of the specified
+.Xr ses 4
+controller.
+If no controller is specified, the status of each controller is returned.
+.El
+.Sh EXAMPLES
+Turn off all locate LEDs:
+.Pp
+.Dl Nm Cm locate all off
+.Pp
+Turn on the locate LED for the drive bay corresponding to
+.Pa da15 :
+.Pp
+.Dl Nm Cm locate da15 on
+.Pp
+Turn on the fault LED for a drive bay not associated with a device:
+.Pp
+.Dl Nm Cm fault -u /dev/ses2 7 on
+.Sh SEE ALSO
+.Xr ses 4
+.Sh HISTORY
+The
+.Nm
+utility first appeared in
+.Fx 11.0 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+utility was written by
+.An Baptiste Daroussin Aq Mt bapt at FreeBSD.org
+and
+.An Allan Jude Aq Mt allanjude at FreeBSD.org .


Property changes on: trunk/usr.sbin/sesutil/sesutil.8
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+MidnightBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/plain
\ No newline at end of property
Added: trunk/usr.sbin/sesutil/sesutil.c
===================================================================
--- trunk/usr.sbin/sesutil/sesutil.c	                        (rev 0)
+++ trunk/usr.sbin/sesutil/sesutil.c	2018-06-03 19:55:32 UTC (rev 10334)
@@ -0,0 +1,567 @@
+/* $MidnightBSD$ */
+/*-
+ * Copyright (c) 2015 Baptiste Daroussin <bapt at FreeBSD.org>
+ * Copyright (c) 2015 Allan Jude <allanjude at FreeBSD.org>
+ * Copyright (c) 2000 by Matthew Jacob
+ * 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
+ *    in this position and unchanged.
+ * 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(S) ``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(S) 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: stable/10/usr.sbin/sesutil/sesutil.c 306797 2016-10-07 01:33:03Z mav $");
+
+#include <sys/param.h>
+#include <sys/ioctl.h>
+#include <sys/types.h>
+#include <sys/sbuf.h>
+
+#include <err.h>
+#include <errno.h>
+#include <fcntl.h>
+#include <getopt.h>
+#include <glob.h>
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+
+#include <cam/scsi/scsi_all.h>
+#include <cam/scsi/scsi_enc.h>
+
+#include "eltsub.h"
+
+static int encstatus(int argc, char **argv);
+static int fault(int argc, char **argv);
+static int locate(int argc, char **argv);
+static int objmap(int argc, char **argv);
+static int sesled(int argc, char **argv, bool fault);
+
+static struct command {
+	const char *name;
+	const char *param;
+	const char *desc;
+	int (*exec)(int argc, char **argv);
+} cmds[] = {
+	{ "fault",
+	    "(<disk>|<sesid>|all) (on|off)",
+	    "Change the state of the fault LED associated with a disk",
+	    fault },
+	{ "locate",
+	    "(<disk>|<sesid>|all) (on|off)",
+	    "Change the state of the locate LED associated with a disk",
+	    locate },
+	{ "map", "",
+	    "Print a map of the devices managed by the enclosure", objmap } ,
+	{ "status", "", "Print the status of the enclosure",
+	    encstatus },
+};
+
+static const int nbcmds = nitems(cmds);
+static const char *uflag;
+
+static void
+usage(FILE *out, const char *subcmd)
+{
+	int i;
+
+	if (subcmd == NULL) {
+		fprintf(out, "Usage: %s [-u /dev/ses<N>] <command> [options]\n",
+		    getprogname());
+		fprintf(out, "Commands supported:\n");
+	}
+	for (i = 0; i < nbcmds; i++) {
+		if (subcmd != NULL) {
+			if (strcmp(subcmd, cmds[i].name) == 0) {
+				fprintf(out, "Usage: %s %s [-u /dev/ses<N>] "
+				    "%s\n\t%s\n", getprogname(), subcmd,
+				    cmds[i].param, cmds[i].desc);
+				break;
+			}
+			continue;
+		}
+		fprintf(out, "    %-12s%s\n\t\t%s\n\n", cmds[i].name,
+		    cmds[i].param, cmds[i].desc);
+	}
+
+	exit(EXIT_FAILURE);
+}
+
+static void
+do_led(int fd, unsigned int idx, bool onoff, bool setfault)
+{
+	encioc_elm_status_t o;
+
+	o.elm_idx = idx;
+	if (ioctl(fd, ENCIOC_GETELMSTAT, (caddr_t) &o) < 0) {
+		close(fd);
+		err(EXIT_FAILURE, "ENCIOC_GETELMSTAT");
+	}
+	o.cstat[0] |= 0x80;
+	if (setfault) {
+		if (onoff)
+			o.cstat[3] |= 0x20;
+		else
+			o.cstat[3] &= 0xdf;
+	} else {
+		if (onoff)
+			o.cstat[2] |= 0x02;
+		else
+			o.cstat[2] &= 0xfd;
+	}
+
+	if (ioctl(fd, ENCIOC_SETELMSTAT, (caddr_t) &o) < 0) {
+		close(fd);
+		err(EXIT_FAILURE, "ENCIOC_SETELMSTAT");
+	}
+}
+
+static bool
+disk_match(const char *devnames, const char *disk, size_t len)
+{
+	const char *dname;
+
+	dname = devnames;
+	while ((dname = strstr(dname, disk)) != NULL) {
+		if (dname[len] == '\0' || dname[len] == ',') {
+			return (true);
+		}
+		dname++;
+	}
+
+	return (false);
+}
+
+static int
+sesled(int argc, char **argv, bool setfault)
+{
+	encioc_elm_devnames_t objdn;
+	encioc_element_t *objp;
+	glob_t g;
+	char *disk, *endptr;
+	size_t len, i, ndisks;
+	int fd;
+	unsigned int nobj, j, sesid;
+	bool all, isses, onoff;
+
+	isses = false;
+	all = false;
+	onoff = false;
+
+	if (argc != 3) {
+		usage(stderr, (setfault ? "fault" : "locate"));
+	}
+
+	disk = argv[1];
+
+	sesid = strtoul(disk, &endptr, 10);
+	if (*endptr == '\0') {
+		endptr = strrchr(uflag, '*');
+		if (endptr != NULL && *endptr == '*') {
+			warnx("Must specifying a SES device (-u) to use a SES "
+			    "id# to identify a disk");
+			usage(stderr, (setfault ? "fault" : "locate"));
+		}
+		isses = true;
+	}
+
+	if (strcmp(argv[2], "on") == 0) {
+		onoff = true;
+	} else if (strcmp(argv[2], "off") == 0) {
+		onoff = false;
+	} else {
+		usage(stderr, (setfault ? "fault" : "locate"));
+	}
+
+	if (strcmp(disk, "all") == 0) {
+		all = true;
+	}
+	len = strlen(disk);
+
+	/* Get the list of ses devices */
+	if (glob((uflag != NULL ? uflag : "/dev/ses[0-9]*"), 0, NULL, &g) ==
+	    GLOB_NOMATCH) {
+		globfree(&g);
+		errx(EXIT_FAILURE, "No SES devices found");
+	}
+
+	ndisks = 0;
+	for (i = 0; i < g.gl_pathc; i++) {
+		/* ensure we only got numbers after ses */
+		if (strspn(g.gl_pathv[i] + 8, "0123456789") !=
+		    strlen(g.gl_pathv[i] + 8)) {
+			continue;
+		}
+		if ((fd = open(g.gl_pathv[i], O_RDWR)) < 0) {
+			/*
+			 * Don't treat non-access errors as critical if we are
+			 * accessing all devices
+			 */
+			if (errno == EACCES && g.gl_pathc > 1) {
+				err(EXIT_FAILURE, "unable to access SES device");
+			}
+			warn("unable to access SES device: %s", g.gl_pathv[i]);
+			continue;
+		}
+
+		if (ioctl(fd, ENCIOC_GETNELM, (caddr_t) &nobj) < 0) {
+			close(fd);
+			err(EXIT_FAILURE, "ENCIOC_GETNELM");
+		}
+
+		objp = calloc(nobj, sizeof(encioc_element_t));
+		if (objp == NULL) {
+			close(fd);
+			err(EXIT_FAILURE, "calloc()");
+		}
+
+		if (ioctl(fd, ENCIOC_GETELMMAP, (caddr_t) objp) < 0) {
+			close(fd);
+			err(EXIT_FAILURE, "ENCIOC_GETELMMAP");
+		}
+
+		if (isses) {
+			if (sesid > nobj) {
+				close(fd);
+				errx(EXIT_FAILURE,
+				     "Requested SES ID does not exist");
+			}
+			do_led(fd, sesid, onoff, setfault);
+			ndisks++;
+			close(fd);
+			break;
+		}
+		for (j = 0; j < nobj; j++) {
+			memset(&objdn, 0, sizeof(objdn));
+			objdn.elm_idx = objp[j].elm_idx;
+			objdn.elm_names_size = 128;
+			objdn.elm_devnames = calloc(128, sizeof(char));
+			if (objdn.elm_devnames == NULL) {
+				close(fd);
+				err(EXIT_FAILURE, "calloc()");
+			}
+			if (ioctl(fd, ENCIOC_GETELMDEVNAMES,
+			    (caddr_t) &objdn) <0) {
+				continue;
+			}
+			if (objdn.elm_names_len > 0) {
+				if (all) {
+					do_led(fd, objdn.elm_idx,
+					    onoff, setfault);
+					continue;
+				}
+				if (disk_match(objdn.elm_devnames, disk, len)) {
+					do_led(fd, objdn.elm_idx,
+					    onoff, setfault);
+					ndisks++;
+					break;
+				}
+			}
+		}
+		close(fd);
+	}
+	globfree(&g);
+	if (ndisks == 0 && all == false) {
+		errx(EXIT_FAILURE, "Count not find the SES id of device '%s'",
+		    disk);
+	}
+
+	return (EXIT_SUCCESS);
+}
+
+static int
+locate(int argc, char **argv)
+{
+
+	return (sesled(argc, argv, false));
+}
+
+static int
+fault(int argc, char **argv)
+{
+
+	return (sesled(argc, argv, true));
+}
+
+static int
+objmap(int argc, char **argv __unused)
+{
+	struct sbuf *extra;
+	encioc_string_t stri;
+	encioc_elm_devnames_t e_devname;
+	encioc_elm_status_t e_status;
+	encioc_elm_desc_t e_desc;
+	encioc_element_t *e_ptr;
+	glob_t g;
+	int fd;
+	unsigned int j, nobj;
+	size_t i;
+	char str[32];
+
+	if (argc != 1) {
+		usage(stderr, "map");
+	}
+
+	/* Get the list of ses devices */
+	if (glob(uflag, 0, NULL, &g) == GLOB_NOMATCH) {
+		globfree(&g);
+		errx(EXIT_FAILURE, "No SES devices found");
+	}
+	for (i = 0; i < g.gl_pathc; i++) {
+		/* ensure we only got numbers after ses */
+		if (strspn(g.gl_pathv[i] + 8, "0123456789") !=
+		    strlen(g.gl_pathv[i] + 8)) {
+			continue;
+		}
+		if ((fd = open(g.gl_pathv[i], O_RDWR)) < 0) {
+			/*
+			 * Don't treat non-access errors as critical if we are
+			 * accessing all devices
+			 */
+			if (errno == EACCES && g.gl_pathc > 1) {
+				err(EXIT_FAILURE, "unable to access SES device");
+			}
+			warn("unable to access SES device: %s", g.gl_pathv[i]);
+			continue;
+		}
+
+		if (ioctl(fd, ENCIOC_GETNELM, (caddr_t) &nobj) < 0) {
+			close(fd);
+			err(EXIT_FAILURE, "ENCIOC_GETNELM");
+		}
+
+		e_ptr = calloc(nobj, sizeof(encioc_element_t));
+		if (e_ptr == NULL) {
+			close(fd);
+			err(EXIT_FAILURE, "calloc()");
+		}
+
+		if (ioctl(fd, ENCIOC_GETELMMAP, (caddr_t) e_ptr) < 0) {
+			close(fd);
+			err(EXIT_FAILURE, "ENCIOC_GETELMMAP");
+		}
+
+		printf("%s:\n", g.gl_pathv[i] + 5);
+		stri.bufsiz = sizeof(str);
+		stri.buf = &str[0];
+		if (ioctl(fd, ENCIOC_GETENCNAME, (caddr_t) &stri) == 0)
+			printf("\tEnclosure Name: %s\n", stri.buf);
+		stri.bufsiz = sizeof(str);
+		stri.buf = &str[0];
+		if (ioctl(fd, ENCIOC_GETENCID, (caddr_t) &stri) == 0)
+			printf("\tEnclosure ID: %s\n", stri.buf);
+
+		for (j = 0; j < nobj; j++) {
+			/* Get the status of the element */
+			memset(&e_status, 0, sizeof(e_status));
+			e_status.elm_idx = e_ptr[j].elm_idx;
+			if (ioctl(fd, ENCIOC_GETELMSTAT,
+			    (caddr_t) &e_status) < 0) {
+				close(fd);
+				err(EXIT_FAILURE, "ENCIOC_GETELMSTAT");
+			}
+			/* Get the description of the element */
+			memset(&e_desc, 0, sizeof(e_desc));
+			e_desc.elm_idx = e_ptr[j].elm_idx;
+			e_desc.elm_desc_len = UINT16_MAX;
+			e_desc.elm_desc_str = calloc(UINT16_MAX, sizeof(char));
+			if (e_desc.elm_desc_str == NULL) {
+				close(fd);
+				err(EXIT_FAILURE, "calloc()");
+			}
+			if (ioctl(fd, ENCIOC_GETELMDESC,
+			    (caddr_t) &e_desc) < 0) {
+				close(fd);
+				err(EXIT_FAILURE, "ENCIOC_GETELMDESC");
+			}
+			/* Get the device name(s) of the element */
+			memset(&e_devname, 0, sizeof(e_devname));
+			e_devname.elm_idx = e_ptr[j].elm_idx;
+			e_devname.elm_names_size = 128;
+			e_devname.elm_devnames = calloc(128, sizeof(char));
+			if (e_devname.elm_devnames == NULL) {
+				close(fd);
+				err(EXIT_FAILURE, "calloc()");
+			}
+			if (ioctl(fd, ENCIOC_GETELMDEVNAMES,
+			    (caddr_t) &e_devname) <0) {
+				/* We don't care if this fails */
+				e_devname.elm_devnames[0] = '\0';
+			}
+			printf("\tElement %u, Type: %s\n", e_ptr[j].elm_idx,
+			    geteltnm(e_ptr[j].elm_type));
+			printf("\t\tStatus: %s (0x%02x 0x%02x 0x%02x 0x%02x)\n",
+			    scode2ascii(e_status.cstat[0]), e_status.cstat[0],
+			    e_status.cstat[1], e_status.cstat[2],
+			    e_status.cstat[3]);
+			if (e_desc.elm_desc_len > 0) {
+				printf("\t\tDescription: %s\n",
+				    e_desc.elm_desc_str);
+			}
+			if (e_devname.elm_names_len > 0) {
+				printf("\t\tDevice Names: %s\n",
+				    e_devname.elm_devnames);
+			}
+			extra = stat2sbuf(e_ptr[j].elm_type, e_status.cstat);
+			if (sbuf_len(extra) > 0) {
+				printf("\t\tExtra status:\n%s",
+				   sbuf_data(extra));
+			}
+			sbuf_delete(extra);
+			free(e_devname.elm_devnames);
+		}
+		close(fd);
+	}
+	globfree(&g);
+
+	return (EXIT_SUCCESS);
+}
+
+static int
+encstatus(int argc, char **argv __unused)
+{
+	glob_t g;
+	int fd, status;
+	size_t i, e;
+	u_char estat;
+
+	status = 0;
+	if (argc != 1) {
+		usage(stderr, "status");
+	}
+
+	/* Get the list of ses devices */
+	if (glob(uflag, 0, NULL, &g) == GLOB_NOMATCH) {
+		globfree(&g);
+		errx(EXIT_FAILURE, "No SES devices found");
+	}
+	for (i = 0; i < g.gl_pathc; i++) {
+		/* ensure we only got numbers after ses */
+		if (strspn(g.gl_pathv[i] + 8, "0123456789") !=
+		    strlen(g.gl_pathv[i] + 8)) {
+			continue;
+		}
+		if ((fd = open(g.gl_pathv[i], O_RDWR)) < 0) {
+			/*
+			 * Don't treat non-access errors as critical if we are
+			 * accessing all devices
+			 */
+			if (errno == EACCES && g.gl_pathc > 1) {
+				err(EXIT_FAILURE, "unable to access SES device");
+			}
+			warn("unable to access SES device: %s", g.gl_pathv[i]);
+			continue;
+		}
+
+		if (ioctl(fd, ENCIOC_GETENCSTAT, (caddr_t) &estat) < 0) {
+			close(fd);
+			err(EXIT_FAILURE, "ENCIOC_GETENCSTAT");
+		}
+
+		printf("%s: ", g.gl_pathv[i] + 5);
+		e = 0;
+		if (estat == 0) {
+			if (status == 0) {
+				status = 1;
+			}
+			printf("OK");
+		} else {
+			if (estat & SES_ENCSTAT_INFO) {
+				printf("INFO");
+				e++;
+			}
+			if (estat & SES_ENCSTAT_NONCRITICAL) {
+				if (e)
+					printf(",");
+				printf("NONCRITICAL");
+				e++;
+			}
+			if (estat & SES_ENCSTAT_CRITICAL) {
+				if (e)
+					printf(",");
+				printf("CRITICAL");
+				e++;
+				status = -1;
+			}
+			if (estat & SES_ENCSTAT_UNRECOV) {
+				if (e)
+					printf(",");
+				printf("UNRECOV");
+				e++;
+				status = -1;
+			}
+		}
+		printf("\n");
+
+		close(fd);
+	}
+	globfree(&g);
+
+	if (status == 1) {
+		return (EXIT_SUCCESS);
+	} else {
+		return (EXIT_FAILURE);
+	}
+}
+
+int
+main(int argc, char **argv)
+{
+	int i, ch;
+	struct command *cmd = NULL;
+
+	uflag = "/dev/ses[0-9]*";
+	while ((ch = getopt_long(argc, argv, "u:", NULL, NULL)) != -1) {
+		switch (ch) {
+		case 'u':
+			uflag = optarg;
+			break;
+		case '?':
+		default:
+			usage(stderr, NULL);
+		}
+	}
+	argc -= optind;
+	argv += optind;
+
+	if (argc < 1) {
+		warnx("Missing command");
+		usage(stderr, NULL);
+	}
+
+	for (i = 0; i < nbcmds; i++) {
+		if (strcmp(argv[0], cmds[i].name) == 0) {
+			cmd = &cmds[i];
+			break;
+		}
+	}
+
+	if (cmd == NULL) {
+		warnx("unknown command %s", argv[0]);
+		usage(stderr, NULL);
+	}
+
+	return (cmd->exec(argc, argv));
+}


Property changes on: trunk/usr.sbin/sesutil/sesutil.c
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+MidnightBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/plain
\ No newline at end of property


More information about the Midnightbsd-cvs mailing list