| 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. |