NAME¶
set_poweron_time - set a time in the future for the system to be powered on
SYNOPSIS¶
/usr/sbin/set_poweron_time [-s] -t absolute_time
/usr/sbin/set_poweron_time [-s] -d delta_time
/usr/sbin/set_poweron_time -m
/usr/sbin/set_poweron_time -h
DESCRIPTION¶
The
set_poweron_time utility is used to set a time in the future to power
on the system. The utility uses firmware interfaces provided by IBM ppc64
systems to provide this functionality.
When used with the
-t option, the utility will configure the system to
power-on at the specified date and time. This is usefule for specifying that
the sysetm should be restarted at 6 AM on Monday morning, for example.
When used with the
-d option, the utility will treat the specified time
as a delta from the present. This is useful for specifying that the system
should be restarted in 2 days, for example.
Times for the
-t and
-d options should be specified in the
following format:
Y<year>
M<month>
D<day>
h<hour>
m<minute>
s<second>
The month, if specified, should be in the range of 1-12. The day, if specified,
should be in the range of 1-31. The hour, if specified, should be in the range
of 0-23. The minute and second, if specified, should be in the range of 0-59.
- For the -t option:
- Year, month, and day default to the current date if not
specified. Hour, minute, and second default to 0 if not specified.
- For the -d option:
- Year, month, day, hour, minute, and second default to 0 if
not specified.
When used with the
-m option, the utility will print the maximum amount
of time in the future that the power-on time can be set (in days). This option
cannot be used with any others.
When used with the
-s option, the utility will shut down the system with
shutdown -h now after the power-on time has been set. If the utility is
unable to set the power-on time for any reason, the system will not be shut
down.
OPTIONS¶
- -t absolute_time
- specify the power-on time
- -d delta_time
- specify the power-on time as a delta from the current
time
- -m
- print the maximum amount of time in the future that the
power-on time can be set (in days)
- -s
- shut down the system after setting the power-on time. The
system will not be shut down if the power-on time cannot be set for any
reason.
- -h
- print a usage message with examples
EXAMPLES¶
Shut down the system and schedule it to restart in 12 hours
and 10 minutes:
set_poweron_time -d h12m10 -s
Schedule the system to restart at noon on June 15th of this
year:
set_poweron_time -t M6D15h12