fwflash - ファームウェアのクエリーおよび更新ユーティリティー
/usr/sbin/fwflash [-l [-c
device_class | ALL ]]
| [-h]
fwflash [-f file1,
file2,file3,... | -r
file]
[-y] [-d device_path]
fwflash コマンドは、Solaris ホストに接続されたサポートされるフラッシュ可能デバイスにバイナリイメージファイルを書き込みます。また、デバイスでサポートされている場合は、ファームウェアをファイルに読み取る機能も提供します。デバイス内のファームウェアの変更はシステムの安定性に重大な影響を与える場合があるため、All の特権を持つユーザーのみがこのコマンドの実行を許可されます。fwflash の実行を承認されたユーザーには、「Firmware Flash Update」権利プロファイルを付与できます。
このコマンドの最初の形式 (上記) は、デバイスに関する情報を提供します。ファームウェアのアップグレード用に fwflash でサポートされている、システム上の現在使用可能なすべてのデバイスが一覧表示されます。一覧操作をフィルタ処理して、指定したデバイスクラスのみを表示できます。このコマンドの 2 番目の形式は、特定のデバイスとの間でのファームウェアイメージの読み取りまたは書き込みの操作を提供します。
サポートしているオプションは、次のとおりです。
–l オプションとともに使用されている場合にのみ有効なオプションパラメータ。このオプションを指定すると、コマンドは、特定のクラスタイプのデバイスのみを一覧表示します。その他のデバイスクラスは列挙されません。Currently supported classes are IB, ETH, enclosure, disk, or ALL.–l オプションに –c が指定されていない場合、クラスはデフォルトで ALL になります。
このオプションによって、特定のクラスの検索が制限されます。Use IB for InfiniBand, ETH for Ethernet, enclosure for SCSI enclosures, and disk for SCSI/SATA/SAS/FC disks.
dev_path は、ユーザーが –f または –r 操作で変更するデバイスの絶対パス名です。このデバイスが見つからない場合、コマンドは失敗します。–d オプションが指定されている場合は、–f または –r も指定する必要があります。
デバイスに書き込む 1 つまたは複数のバイナリファームウェアイメージファイルへのパスを指定します。fwflash は、各ファイルが指定されたデバイスの有効なファームウェアイメージであることを検証します。そうでない場合、コマンドは該当するエラーメッセージで失敗します。Cards running secure firmware have additional restrictions (see NOTES section below).
複数のファームウェアイメージファイルが指定されている場合は、各イメージが検証され、コマンド行で指定された順序でデバイスにフラッシュされます。指定されたいずれかのファイルを正常にフラッシュできない場合は、該当するメッセージが表示されます。
新しいファームウェアイメージがデバイスにフラッシュされたあと、新しいファームウェアを正しくアクティブにするには、リブートが必要です。
fwflash のコマンド行の使用法に関するメッセージを表示します。
ファームウェアのアップグレードに使用可能なシステム上のデバイスを一覧表示し、各デバイスまたはデバイスクラスに固有の情報を表示します。
For InfiniBand (IB) and Ethernet (ETH) devices, the list operation displays the guids (Globally Unique Identifier) and MAC addresses currently set for the device, as well as the current firmware revision installed.There are four separate guids on the device; two of them can be set with the same value.Typically, there are two MAC addresses, one for each port on the device.Secure firmware cards will also show the firmware security attributes (see NOTES section below).
SCSI Enclosure Services (ses または sgen) デバイスの場合は、識別用のターゲットポートのワールドワイドネームが表示されます (使用可能な場合)。
デバイスからファームウェアを読み取っているときに作成するファイルへのパスを指定します。–f オプションと –r オプションは相互に排他的です。
すべてのフラッシュ可能デバイスがデバイスからのファームウェアイメージの読み取りをサポートしているわけではありません。At present, only InfiniBand (IB) and Ethernet (ETH) devices are supported for this operation.選択されたデバイスがこの操作をサポートしていない場合は、メッセージが表示されます。Cards running secure firmware do not support this operation (see NOTES section below).
フラッシュの読み取り (–r) または書き込み (–f) 操作が指定されている場合にのみ有効です。このオプションを指定すると、fwflash は操作中に確認を求めず、非対話的に動作します。互換性のないファームウェアイメージをデバイスに強制的にフラッシュできるオプションは存在しないことに注意してください。
次のコマンドは、引数なしでコマンドが入力されたときの fwflash を示しています。
example# fwflash
Usage:
Usage:
fwflash [-l [-c device_class | ALL]] | [-h]
fwflash [-f file1,file2,file3,... | -r file] [-y] -d device_path
-l list flashable devices in this system
-c device_class limit search to a specific class
eg IB for InfiniBand, ses for SCSI Enclosures
-h print this usage message
-f file1,file2,file3,...
firmware image file list to flash
-r file file to dump device firmware to
-y answer Yes/Y/y to prompts
-d device_path pathname of device to be flashed
If -d device_path is specified, then one of -f <files>
or -r <file> must also be specified
If multiple firmware images are required to be flashed
they must be listed together, separated by commas. The
images will be flashed in the order specified.
使用例 2 フラッシュに使用可能なデバイスの一覧表示
次のコマンドは、フラッシュに使用可能なデバイスを一覧表示します。
example# fwflash -l
List of available devices:
Device[0], /devices/pci@0,0/pci8086,3595@2/pci8086,32a@0,2/\
pci15b3,5a46@c/pci15b3,5a44@0:devctl
Class [IB]
GUID: System Image - 0002c901081e33b3
Node - 0000000000003446
Port 1 - 0002c901081e33b1
Port 2 - 0002c901081e33b2
Firmware revision: 2.7.8100
Product : 375-3606-03
PSID : SUN0150000009
Description : Sun Falcon QDR
Device[1], /devices/pci@0,0/pci8086,3597@4/pci15b3,6278@0:devctl
Class [IB]
GUID: System Image - 0002c9010a99e3b3
Node - 0002c9010a99e3b0
Port 1 - 0002c9010a99e3b1
Port 2 - 0002c9010a99e3b2
Firmware revision: 2.7.8100
Product : 375-3606-03
PSID : SUN0150000009
Description : Sun Falcon QDR
Device[2], /devices/pci@0,0/pci8086,2f04@2/pci15b3,16@0:devctl
Class [ETH]
GUID: System Image - ec0d9a0300d8f62a
Node - ec0d9a0300d8f62a
Port 1 - ec0d9a0300d8f62a
Port 2 - ec0d9a0300d8f62b
Mac 1 - 0000ec0d9ad8f62a
Mac 2 - 0000ec0d9ad8f62b
Firmware revision : 16.21.2024
Product : MCX556A-EDAS_C14
PSID : ORC0000000003
Description : CX556A - ConnectX-5 QSFP28
Security attributes: secure-fw signed
あるいは、SCSI Enclosure Services デバイスとして表示される SAS エクスパンダの場合は、次のような出力が表示されることがあります。
example# fwflash -l
List of available devices:
Device[0] /devices/pci@0/pci@0/pci@2/scsi@0/ses@3,0:ses
Class [sgen]
Target port WWN : 500605b00002453d
Vendor : SUN
Product : 16Disk Backplane
Firmware revision: 5021
使用例 3 IB HCA デバイスのフラッシュアップグレード
次のコマンドは、IB HCA デバイスをフラッシュアップグレードします。
example# fwflash -f ./version.3.2.0000 \ -d /devices/pci@0,0/pci8086,3597@4/pci15b3,6278@0:devctl About to update firmware on: /devices/pci@0,0/pci8086,3597@4/pci15b3,6278@0:devctl Continue (Y/N): Y Updating . . . . . . . . . . . . Done. New image will be active after the system is rebooted.
アップグレードを続行する前に確認を求められること、および新しいファームウェアイメージをアクティブにするにはホストをリブートする必要があることに注意してください。
次のコマンドは、このコマンドに –y オプションを追加します。
example# fwflash -y -f ./version.3.2.0000 \ -d /devices/pci@0,0/pci8086,3597@4/pci15b3,6278@0:devctl About to update firmware on: /devices/pci@0,0/pci8086,3597@4/pci15b3,6278@0:devctl Updating . . . . . . . . . . . . Done. New image will be active after the system is rebooted.使用例 4 Flash Upgrading an ETH Device
The following command flash upgrades an ETH device.
example# fwflash -f \
fw-ConnectX5-rel-16_22_1002-MCX556A-EDAS_C14_Ax-FlexBoot-3.5.403.bin \
-d /devices/pci@0,0/pci8086,2f04@2/pci15b3,16@0:devctl
Verify firmware image
Current HCA firmware version: 16.21.2024
Security attributes: secure-fw signed
Will be updated to firmware : 16.22.1002
Security attributes: secure-fw signed
About to update firmware on /devices/pci@0,0/pci8086,2f04@2/pci15b3,16@0:devctl
with file fw-ConnectX5-rel-16_22_1002-MCX556A-EDAS_C14_Ax-FlexBoot-3.5.403.bin.
Do you want to continue (Y/N): Y
Updating firmware: this takes about 40 seconds, so please be patient.
Updating firmware: Success!
fwflash: New firmware will be activated after you reboot
使用例 5 デバイスファームウェアのファイルへの読み取り
次のコマンドは、デバイスファームウェアをファイルに読み取ります。読み取りが確認なしで実行されるように、このコマンドは –y オプションを使用します。
example# fwflash -y -r /firmware.bin \
-d /devices/pci@1d,700000/pci@1/pci15b3,5a44@0:devctl
About to read firmware on:
/devices/pci@1d,700000/pci@1/pci15b3,5a44@0:devctl
to filename: /firmware.bin
Reading . . .
Done.
使用例 6 フラッシュ可能デバイスが見つからない場合
次のコマンド出力は、ユーザーに、サポートされるフラッシュ可能デバイスがシステム内に見つからなかったことを通知します。
example# fwflash -l fwflash: No flashable devices attached with the ses driver in this system fwflash: No flashable devices attached with the sgen driver in this system fwflash: No flashable devices attached with the hermon driver in this system fwflash: No flashable devices in this system
/usr/lib/fwflash/identify 内に見つかった各プラグインを順番にロードし、システムデバイスツリーを調べて、現在接続されているいずれかのデバイスをフラッシュできるかどうかを判定します。現在サポートされているデバイスタイプおよびドライバのリストについては、下の「注意事項」のセクションを参照してください。
fwflash コマンドは、次の値を返します。
成功
Failure
属性についての詳細は、マニュアルページの attributes(7) を参照してください。
|
hermon(4D), mlxne(4D), ses(4D), attributes(7)
The InfiniBand Trade Association website, https://www.infinibandta.org
The SCSI Storage Interfaces committee website, https://www.t10.org
SCSI Primary Commands-4, SPC4
SCSI Enclosure Services-2, SES2
Serial Attached SCSI-2, SAS2
fwflash コマンドは、次のものをサポートしています。
AMD または Intel のどちらかの並列フラッシュ部品を含む InfiniBand ホストチャネルアダプタ (IB HCA)。
ses(4D) ドライバで接続された、SAS エクスパンダなどの SCSI Enclosure Services デバイス。
Some Oracle OEM Mellanox adapters (e.g. ConnectX-5) use so-called "secure firmware" (SF).This feature is meant to restrict firmware usage to only officially approved versions.SF image files are digitally signed and verified when attempting to write the image to a card.
If the signature cannot be verified, the writing (-f) operation is blocked, and an error message will be printed.Once a card running SF is written with a new firmware image, the new image must be activated (via reboot), before the card can be written again with a new image.
Cards supporting SF will show "Security attributes" with the list (-l) option.Production SF will have the "secure-fw" and "signed" attributes.Development SF will also show the "dev" attribute.Debug SF will also have the "debug" attribute.Production and Development SF use different keys.A card running Production SF cannot be written with Development SF without using a special hardware procedure.
Cards running SF do not support the read (-r) option to read firmware from the card.