Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

ls_rtaske()

Starts a remote task on a specified host.

DESCRIPTION

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 documented in ls_rfs() 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.

SYNOPSIS

#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

*envp

RETURN VALUES

integer:Unique TaskID

Function was successful.

integer:-1

Function failed.

ERRORS

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

SEE ALSO

Related APIs

ls_rexecv()

ls_rexecve()

ls_rtask()

ls_control()

ls_chdir()

ls_conntaskport()

ls_rstenv()

ls_initrex()

ls_rfs()

Equivalent line command

none

Files

${LSF_ENVDIR-/etc}/lsf.conf


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next