Knowledge Center Contents Previous Next |
ls_rsetenv()
Sets up environment variables on a remote host.
DESCRIPTION
ls_rsetenv() sets up the environment variables given in envp on the specified remote host. envp is a pointer to an array of strings of the form variable=value. When the environment variables are set, all remote tasks on the remote host acquire the environment setting until another call to this routine overrides it. A default set of environment variables is set up for the remote host if this routine is never called (see ls_rtask()). This call is typically used to propagate changes in the local environment to the remote hosts to which the application has connections.
Any program using this routine must call ls_initrex() first.
Any program using this API must be setuid to root if LSF_AUTH is not defined in the lsf.conf file.
SYNOPSIS
#include <lsf/lsf.h> int ls_rsetenv(char *host, char **envp)PARAMETERS
*host
The remote host upon which the environment is being set.
**envp
A pointer to an array of strings of the form variable=value.
RETURN VALUES
integer:0
The function was successful.
integer:-1
Function failed.
ERRORS
If the function fails, lserrno is set to indicate the error.
SEE ALSO
Related APIs
ls_rtask()
ls_initrex()
Equivalent line command
none
Files
${LSF_ENVDIR-/etc}/lsf.conf
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |