Content-type: text/html Man page of pthread_condattr_getclock

pthread_condattr_getclock

Section: Standard C Library Functions (3C)
Updated: 30 Jan 2004
Index Return to Main Contents
 

NAME

pthread_condattr_getclock, pthread_condattr_setclock - get and set the clock selection condition variable attribute  

SYNOPSIS

cc -mt [ flag... ] file... [ library... ]
#include <pthread.h>

int pthread_condattr_getclock(const pthread_condattr_t *restrict attr, clockid_t *restrict clock_id);

int pthread_condattr_setclock(pthread_condattr_t *attr, clockid_t clock_id);  

DESCRIPTION

The pthread_condattr_getclock() function obtains the value of the clock attribute from the attributes object referenced by attr. The pthread_condattr_setclock() function sets the clock attribute in an initialized attributes object referenced by attr. If pthread_condattr_setclock() is called with a clock_id argument that refers to a CPU-time clock, the call fails.

The clock attribute is the clock ID of the clock that is used to measure the timeout service of pthread_cond_timedwait(3C). The default value of the clock attribute refers to the system clock.  

RETURN VALUES

Upon successful completion, the pthread_condattr_getclock() function returns 0 and stores the value of the clock attribute of attr into the object referenced by the clock_id argument. Otherwise, an error number is returned to indicate the error.

Upon successful completion, the pthread_condattr_setclock() function returns 0. Otherwise, an error number is returned to indicate the error.  

ERRORS

These functions may fail if:

EINVAL The value specified by attr is invalid.

The pthread_condattr_setclock() function may fail if:

EINVAL The value specified by clock_id does not refer to a known clock, or is a CPU-time clock.

 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityStandard
MT-LevelMT-Safe

 

SEE ALSO

pthread_cond_init(3C), pthread_cond_timedwait(3C), pthread_condattr_destroy(3C), pthread_condattr_getpshared(3C), pthread_create(3C), pthread_mutex_init(3C), attributes(5), standards(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:22 GMT, October 02, 2010