sam_lstat(3X)

NAME
     sam_stat, sam_lstat - Gets file status over a  network  con-
     nection

SYNOPSIS
     cc [ flag  ... ] file  ... -L/opt/SUNWsamfs/lib -lsamrpc  -lnsl [ library ... ]

     #include "/opt/SUNWsamfs/include/stat.h"
     #include "/opt/SUNWsamfs/include/samrpc.h"

     int sam_stat(const char *path, struct sam_stat *buf);

     int sam_lstat(const char *path, struct sam_stat *buf);

DESCRIPTION
     These  are  the  RPC-based  versions  of   sam_stat(3)   and
     sam_lstat(3).

     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.

RETURN VALUES
     Upon successful completion a value of 0 is returned.  Other-
     wise, a value of -1 is returned and errno is set to indicate
     the error.

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

SEE ALSO
     sam_lstat(3), sam_stat(3).

     sam_closerpc(3X), sam_initrpc(3X).