__ppc_yield (3)

Leading comments

Copyright (c) 2015, IBM Corporation.

%%%LICENSE_START(VERBATIM)
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.

Permission is granted to copy and distribute modified versions of
this manual under the conditions for verbatim copying, provided that
the entire resulting derived work is distributed under the terms of
a permission notice identical to this one.

Since the Linux kernel...

(The comments found at the beginning of the groff file "man3/__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 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

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)

COLOPHON

This page is part of release 4.04 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 www.kernel.org/doc/man-pages