Standard C Library Functions     pthreadmutexattrgetpshared(3C)



NAME
     pthreadmutexattrgetpshared, pthreadmutexattrsetpshared -
     get or set process-shared attribute

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

     int pthreadmutexattrgetpshared(
          const pthreadmutexattrt *restrict attr,
          int *restrict pshared);


     int pthreadmutexattrsetpshared(pthreadmutexattrt *attr,
          int pshared);


DESCRIPTION
     The  pthreadmutexattrgetpshared()  function  obtains   the
     value  of  the  process-shared attribute from the attributes
     object        referenced        by         attr.         The
     pthreadmutexattrsetpshared()  function  is used to set the
     process-shared attribute in an initialized attributes object
     referenced by attr.


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

RETURN VALUES
     Upon successful  completion,  pthreadmutexattrgetpshared()
     returns  0 and stores the value of the process-shared attri-
     bute of attr into  the  object  referenced  by  the  pshared
     parameter.  Otherwise,  an error number is returned to indi-
     cate the error.


     Upon successful  completion,  pthreadmutexattrsetpshared()
     returns   0. Otherwise, an error number is returned to indi-
     cate the error.

ERORS




SunOS 5.11          Last change: 23 Mar 2005                    1






Standard C Library Functions     pthreadmutexattrgetpshared(3C)



     The            pthreadmutexattrgetpshared()            and
     pthreadmutexattrsetpshared() functions may fail if:

     EINVAL    The value specified by attr is invalid.



     The pthreadmutexattrsetpshared() function may 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
     pthreadcreate(3C),                  pthreadmutexinit(3C),
     pthreadmutexattrinit(3C),   pthreadcondinit(3C),  attri-
     butes(5), standards(5)























SunOS 5.11          Last change: 23 Mar 2005                    2