dpns_stat man page

DPNS_STAT(3)                DPNS Library Functions                DPNS_STAT(3)

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

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

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

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

      [1mint dpns_statx (const char *[4m[22mpath[24m[1m,  struct  dpns_fileid  *[4m[22mfile_uniqueid[24m[1m,[0m
      [1mstruct dpns_filestat *[4m[22mstatbuf[24m[1m)[0m

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

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

      [1mdpns_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 DPNS
             directory or the full DPNS 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,    [1mdpns_chdir(3)[22m,    [1mdpns_chmod(3)[22m,    [1mdpns_chown(3)[22m,
      [1mdpns_creat(3)[0m

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

DPNS                     $Date: 2003/09/02 07:08:38 $             DPNS_STAT(3)

Referenced By

dpns_lstat(3) is an alias of dpns_stat(3).