1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00
community.general/docs/json/cron.json

109 lines
No EOL
3.1 KiB
JSON

{
"requirements": "cron",
"description": [
"Use this module to manage crontab entries. This module allows you to create named crontab entries, update, or delete them.",
"The module include one line with the description of the crontab entry \"#Ansible: <name>\" corresponding to the \"name\" passed to the module, which is used by future ansible/module calls to find/check the state."
],
"author": "Dane Summers",
"docuri": "cron",
"module": "cron",
"filename": "library/cron",
"examples": [
{
"code": "cron name=\"check dirs\" hour=\"5,2\" job=\"ls -alh > /dev/null\"",
"description": "Ensure a job that runs at 2 and 5 exists. Creates an entry like \"* 5,2 * * ls -alh > /dev/null\""
},
{
"code": "name=\"an old job\" cron job=\"/some/dir/job.sh\" state=absent",
"description": "Ensure an old job is no longer present. Removes any job that is preceded by \"#Ansible: an old job\" in the crontab"
}
],
"version_added": "0.9",
"short_description": "Manage crontab entries.",
"now_date": "2012-10-09",
"options": {
"name": {
"default": null,
"required": true,
"description": [
"Description of a crontab entry."
],
"aliases": []
},
"hour": {
"default": "*",
"required": false,
"description": [
"Hour when the job should run ( 0-23, *, */2, etc )"
],
"aliases": []
},
"job": {
"default": null,
"required": false,
"description": [
"The command to execute.",
"Required if state=present."
],
"aliases": []
},
"month": {
"default": "*",
"required": false,
"description": [
"Month of the year the job should run ( 1-12, *, */2, etc )"
],
"aliases": []
},
"state": {
"default": "present",
"required": false,
"description": [
"Whether to ensure the job is present or absent."
],
"aliases": []
},
"user": {
"default": "root",
"required": false,
"description": [
"The specific user who's crontab should be modified."
],
"aliases": []
},
"backup": {
"default": false,
"required": false,
"description": [
"If set, then create a backup of the crontab before it is modified.",
"The location of the backup is returned in the 'backup' variable by this module."
],
"aliases": []
},
"day": {
"default": "*",
"required": false,
"description": [
"Day of the month the job should run ( 1-31, *, */2, etc )"
],
"aliases": []
},
"minute": {
"default": "*",
"required": false,
"description": [
"Minute when the job should run ( 0-59, *, */2, etc )"
],
"aliases": []
},
"weekday": {
"default": "*",
"required": false,
"description": [
"Day of the week that the job should run ( 0-7 for Sunday - Saturday, or mon, tue, * etc )"
],
"aliases": []
}
},
"ansible_version": "0.8"
}