posix_trace_clear 서브루틴
용도
추적 스트림 및 추적 로그를 지웁니다.
라이브러리
Posix 추적 라이브러리 (libposixtrace.a' )
구문
#include <sys/types.h>
#include <trace.h>
int posix_trace_clear(trid)
trace_id_t trid;설명
' posix_trace_clear ' 서브루틴은 trid 매개변수로 식별된 추적 스트림을 다시 초기화합니다. ' posix_trace_create ' 서브루틴과 동일한 결과를 반환합니다. ' posix_trace_clear 서브루틴은 ' posix_trace_create 서브루틴의 할당된 리소스를 재사용하지만 이벤트 이름을 추적하는 데 사용되는 추적 이벤트 유형 식별자의 매핑을 변경하지 않으며 추적 스트림 상태도 변경하지 않습니다.
' posix_trace_clear ' 서브루틴 호출 이전에 기록된 추적 스트림의 모든 추적 이벤트가 손실됩니다. ' posix_stream_full_status '의 상태는 다음과 같이 설정됩니다POSIX_TRACE_NOT_FULLstatus. ' posix_trace_clear 호출 중에 발생한 모든 추적 이벤트가 기록된다는 보장은 없습니다.
추적 스트림이 로그와 함께 생성된 경우, ' posix_trace_clear ' 서브루틴은 로그 없이 추적 스트림이 생성된 경우와 동일한 동작으로 추적 스트림을 다시 초기화합니다. Trid 매개변수로 식별된 추적 스트림과 관련된 추적 로그를 다시 초기화합니다. ' posix_trace_create_withlog 하위 루틴의 추적 로그에 할당된 리소스를 동일하게 사용하며 관련 추적 스트림 상태는 변경되지 않습니다. ' posix_trace_clear 하위 루틴 호출 후 추적 로그에 기록된 첫 번째 추적 이벤트는 ' posix_trace_clear ' 하위 루틴 호출 후 활성 추적 스트림에 기록된 첫 번째 추적 이벤트와 동일합니다. ' posix_log_full_status ' 상태는 다음과 같이 설정됩니다POSIX_TRACE_NOT_FULL로 설정하고 ' posix_log_overrun_status '은POSIX_TRACE_NO_OVERRUN. ' posix_trace_clear 호출 중에 발생한 모든 추적 이벤트가 추적 로그에 기록된다는 보장은 없습니다. 로그 전체 정책이POSIX_TRACE_APPEND를 호출하면 스트림과 추적 로그가 마치 ' posix_trace_withlog 서브루틴에서 반환되는 것처럼 다시 초기화됩니다.
매개변수
| 항목 | 설명 |
|---|---|
| trid | 활성 추적 스트림의 추적 스트림 ID를 지정합니다. |
리턴 값
성공적으로 완료되면 ' posix_trace_clear 서브루틴은 0 값을 반환합니다. 그렇지 않으면 해당 오류 번호를 리턴합니다.
오류
| 항목 | 설명 |
|---|---|
| EINVAL | Trid 매개변수의 값이 활성 추적 스트림에 해당하지 않습니다. |