timer

Synopsis:
timer [-refnum <num | name> ] [-repeat <times>] <seconds> [<action>]
timer -delete [all] | [<num | name>]

Description:
This command allows the client to store arbitrary commands scheduled for execution at some specified number of seconds in the future. Any number of timers may be set, and any number of commands may be used in a timer. Timers with multiple commands must have those commands surrounded by curly braces.
All timers are assigned a reference number to distinguish them from each other. A specific reference number may be specified, though the number may not be one that is already in use, and it must be either a non-negative integer or a string of no more than 10 characters (longer strings will be silently truncated). The reference number or name is also used to delete a timer. Using the timer command with no arguments will display the list of pending timers. When used with -repeat, the timer will only expire after running through number of times.

Options:
-delete <num> | all delete the numbered timer, or all timers
-list same as using no arguments; lists all timers
-refnum <num | name> set a timer with the given reference number or name
-repeat cycle through the timer times before expiring
-update re-assign the timer with new values
-window specifies in which window the timer should go off

Examples:
To create a reminder that X Files will be on in 10 minutes:
timer 600 {
..beep echo *** X Files is on!
..echo *** Why are you still on napster?!
}

To assign a specific refnum to that timer:
timer -ref 103 600 { ... }
timer -ref foo 600 { ... }

This timer's reference name will be truncated to "foobarbooy":
timer -ref foobarbooya 45 { ... }

To delete all pending timers:
timer -d all

Other Notes:
TekNap attempts to keep track of which server and window each timer was started from. Each timer will be reverted back to that window and server when it expires.

Back