名称

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]

結果を保持するためのメモリ領域の割り付けに失敗しました。

関連項目

pmc(3), hwpmc(4)