PTHREAD_BARRIER_WAIT man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

PTHREAD_BARRIER_WAIT(3C)			      PTHREAD_BARRIER_WAIT(3C)

NAME
       pthread_barrier_wait - synchronize at a barrier

SYNOPSIS
       cc -mt [ flag... ] file... [ library... ]
       #include <pthread.h>

       int pthread_barrier_wait(pthread_barrier_t *barrier);

DESCRIPTION
       The  pthread_barrier_wait() function synchronizes participating threads
       at the barrier referenced by barrier. The calling thread	 blocks	 until
       the required number of threads have called pthread_barrier_wait() spec‐
       ifying the barrier.

       When the required number of threads have called	pthread_barrier_wait()
       specifying  the	barrier, the constant PTHREAD_BARRIER_SERIAL_THREAD is
       returned to one unspecified thread and 0 is returned  to	 each  of  the
       remaining  threads. At this point, the barrier is reset to the state it
       had as a result of the most  recent  pthread_barrier_init(3C)  function
       that referenced it.

       The  constant  PTHREAD_BARRIER_SERIAL_THREAD  is defined in <pthread.h>
       and its value is distinct from any other value returned by pthread_bar‐
       rier_wait().

       The results are undefined if this function is called with an uninitial‐
       ized barrier.

       If a signal is delivered to a thread blocked on a barrier, upon	return
       from  the  signal  handler the thread resumes waiting at the barrier if
       the barrier wait has not completed (that is, if the required number  of
       threads	have  not  arrived  at the barrier during the execution of the
       signal handler); otherwise, the thread continues	 as  normal  from  the
       completed  barrier wait. Until the thread in the signal handler returns
       from it, it is unspecified whether other threads may proceed  past  the
       barrier once they have all reached it.

       A  thread  that has blocked on a barrier does not prevent any unblocked
       thread that is eligible to use the same processing resources from even‐
       tually making forward progress in its execution.

       Eligibility  for	 processing  resources is determined by the scheduling
       policy.

RETURN VALUES
       Upon successful completion, the pthread_barrier_wait() function returns
       PTHREAD_BARRIER_SERIAL_THREAD  for a single (arbitrary) thread synchro‐
       nized at the barrier and 0 for each of the other threads. Otherwise, an
       error number is returned to indicate the error.

ERRORS
       The pthread_barrier_wait() function will fail if:

       EINVAL
		 The  value specified by barrier does not refer to an initial‐
		 ized barrier object.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ Standard	      │
       ├────────────────────┼─────────────────┤
       │MT-Level	    │ MT-Safe	      │
       └────────────────────┴─────────────────┘

SEE ALSO
       pthread_barrier_destroy(3C), attributes(5), standards(5)

				 Jan 30, 2004	      PTHREAD_BARRIER_WAIT(3C)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net