Debian Codegraph @

upstream/debian-trixie/man3/__ppc_yield.3

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