pthread_yield(3T)                 SDK R4.11                pthread_yield(3T)


NAME
       pthreadyield - yield to other threads

SYNOPSIS
       void pthreadyield(void *arg);

DESCRIPTION
       The pthreadyield() function causes the calling thread to yield its
       processor to peers of equal priority or better.  That is, the calling
       thread's execution is halted and the thread made runnable, so that it
       can be rescheduled.

       If the calling thread has local contention scope, it yields to other
       threads with equal or better priority in the same thread group.  If
       the calling thread has global contention scope, it yields to other
       thread groups of equal or better priority, which is equivalent to the
       behavior of schedyield(2).

       If the calling thread has no peers of equal or better priority that
       are runnable on the current processor, the calling thread returns
       immediately from its call to pthreadyield().

       The behavior of pthreadyield() is unspecified if the value of arg is
       not NULL.  DG/UX currently ignores this parameter.

DIAGNOSTICS
   Return Value
       The pthreadyield() function returns nothing and never gets an error.

   Errors
       None.

SEE ALSO
       pthreadattrsetsched(3T), pthreadattrsetprio(3T),
       pthreadgroupcreate(3T), schedyield(2), threads(5).

NOTES
       The semantics of arg are poorly defined by the standard.  For now,
       applications should pass NULL for maximum portability in the future.

       The use of this function is generally discouraged for applications
       other than realtime applications wishing to gain full control over
       the scheduling of their threads.


Licensed material--property of copyright holder(s)