Type: infiniband
Description: LXD supports two different kinds of network types for InfiniBand devices: physical: Passes a physical device from the host through to the instance. The targeted device will vanish from the host and...

Hide navigation sidebar
Hide table of contents sidebar
Skip to content
Back to top
View this page
Toggle table of contents sidebar

# Type: `infiniband`

▶ Watch on YouTube

Note

The `infiniband` device type is supported for both containers and VMs. It supports hotplugging only for containers, not for VMs.

LXD supports two different kinds of network types for InfiniBand devices:

- `physical`: Passes a physical device from the host through to the instance. The targeted device will vanish from the host and appear in the instance.

- `sriov`: Passes a virtual function of an SR-IOV-enabled physical network device into the instance.

  Note

  InfiniBand devices support SR-IOV, but in contrast to other SR-IOV-enabled devices, InfiniBand does not support dynamic device creation in SR-IOV mode. Therefore, you must pre-configure the number of virtual functions by configuring the corresponding kernel module.

## Device options

`infiniband` devices have the following device options:

`hwaddr`

MAC address of the new interface

Key: | `hwaddr`
Type: | string
Default: | randomly assigned
Required: | no

You can specify either the full 20-byte variant or the short 8-byte variant (which will modify only the last 8 bytes of the parent device).

`mtu`

MTU of the new interface

Key: | `mtu`
Type: | integer
Default: | parent MTU
Required: | no

`name`

Name of the interface inside the instance

Key: | `name`
Type: | string
Default: | kernel assigned
Required: | no

`nictype`

Device type

Key: | `nictype`
Type: | string
Required: | yes

Possible values are `physical` and `sriov`.

`parent`

The name of the host device or bridge

Key: | `parent`
Type: | string
Required: | yes

## Configuration examples

Add a `physical` `infiniband` device to an instance:

    lxc config device add <instance_name> <device_name> infiniband nictype=physical parent=<device>

Add an `sriov` `infiniband` device to an instance:

    lxc config device add <instance_name> <device_name> infiniband nictype=sriov parent=<sriov_enabled_device>

See Configure devices for more information.