Debian Codegraph @

upstream/fedora-44/man2/rtas.2

raw
1 .\" Copyright (C) 2004 IBM Corporation
2 .\" This file is distributed according to the GNU General Public License.
3 .\" See the file COPYING in the top level source directory for details.
4 .\"
5 .\" This page documents the differences between the low-level kernel system call interface .\" and that made available to applications by glibc. Portable applications should always .\" use the official library interface.
6 .\"
7 .de Sh \" Subsection
8 .br
9 .if t .Sp
10 .ne 5
11 .PP
12 \fB\\$1\fR
13 .PP
14 ..
15 .de Sp \" Vertical space (when we can't use .PP)
16 .if t .sp .5v
17 .if n .sp
18 ..
19 .de Ip \" List item
20 .br
21 .ie \\n(.$>=3 .ne \\$3
22 .el .ne 3
23 .IP "\\$1" \\$2
24 ..
25 .TH "RTAS" 2
26 .SH NAME
27 rtas \- Allows userspace to call RTAS (Run Time Abstraction Services)
28 .SH "SYNOPSIS"
29 .ad l
30 .hy 0
31 .HP 17
32 int\ \fBppc_rtas\fR\ (struct rtas_args\ \fI*uargs\fR);
33 .ad
34 .hy
35
36 .SH "DESCRIPTION"
37 \fBppc_rtas\fR enables userspace manipulation of the RunTime Abstraction Services (RTAS). RTAS provides for a portable method of access and setting system information. For example, you could gather information on various system sensors and set poweron values. RTAS is accessed via the /proc entry called "rtas". Manipulations on RTAS are implemented via command line arguments on /proc/rtas.
38 The values for \fIuargs\fR vary greatly.
39 For more information, see the \fIview/arch/ppcKconfig\fR file.
40
41 .SH "RETURN VALUE"
42
43 .PP
44 \fBrtas\fR returns 0 on success; otherwise it returns one of the errors listed in the "Errors" section.
45
46 .SH "ERRORS"
47
48 .TP
49 -EPERM
50 User does not have CAP_SYS_ADMIN capabilities.
51
52 .TP
53 -EFAULT
54 Problem copying \fIuargs\fR values to/from user space.
55
56 .TP
57 -EINVAL
58 Either number of \fIuargs\fR passed in too large or size of \fIuargs\fR array too large.
59
60 .SH AUTHOR
61 Niki Rahimi.