ls_rtaske

Starts a remote task on a specified host.

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

ls_rtaske starts a remote task on the specified host. This routine is basically a remote fork followed by an execv. The arguments are identical to those of ls_rexecv. ls_rtask is typically used by a parallel application to execute multiple remote tasks efficiently. When a remote task finishes, a SIGUSR1 signal is delivered back to the application, and its status can be collected by calling ls_rwait or ls_rwaittid. ls_rtask returns a unique task ID to be used by the application to differentiate outstanding remote tasks. It returns -1 on failure.

ls_rtaske is the same as ls_rtask 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.

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_rtaske(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.