__ppc_yield

__PPC_YIELD(3)             Linux Programmer'sManual             __PPC_YIELD(3)

NAME
       __ppc_yield,  __ppc_mdoio,  __ppc_mdoom - Hint the processor to release
       shared resources

SYNOPSIS
       #include <sys/platform/ppc.h>

       void __ppc_yield(void);
       void __ppc_mdoio(void);
       void __ppc_mdoom(void);

DESCRIPTION
       These functions provide hints about the usage  of  resources  that  are
       shared  with  other  processors on the Power architecture.  They can be
       used, for example, if a program waiting on a lock intends to divert the
       shared resources to be used by other processors.

       __ppc_yield()  provides  a  hint  that performance will probably be im-
       proved if shared resources dedicated to the executing processor are re-
       leased for use by other processors.

       __ppc_mdoio()  provides  a  hint  that performance will probably be im-
       proved if shared resources dedicated to the executing processor are re-
       leased  until  all  outstanding  storage  accesses to caching-inhibited
       storage have been completed.

       __ppc_mdoom() provides a hint that performance  will  probably  be  im-
       proved if shared resources dedicated to the executing processor are re-
       leased until all outstanding storage accesses to cacheable storage  for
       which the data is not in the cache have been completed.

VERSIONS
       These functions first appeared in glibc in version 2.18.

ATTRIBUTES
       For  an  explanation  of  the  terms  used  in  this  section,  see at-
       tributes(7).

       +------------------------------+---------------+---------+
       |Interface                     | Attribute     | Value   |
       +------------------------------+---------------+---------+
       |__ppc_yield(), __ppc_mdoio(), | Thread safety | MT-Safe |
       |__ppc_mdoom()                 |               |         |
       +------------------------------+---------------+---------+
CONFORMING TO
       These functions are nonstandard GNU extensions.

SEE ALSO
       __ppc_set_ppr_med(3)

       Power ISA, Book II - Section 3.2 ("or" architecture)

COLOPHON
       This  page  is  part of release 5.05 of the Linux man-pages project.  A
       description of the project, information about reporting bugs,  and  the
       latest     version     of     this    page,    can    be    found    at
       https://www.kernel.org/doc/man-pages/.

GNU C Library                     2017-09-15                    __PPC_YIELD(3)