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 Referencetrace.hファイル。