Manual Pages for UNIX Operating System command usage for man pthread_condattr_getpshared

Standard C Library Functions      pthread_condattr_getpshared(3C)



NAME
     pthread_condattr_getpshared,  pthread_condattr_setpshared  -
     get or set process-shared condition variable attributes

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

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


     int pthread_condattr_setpshared(pthread_condattr_t *attr,
          int pshared);


DESCRIPTION
     The pthread_condattr_getpshared() function obtains the value
     of  the  process-shared attribute from the attributes object
     referenced by attr. The pthread_condattr_setpshared()  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
     PTHREAD_PROCESS_SHARED  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
     PTHREAD_PROCESS_PRIVATE, 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 PTHREAD_PROCESS_PRIVATE.


     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  pthread_condattr_setpshared()  function
     returns   0. Otherwise, an error number is returned to indi-
     cate the error.


     If successful,  the  pthread_condattr_getpshared()  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      pthread_condattr_getpshared(3C)



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

ERRORS
     The            pthread_condattr_getpshared()             and
     pthread_condattr_setpshared() functions may fail if:

     EINVAL    The value specified by attr is invalid.



     The pthread_condattr_setpshared() function will fail if:

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


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_condattr_init(3C),               pthread_create(3C),
     pthread_mutex_init(3C),     pthread_cond_init(3C),    attri-
     butes(5), standards(5)

















SunOS 5.11          Last change: 23 Mar 2005                    2