uptab

uptab − XML time uptime spans

uptab(5) files are XML-based and as such must obey XML syntax. The root element is an <uptab> element. The <span> children of <uptab> each define an amount of uptime for the Shuriken uptime scheduling system The uptabrtc(8) program saves an alarm to the Linux real time clock daily alarm to ensure the system is up for the spans of time specified in the uptab(5) file.

The begin attribute of a <span> element specifies the date and time (up to minute precision) of a span of time. The date-time format is ISO 8601 which is YYYY-MM-DDTHH:MMZ T is a literal letter T. Z can be replaced with a timezone designator (offset from UTC/GMT). Examples of timezones are: +3:00 -7:00

The duration attribute of a <span> element specifies the duration of a span of time, again with minute precision and using ISO 8601 formatting. The duration format appears as: PyrsYmnthsMdaysDThrsHminsM with yrs mnths days hrs mins replaced with amounts of time. P Y M DT H M are all literal capital letters. However, Shuriken only correctly interprets the days, hours, and minute components (calendrical calculations are actually too complicated).

The description attribute of a <span> element is a simple plaint text field for including a unique identifier for a span of time. This is useful for applications that may want to remove a span of time from the uptab(5) file at a later time.

Jared Krinke <deraj@users.sourceforge.net>

shuriken(7), uptabrtc(8), uptab(8), mustbeup(8)

If you value the Shuriken uptime scheduler, have a PayPal account, and are feeling generous, please make a micropayment donation to furiousj@u.washington.edu to support the author. Suggested donation: $0.25. Credit card payments are currently not accepted due to overhead.