kate(4) manual page

3 files changed, 104 insertions, 4 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 155c41e51fa..31c9e8b4d1a 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.444 2008/03/23 08:00:38 cnst Exp $
+#	$OpenBSD: Makefile,v 1.445 2008/03/27 01:54:44 cnst Exp $
 
 MAN=	aac.4 ac97.4 acphy.4 \
 	acpi.4 acpiac.4 acpibat.4 acpibtn.4 acpicpu.4 acpidock.4 \
@@ -27,7 +27,7 @@ MAN=	aac.4 ac97.4 acphy.4 \
 	iopsp.4 ip.4 ip6.4 ipcomp.4 ipgphy.4 ipmi.4 ips.4 ipsec.4 ipw.4 \
 	isa.4 isagpio.4 isapnp.4 ises.4 isp.4 it.4 iwi.4 iwn.4 ixgb.4 \
 	jmb.4 \
-	ksyms.4 kue.4 lc.4 lge.4 lii.4 lkm.4 lm.4 \
+	kate.4 ksyms.4 kue.4 lc.4 lge.4 lii.4 lkm.4 lm.4 \
 	lmc.4 lmenv.4 lmn.4 lmtemp.4 lo.4 lofn.4 lpt.4 lxtphy.4 luphy.4 \
 	maestro.4 mainbus.4 malo.4 maxds.4 maxtmp.4 mbg.4 midi.4 mii.4 mfi.4 \
 	moscom.4 mpi.4 mpu.4 msk.4 msts.4 mtd.4 mtdphy.4 multicast.4 mtio.4 \
diff --git a/share/man/man4/kate.4 b/share/man/man4/kate.4
new file mode 100644
index 00000000000..8fa2cb437b4
--- /dev/null
+++ b/share/man/man4/kate.4
@@ -0,0 +1,98 @@
+.\"	$OpenBSD: kate.4,v 1.1 2008/03/27 01:54:44 cnst Exp $
+.\"
+.\" Copyright (c) 2008 Constantine A. Murenin <cnst+openbsd@bugmail.mojo.ru>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate: March 27 2008 $
+.Dt KATE 4
+.Os
+.Sh NAME
+.Nm kate
+.Nd AMD K8 temperature sensor
+.Sh SYNOPSIS
+.Cd "kate* at pci?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the temperature sensors available in the
+AMD K8 family of processors.
+.Pp
+These sensors were officially introduced with
+Revision F Family 0Fh processors,
+and provide 1 degC accuracy.
+Precision was improved in Revision G chips,
+which provide two more bits for 0.25 degC steppings.
+Each core may have two temperature sensors, and
+there may be up to two cores per package.
+.Pp
+Multiprocessor systems would have one instance of
+.Nm
+per each chip.
+In each instance,
+.Va temp0
+and
+.Va temp1
+sensors
+correspond to the temperature sensors on the first core,
+whereas
+.Va temp2
+and
+.Va temp3
+correspond to the temperature sensors on the second core.
+As such, single core chips may have two sensors,
+and dual-core dual-processor systems may have as many as 8
+temperature sensors in total.
+.Pp
+Since many prior revisions of the chips appear to have
+valid readings for at least some temperature sensors
+in the same address space as the abovementioned revisions,
+the driver may also attach on such older revisions provided
+that it finds some sensor readings that appear valid.
+However, in such cases
+.Nm
+would not print the core revision information into the dmesg.
+.Pp
+Sensor values are made available through the
+.Xr sysctl 8
+interface.
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr pci 4 ,
+.Xr sensorsd 8 ,
+.Xr sysctl 8
+.Rs
+.%T "BIOS and Kernel Developer's Guide for AMD NPT Family 0Fh Processors"
+.%D July 2007
+.%R Publication # 32559
+.%P pp. 21--23 and pp. 179--184
+.\" .%O http://www.amd.com/us-en/assets/content_type/white_papers_and_tech_docs/32559.pdf
+.Re
+.Rs
+.%T "Revision Guide for AMD NPT Family 0Fh Processors"
+.%D February 2008
+.%R Publication # 33610
+.\" .%O http://www.amd.com/us-en/assets/content_type/white_papers_and_tech_docs/33610.pdf
+.Re
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Ox 4.4 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Constantine A. Murenin Aq cnst@openbsd.org
+whilst at the University of Waterloo.
diff --git a/share/man/man4/pci.4 b/share/man/man4/pci.4
index 3f13af8f2aa..120bfd64f17 100644
--- a/share/man/man4/pci.4
+++ b/share/man/man4/pci.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pci.4,v 1.247 2008/03/09 20:17:01 jmc Exp $
+.\"	$OpenBSD: pci.4,v 1.248 2008/03/27 01:54:44 cnst Exp $
 .\"	$NetBSD: pci.4,v 1.29 2000/04/01 00:32:23 tsarna Exp $
 .\"
 .\" Copyright (c) 2000 Theo de Raadt.  All rights reserved.
@@ -31,7 +31,7 @@
 .\" (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 $Mdocdate: March 9 2008 $
+.Dd $Mdocdate: March 27 2008 $
 .Dt PCI 4
 .Os
 .Sh NAME
@@ -385,6 +385,8 @@ AMD Elan SC520 System Controller with watchdog timer and GPIO
 Geode SC1100/SCx200 IAOC watchdog timer device
 .It Xr ichwdt 4
 Intel 6300ESB ICH watchdog timer device
+.It Xr kate 4
+AMD K8 temperature sensor
 .It Xr pwdog 4
 Quancom PWDOG1 watchdog timer device
 .It Xr viaenv 4