Work with cron
Note
Salt does not escape cron metacharacters automatically. You should backslash-escape percent characters and any other metacharacters that might be interpreted incorrectly by the shell.
salt.modules.cron.
get_entry
(user, identifier=None, cmd=None)¶Return the specified entry from user's crontab. identifier will be used if specified, otherwise will lookup cmd Either identifier or cmd should be specified.
User's crontab to query
Search for line with identifier
Search for cron line with cmd
CLI Example:
salt '*' cron.get_entry root identifier=task1
salt.modules.cron.
list_tab
(user)¶Return the contents of the specified user's crontab
CLI Example:
salt '*' cron.list_tab root
salt.modules.cron.
ls
(user)¶This function is an alias of list_tab
.
Return the contents of the specified user's crontab
CLI Example:
salt '*' cron.list_tab root
salt.modules.cron.
raw_cron
(user)¶Return the contents of the user's crontab
CLI Example:
salt '*' cron.raw_cron root
salt.modules.cron.
rm
(user, cmd, minute=None, hour=None, daymonth=None, month=None, dayweek=None, identifier=None)¶This function is an alias of rm_job
.
Remove a cron job for a specified user. If any of the day/time params are specified, the job will only be removed if the specified params match.
CLI Example:
salt '*' cron.rm_job root /usr/local/weekly salt '*' cron.rm_job root /usr/bin/foo dayweek=1
salt.modules.cron.
rm_env
(user, name)¶Remove cron environment variable for a specified user.
CLI Example:
salt '*' cron.rm_env root MAILTO
salt.modules.cron.
rm_job
(user, cmd, minute=None, hour=None, daymonth=None, month=None, dayweek=None, identifier=None)¶Remove a cron job for a specified user. If any of the day/time params are specified, the job will only be removed if the specified params match.
CLI Example:
salt '*' cron.rm_job root /usr/local/weekly
salt '*' cron.rm_job root /usr/bin/foo dayweek=1
salt.modules.cron.
rm_special
(user, cmd, special=None, identifier=None)¶Remove a special cron job for a specified user.
CLI Example:
salt '*' cron.rm_special root /usr/bin/foo
salt.modules.cron.
set_env
(user, name, value=None)¶Set up an environment variable in the crontab.
CLI Example:
salt '*' cron.set_env root MAILTO user@example.com
salt.modules.cron.
set_job
(user, minute, hour, daymonth, month, dayweek, cmd, commented=False, comment=None, identifier=None)¶Sets a cron job up for a specified user.
CLI Example:
salt '*' cron.set_job root '*' '*' '*' '*' 1 /usr/local/weekly
salt.modules.cron.
set_special
(user, special, cmd, commented=False, comment=None, identifier=None)¶Set up a special command in the crontab.
CLI Example:
salt '*' cron.set_special root @hourly 'echo foobar'
salt.modules.cron.
write_cron_file
(user, path)¶Writes the contents of a file to a user's crontab
CLI Example:
salt '*' cron.write_cron_file root /tmp/new_cron
Changed in version 2015.8.9.
Note
Some OS' do not support specifying user via the crontab command i.e. (Solaris, AIX)
salt.modules.cron.
write_cron_file_verbose
(user, path)¶Writes the contents of a file to a user's crontab and return error message on error
CLI Example:
salt '*' cron.write_cron_file_verbose root /tmp/new_cron
Changed in version 2015.8.9.
Note
Some OS' do not support specifying user via the crontab command i.e. (Solaris, AIX)