/usr/sbin/fwflash [-l [-c device_class | ALL ]] | [-v] | [-h]
fwflash [-f file1, file2,file3,... | -r file] [-y] [-d device_path]
fwflash コマンドは、Solaris ホストに接続されたサポートされるフラッシュ可能デバイスにバイナリイメージファイルを書き込みます。また、デバイスでサポートされている場合は、ファームウェアをファイルに読み取る機能も提供します。デバイス内のファームウェアの変更はシステムの安定性に重大な影響を与える場合があるため、All の特権を持つユーザーのみがこのコマンドの実行を許可されます。fwflash の実行を承認されたユーザーには、「Firmware Flash Update」権利プロファイルを付与できます。
このコマンドの最初の形式 (上記) は、デバイスに関する情報を提供します。ファームウェアのアップグレード用に fwflash でサポートされている、システム上の現在使用可能なすべてのデバイスが一覧表示されます。一覧操作をフィルタ処理して、指定したデバイスクラスのみを表示できます。このコマンドの 2 番目の形式は、特定のデバイスとの間でのファームウェアイメージの読み取りまたは書き込みの操作を提供します。
サポートしているオプションは、次のとおりです。
–l オプションとともに使用されている場合にのみ有効なオプションパラメータ。このオプションを指定すると、コマンドは、特定のクラスタイプのデバイスのみを一覧表示します。その他のデバイスクラスは列挙されません。現在サポートされるクラスは、IB、enclosure、disk、または ALL です。–l オプションに –c が指定されていない場合、クラスはデフォルトで ALL になります。
このオプションによって、特定のクラスの検索が制限されます。InfiniBand には IB を、SCSI 格納装置には enclosure を、SCSI/SATA/SAS/FC ディスクには disk を使用します。
dev_path は、ユーザーが –f または –r 操作で変更するデバイスの絶対パス名です。このデバイスが見つからない場合、コマンドは失敗します。–d オプションが指定されている場合は、–f または –r も指定する必要があります。
デバイスに書き込む 1 つまたは複数のバイナリファームウェアイメージファイルへのパスを指定します。fwflash は、各ファイルが指定されたデバイスの有効なファームウェアイメージであることを検証します。そうでない場合、コマンドは該当するエラーメッセージで失敗します。
複数のファームウェアイメージファイルが指定されている場合は、各イメージが検証され、コマンド行で指定された順序でデバイスにフラッシュされます。指定されたいずれかのファイルを正常にフラッシュできない場合は、該当するメッセージが表示されます。
新しいファームウェアイメージがデバイスにフラッシュされたあと、新しいファームウェアを正しくアクティブにするには、リブートが必要です。
fwflash のコマンド行の使用法に関するメッセージを表示します。
ファームウェアのアップグレードに使用可能なシステム上のデバイスを一覧表示し、各デバイスまたはデバイスクラスに固有の情報を表示します。
InfiniBand (IB) デバイスの場合は、一覧操作によって、HCA に現在設定されている guid (グローバル一意識別子) のほか、インストールされている現在のファームウェアリビジョンが表示されます。HCA 上には 4 つの個別の guid が存在し、そのうちの 2 つを同じ値に設定できます。
SCSI Enclosure Services (ses または sgen) デバイスの場合は、識別用のターゲットポートのワールドワイドネームが表示されます (使用可能な場合)。
デバイスからファームウェアを読み取っているときに作成するファイルへのパスを指定します。–f オプションと –r オプションは相互に排他的です。
すべてのフラッシュ可能デバイスがデバイスからのファームウェアイメージの読み取りをサポートしているわけではありません。現時点では、InfiniBand (IB) デバイスのみがこの操作をサポートしています。選択されたデバイスがこの操作をサポートしていない場合は、メッセージが表示されます。
fwflash のバージョン情報を表示して終了します。
フラッシュの読み取り (–r) または書き込み (–f) 操作が指定されている場合にのみ有効です。このオプションを指定すると、fwflash は操作中に確認を求めず、非対話的に動作します。互換性のないファームウェアイメージをデバイスに強制的にフラッシュできるオプションは存在しないことに注意してください。
次のコマンドは、引数なしでコマンドが入力されたときの fwflash を示しています。
example# fwflash Usage: Usage: fwflash [-l [-c device_class | ALL]] | [-v] | [-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 -v print version number of fwflash utility -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
あるいは、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 デバイスファームウェアのファイルへの読み取り
次のコマンドは、デバイスファームウェアをファイルに読み取ります。読み取りが確認なしで実行されるように、このコマンドは –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.使用例 5 フラッシュ可能デバイスが見つからない場合
次のコマンド出力は、ユーザーに、サポートされるフラッシュ可能デバイスがシステム内に見つからなかったことを通知します。
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 コマンドは、次の値を返します。
成功
失敗
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
attributes(5), hermon(7D), ses(7D)
InfiniBand Trade Association の Web サイト、http://www.infinibandta.orghttp://www.infinibandta.org
SCSI Storage Interfaces Committee の Web サイト、http://www.t10.orghttp://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(7D) ドライバで接続された、SAS エクスパンダなどの SCSI Enclosure Services デバイス。