(devices-usb)=
# タイプ: `usb`

```{youtube} https://www.youtube.com/watch?v=SAord28VS4g
:title: LXD USB devices
```

```{note}
`usb`デバイスタイプはコンテナとVMの両方でサポートされます。
コンテナとVMの両方でホットプラグをサポートします。
```

USBデバイスは、指定されたUSBデバイスをインスタンスに出現させます。
パフォーマンスの問題のため、高スループットまたは低レイテンシを要求するデバイスの使用は避けてください。

コンテナでは、(`/dev/bus/usb`にある)`libusb`デバイスのみがインスタンスに渡されます。
この方法はユーザスペースのドライバを持つデバイスで機能します。
専用のカーネルドライバを必要とするデバイスは、代わりに[`unix-char`デバイス](devices-unix-char)か[`unix-hotplug`デバイス](devices-unix-hotplug)を使用してください。

仮想マシンでは、USBデバイス全体がパススルーされますので、あらゆるUSBデバイスがサポートされます。
デバイスがインスタンスに渡されると、ホストからは消失します。

## デバイスオプション

`usb`デバイスには以下のデバイスオプションがあります。

キー        | 型     | デフォルト値 | 説明
:--         | :--    | :--          | :--
`gid`       | int    | `0`          | コンテナのみ: インスタンス内のデバイス所有者のGID
`mode`      | int    | `0660`       | コンテナのみ: インスタンス内のデバイスのモード
`productid` | string | -            | USBデバイスのプロダクトID
`required`  | bool   | `false`      | このデバイスがインスタンスの起動に必要かどうか(デフォルトは`false`で、すべてのデバイスがホットプラグ可能です)
`uid`       | int    | `0`          | コンテナのみ: インスタンス内のデバイス所有者のUID
`vendorid`  | string | -            | USBデバイスのベンダーID