1BKR-SYSTEM-LIST(1) Beaker BKR-SYSTEM-LIST(1)
2
3
4
6 bkr-system-list - List Beaker systems
7
9 bkr system-list [options]
10 [--available | --free | --mine]
11 [--type <type>] [--status <status>] [--pool <pool>]
12 [--arch <arch>] [--dev-vendor-id <vendorid>]
13 [--dev-device-id <deviceid>] [--dev-driver <driver>]
14 [--dev-description <description>] [--dev-sub-vendor-id <subvendorid>]
15 [--dev-sub-device-id <subdeviceid>]
16
17
19 Prints to stdout a list of all matching systems in Beaker.
20
22 --available
23 Limit to systems which would be available to be scheduled by the
24 current user. This will exclude any systems whose access policy
25 prevent the current user from running jobs on them.
26
27 Note that this does not exclude systems which are currently oc‐
28 cupied by other users. Use --free for that.
29
30 --free Like --available, but only includes which can be scheduled right
31 now.
32
33 --removed
34 Limit to systems which have been marked as Removed.
35
36 --mine Limit to systems which are owned by the current user.
37
38 The --available, --free, and --mine options are mutually exclusive.
39
40 --type <type>
41 Limit to systems of type <type>. Most users will want to filter
42 for the Machine type.
43
44 --status <status>
45 Limit to systems whose status is <status>, for example Auto‐
46 mated, Manual, or Broken.
47
48 --pool <pool>
49 Limit to systems which are in <pool>
50
51 --group <group>
52 Compatibility alias for --pool.
53
54 --arch <arch>
55 Limit to systems of arch <arch>.
56
57 --dev-vendor-id <vendorid>
58 Limit to systems which have a device with <vendorid>.
59
60 --dev-device-id <deviceid>
61 Limit to systems which have a device with <deviceid>.
62
63 --dev-sub-vendor-id <subvendorid>
64 Limit to systems which have a device with <subvendorid>.
65
66 --dev-sub-device-id <subdeviceid>
67 Limit to systems which have a device with <subdeviceid>.
68
69 --dev-driver <driver>
70 Limit to systems which have a device with <driver>.
71
72 --dev-description <description>
73 Limit to systems which have a device with <description>.
74
75 --xml-filter <xml>
76 Limit to systems which match the given XML filter criteria. Sup‐
77 ports the same criteria as inside the <hostRequires/> element in
78 Beaker job XML.
79
80 --host-filter <name>
81 Limit to systems which match the given pre-defined host filter.
82 Refer to the description of the --host-filter workflow option in
83 bkr(1).
84
85 Common bkr options are described in the Options section of bkr(1).
86
88 Non-zero on error, otherwise zero. If no systems match the given cri‐
89 teria this is considered to be an error, and the exit status will be 1.
90
92 List automated systems which are in the kernel-hw pool and are not cur‐
93 rently in use:
94
95 bkr system-list --free --type=Machine --status=Automated --pool=kernel-hw
96
98 bkr(1)
99
101 The Beaker team <beaker-devel@lists.fedorahosted.org>
102
104 2013-2022 Red Hat, Inc.
105
106
107
108
10928.3 May 21, 2022 BKR-SYSTEM-LIST(1)