名称

pmc_name_of_capability, pmc_name_of_class, pmc_name_of_cputype, pmc_name_of_disposition, pmc_name_of_event, pmc_name_of_mode, pmc_name_of_state — pmc(3) と hwpmc(4) によって使用された数値定数のための人間に読み込み可能な名前

ライブラリ

Performance Counters Library (libpmc, -lpmc)

書式

#include < pmc.h>

const char *
pmc_name_of_capability( enum pmc_caps pc);

const char *
pmc_name_of_class( enum pmc_class pc);

const char *
pmc_name_of_cputype( enum pmc_cputype ct);

const char *
pmc_name_of_disposition( enum pmc_disp pd);

const char *
pmc_name_of_event( enum pmc_event pe);

const char *
pmc_name_of_mode( enum pmc_mode pm);

const char *
pmc_name_of_state( enum pmc_state ps);

解説

これらの便利関数は、 Performance Counters Library (libpmc, -lpmc) によって使用された数値定数をそれらの引数の人間に読み込み可能な表現への const char * ポインタに変換します。

関数 pmc_name_of_capability() は、引数 pc で与えられた PMC ケーパビリティフラグを人間に読み込み可能な文字列に変換します。 PMC ケーパビリティは、 pmc(3) に説明されています。

関数 pmc_name_of_class() は、引数 pc で指定された PMC クラス値を人間に読み込み可能な名前に変換します。 PMC クラスは、 pmc(3) に説明されています。

関数 pmc_name_of_cputype() は、引数 ct で指定された CPU タイプ値を人間に読み込み可能な名前に変換します。ライブラリで知られている CPU タイプは、 pmc(3) に説明されています。

関数 pmc_name_of_disposition() は、引数 pd で指定された PMC 行の傾向 (disposition) を人間に読み込み可能な名前に変換します。 PMC 行の傾向 (disposition) は、 hwpmc(4) に説明されています。

関数 pmc_name_of_event() は、引数 pe で指定された PMC イベント番号を文字列に変換します。 PMC イベント名は、 pmc(3) のセクション イベント指定子 に文書化されています。

関数 pmc_name_of_mode() は、引数 pm によって指定された PMC モードを人間に読み込み可能な文字列に変換します。 PMC モードは、 pmc(3) に説明されています。

関数 pmc_name_of_state() は、引数 ps の値を人間に読み込み可能な名前に変換します。

実装に関する注

返されたポインタは、PMC ライブラリのスタティックな記憶域の内部を指し、呼び出し側によって解放されるべきではありません。

戻り値

これらの関数は、成功して終了するとき NULL でないポインタを返します。エラーの場合には、NULL ポインタが返され、グローバル変数 errno は、エラーを示す値に設定されます。

エラー

これらの関数への呼び出しは、次のエラーで失敗します:

[ EINVAL]

関数引数が、不正な値を指定しました。

関連項目

pmc(3), pmc_cpuinfo(3), pmc_pmcinfo(3), hwpmc(4)