.\" Copyright (c) International Business Machines Corp., 2006
.\"
+.\" %%%LICENSE_START(GPLv2+_SW_3_PARA)
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
.\" the GNU General Public License for more details.
.\"
-.\" You should have received a copy of the GNU General Public License
-.\" along with this program; if not, write to the Free Software
-.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston,
-.\" MA 02111-1307 USA
+.\" You should have received a copy of the GNU General Public
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
.\"
.\" HISTORY:
.\" 2005-09-28, created by Arnd Bergmann <arndb@de.ibm.com>
.\" 2007-09-28, updates for newer kernels, added example
.\" by Jeremy Kerr <jk@ozlabs.org>
.\"
-.TH SPU_RUN 2 2007-11-25 Linux "Linux Programmer's Manual"
+.TH SPU_RUN 2 2012-08-05 Linux "Linux Programmer's Manual"
.SH NAME
spu_run \- execute an SPU context
.SH SYNOPSIS
.BI "int spu_run(int " fd ", unsigned int *" npc \
", unsigned int *" event ");"
.fi
+
+.IR Note :
+There is no glibc wrapper for this system call; see NOTES.
.SH DESCRIPTION
The
.BR spu_run ()
returns the value of the
.I spu_status
register.
-On error it returns \-1 and sets
+On error, it returns \-1 and sets
.I errno
to one of the error codes listed below.
The bits masked with this value contain the code returned from a
.BR stop-and-signal
instruction.
-These bits are only valid if the 0x02 bit is set.
+These bits are valid only if the 0x02 bit is set.
.PP
If
.BR spu_run ()
.BR spu_run ()
system call was added to Linux in kernel 2.6.16.
.SH CONFORMING TO
-This call is Linux-specific and only implemented by the PowerPC
+This call is Linux-specific and implemented only by the PowerPC
architecture.
Programs using this system call are not portable.
.SH NOTES
is meant to be used from libraries that implement a more abstract
interface to SPUs, not to be used from regular applications.
See
-.I http://www.bsc.es/projects/deepcomputing/linuxoncell/
+.UR http://www.bsc.es\:/projects\:/deepcomputing\:/linuxoncell/
+.UE
for the recommended libraries.
.SH EXAMPLE
The following is an example of running a simple, one-instruction SPU
.BR spu_create (2),
.BR capabilities (7),
.BR spufs (7)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.