DQ-SERVER(1)

💖 DQ-SERVER(1) 💖

ok so this is a User Contributed Perl Documentation page, bestie — it lives in section 1 of the manual, and it's literally about making a whole queue of tasks go brrr without you lifting a finger 🫶

---

✨ NAME ✨

dq-server — run a command on all tasks in an IPC::DirQueue queue 👑

---

🌸 SYNOPSIS 🌸

dq-server --dir qdirectory [--njobs N] command arg arg ...

that's it, that's the whole vibe check 💅

---

🦋 DESCRIPTION 🦋

ok so picture this: you've got an IPC::DirQueue directory, right? and it's got tasks in it. dq-server will remove each task in turn from that directory, running the named command on each one. one at a time, in turn, no skipping, no cap 🎀

and the way it does that is, it runs the command like:

command arg arg ... nameofdatafile

so your command gets its own arg arg ... and then the name of the data file gets tacked on at the end. that's the whole handoff. iconic. ✨

once the queue is empty? it doesn't just dip. it waits indefinitely for more tasks to arrive 🫶 like a loyal bestie holding your spot in line fr fr. so it just hangs out, ready, waiting for the next task to show up.

and if you don't wanna be there forever — maybe you only want it to chew through a certain number of jobs — you can put a limit on how many jobs it dequeues using --njobs. lowkey the most useful thing here. 🔥

---

💅 OPTIONS 💅

• --njobs N (default: 0) — how many jobs to dequeue from the queue directory. and 0 means unlimited ⭐ so if you leave it at the default, it's gonna keep going forever, periodt.

---

🌈 SEE ALSO 🌈

• IPC::DirQueue(3)
• dq-deque(1)
• dq-list(1)
• dq-server(1)
• dq-submit(1)

(yes, dq-server(1) is listed in its own SEE ALSO. self-love, honestly? we stan. 💜)

---

k byeeee 💖 this page is from perl v5.42.0, dated 2025-07-25 — so if you're reading this way later, go check if anything changed, bestie 🎀✨