summaryrefslogtreecommitdiffstats
path: root/man2/spu_run.2
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:41:07 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:41:07 +0000
commit3af6d22bb3850ab2bac67287e3a3d3b0e32868e5 (patch)
tree3ee7a3ec64525911fa865bb984c86d997d855527 /man2/spu_run.2
parentAdding debian version 6.05.01-1. (diff)
downloadmanpages-3af6d22bb3850ab2bac67287e3a3d3b0e32868e5.tar.xz
manpages-3af6d22bb3850ab2bac67287e3a3d3b0e32868e5.zip
Merging upstream version 6.7.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man2/spu_run.2')
-rw-r--r--man2/spu_run.222
1 files changed, 11 insertions, 11 deletions
diff --git a/man2/spu_run.2 b/man2/spu_run.2
index 0a9d229..5b70753 100644
--- a/man2/spu_run.2
+++ b/man2/spu_run.2
@@ -9,7 +9,7 @@
.\" 2007-09-28, updates for newer kernels, added example
.\" by Jeremy Kerr <jk@ozlabs.org>
.\"
-.TH spu_run 2 2023-05-03 "Linux man-pages 6.05.01"
+.TH spu_run 2 2023-10-31 "Linux man-pages 6.7"
.SH NAME
spu_run \- execute an SPU context
.SH LIBRARY
@@ -20,11 +20,11 @@ Standard C library
.BR "#include <sys/spu.h>" " /* Definition of " SPU_* " constants */"
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
-.PP
+.P
.BI "int syscall(SYS_spu_run, int " fd ", uint32_t *" npc \
", uint32_t *" event );
.fi
-.PP
+.P
.IR Note :
glibc provides no wrapper for
.BR spu_run (),
@@ -44,7 +44,7 @@ that refers to a specific SPU context.
When the context gets scheduled to a physical SPU,
it starts execution at the instruction pointer passed in
.IR npc .
-.PP
+.P
Execution of SPU code happens synchronously, meaning that
.BR spu_run ()
blocks while the SPU is still running.
@@ -53,7 +53,7 @@ to execute SPU code in parallel with other code on either the
main CPU or other SPUs, a new thread of execution must be created
first (e.g., using
.BR pthread_create (3)).
-.PP
+.P
When
.BR spu_run ()
returns, the current value of the SPU program counter is written to
@@ -63,7 +63,7 @@ so successive calls to
can use the same
.I npc
pointer.
-.PP
+.P
The
.I event
argument provides a buffer for an extended status code.
@@ -73,7 +73,7 @@ context was created with the
flag, then this buffer is populated by the Linux kernel before
.BR spu_run ()
returns.
-.PP
+.P
The status code may be one (or more) of the following constants:
.TP
.B SPE_EVENT_DMA_ALIGNMENT
@@ -89,7 +89,7 @@ A DMA storage error occurred.
.TP
.B SPE_EVENT_SPE_ERROR
An illegal instruction was executed.
-.PP
+.P
NULL
is a valid value for the
.I event
@@ -104,7 +104,7 @@ register.
On failure, it returns \-1 and sets
.I errno
is set to indicate the error.
-.PP
+.P
The
.I spu_status
register value is a bit mask of status codes and
@@ -141,7 +141,7 @@ The bits masked with this value contain the code returned from a
.B stop-and-signal
instruction.
These bits are valid only if the 0x02 bit is set.
-.PP
+.P
If
.BR spu_run ()
has not returned an error, one or more bits among the lower eight
@@ -198,7 +198,7 @@ The following is an example of running a simple, one-instruction SPU
program with the
.BR spu_run ()
system call.
-.PP
+.P
.\" SRC BEGIN (spu_run.c)
.EX
#include <err.h>