posix_trace_attr_setmaxdatasize 子例程

用途

设置最大用户跟踪事件数据大小。

Posix 跟踪库 (libposixtrace.a)

语法

#include <sys/types.h>
#include <trace.h>

int posix_trace_attr_setmaxdatasize(attr, maxdatasize)
trace_attr_t *attr;
size_t maxdatasize;

描述

posix_trace_attr_setmaxdatasize 子例程使用 maxdatasize 参数指定的大小值,在 attr 对象的 max-data-size 属性中设置允许的最大大小 (以字节计)。 此最大大小是可以传递到 posix_trace_event 子例程的用户数据参数的最大允许大小。 系统会截断传递到 posix_trace_event 的数据,该数据的长度超过最大数据大小。

如果使用未初始化的属性对象作为参数来调用此子例程,那么不会指定结果。

参数

描述
属性 指定跟踪属性对象。
最大数据大小 指定将实现 max-data-size 属性的位置 (以字节计)。

返回值

成功完成后,此子例程将返回值 0。 否则,将返回相应的错误号。

错误

如果返回以下错误号,那么此子例程将失败:
描述
EINVAL attr 参数为空或其他参数无效。

文件

trace.h 文件和 Files Reference中的 types.h 文件。