nodedev-list

Lists resources that are represented in sysfs on the KVM host and that can be detected by libvirt.

Syntax

Selected options

--cap <type>

Restricts the command output to one or more capability types. Capability types group resources that can be used for similar purposes in guest configurations. The following specifications are examples of valid types:

mdev: Lists the available mediated devices.
mdev_types: Lists potential parent devices for mediated devices.
ap_card: Lists the available cryptographic adapters.
ap_queue: Lists the available domains on cryptographic adapters.
ap_matrix: Lists VFIO mediated devices that represent AP configurations. Such mediated devices can be assigned to virtual servers as pass-through devices. Only one such AP configuration can be assigned to a specific virtual server.
storage: Lists the available storage devices, for example, DASD or SCSI block devices.

--inactive

Lists inactive devices. By default, only active devices are listed.

--all

Lists active and inactive devices. By default, only active devices are listed.

--tree

Shows the hierarchical relationship of the host resources in a tree view.

Usage

Managing mediated devices with libvirt

Example

This example shows a tree view of all host resources that are detected by libvirt.

$ virsh nodedev-list --tree
computer
  |
  +- ap_card08
  |
  | +- ap_08_0001
  | +- ap_08_0002
  |
  +- ap_card09
  |   |
  |   +- ap_09_0001
  |   +- ap_09_0002
  |
  +- ap_matrix
  |   |
  |   +- mdev_45b9ba40_b8aa_4b84_9cdd_bdeea3a6a365_matrix
  |   +- mdev_4e7855ca_933a_489d_a3a4_d3aec6e0de69_matrix
  ...
  +- css_0_0_006b
  |   |
  |   +- ccw_0_0_1000
  |       |
  |       +- block_dasdg_IBM_750000000DHVL1_0001_00
  |
  +- css_0_0_0072
  |   |
  |   +- mdev_96c03c6a_a109_44fe_816a_ba371542164b_0_0_0072
  ...

This example lists all cryptographic adapters and mediated devices.

$ virsh nodedev-list --cap ap_card,mdev
ap_card08
ap_card09
mdev_45b9ba40_b8aa_4b84_9cdd_bdeea3a6a365_matrix
mdev_4e7855ca_933a_489d_a3a4_d3aec6e0de69_matrix
...
mdev_96c03c6a_a109_44fe_816a_ba371542164b_0_0_0072
...