Debian Codegraph @

upstream/debian-unstable/man3/__ppc_yield.3

raw
1 '\" t
2 .\" Copyright 2015, International Business Machines Corp.
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
6 .\"
7 .TH __ppc_yield 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 __ppc_yield, __ppc_mdoio, __ppc_mdoom \-
10 Hint the processor to release shared resources
11 .SH LIBRARY
12 Standard C library
13 .RI ( libc ,\~ \-lc )
14 .SH SYNOPSIS
15 .nf
16 .B #include <sys/platform/ppc.h>
17 .P
18 .B void __ppc_yield(void);
19 .B void __ppc_mdoio(void);
20 .B void __ppc_mdoom(void);
21 .fi
22 .SH DESCRIPTION
23 These functions
24 provide hints about the usage of resources that are shared with other
25 processors on the Power architecture.
26 They can be used, for example, if a program waiting on a lock intends
27 to divert the shared resources to be used by other processors.
28 .P
29 .BR __ppc_yield ()
30 provides a hint that performance will probably be improved if shared
31 resources dedicated to the executing processor are released for use by
32 other processors.
33 .P
34 .BR __ppc_mdoio ()
35 provides a hint that performance will probably be improved if shared
36 resources dedicated to the executing processor are released until all
37 outstanding storage accesses to caching-inhibited storage have been
38 completed.
39 .P
40 .BR __ppc_mdoom ()
41 provides a hint that performance will probably be improved if shared
42 resources dedicated to the executing processor are released until all
43 outstanding storage accesses to cacheable storage for which the data
44 is not in the cache have been completed.
45 .SH ATTRIBUTES
46 For an explanation of the terms used in this section, see
47 .BR attributes (7).
48 .TS
49 allbox;
50 lbx lb lb
51 l l l.
52 Interface Attribute Value
53 T{
54 .na
55 .nh
56 .BR __ppc_yield (),
57 .BR __ppc_mdoio (),
58 .BR __ppc_mdoom ()
59 T} Thread safety MT-Safe
60 .TE
61 .SH STANDARDS
62 GNU.
63 .SH HISTORY
64 glibc 2.18.
65 .SH SEE ALSO
66 .BR __ppc_set_ppr_med (3)
67 .P
68 .I Power ISA, Book\~II - Section\~3.2 ("or" architecture)