Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

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