power_onoff(1M)power_onoff(1M)NAMEpower_onoff - timed, automatic system power on, and power off
SYNOPSIS
time [date] ] time_designation]
DESCRIPTION
instructs the UPS monitor to shut down the system, and optionally
informs the monitor when to power on the system again. The UPS monitor
in turn instructs the uninterruptible power source (UPS) when to turn
the power off and on. The UPS monitor then proceeds to shut down the
system. The time to restart the system (power on) is specified with
command-line arguments.
Some UPS units limit the time that can elapse between the time the
power is turned off and the time it is turned back on. Please see your
UPS documentation for information about limitations.
requires a UPS that is supported by the UPS monitor (see ups_mond(1M)).
Command Line Arguments
The command has two forms, and recognizes the following arguments:
No power on.
Causes the system to be shutdown and not be powered back
on.
time Can be specified as one, two, or four digits. One- and
two-digit numbers represent hours; four digits represent
hours and minutes. time can also be specified as two num‐
bers separated by a colon single quote the letter "h" a
period or comma A suffix or can be appended. Otherwise a
24-hour clock time is understood. For example, and are
read as 15 minutes after 8 in the morning. The suffixes
and can be used to indicate Coordinated Universal Time.
The special names and are also recognized.
date Can be specified as either a day of the week (fully spelled
out or abbreviated) or a date consisting of a day, a month,
and optionally a year. The day and year fields must be
numeric, and the month can be fully spelled out, abbrevi‐
ated, or numeric. These three fields can be in any order,
and be separated by punctuation marks such as slash hyphen
period or comma The years 00-68 would be interpreted as
2000-2068 and 69-99 would be 1969-1999. Two special
``days'', and are also recognized. If no date is given, is
assumed if the given time is greater than the current time;
is assumed if it is less. If the given month is less than
the current month (and no year is given), next year is
assumed.
or
If followed by a
time_designation of or lets the user startup the
system when the specified time_designation has
elapsed. A numerical operator, enables the user to
schedule the startup several hours, days, weeks,
months, or years in advance (see EXAMPLES). Using
the argument is equivalent to using an increment of
Both plural and singular forms of time_designation
are accepted.
EXTERNAL INFLUENCES
International Code Set Support
Single- and multi-byte character code sets are supported.
RETURN VALUE
Exit code 0 is returned upon successful completion, otherwise
non 0 is returned.
DIAGNOSTICS
issues diagnostic messages when it encounters syntax errors and
out-of-range times.
EXAMPLES
To startup the system at 5:00 am next Tuesday, use
To startup the system at 5:30 am tomorrow, use
To make your system startup each weekday at 7:30 am and shutdown
at 5:30 pm each week day, use to execute the first entry on Mon‐
day through Thursday and the second entry on Friday (see
crontab(1)).
To startup the system at 8:15 on January 24, use
To startup the system at 5:15 on January 24, use
To startup the system at 9:30 tomorrow, use
To startup the system 24 hours from now, use
To shutdown the system and not start it up, use
WARNINGS
Jobs can be submitted up to 2037. If jobs were submitted any
later than 2037, an error message will display "BAD DATE".
Some UPS units limit the time that can elapse between the time
the power is turned off and the time it is turned back on.
Please see your UPS documentation for information about limita‐
tions.
If the date argument begins with a number and the time argument
is also numeric (and without suffix), the time argument should
be a four-digit number that can be correctly interpreted as
hours and minutes.
Do not use both and within a single command; only the first
operator is accepted and the trailing operator is ignored. No
warning or error is produced.
The power cord must be disconnected before servicing the unit.
AUTHOR
was developed by HP.
FILES
fifo for communicating with ups_mond.
SEE ALSOat(1), cron(1M), crontab(1), queuedefs(4), proto(4), kill(1),
sam(1M), ups_mond(1M).
power_onoff(1M)