1DPNS_RENAME(3)              DPNS Library Functions              DPNS_RENAME(3)
2
3
4

NAME

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

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpns_api.h"
11
12       int dpns_rename (const char *oldpath, const char *newpath)
13

DESCRIPTION

15       dpns_rename renames a DPNS file or directory in the name server.
16
17       oldpath  and  newpath must be of the same type, i.e. both regular files
18       or both directories.
19
20       If newpath exists already, it will be removed before the  rename  takes
21       place. If newpath is a directory, it must be empty.
22
23       When renaming a directory, newpath must not be a descendant of oldpath,
24       i.e.  newpath must not contain a path prefix that names oldpath.
25
26       Write permission is required on both parents. If oldpath  is  a  direc‐
27       tory,  write permission is required on it and if newpath is an existing
28       directory, write permission is also required on it.
29
30       If any of the parents has the sticky bit S_ISVTX set, either
31
32              the effective user ID of the requestor must match the  owner  ID
33              of the file or
34
35              the  effective  user ID of the requestor must match the owner ID
36              of the directory or
37
38              the file must be writable by the requestor or
39
40              the requestor must have ADMIN privilege in the Cupv database.
41

RETURN VALUE

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

ERRORS

47       ENOENT       A component of oldpath prefix does not exist or oldpath or
48                    newpath is a null pathname.
49
50       EACCES       Search permission is denied on a  component  of  the  path
51                    prefixes  or write permission on the parent directories is
52                    denied or oldpath is a directory and write  permission  is
53                    denied on oldpath or newpath.
54
55       EFAULT       oldpath or newpath is a NULL pointer.
56
57       EEXIST       newpath  is an existing directory and is not empty or new‐
58                    path is an existing file with replicas.
59
60       ENOTDIR      A component of the path prefixes is  not  a  directory  or
61                    oldpath  is a directory and newpath is an existing regular
62                    file.
63
64       EISDIR       newpath is a directory while oldpath is a regular file.
65
66       EINVAL       newpath is a descendant of oldpath.
67
68       ENAMETOOLONG The length of oldpath or newpath exceeds CA_MAXPATHLEN  or
69                    the length of a path component exceeds CA_MAXNAMELEN.
70
71       SENOSHOST    Host unknown.
72
73       SENOSSERV    Service unknown.
74
75       SECOMERR     Communication error.
76
77       ENSNACT      Name server is not running or is being shutdown.
78

SEE ALSO

80       Castor_limits(4),    dpns_chdir(3),    dpns_chmod(3),   dpns_unlink(3),
81       Cupvlist(1)
82

AUTHOR

84       LCG Grid Deployment Team
85
86
87
88DPNS                     $Date: 2005/06/30 08:34:03 $           DPNS_RENAME(3)
Impressum