Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

ls_rfstat()

Obtains information about a file located on a remote host.

DESCRIPTION

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

ls_rfstat() 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.

SYNOPSIS

#include <sys/types.h>
#include <unistd.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <limits.h>
#include <lsf/lsf.h> 
int ls_rfstat(int rfd, struct stat *buf) 

PARAMETERS

rfd

References the file that is to be accessed.

*buf

RETURN VALUES

Response is the same from its UNIX counterpart.

integer:-1

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_rgetmnthost()

ls_rfcontrol()

ls_initrex()

Equivalent line command

none

Files

none


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