bkr distro-trees-list: List Beaker distro trees¶

Synopsis¶

Description¶

Prints to stdout the details of all matching Beaker distro trees.

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

Exit status¶

Non-zero on error, otherwise zero. If no distros match the given criteria this is considered to be an error, and the exit status will be 1.

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)