faxq(1)

💖 faxq(1) — the mgetty+sendfax manual, but make it make sense 💖

okay bestie, sit down, we're talking about faxq today and honestly? it's giving ✨queue manager✨. This one lives in the mgetty+sendfax manual and it's about peeking at the fax jobs your system has lined up. Let's get into it 🫶

🌸 NAME 🌸

faxq — display fax jobs queued by faxspool(1) 💅

✨ SYNOPSIS ✨

faxq [<command>] [-osa] [-v] [-r<job>] [-rall] [-P<job><prio>]

🦋 DESCRIPTION 🦋

So basically, faxq shows you the fax queue that faxspool(1) set up. That's the whole vibe.

It goes looking for every job that faxspool(1) dropped into /var/spool/fax/outgoing/*. For each job sitting in that queue, faxq prints out some status info about it. And if you don't pass any options at all? You get one single line per queued fax job, showing the job number, the sender, the number of pages and the target fax number. Clean, minimal, iconic. 💖

👑 COMMANDS 👑

• faxq stop — this stops the fax queue from processing by creating the file /var/spool/fax/outgoing/stop. Real talk though: it only works if you have write access to the spool directory. Depending on how your local setup is configured, that means either "root only" or "fax administrator group". No write access? You get an error message, sorry bestie 😭
• faxq start — this re-starts a queue that you previously stopped, by removing the stop file. And same energy as faxq stop: it only works if you have write access. 🫶

💅 OPTIONS 💅

• -v — tells faxq to print a more verbose report for each job, and by verbose we mean multiple lines. She's chatty, we love her.
• -o — show old jobs too, i.e. the ones that were already sent but are still hanging around in the queue directory. They're not gone, they're just lurking.
• -s — show suspended jobs. Those are the ones that got stopped because of too many fatal errors while sending 😭. Good news: you can restart those jobs with faxq -r <job>.
• -a — show ALL jobs. Active, old, suspended, the whole friend group. 🌈
• -r <job> — restart the job with the given ID(s). You can do "-r F012345" or "-r F01234*" — yes, wildcards, she ate. 👑
• -r all — restart ALL suspended jobs. Every single suspended job in the queue (that you have write permissions for) will be requeued. ⚠️ Heads up though: use faxrm to delete jobs that you do not want to be sent! Don't just yeet everything back into the wild.
• -P <job> <prio> — change the priority of fax job <job> to <prio>. Example: "faxq -P F000247 3".

💀 BUGS 💀

• faxq doesn't handle time scheduling yet. Not yet, bestie. 🙈
• faxq -P is currently broken (needs re-implementing with faxq-helper). Yeah. It's broken. We said what we said. 💀

🔥 SEE ALSO 🔥

faxrunq(1), faxspool(1), faxrm(1), faxqueue(5)

🎀 AUTHOR 🎀

faxq is Copyright (C) 1993 by Gert Doering, <gert@greenie.muc.de>. Respect the OG 🫶

and that's the whole page, bestie — greenie, 27 Oct 93, faxq(1), mgetty+sendfax manual, we're done here, go check your queue 💖✨🌸