HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

141

142

143

144

145

146

147

148

149

150

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man1m/naaagt.1m

________________________________________________________________

___ ___

power_onoff(1M) power_onoff(1M)

(Series 800 Only)

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 speciﬁed 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 speciﬁed as one, two, or four digits. One- and two-digit numbers represent hours; four

digits represent hours and minutes. time can also be speciﬁed as two numbers separated by a

colon (: ), single quote (’ ), the letter "h" (h ), a period (

. ), or comma (, ). A sufﬁx 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

sufﬁxes 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 speciﬁed as either a day of the week (fully spelled out or abbreviated) or a date consist-

ing of a day, a month, and optionally a year. The day and year ﬁelds must be numeric, and the

month can be fully spelled out, abbreviated, or numeric. These three ﬁelds 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.

+increment

If followed by a time_designation of

minutes, hours, days, weeks, months,oryears,

lets the user startup the system when the speciﬁed 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 singularforms 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 Release 11i: December 2000 − 1 − Section 1M−−649

___