Type: unix-block

▶ Watch on YouTube (opens in a new tab)

Note
The unix-block device type is supported for containers. It supports hotplugging.

Unix block devices make the specified block device appear as a device in the container (under /dev). You can read from the device and write to it.

Device options

unix-block devices have the following device options:

gid

GID of the device owner in the container

• Key: gid
• Type: integer
• Default: 0

major

Device major number

• Key: major
• Type: integer
• Default: device on host

minor

Device minor number

• Key: minor
• Type: integer
• Default: device on host

mode

Mode of the device in the container

• Key: mode
• Type: integer
• Default: 0660

path

Path inside the container

• Key: path
• Type: string
• Required: either source or path must be set

required

Whether this device is required to start the container

• Key: required
• Type: bool
• Default: true

See Hotplugging for more information.

source

Path on the host

• Key: source
• Type: string
• Required: either source or path must be set

uid

UID of the device owner in the container

• Key: uid
• Type: integer
• Default: 0

Configuration examples

Add a unix-block device to a container by specifying its source and path:

lxc config device add <instance_name> <device_name> unix-block source=<path_on_host> path=<path_on_instance>

If you want to use the same path on the container as on the host, you can omit the source option:

lxc config device add <instance_name> <device_name> unix-block path=<path_to_the_device>

See Configure devices for more information.

Hotplugging

Hotplugging is enabled if you set required=false and specify the source option for the device.

In this case, the device is automatically passed into the container when it appears on the host, even after the container starts. If the device disappears from the host system, it is removed from the container as well.