# vm.device.passthrough_device

Retrieve details about device PCI device

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.

## Any of

Type: string
Type: null

##

#### Domain

PCI domain number. `null` if not available.

## Any of

Type: string
Type: null

##

#### Bus

PCI bus number. `null` if not available.

## Any of

Type: string
Type: null

##

#### Slot

PCI slot number. `null` if not available.

## Any of

Type: string
Type: null

##

#### Function

PCI function number. `null` if not available.

## Any of

Type: string
Type: null

##

#### Product

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

## Any of

Type: string
Type: null

##

#### Vendor

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

## Any of

Type: string
Type: null

##

#### Controller Type

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

## Any of

Type: string
Type: null

##

Default: null

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

## Any of

#### 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

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

Type: string
Type: null

Required roles: VM_DEVICE_READ