PERFORCE change 125356 for review

[Constantine A. Murenin]

http://perforce.freebsd.org/chv.cgi?CH=125356

Change 125356 by cnst at dale on 2007/08/19 19:03:35

	document HW_SENSORS
	
	Obtained from:	OpenBSD

Affected files ...

.. //depot/projects/soc2007/cnst-sensors/lib.libc.gen/sysctl.3#5 edit

Differences ...

==== //depot/projects/soc2007/cnst-sensors/lib.libc.gen/sysctl.3#5 (text+ko) ====

@@ -283,6 +283,7 @@
 .It "HW_FLOATINGPT	integer	no"
 .It "HW_MACHINE_ARCH	string	no"
 .It "HW_REALMEM	integer	no"
+.It "HW_SENSORS	node	not applicable"
 .El
 .Pp
 .Bl -tag -width 6n
@@ -306,6 +307,34 @@
 The machine dependent architecture type.
 .It Li HW_REALMEM
 The bytes of real memory.
+.It Li HW_SENSORS
+Third level comprises an array of
+.Li struct sensordev
+structures containing information about devices 
+that may attach hardware monitoring sensors. 
+.Pp
+Third, fourth and fifth levels together comprise an array of
+.Li struct sensor
+structures containing snapshot readings of hardware monitoring sensors.
+In such usage, third level indicates the numerical representation 
+of the sensor device name to which the sensor is attached 
+(device's xname and number shall be matched with the help of 
+.Li struct sensordev
+structure above), 
+fourth level indicates sensor type and 
+fifth level is an ordinal sensor number (unique to
+the specified sensor type on the specified sensor device).
+.Pp
+The
+.Sy sensordev
+and
+.Sy sensor
+structures
+and
+.Sy sensor_type
+enumeration
+are defined in
+.Aq Pa sys/sensors.h .
 .El
 .Ss CTL_KERN
 The string and integer information available for the CTL_KERN level