add ses.4 man page

2 files changed, 115 insertions, 2 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index b4bbf4d9c73..0bdbb879739 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.99 2000/02/17 21:13:14 niklas Exp $
+#	$OpenBSD: Makefile,v 1.100 2000/02/22 23:35:27 mjacob Exp $
 #	$NetBSD: Makefile,v 1.22.4.2 1996/07/18 00:51:10 jtc Exp $
 
 MAN=	ac97.4 atalk.4 atapiscsi.4 audio.4 adv.4 ahc.4 al.4 ax.4 bpf.4 \
@@ -9,7 +9,7 @@ MAN=	ac97.4 atalk.4 atapiscsi.4 audio.4 adv.4 ahc.4 al.4 ax.4 bpf.4 \
 	isapnp.4 iso.4 isp.4 ksyms.4 lkm.4 lmc.4 lo.4 lxtphy.4 midi.4 mii.4 \
 	mtdphy.4 mtio.4 ncr.4 ne.4 netintro.4 ns.4 nsip.4 nsphy.4 null.4 \
 	opl.4 options.4 pciide.4 pcmcia.4 pty.4 qsphy.4 raid.4 random.4 \
-	rl.4 rln.4 rlphy.4 route.4 scsi.4 sd.4 sf.4 sis.4 sk.4 sl.4 sm.4 \
+	rl.4 rln.4 rlphy.4 route.4 scsi.4 sd.4 ses.4 sf.4 sis.4 sk.4 sl.4 sm.4 \
 	spp.4 sppp.4 sqphy.4 ss.4 st.4 ste.4 sv.4 tb.4 tcp.4 termios.4 ti.4 \
 	tl.4 tlphy.4 tp.4 tqphy.4 tty.4 tun.4 tx.4 txphy.4 uaudio.4 udp.4 \
 	ugen.4 uhid.4 uk.4 ukphy.4 unix.4 usb.4 vnd.4 vr.4 wb.4 wd.4 we.4 \
diff --git a/share/man/man4/ses.4 b/share/man/man4/ses.4
new file mode 100644
index 00000000000..453014062a7
--- /dev/null
+++ b/share/man/man4/ses.4
@@ -0,0 +1,113 @@
+.\" Copyright (c) 2000
+.\"	Matthew Jacob <mjacob@openbsd.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.
+.\"
+.\" $OpenBSD: ses.4,v 1.1 2000/02/22 23:35:27 mjacob Exp $
+.\"
+.Dd February 22, 2000
+.Dt SES 4
+.Os OpenBSD
+.Sh NAME
+.Nm ses
+.Nd SCSI Environmental Services Driver
+.Sh SYNOPSIS
+.Sh SYNOPSIS
+.Cd ses* at scsibus? target ? lun ?
+.Sh DESCRIPTION
+The
+.Nm ses
+driver provides support for all
+.Tn SCSI
+devices of the environmental services class that are attached to the system
+through a supported
+.Tn SCSI
+Host Adapter, as well as emulated support for SAF-TE (SCSI Accessible
+Fault Tolerant Enclosures).
+The environmental services class generally are enclosure devices that
+provide environmental information such as number of power supplies (and
+state), temperature, device slots, and so on.
+.Pp
+A
+.Tn SCSI
+Host
+adapter must also be separately configured into the system
+before a
+.Tn SCSI
+SCSI Environmental Services device can be configured.
+.Sh IOCTLS
+The following
+.Xr ioctl 2
+calls apply to
+.B SES
+devices.
+They are defined in the header file
+.Aq Pa scsi/ses.h
+(\fIq.v.\fR).
+.Pp
+.Bl -tag -width SESIOC_GETENCSTAT
+.It Dv SESIOC_GETNOBJ
+Used to find out how many
+.B SES
+objects are driven by this particular device instance.
+.It Dv SESIOC_GETOBJMAP
+Read, from the kernel, an array of SES objects which contains
+the object identifier, which subenclosure it is in, and the
+.B SES
+type of the object.
+.It Dv SESIOC_GETENCSTAT
+Get the overall enclosure status.
+.It Dv SESIOC_SETENCSTAT
+Set the overall enclosure status.
+.It Dv SESIOC_GETOBJSTAT
+Get the status of a particular object.
+.It Dv SESIOC_SETOBJSTAT
+Set the status of a particular object.
+.It Dv SESIOC_GETTEXT
+Get the associated help text for an object (not yet implemented).
+.B SES
+devices often have descriptive text for an object which can tell
+you things like location (e.g, "left power supply").
+.It Dv SESIOC_INIT
+Initialize the enclosure.
+.Sh FILES
+.Bl -tag -width /dev/rsdXXXXX -compact
+.It Pa /dev/ses Ns Ar N
+The \fINth\fR \fBSES\fR device.
+.Sh DIAGNOSTICS
+When the kernel is configured with
+.Tn DEBUG
+enabled, the first open to an SES device will spit out overall enclosure
+parameters to the console.
+.Sh SEE ALSO
+.Xr sesd 8 ,
+.Xr getencstat 8 ,
+.Xr setenctsat 8 ,
+.Xr setobjstat 8
+.Sh HISTORY
+The
+.Nm
+driver was written for the
+.Tn SCSI
+subsystem by Matthew Jacob. This is the functional equivalent of a similar
+driver available in Solaris, Release 7.