 |
Index for Section 8 |
|
 |
Alphabetical listing for E |
|
envconfig(8)
NAME
envconfig - Configures the Environmental Monitoring daemon
SYNOPSIS
/usr/sbin/envconfig -c var=value
/usr/sbin/envconfig start | stop
/usr/sbin/envconfig -q
FLAGS
Environmental Monitoring provides a means of detecting system threshold
conditions, that if exceeded, could result in a loss of data or damage to
the system itself. To detect and notify users of critical conditions, the
envmond daemon is used. This utility, envconfig, is used to customize the
envmond daemon. This section describes the envconfig flags you can use to
configure the daemon.
-c var=value
Sets the variables that specify how the system environment is
monitored. These variables are stored in the /etc/rc.config file
and are read by the envmond daemon at system startup. If a
variable is not set, the default value of that variable is
assumed.
ENVMON_CONFIGURED
Specifies the state of Environmental Monitoring. If this
variable is set to zero (0), the Environmental Monitoring
package is not started during the system boot. If this
variable is set to 1, and Environmental Monitoring is
supported by that platform, it is started during the system
boot. The default value is zero (0).
ENVMON_GRACE_PERIOD
Specifies the time (in minutes) that can elapse between the
detection of a high temperature condition and the shutdown of
the system. The default value is 15 minutes.
ENVMON_HIGH_THRESH
Specifies the threshold level that can be encountered before
the envmond daemon broadcasts a warning and suggested action.
ENVMON_MONITOR_PERIOD
Specifies the frequency (in seconds) between queries of the
system by the envmond daemon. The default value is 60
seconds.
ENVMON_USER_SCRIPT
Specifies the path of a user-defined script that you want to
the envmond daemon to execute when a high threshold level is
encountered. The envmond daemon continues to check the
environment after the script has executed and proceeds as
needed should the high threshold levels persist.
If you set this variable, the envmond daemon directs output
from the script to /dev/console. Output is not displayed on
standard output or written to a file as this is not the
behavior of the daemon. To display on standard output,
explicitly specify the logger command within the user defined
script.
start | stop
Turns the envmond daemon on or off after system startup.
-q Displays the values of ENVMON_CONFIGURED, ENVMON_GRACE_PERIOD,
ENVMON_HIGH_THRESH, ENVMON_MONITOR_PERIOD and ENVMON_USER_SCRIPT
as specified in the /etc/rc.config file. If a specified entry is
not found, the environmental variable is not displayed.
DESCRIPTION
The envconfig utility is used to customize the envmond daemon. You must
have root privileges to use this utility. Using this utility, you can:
· Specify whether or not Environmental Monitoring is turned on or off at
system startup.
· Specify how much time can elapse between the envmond daemon
encountering a critical condition and the daemon initiating an orderly
shutdown of the system.
· Specify how frequently the envmond daemon queries the system for
information.
· Start and stop the envmond after Environmental Monitoring has been
turned on at system startup.
· Display the settings of the environment variables as specified in the
/etc/rc.config file.
EXAMPLES
In the following example the system shuts down in 10 minutes if the
temperature does not fall below the critical threshold.
/usr/sbin/envconfig -c ENVMON_GRACE_PERIOD=10
FILES
/etc/rc.config
A database that contains the values of the environment monitoring
variables.
RELATED INFORMATION
Utilities: envmond(8)