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 参数为空或其他参数无效。 |