bkr-distro-trees-list man page

bkr-distro-trees-list ā€” List Beaker distro trees

Synopsis

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

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

--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 RHEL5.6 Server nightly trees from a particular date:

bkr distro-trees-list --name "RHEL5.6-Server-20101110%"

See Also

bkr(1), bkr-distros-list(1)

Author

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

Referenced By

bkr(1), bkr-distros-list(1), bkr-distro-trees-verify(1).

Nov 17, 2017 24.5 Beaker