*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> power_onoff (1m)              
Title
Content
Arch
Section
 

Contents


 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 ]
      
      
 Similar pages
Name OS Title
power OpenBSD power button and power fail support
wakeupat IRIX request that system power back on at a future time
ups_mond HP-UX HP PowerTrust Uninterruptible Power System monitor daemon
ups_conf HP-UX HP PowerTrust Uninterruptible Power System (UPS) monitor configuration file
wol Tru64 Send network packet over subnet to turn on target system power
dopowerhooks NetBSD run all power hooks
dopowerhooks OpenBSD run all power hooks
powerhook_disestablish OpenBSD add or remove a power hook
exp IRIX exponential, logarithm, power
powerhook_establish OpenBSD add or remove a power hook
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service