ENVSTAT(8)

NAME
envstat - display environmental sensor readings

SYNOPSIS
envstat [-flr] [-i interval] [-n headrep] [-s sensor1,sensor2,...] [-w width] [device]

DESCRIPTION
envstat displays sensor readings from any device which supports the envsys(4) API. Readings are displayed in columns, one column per sensor. Column widths as well as displayed sensors are fully customizable. The column headers display the name (stored in the device driver) as well as the units of each sensor.

The options are as follows:

-f  Display any temperature values in degrees Fahrenheit. The default is to display temperature values in degrees Celsius.

-l  List the names of all supported sensors, one per line. Use of this flag causes envstat to ignore all other option flags.

-i  Repeat the display every interval seconds. Note that some devices do not provide fresh values on demand. See the individual device's manual page for meaningful values for interval. If not specified, or specified as 0, envstat produces one line of values and exits.

-n  Display a new header every headrep lines. An argument of 0 disables header line printing completely. The default is every 22 lines.

-r  Display the sensors row wise. This is useful when the number of sensors is large. This option also displays fractional values when present (e.g., the percentage battery charge).

-s  Restrict the display to the named sensors. The sensor names must be supplied as a comma separated list. Sensor names are case sensitive.

-w  Use width as the column width for the output. Each column is additionally separated by a single space. The default is either the length of the longest sensor name or spread evenly to fill 80 columns, whichever is greater.

EXAMPLES
Display the “acpibat0 charge ” sensor on one line (row format) every ten seconds:
    envstat -s acpibat0 charge -r -i 10

SEE ALSO
acpiacad(4), acpibat(4), acpitz(4), adt7467c(4), aiboost(4), envsys(4), ipmi(4), it(4), lm(4), lmtemp(4), nsclpcsio(4), owtemp(4), sparc/tctrl(4), sparc64/envctrl(4), tm121temp(4), ug(4), viaenv(4).

HISTORY
envstat appeared in NetBSD 1.5.