ls_rtask

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

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_rtask(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:

int:Unique TaskID
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_rexecv

ls_rexecve

ls_rtaske

ls_rfcontrol

ls_chdir

ls_conntaskport

ls_rsetenv

ls_initrex