opensolaris man page for pthread_condattr_getclock

pthread_condattr_getclock(3C)				   Standard C Library Functions 			     pthread_condattr_getclock(3C)

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_con-
       dattr_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 TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-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)

SunOS 5.11							    30 Jan 2004 				     pthread_condattr_getclock(3C)