__ppc_yield(3)             Library Functions Manual             __ppc_yield(3)

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

LIBRARY
       Standard C library (libc, -lc)

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
       improved if shared resources dedicated to the executing processor are
       released for use by other processors.

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

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

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

       +--------------------------------------------+---------------+---------+
       |Interface                                   | Attribute     | Value   |
       +--------------------------------------------+---------------+---------+
       |__ppc_yield (), __ppc_mdoio (), __ppc_mdoom | Thread safety | MT-Safe |
       |()                                          |               |         |
       +--------------------------------------------+---------------+---------+
STANDARDS
       GNU.

HISTORY
       glibc 2.18.

SEE ALSO
       __ppc_set_ppr_med(3)

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

Linux man-pages 6.7               2023-10-31                    __ppc_yield(3)