ls_rgetmnthost

Obtains the name of the file server that exports a specified file system.

This routine performs operations on files located on remote hosts.

ls_rgetmnthost obtains the name of the file server that exports the file system mounted on host that contains file, where file is a relative or absolute path name. If host is NULL, the local host name is assumed. This call corresponds to the ls_getmnthost call.

Either the RES must be running at the remote host to service any remote file operation or rcp() be available.

ls_initrex must be called before calling any remote file operation.

This remote file operation makes 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 <sys/types.h>
#include <unistd.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <limits.h>
#include <lsf/lsf.h>

char *ls_rgetmnthost(char *host, char *file)

Parameters:

	*host	The host containing the file.
	*file	The file to be accessed.

Data Structures:

none

Define Statements:

none

Returns:

char *:Hostname
The function was successful.

NULL
Function failed.

Errors:

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

Equivalent line commands:

none

Files:

none

See also:

ls_ropen

ls_rread

ls_rwrite

ls_rlseek

ls_rclose

ls_rstat

ls_rfstat

ls_rfcontrol

ls_initrex