There are several libvirt functions, all with the
prefix virNodeDevice, which deal with management of
host devices that can be handed to guests via passthrough as
<hostdev> elements
in the domain XML.
These devices are represented as a hierarchy, where a device on
a bus has a parent of the bus controller device; the root of the
hierarchy is the node named "computer".
When represented in XML, a node device uses the
top-level device element, with the following
elements present according to the type of device:
nameparentcapabilitytype lists which category the device
belongs to, and controls which further subelements will be
present to describe the node:
systemproducthardwarevendor, version,
serial, and uuid.firmwarevendor, version,
and release_date.pcidomainbusslotfunctionproductid with the hexadecimal product
id, and an optional text description of that id.vendorid with the hexadecimal vendor
id, and an optional text name of that vendor.iommuGroupnumber attribute which tells
the group number used for management of the group (all
devices in group "n" will be found in
"/sys/kernel/iommu_groups/n"). It will also have a
list of address subelements, each
containing the PCI address of a device in the same
group. The toplevel device will itself be included in
this list.
capabilitytype attribute
which will be set to
either physical_function
or virtual_functions. If the type
is physical_function, there will be a
single address subelement which contains
the PCI address of the SRIOV Physical Function (PF)
that is the parent of this device (and this device is,
by implication, an SRIOV Virtual Function (VF)). If
the type is virtual_functions, then this
device is an SRIOV PF, and the capability element will
have a list of address subelements, one
for each VF on this PF. If the host system supports
reporting it (via the "sriov_maxvfs" file in the
device's sysfs directory) the capability element will
also have an attribute named maxCount
which is the maximum number of SRIOV VFs supported by
this device, which could be higher than the number of
VFs that are curently active since
1.3.0; in this case, even if there are
currently no active VFs the virtual_functions
capabililty will still be shown.
numanode attribute tells which NUMA node is the PCI
device associated with.
pci-expresslink which addresses the PCI Express device's link.
While a device has its own capabilities
(validity='cap'), the actual run time capabilities
are negotiated on the device initialization
(validity='sta'). The link element then
contains three attributes: port which says in which
port is the device plugged in, speed (in
GigaTransfers per second) and width for the number
of lanes used. Since the port can't be negotiated, it's not
exposed in ./pci-express/link/[@validity='sta'].
usb_devicebusdeviceproductid with the hexadecimal product
id, and an optional text description of that id.vendorid with the hexadecimal vendor
id, and an optional text name of that vendor.usbnumberclasssubclassprotocoldescriptionnetinterfaceaddresslinkspeed in Mbits per
second and state to tell the state of the
link. So far, the whole element is just for output,
not setting.
featurerxtxsgtsoufogsogrolrorxvlantxvlanntuplerxhashrdmatxudptnlcapabilitytype can be "80203" for IEEE
802.3, or "80211" for various flavors of IEEE 802.11.
scsi_hosthostunique_idfind -H
/sys/class/scsi_host/host{0..9}/unique_id |
xargs grep '[0-9]'. On output, if the unique_id
file exists, the value from the file will be displayed.
This can be used in order to help uniquely identify the
scsi_host adapter in a
Storage Pool. Since 1.2.7
capabilityvports,
and max_vports. vports shows the
number of vport in use. max_vports shows the
maximum vports the HBA supports. "fc_host" implies following
sub-elements: wwnn, wwpn, and
fabric_wwn.
scsihostbustargetluntypestorageblockbusdrive_typemodelvendorserialsizecapabilitytype. Current capabilities
include "hotpluggable" and "removable", with the
latter implying the following
sub-elements: media_available (0 or
1), media_size,
and media_label.The following are some example node device XML outputs:
<device>
<name>computer</name>
<capability type='system'>
<product>2241B36</product>
<hardware>
<vendor>LENOVO</vendor>
<version>ThinkPad T500</version>
<serial>R89055N</serial>
<uuid>c9488981-5049-11cb-9c1c-993d0230b4cd</uuid>
</hardware>
<firmware>
<vendor>LENOVO</vendor>
<version>6FET82WW (3.12 )</version>
<release_date>11/26/2009</release_date>
</firmware>
</capability>
</device>
<device>
<name>net_eth1_00_27_13_6a_fe_00</name>
<parent>pci_0000_00_19_0</parent>
<capability type='net'>
<interface>eth1</interface>
<address>00:27:13:6a:fe:00</address>
<capability type='80203'/>
</capability>
</device>
<device>
<name>pci_0000_02_00_0</name>
<path>/sys/devices/pci0000:00/0000:00:04.0/0000:02:00.0</path>
<parent>pci_0000_00_04_0</parent>
<driver>
<name>igb</name>
</driver>
<capability type='pci'>
<domain>0</domain>
<bus>2</bus>
<slot>0</slot>
<function>0</function>
<product id='0x10c9'>82576 Gigabit Network Connection</product>
<vendor id='0x8086'>Intel Corporation</vendor>
<capability type='virt_functions'>
<address domain='0x0000' bus='0x02' slot='0x10' function='0x0'/>
<address domain='0x0000' bus='0x02' slot='0x10' function='0x2'/>
<address domain='0x0000' bus='0x02' slot='0x10' function='0x4'/>
<address domain='0x0000' bus='0x02' slot='0x10' function='0x6'/>
<address domain='0x0000' bus='0x02' slot='0x11' function='0x0'/>
<address domain='0x0000' bus='0x02' slot='0x11' function='0x2'/>
<address domain='0x0000' bus='0x02' slot='0x11' function='0x4'/>
</capability>
<iommuGroup number='12'>
<address domain='0x0000' bus='0x02' slot='0x00' function='0x0'/>
<address domain='0x0000' bus='0x02' slot='0x00' function='0x1'/>
</iommuGroup>
<pci-express>
<link validity='cap' port='1' speed='2.5' width='1'/>
<link validity='sta' speed='2.5' width='1'/>
</pci-express>
</capability>
</device>