1BKR-DISTRO-TREES-LIST(1)            Beaker            BKR-DISTRO-TREES-LIST(1)
2
3
4

NAME

6       bkr-distro-trees-list - List Beaker distro trees
7

SYNOPSIS

9       bkr distro-trees-list [options]
10         [--tag <tag>] [--name <name>] [--treepath <url>] [--family <family>]
11         [--arch <arch>] [--distro-id <distroid>] [--distro-tree-id <distrotreeid>]
12         [--limit <number>] [--format <format>]
13
14

DESCRIPTION

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

OPTIONS

19       --tag <tag>
20              Limit to distros which have been tagged in Beaker with <tag>.
21
22       --name <name>
23              Limit to distros with the given name. <name> is interpreted as a
24              SQL LIKE pattern (the % character matches any substring).
25
26       --treepath <url>
27              Limit to distro trees with the given tree path. <url> is  inter‐
28              preted  as  a SQL LIKE pattern (the % character matches any sub‐
29              string).
30
31       --labcontroller <fqdn>
32              Limit to distro trees which are available on the given lab  con‐
33              troller.   <fqdn>  is  interpreted  as a SQL LIKE pattern (the %
34              character matches any substring).
35
36       --family <family>
37              Limit to distros of the given family (major version), for  exam‐
38              ple RedHatEnterpriseLinuxServer8.
39
40       --arch <arch>
41              Limit to distro trees for the given arch.
42
43       --distro-id <distroid>
44              Limit to distro trees for the given distro id.
45
46       --distro-tree-id <distrotreeid>
47              Limit to distro trees for the given distro tree id.
48
49       --xml-filter <xml>
50              Limit to distro trees which match the given XML filter criteria.
51              Supports the same criteria as inside the <distroRequires/>  ele‐
52              ment in Beaker job XML.
53
54       --limit <number>
55              Return at most <number> distro trees.
56
57       --format <format>
58              Display  results  in  the  given format, either tabular or json.
59              The tabular format is verbose and intended  for  human  consump‐
60              tion,  whereas  the json format is machine-readable. The default
61              is tabular.
62
63       Common bkr options are described in the Options section of bkr(1).
64

EXIT STATUS

66       Non-zero on error, otherwise zero.  If no distros match the given  cri‐
67       teria this is considered to be an error, and the exit status will be 1.
68

EXAMPLES

70       List details of all RHEL 8.0.0 nightly trees from a particular date:
71
72          bkr distro-trees-list --name "RHEL-8.0.0-20190410%"
73

SEE ALSO

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

AUTHOR

78       The Beaker team <beaker-devel@lists.fedorahosted.org>
79
81       2013-2022 Red Hat, Inc.
82
83
84
85
8628.3                             May 21, 2022         BKR-DISTRO-TREES-LIST(1)
Impressum