Type: unix-char - LXD documentation
Description: Unix character devices make the specified character device appear as a device in the instance (under/dev). You can read from the device and write to it. Device options: unix-char devices have the f...

Hide navigation sidebar
Hide table of contents sidebar
Back to top
Toggle table of contents sidebar

# Type: `unix-char`

▶ Watch on YouTube

Note

The `unix-char` device type is supported for containers. It supports hotplugging.

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

## Device options

`unix-char` devices have the following device options:

Key | Type | Default | Description
--- | --- | --- | ---
`gid` | int | `0` | GID of the device owner in the instance
`major` | int | device on host | Device major number
`minor` | int | device on host | Device minor number
`mode` | int | `0660` | Mode of the device in the instance
`path` | string | - | Path inside the instance (one of `source` and `path` must be set)
`required` | bool | `true` | Whether this device is required to start the instance (see Hotplugging)
`source` | string | - | Path on the host (one of `source` and `path` must be set)
`uid` | int | `0` | UID of the device owner in the instance

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