sam_stat, sam_lstat - Gets file status over a network con-
cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsamrpc -lnsl [ library ... ]
int sam_stat(const char *path, struct sam_stat *buf);
int sam_lstat(const char *path, struct sam_stat *buf);
These are the RPC-based versions of sam_stat(3) and
sam_stat(3X) and sam_lstat(3X) get file status by sending a
request to the Sun QFS or SAM-QFS RPC server, sam-rpcd.
If the server machine is different from the local machine,
path must be an absolute path. If the server machine is the
local machine, path may be an absolute path or relative to
the user's current working directory.
A call to sam_initrpc(3X) must be issued before these calls.
Upon successful completion a value of 0 is returned. Other-
wise, a value of -1 is returned and errno is set to indicate
EDESTADDRREQ sam_initrpc was not successfully called,
as required, before making this call.
EINVAL path is not an absolute pathname and the
server (SAMHOST) machine is not the same
as the local machine.