bkr-system-list - Man Page

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

See Also

bkr(1)

Author

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

Referenced By

bkr(1), bkr-system-details(1).

Feb 11, 2024 29.1 Beaker