xref: /dragonfly/share/man/man4/km.4 (revision bc9cc675)
1.\"	$OpenBSD: km.4,v 1.9 2013/07/16 16:05:49 schwarze Exp $
2.\"
3.\" Copyright (c) 2008/2010 Constantine A. Murenin <cnst+dfly@bugmail.mojo.ru>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd August 2, 2020
18.Dt KM 4
19.Os
20.Sh NAME
21.Nm km
22.Nd AMD K10 temperature sensor
23.Sh SYNOPSIS
24To compile this driver into the kernel,
25place the following lines in your
26kernel configuration file:
27.Bd -ragged -offset indent
28.Cd "device pci"
29.Cd "device km"
30.Ed
31.Pp
32Alternatively, to load the driver as a
33module at boot time, place the following line in
34.Xr loader.conf 5 :
35.Bd -literal -offset indent
36km_load="YES"
37.Ed
38.Sh DESCRIPTION
39The
40.Nm
41driver provides support for the temperature sensors available in the
42AMD Family 10h, 11h, 12h, 14h, 15h and 16h processors.
43.Pp
44Each chip reports one temperature sensor.
45Multiprocessor systems have one instance of
46.Nm
47per chip.
48The highest resolution supported by the driver is 0.125 degC.
49.Pp
50Sensor values are made available through the
51.Dv HW_SENSORS
52.Xr sysctl 3
53interface,
54and can be monitored with the
55.Xr systat 1
56.Ar sensors
57display,
58.Xr sensorsd 8
59and
60.Xr sysctl 8
61.Ar hw.sensors .
62For example, with an
63.Tn AMD
64.Tn Phenom X4
659850 Black Edition 2.5GHz
66.Tn Socket AM2+
67125W quad-core processor:
68.Bd -literal -offset indent
69%sysctl hw.sensors.km0
70hw.sensors.km0.temp0: 60.50 degC
71.Ed
72.Sh SEE ALSO
73.Xr systat 1 ,
74.Xr sysctl 3 ,
75.Xr amdtemp 4 ,
76.Xr intro 4 ,
77.Xr kate 4 ,
78.Xr pci 4 ,
79.Xr sensorsd 8 ,
80.Xr sysctl 8
81.Rs
82.%T "BIOS and Kernel Developer's Guide for AMD Family 10h Processors"
83.%D March 26, 2008
84.%R Publication # 31116
85.%P pp. 236--237 and pp. 243--244
86.Re
87.Rs
88.%T "BIOS and Kernel Developer's Guide for AMD Family 11h Processors"
89.%D July 07, 2008
90.%R Publication # 41256
91.%P pp. 156--157 and pp. 159--160
92.Re
93.Rs
94.%T "BIOS and Kernel Developer's Guide for AMD Family 12h Processors"
95.%D October 06, 2011
96.%R Publication # 41131 Rev 3.02
97.%P pp. 303--304 and p. 316
98.Re
99.Rs
100.%T "BIOS and Kernel Developer's Guide for AMD Family 14h Models 00h-04h Processors"
101.%D May 02, 2011
102.%R Publication # 43170
103.%P pp. 277--278 and pp. 280--282
104.Re
105.Rs
106.%T "BIOS and Kernel Developer's Guide for AMD Family 15h Models 00h-0Fh Processors"
107.%D January 23, 2013
108.%R Publication # 42301 Rev 3.14
109.%P pp. 374--375 and pp. 293--294
110.Re
111.Rs
112.%T "BIOS and Kernel Developer's Guide for AMD Family 15h Models 10h-1Fh Processors"
113.%D June 04, 2013
114.%R Publication # 42300 Rev 3.10
115.%P p. 419 and pp. 432--433
116.Re
117.Rs
118.%T "BIOS and Kernel Developer's Guide for AMD Family 15h Models 30h-3Fh Processors"
119.%D June 17, 2014
120.%R Publication # 49125 Rev 3.03
121.%P p. 440 and pp. 457--458
122.Re
123.Rs
124.%T "Preliminary BIOS and Kernel Developer's Guide for AMD Family 16h Models 00h-0Fh Processors"
125.%D May 30, 2013
126.%R Publication # 48751 Rev 3.00
127.%P p. 400 and pp. 418--419
128.Re
129.Sh HISTORY
130The
131.Nm
132driver first appeared in
133.Ox 4.4
134and
135.Dx 2.5 .
136.Sh AUTHORS
137.An -nosplit
138The
139.Nm
140driver was written for
141.Ox
142and
143.Dx
144by
145.An Constantine A. Murenin Aq Lk http://cnst.su/ ,
146Raouf Boutaba Research Group,
147David R. Cheriton School of Computer Science,
148University of Waterloo.
149