Manual Pages for UNIX Operating System command usage for man pthread_condattr_setclock

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 

     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 refer-
     enced 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 attri-
     bute 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.







SunOS 5.11          Last change: 30 Jan 2004                    1






Standard C Library Functions        pthread_condattr_getclock(3C)



     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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


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          Last change: 30 Jan 2004                    2