bkr system-list: List Beaker systems¶

Synopsis¶

bkr system-list [options]

[--available | --free | --mine]
[--type <type>] [--status <status>] [--pool <pool>]
[--arch <arch>] [--dev-vendor-id <vendorid>]
[--dev-device-id <deviceid>] [--dev-driver <driver>]
[--dev-description <description>] [--dev-sub-vendor-id <subvendorid>]
[--dev-sub-device-id <subdeviceid>]

Description¶

Prints to stdout a list of all matching systems in Beaker.

Options¶

--available¶

Limit to systems which would be available to be scheduled by the current user. This will exclude any systems whose access policy prevent the current user from running jobs on them.

Note that this does not exclude systems which are currently occupied by other users. Use --free for that.

--free¶: Like --available, but only includes which can be scheduled right now.

--removed¶: Limit to systems which have been marked as Removed.

--mine¶: Limit to systems which are owned by the current user.

The --available, --free, and --mine options are mutually exclusive.

--type <type>¶: Limit to systems of type <type>. Most users will want to filter for the Machine type.

--status <status>¶: Limit to systems whose status is <status>, for example Automated, Manual, or Broken.

--pool <pool>¶: Limit to systems which are in <pool>

--group <group>¶: Compatibility alias for --pool.

--arch <arch>¶: Limit to systems of arch <arch>.

--dev-vendor-id <vendorid>¶: Limit to systems which have a device with <vendorid>.

--dev-device-id <deviceid>¶: Limit to systems which have a device with <deviceid>.

--dev-sub-vendor-id <subvendorid>¶: Limit to systems which have a device with <subvendorid>.

--dev-sub-device-id <subdeviceid>¶: Limit to systems which have a device with <subdeviceid>.

--dev-driver <driver>¶: Limit to systems which have a device with <driver>.

--dev-description <description>¶: Limit to systems which have a device with <description>.

--xml-filter <xml>¶: Limit to systems which match the given XML filter criteria. Supports the same criteria as inside the <hostRequires/> element in Beaker job XML.

--host-filter <name>¶: Limit to systems which match the given pre-defined host filter. Refer to the description of the --host-filter workflow option in bkr(1).

Common bkr options are described in the Options section of bkr(1).

Exit status¶

Non-zero on error, otherwise zero. If no systems match the given criteria this is considered to be an error, and the exit status will be 1.

Examples¶

List automated systems which are in the kernel-hw pool and are not currently in use:

bkr system-list --free --type=Machine --status=Automated --pool=kernel-hw