Envsys


The envsys framework is a kernel-level hardware monitoring sensors framework in NetBSD. , the framework is used by close to 85 device drivers to export various environmental monitoring sensors, as evidenced by references of the sysmon_envsys_register symbol within the sys path of NetBSD; with temperature sensors, ENVSYS_STEMP, being the most likely type to be exported by any given driver. Sensors are registered with the kernel through sysmon_envsys API. Consumption and monitoring of sensors from the userland is performed with the help of envstat utility through proplib through ioctl against the /dev/sysmon pseudo-device file, the powerd power management daemon that responds to kernel events by running scripts from /etc/powerd/scripts/, as well as third-party tools like symon and GKrellM from pkgsrc.

Features

The framework allows the user to amend the monitoring limits specified by the driver, and for the driver to perform monitoring of the sensors in kernel space, or even to programme a hardware chip to do the monitoring for the system automatically. Two levels of limits are defined: critical and warning, both of which additionally extend to an over and an under categorisation. If limit thresholds are crossed, a kernel event may be generated, which can be caught in the userland by powerd to execute a pre-defined user script. By comparison, in OpenBSD's hw.sensors, the monitoring of user-defined values is performed in userspace by sensorsd.
, the framework itself does not facilitate computer fan control, although the drivers could still implement interfacing with the fan-controlling capabilities of their chips through other means, for example, through a driver-specific sysctl interface, which is the approach taken by the dbcool driver. However, the drivers for the most popular Super I/O chips like lm and itesio do not implement any fan control at all.

History

The framework undergone two major revisions: the first version of envsys.h was committed on ; with envsys.4 man page following on. Between 2000 and 2007, the manual page for envsys in NetBSD stated that the "API is experimental", and that the "entire API should be replaced by a sysctl", "should one be developed"; it can be noted that in 2003 this was the exact approach taken by OpenBSD with sysctl hw.sensors when some of the envsys drivers were ported to OpenBSD.
The second revision came about on. The serialisation with userland was reimplemented using property lists with the help of NetBSD's new proplib library.
The envsys framework was the precursor to OpenBSD's sysctl hw.sensors framework in 2003, and many drivers, as well as some sensor types, have been ported back and forth between NetBSD and OpenBSD. Support for sensors of drive type has been added to NetBSD on, similar to drive type in OpenBSD, which was at the same time when bio and bioctl were ported from OpenBSD to NetBSD.