ls_rexecv

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_rexecv 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.

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_rexecv(char *host, char **argv, int options)

Parameters:

	*host	The remote host where the program is executed.
	**argv	The program being used.
	options	options_rexec

Data Structures:

none

Define Statements:

options_rexec

Returns:

None
Function was successful.

int:-1
Function failed.

Errors:

Systems that conform to the Single UNIX specification are not required to detect error conditions for this function.

Equivalent line commands:

none

Files:

${LSF_ENVDIR:-/etc}/lsf.conf

See also:

ls_rexecve

ls_rtask

ls_rtaske

ls_rfcontrol

ls_chdir

ls_conntaskport

ls_initrex