ls_rstat

Obtains information about a file located on a remote host.

This routine performs operations on files located on remote hosts. This call corresponds to the UNIX stat() system calls.

ls_rstat obtains information about a file located on the remote host. Because different platforms have different fields in the stat structure, only the following fields are updated: st_dev, st_ino, st_mode, st_nlink, st_uid, st_gid, st_rdev, st_size, st_atime, st_mtime, and st_ctime.

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>

int ls_rstat(char *host, char *path, struct stat *buf)

Parameters:

	*host	The remote host containing the file to be analyzed.
	*path	The path name to the file to be opened.
	*buf	Pointer of the stat Structure which will be filled by the performance of stat() on the remote system.

Data Structures:

none

Define Statements:

none

Returns:

int: 0
Response is the same from its UNIX counterpart.

int:-1
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_rfstat

ls_rgetmnthost

ls_rfcontrol

ls_initrex