BKR-DISTROS-LIST(1)

📦
version 29.2 · 3 versions
, in epel 9

✨ BKR-DISTROS-LIST 💅

okay so real talk, bestie — this is the bkr-distros-list(1) page from the Beaker manual, and it's literally just about listing distros. that's it. that's the whole vibe. let's get into it 🎀

🌸 NAME 🌸

bkr-distros-list — List Beaker distros 🦋

like, it lists them. iconic behaviour honestly.

⭐ SYNOPSIS ⭐

bkr distros-list [options]
  [--tag <tag>] [--name <name>] [--family <family>]
  [--distro-id <distroid>] [--limit <number>] [--format <format>]

she's got options, she's got range 👑

💖 DESCRIPTION 💖

so what it does is: it prints to stdout the details of all matching Beaker distros. all of them. the matching ones. that's the assignment and she ate 💅✨

🎀 OPTIONS 🎀

  • --tag <tag> — only shows you distros that have been tagged in Beaker with <tag>. filtering by vibe, basically 💫
  • --name <name> — limits to distros with the given name. and listen, <name> is interpreted as a SQL LIKE pattern — so the % character matches any substring. no cap, that's how it works 🔍
  • --family <family> — limits to distros of the given family (that's the major version, iykyk), for example RedHatEnterpriseLinuxServer5. main character family energy 👑
  • --distro-id <distroid> — limits to distros of the given distroid. specific. targeted. obsessed 🎯
  • --limit <number> — returns at most <number> distros. because sometimes you don't need the whole menu, just a lil taste 🍓
  • --format <format> — displays results in the given format, either tabular or json. the tabular format is verbose and intended for human consumption (hiiii that's us 🙈), whereas the json format is machine-readable (for the robots 🤖). the default is tabular.

the common bkr options are described in the Options section of bkr(1). go read that if you're nosy like me 💜

🔥 EXIT STATUS 🔥

non-zero on error, otherwise zero. literally so simple.

but wait — plot twist 😭 — if no distros match the given criteria, this is considered to be an error, and the exit status will be 1. yeah. finding nothing is a whole failure here. she's dramatic like that 💀

🌈 EXAMPLES 🌈

list details of all RHEL7 distros with the RELEASED tag:

bkr distros-list --family RedHatEnterpriseLinux7 --tag RELEASED

chef's kiss, no notes 🫶

🦋 HISTORY 🦋

so prior to version 0.9, this command also accepted --treepath, --labcontroller, and --arch filter options. those are gone now bestie, they moved out 🧚 use bkr distro-trees-list instead ✨

👑 SEE ALSO 👑

the friend group 💕

💜 AUTHOR 💜

The Beaker team <beaker-devel@lists.fedorahosted.org> 🫶

2013-2025 Red Hat, Inc.

and that's the whole page, bestie — slay 💅✨

version 29.2, dated May 26, 2025 — mwah, xoxo, go list some distros 🎀

📦 where this page comes from