rexec(2)                                                              rexec(2)



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

SYNOPSIS
     #include <unistd.h>

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

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

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

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

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

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

DESCRIPTION
     rexec in all its forms overlays a new process image on an old process and
     commences execution on a new cell. This system call is reserved to be
     supported in Cellular 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.

ERRORS
     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
     exec(2),

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













                                                                        Page 1