add a man page for the power button driver (u5/u10/etc) based on prodding

from steven mestdagh

3 files changed, 65 insertions, 3 deletions

diff --git a/share/man/man4/man4.sparc64/Makefile b/share/man/man4/man4.sparc64/Makefile
index cbf40eaf1ce..128b5302da4 100644
--- a/share/man/man4/man4.sparc64/Makefile
+++ b/share/man/man4/man4.sparc64/Makefile
@@ -1,10 +1,10 @@
-#	$OpenBSD: Makefile,v 1.46 2006/06/02 04:54:06 jason Exp $
+#	$OpenBSD: Makefile,v 1.47 2006/09/09 14:04:12 jason Exp $
 
 MAN=	agten.4 apio.4 asio.4 audioce.4 audiocs.4 autoconf.4 auxio.4 \
 	be.4 beeper.4 bwtwo.4 central.4 cgsix.4 cgthree.4 cgtwelve.4 \
 	clkbrd.4 clock.4 comkbd.4 creator.4 \
 	ebus.4 esp.4 fhc.4 intro.4 le.4 magma.4 mem.4 mgx.4 openprom.4 \
-	pcons.4 ppm.4 psycho.4 qe.4 qec.4 rfx.4 sab.4 schizo.4 spif.4 \
+	pcons.4 power.4 ppm.4 psycho.4 qe.4 qec.4 rfx.4 sab.4 schizo.4 spif.4 \
 	timer.4 tvtwo.4 upa.4 uperf.4 vigra.4 xbox.4 zs.4 zx.4
 MLINKS=	beeper.4 beep.4 \
 	clock.4 rtc.4 \
diff --git a/share/man/man4/man4.sparc64/ebus.4 b/share/man/man4/man4.sparc64/ebus.4
index 8ef386ba2b7..628302b39c6 100644
--- a/share/man/man4/man4.sparc64/ebus.4
+++ b/share/man/man4/man4.sparc64/ebus.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ebus.4,v 1.7 2006/02/01 14:04:40 dlg Exp $
+.\"	$OpenBSD: ebus.4,v 1.8 2006/09/09 14:04:12 jason Exp $
 .\"	$NetBSD: ebus.4,v 1.3 2002/03/13 21:42:20 wiz Exp $
 .\"
 .\" Copyright (c) 1999 Matthew R. Green
@@ -64,6 +64,7 @@ SCSI DMA.
 .Xr lpt 4 ,
 .Xr pcfiic 4 ,
 .Xr pckbc 4 ,
+.Xr power 4 ,
 .Xr sab 4 ,
 .Xr uperf 4
 .Rs
diff --git a/share/man/man4/man4.sparc64/power.4 b/share/man/man4/man4.sparc64/power.4
new file mode 100644
index 00000000000..8dfd0c17ca4
--- /dev/null
+++ b/share/man/man4/man4.sparc64/power.4
@@ -0,0 +1,61 @@
+.\"     $OpenBSD: power.4,v 1.1 2006/09/09 14:04:12 jason Exp $
+.\"
+.\" Copyright (c) 2006 Jason L. Wright (jason@thought.net)
+.\" 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 ``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 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.
+.\"
+.Dd January 30, 2002
+.Dt POWER 4 sparc64
+.Os
+.Sh NAME
+.Nm power
+.Nd power button
+.Sh SYNOPSIS
+.Cd "power* at ebus?"
+.Sh DESCRIPTION
+Some UltraSPARC host bridges provide an interrupt when the power button
+is depressed.
+The
+.Nm
+driver catches that interrupt.
+If the
+.Nm machdep.kbdreset
+.Xr sysctl 8
+is set to 1,
+.Nm power
+will signal
+.Xr init 8
+to do a clean shutdown and power the machine down.
+.Sh SEE ALSO
+.Xr ebus 4 ,
+.Xr intro 4 ,
+.Xr init 8 ,
+.Xr sysctl 8
+.Sh HISTORY
+The
+.Nm
+driver was first supported in
+.Ox 4.0 .
+.Sh AUTHORS
+The driver was written by
+.An Jason Wright Aq jason@thought.net .