Knowledge Center Contents Previous Next |
ls_rstat()
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 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.
SYNOPSIS
#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
*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_rfstat()
ls_rgetmnthost()
ls_rfcontrol()
ls_initrex()
Equivalent line command
none
Files
none
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |