---
name: "laminarc"
section: "1"
platform: "linux"
package: "laminarc"
version: "1.0-3"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/laminarc"
---

# laminarc(1)

Laminar CI client application

## NAME

**laminarc** - Laminar CI client application

## SYNOPSIS

**laminarc** queue *JOB* \[*PARAM=VALUE...*\] ...

**laminarc** queue *JOB* \[*PARAM=VALUE...*\] ...

**laminarc** queue *JOB* \[*PARAM=VALUE...*\] ...

**laminarc** set *PARAM=VALUE...*

**laminarc** show-jobs

**laminarc** show-running

**laminarc** show-queued

**laminarc** abort *JOB* *NUMBER*

## DESCRIPTION

The **laminarc** program connects to a Laminar server and perform one of following operations:

- **queue**

  adds job(s) (with optional parameters) to the queue and returns immediately.

- **start**

  adds job(s) (with optional parameters) to the queue and returns when the jobs begin execution.

- **run**

  adds job(s) (with optional parameters) to the queue and returns when the jobs complete execution. The exit code will be non-zero if any of the runs does not complete successfully.

- **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.

- **show-jobs**

  list jobs known to the server.

- **show-running**

  list the currently running jobs with their numbers.

- **show-queued**

  list the names and numbers of the jobs waiting in the queue.

- **abort**

  manually abort a currently running job by name and number.

The laminar server to connect to is read from the LAMINAR\_HOST environment variable. If empty, it falls back to LAMINAR\_BIND\_RPC and finally defaults to *unix-abstract:laminar*

## ENVIRONMENT

- LAMINAR\_HOST

  address of server to connect. May be of the form *IP:PORT,* *unix:PATH/TO/SOCKET* or *unix-abstract:NAME*

- LAMINAR\_BIND\_RPC

  fallback server address variable. It is set by **laminard** during execution of scripts.

## SEE ALSO

[laminard(8)](/laminard/8.md)

## AUTHORS

Oliver Giles created Laminar CI. Dmitry Bogatov created this manual page for the Debian project (but it can be used by others).