Cron

Parses /etc/cron.d/*, /etc/crontab

Author: Raphael Pinson rap.nosp@m.hink@gmai.nosp@m.l.com

Summary
CronParses /etc/cron.d/*, /etc/crontab
ReferenceThis lens tries to keep as close as possible to `man 5 crontab` where possible.
LicenseThis file is licensed under the LGPL v2+, like the rest of Augeas.
Lens UsageSample usage of this lens in augtool
Configuration filesThis lens applies to /etc/cron.d/* and /etc/crontab.
USEFUL PRIMITIVES
Generic primitives
eol
indent
comment
empty
num
alpha
alphanum
entry_prefix
Separators
sep_spc
sep_eq
ENTRIES
shellvarA shell variable in crontab
- prefix of an entry
minute
hour
dayofmonth
month
dayofweek
user
timeTime in the format “minute hour dayofmonth month dayofweek”
the valid values for schedules
scheduleTime in the format “@keyword”
entryA crontab entry
lnsThe cron lens
filter

Reference

This lens tries to keep as close as possible to `man 5 crontab` where possible.

License

This file is licensed under the LGPL v2+, like the rest of Augeas.

Lens Usage

Sample usage of this lens in augtool

  • Get the entry that launches ‘/usr/bin/ls’
match '/files/etc/crontab/entry[. = "/usr/bin/ls"]'

Configuration files

This lens applies to /etc/cron.d/* and /etc/crontab.  See filter.

USEFUL PRIMITIVES

Generic primitives

eol

let eol     = Util.eol

indent

let indent  = Util.indent

comment

let comment = Util.comment

empty

let empty   = Util.empty

num

let num        = /[0-9*][0-9\/,*-]*/

alpha

let alpha      = /[A-Za-z]{3}/

alphanum

let alphanum   = (num|alpha) . ("-" . (num|alpha))?

entry_prefix

let entry_prefix = /-/

Separators

sep_spc

let sep_spc = Util.del_ws_spc

sep_eq

let sep_eq  = Util.del_str "="

ENTRIES

shellvar

let shellvar = let key_re = /[A-Za-z-1-9_]+(\[[0-9]+\])?/ - "entry" in let sto_to_eol = store /[^\n]*[^ \t\n]/ in [ key key_re . sep_eq . sto_to_eol . eol ]

A shell variable in crontab

- prefix of an entry

minute

let minute     = [ label "minute"       . store num ]

hour

let hour       = [ label "hour"         . store num ]

dayofmonth

let dayofmonth = [ label "dayofmonth" . store num ]

month

let month      = [ label "month"        . store alphanum ]

dayofweek

let dayofweek  = [ label "dayofweek"  . store alphanum ]

user

let user       = [ label "user"         . store Rx.word ]

time

let time        = [ label "time" . minute . sep_spc . hour  . sep_spc . dayofmonth . sep_spc . month . sep_spc . dayofweek ]

Time in the format “minute hour dayofmonth month dayofweek”

the valid values for schedules

schedule

let schedule    = [ label "schedule" . Util.del_str "@"
                   
. store schedule_re ]

Time in the format “@keyword”

entry

let entry       = [ label "entry" . indent . prefix? . ( time | schedule ) . sep_spc . user . sep_spc . store Rx.space_in . eol ]

A crontab entry

lns

let lns = ( empty | comment | shellvar | entry )*

The cron lens

filter

let eol     = Util.eol
let indent  = Util.indent
let comment = Util.comment
let empty   = Util.empty
let num        = /[0-9*][0-9\/,*-]*/
let alpha      = /[A-Za-z]{3}/
let alphanum   = (num|alpha) . ("-" . (num|alpha))?
let entry_prefix = /-/
let sep_spc = Util.del_ws_spc
let sep_eq  = Util.del_str "="
let shellvar = let key_re = /[A-Za-z-1-9_]+(\[[0-9]+\])?/ - "entry" in let sto_to_eol = store /[^\n]*[^ \t\n]/ in [ key key_re . sep_eq . sto_to_eol . eol ]
A shell variable in crontab
let minute     = [ label "minute"       . store num ]
let hour       = [ label "hour"         . store num ]
let dayofmonth = [ label "dayofmonth" . store num ]
let month      = [ label "month"        . store alphanum ]
let dayofweek  = [ label "dayofweek"  . store alphanum ]
let user       = [ label "user"         . store Rx.word ]
let time        = [ label "time" . minute . sep_spc . hour  . sep_spc . dayofmonth . sep_spc . month . sep_spc . dayofweek ]
Time in the format “minute hour dayofmonth month dayofweek”
let schedule    = [ label "schedule" . Util.del_str "@"
                   
. store schedule_re ]
Time in the format “@keyword”
let entry       = [ label "entry" . indent . prefix? . ( time | schedule ) . sep_spc . user . sep_spc . store Rx.space_in . eol ]
A crontab entry
let lns = ( empty | comment | shellvar | entry )*
The cron lens
Close