trcstop 子例程

在线编辑

用途

停止跟踪会话。

库

运行时服务库 (librts.a)

语法

# include <sys/trcmacros.h>
# 定义 TRCSTOP SERIAL 0x40000000
# 定义 TRCSTOP DISCARDBUFS 0x20000000
int trcstop( Channel)
int Channel;

描述

特尔克斯特普 子例程用于停止特定跟踪通道的跟踪会话。

参数

项 描述
通道 指定八个跟踪通道中的一个。 通道号 0 始终是指事件/性能跟踪。 通道号 1 到 7 指定通用跟踪通道。
序列 (TRCSTOP SERIAL) 如果使用 序列 标志对通道进行 OR 运算，那么 特尔克斯特普 子例程会将跟踪 I/O 操作从多个处理器缓冲区序列化到跟踪文件中。 对于所有跟踪方式， 序列 标志都适用。 此标志与 废弃 buff 标志是互斥的。
废弃 buff (TRCSTOP DISCARDBUFF0) 要设置此选项，用户需要将 废弃 buff 标志与通道选项进行 OR 运算。 当调用时， 特尔克斯特普 子例程将废弃任何已捕获的跟踪缓冲区暂挂 I/O 操作。 如果跟踪缓冲区已写至文件，那么将忽略 废弃 buff 标志。 此标记与串行标记互斥。

返回值

项 描述
重大安全事件数量 跟踪会话已成功停止。
-1 该跟踪会话未停止。