LAMINARC(1)

💅 laminarc — the Laminar CI client app, explained by your bestie

okay so real quick, the man page name is laminarc and this is section 1, and honestly? she's iconic. let's get into it 🫶

---

✨ SYNOPSIS ✨

the receipts, verbatim, no cap:

laminarc queue JOB [PARAM=VALUE...] ...
laminarc start JOB [PARAM=VALUE...] ...
laminarc run JOB [PARAM=VALUE...] ...
laminarc set PARAM=VALUE...
laminarc show-jobs
laminarc show-running
laminarc show-queued
laminarc abort JOB NUMBER

like… look at all those little verbs. she contains multitudes 💅

---

🌸 DESCRIPTION 🌸

so laminarc is basically the extrovert bestie of the group — she connects to a Laminar server and then does one of the following things for you. one (1) operation, that's the vibe:

• queue — adds job(s) (with optional parameters, bestie) to the queue and returns immediately. she does not wait. she has places to be 💨
• start — adds job(s) (with optional parameters) to the queue and comes back when the jobs begin execution. so she waits, but only barely. lowkey patient.
• run — adds job(s) (with optional parameters) to the queue and comes back when the jobs complete execution. this one's committed fr. and heads up 🚨 the exit code will be non-zero if any of the runs does not complete successfully.
• --next may be passed to queue, start or run in order to place the job at the front of the queue instead of at the end. front-of-the-line privileges, we love an icon who cuts the queue (consensually, via flag) 👑
• set — sets one or more parameters to be exported as environment variables in subsequent scripts, for the run identified by the $JOB and $RUN environment variables. this is primarily intended for use from within a job execution, where those variables are already set by the server. iykyk 🌈
• show-jobs — lists jobs known to the server. little roster moment 📋
• show-running — lists the currently running jobs with their numbers. numbers matter, remember them.
• show-queued — lists the names and numbers of the jobs waiting in the queue. the line-up, if you will 🎀
• abort — manually aborts a currently running job by name and number. it's giving "we need to talk" 💀

so which server does she connect to? the Laminar server to connect to is read from the LAMINAR_HOST environment variable. if that's empty, she falls back to LAMINAR_BIND_RPC, and finally defaults to unix-abstract:laminar. three chances, very forgiving queen 🙈

---

🦋 ENVIRONMENT 🦋

• LAMINAR_HOST — address of server to connect. may be of the form IP:PORT, unix:PATH/TO/SOCKET or unix-abstract:NAME. three fits, pick your fav ✨
• LAMINAR_BIND_RPC — the fallback server address variable. it is set by laminard during execution of scripts. she's the understudy but she's ready 💜

---

🎀 SEE ALSO 🎀

• laminard(8) — the other half of the duo. go say hi.

---

👑 AUTHORS 👑

• Oliver Giles created Laminar CI. founder energy, main character energy, no notes 🔥
• Dmitry Bogatov created this manual page for the Debian project (but it can be used by others). generous icon, sharing the manual with the whole group chat 🫶

---

and that's the page!! you read the whole thing, i'm so proud of you 🥹💖

this printing of laminarc(1) is the Apr 04, 2019 edition — date stamped and everything, a little vintage vintage, and it's already slaying 🎀✨ bye bestie, go queue something 🌸