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

NAME

6       dpns_symlink  -  make  a  symbolic link to a file or a directory in the
7       DPNS Name Server
8

SYNOPSIS

10       #include <sys/types.h>
11       #include "dpns_api.h"
12
13       int dpns_symlink (const char *target, const char *linkname)
14

DESCRIPTION

16       dpns_symlink makes a symbolic link to a file or a directory in the DPNS
17       Name Server.
18
19       linkname
20              specifies  the  link name relative to the current DPNS directory
21              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       ENOENT       A component of linkname prefix does not exist.
29
30       EACCES       Search  permission  is  denied  on a component of linkname
31                    prefix or write permission on linkname parent directory is
32                    denied.
33
34       EFAULT       target or linkname is a NULL pointer.
35
36       EEXIST       linkname exists already.
37
38       ENOTDIR      A component of linkname prefix is not a directory.
39
40       ENOSPC       The name server database is full.
41
42       ENAMETOOLONG The  length of target or linkname exceeds CA_MAXPATHLEN or
43                    the length of a linkname component exceeds CA_MAXNAMELEN.
44
45       SENOSHOST    Host unknown.
46
47       SENOSSERV    Service unknown.
48
49       SECOMERR     Communication error.
50
51       SELOOP       Too many symbolic links encountered when parsing linkname.
52
53       ENSNACT      Name server is not running or is being shutdown.
54

SEE ALSO

56       Castor_limits(4),   dpns_chdir(3),   dpns_chmod(3),   dpns_readlink(3),
57       dpns_stat(3), dpns_statg(3), Cupvlist(1)
58

AUTHOR

60       LCG Grid Deployment Team
61
62
63
64DPNS                     $Date: 2004/06/28 09:18:05 $          DPNS_SYMLINK(3)