diff --git a/man3/__ppc_set_ppr_med.3 b/man3/__ppc_set_ppr_med.3 new file mode 100644 index 000000000..a6b650674 --- /dev/null +++ b/man3/__ppc_set_ppr_med.3 @@ -0,0 +1,96 @@ +.\" 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 and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume. +.\" no responsibility for errors or omissions, or for damages resulting. +.\" from the use of the information contained herein. The author(s) may. +.\" not have taken the same level of care in the production of this. +.\" manual, which is licensed free of charge, as they might when working. +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\" Process this file with +.\" groff -man -Tascii foo.1 +.\" +.TH __PPC_SET_PPR_MED 3 2015-08-05 "GNU C Library" "Linux\ +Programmer's Manual" +.SH NAME +__ppc_set_ppr_med, __ppc_set_ppr_low, __ppc_set_ppr_med_low \- +Set the Program Priority Register +.SH SYNOPSIS +.B #include +.sp +.B void __ppc_set_ppr_med(void); +.br +.B void __ppc_set_ppr_low(void); +.br +.B void __ppc_set_ppr_med_low(void); +.SH DESCRIPTION +The functions +.BR __ppc_set_ppr_med (), +.BR __ppc_set_ppr_low () +and +.BR __ppc_set_ppr_med_low () +provide access to the +.I Program Priority Register +(PPR). +.P +The PPR is a 64-bit register that controls the program's priority. +By adjusting the PPR value the programmer may improve system +throughput by causing the system resources to be used more +efficiently, especially in contention situations. +The three unprivileged states available are covered by the functions +.BR __ppc_set_ppr_med (), +.BR __ppc_set_ppr_low () +and +.BR __ppc_set_ppr_med_low (). +More information available in Power ISA 2.06b - Book II - Section 3.1. +.P +.BR __ppc_set_ppr_med () +sets the Program Priority Register to medium value (default). +.P +.BR __ppc_set_ppr_low () +sets the Program Priority Register to low value. +.P +.BR __ppc_set_ppr_med_low () +sets the Program Priority Register to medium low value. +.SH VERSIONS +GNU C Library added support for +.BR __ppc_set_ppr_med (), +.BR __ppc_set_ppr_low () +and +.BR __ppc_set_ppr_med_low () +in version 2.18. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.ad l +.TS +allbox; +lb lb lb +l l l. +Interface Attribute Value +T{ +.BR __ppc_set_ppr_med (), +.BR __ppc_set_ppr_low (), +.BR __ppc_set_ppr_med_low () +T} Thread safety MT-Safe +.TE +.ad +.SH CONFORMING TO +These functions are nonstandard GNU extensions. +.SH SEE ALSO +.BR __ppc_yield (3)