1*3bafbbb3Swiz.\" $NetBSD: getencstat.8,v 1.5 2009/04/11 13:24:00 wiz Exp $ 2f249807bSmjacob.\" $OpenBSD: $ 3f249807bSmjacob.\" $FreeBSD: $ 4f249807bSmjacob.\" 5f249807bSmjacob.\" Copyright (c) 2000 Matthew Jacob 6f249807bSmjacob.\" All rights reserved. 7f249807bSmjacob.\" 8f249807bSmjacob.\" Redistribution and use in source and binary forms, with or without 9f249807bSmjacob.\" modification, are permitted provided that the following conditions 10f249807bSmjacob.\" are met: 11f249807bSmjacob.\" 1. Redistributions of source code must retain the above copyright 12f249807bSmjacob.\" notice, this list of conditions, and the following disclaimer, 13f249807bSmjacob.\" without modification, immediately at the beginning of the file. 14f249807bSmjacob.\" 2. The name of the author may not be used to endorse or promote products 15f249807bSmjacob.\" derived from this software without specific prior written permission. 16f249807bSmjacob.\" 17f249807bSmjacob.\" Alternatively, this software may be distributed under the terms of the 18f249807bSmjacob.\" the GNU Public License ("GPL"). 19f249807bSmjacob.\" 20f249807bSmjacob.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 21f249807bSmjacob.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22f249807bSmjacob.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23f249807bSmjacob.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR 24f249807bSmjacob.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25f249807bSmjacob.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26f249807bSmjacob.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27f249807bSmjacob.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28f249807bSmjacob.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29f249807bSmjacob.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30f249807bSmjacob.\" SUCH DAMAGE. 31f249807bSmjacob.\" 32f249807bSmjacob.\" Matthew Jacob 33f249807bSmjacob.\" Feral Software 34f249807bSmjacob.\" mjacob@feral.com 35f249807bSmjacob.Dd February 21, 2000 36f249807bSmjacob.Dt GETENCSTAT 8 37f249807bSmjacob.Os 38f249807bSmjacob.Sh NAME 39f249807bSmjacob.Nm getencstat 40f249807bSmjacob.Nd get SCSI Environmental Services Device enclosure status 41f249807bSmjacob.Sh SYNOPSIS 42f249807bSmjacob.Nm 43f249807bSmjacob.Op Fl v 44f249807bSmjacob.Ar device 45f249807bSmjacob.Op Ar device ... 46f249807bSmjacob.Sh DESCRIPTION 47f249807bSmjacob.Nm 48f249807bSmjacobgets summary and detailed SCSI Environmental Services (or SAF-TE) device 49*3bafbbb3Swizenclosure status. 50*3bafbbb3SwizThe overall status is printed out. 51*3bafbbb3SwizIf the overall status 529bc855a9Ssimonbis considered okay, nothing else is printed out (unless the 53f249807bSmjacob.Fl v 54f249807bSmjacoboption is used). 55f249807bSmjacob.Pp 56f249807bSmjacobA SCSI Environmental Services device enclosure may be either in the state 572cfdc9a9Sjoergof being 582cfdc9a9Sjoerg.Sy OK , 592cfdc9a9Sjoergor in one or more of the states of 602cfdc9a9Sjoerg.Sy INFORMATIONAL , 612cfdc9a9Sjoerg.Sy NON-CRITICAL , 62*3bafbbb3Swiz.Sy CRITICAL , 632cfdc9a9Sjoergor 642cfdc9a9Sjoerg.Sy UNRECOVERABLE 652cfdc9a9Sjoergstates. 662cfdc9a9SjoergThese overall states reflect a summary of the states of each object within 67f249807bSmjacobsuch a device (such as power supplies or disk drives). 68f249807bSmjacob.Pp 69f249807bSmjacobWith the 70f249807bSmjacob.Fl v 71f249807bSmjacoboption, the status of all objects within the device is printed, whether 722cfdc9a9Sjoerg.Sy OK 732cfdc9a9Sjoergor not. 742cfdc9a9SjoergAlong with the status of each object is the object identifier. 75f249807bSmjacob.Pp 76f249807bSmjacobThe user may then use 77f249807bSmjacob.Xr setencstat 8 78f249807bSmjacobto try and clear overall device status, or may use 79f249807bSmjacob.Xr setobjstat 8 80f249807bSmjacobto set specific object status. 81f249807bSmjacob.Sh FILES 82f249807bSmjacob.Bl -tag -width /dev/sesN -compact 832cfdc9a9Sjoerg.It Pa /dev/ses Ns Ar N 84f249807bSmjacobSCSI Environmental Services Devices 85f249807bSmjacob.El 86f249807bSmjacob.Sh SEE ALSO 87f249807bSmjacob.Xr ses 4 , 88f249807bSmjacob.Xr sesd 8 , 89f249807bSmjacob.Xr setencstat 8 , 90f249807bSmjacob.Xr setobjstat 8 91