lfc_stat man page

LFC_STAT(3)                  LFC Library Functions                 LFC_STAT(3)

[1mNAME[0m
      lfc_stat  -  get  information about a LFC file or directory in the name
      server

[1mSYNOPSIS[0m
      [1m#include <sys/types.h>[0m
      [1m#include "lfc_api.h"[0m

      [1mint lfc_lstat (const char *[4m[22mpath[24m[1m, struct lfc_filestat *[4m[22mstatbuf[24m[1m)[0m

      [1mint lfc_stat (const char *[4m[22mpath[24m[1m, struct lfc_filestat *[4m[22mstatbuf[24m[1m)[0m

      [1mint lfc_statx (const  char  *[4m[22mpath[24m[1m,  struct  lfc_fileid  *[4m[22mfile_uniqueid[24m[1m,[0m
      [1mstruct lfc_filestat *[4m[22mstatbuf[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mlfc_stat  [22mgets  information  about  a LFC file or directory in the name
      server.

      [1mlfc_lstat  [22mis  identical  to  [1mlfc_stat  [22mexcept  for   symbolic   links.
      [1mlfc_lstat  [22mretrieves  information about the link itself, while [1mlfc_stat[0m
      gets information about the file/directory referenced  by  the  symbolic
      link.

      [1mlfc_statx  [22mreturns  the  same information plus the file unique id (name
      server hostname and file id).  The file can be specified by  [4mpath[24m  name
      or by [4mfile_uniqueid[24m.  If both are given, [4mfile_uniqueid[24m is used.

      [4mpath[24m   specifies  the  logical  pathname  relative  to  the current LFC
             directory or the full LFC pathname.

      The structure pointed to by [4mstatbuf[24m contains the following members:
             u_signed64     fileid;        /* entry unique identifier */
             mode_t         filemode; /* see below */
             int       nlink;         /* number of files in a directory */
             uid_t          uid;
             gid_t          gid;
             u_signed64     filesize;
             time_t         atime;         /* last access to file */
             time_t         mtime;         /* last file modification */
             time_t         ctime;         /* last metadata modification */
             short          fileclass;          /*  1-->  experiment,  2  -->
             user */
             char      status;        /* '-' --> online, 'm' --> migrated */

      filemode  is  constructed  by  OR'ing  the bits defined in <[1msys/stat.h[22m>
      under Unix or  [1m"statbits.h" [22munder Windows/NT:

             [1mS_IFLNK   0xA000          [22msymbolic link
             [1mS_IFREG   0x8000          [22mregular file
             [1mS_IFDIR   0x4000          [22mdirectory
             [1mS_ISUID   0004000         [22mset user ID on execution
             [1mS_ISGID   0002000         [22mset group ID on execution
             [1mS_ISVTX   0001000         [22msticky bit
             [1mS_IRUSR   0000400         [22mread by owner
             [1mS_IWUSR   0000200         [22mwrite by owner
             [1mS_IXUSR   0000100         [22mexecute/search by owner
             [1mS_IRGRP   0000040         [22mread by group
             [1mS_IWGRP   0000020         [22mwrite by group
             [1mS_IXGRP   0000010         [22mexecute/search by group
             [1mS_IROTH   0000004         [22mread by others
             [1mS_IWOTH   0000002         [22mwrite by others
             [1mS_IXOTH   0000001         [22mexecute/search by others

[1mRETURN VALUE[0m
      This routine returns 0 if the operation was successful  or  -1  if  the
      operation failed. In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mENOENT       [22mThe named file/directory does not exist or is a null path-
                   name.

      [1mEACCES       [22mSearch permission is denied on a  component  of  the  [4mpath[0m
                   prefix.

      [1mEFAULT       [4m[22mpath[24m or [4mstatbuf[24m is a NULL pointer.

      [1mENOTDIR      [22mA component of [4mpath[24m prefix is not a directory.

      [1mENAMETOOLONG [22mThe  length of [4mpath[24m exceeds [1mCA_MAXPATHLEN [22mor the length of
                   a [4mpath[24m component exceeds [1mCA_MAXNAMELEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

      [1mENSNACT      [22mName server is not running or is being shutdown.

[1mSEE ALSO[0m
      [1mCastor_limits(4)[22m, [1mlfc_chdir(3)[22m,  [1mlfc_chmod(3)[22m,  [1mlfc_chown(3)[22m,  [1mlfc_cre-[0m
      [1matg(3)[0m

[1mAUTHOR[0m
      [1mLCG Grid Deployment [22mTeam

LFC                      $Date: 2003/09/02 07:08:38 $              LFC_STAT(3)

Referenced By

lfc_lstat(3) is an alias of lfc_stat(3).