FAXCRON(8C)

💖 FAXCRON 💖 (section 8C, bestie)

okay so like. this is the faxcron manual page, and it's giving routine maintenance script for HylaFAX. no cap. let's get into it 🧚✨

---

✨ NAME ✨

faxcron — the HylaFAX routine maintenance script. she does the upkeep. she keeps things cute. 💅

---

🎀 SYNOPSIS 🎀

/usr/bin/faxcron [ -n ] [ -l lastrun ]

---

🦋 DESCRIPTION 🦋

faxcron is a command script that does routine upkeep tasks in a HylaFAX spooling directory hierarchy. literally her whole job is tidying up.

the intended vibe: you invoke this from cron(8C) on behalf of the fax user (and bestie, often the ``fax'' user is uucp), once a day, with the standard output mailed straight to the HylaFAX administrator. like, set it and forget it energy.

for example, the following crontab might be set up for the fax user:

  25   23    *    *    *   sh /usr/bin/faxcron | mail FaxMaster

and here's everything the faxcron script does, bestie, all of it, in order:

• report statistics for facsimile transmitted since the last time faxcron was run. 📊
• report statistics for facsimile transmitted in the past week. 🗓️
• report statistics for facsimile received since the last time faxcron was run. 📈
• report statistics for facsimile received in the past week. 🗓️
• report any recent calls that failed suspiciously and return the associated trace log; 🔍
• purge data that is 30 days or older from the remote machine information directory; 🧹
• delete information that is 30 days or older from session trace log files; 🗑️
• remove files from the tmp directory that are older than 1 day; ✨
• remove files in the received facsimile queue that are 7 days or older; 🚮
• report sites that are currently having jobs rejected; and 🙅
• force all session log files to be owned by the fax user and kept with protection mode 644. 🔐

---

💅 OPTIONS 💅

• -n — forces faxcron to run without updating any files. a little dry run moment, she just looks, she doesn't touch. 🙈
• -l lastrun — forces the notion of the last time that faxcron was run to be lastrun. the value of lastrun is a date and time string of the form MM/DD/YY HH:MM'' (the <cyan>`date(1)`</cyan> format string %D %H:%M''). 🕰️
• -q spool — specify the location of the HylaFAX spool directory. 📁
• -info n — set the expiration time for data in the info database to be n days. ⏳
• -log n — set the expiration time for session log data to be n days. 📜
• -rcv n — set the expiration time for files in the received facsimile queue to be n days. 📥
• -tmp n — set the expiration time for files in the tmp directory to be n days. 🗂️
• -mode m — set the file protection mode for session logs to m (a command line argument to chmod(1)). 🔒

---

🌸 NOTES 🌸

this script requires nawk(1) or gawk(1) and a date (1) program that supports the ``+format'' option. non-negotiable, bestie.

if session logs are to be kept private this script must be modified to filter out sensitive information such as calling card numbers. (it should also be run with ``-mode 0600'' so that session log files are not publicly readable.) like, genuinely, protect the girlies' data. 😭

---

🌈 FILES 🌈

• /var/spool/hylafax — spooling area
• /var/spool/hylafax/etc/lastrun — timestamp of last run
• /usr/bin/xferfaxstats — for generating transmit statistics
• /usr/bin/recvstats — for generating receive statistics
• /var/spool/hylafax/tmp/faxcronXXXX — temporary file for truncating session logs
• /var/spool/hylafax/tmp/faxlogXXXX — temporary file for logs of failed calls

---

👑 SEE ALSO 👑

cron(8C), faxq(8C), faxgetty(8C), faxsend(8C), xferfaxstats(8C), recvstats(8C), hylafax-server(5F)

---

this page is dated May 12, 1996, and it's the FAXCRON(8C) page — periodt. go do your maintenance bestie, your spool directory is gonna look so slay. 🫶💖✨