share/man/man4/km.4

   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
  24 To compile this driver into the kernel,
  25 place the following lines in your
  26 kernel configuration file:
  27 .Bd -ragged -offset indent
  28 .Cd "device pci"
  29 .Cd "device km"
  30 .Ed
  31 .Pp
  32 Alternatively, to load the driver as a
  33 module at boot time, place the following line in
  34 .Xr loader.conf 5 :
  35 .Bd -literal -offset indent
  36 km_load="YES"
  37 .Ed
  38 .Sh DESCRIPTION
  39 The
  40 .Nm
  41 driver provides support for the temperature sensors available in the
  42 AMD Family 10h, 11h, 12h, 14h, 15h and 16h processors.
  43 .Pp
  44 Each chip reports one temperature sensor.
  45 Multiprocessor systems have one instance of
  46 .Nm
  47 per chip.
  48 The highest resolution supported by the driver is 0.125 degC.
  49 .Pp
  50 Sensor values are made available through the
  51 .Dv HW_SENSORS
  52 .Xr sysctl 3
  53 interface,
  54 and can be monitored with the
  55 .Xr systat 1
  56 .Ar sensors
  57 display,
  58 .Xr sensorsd 8
  59 and
  60 .Xr sysctl 8
  61 .Ar hw.sensors .
  62 For example, with an
  63 .Tn AMD
  64 .Tn Phenom X4
  65 9850 Black Edition 2.5GHz
  66 .Tn Socket AM2+
  67 125W quad-core processor:
  68 .Bd -literal -offset indent
  69 %sysctl hw.sensors.km0
  70 hw.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
 130 The
 131 .Nm
 132 driver first appeared in
 133 .Ox 4.4
 134 and
 135 .Dx 2.5 .
 136 .Sh AUTHORS
 137 .An -nosplit
 138 The
 139 .Nm
 140 driver was written for
 141 .Ox
 142 and
 143 .Dx
 144 by
 145 .An Constantine A. Murenin Aq Lk http://cnst.su/ ,
 146 Raouf Boutaba Research Group,
 147 David R. Cheriton School of Computer Science,
 148 University of Waterloo.