rexec(2)							      rexec(2)

NAME    [Toc]    [Back]

     rexec: rexecl, rexecv, rexecle, rexecve, rexeclp, rexecvp - execute a
     file on a remote cell

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     int rexecl	(cell_t	cell, const char *path,	const char *arg0, ..., const
	  char *argn, (char *)0);

     int rexecv	(cell_t	cell, const char *path,	char *const *argv);

     int rexecle (cell_t cell, const char *path, const char *arg0, ...,	const
	  char *argn, (char *0), const char *envp[]);

     int rexecve (cell_t cell, const char *path, char *const *argv, char
	  *const *envp);

     int rexeclp (cell_t cell, const char *file, const char *arg0, ...,	const
	  char *argn, (char *)0);

     int rexecvp (cell_t cell, const char *file, char *const *argv);

DESCRIPTION    [Toc]    [Back]

     rexec in all its forms overlays a new process image on an old process and
     commences execution on a new cell.	This system call was reserved to be
     supported in a future version of IRIX. In IRIX release 6.5, the only
     valid value for cell is 0 and then	each form of rexec is equivalent to
     the corresponding form of exec. Therefore use of rexec is deprecated as
     this system call may not be present in future IRIX	releases.

ERRORS    [Toc]    [Back]

     In	addition to the	error codes returned by	exec, the following error code
     may be returned by	any of the forms of rexec:

     [EINVAL]	 An invalid value for cell was specified.

SEE ALSO    [Toc]    [Back]

     exec(2),

DIAGNOSTICS    [Toc]    [Back]

     If	rexec returns to the calling process, an error has occurred; the
     return value is -1	and errno is set to indicate the error.


									PPPPaaaaggggeeee 1111