<address> as child element of <source>

Specifies a device address from the host point of view.

Text content

None.

Selected attributes

The set of relevant attributes depends on the type of the host device: scsi, mdev, or pci. The device type is specified as the type attribute of the ancestor hostdev element.

type="scsi"

Specifies a SCSI device.

bus="0": For a SCSI device, the value is zero.
target: Specifies the SCSI ID.
unit: Specifies the SCSI LUN.

type="mdev"

Specifies a VFIO mediated device, for example, a pass-through device for cryptographic adapter resources.

uuid: Specifies the UUID of the mediated device on the host.

type="pci"

Specifies a pass-through PCI device. On IBM® Z, PCI devices are identified by a function address of the form: <domain>:<bus>:<slot>.<function>. All specifications must match the values of the host device as displayed with lspci -D.

domain: Specifies the PCI domain number.

bus: Specifies the PCI bus.

slot: Specifies the PCI slot.

function: Specifies the PCI function.

Usage

Parent elements

<source> as child element of <hostdev>

Child elements

None.

Example

<devices>
   ...
   <controller type="scsi" model="virtio-scsi" index="0"/>
   <hostdev mode="subsystem" type="scsi">
      <source>
         <adapter name="scsi_host0"/>
         <address bus="0" target="0" unit="0"/>
      </source>
      <address type="drive" controller="0" bus="0" target="0" unit="0"/>
   </hostdev>
   ...
   <hostdev mode="subsystem" type="mdev" model="vfio-ap">
      <source>
        <address uuid="99e714ec-8eee-40fd-a26e-80ff3b1a2564"/>
      </source>
   </hostdev>
   ...
   <hostdev mode="subsystem" type="pci" managed="yes">
      <driver name="vfio"/>
      <source>
         <address domain="0x0002" bus="0x00" slot="0x00" function="0x0"/>
      </source>
      <address type="pci"> 
         <zpci uid="0x0001" fid="0x00000000"/>
      </address>
   </hostdev>
</devices>