名称

pmc_start, pmc_stop — PMC を開始して、停止する

ライブラリ

Performance Counters Library (libpmc, -lpmc)

書式

#include < pmc.h>

int
pmc_start( pmc_id_t pmc);

int
pmc_stop( pmc_id_t pmc);

解説

これらの関数は、PMC を開始して停止するために使用されます。

関数 pmc_start() は、引数 pmc によって指定された PMC を開始します。指定された PMC にはプロセスの範囲があり、どのターゲットにもアタッチされていないなら、現在のプロセスにアタッチされます。

関数 pmc_stop() は、引数 pmc によって指定された PMC を停止します。

戻り値

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

エラー

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

[ EDOOFUS]

関数 pmc_start() は、ログファイルを必要とする PMC を指定しましたが、ログファイルが設定されていませんでした。

[ EINVAL]

指定された PMC が削除されている途中のプロセスにあります。

[ EINVAL]

関数 pmc_stop() が、決して開始されない PMC を指定しました。

[ ENXIO]

指定された PMC にはシステム範囲があり、関連 CPU が、無効にされたか、または不足しています。

関連項目

pmc(3), hwpmc(4)