Sun Enterprise 10000 SSP 3.3 リファレンスマニュアル

hpost(1M)

名前 | 形式 | 注意 | 機能説明 | オプション | 使用法 | ファイル | 環境 | 診断 | 関連項目

名前

hpost- JTAG 経由の POST の制御と処理

形式

hpost

-?

-?postrc

-?blacklist

-?level

-?verbose

hpost

-aCcfnqs

-D

boardmask,

path

-D

"comment"

-e

xcode

-g

path

-H

boardmask,refproc

-i

proc

-J

bus_mask

-JJ

bus_mask

-l

level

-p

proc

-Q

proc

,skipmask

-R

redlist_file

-v

level

-X

blacklist_file

-W

-Z

proc

注意

このコマンドは購入先の技術者だけが使用します。このコマンドの使用を誤ると、オペレーティングシステムに重大な障害を引き起こす場合があります。

機能説明

POST (電源投入時自己診断) プログラムは、 Sun Enterprise 10000 システムの未初期化ハードウェアをチェックし、必要に応じて初期化済みシステムに設定したうえで、OBP (OpenBootProm) に渡します。hpost は SSP に常駐する実行可能プログラムであり、Enterprise10000 ドメインと SSP の間の IEEE 1149.1 JTAG 走査インタフェースを介して、POST の動作とシーケンスを制御します。

最初の引数が -n でない場合、hpost(1M) はオプションファイルの .postrc を読み取り、そのファイルに記述されている命令を実行してから、ホストとのやり取りを開始します (postrc(4) を参照)。hpost は、まず現在のディレクトリ (.) の中で .postrc を探します。ここで見つからない場合は、続いて $SSPVAR/etc/platform_name/$SUNW_HOSTNAME を探します。ここでも .postrc が見つからない場合は、ユーザーのホームディレクトリである $HOME を探します。ただし例外として、カレントディレクトリが $HOME の場合は、検索パスの最初の要素である (.) は省略されます。.postrc が見つからない場合は、hpost(1M) は .postrc なしで処理を続行します。

次のコマンドで表示できます。

hpost ?postrc

オプション

hpost のオプションについて説明します。

数値オプションの引数は通常は 10 進数です。ただし、先頭に x または 0x を付けることによって、16 進数で指定することもできます。mask で示される引数は 16 進数になります。
board はシステムボードの番号 (0 〜 15) を示します。
proc はプロセッサの番号 (0 〜 63) を示します。この番号はプロセッサの物理的な位置 (例 : board * 4 + processor_module #) に対応します。
ハイフンの付いたフラグとその引数の間に、スペースは入りません。
オプションの最初のグループの先頭にある疑問符 (?) は h で置き換えることができます。たとえば、-?postrc は -hpostrc で置き換えることができます。

-?

引数の簡単な説明を表示します。

-?postrc

.postrc ファイルの簡単な説明を表示します。

-?blacklist

blacklist(4) / redlist(4) ファイルの構文の簡単な説明を表示します。

-?level

level 番号に関する簡単な説明を表示します。

-?verbose

verbose 番号に関する簡単な説明を表示します。

-a

POST を代替診断レベルで実行します。-a は、通常より高い診断レベルで POST を実行する必要があるエラー再起動シナリオで使用するために便宜的に用意されました。.postrc ファイルで alt_level の値を指定した場合は、-a はその値を代替診断レベルとして使用します。.postrc ファイルで alt_level の値を指定しなかった場合は、デフォルト値を使用します。デフォルト値は、-a を指定しないときのデフォルト診断レベルより高く設定されています。いずれにせよ、診断レベルが -a を指定しないときよりも低くなることはありません。

-a と -l を同時に使用することはできません。-l および postrc(4) も参照してください。

-C

センタープレーンの初期設定を実行します。 -C を指定しないと、hpost は、同じ物理プラットフォーム内にすでに設定済みであり実行中であるドメインがあると想定します。hpost はセンタープレーンを調べて、バス設定を判別します。hpost が調べるのはこの設定だけで、これが無効であると判別された場合は、hpost はただちに終了します。

-C を指定した場合は、hpost はこのプラットフォームでは他に何も実行されていないと想定し、ドメイン内で最高の性能指数を持つバス設定のシステム (センタープレーンも含まれます) をテストし、設定します。

-c

.postrc、blacklist(4)、redlist(4) の各ファイルを (通常通りに) 構文解析します。構文エラーを検出した場合は、メッセージを表示してただちに終了します。postrc(4)、blacklist(4)、redlist(4) を参照してください。

-D[boardmask,][path]

特別なモードの POST を起動します。この特別なモードでは、POST はホストから状態を走査し、その結果をバイナリファイルにダンプして、ただちに終了します。 path が指定されていない場合は、デフォルトのパスが使用されます (boardmask に続くコンマは必須です )。ダンプファイルは hpost では分析できませんが、購入先とサンの担当者には有用なデータとなります。

boardmask はマシンの 20 ビットマスクの部分をダンプに含めることを指定します。ビット 0 〜 15 はシステムボード、ビット 16 と 17 はセンタープレーンの 2 つのハーフ、ビット 18 と 19 は 2 つの制御ボードにそれぞれ対応します。boardmask を指定しないと、値は FFFFF とみなされ、システムの全部分がダンプに含まれます。ただし、hpost は発見的決定アルゴリズムを使用して、接続されていないか電源が切れているシステムボードを検出し、ダンプファイルに含まないようにします。boardmask が指定されている場合、こうした編集は行われません。

-D が指定されていると、hpost の標準入力が端末である場合に、1 行のコメントをファイルに入れることを促すメッセージが表示されます。Return キーだけを押すと、コメントは空白になります。一緒に -d を指定した場合は、コメントの入力を促すメッセージは表示されません。-d オプションの説明を参照してください。

-d "comment"

指定したコメントをダンプファイルに挿入します。このオプションと引数の間にはスペースを入れます。単一の語からなるコメントの場合は、引用符は必要ありません。標準の入力手段 (端末、スクリプト等) であるかどうかに関わらず、コメントが挿入されます。 -D を参照してください。

-excode

POST 終了コードのオンラインの説明を標準出力に出力します。

-Hboardmask,refproc

特別なモードの POST を実行します。このモードでは、動作中のドメインに 1 つまたは複数のボードを DR (動的再構成) 接続するための準備が行われます。boardmask は、POST が実行されるボードの 16 ビットマスクで、refproc はターゲットドメインの現在のマスター CPU です。この CPU は別のボードに装着されている必要があります。

注意 - コマンド行では -H を指定しないでください。 -H は DR プロセスの 1 ステップとして他のプログラムからのみ呼び出される必要があります。dr(1M) を参照してください。

-i[proc]

対話モードを実行します。このオプションはデバッグのために使用します。proc (単一プロセッサの番号) を指定すると、そのプロセッサだけが使用され、hpost は対話セッションを開始します。proc を指定しないと、すべてのプロセッサが使用され、hpost は、デバッグの各段階で、その段階を実行するか、次に進むかを尋ねるだけの単純な対話セッションを開始します。

-Jbus_mask

テストに基づいて設定を選択する代わりに、指定したバス設定を使用します。このモードの POST を使用するのはサンの技術者だけであり、bus_mask は指定したバス設定における 6 ビットのバイナリマスクとして解釈されます。2 つの最上位ビットはデータバスであり、4 つの最下位ビットはアドレスバスです。3F はすべてのバスの使用を hpost に指示します。

-JJbus_mask

このオプションは -J オプションに似ていますが、実行されるのは JTAG の初期設定だけです。

-llevel

POST による診断レベルを設定します。有効値は 7 〜 127 で、デフォルトのレベルは 16 です。 -?level を指定すると、簡単な説明が表示されます。

-n

.postrc ファイルの読み取りを抑止します。このオプションは必ず先頭に指定してください。

-pproc

指定したプロセッサを優先ブートプロセッサとして使用します。指定したプロセッサが最終設定に定義されていない場合は、このオプションは無視されます。

-Qproc[,skipmask]

(Quick POST) このオプションを指定すると、POST は指定されたプロセッサのブートバス SRAM から設定情報を読み取り、最小限のテストを実行して、記述されたシステムを再設定します。ソフトウェアのクラッシュをすぐに回復する必要がある場合には、このオプションを使用します。指定した設定を実現できない場合は、このオプションは失敗します。

skipmask オプションを指定すると、呼び出し側 (通常は別のプログラム) は、初期設定プロセスの中で不必要と判断したステップを省略します。このため、回復がより速くなります。skipmask のビットの意味を以下に示します。

0 - 再設定の全段階を実行します (デフォルト)。

0x0001 - プロセッサ IMU のタグをクリアせず、IMU を無効にしません。

0x0002 - プロセッサ DMU のタグをクリアせず、DMU を無効にしません。

0x0004 - プロセッサの命令キャッシュをクリアしません。

0x0008 - プロセッサのデータキャッシュをクリアしません。

0x0010 - プロセッサの外部キャッシュをクリアしません。

0x0020 - CIC 重複タグ (DTAG) をクリアしません。

0x0040 - 入出力コントローラを初期設定しません。

0x0080 - メモリーをクリアしません。

-q

省略 (Quiet) モード。画面出力をすべて破棄します。

-R {redlist_file | none}

デフォルトの redlist ファイルの代わりに使用する redlist を指定します。none を指定すると、redlist ファイルは使用されません。下記の「注意」を参照してください。

-s

適切な優先順位を付けたうえで、画面出力をすべて syslog に送ります。

-vlevel

メッセージの冗長レベルを設定します。有効値は 0 〜 255 で、デフォルトのレベルは 20 です。 -?verbose を指定すると、簡単な説明が表示されます。

-X {blacklist_file | none}

デフォルトのパスは使用しません。none を指定すると、blacklist(4) ファイルは使用されません。下記の「注意」を参照してください。

-W[c]

現在のドメインに存在しているレコード停止状態をクリアし、センタープレーンの ASIC レコーディングを再度有効にしようとします。このドメインにアービトレーション停止やその他の重大なエラーが検出されたときは、報告したうえで、レコード停止をクリアしようとする試みは放棄されます。この操作の結果は、hpost の終了コードで報告されます。

レコード停止状態が別のドメインに存在している場合は、センタープレーンのレコーディングを再度有効にする試みは失敗します。この失敗は報告されますが、-W の操作は失敗したとはみなされません。

InterDomain Networks (IDN) に属するドメインに対する -W 操作では、オプションの c フラグを使用してください。IDN の 1 つのドメインに対してのみ -Wc を呼び出してください。hpost は、そのドメインおよび IDN 内の他のすべてのドメインのレコード停止をクリアします。

通常、このモードの hpost は、状態ダンプファイルが作成されてから、SSP イベント検出デーモンによって呼び出されます。-D オプションを参照してください。

-Zproc

(Zip POST) このオプションを指定すると、POST は指定したプロセッサのブートバス SRAM から設定情報を読み取り、システムの JTAG 初期設定だけを実行して、記述されている設定を実現します。ソフトウェアのクラッシュの後でソフトウェアの状態をダンプする場合は、このオプションを使用します。通常の POST プロセスではこの状態は破壊されるおそれがあります。指定した設定を実現できない場合には、hpost -Z は失敗したものとみなされます。

注意 - プロダクションシステムで -R または -X を使用するときには注意が必要です。POST が標準外の blacklist(4) ファイルまたは redlist(4) ファイルを使用していることは、他の SSP ソフトウェアにはわかりません。

使用法

通常、POST は SSP の監視スクリプトまたは監視プログラムによって実行されます。ただし、エンジニアリング開発、製造、保守サービスなどの状況では、コマンド行から実行されることもあります。

ファイル

以下のファイルがサポートされます。

./.postrc - ローカルの POST 設定ファイル

$HOME/.postrc - ユーザーのデフォルト POST 設定ファイル

$SSPVAR/etc/platform_name/$SUNW_HOSTNAME/.postrc - ホスト名に固有のデフォルト POST 設定ファイル

$SSPVAR/etc/platform_name/blacklist - デフォルトの blacklist ファイル (-X を参照)

$SSPVAR/etc/platform_name/redlist - デフォルトの redlist ファイル (-R を参照)

$SSPVAR/adm/$SUNW_HOSTNAME/post/postmmdd.hhmm.log - デフォルトのログファイル (-g を参照)

$SSPVAR/adm/$SUNW_HOSTNAME/xfstatemmdd.hhmm.ss - デフォルトのダンプファイル (-D を参照)

$SSPVAR/adm/$SUNW_HOSTNAME/hpost.lock - POST ロックファイル

$SSPOPT/release/Ultra-Enterprise-10000/*/*/*/hostobjs/*.elf - (ホストに常駐している) POST の実行可能ファイルをダウンロードするときのパス

環境

環境変数 SUNW_HOSTNAME が該当ドメイン名に設定されている必要があります。

診断

0 〜 63 の終了ステータスは、正常な設定を意味します。この数値は、POST 対 OBP のハンドオフ構造体 (設定を記述します) を持つブートバス SRAM が含まれているプロセッサの数を示します。0 〜 63 以外の数値は、システムが設定されていないことを示します (これらはサンの技術者だけが使用する数値であり、関連情報は使用制限の見出しが付いたファイルに記述されています。ただし、-e オプションを指定すると、すべての値の説明が表示されます)。