ls_rsetenv

Sets up environment variables on a remote host.

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.

#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.

Data Structures:

none

Define Statements:

none

Returns:

int: 0
The function was successful.

int:-1
Function failed.

Errors:

If the function fails, lserrno is set to indicate the error.

Equivalent line commands:

none

Files:

${LSF_ENVDIR:-/etc}/lsf.conf

See also:

ls_rtask

ls_initrex