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

NAME

6       dpns_mkdir - create a new DPNS directory in the name server
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpns_api.h"
11
12       int dpns_mkdir (const char *path, mode_t mode)
13

DESCRIPTION

15       dpns_mkdir creates a new DPNS directory in the name server.
16
17       An  entry  is  created  in the name server database and the directory's
18       owner ID is set to the effective user ID of the requestor.   The  group
19       ID  of  the directory is set to the effective group ID of the requestor
20       or is taken from the parent directory if the latter has the S_ISGID bit
21       set.
22
23       The  access permission bits for the directory are taken from mode, then
24       all bits set in the requestor's file mode  creation  mask  are  cleared
25       (see  dpns_umask(3)).   The  S_ISGID,  S_ISUID  and  S_ISVTX  bits  are
26       silently cleared.
27
28       path   specifies the logical pathname  relative  to  the  current  DPNS
29              directory or the full DPNS pathname.
30

RETURN VALUE

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

ERRORS

36       ENOENT       A component of path prefix does not exist  or  path  is  a
37                    null pathname.
38
39       EACCES       Search  permission  is  denied  on a component of the path
40                    prefix or write permission  on  the  parent  directory  is
41                    denied.
42
43       EFAULT       path is a NULL pointer.
44
45       EEXIST       path exists already.
46
47       ENOTDIR      A component of path prefix is not a directory.
48
49       ENOSPC       The name server database is full.
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_chmod(3), dpns_umask(3)
64

AUTHOR

66       LCG Grid Deployment Team
67
68
69
70DPNS                     $Date: 2001/10/04 12:12:45 $            DPNS_MKDIR(3)
Impressum