NAME | SYNOPSIS | DESCRIPTION | VERSIONS | ATTRIBUTES | CONFORMING TO | SEE ALSO | COLOPHON

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

NAME         top

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

SYNOPSIS         top

       #include <sys/platform/ppc.h>

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

DESCRIPTION         top

       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.

VERSIONS         top

       These functions first appeared in glibc in version 2.18.

ATTRIBUTES         top

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

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

CONFORMING TO         top

       These functions are nonstandard GNU extensions.

SEE ALSO         top

       __ppc_set_ppr_med(3)

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

COLOPHON         top

       This page is part of release 4.12 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                    2015-08-05                   __PPC_YIELD(3)

Pages that refer to this page: __ppc_set_ppr_med(3)