RBM_CLI(7)

💖 rbm_cli — the rbm command line interface 💖

okay bestie, welcome to rbm_cli(7) — yes that's the manpage name, it's giving very "section 7, miscellaneous" and honestly? iconic. this is where you learn how to actually talk to rbm from your terminal, and no cap, it's easier than it looks 🫶

---

✨ SYNOPSIS ✨

rbm <action> <project> [options]

like. that's the whole shape of it. action first, then the project, then whatever little flags your heart desires 🌸

---

🦋 DESCRIPTION 🦋

so the rbm commands? they usually take an action as the first argument, then a project's name, then some options. that's the vibe. action, project, options, slay, done 💅

---

🎀 COMMAND LINE OPTIONS 🎀

okay so here's the tea ☕ — a lot of the configuration options that you can set in the main config file and in the project config files can also be overridden right from the command line. main character energy.

the naming rule is literally so simple it's cute:

• the command line option name is the same as the configuration file option
• but you prepend it with --
• and every _ gets swapped for a -

so like, output_dir: out in the config file? you can just hit it with --output-dir=out instead. periodt ✨

here's every single option you can set on the command line, no skipping, we're doing all of them 💖

• --sysconf-file=<file> — set the optional system configuration file path
• --localconf-file=<file> — set the optional local configuration file path
• --target=<target> — set the target. and bestie, you can use this option multiple times to use more than one target at once 👑 see rbm_targets(7) for the details
• --output-dir=<directory> — set the output directory
• --build-log=<filename> — set the file where the build logs get written. if the value is - (which is the default), the logs go out on stdout and stderr
• --version=<version> — set the package version
• --pkg-rel=<rel> — set the package release number
• --distribution=<distribution> — the name of the linux distribution to build the package for
• --fetch, --no-fetch — whether the latest commits should be fetched from the remote git repository or not
• --debug, --no-debug — enable or disable debug mode: this opens a shell in the temporary build directory if a build failure happens 🐚 (very "let me look at what went wrong in there" of it)
• --step — this sets the current step when you're using the showconf command. when you're using the build command, it's used to select the step (and the build script of the same name) to start from
• --git-hash=<hash> — the git hash of the commit / tag to use
• --hg-hash=<hash> — the mercurial hash of the commit / tag to use
• --commit-gpg-id=<GPG ID> — check that the commit is signed by this GPG key ID 🔐
• --tag-gpg-id=<GPG ID> — check if the selected git hash is a tag, and that it's signed by the selected GPG key ID
• --gpg-keyring=<file> — GPG keyring filename
• --gpg-keyring-dir=<directory> — directory containing GPG keyring files
• --gpg-args=<args> — optional gpg arguments
• --gpg-bin=<path> — path to the gpg binary

ngl, the gpg ones are a whole lil cluster — if you're doing signed-commit checking, you're gonna want --commit-gpg-id, --tag-gpg-id, --gpg-keyring, --gpg-keyring-dir, --gpg-args and --gpg-bin all in your mental notes 🧚

---

🌈 SEE ALSO 🌈

• rbm(1)
• rbm_config(7)

go read those next, they're the sequel and the prequel respectively, iykyk 💜

---

and that's the page!! this one is dated 07/25/2025 and it's page RBM_CLI(7) of the manual — so when you cite it in your notes, that's the receipt 🧾✨ mwah, go build something, bestie 💖🎀🦋