Type: object

Type: array
No Additional Items

Tuple Validation

Parameter 1: device

device

Type: string

PCI device identifier to get passthrough information for.

Must be at least 1 characters long

VMDevicePassthroughDevice

Type: object

Detailed information about the specified PCI passthrough device.

No Additional Properties

VMDeviceCapability

Type: object

PCI device capability information.

No Additional Properties

Class

PCI device class identifier. null if not available.

Type: string

Type: null

Domain

PCI domain number. null if not available.

Any of

Option 1
Option 2

Type: string

Type: null

Bus

PCI bus number. null if not available.

Any of

Option 1
Option 2

Type: string

Type: null

Slot

PCI slot number. null if not available.

Any of

Option 1
Option 2

Type: string

Type: null

Function

PCI function number. null if not available.

Any of

Option 1
Option 2

Type: string

Type: null

Product

Product name of the PCI device. null if not available.

Any of

Option 1
Option 2

Type: string

Type: null

Vendor

Vendor name of the PCI device. null if not available.

Any of

Option 1
Option 2

Type: string

Type: null

Controller Type

Type of controller this device provides. null if not a controller.

Any of

Option 1
Option 2

Type: string

Type: null

Default: null

IOMMU group information for device isolation. null if IOMMU not available.

Any of

VMDeviceIOMMUGroup
Option 2

VMDeviceIOMMUGroup

Type: object
No Additional Properties

Number

Type: integer

IOMMU group number for device isolation.

Addresses

Type: array of object

Array of PCI addresses in this IOMMU group.

No Additional Items

Each item of this array must be:

VMDeviceIOMMUGroupAddress

Type: object
No Additional Properties

Domain

Type: string

PCI domain number for this IOMMU group address.

Bus

Type: string

PCI bus number for this IOMMU group address.

Slot

Type: string

PCI slot number for this IOMMU group address.

Function

Type: string

PCI function number for this IOMMU group address.

Type: null

Available

Type: boolean

Whether the device is available for passthrough to virtual machines.

Drivers

Type: array of string

Array of kernel drivers currently bound to this device.

No Additional Items

Each item of this array must be:

Type: string

Error

Error message if the device cannot be used for passthrough. null if no error.

Any of

Option 1
Option 2

Type: string

Type: null

Reset Mechanism Defined

Type: boolean

Whether the device supports proper reset mechanisms for passthrough.

Description

Type: string

Human-readable description of the PCI device.

Critical

Type: boolean

Whether this device is critical to host system operation.

Device Path

Device filesystem path. null if not available.

Any of

Option 1
Option 2

Type: string

Type: null

Call parameters

Tuple Validation

Parameter 1: device

device

Return value

VMDevicePassthroughDevice

capability Required

VMDeviceCapability

class Required

Class

Any of

domain Required

Domain

Any of

bus Required

Bus

Any of

slot Required

Slot

Any of

function Required

Function

Any of

product Required

Product

Any of

vendor Required

Vendor

Any of

controller_type Required

Controller Type

Any of

iommu_group

Any of

VMDeviceIOMMUGroup

number Required

Number

addresses Required

Addresses

Each item of this array must be:

VMDeviceIOMMUGroupAddress

domain Required

Domain

bus Required

Bus

slot Required

Slot

function Required

Function

available Required

Available

drivers Required

Drivers

Each item of this array must be:

error Required

Error

Any of

reset_mechanism_defined Required

Reset Mechanism Defined

description Required

Description

critical Required

Critical

device_path Required

Device Path

Any of