dpns_statg man page

DPNS_STATG(3)               DPNS Library Functions               DPNS_STATG(3)

[1mNAME[0m
      dpns_statg - 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_statg  (const  char   *[4m[22mpath[24m[1m,   const   char   *[4m[22mguid,[24m   [1mstruct[0m
      [1mdpns_filestatg *[4m[22mstatbuf[24m[1m)[0m

      [1mint dpns_statr (const char *[4m[22msfn[24m[1m, struct dpns_filestatg *[4m[22mstatbuf[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_statg  [22mgets information about a DPNS file or directory, having the
      given GUID, in the name server.

      [1mdpns_statr [22mretrieves information about the given replica.

      The file can be specified by [4mpath[24m name or by [4mguid[24m.  If both are  given,
      they must point at the same file.

      [4mguid[24m   specifies the Grid Unique IDentifier.

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

      [4msfn[24m    is either the Site  URL  or  the  Physical  File  Name  for  the
             replica.

      The structure pointed to by [4mstatbuf[24m contains the following members:
             u_signed64     fileid;             /* entry unique identifier */
             char      guid[CA_MAXGUIDLEN+1]    /* GUID */
             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 */
             char      csumtype[3];
             char      csumvalue[33];

      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.

      [1mEINVAL       [22mThe  length of the [4mguid[24m component exceeds [1mCA_MAXGUIDLEN [22mor
                   path and guid are both given and they point at a different
                   file.

      [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 [22mor  the  length  of
                   the [4msfn[24m exceeds [1mCA_MAXSFNLEN[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: 2005/04/28 05:20:20 $            DPNS_STATG(3)

Referenced By

dpns_access(3), dpns_creat(3), dpns_readlink(3), dpns_setatime(3), dpns_symlink(3), dpns_umask(3), dpns_utime(3).

dpns_statr(3) is an alias of dpns_statg(3).