ls_rexecv
Executes a program on a specified remote host.This routine is for executing remote tasks. It is modeled after the UNIX fork and execv system calls.
ls_rexecv executes a program on the specified remote host. The program name is given in argv[0] and the arguments are listed in argv. This routine is basically a remote execv. If a connection with the Remote Execution Server(RES) on host has not been set up previously, ls_connect is invoked to automatically establish the connection. The remote execution environment is set up to be exactly the same as the local one and is cached by the remote RES server.
The caller of this routine is typically a child process which terminates when the remote task is over. This routine does not return if successful. 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_rexecv(char *host, char **argv, int options)
Data Structures:
- Parameters:
*host The remote host where the program is executed. **argv The program being used. options options_rexec Define Statements:
- none
Errors:
- Returns:
- None
Function was successful.int:-1
Function failed.Equivalent line commands:
- Systems that conform to the Single UNIX specification are not required to detect error conditions for this function.
Files:
- none
- ${LSF_ENVDIR:-/etc}/lsf.conf
Date Modified: 28 Jun 2011
Platform Support: support@platform.com
Platform Information Development: doc@platform.com
Platform Computing. Accelerating Intelligence(TM).
Copyright © 1994-2011 Platform Computing Corporation. All rights reserved.