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

NAME

6       dpns_undelete - recover a logically deleted DPNS file entry in the name
7       server
8

SYNOPSIS

10       #include <sys/types.h>
11       #include "dpns_api.h"
12
13       int dpns_undelete (const char *path)
14

DESCRIPTION

16       dpns_undelete  recovers  a  DPNS  file  entry  logically   deleted   by
17       dpns_delete.  This can be done as long as a the reclaim utility has not
18       been run on the corresponding tape volume.
19
20       path   specifies the logical pathname  relative  to  the  current  DPNS
21              directory or the full DPNS pathname.
22

RETURN VALUE

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

ERRORS

28       EPERM        path is a directory.
29
30       ENOENT       The named file does not exist or is a null pathname.
31
32       EACCES       Search permission is denied on a  component  of  the  path
33                    prefix  or write permission is denied on the parent direc‐
34                    tory or the parent has the sticky bit S_ISVTX set and
35
36                      the effective user ID of the requestor  does  not  match
37                      the owner ID of the file and
38
39                      the  effective  user  ID of the requestor does not match
40                      the owner ID of the directory and
41
42                      the file is not writable by the requestor and
43
44                      the requestor does not have ADMIN privilege in the  Cupv
45                      database.
46
47       EFAULT       path is a NULL pointer.
48
49       ENOTDIR      A component of path prefix is not a directory.
50
51       ENAMETOOLONG The  length of path exceeds CA_MAXPATHLEN or the length of
52                    a path component exceeds CA_MAXNAMELEN.
53
54       SENOSHOST    Host unknown.
55
56       SENOSSERV    Service unknown.
57
58       SECOMERR     Communication error.
59
60       ENSNACT      Name server is not running or is being shutdown.
61

SEE ALSO

63       Castor_limits(4), dpns_chdir(3), dpns_delete(3), Cupvlist(1)
64

AUTHOR

66       LCG Grid Deployment Team
67
68
69
70DPNS                     $Date: 2002/10/16 06:25:40 $         DPNS_UNDELETE(3)