Module `Cron`Source

Cron is a task scheduler standardized by POSIX.

Sourcetype t

The type for cron table.

Sourcetype entry

The type of cron table entry.

Sourceval entries : t -> entry list

entries crontab observes crontab entries.

Sourceval make : entry list -> t

make entries builds a contrab from a list of entries.

Sourcetype field =

| All
(*
All is equivalent to "*".
*)
| List of element list
(*
Enumerate [1; 3; 9] is equivalent to "1,3,9"
*)

Sourceand element = private

| Single of int
(*
Single k is the singleton value "k".
*)
| Range of int * int
(*
Range (a, b) is the range "a-b".
*)

Sourcetype validator = int -> unit

Not all integers are valid. A validator makes sure only valid values are used.

Sourceval valid_minute : validator

A minute is valid if in 0..59.

Sourceval valid_hour : validator

An hour is valid if in 0..23.

Sourceval valid_day_of_the_month : validator

A day of the month is valid if in 1.31.

Sourceval valid_day_of_the_week : validator

A day of the week is valid if in 0..6.

Sourceval valid_month_of_the_year : validator

A month of the year is valid if in 1..12.

Sourceval single : validator -> int -> element

Build a single valid element.

Sourceval range : validator -> int -> int -> element

Build a range of valid elements.

Sourceexception InvalidElement of string * int

Source

val make_entry : 
  ?minute:field ->
  ?hour:field ->
  ?day_of_the_month:field ->
  ?month_of_the_year:field ->
  ?day_of_the_week:field ->
  string ->
  entry

make_entry command creates a crontab entry executing command.

parameter minute
must be in 0..59.

parameter hour
must be in 0..23.

parameter day_of_the_month
must be in 1.31.

parameter month_of_the_year
must be in 1..12.

parameter day_of_the_week
must be in 0..6 with 0 = Sunday.

raises InvalidEntryField
if some input does not conform to the previous constraint. For all field, the default value is All.

Sourceval minute : entry -> field

minute entry returns an integer in 0..59. None means Any.

Sourceval hour : entry -> field

hour entry returns an integer in 0..23. None means Any.

Sourceval day_of_the_month : entry -> field

day_of_the_month entry returns an integer in 1..31. None means Any.

Sourceval month_of_the_year : entry -> field

month_of_the_year entry returns an integer in 0..11. None means Any.

Sourceval day_of_the_week : entry -> field

day_of_the_week entry returns an integer in 0..6. None means Any.

Sourceexception ParseError of int * string

Sourceval entry_of_string : string -> entry

entry_of_string line turns a crontab line into an entry.

raises ParseError
if line does not conform to POSIX.

Sourceval string_of_entry : entry -> string

string_of_entry entry produces a textual representation of entry conforming to the POSIX standard.

raises ParseError
if line does not conform to POSIX.

Sourceval crontab_of_string : string -> t

crontab_of_string input reads input as a crontab is possible.

raises ParseError
in case of syntax error.

Sourceval string_of_crontab : t -> string

string_of_crontab crontable produces a textual representation of crontable conforming to the POSIX standard.

Sourceexception CrontabError of Unix.process_status

Sourceval crontab_install : ?user:string -> t -> unit

crontab_install crontable installs the crontable.

parameter user
is the current user by default.

raises CrontabError
if something went wrong.

Sourceval crontab_get : ?user:string -> unit -> t

crontab_list () returns the currently installed cron table.

parameter user
is the current user by default.

Sourceval crontab_insert_entry : ?user:string -> entry -> unit

crontab_insert_entry entry installs a new entry in the current crontab, if it is not already there.

Sourceval crontab_remove_entry : ?user:string -> entry -> unit

crontab_remove_entry entry removes an entry in the current crontab.

raises Not_found
if it does not exist.

Sourceval crontab_remove : ?user:string -> unit -> unit

crontab_remove () removes the currently installed cron table.

parameter user
is the current user by default.

Sourceval version : string

This library version.

package crontab

Module CronSource

Module `Cron`Source