pm_get_program_pthread サブルーチン

オンライン編集

目的

ターゲット pthread のパフォーマンス・モニター設定を検索します。

ライブラリー

パフォーマンス・モニター API ライブラリー (libpmapi.a)

構文

#include <pmapi.h>  

int pm_set_program_pthread ( pid,  tid,  ptid,  *prog)
pid_t pid;
tid_t tid;
ptid_t ptid;
pm_prog_t *prog;

説明

pm_get_program_pthread サブルーチンは、ターゲット pthread のパフォーマンス・モニター設定を取得します。 pthread は、呼び出しプロセスの制御下で停止し、デバッグ対象プロセスの一部でなければなりません。 これには、イベント ID のリストにあるモード情報およびカウントされるイベントが含まれます。 ID は、 pm_inititialize サブルーチンによって返されるリストから選択する必要があります。

pthread が 1: 1 モードで実行されている場合は、 tid パラメーターのみを指定する必要があります。 pthread が m: n モードで実行されている場合は、 ptid パラメーターのみを指定する必要があります。 ptid パラメーターと tid パラメーターの両方が指定されている場合、それらは ptid パラメーターが指定された単一の pthread を参照し、指定された tid パラメーターを持つカーネル・スレッド上で現在実行されている必要があります。

カウント・モードには、ユーザー・モードとカーネル・モード、および現在のカウント状態が含まれます。

しきい値 ( pm_initialize サブルーチンによって示される) で使用できるイベントがリストに含まれている場合は、しきい値も戻されます。

パラメーター

項目 説明
pid ターゲット pthread のプロセス ID。 ターゲット・プロセスはデバッグ・プロセスの引数でなければなりません。
tid ターゲット pthread のスレッド ID。 このパラメーターを無視するには、0 に設定します。
ptid ターゲット pthread の Pthread ID。 このパラメーターを無視するには、0 に設定します。
プログラム (* prog) 設定されているパフォーマンス・モニターのイベントおよびモードを返します。 以下のタイプがサポートされています:
PMUSER (PM_USER)
ユーザー・モードで実行されているプロセスをカウントします
PM_カーネル
カーネル・モードで実行されているプロセスをカウントします
PMCOUNT (PM_COUNT)
カウントがオン

戻り値

項目 説明
0 エラーはありません。
Positive error code エラー・コードをデコードするには、 pm_error サブルーチン を参照してください。

エラー・コード

pm_error サブルーチンを参照してください。

ファイル

項目 説明
/usr/include/pmapi.h 標準マクロ、データ・タイプ、およびサブルーチンを定義します。