package crontab

  1. Overview
  2. Docs
Legend:
Library
Module
Module type
Parameter
Class
Class type

Cron is a task scheduler standardized by POSIX.

type t

The type for cron table.

type entry

The type of cron table entry.

val entries : t -> entry list

entries crontab observes crontab entries.

val make : entry list -> t

make entries builds a contrab from a list of entries.

type field =
  1. | All
    (*

    All is equivalent to "*".

    *)
  2. | List of element list
    (*

    Enumerate [1; 3; 9] is equivalent to "1,3,9"

    *)
and element = private
  1. | Single of int
    (*

    Single k is the singleton value "k".

    *)
  2. | Range of int * int
    (*

    Range (a, b) is the range "a-b".

    *)
type validator = int -> unit

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

val valid_minute : validator

A minute is valid if in 0..59.

val valid_hour : validator

An hour is valid if in 0..23.

val valid_day_of_the_month : validator

A day of the month is valid if in 1.31.

val valid_day_of_the_week : validator

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

val valid_month_of_the_year : validator

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

val single : validator -> int -> element

Build a single valid element.

val range : validator -> int -> int -> element

Build a range of valid elements.

exception InvalidElement of string * int
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.

val minute : entry -> field

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

val hour : entry -> field

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

val day_of_the_month : entry -> field

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

val month_of_the_year : entry -> field

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

val day_of_the_week : entry -> field

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

exception ParseError of int * string
val 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.

val 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.

val crontab_of_string : string -> t

crontab_of_string input reads input as a crontab is possible.

  • raises ParseError

    in case of syntax error.

val string_of_crontab : t -> string

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

exception CrontabError of Unix.process_status
val 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.

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

crontab_list () returns the currently installed cron table.

  • parameter user

    is the current user by default.

val 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.

val 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.

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

crontab_remove () removes the currently installed cron table.

  • parameter user

    is the current user by default.

val version : string

This library version.