Knowledge Center Contents Previous Next |
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 |