posix_trace_stop サブルーチン
目的
トレースを停止します。
ライブラリー
Posix トレース・ライブラリ (libposixtrace.a)
構文
#include <trace.h>
int posix_trace_stop(trid)
trace_id_t trid;説明
posix_trace_stopサブルーチンは、tridパラメータで特定されるトレースストリームを停止する。
posix_trace_stopサブルーチンの呼び出しの効果はPOSIX_TRACE_STOPシステムトレースイベントとしてトレースストリームに記録され、トレースストリームのステータスはPOSIX_TRACE_SUSPENDED になる。 このサブルーチンが呼ばれたときにトレースストリームが中断されている場合、POSIX_TRACE_STOPシステムトレースイベントは記録されず、トレースストリームは中断されたままである。 トレースストリームが満杯の場合、POSIX_TRACE_STOPシステムトレースイベントは記録されず、トレースストリームの状態は変更されない。
パラメーター
| 項目 | 説明 |
|---|---|
| ハイド | トレース・ストリーム ID を指定します。 |
戻り値
正常終了すると、このサブルーチンはゼロの値を戻します。 それ以外の場合は、対応するエラー番号を返します。
エラー
以下のエラー番号が戻されると、サブルーチンは失敗します。
| 項目 | 説明 |
|---|---|
| EINVAL | tridパラメータの値は、アクティブなトレースストリームに対応していないため、トレースストリームは開始または停止されない。 |
ファイル
Files Reference のtrace.hファイル。