STLSTATS(8)

名称
stlstats - Stallion Technologies 製マルチポートシリアルボードの統計情報を表示する

書式
stlstats [-hVi] [-c control-device] [-b board-number] [-p port-number] [-d port-device]

解説
stlstats ユーティリティは Stallion Technologies 製のマルチポートシリアルボードに接続されている ポートに関する統計情報を表示するのに用いられます。

stlstats は通常フルスクリーンのメニュー操作型アプリケーションとして動作します。 このスクリーンへの正当な入力文字を示すヘルプ行が各スクリーンの 最下部に表示されます。

一般的に、数字キー ('0' から '9') は統計を表示するデバイスの番号を 指定します。 数字だけでは利用可能な全てのデバイスを指定するのに十分でない場合 (例えば、 16 ポートのパネルでは) 残りのデバイスをアクセスするのには アルファベットの最初の方の文字を用います。'a' から 'f' までの文字が、 デバイス 10 から 15 までをアクセスするのに 用いられます。

'q' キーは常に 1 レベル前のスクリーンに戻るのに用いられます。 前の画面に戻るのには、エスケープキーを用いることもできます。

最初のスクリーンは ボード 0 のパネル 0 にある全ポートの表示画面です。 このスクリーンに表示される値は各ポートの情報の概要です。 表示される統計情報は、ドライバと TTY の状態フラグ、 termio フラグ (cflag, iflag, oflag, lflag)、 RS-232 シグナル値 (TIOCM シグナル 定義による)、送受信した文字数の総計です。

システムにインストールされた各パネルおよびボードについての 要約情報をこのスクリーンで見ることができます。 各ボードは数字キー ('0' から '7') でアクセスでき、各ボード上の パネルは 'n' キーによって順次アクセスできます。

ポートごとのスクリーンは特定のポートについてのいくぶん 詳しい情報を表示します。 このスクリーンは、ボードスクリーンから 'p' キーを押すことによって 移行することができます。 最初に表示されるポートはポート 0 です。 他のポートを表示するには、数字キーと英字キー ('0' から '9' と 'a' から 'f') を使って下さい。 このスクリーンが表示するのは、ドライバと TTY の状態フラグ、 ハードウェア ID、 termio フラグ (cflag, iflag, oflag, lflag)、 送受信した文字数の総計、現在バッファにある文字、 発生したエラー (オーバラン、パリティ、フレーミング、ロスト) の回数、ソフトウェア的なフロー制御文字を送受信した字数、 ハードウェアによるフロー制御を実行した回数、 break を送受信した回数、 モデムの信号状態の変化、現在の RS-232 シグナル状態です。

オプションは以下の通りです。

-h  使用法の情報を出力します。

-V  バージョン情報を出力します。

-i  ボードタイプの情報のみを表示します。 この出力は、ボードについて少量の情報を得る必要があるスクリプトや プログラム (例えば、自動化されたダウンロードスクリプト) に とって役立ちます。 stlstats ユーティリティはフルスクリーンのインタラクティブモードに入りません。

-c control-device
    ポートの統計情報を集めるためのボード制御用デバイスを指定します。 デフォルトは /dev/staliomem0 です。

-b board-number
    最初に表示するボード番号を指定します。 デフォルトではボード 0 を表示するようになっています。

-p port-number
    最初に表示するポート番号を指定します。 このオプションが指定されている場合、 stlstats ユーティリティは (ボードの表示を省略して) 即座にポート表示スクリーンを表示します。

-d port-device
    最初に表示するポートのスペシャルデバイスファイル (/dev/ttyXXX) を指定します。 ボードスクリーン表示を省略し、ポート統計スクリーンを スタートアップ時に即座に表示します。

関連ファイル

/dev/staliomem0
    統計情報収集に用いられる、ドライバ制御用のデバイス

関連項目
stl(4), stli(4), stlload(8)

歴史
このプログラムのオリジナル版は Greg Ungerer <gerg@stallion.com> によって開発されました。