1.\" $NetBSD: envstat.8,v 1.54 2010/02/09 03:19:51 cnst Exp $ 2.\" 3.\" Copyright (c) 2000, 2007, 2008, 2009 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Juan Romero Pardines and Bill Squier. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.Dd January 29, 2010 31.Dt ENVSTAT 8 32.Os 33.Sh NAME 34.Nm envstat 35.Nd utility to handle environmental sensors 36.Sh SYNOPSIS 37.Nm 38.Op Fl DfIlSTWx 39.Op Fl c Ar file 40.Op Fl d Ar device 41.Op Fl i Ar interval 42.Op Fl s Ar "device:sensor,..." 43.Op Fl w Ar width 44.Sh DESCRIPTION 45.Nm 46is a utility that handles various aspects of the sensors 47registered with the 48.Xr envsys 4 49framework. 50It is capable of displaying sensor values as well as 51changing parameters and setting critical limits for the sensors. 52.Pp 53In display mode, column widths as well as displayed sensors 54are fully customizable. 55Critical limits or other properties can be set via the configuration file. 56If critical limits were set previously, the display mode will show 57the critical limits in addition to the current values. 58.Pp 59The following options are available: 60.Bl -tag -width flag 61.It Fl c 62Accepts a file as argument to set properties for sensors in 63devices registered with the framework. 64See the 65.Xr envsys.conf 5 66manual page for more information. 67.It Fl D 68Display the names of the drivers that were registered with 69the 70.Xr envsys 4 71framework, one per line and some properties for the driver: refresh timeout 72value, for example. 73.It Fl d Ar device 74Display only the sensors for the given 75.Ar device . 76This is useful when there are multiple devices registered and 77you want to only see results from a specific device. 78.It Fl f 79Display temperature values in degrees Fahrenheit. 80The default is to display temperature values in degrees Celsius. 81.It Fl I 82This flag skips the sensors with invalid state, these are normally 83shown using the 84.Qq N/A 85string by default. 86.It Fl i Ar interval 87Repeat the display every 88.Ar interval 89seconds. 90Note that some devices do not provide fresh values on demand. 91See the individual device's manual page for meaningful values for 92.Ar interval . 93If not specified, or specified as 0, 94.Nm 95produces one round of values and exits. 96.It Fl k 97Display temperature values in Kelvin. 98The default is to display temperature values in degrees Celsius. 99.It Fl l 100List the names of all supported sensors, one per line. 101Use of this flag causes 102.Nm 103to ignore all other option flags. 104.It Fl r 105This flag is provided for compatibility reasons and there's no need 106to use it. 107In the previous implementation, it was used to enable the 108row mode; this mode is now the default. 109.It Fl S 110This flag is used to restore defaults to all devices registered with 111the framework. 112This will remove all properties that were set in 113the configuration file to the setting that the drivers use by 114default. 115.It Fl s Ar "device:sensor,..." 116Restrict the display to the named sensors. 117The pair device and sensor description must be supplied as a comma separated list. 118Device as well as sensor descriptions are case sensitive. 119.It Fl T 120Create and display max, min and average statistics for a sensor. 121Must be used with an 122.Ar interval , 123otherwise statistics cannot be collected up. 124Please note that to get realistic 125values a lower interval value should be used, but that will also increase 126overhead. 127.It Fl w Ar width 128Use 129.Ar width 130as the column width for the output. 131Each column is additionally separated by a single space. 132The default is the length of the longest sensor name. 133.It Fl W 134This option has no effect. 135It is retained for historical reasons. 136.It Fl x 137Shows the property list used by the 138.Xr sysmon_envsys 9 139framework that contains details about all registered drivers 140and sensors. 141.El 142.Sh EXAMPLES 143To display the 144.Dq charge 145sensor of the driver 146.Ar acpibat0 147in one line every ten seconds: 148.Pp 149.Dl $ envstat -s \*qacpibat0:charge\*q -i 10 150.Pp 151To list the drivers that are currently registered with 152.Xr envsys 4 : 153.Pp 154.Dl $ envstat -D 155.Pp 156To display the sensors of the driver 157.Ar aiboost0 : 158.Pp 159.Dl $ envstat -d aiboost0 160.Pp 161To set all properties specified in the configuration file: 162.Pp 163.Dl $ envstat -c /etc/envsys.conf 164.Pp 165To remove all properties that were set previously in the configuration 166file: 167.Pp 168.Dl $ envstat -S 169.Pp 170To display statistics for all sensors and ignoring sensors with 171invalid states every second: 172.Pp 173.Dl $ envstat -ITi1 174.Sh SEE ALSO 175.Xr proplib 3 , 176.Xr acpiacad 4 , 177.Xr acpibat 4 , 178.Xr acpitz 4 , 179.Xr admtemp 4 , 180.Xr aiboost 4 , 181.Xr aibs 4 , 182.Xr amdtemp 4 , 183.Xr aps 4 , 184.Xr arcmsr 4 , 185.Xr battery_pmu 4 , 186.Xr cac 4 , 187.Xr coretemp 4 , 188.Xr dbcool 4 , 189.Xr envctrl 4 , 190.Xr envsys 4 , 191.Xr finsio 4 , 192.Xr ipmi 4 , 193.Xr itesio 4 , 194.Xr lm 4 , 195.Xr lmtemp 4 , 196.Xr mfi 4 , 197.Xr nsclpcsio 4 , 198.Xr owtemp 4 , 199.Xr pic16lc 4 , 200.Xr smsc 4 , 201.Xr tctrl 4 , 202.Xr thinkpad 4 , 203.Xr tm121temp 4 , 204.Xr ug 4 , 205.Xr viaenv 4 , 206.Xr envsys.conf 5 207.Sh HISTORY 208.Nm 209appeared in 210.Nx 1.5 . 211It was completely rewritten from scratch for 212.Nx 5.0 . 213.Sh AUTHORS 214.An -nosplit 215The 216.Nm 217utility that appeared in 218.Nx 5.0 219was written by 220.An Juan Romero Pardines . 221The previous version was written by 222.An Bill Squier . 223