Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

ls_rgetmnthost()

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

DESCRIPTION

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.

SYNOPSIS

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

RETURN VALUES

character:Hostname

The function was successful.

character:NULL

Function failed.

ERRORS

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

SEE ALSO

Related APIs

ls_ropen()

ls_rread()

ls_rwrite()

ls_rlseek()

ls_rclose()

ls_rstat()

ls_rfstat()

ls_rfcontrol()

ls_initrex()

Equivalent line command

none

Files

none


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next