ls_rexecve

Executes a program on a specified remote host.

This routine is for executing remote tasks. It is modeled after the UNIX fork and execv system calls.

ls_rexecve executes a program on the specified remote host. The program name is given in argv[0] and the arguments are listed in argv. This routine is basically a remote execv. If a connection with the Remote Execution Server (RES) on host has not been set up previously, ls_connect is invoked to automatically establish the connection. The remote execution environment is set up to be exactly the same as the local one and is cached by the remote RES server.

ls_rexecve is the same as ls_rexecv except that it provides the support of setting up a new environment specified by the string array **envp. When envp is a NULL pointer, it means using the remote RES server's cached environment, otherwise using the new one. A minimal default environment (HOME, SHELL, USER, and PATH) is initially cached when a remote execution connection is established and the cached environment is updated whenever the remote execution environment is changed by ls_rsetenv or any of the routines on this man page.

The caller of this routine is typically a child process which terminates when the remote task is over. This routine does not return if successful. It returns -1 on failure.

Any program using this routine must call ls_initrex first.

Any program using these routines must be setuid to root if LSF_AUTH is not defined in the lsf.conf file.

The remote file operations make use of a Remote File Server on the remote host. When this RFS shuts down, its status will be reported to its client. The client should ignore this status.

#include <lsf/lsf.h>

int ls_rexecve(char *host, char **argv, int options, char **envp)

Parameters:

	*host	The remote host where the program is executed.
	**argv	The program being used.
	options	options_rexec
	**envp	Environment pointer which is used for set up remote environment.