power_onoff.1m (2010 09)
p
power_onoff(1M) power_onoff(1M)
NAME
power_onoff - timed, automatic system power on, and power off
SYNOPSIS
/usr/sbin/power_onoff -n
/usr/sbin/power_onoff
time [ date ][[
next +increment] time_designation]
DESCRIPTION
power_onoff instructs the UPS monitor (ups_mond) 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
power_onoff command-line argu-
ments.
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.
power_onoff requires a UPS that is supported by the UPS monitor (see ups_mond (1M)).
Command Line Arguments
The
power_onoff command has two forms, and recognizes the following arguments:
-n 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 numbers
separated by a colon (
: ), single quote ( ’ ), the letter "h" (
h ), a period ( . ), or comma ( , ).
Asuffix
am or pm can be appended. Otherwise a 24-hour clock time is understood. For
example, 0815, 8:15, 8’15, 8h15, 8.15, and 8,15 are read as 15 minutes after 8 in the
morning. The suffixes zulu and utc can be used to indicate Coordinated Universal Time.
The special names noon, midnight, now, and next are also recognized.
date Can be specified as either a day of the week (fully spelled out or abbreviated) or a date con-
sisting 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, abbreviated, 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’’, today and
tomorrow, are also recognized. If no date is
given,
today is assumed if the given time is greater than the current time; tomorrow 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.
next
or
+increment
If followed by a time_designation of
minutes, hours, days, weeks, months,oryears,
lets the user startup the system when the specified time_designation has elapsed. A numeri-
cal operator,
+increment, enables the user to schedule the startup several hours, days,
weeks, months, or years in advance (see EXAMPLES). Using the argument next is
equivalent to using an increment of +1. 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
power_onoff 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
power_onoff 5am Tuesday next week
To startup the system at 5:30 am tomorrow, use
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1