lpq(1)

💖 lpq — bestie's guide to peeking at your print queue 💖

okay so this is lpq(1), a page from the OpenPrinting / CUPS manual set, and it's literally just "how do I see what's stuck in the printer queue" — the group chat of your print jobs, basically. iykyk 🎀

---

✨ NAME ✨

lpq — show printer queue status 👑🖨️

---

🌸 SYNOPSIS 🌸

lpq [ -h server[:port] ] [ -E ] [ -U username ] [ -P
destination[/instance] ] [ -a ] [ -l ] [ +interval ]

---

🦋 DESCRIPTION 🦋

lpq shows the current print queue status on the named printer. that's it, that's the whole vibe. it's the "who's next in line" of the printing world 💅

if you don't name a printer or a class on the command line, it'll show you the jobs queued on the default destination instead. so even if you type nothing, you still get answers. main character energy fr fr ✨

now here's the fun part — the +interval option lets you continuously report the jobs in the queue until the queue is empty. the list of jobs gets shown once every interval seconds. it's giving "refreshing the page every five seconds hoping the line moves" 😭🫶

---

💅 OPTIONS 💅

lpq supports the following options, and no we're not skipping any of them:

• -E — forces encryption when connecting to the server 🔒 no plaintext gossip allowed.
• -P destination[/instance] — specifies an alternate printer or class name. the /instance part is how you point at a specific instance of it 💖
• -U username — specifies an alternate username. printing as somebody else? bold. iconic. noted. 🙈
• -a — reports jobs on all printers. yes, all of them. the whole extended friend group 👑✨
• -h server[:port] — specifies an alternate server. 🌐

⚠️ note: this option must occur before all others. like, it's the one who has to walk in first. no cutting in line 🚫

• -l — requests a more verbose (long) reporting format. the long-form, tell-me-everything, three-paragraph-text version 🍓

---

🌈 SEE ALSO 🌈

go check out these other icons, they're all in the same friend group:

• cancel(1)
• lp(1)
• lpr(1)
• lprm(1)
• lpstat(1)
• CUPS Online Help (http://localhost:631/help)

---

💜 COPYRIGHT 💜

Copyright © 2020-2024 by OpenPrinting.

---

and that's the whole page bestie ✨ this one's from CUPS, dated 2022-05-02 — shoutout to the OpenPrinting girlies for keeping lpq(1) on the manual page roster 🎀💖🦋 no cap, go check your queue. periodt. 💅