名称

nvmecontrol — NVM Express 制御ユーティリティ

書式

nvmecontrol

devlist

nvmecontrol

identify [ -v][ -x]<device id>

nvmecontrol

perftest < -n num_threads>< -o read|write>[ -p]< -s size_in_bytes>< -t time_in_sec><namespace id>

nvmecontrol

reset <controller id>

nvmecontrol

logpage < -p page_id>[ -x]<device id><namespace id>

nvmecontrol

firmware [ -s slot][ -f path_to_firmware][ -a]<device id>

解説

NVM Express (NVMe) は、PCI Express 上の SSD と他の高速記憶デバイスのための、記憶プロトコルの標準です。

使用例

nvmecontrol devlist

それらのデバイスノードと共に NVMe コントローラと名前空間のリストを表示します。

nvmecontrol identify nvme0

nvme0 IDENTIFY_CONTROLLER データの人間に読み込み可能な要約を表示します。

nvmecontrol identify -x -v nvme0ns1

名前空間 1 のための nvme0 IDENTIFY_NAMESPACE データの 16 進数のダンプを表示します。

nvmecontrol perftest -n 32 -o read -s 512 -t 30 nvme0ns1

32 のカーネルスレッドを 30 秒に使用して、nvme0ns1 上で性能テストを実行します。各スレッドは、単一の 512 バイトの読み込みコマンドを発行します。結果は、30 秒の期限がすぎると、標準出力 (stdout) に印刷 (表示) されます。

nvmecontrol reset nvme0

nvme0 コントローラのコントローラレベルのリセットを実行します。

nvmecontrol logpage -p 1 nvme0

nvme0 コントローラのエラー情報ログの人間に読み込み可能な要約を表示します。 NVMe 仕様によって定義されたログページは、Error Information Log (エラー情報ログ) (ID=1)、SMART/Health Information Log (SMART/Health 情報ログ) (ID=2) と Firmware Slot Log (ファームウェアのスロットログ) (ID=3) を含んでいます。

nvmecontrol logpage -p 1 -x nvme0

nvme0 コントローラのエラー情報ログの16進数のダンプを表示します。

nvmecontrol firmware -s 2 -f /tmp/nvme_firmware nvme0

"/tmp/nvme_firmware"に含まれるファームウェアイメージを nvme0 コントローラのスロット 2 にダウンロードしますが、イメージを活性化しません。

nvmecontrol firmware -s 4 -a nvme0

次のリセットで nvme0 コントローラのスロット 4 のファームウェアを活性化します。

nvmecontrol firmware -s 7 -f /tmp/nvme_firmware -a nvme0

"/tmp/nvme_firmware"に含まれるファームウェアイメージを nvme0 コントローラのスロット 7 にダウンロードしますが、次のリセットでそれを活性化します。

作者

nvmecontrol は、Intel によって開発され、最初に Jim Harris <jimharris@FreeBSD.org>によって書かれました。

このマニュアルページは、 Jim Harris <jimharris@FreeBSD.org>によって書かれました。