power_onoff(1M) power_onoff(1M)
NAME [Toc] [Back]
power_onoff - timed, automatic system power on, and power off
SYNOPSIS [Toc] [Back]
/usr/sbin/power_onoff -n
/usr/sbin/power_onoff time [date] [[next | +increment]
time_designation]
DESCRIPTION [Toc] [Back]
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 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.
power_onoff requires a UPS that is supported by the UPS monitor (see
ups_mond(1M)).
Command Line Arguments [Toc] [Back]
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 (,). A suffix 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 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,
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
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
power_onoff(1M) power_onoff(1M)
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 If followed by a time_designation of minutes, hours, days,
or weeks, months, or years, lets the user startup the system
+increment when the specified time_designation has elapsed. A
numerical 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 [Toc] [Back]
International Code Set Support
Single- and multi-byte character code sets are supported.
RETURN VALUE [Toc] [Back]
Exit code 0 is returned upon successful completion, otherwise non 0 is
returned.
DIAGNOSTICS [Toc] [Back]
power_onoff issues diagnostic messages when it encounters syntax
errors and out-of-range times.
EXAMPLES [Toc] [Back]
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
power_onoff 5:30 tomorrow
To make your system startup each weekday at 7:30 am and shutdown at
5:30 pm each week day, use crontab to execute the first entry on
Monday through Thursday and the second entry on Friday (see
crontab(1)).
power_onoff 7:30 tomorrow
power_onoff 7:30 Monday
To startup the system at 8:15 on January 24, use
power_onoff 0815 Jan 24
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
power_onoff(1M) power_onoff(1M)
To startup the system at 5:15 on January 24, use
power_onoff 5:15 Jan 24
To startup the system at 9:30 tomorrow, use
power_onoff 9:30am tomorrow
To startup the system 24 hours from now, use
power_onoff now + 1 day
To shutdown the system and not start it up, use
power_onoff -n
WARNINGS [Toc] [Back]
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 limitations.
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 next and + increment within a single power_onoff
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 [Toc] [Back]
power_onoff was developed by HP.
FILES [Toc] [Back]
/var/tmp/timed_off fifo for communicating with
ups_mond.
SEE ALSO [Toc] [Back]
at(1), cron(1M), crontab(1), queuedefs(4), proto(4), kill(1), sam(1M),
ups_mond(1M).
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003 [ Back ] |