filesystems/spufs/spu_run.rst

1 .. SPDX-License-Identifier: GPL-2.0
10        spu_run - execute an spu context
20 	    int spu_run(int fd, unsigned int *npc, unsigned int *event);
25        Cell Broadband Engine Architecture in order to access Synergistic  Pro-
26        cessor  Units  (SPUs).  It  uses the fd that was returned from spu_cre-
27        ate(2) to address a specific SPU context. When the context gets  sched-
32        not  return  while the SPU is still running. If there is a need to exe-
41        event can be a NULL pointer or point to an extended  status  code  that
42        gets  filled  when spu_run returns. It can be one of the following con-
54        If NULL is passed as the event argument, these errors will result in  a
59        spu_run  returns the value of the spu_status register or -1 to indicate
60        an error and set errno to one of the error  codes  listed  below.   The
61        spu_status  register  value  contains  a  bit  mask of status codes and
62        optionally a 14 bit code returned from the stop-and-signal  instruction
63        on the SPU. The bit masks for the status codes are:
66 	      SPU was stopped by stop-and-signal.
75 	      SPU is in single-step mode.
85               stop-and-signal.
93               fd is in non-blocking mode and spu_run would block.
105        ENOMEM Insufficient memory was available to handle a page fault result-
117        See  http://www.bsc.es/projects/deepcomputing/linuxoncell/ for the rec-
123        This call is Linux specific and only implemented by the ppc64 architec-