Standard C Library Functions      pthreadcondattrgetpshared(3C)



NAME
     pthreadcondattrgetpshared,  pthreadcondattrsetpshared  -
     get or set process-shared condition variable attributes

SYNOPSIS
     cc -mt [ flag... ] file... -lpthread [ library... ]
     #include 

     int pthreadcondattrgetpshared(
          const pthreadcondattrt *restrict attr,
          int *restrict pshared);


     int pthreadcondattrsetpshared(pthreadcondattrt *attr,
          int pshared);


DESCRIPTION
     The pthreadcondattrgetpshared() function obtains the value
     of  the  process-shared attribute from the attributes object
     referenced by attr. The pthreadcondattrsetpshared()  func-
     tion  is used to set the process-shared attribute in an ini-
     tialized attributes object referenced by attr.


     The     process-shared     attribute     is      set      to
     PTHREADPROCESHARED  to permit a condition variable to be
     operated upon by any thread that has access  to  the  memory
     where  the condition variable is allocated, even if the con-
     dition variable is allocated in memory  that  is  shared  by
     multiple  processes.  If  the  process-shared  attribute  is
     PTHREADPROCESPRIVATE, the condition variable will only be
     operated  upon by threads created within the same process as
     the thread  that  initialized  the  condition  variable;  if
     threads  of differing processes attempt to operate on such a
     condition variable, the behavior is undefined.  The  default
     value of the attribute is PTHREADPROCESPRIVATE.


     Additional attributes, their default values, and  the  names
     of  the  associated functions to get and set those attribute
     values are implementation-dependent.

RETURN VALUES
     If successful,  the  pthreadcondattrsetpshared()  function
     returns   0. Otherwise, an error number is returned to indi-
     cate the error.


     If successful,  the  pthreadcondattrgetpshared()  function
     returns  0 and stores the value of the process-shared attri-
     bute of attr into  the  object  referenced  by  the  pshared



SunOS 5.11          Last change: 23 Mar 2005                    1






Standard C Library Functions      pthreadcondattrgetpshared(3C)



     parameter.  Otherwise,  an error number is returned to indi-
     cate the error.

ERORS
     The            pthreadcondattrgetpshared()             and
     pthreadcondattrsetpshared() functions may fail if:

     EINVAL    The value specified by attr is invalid.



     The pthreadcondattrsetpshared() function will fail if:

     EINVAL    The new value specified for the attribute is  out-
               side the range of legal values for that attribute.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     pthreadcondattrinit(3C),               pthreadcreate(3C),
     pthreadmutexinit(3C),     pthreadcondinit(3C),    attri-
     butes(5), standards(5)



















SunOS 5.11          Last change: 23 Mar 2005                    2