manページ  — GPROF

gprof ユーティリティは、各ルーチンが消費した時間を計算します。 次に、この時間は呼び出しグラフの辺にそって伝播されます。 サイクルが見つかると、サイクルに対する呼び出しが、サイクルの時間を 共有するものとされます。 最初のリストには、関数からの呼び出しグラフ全体の合計時間によって ソートされた関数が表示されています。 各関数のエントリの下には、その関数の呼び出しグラフ での (直接の) 子 (すなわち呼び出された関数名) が表示され、それらの 関数の消費時間がどれくらい親 (つまり呼び出した側の関数) に伝播されているかが 示されています。 同様に、各関数のエントリの上側には、 関数での消費時間が呼び出し元の関数にどのように伝播されているかが 示されています。

サイクル全体とそのメンバのリストを示したエントリが、 サイクルの呼び出し回数や実行時間への各メンバの寄与を含めて表示されます。

次のリストでは、 prof(1) (NetBSD, FreeBSDにはありません) と同様なフラットプロファイル (flat profile) 表示されます。 ここには、関数の合計実行時間や呼び出し回数、 その関数本体のみの実行時間 (ミリ秒またはマイクロ秒)、 その関数本体及びそこから呼び出された関数の実行時間 (ミリ秒またはマイクロ秒)、 が表示されます。

最後に関数名の索引が表示されます。

以下のオプションが利用可能です。

-a
	静的に宣言された関数の表示を抑制します。 このオプションが指定されると、静的関数についてのすべての関連する情報 (実行時間、別の関数の呼び出し、他の関数からの呼び出しなど) が、 a.out ファイル中の静的関数の直前に読み込まれるされる関数に含まれることになります。
-b
	プロファイル中の各フィールドの説明文を抑制します。
-C count
	count 数以上の関数を含む (呼び出し関係の) サイクルを取り除くために、 切断すべきアーク (呼び出し関係) の最小集合を見つけます。 注意:サイクルを中断するために用いられるアルゴリズムは指数関数的な ものです。 そのため、このオプションを指定すると、 gprof を実行するのに非常に長い時間がかかります。
-e name
	ルーチン name とそのすべての子孫 (それらの関数が表示抑制されていない親をほかに 持っていなければ) のグラフプロファイルエントリの表示を抑制 します。 2 つ以上の -e を指定することができます。 各 -e には 1 つしか name を指定することができません。
-E name
	-e と同様、指定されたルーチン name のグラフプロファイル エントリ表示を抑制します。 さらに、プログラムのトータルの時間と計算時間の パーセンテージから name で使われている時間を取り除きます。 (たとえば、 -E mcount -E mcleanup がデフォルトです)
-f name
	指定されたルーチン name とその子孫のグラフプロファイルエントリ のみを表示します。 -f オプションは、複数指定することができます。 各オプション -f には、1 つしか name を指定することができません。
-F name
	-f と同様に、指定されたルーチン name とその子孫のグラフ プロファイルエントリのみを表示します。 プログラムのトータルの時間と計算時間の割合 には、表示されたルーチンの時間のみが使われます。 -F は複数指定することができます。 各オプション -F には、1 つしか name を指定することができません。 オプション -F は、オプション -E の効果を打ち消します。
-k fromname toname
	fromname から toname への関数呼び出し関係のアークを削除します。 このオプションによって、不必要だと思うサイクルを切断することができます。 オプション -k は、複数指定することができます。 各オプション -k には一対のルーチン名 ( fromname と toname) しか 指定することができません。
-K
	sysctl(3) および kldsym(2) のインタフェースを使用して、 現在実行中のカーネルからシンボル情報を収集します。 これは、 a.out 引数を無視させ、 kld(4) [英語] モジュール中のシンボルを使用できるようにします。
-l
	呼び出しグラフプロファイルの表示を抑制します。
-L
	フラットプロファイルの表示を抑制します。
-s
	指定されたすべてのプロファイルファイル中のプロファイル情報の合計 を表すサマリプロファイルファイル gmon.sum が生成されます。 このサマリプロファイルファイルはこのあとの gprof の実行に 対して与えられ (その際にも通常 -s が指定される)、一連の a.out 実行の結果のプロファイルデータの合計を 求めることができます。
-u
	C プログラムには見えない名前の関数の表示を抑制します。 ELF オブジェクト形式では、文字 ‘.amp;’ を含む名前を意味します。 a.out オブジェクト形式では、文字 ‘_’ で開始しない名前を意味します。 それらの関数に関連する情報は、すぐ低位側のアドレスにある (表示が 抑制されていない) 関数に含まれます。 これにより関数内にあるただのラベルが関数と認識されてしまうのを 防ぐ事ができます。
-z
	使用されていないルーチン (呼び出し回数と合計時間が 0 である) を表示します。 -c オプションとともに使うと、一度も呼ばれていないルーチンを発見する事ができます。

S. Graham, P. Kessler, M. McKusick, Software - Practice and Experience, pp. 671-685, An Execution Profiler for Modular Programs, 13, 1983.

S. Graham, P. Kessler, M. McKusick, 6, Proceedings of the SIGPLAN '82 Symposium on Compiler Construction, SIGPLAN Notices, pp. 120-126, gprof: A Call Graph Execution Profiler, 17, June 1982.

プロファイルされているプログラムは、 グラフプロファイル ファイルにプロファイル情報がセーブされるよう exit(3) を呼ぶか、正常に終了しなければいけません。