CDIST-TYPE__CRON(7)

📦
version 7.0.0 · 8 versions
, in fedora 43, fedora 44

💖 cdist-type__cron — a.k.a. the __cron type from cdist ✨

okay bestie, gather round, because this is the manual page for cdist-type__cron and it's literally the moment your server's to-do list gets its whole life together. 🕐💅

🌸 NAME 🌸

cdist-type__cron — installs and manages cron jobs, fr fr. 🎀

🦋 DESCRIPTION 🦋

This cdist type lets you manage entries in a user's crontab. That's it, that's the vibe. You want stuff to happen on a schedule? This is the girl for the job. obsessed. ✨

👑 REQUIRED PARAMETERS 👑

no skipping these, they're mandatory bestie 😤

  • user — the user whose crontab is getting edited. not optional, not negotiable, we need to know who we're scheduling for. 🫶
  • command — the command to run. the actual thing that's gonna go do the thing. 🌟

🎀 OPTIONAL PARAMETERS 🎀

⚠️ NOTE: all the time-related parameters (--minute, --hour, --day_of_month, --month and --day_of_week) default to *, which means execute it always. so if you set --hour 0 thinking "aww yeah midnight only", it will actually run every minute in the first hour of the morning, all days. the way that * sneaks in on the other fields… 😭 watch out for that one. it's giving "I thought I was being specific" energy. 💀
  • state — either present or absent. defaults to present. use absent when you want it GONE, periodt. 👋
  • 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 — takes whatever the user has given instead of the time and date fields. if you give this, all other time and date fields are ignored. you can use it for cron EXTENSIONS like reboot, yearly, etc. check crontab(5) for the extensions your cron implementation actually implements, iykyk. 🔥
  • raw_command — takes whatever the user gave in the command and ignores everything else. if you give this, the command gets added to the crontab. this is your girl for defining variables like SHELL or MAILTO. 🧚

🌈 EXAMPLES 🌈

the moment you've all been waiting for, bestie. real code, real slay. 💖

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

⭐ SEE ALSO ⭐

💜 AUTHORS 💜

  • Steven Armstrong <steven-cdist--@--armstrong.cc> — the icon, the legend. 👑

🌸 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. 📜✨

ungleich GmbH 2021 🫶

and that's the whole page bestie!! 💖 this was cdist version 7.0.0, dated Jul 31, 2022 — go schedule something iconic, you've got this, mwah 💋 🌈🦋✨

📦 where this page comes from