BKR-DISTRO-TREES-LIST(1)

📦
version 29.2 · 3 versions
, in epel 9

🌸 NAME 🌸

bkr-distro-trees-list — List Beaker distro trees. Bestie, this is the bkr-distro-trees-list page from the Beaker manual, section 1, and yes we are absolutely getting into it 💅

✨ SYNOPSIS ✨

Okay so the shape is literally this:

bkr distro-trees-list [options]
  [--tag <tag>] [--name <name>] [--treepath <url>] [--family <family>]
  [--arch <arch>] [--distro-id <distroid>] [--distro-tree-id <distrotreeid>]
  [--limit <number>] [--format <format>]

💅 DESCRIPTION 💅

It prints to stdout the details of all matching Beaker distro trees. That’s the whole serve: you give it filters, it gives you matching distro trees. Iconic behavior, no cap 🌈

🎀 OPTIONS 🎀

  • --tag <tag> — Limit to distros which have been tagged in Beaker with <tag>.
  • --name <name> — Limit to distros with the given name. <name> is interpreted as a SQL LIKE pattern (the % character matches any substring).
  • --treepath <url> — Limit to distro trees with the given tree path. <url> is interpreted as a SQL LIKE pattern (the % character matches any substring).
  • --labcontroller <fqdn> — Limit to distro trees which are available on the given lab controller. <fqdn> is interpreted as a SQL LIKE pattern (the % character matches any substring).
  • --family <family> — Limit to distros of the given family (major version), for example RedHatEnterpriseLinuxServer8.
  • --arch <arch> — Limit to distro trees for the given arch.
  • --distro-id <distroid> — Limit to distro trees for the given distro id.
  • --distro-tree-id <distrotreeid> — Limit to distro trees for the given distro tree id.
  • --xml-filter <xml> — Limit to distro trees which match the given XML filter criteria. Supports the same criteria as inside the <distroRequires/> element in Beaker job XML.
  • --limit <number> — Return at most <number> distro trees.
  • --format <format> — Display results in the given format, either tabular or json. The tabular format is verbose and intended for human consumption, whereas the json format is machine-readable. The default is tabular.

Common bkr options are described in the Options section of bkr(1). Go check that bestie, it’s giving essential reading 🫶

🚦 EXIT STATUS 🚦

Non-zero on error, otherwise zero. And listen: if no distros match the given criteria, this is considered to be an error, and the exit status will be 1 💀 So no “empty but fine” moment here, okay?

🧪 EXAMPLES 🧪

List details of all RHEL 8.0.0 nightly trees from a particular date:

bkr distro-trees-list --name "RHEL-8.0.0-20190410%"

👀 SEE ALSO 👀

bkr(1), bkr-distros-list(1) — yes bestie, the whole little friend group 🔥

💌 AUTHOR 💌

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

2013-2025 Red Hat, Inc.

okay bestie, that’s the page 💖 source/version: Beaker 29.2; date: May 26, 2025. Go forth and list those trees 🎀✨

📦 where this page comes from