io7m | single-page | multi-page
3.9. vm-add-lpc-device
Previous
3. Command-Line Interface
Up
3.11. vm-add-virtio-disk
Next
3.10

# vm-add-passthru-device

- 3.10. vm-add-passthru-device
  - 3.10.1. Name
  - 3.10.2. Description
  - 3.10.3. Example
  - 3.10.4. See Also

3.10.1

## Name

1
vm-add-passthru-device - Add a PCI passthru device to a virtual machine
3.10.2

## Description

1
The vm-add-passthru-device command adds a PCI passthru device to the virtual machine. Using a PCI passthru device requires wiring the guest virtual machine's memory - see the vm-set command.
2

### 3.10.2.2 Parameters

Parameter | Type | Required | Description
--- | --- | --- | ---
--add-backend | TTY Backend | true | A specification of the TTY device backend to add
--comment | String | false | A comment describing the new device
--configuration | Path | false | The path to the configuration file (environment variable: $WAXMILL_CONFIGURATION_FILE)
--device-slot | Device Slot | true | The slot to which the device will be attached.
--host-device-slot | Device Slot | true | The host device.
--machine | UUID | true | The ID of the virtual machine
--verbose | Log Level | false | Set the minimum logging verbosity level.
--replace | Boolean | false | true if an existing device in the given slot should be replaced.

3

### 3.10.2.3 Device Slot Syntax

    bus        = ? [0 .. 255] ? ;
    slot       = ? [0 .. 31] ? ;
    function   = ? [0 .. 7] ? ;
    deviceSlot = bus , ":" , slot , ":" , function ;

    Examples:
      0:0:0
      255:31:7

3.10.3

## Example

1

### 3.10.3.1 Example

    $ waxmill vm-add-passthru-device \
      --machine de17174a-1b3c-4ebc-80af-cb239aa18cbd \
      --device-slot 0:4:0 \
      --host-device-slot 1:2:3

3.10.4

## See Also

1
See bhyve PCI Passthrough on the FreeBSD wiki.
3.9. vm-add-lpc-device
Previous
3. Command-Line Interface
Up
3.11. vm-add-virtio-disk
Next
io7m | single-page | multi-page