NAME

       setalarm - sets the system to start and run a script at specified times.

SYNOPSIS

       setalarm [ -p ] [ [h]h:mm ] [ -o offset ] [ command ]

       setalarm [ -p ] [ -c m h dom mon dow ] [ -o offset ] [ command ]

       setalarm [ -p ] [ -u utc ] [ -o offset ] [ command ]

       setalarm -d

DESCRIPTION

       This  should be run as root, unless using the -p option. The time to wake the computer can
       be given in three possible formats.  The simplest is just a time, written hh:mm  or  h:mm.
       This time is interpreted as the earliest time in the future when that time occurs.  If the
       -c option is  provided,  a  cron-formatted  recurrence  (minute  hour  day_of_month  month
       day_of_week)  may  follow.  Special times such as "@hourly" are not accepted.  With the -u
       option, the time to wake the computer should be provided in UTC format.

       command is run at the closest time in the future that matches the recurrence rules  or  at
       the  time  specified  using an exact hh:mm or UTC time. For this to occur, the computer is
       woken up several minutes in advance to allow for boot time. By default, this "offset" is 5
       minutes,  but  can  be  changed with the -o option, in which case the computer is woken up
       offset minutes in advance. To ensure that the computer will  wake  given  the  -c  option,
       crontab entries are made in root's crontab to rerun setalarm as necessary.

       With  the  -p  option,  setalarm  will  not make any changes to the system wake time or to
       root's crontab. Instead, setalarm just prints the time, in  UTC,  at  which  the  computer
       would be set to wake up with the given input.

       Given the -d option, setalarm removes all alarms.

NOTES

       setalarm  was  created  for  use  with wakeup, a fully customizable and extensible talking
       alarm clock. However, it is generally usable as  a  convenient  wrapper  for  setting  the
       system wakeup (see http://www.mythtv.org/wiki/ACPI_Wakeup for details about ACPI wakeup)

SEE ALSO

       wakeup(1), wakeup-settings(1), cron, crontab

AUTHOR

       The   program   and   its   documentation   are   copyrighted  (C)  2012  by  David  Glass
       <dsglass@gmail.com>. All rights reserved. They are distributed under the terms of the  GNU
       General Public License version 3 or later.