第 3 章 システム変数の設定

この章では、不揮発性 RAM (NVRAM) のシステム変数にアクセスし、変更する方法について説明します。

システム変数はシステム NVRAM に格納されます。それらの変数は、起動時のマシン構成と関連する通信特性を設定します。システム変数のデフォルト値は変更することができ、行った変更は電源再投入後も有効です。システム変数は常に注意深く調整する必要があります。

この章で説明する手順は、ユーザーインタフェースに入っているものとしています。ユーザーインタフェースに入る方法については、第 1 章「概要」を参照してください。

表 3-1 に、IEEE Standard 1275-1994 の定義に従う標準的セットの NVRAM システム変数の一覧を示します。

上記以外に、IEEE Standard 1275-1994 の SBus 版でシステム変数が定義されています。それらの変数を表 3-2 に示します。

OpenBoot の実装が異なると、使用するデフォルトやシステム変数も異なる場合があります。

変数設定の表示と変更

NVRAM システム変数は、表 3-3 に示すコマンドを使用して表示、変更できます。

以降でこれらのコマンドをどのように使用できるかを示します。

Sun OS は OpenBoot システム変数を変更するための eeprom (1M) ユーティリティーを備えています。

変数の現在の設定の表示システムの現在の変数設定のリストを表示するには、次のように入力します。

ok printenv 

Variable Name   Value   Default Value
oem-logo 2c 31 2c 2d 00 00 00 00 ...
oem-logo?       false   false
oem-banner
oem-banner?     false   false
output-device   ttya    screen
input-device    ttya    keyboard
sbus-probe-list 03      0123
diag-file
diag-device     net     net
boot-file
boot-device     disk    disk net
auto-boot?      false   true
fcode-debug?    true    false
use-nvramrc?    false   false
nvramrc
screen-#columns 80      80
screen-#rows    34      34
security-mode   none    none
security-password
security-#badlogins     0
diag-switch?    true    false
ok

現在の設定の書式付きリストでは、数値変数は 10 進数で示されます。

変数設定を変更するには、次のように入力します。

ok setenv variable-name value

variable-name は変数の名前であり、value は変数に該当する数値またはテキスト文字列です。数値のデータ型は、0x を前に付けなければ 10 進になります。0x は 16 進数の修飾子です。

たとえば、auto-boot? 変数の設定を false に変更するには、次のように入力します。

ok setenv auto-boot? false
ok 

多くの場合、変数の値を変更しても、そのままでは OpenBoot ファームウェアの動作には無効です。次の電源再投入またはシステムリセットで初めて、ファームウェアはそれらの変数の新しい値を使用します。

set-default 変数と set-defaults コマンドを使用して、変数の特定の 1 つまたは大部分をもとのデフォルト設定に戻すことができます。

たとえば、auto-boot? 変数をそのもとのデフォルト設定 (true) に戻すには、次のように入力します。

ok set-default auto-boot?
ok

大部分の変数をそれぞれのもとのデフォルト設定に戻すには、次のように入力します

ok set-defaults
ok

SPARC システムでは、マシンのパワーアップ処理の間「Stop-N」 を押し下げておくことにより、NVRAM 変数をそれぞれのデフォルト設定に戻すことができます。このコマンドを発行するときは、SPARC システムに電源を投入した直後に「Stop-N」を押し、数秒間またはバナーが表示されるまで (ディスプレイが使用できる場合)、押さえたままにしておきます。これにより、SPARC と互換性のあるマシンの NVRAM の内容をデフォルト設定に戻すことができます。

セキュリティー変数の設定

NVRAM のシステムセキュリティー用として次に示す変数があります。

• security-mode

• security-password

• security-#badlogins

security-mode は、ユーザーがユーザーインタフェースから実行できる一連の処理を制限できます。3 つのセキュリティーモードを、セキュリティーの高い順序で示すと次のとおりです。

コマンドセキュリティー

security-mode を設定しているときは、

• boot コマンドだけを入力する場合、パスワードは必要ありません。ただし、引数を付けて boot コマンドを使用すると、パスワードが必要です。

• go コマンドはパスワードを要求しません。

• その他のコマンドを実行するにはパスワードが必要です。

次に画面で例を示します。

ok boot     (パスワード必要なし)
ok go       (パスワード必要なし)
ok boot filename  (パスワード必要)
Password:   (入力時パスワードは画面表示されない)
ok reset-all   (パスワード必要)
Password:   (入力時パスワードは画面表示されない) 

セキュリティーパスワードを絶対に忘れないようにしてください。また、セキュリティーモードを設定する前にセキュリティーパスワードを設定してください。このパスワードを忘れると、システムが使用できなくなります。購入先に連絡してマシンを再び起動可能にする必要があります。

セキュリティーパスワードと command セキュリティーモードを設定するには、ok プロンプトで次のように入力します。

ok password 
ok New password (only first 8 chars are used):
ok Retype new password:
ok setenv security-mode command 
ok

設定するセキュリティーパスワードは 0 〜 8 つの文字でなければなりません。8 文字目より後の文字は無視されます。システムをリセットする必要はありません。セキュリティー機能はコマンドを入力した直後に有効になります。

誤ったセキュリティーパスワードを入力した場合は、約 10 秒の遅延があってから次の起動プロンプトが現れます。誤ったセキュリティーパスワードを入力した回数は security-#badlogins 変数に格納されます。

フルセキュリティー

full セキュリティーモードは最も制限の多いモードです。security-mode を full に設定した場合は、

• boot コマンドの入力時にはパスワードが必要です。

• go コマンドはパスワードを要求しません。

• その他のコマンドを実行するにはパスワードが必要です。

次に例を示します。

ok go       (パスワード必要なし)
ok boot     (パスワード必要)
Password:   (入力時パスワードは画面表示されない)
ok boot filename   (パスワード必要)
Password:   (入力時パスワードは画面表示されない)
ok reset-all     (パスワード必要)
Password:   (入力時パスワードは画面表示されない)

セキュリティーパスワードを絶対に忘れないようにしてください。また、セキュリティーモードを設定する前にセキュリティーパスワードを設定してください。このパスワードを忘れると、システムが使用できなくなります。購入先に連絡してマシンを再び起動可能にする必要があります。

セキュリティーパスワードと full セキュリティーを設定するには、ok プロンプトで次のように入力します。

ok password 
ok New password (only first 8 chars are used):
ok Retype new password:
ok setenv security-mode full 
ok

電源投入時バナーの変更

バナー構成用として次の変数があります。

• oem-banner

• oem-banner?

• oem-logo

• oem-logo?

電源投入時バナーを表示するには、次のように入力します。

ok banner 
Sun Ultra 1 SBus (UltraSPARC 167 MHz),Keyboard PresentPROM
Rev. 3.0, 64MB memory installed, Serial # 289Ethernet
address 8:0:20:d:e2:7b, Host ID: 80000121
ok

システムによりバナーはこれとは異なることがあります。

バナーは、テキストフィールドとロゴの 2 つの部分からなっています (シリアルポートを介す場合は、テキストフィールドしか表示されません)。oem-banner と oem-banner? システム変数を使用して、既存のテキストフィールドを、カスタマイズしたテキストメッセージに置き換えることができます。

作成カスタマイズしたバナー電源投入時バナーにカスタマイズしたテキストフィールドを挿入するには、次のように入力します。

ok setenv oem-banner Hello Mom and Dad
ok setenv oem-banner? true
ok banner
 Hello Mom and Dad
ok

システムは、前の画面に示すように、新しいメッセージ付きのバナーを表示します。

図形ロゴは多少異なる方法で取り扱わなければなりません。oem-logo は、64×64 に配列された合計 4096 ビットからなる 512 バイトの配列です。各ビットはそれぞれ 1 ピクセルに相当します。最初のバイトの最上位ビット (MSB) が左上コーナのピクセルを制御します。次のビットはその右のピクセルを制御し、以下同様に各ビットは順次にピクセルに対応します。

新しいロゴを作成するには、まず、正しいデータを収容した Forth 配列を作成し、次にこの配列を oem-logo にコピーします。次にこの配列を $setenv で oem-logo にインストールします。次の例では、oem-logo の上側の半分に昇順パターンを書き込んでいます。

ok create logoarray d# 512 allot
ok logoarray d# 256 0 do i over i + c! loop drop
ok logoarray d# 256 " oem-logo" $setenv
ok setenv oem-logo? true
ok banner 

初期設定のサンの電源投入時バナーを復元するには、oem-logo? および oem-banner? 変数を false に設定します。

ok setenv oem-logo? false
ok setenv oem-banner? false
ok

oem-logo 配列は非常に大きいので、printenv は最初のほぼ 8 バイト (16 進) しか表示しません。配列全体を表示するには、oem-logo dump コマンドを使用します。 oem-logo 配列は、データの復元が難しいことがあるので、set-defaultsによって消去されません。しかし、set-defaults を実行すると、oem-logo? が false に設定され、したがってカスタマイズしたロゴはそれ以降表示されなくなります。

一部のシステムは oem-logo 機能をサポートしません。

入出力の制御

コンソールは、OpenBoot とユーザーとの間の第一の対話手段として使用されます。コンソールは、ユーザーから与えられる情報を受け取るために使用される入力デバイスと、ユーザーに情報を送るために使用される出力デバイスからなっています。一般的に、コンソールはテキスト・グラフィックス両用ディスプレイデバイスとキーボードの組み合わせか、シリアルポートに接続された ASCII 端末です。

システム入出力の制御関係の構成用として次に示すシステム変数があります。

• input-device

• output-device

• screen-#columns

• screen-#rows

これらの変数を使用してコンソール用の電源投入時デフォルトを割り当てます。これらの値は次の電源再投入またはシステムリセットまで有効になりません。

入出力デバイスオプションの選択

input-device および output-device 変数は、電源投入リセット後のファームウェア入出力デバイスの選択を制御します。input-device のデフォルト値は keyboard であり、output-device のデフォルト値は screen です。input-device、output-device の値はデバイス指定子でなければなりません。多くの場合、別名 keyboard、screen がこれらの変数の値として使用されます。

システムをリセットすると、指定したデバイスが初めのフォームウェアのコンソールの入力または出力デバイスになります。(入力または出力デバイスを一時的に変更する場合は、第 4 章「Forth ツールの使用方法」で説明する input または output コマンドを使用します。)

設定デフォルト入出力デバイス ttya を電源投入時初期コンソール入力デバイスとして設定するには、次のように入力します。

ok setenv input-device ttya
ok

input-device として keyboard を選択したが、このデバイスが接続されていない場合は、次の電源再投入またはシステムリセット後は、入力は予備のデバイス (通常 ttya) から受け入れられます。output-device として screen を選択したが、フレームバッファーが存在しない場合は、次の電源再投入またはシステムリセット後は、出力は予備のデバイスに送られます。

デフォルト出力デバイスとして SBus フレームバッファーを指定するには (特にシステムに複数のフレームバッファーが存在する場合)、次のように入力します。

ok setenv output-device /sbus/SUNW,leo 
ok 

シリアルポート特性の設定

設定シリアルポート特性シリアルポートの代表的な通信特性の範囲は次のとおりです。

• baud = 110、300、1200、2400、4800、9600、19200、または 38400 ビット/秒

• #bits = 5、6、7、または 8 (データビット)

• parity = n (なし)、e (偶数)、または o (奇数)、パリティービット

• #stop = 1 (1)、. (1.5)、または 2 (2) ストップビット

システムによっては、rts/cts および xon/xoff ハンドシェークは実装されていません。選択したプロトコルが実装されていないときは、ハンドシェーク変数は受け入れられますが、無視されます。メッセージは何も表示されません。

起動オプションの選択

次にシステム変数を使用して、電源再投入またはシステムリセット後にシステムを自動的に起動させるかどうかを設定できます。

• auto-boot?

auto-boot? が true で OpenBoot が診断モードではない場合は、システムは電源再投入またはシステムのリセット後 (boot-device と boot-file の値を使用して) 自動的に起動します。

手動起動時にも、これらの変数を使用して起動デバイスと起動するプログラムを選択することができます。たとえば、Ethernet からの自動起動を指定するには、次のように入力します。

ok setenv boot-device net 
ok 

boot-file と boot-device に対する変更は、次に起動 (boot) が実行されたときに有効になります。

電源投入時自己診断テストの制御 (POST)

電源投入時自己診断テスト用として次に示す変数があります。

• diag-switch?

• diag-device

• diag-file

• diag-level

diag-switch? を true に設定すると、diagnostic-mode? が true を返します。diagnostic-mode? が true を返すと、システムは次のように動作します。

• 以降の電源投入やシステムリセットプロセスでは、完全な 自己診断テストを実行します。

• 追加ステータスメッセージ (詳細は実装によって異なります) を表示することがあります。

• 異なる起動用システム変数を使用します。(起動処理に対する影響についての詳細は、第 2 章「システムの起動とテスト」を参照してください。)

大部分のシステムでは、diag-switch? 変数の工場出荷時のデフォルトは false です。diag-switch? を true に設定するには、次のように入力します。

ok setenv diag-switch? true 
ok

一部のシステムは diagnostic-mode? が true を返すハードウェアの診断スイッチを備えています。そのハードウェアスイッチが設定されているか、または diag-switch? が true に設定されている場合は、システムは電源投入時にフルテストを実行します。

一部の実装では、電源投入時に実装によって決まるキー入力処理を使用して diag-switch? を true に強制設定できる場合があります。詳細は、システムのマニュアルまたは本書の付録 C 「障害追跡ガイド」を参照してください。

diag-switch? を false に設定するには、次のように入力します。

ok setenv diag-switch? false 
ok

診断モードではない場合は、(テストでエラーが発生しなければ) システムは診断テスト実行中は報告せず、診断の一部を実行します。

nvramrc の使用方法

nvramrc システム変数はスクリプトと呼ばれる内容を持ち、起動時に実行されるユーザー定義コマンドを格納します。

一般的に、nvramrc は起動時のシステム変数を保存したり、デバイスドライバコードをパッチしたり、インストール先固有のデバイス構成とデバイスの別名を定義するためにデバイスドライバが使用します。また、バグパッチまたはユーザーインストールの拡張用にも使用できます。コマンドは、ユーザーがコンソールから入力するように ASCII で格納されます。

use-nvramrc? システム変数が true の場合は、そのスクリプトが OpenBoot の起動処理で次のように評価されます。

• 電源投入時自己診断テスト (POST)を実行します。

• システムの初期化を実行します。

• (use-nvramrc? が true の場合) スクリプトを評価します。

• probe-all を実行します (FCode を評価します)。

• install-console を実行します。

• banner を実行します。

• 二次診断を実行します。

• (auto-boot? が true の場合) デフォルト起動を実行します。

場合によっては、probe-all install-console banner の処理を変更することが必要な場合があります。たとえば、差し込み式ディスプレイデバイスのプローブが終わってからコンソールデバイスの選択が終わるまでに、差し込み式デバイスの特性を変更するコマンドを実行する必要があることがあります。そのようなコマンドは、probe-all と install-console の間で実行する必要があります。出力をコンソールに表示するコマンドを install-console または banner の後に入れる必要があります。

これは、banner か suppress-banner を内容とするカスタムスクリプトを作成することにより実現できます。それは、そのスクリプトから banner か suppress-banner が実行されれば、probe-all、install-console および banner 処理が実行されないためです。つまり、そのスクリプト内部で probe-all、install-console、banner を場合により他のコマンドと混用する形で使用することができ、スクリプト終了後にそれらのコマンドを再び実行させないようにできます。

次の例外を除く、ほとんどすべてのユーザーインタフェースコマンドがスクリプトで使用できます。

• boot

• go

• nvedit

• password

• reset-all

• setenv security-mode

スクリプトの内容の編集

スクリプトエディタである nvedit では、表 3-5 に示すコマンドを使用して、スクリプトの内容を作成、変更することができます。

表 3-6 にスクリプトエディタで使用できる編集コマンドを示します。

スクリプトファイルの起動

次の手順で、スクリプトコマンドファイルを作成し起動してください。

1. ok プロンプトで、nvedit と入力します。

エディタのコマンドを使用してスクリプトの内容を編集します。

1. Control-C を入力してエディタを終了し、再び ok プロンプトを表示させます。

変更を保存するために nvstore をまだ入力していない場合、nvrun と入力して一時編集バッファーの内容を実行できます。

1. nvstore と入力して変更結果を保存します。

2. 次のように入力して、スクリプトを有効にします。

   setenv use-nvramrc? true

3. reset-all と入力してシステムをリセットしてからスクリプトの内容を実行するか、次のように入力してスクリプトの内容を直接実行します。

   nvramrc evaluate

次の例で、nvramrc 内に単純なコロン定義を作成する方法を示します。

ok nvedit 
0: : hello ( -- ) 
1: ." Hello, world. " cr 
2: ; 
3: ^C 
ok nvstore 
ok setenv use-nvramrc? true 
ok reset-all 
...
ok hello 
Hello, world.
ok 

上の例で nvedit の行番号のプロンプト (0:、1:、2:、3:) に注意してください。これらのプロンプトはシステムによって異なることがあります。