PERFMON

Section: Devices and Network Interfaces (4)
Updated: i386
索引 jman

BSD mandoc
FreeBSD 2.2

索引

名称

perfmon - CPU の性能モニタリングをするインタフェース

索引

書式

cpu I586_CPU cpu I686_CPU options PERFMON

索引

解説

perfmon ドライバにより Intel の Pentium と Pentium Pro の CPU 内部の性能モニタリング機能にアクセスできます。これらのプロセッサには多彩なイベントについて発生回数または (CPU サイクルでの) 持続時間のどちらかを測定するように設定できる 2 個の内部カウンタと、同じくクロックサイクルを数える 1 個のサイクルカウンタが実装されています。ドライバではこれらの機能に対してデバイス形式によるインタフェースを提供します。

性能モニタリングをするカウンタへの全てのアクセスはデバイス型特殊ファイルの ``/dev/perfmon '' を媒介として処理されます。このデバイスが提供する ioctl(2) リクエストは多くあり Aq Pa machine/perfmon.h の中で定義され、このファイルの中には Pentium と Pentium Pro プロセッサの両方の色々なカウンタの定義もあります。

注意事項: 利用可能なイベントの集合はプロセッサ毎に異なります。使用されるイベントコードが測定される CPU の型式に対して適正であることを確認することはプログラマの責任です。

以下の ioctl(2) リクエストが定義されています:

PMIOSETUP

(struct pmc ) 構造体に定義されているパラメータとフラグでカウンタを設定します。以下のフィールドが struct pmc に定義されています:

int pmc_num: 指定するカウンタ番号です。 NPMC (現在は 2) より小さくなければなりません。
u_char pmc_event: モニタすべき特定のイベントコードで、 Aq Pa machine/perfmon.h に定義されています。
u_char pmc_unit: イベントの型に対応する装置のマスクの値です ( Intel の文書を参照)。
u_char pmc_flags: カウンタの働きを変更するフラグ (下記参照) です。
u_char pmc_mask: カウンタのマスクの値です。つまり、本来、この値は指定された数のクロック以上 (又は以下) の間継続するイベントにカウントを制限する為に使用されるしきい値です。

次のような pmc_flags の値が定義されています:

PMCF_USR: イベントをユーザモードでカウントします。
PMCF_OS: イベントをカーネルモードでカウントします。
PMCF_E: イベントを持続時間ではなくその数でカウントします。
PMCF_INV: カウンタのマスクの比較の意味を逆転します。

PMIOGET

(struct pmc ) 指定されたカウンタの現在の設定を返します。

PMIOSTART

PMIOSTOP

(int ) 指定したカウンタを起動 (停止) します。ハードウェアの欠陥により、番号順に起動と停止をしなければなりません。 (即ち、カウンタ 0 は必ずまずカウンタ 1 を停止してから停止しなければなりません)。ドライバではこの制約を 強制していません (と言うのも将来の CPU ではこの制約はなくなるかも知れません)。

PMIORESET