The Open Group Base Specifications Issue 7
IEEE Std 1003.1, 2013 Edition
Copyright © 2001-2013 The IEEE and The Open Group

#### NAME

> posix_trace_attr_getclockres, posix_trace_attr_getcreatetime, posix_trace_attr_getgenversion, posix_trace_attr_getname, posix_trace_attr_setname - retrieve and set information about a trace stream (TRACING)

#### SYNOPSIS

> ``[OB TRC] #include <time.h>
> #include <trace.h>
> int posix_trace_attr_getclockres(const trace_attr_t *`attr`,
> struct timespec *`resolution`);
> int posix_trace_attr_getcreatetime(const trace_attr_t *`attr`,
> struct timespec *`createtime`);
> #include <trace.h>
> int posix_trace_attr_getgenversion(const trace_attr_t *`attr`,
> char *`genversion`);
> int posix_trace_attr_getname(const trace_attr_t *`attr`,
> char *`tracename`);
> int posix_trace_attr_setname(trace_attr_t *`attr`,
> const char *`tracename`);``
> `
> `

#### DESCRIPTION

> The posix_trace_attr_getclockres() function shall copy the clock resolution of the clock used to generate timestamps from the clock-resolution attribute of the attributes object pointed to by the attr argument into the structure pointed to by the resolution argument.

> The posix_trace_attr_getcreatetime() function shall copy the trace stream creation time from the creation-time attribute of the attributes object pointed to by the attr argument into the structure pointed to by the createtime argument. The creation-time attribute shall represent the time of creation of the trace stream.

> The posix_trace_attr_getgenversion() function shall copy the string containing version information from the generation-version attribute of the attributes object pointed to by the attr argument into the string pointed to by the genversion argument. The genversion argument shall be the address of a character array which can store at least {TRACE_NAME_MAX} characters.

> The posix_trace_attr_getname() function shall copy the string containing the trace name from the trace-name attribute of the attributes object pointed to by the attr argument into the string pointed to by the tracename argument. The tracename argument shall be the address of a character array which can store at least {TRACE_NAME_MAX} characters.

> The posix_trace_attr_setname() function shall set the name in the trace-name attribute of the attributes object pointed to by the attr argument, using the trace name string supplied by the tracename argument. If the supplied string contains more than {TRACE_NAME_MAX} characters, the name copied into the trace-name attribute may be truncated to one less than the length of {TRACE_NAME_MAX} characters. The default value is a null string.

#### RETURN VALUE

> Upon successful completion, these functions shall return a value of zero. Otherwise, they shall return the corresponding error number.

> If successful, the posix_trace_attr_getclockres() function stores the clock-resolution attribute value in the object pointed to by resolution. Otherwise, the content of this object is unspecified.

> If successful, the posix_trace_attr_getcreatetime() function stores the trace stream creation time in the object pointed to by createtime. Otherwise, the content of this object is unspecified.

> If successful, the posix_trace_attr_getgenversion() function stores the trace version information in the string pointed to by genversion. Otherwise, the content of this string is unspecified.

> If successful, the posix_trace_attr_getname() function stores the trace name in the string pointed to by tracename. Otherwise, the content of this string is unspecified.

#### ERRORS

> The posix_trace_attr_getclockres(), posix_trace_attr_getcreatetime(), posix_trace_attr_getgenversion(), and posix_trace_attr_getname() functions may fail if:

> [EINVAL]
>   The value specified by one of the arguments is invalid.

The following sections are informative.

#### EXAMPLES

> None.

#### APPLICATION USAGE

> None.

#### RATIONALE

> None.

#### FUTURE DIRECTIONS

> The posix_trace_attr_getclockres(), posix_trace_attr_getcreatetime(), posix_trace_attr_getgenversion(), posix_trace_attr_getname(), and posix_trace_attr_setname() functions may be removed in a future version.

#### SEE ALSO

> posix_trace_attr_destroy, posix_trace_create, posix_trace_get_attr, uname

> XBD <time.h>, <trace.h>

#### CHANGE HISTORY

> First released in Issue 6. Derived from IEEE Std 1003.1q-2000.

#### Issue 7

> The posix_trace_attr_getclockres(), posix_trace_attr_getcreatetime(), posix_trace_attr_getgenversion(), posix_trace_attr_getname(), and posix_trace_attr_setname() functions are marked obsolescent.

End of informative text.

return to top of page

UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
Copyright © 2001-2013 The IEEE and The Open Group, All Rights Reserved
[ Main Index | XBD | XSH | XCU | XRAT ]