posix_trace_attr_init 子例程
用途
初始化跟踪流属性对象。
库
Posix 跟踪库 (libposixtrace.a)
语法
#include <trace.h>
int posix_trace_attr_init(attr)
trace_attr_t * attr;描述
posix_trace_attr_init 子例程使用以下缺省值初始化跟踪属性对象 attr 对象:
| 属性字段 | 缺省值 |
|---|---|
stream_minsize |
8192 字节 |
stream_fullpolicy |
对于没有 LOG 的流，缺省值为 POSIX_TRACE_LOOP 对于具有 LOG 的流，缺省值为 POSIX_TRACE_FLUSH |
max_datasize |
16 字节 |
inheritance |
posix_trace_close_for_child |
log_maxsize |
1 MB |
log_fullpolicy |
posix_trace_loop |
由已初始化的跟踪属性对象生成的 version 和 clock-resolution 属性设置为以下值:
| 属性字段 | 值 |
|---|---|
version |
0.1 |
clock-resolution |
用于生成时间戳记的时钟的时钟分辨率。 |
由 posix_trace_create 或 posix_trace_create_withlog 子例程创建流时，将设置 creation_time 属性。
当调用 posix_trace_attr_init 子例程以指定已初始化的 attr 属性对象时，此对象将使用缺省值进行初始化，与第一个初始化中的值相同。 如果未保存此属性，那么无法再访问已初始化的 attr 属性对象。
当由 posix_trace_create 子例程使用时，生成的属性对象定义所创建的跟踪流的属性。 可以在对 posix_trace_create 子例程的多次调用中使用单个属性对象。 使用属性对象创建一个或多个跟踪流之后，影响该属性对象的任何子例程 (包括破坏) 都不会影响先前创建的任何跟踪流。 已初始化的属性对象还用于在调用 posix_trace_get_attr 子例程时接收现有跟踪流或跟踪日志的属性。
posix_trace_attr_init 子例程再次初始化已破坏的 attr 属性对象。
参数
| 项 | 描述 |
|---|---|
| attr | 指定要初始化的跟踪属性对象。 |
返回值
成功完成后，将返回值 0。 否则，将返回相应的错误号。
错误
当 posix_trace_attr_init 子例程失败时，将返回以下错误代码:
| 项 | 描述 |
|---|---|
EINVAL |
attr 参数的值为空。 |
ENOMEM |
内存不足，无法初始化跟踪属性对象。 |
文件
Files Reference 中的 trace.h 文件