Knowledge Center Contents Previous Next |
ls_rtask()
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_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 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_rtask(char *host, char **argv, int options)PARAMETERS
*host
The remote host where the program is executed.
**argv
The program being used.
options
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_rtaske()
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 |