TinyMUX

@cron

Commands

Description

COMMAND: @cron / =

Schedules periodic execution of an attribute using Unix cron syntax. The attribute on the specified object is triggered according to the time specification given in .

The consists of five fields separated by spaces:

FieldRangeSpecial Names
Minute0-59
Hour0-23
Day of Month1-31
Month1-12jan-dec
Day of Week0-7sun-sat (0 and 7 are both Sunday)

Each field supports the following special characters:

  • * - Matches all values for that field.
  • 1-5 - Ranges. Matches values 1 through 5.
  • 1,3,5 - Lists. Matches values 1, 3, and 5.
  • */15 - Steps. Matches every 15th value (e.g., 0, 15, 30, 45 for minutes).

When both Day of Month and Day of Week are specified (i.e., neither is *), the trigger fires when either condition is met (OR semantics), consistent with Vixie cron behavior.

Cron entries are not persisted across server restarts. Use @startup to re-register cron entries when the server starts.

You must control the object to set a cron entry on it.

Examples

> @cron me/HOURLY = 0 * * * *

Triggers the HOURLY attribute on yourself at the top of every hour.

> @cron me/BACKUP = */15 * * * *

Triggers BACKUP every 15 minutes.

> @cron me/MORNING = 0 8 * * mon-fri

Triggers MORNING at 8:00 AM on weekdays.

> @cron me/MONTHLY = 0 0 1 * *

Triggers MONTHLY at midnight on the first day of each month.

> &STARTUP me = @cron me/HOURLY = 0 * * * *

Ensures the cron entry is re-registered after a server restart.

@crondel, @crontab, @daily, @startup, @wait.