bkr-distros-list - Man Page
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 <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 RHEL7 distros with the RELEASED tag:
bkr distros-list --family RedHatEnterpriseLinux7 --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
Author
The Beaker team <beaker-devel@lists.fedorahosted.org>
Copyright
2013-2024 Red Hat, Inc.
Referenced By
bkr(1), bkr-distro-trees-list(1).