LR_CRON.IN(1)

📦 version 2.1.1, in arch rolling

💅 lr_cron — the manual, bestie edition 🎀

okay so this is lr_cron from LogReport's Lire docs, and it's genuinely so useful once you get it. no cap.

✨ NAME ✨

lr_cron — runs the perodical jobs you set up in a DlfStore 💖 (that's "perodical" with their spelling, not mine, iykyk — we keep it exactly as it is 🫶)

🌸 SYNOPSIS 🌸

lr_cron period store

that's it. two args. period, then store. slay ✨

🦋 DESCRIPTION 🦋

so lr_cron is literally designed to be called from a crontab(5) entry. that's its whole main character moment. 👑

period should be one of these five strings, exactly:

  • "hourly"
  • "daily"
  • "weekly"
  • "monthly"
  • "yearly"

and store should be the full path name of the DLF Store. full path, bestie, don't be out here with relative nonsense 🙈

you configure your periodical jobs in the store using lire(1). that's the tool for the configuring part.

but here's the thing — configuring jobs with lire(1) does not magically run them. to run jobs as scheduled by lire(1), you will need to setup cron jobs. periodt. 💀 for each schedule you actually use, you should configure a cron job to be executed according to that period. one cron job per period you care about, basically.

here's a crontab(5) entry setup that will make sure that all possible schedules are supported in the /home/flacoste/myStore DLF store:

05  *  *  *  * lr_run lr_cron hourly  /home/flacoste/myStore
15 01  *  *  * lr_run lr_cron daily   /home/flacoste/myStore
15 02  *  * 02 lr_run lr_cron weekly  /home/flacoste/myStore
15 03 01  *  * lr_run lr_cron monthly /home/flacoste/myStore
15 04 01  01 * lr_run lr_cron yearly  /home/flacoste/myStore

see how all five periods show up? 👑 all five lines, all five vibes, and lr_run doing its little wrapper dance in front of each one. iconic.

.

(yes, there's literally a lone . sitting there in the original and I'm keeping it. it's part of the lore now. 🎀)

🌈 SEE ALSO 🌈

  • lire(1) — go read this one, it's the whole reason the store has jobs in the first place 🫶

💜 AUTHOR 💜

Francis J. Lacoste <flacoste@logreport.org> — actual legend, wrote the thing 🌟

⭐ VERSION ⭐

$Id: lr_cron.in,v 1.37 2006/07/23 13:16:32 vanbaal Exp $

Copyright (C) 2004 Stichting LogReport Foundation LogReport@LogReport.org

This program is free software; 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 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

⚠️ okay this part is the serious bit and I need you to actually read it: there is NO WARRANTY here, fr fr. not even the implied kind. the whole "WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE" is doing real work. don't come crying to the LogReport girlies if it breaks.

You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html. 🧚

and that's the page!! 💅 this doc is Lire 2.1.1, dated 2025-09-28, and honestly? she ate. go set up your crontab, bestie, you got this 🌸🦋✨

📦 where this page comes from