posix_trace_attr_getclockres Subroutine
Purpose
Retrieves the clock resolution.
Library
Posix Trace Library (libposixtrace.a)
Syntax
#include <time.h>
#include <trace.h>
int posix_trace_attr_getclockres(attr, resolution)
const trace_attr_t *attr;
struct timespec *resolution;
Description
The posix_trace_attr_getclockres subroutine copies the clock resolution of the clock that is used to generate timestamps from the attr object into the resolution parameter. The attr object defines the clock resolution. The resolution parameter points to the structure.
If this subroutine is called with a non-initialized attributes object as parameter, the result is not specified.
Parameters
| Item | Description |
|---|---|
| attr | Specifies the trace attributes object. |
| resolution | Specifies where the clock-resolution attribute of the attr object is stored. |
Return Values
Upon successful completion, it returns a value of zero. Otherwise, it returns the corresponding error number.
If successful, the posix_trace_attr_getclockres subroutine stores the clock-resolution attribute value of the resolution parameter. Otherwise, the content of this object is not specified.
Errors
| Item | Description |
|---|---|
| EINVAL | One of the parameters is null. |
Files
The trace.h file in Files Reference