Man Linux: Main Page and Category List

NAME

       dpns_statg - get information about a DPNS file or directory in the name
       server

SYNOPSIS

       #include <sys/types.h>
       #include "dpns_api.h"

       int  dpns_statg  (const  char   *path,   const   char   *guid,   struct
       dpns_filestatg *statbuf)

       int dpns_statr (const char *sfn, struct dpns_filestatg *statbuf)

DESCRIPTION

       dpns_statg  gets information about a DPNS file or directory, having the
       given GUID, in the name server.

       dpns_statr retrieves information about the given replica.

       The file can be specified by path name or by guid.  If both are  given,
       they must point at the same file.

       guid   specifies the Grid Unique IDentifier.

       path   specifies  the  logical  pathname  relative  to the current DPNS
              directory or the full DPNS pathname.

       sfn    is either the Site  URL  or  the  Physical  File  Name  for  the
              replica.

       The structure pointed to by statbuf 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  <sys/stat.h>
       under Unix or  "statbits.h" under Windows/NT:

              S_IFLNK   0xA000          symbolic link
              S_IFREG   0x8000          regular file
              S_IFDIR   0x4000          directory
              S_ISUID   0004000         set user ID on execution
              S_ISGID   0002000         set group ID on execution
              S_ISVTX   0001000         sticky bit
              S_IRUSR   0000400         read by owner
              S_IWUSR   0000200         write by owner
              S_IXUSR   0000100         execute/search by owner
              S_IRGRP   0000040         read by group
              S_IWGRP   0000020         write by group
              S_IXGRP   0000010         execute/search by group
              S_IROTH   0000004         read by others
              S_IWOTH   0000002         write by others
              S_IXOTH   0000001         execute/search by others

RETURN VALUE

       This  routine  returns  0  if the operation was successful or -1 if the
       operation failed. In the latter case, serrno is set appropriately.

ERRORS

       ENOENT       The named file/directory does  not  exist  or  is  a  null
                    pathname.

       EACCES       Search  permission  is  denied  on a component of the path
                    prefix.

       EFAULT       path or statbuf is a NULL pointer.

       EINVAL       The length of the guid component exceeds CA_MAXGUIDLEN  or
                    path and guid are both given and they point at a different
                    file.

       ENOTDIR      A component of path prefix is not a directory.

       ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length  of
                    a  path  component  exceeds CA_MAXNAMELEN or the length of
                    the sfn exceeds CA_MAXSFNLEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       ENSNACT      Name server is not running or is being shutdown.

SEE ALSO

       Castor_limits(4),    dpns_chdir(3),    dpns_chmod(3),    dpns_chown(3),
       dpns_creat(3)

AUTHOR

       LCG Grid Deployment Team