ls_chdir

ls_chdir sets the application's working directory on the remote host to the directory specified by clntdir.

If the application subsequently requests remote execution with the flag REXF_CLNTDIR, the Remote Execution Server (RES) uses the application's working directory on the remote host, instead of the application's local current working directory, as the current working directory for the remote execution. The RES keeps a working directory for each application, which is initialized as the user's home directory. The application can call this routine to change its working directory on a particular host. clntdir must be the full pathname of a valid directory on the host host.

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.

Sets an application's working directory on a remote host to a specified directory.

#include <lsf/lsf.h>

int ls_chdir(char *host, char *clntdir)

Parameters:

	*host	The remote host containing the client directory.
	*clntdir	The full pathname of a valid directory on the host host.

Data Structures:

none

Define Statements:

none

Returns:

int:0
Function was successful.

int:-1
Function failed.

int:-2
A warning if the RES fails to check clntdir due to permission denial. This is a temporary mechanism to get around the root uid mapping problem of NFS.

Errors:

Systems that conform to the Single UNIX specification are not required to detect error conditions for this function.

Equivalent line commands:

none

Files:

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

See also:

none