Manual Pages for UNIX Operating System command usage for man pthread_barrierattr_setpshared

Standard C Library Functions   pthread_barrierattr_getpshared(3C)



NAME
     pthread_barrierattr_getpshared,
     pthread_barrierattr_setpshared  - get and set process-shared
     attribute of barrier attributes object

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

     int pthread_barrierattr_getpshared(
          const pthread_barrierattr_t *restrict attr,
          int *restrict pshared);


     int pthread_barrierattr_setpshared(pthread_barrierattr_t *attr,
          int pshared);


DESCRIPTION
     The pthread_barrierattr_getpshared()  function  obtains  the
     value  of  the  process-shared attribute from the attributes
     object        referenced        by         attr.         The
     pthread_barrierattr_setpshared()  function sets the process-
     shared attribute in an initialized attributes object  refer-
     enced by attr.


     The     process-shared     attribute     is      set      to
     PTHREAD_PROCESS_SHARED  to  permit  a barrier to be operated
     upon by any thread that has access to the memory  where  the
     barrier  is  allocated.  If  the process-shared attribute is
     PTHREAD_PROCESS_PRIVATE, the barrier will only  be  operated
     upon  by  threads  created  within  the  same process as the
     thread that initialized the barrier. If threads of different
     processes attempt to operate on such a barrier, the behavior
     is undefined.


     The    default     value     of     the     attribute     is
     PTHREAD_PROCESS_PRIVATE.            Both           constants
     PTHREAD_PROCESS_SHARED   and   PTHREAD_PROCESS_PRIVATE   are
     defined in .


     No barrier attributes other than the  process-shared  attri-
     bute are provided.

RETURN VALUES
     Upon          successful           completion,           the
     pthread_barrierattr_getpshared()   function  returns  0  and
     stores the value of the  process-shared  attribute  of  attr
     into   the  object  referenced  by  the  pshared  parameter.



SunOS 5.11          Last change: 30 Jan 2004                    1






Standard C Library Functions   pthread_barrierattr_getpshared(3C)



     Otherwise, an error  number  is  returned  to  indicate  the
     error.


     Upon          successful           completion,           the
     pthread_barrierattr_setpshared()  function returns 0. Other-
     wise, an error number is returned to indicate the error.

ERRORS
     These functions may fail if:

     EINVAL    The value specified by attr is invalid.



     The pthread_barrierattr_setpshared() function may fail if:

     EINVAL    The new value  specified  for  the  process-shared
               attribute   is   not   one  of  the  legal  values
               PTHREAD_PROCESS_SHARED or PTHREAD_PROCESS_PRIVATE.


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_barrier_init(3C),   pthread_barrierattr_destroy(3C),
     attributes(5), standards(5)













SunOS 5.11          Last change: 30 Jan 2004                    2