PMC_EVENT_NAMES_OF_CLASS(3) | FreeBSD Library Functions Manual | PMC_EVENT_NAMES_OF_CLASS(3) |
名称
pmc_event_names_of_class — PMC のクラスによってサポートされたイベント名のリストを返すライブラリ
Performance Counters Library (libpmc, -lpmc)書式
#include < pmc.h> int
pmc_event_names_of_class( enum pmc_class cl, const char ***eventnames, int *nevents);
解説
関数 pmc_event_names_of_class() は、引数 cl によって指定された PMC ハードウェアのクラスによってサポートされたハードウェアイベント名を検索します。指定された PMC ハードウェアのクラスによってサポートされたイベントへの const char * ポインタの配列を返します。引数 nevents によって指された位置は、返されたイベント名の数に設定されます。
返された配列は、 malloc(3) を使用して割り付けられます。
戻り値
The pmc_event_names_of_class() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.エラー
pmc_event_names_of_class() への呼び出しは、次のエラーで失敗します:- [ EINVAL]
- 引数 cl が、無効でした。
- [ ENOMEM]
- 結果を保持するためのメモリ領域の割り付けに失敗しました。
November 23, 2007 | FreeBSD |