DEVSTAT

Section: Misc. Reference Manual Pages (9)
索引 jman

BSD mandoc
 

索引

名称

devstat devstat_add_entry devstat_end_transaction devstat_end_transaction_bio devstat_remove_entry devstat_start_transaction - デバイス統計の記録のためのカーネルインタフェース  

索引

書式

In sys/devicestat.h Ft void Fo devstat_add_entry Fa struct devstat *ds Fa const char *dev_name Fa int unit_number Fa u_int32_t block_size Fa devstat_support_flags flags Fa devstat_type_flags device_type Fa devstat_priority priority Fc Ft void Fn devstat_remove_entry struct devstat *ds Ft void Fn devstat_start_transaction struct devstat *ds Ft void Fo devstat_end_transaction Fa struct devstat *ds Fa u_int32_t bytes Fa devstat_tag_type tag_type Fa devstat_trans_flags flags Fc Ft void Fo devstat_end_transaction_bio Fa struct devstat *ds Fa struct bio *bp Fc  

索引

解説

devstat サブシステムは、その名称が暗示する様に、 デバイス統計を記録するためのインタフェースです。 この目的は、適度に詳細な統計情報を記録しつつ、 記録に使用する CPU 時間を最小とするというものです。 従って、 のコードのカーネル内の部分では、実際の統計的な計算は行なわれていません。 代わりに、これはユーザプログラムが取り扱うように残されています。

Fn devstat_add_entry は サブシステムにデバイスを登録します。 呼び出し側はこの関数の呼び出しの前に、既に割当てられ 0 でクリア された devstat 構造体を持っていることを期待されています。 Fn devstat_add_entry は幾つかの引数を取ります。

ds
クライアントによって割当てられ 0 でクリアされた、 devstat 構造体です。
dev_name
デバイスの名前です。 例えば da, cd, sa です。
unit_number
デバイスユニット番号です。
block_size
サポートされている場合には、デバイスのブロックサイズです。 デバイスがブロックサイズをサポートしていない場合、または リストにそのデバイスが追加される時点ではブロックサイズが判っていない場合には、 0 に設定されるべきです。
flags
デバイスによって操作がサポートされているかサポートされていないかを示す フラグです。 詳細は以下を参照してください。
device_type
デバイスの型です。 これは 3 つの部分、基本的なデバイスの型 (例えば、直接アクセス、CDROM、 順次アクセス)、インタフェースの型 (IDE, SCSI またはその他) および 通過するデバイスを示すためのパススルーフラグに、分割されます。 完全な型のリストは以下を参照してください。
priority
デバイスの優先度です。 優先度はデバイスの devstat リストの中でどのようにデバイスを並び替えるかを決定するために使用されます。 デバイスは最初に優先度 (高い方から低い方) によって、 それからアタッチされた順番によって並び替えられます。 利用可能な優先度の完全なリストは以下を参照してください。

Fn devstat_remove_entry は サブシステムからデバイスを削除します。 これは引数として当のデバイスの devstat 構造体を取ります。 世代番号は増やされデバイスの数は減らされます。

Fn devstat_start_transaction は サブシステムに処理の開始を登録します。 個々の処理の開始でビジーカウントが増やされます。 デバイスがアイドルからビジーに移ったときには、システム uptime が devstat 構造体の start_time フィールドに記録されます。

Fn devstat_end_transaction は サブシステムに処理の終了を登録します。 これは 4 つの引数を取ります。

ds
当のデバイスのための devstat 構造体です。
bytes
この処理で転送されたバイト数です。
tag_type
処理のタグの型です。 タグの型は以下を参照してください。
flags
その処理が読込みだったのか、書込みだったのか、 または転送されたデータがなかったのかを示す処理フラグです。

Fn devstat_end_transaction_bio は、biodone() の準備が整っている struct bio からすべての情報を引き出すための、 Fn devstat_end_transaction のためのラッパです。

devstat 構造体は以下のフィールドで構成されています。

dev_links
個々の devstat は登録されたときにリンクされたリストに置かれます。 dev_links フィールドには devstat 構造体のリストの中の次のエントリへのポインタが入ります。
device_number
デバイス番号は、個々のデバイスのための一意な識別子です。 デバイス番号は、個々の新しいデバイスが登録されるごとに増やされます。 現在はデバイス番号は単なる 32 ビット整数ですが、40 億個を超える デバイス到着イベントを持つシステムがあれば、拡張するかもしれません。
device_name
デバイス名称はドライバ登録によって与えられる文字列であり、 自分自身を識別するために使用できます。 (例えば ``da'' ``cd'' ``sa'' など)。
unit_number
ユニット番号は当の周辺装置のドライバ特有の実体を識別します。
bytes_written
これはそのデバイスに既に書込まれたバイト数です。 この数は現在は符号なし 64 ビット整数です。 32 ビットの整数を使った場合にはシステムによってはすぐにカウンタが 一回りしてしまうという問題を、これにより回避できると期待しています。
bytes_read
これはそのデバイスから既に読込まれたバイト数です。
bytes_freed
これはそのデバイス上の既に解放/消去されたバイト数です。
num_reads
これはそのデバイスからの読込み回数です。
num_writes
これはそのデバイスへの書込み回数です。
num_frees
これはそのデバイス上の解放/消去操作の回数です。
num_other
これはそのデバイスへの読込みでも書込みでもない処理の回数です。 例えば、 SCSI ドライバはしばしばテストユニットレディコマンドを SCSI デバイスに送ります。 そのテストユニットレディコマンドはデータを全く読込みまたは書込みません。 これは単にその状態を返させるだけにすぎません。
busy_count
これはそのデバイスのための現在未解決の処理の数です。 これは 0 を決して下回るべきではなく、アイドルのデバイスでは 0 になるべきです。 これらの状態のいずれかが真でない場合には、クライアントのコードの Fn devstat_start_transaction と Fn devstat_end_transaction の呼び出し方に問題があることを示しています。 個々の処理にはただ 1 つの処理開始イベントがあるべきであり、 各処理に対して 1 つの処理終了イベントがあるべきです。
block_size
そのデバイスがブロックサイズを持っている場合には、 これはそのデバイスのブロックサイズです。
tag_types
これはデバイスに送られた様々なタグの型の数を記録するための カウンタの配列です。 タグの型のリストは以下を参照してください。
dev_creation_time
これはそのデバイスが登録されたときの Fn getmicrotime によって報告される時間です
busy_time
これは、デバイスのビジーカウントが 0 より大きかった時間の量です。 これはビジーカウントが 0 に戻ったときにのみ更新されます。
start_time
これはそのデバイスのビジーカウントが 0 から 1 に移ったときの Fn getmicrouptime によって報告される時間です
last_comp_time
これは処理が完全に終わったときの Fn getmicrouptime によって報告される時間です。 これはデバイスビジー時間を計算するために start_time と一緒に使用されます。
flags
これらのフラグは個々のデバイスによって、どの統計測定がサポート されているのかを示します。 これらのフラグは本来は、統計を解読するユーザ側のプログラムの補助として 働くことを意図されています。
device_type
これはデバイスの型です。 これは 3 つの部分から構成されています。 デバイスの型 (例えば、直接アクセス、CDROM、順次アクセス、など)、 インタフェース (IDE, SCSI またはその他) および当のデバイスが パススルードライバであるかどうか、です。 デバイスの型の完全なリストは以下を参照してください。
priority
これは優先度です。 これはデバイスを リストの何処に挿入するのかを決定するために使用される最初のパラメータです。 2 番目のパラメータはアタッチの順番です。 利用可能な優先度のリストは以下を参照してください。

個々のデバイスはデバイスの型が与えられます。 パススルーデバイスは インタフェースを供給するためのデバイスと同じ基礎的なデバイスの型と インタフェースを持ちますが、パススルーフラグも設定されています。 基本のデバイスの型は SCSI のデバイス型番号と一致しています。 そのため SCSI 周辺装置では、問合せから返されたデバイスの型は、通常、 SCSI インタフェースの型ともし適切であればパススルーフラグで OR されます。 デバイスの型のフラグは以下のとおりです。 

typedef enum {
        DEVSTAT_TYPE_DIRECT     = 0x000,
        DEVSTAT_TYPE_SEQUENTIAL = 0x001,
        DEVSTAT_TYPE_PRINTER    = 0x002,
        DEVSTAT_TYPE_PROCESSOR  = 0x003,
        DEVSTAT_TYPE_WORM       = 0x004,
        DEVSTAT_TYPE_CDROM      = 0x005,
        DEVSTAT_TYPE_SCANNER    = 0x006,
        DEVSTAT_TYPE_OPTICAL    = 0x007,
        DEVSTAT_TYPE_CHANGER    = 0x008,
        DEVSTAT_TYPE_COMM       = 0x009,
        DEVSTAT_TYPE_ASC0       = 0x00a,
        DEVSTAT_TYPE_ASC1       = 0x00b,
        DEVSTAT_TYPE_STORARRAY  = 0x00c,
        DEVSTAT_TYPE_ENCLOSURE  = 0x00d,
        DEVSTAT_TYPE_FLOPPY     = 0x00e,
        DEVSTAT_TYPE_MASK       = 0x00f,
        DEVSTAT_TYPE_IF_SCSI    = 0x010,
        DEVSTAT_TYPE_IF_IDE     = 0x020,
        DEVSTAT_TYPE_IF_OTHER   = 0x030,
        DEVSTAT_TYPE_IF_MASK    = 0x0f0,
        DEVSTAT_TYPE_PASS       = 0x100
} devstat_type_flags;

デバイスはそれらに関連付けられた優先度を持っていて、 リストのおおよそ何処に置かれるのかを制御します。 優先度は以下のとおりです。 

typedef enum {
        DEVSTAT_PRIORITY_MIN    = 0x000,
        DEVSTAT_PRIORITY_OTHER  = 0x020,
        DEVSTAT_PRIORITY_PASS   = 0x030,
        DEVSTAT_PRIORITY_FD     = 0x040,
        DEVSTAT_PRIORITY_WFD    = 0x050,
        DEVSTAT_PRIORITY_TAPE   = 0x060,
        DEVSTAT_PRIORITY_CD     = 0x090,
        DEVSTAT_PRIORITY_DISK   = 0x110,
        DEVSTAT_PRIORITY_ARRAY  = 0x120,
        DEVSTAT_PRIORITY_MAX    = 0xfff
} devstat_priority;

個々のデバイスは何の操作がサポートされているかサポートされていないのかを示す、 それに関連付けられたフラグを持っています。 devstat_support_flags の値は以下のとおりです。

DEVSTAT_ALL_SUPPORTED
デバイスによって全ての統計の型がサポートされています。
DEVSTAT_NO_BLOCKSIZE
このデバイスはブロックサイズを持っていません。
DEVSTAT_NO_ORDERED_TAGS
このデバイスは順序タグ (ordered tag) をサポートしていません。
DEVSTAT_BS_UNAVAILABLE
このデバイスはブロックサイズをサポートしていますが、現在は利用できません。 このフラグはリムーバブルメディアのドライバでよく使用されます。

デバイスへの処理は 3 つのカテゴリのうちのいずれかに分類されます。 これは Fn devstat_end_transaction へ渡される flags に表現されています。 処理の型は以下のとおりです。 

typedef enum {
        DEVSTAT_NO_DATA = 0x00,
        DEVSTAT_READ    = 0x01,
        DEVSTAT_WRITE   = 0x02,
        DEVSTAT_FREE    = 0x03
} devstat_trans_flags;

Fn devstat_end_transaction の tag_type 引数には、次の 4 つの値を指定可能です:

DEVSTAT_TAG_SIMPLE
その処理は単純なタグを持っていました。
DEVSTAT_TAG_HEAD
この処理はキュータグの先頭を持っていました。
DEVSTAT_TAG_ORDERED
その処理は順序タグを持っていました。
DEVSTAT_TAG_NONE
そのデバイスはタグをサポートしません。

タグの型の値は SCSI のタグの定義の下位 4 ビットと一致しています。 例えば CAM では、 CCB の tag_action が 0xf と OR することにより、 Fn devstat_end_transaction に渡すタグの型を判定します。

In sys/devicestat.h で DEVSTAT_VERSION マクロが定義されています。 これは サブシステムの現在のバージョンで、 統計にアクセスするユーザ側プログラムの再コンパイルが要求される変更のたびに、 増やされるべきです。 ユーザ側プログラムは、カーネルの 構造体と同期しているかどうかを決定するために、 kern.devstat.version sysctl 変数を通してこのバージョンを使用します。  

索引

関連項目

systat(1), devstat(3), iostat(8), rpc.rstatd8, vmstat(8)  

索引

歴史

統計システムは Fx 3.0 で登場しました。  

索引

作者

An Kenneth Merry Aq ken@FreeBSD.org  

索引

バグ

リスト操作コード周りで Fn spl 保護が必要かもしれません。 これは、例えば誰かが kern.devstat.all sysctl 変数を取り出している間に、デバイスのリストが変更されないことを 保証するためです。

現在の の構造では正確に処理毎の時間を測定することが不可能です。 唯一の上手くいきそうな処理毎の正確な時間測定の方法は、 処理毎にタイムスタンプを記録することです。 システムのパフォーマンスおよび各個の処理のためにタイムスタンプを 保存するための空間コストに負の影響を与えるため、 この測定は恐らくは殆んどの人々には価値のないことです。

 

索引

Index

名称
書式
解説
関連項目
歴史
作者
バグ

jman


Time: 07:07:55 GMT, January 12, 2009