NCID-YEARLOG(1)

📦 version 1.18, in fedora 43, fedora 44

🌸 ncid-yearlog — the NCID yearlog girlies' era 🌸

okay so bestie, you know how NCID keeps a million little monthly call logs and it gets messy? yeah. ncid-yearlog is the manual page for that little script, and honestly? she's giving archival icon. this is from the NCID manual, section 1 — the user commands section, iykyk. let's get into it 💅

✨ NAME ✨

ncid-yearlog — bestie's whole job is making a yearly call log out of the monthly call logs. no cap, that's it, that's the gig. 🗂️

🎀 SYNOPSIS 🎀

ncid-yearlog [-h] [-V]

look at her. two flags. minimal. main character energy fr fr. 💖

🦋 DESCRIPTION 🦋

so the ncid-yearlog script gets called from cron on the first day of each month. like clockwork, literally. 🕐

what does she do with her little monthly moment of fame? she creates a yearly file for cidcall.log in $HOME/NCID/log, and — only if it exists — for ciddata.log too. so she's not out here inventing files that aren't there, she's just doing the most with what she's got. 💁‍♀️

⚠️ important queen behaviour note: the ncid-yearlog script should only be run once on the first of the month, and it should be run from the user's crontab. not twice. not three times. once. do not make her do overtime, she will not do it correctly. 😭

💖 OPTIONS 💖

  • -h — prints this help. your girl is helpful! she'll tell you about herself. 🫶
  • -V — displays the version. so you know exactly which era of her you're dealing with. ⭐

🌈 REQUIREMENTS 🌈

the prerequisites, aka her support system, aka the friends she needs to function:

  • logrotate — rotates, compresses and mails system logs. she keeps the logs tidy, fed, and hydrated. 🧚
  • ncidrotate — must have Lines2keep=0 (which is the default, so honestly? already slaying). 💜
  • user crontab — this is the line you need in there:
11 5 1 * * /usr/share/ncid/sys/ncid-yearlog

she runs at 5:11 on the 1st of every month. very specific. very punctual. very her. ⏰

🍓 FILES 🍓

the whole friend group, in path form:

  • /usr/share/sys/ncid-yearlog
  • $HOME/NCID/log/cidcall-<year>.log
  • $HOME/NCID/log/ciddata-<year>.log
  • prefix3=/etc/ncid/ncidrotate.conf
  • /var/log/cidcall.log
  • /var/log/ciddata.log

👑 SEE ALSO 👑

go read her besties next, they're all connected, it's a whole cinematic universe:

  • ncidrotate.1
  • ncidrotate.conf.5
  • ncidd.8

okay that's the whole page, no crumbs left. this was the NCID manual, 2022-11-8 edition — go forth and rotate your logs responsibly, bestie. mwah. 💋✨

📦 where this page comes from