NAME    [Toc]    [Back]

       pthread_mutexattr_getpshared  - Obtains the process-shared
       attribute of a mutex attributes object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_mutexattr_getpshared(
               const pthread_mutexattr_t *attr,
               int *pshared );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

PARAMETERS    [Toc]    [Back]

       Address of the  mutex  attributes  object  whose  processshared
 attribute is to be obtained.  Location to store the
       value of the process-shared attribute of attr.

DESCRIPTION    [Toc]    [Back]

       This routine  obtains  the  value  of  the  process-shared
       attribute  in  the  mutex  attributes object referenced by
       attr and stores it at the  location  pshared.  The  object
       referenced by attr must be initialized before this routine
       is called.

       Setting  the  process-shared  attribute  to   PTHREAD_PROCESS_PRIVATE
  permits  a  mutex  to  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 process-shared attribute of a
       mutex attributes object is PTHREAD_PROCESS_PRIVATE.

       Setting  the  process-shared  attribute  to   PTHREAD_PROCESS_SHARED
  permits  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 programs.

RETURN VALUES    [Toc]    [Back]

       If an error condition  occurs,  this  routine  returns  an
       integer  value  indicating  the  type  of  error. Possible
       return values are as follows: Successful completion.   The
       value  specified by attr is not a valid attributes object.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions: pthread_mutexattr_setpshared(3), pthread_mutexattr_init(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                  pthread_mutexattr_getpshared(3)