NAME    [Toc]    [Back]

       pthread_condattr_getpshared  -  Obtain  the process-shared
       attribute of a condition variable attributes object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_condattr_getpshared(
               const pthread_condattr_t attr,
               int *pshared );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

PARAMETERS    [Toc]    [Back]

       Address of the condition variable attributes object  whose
       process-shared  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 condition variable 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.

       Creating  a  condition   variable   whose   process-shared
       attribute  is set to PTHREAD_PROCESS_PRIVATE permits it to
       be operated on by threads created within the same  process
       as  the  thread  that initialized that condition variable.
       If threads other than processes attempt to operate on such
       a condition variable, the behavior is undefined.

       The  default  value  of the process-shared attribute of an
       initialized  condition  variable  attributes   object   is
       PTHREAD_PROCESS_PRIVATE.

       Creating   a   condition   variable  whose  process-shared
       attribute is set to PTHREAD_PROCESS_SHARED permits  it  to
       be operated upon by any thread that has access to the memory
 where that condition variable is allocated, even if it
       is  allocated  in  memory  that is shared by multiple processes.

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_condattr_init(3),      pthread_condattr_setpshared(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                   pthread_condattr_getpshared(3)