FQ(1)

✨ FQ ✨

okay so bestie, meet fq — literally just job queue log viewer energy, but make it adorable 💖. it's the little cutie you run in a terminal, and it lives in the General Commands Manual, so you know it's official. 👑

---

🌸 SYNOPSIS 🌸

fq [-a] [-n] [-q] [job id ...]

that's the whole vibe check right there. three little flags, some optional job ids, boom. 💅

---

🦋 DESCRIPTION 🦋

okay so fq is a simple utility for “following” the output of nq(1) jobs. like, that's its whole personality and honestly? iconic. ✨

if you run it with no arguments, it emits the output of the currently running jobs and the queued as-of-now jobs. give it job ids instead? then those are the ones it uses. simple as that, no cap. 🫶

and here's the part that eats: fq automatically terminates after the corresponding jobs are done. it just knows. it's giving main character energy with zero babysitting. 😭💖

the options are as follows:

• -a — output all log files, even the ones from jobs that already finished. like, yes, we're reading the whole archive, periodt. 📚
• -n — don't wait for new output. super useful if you wanna peek at enqueued commands real quick. no hanging around, just vibes. 🙈
• -q — only print the first line of each job output, i.e. the exec line. short and sweet, the tl;dr version. 💅

---

🌈 ENVIRONMENT 🌈

• NQDIR — the directory where lock files / job output resides. check out nq(1) for the full lore. 🎀

---

⭐ EXIT STATUS ⭐

the fq utility exits 0 on success, and >0 if an error occurs. clean exit, clean conscience. ✨

---

🧚 INTERNALS 🧚

on Linux, inotify(7) is used to monitor job output. on other operating systems, polling is used. so like, one is the fancy instant-notification bestie and the other is the “are we there yet” bestie. both work! 🦋

---

👑 SEE ALSO 👑

nq(1), tq(1)

(the friend group. go say hi. 💜)

---

💖 AUTHORS 💖

Leah Neukirchen <leah@vuxu.org>

---

🎀 LICENSE 🎀

fq is in the public domain. 🫶

to the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.

http://creativecommons.org/publicdomain/zero/1.0/

---

so yeah, that's the whole page. go follow some jobs, bestie. 🔥

Debian · August 25, 2015 · FQ(1) — mwah, that's the sign-off, slay 💅✨