💾 Archived View for gmi.noulin.net › man › man3 › __ppc_yield.3.gmi captured on 2023-09-08 at 16:48:15. Gemini links have been rewritten to link to archived content

View Raw

More Information

-=-=-=-=-=-=-

__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 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 out‐
       standing 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  out‐
       standing 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 attributes(7).

       ┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬───────────────┬─────────┐
       │Interface                                                                                                                             │ Attribute     │ Value   │
       ├──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
       │__ppc_yield(), __ppc_mdoio(), __ppc_mdoom()                                                                                           │ Thread safety │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘

CONFORMING TO
       These functions are nonstandard GNU extensions.

SEE ALSO
       __ppc_set_ppr_med(3)

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

GNU C Library                                                                  2021-03-22                                                                 __PPC_YIELD(3)