16.35. cdist-type__cron(7)

16.35.1. NAME

cdist-type__cron - Installs and manages cron jobs

16.35.2. DESCRIPTION

This cdist type allows you to manage entries in a users crontab.

16.35.3. REQUIRED PARAMETERS

user

The user who's crontab is edited

command

The command to run.

16.35.4. OPTIONAL PARAMETERS

NOTE: All time-related parameters (--minute, --hour, --day_of_month --month and --day_of_week) defaults to *, which means to execute it always. If you set --hour 0 to execute the cronjob only at midnight, it will execute every minute in the first hour of the morning all days.

state

Either present or absent. Defaults to present.

minute

See crontab(5). Defaults to *

hour

See crontab(5). Defaults to *

day_of_month

See crontab(5). Defaults to *

month

See crontab(5). Defaults to *

day_of_week

See crontab(5). Defaults to *

raw

Take whatever the user has given instead of time and date fields. If given, all other time and date fields are ignored. Can for example be used to specify cron EXTENSIONS like reboot, yearly etc. See crontab(5) for the extensions if any that your cron implementation implements.

raw_command

Take whatever the user has given in the command and ignore everything else. If given, the command will be added to crontab. Can for example be used to define variables like SHELL or MAILTO.

16.35.5. EXAMPLES

# run Monday to Saturday at 23:15
__cron some-id --user root --command "/path/to/script" \
   --hour 23 --minute 15 --day_of_week 1-6

# run on reboot
__cron some-id --user root --command "/path/to/script" \
   --raw @reboot

# remove cronjob
__cron some-id --user root --command "/path/to/script" --state absent

# define default shell
__cron some-id --user root --raw_command --command "SHELL=/bin/bash" \
   --state present

16.35.6. SEE ALSO

crontab(5)

16.35.7. AUTHORS

Steven Armstrong <steven-cdist--@--armstrong.cc>

16.35.8. COPYING

Copyright (C) 2011-2013 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.