NAME

       dpns_rename - rename a DPNS file or directory in the name server

SYNOPSIS

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

       int dpns_rename (const char *oldpath, const char *newpath)

DESCRIPTION

       dpns_rename renames a DPNS file or directory in the name server.

       oldpath and newpath must be of the same type, i.e. both regular files or both directories.

       If newpath exists already, it will be removed before the rename takes place. If newpath is
       a directory, it must be empty.

       When renaming a directory, newpath must not be a descendant of oldpath, i.e.  newpath must
       not contain a path prefix that names oldpath.

       Write  permission is required on both parents. If oldpath is a directory, write permission
       is required on it and if newpath is  an  existing  directory,  write  permission  is  also
       required on it.

       If any of the parents has the sticky bit S_ISVTX set, either

              the effective user ID of the requestor must match the owner ID of the file or

              the effective user ID of the requestor must match the owner ID of the directory or

              the file must be writable by the requestor or

              the requestor must have ADMIN privilege in the Cupv database.

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       A component of oldpath prefix does not exist or oldpath or newpath is a  null
                    pathname.

       EACCES       Search  permission  is  denied  on  a component of the path prefixes or write
                    permission on the parent directories is denied or oldpath is a directory  and
                    write permission is denied on oldpath or newpath.

       EFAULT       oldpath or newpath is a NULL pointer.

       EEXIST       newpath  is  an existing directory and is not empty or newpath is an existing
                    file with replicas.

       ENOTDIR      A component of the path prefixes is not a directory or oldpath is a directory
                    and newpath is an existing regular file.

       EISDIR       newpath is a directory while oldpath is a regular file.

       EINVAL       newpath is a descendant of oldpath.

       ENAMETOOLONG The  length  of  oldpath  or newpath exceeds CA_MAXPATHLEN or the length of a
                    path component exceeds CA_MAXNAMELEN.

       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_unlink(3), Cupvlist(1)

AUTHOR

       LCG Grid Deployment Team