bkr-distros-list man page

bkr-distros-list ā€” List Beaker distros

Synopsis

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

Description

Prints to stdout the details of all matching Beaker distros.

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

--family <family>

Limit to distros of the given family (major version), for example RedHatEnterpriseLinuxServer5.

--distro-id <distroid>

Limit to distros of the given distroid.

--limit <number>

Return at most <number> distros.

--format tabular, --format json

Display results in the given format. tabular is verbose and intended for human consumption, whereas json is machine-readable.

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 RHEL6 distros with the RELEASED tag:

bkr distros-list --family RedHatEnterpriseLinux6 --tag RELEASED

History

Prior to version 0.9, this command also accepted --treepath, --labcontroller, and --arch filter options. Use bkr distro-trees-list instead.

See Also

bkr(1), bkr-distro-trees-list(1)

Author

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

Referenced By

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

Jul 26, 2017 24.3 Beaker