PROFIL

Section: System Calls (2)
索引 jman

BSD mandoc
 

索引

名称

profil - プロセスのプロファイルを制御する  

索引

ライブラリ

Lb libc  

索引

書式

In unistd.h Ft int Fn profil char *samples size_t size vm_offset_t offset int scale  

索引

解説

Fn profil システムコールは、現在のプロセスのカウンタプロファイルを有効化または 無効化します。 プロファイルが有効な場合、プロファイルクロックチックごとに、カーネルは Fa samples バッファ内の適切なカウントを更新します。 プロファイルクロックの周波数は、 プロファイル出力ファイル内のヘッダ内に記録されます。

バッファ Fa samples には Fa size バイトが含まれており、一連の 16 ビットの塊に分割されます。 各塊は、プロファイルが有効時にプロファイルクロックチックが発生したときに、 プログラムカウンタがプロセス内の特別なアドレス範囲内にあった回数を カウントします。 指定のプログラムカウンタアドレスについて、対応する塊の数が 次の関係によって与えられます。

[(pc - offset) / 2] * scale / 65536

Fa offset 引数は、カーネルがプログラムカウンタサンプルを 取る最も低いアドレスです。 Fa scale 引数の範囲は 1 から 65536 であり、 塊の広がりを変更するのに使用できます。 スケール 65536 は、各塊をアドレス範囲の 2 バイトに割り当てます。 スケール 32768 は 4 バイト、16384 は 8 バイト、後は同様です。 中間の値はおおよそ中間の範囲を与えます。 Fa scale 値が 0 の場合、プロファイルは無効になります。  

索引

戻り値

Rv -std profil  

索引

関連ファイル

/usr/lib/gcrt0.o
プロファイリング用の C ランタイムスタートアップファイル
gmon.out
プロファイル出力ファイルの従来の名前

 

索引

エラー

次のエラーが報告される可能性があります:

Bq Er EFAULT
バッファ Fa samples に無効なアドレスが入っています。

 

索引

関連項目

gprof(1)  

索引

歴史

Fn profil 関数は AT&T System v7 で登場しました。  

索引

バグ

このルーチンの名前は Fn profile にすべきです。

Fa samples 引数は本当はベクトル Fa unsigned short のベクトルである必要があります。

gmon.out ファイルの形式は記述されていません。


 

索引

Index

名称
ライブラリ
書式
解説
戻り値
関連ファイル
エラー
関連項目
歴史
バグ

jman



Time: 07:06:29 GMT, January 12, 2009