1LFC_MKDIRG(3)                LFC Library Functions               LFC_MKDIRG(3)
2
3
4

NAME

6       lfc_mkdirg  -  create  a  new LFC directory in the name server with the
7       specified GUID
8

SYNOPSIS

10       #include <sys/types.h>
11       #include "lfc_api.h"
12
13       int lfc_mkdirg (const char *path, const char *guid, mode_t mode)
14

DESCRIPTION

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

RETURN VALUE

36       This  routine  returns  0  if the operation was successful or -1 if the
37       operation failed. In the latter case, serrno is set appropriately.
38

ERRORS

40       ENOENT       A component of path prefix does not exist  or  path  is  a
41                    null pathname.
42
43       EACCES       Search  permission  is  denied  on a component of the path
44                    prefix or write permission  on  the  parent  directory  is
45                    denied.
46
47       EFAULT       path is a NULL pointer.
48
49       EEXIST       path exists already.
50
51       EINVAL       The length of the guid exceeds CA_MAXGUIDLEN.
52
53       ENOTDIR      A component of path prefix is not a directory.
54
55       ENOSPC       The name server database is full.
56
57       ENAMETOOLONG The  length of path exceeds CA_MAXPATHLEN or the length of
58                    a path component exceeds CA_MAXNAMELEN.
59
60       SENOSHOST    Host unknown.
61
62       SENOSSERV    Service unknown.
63
64       SECOMERR     Communication error.
65
66       ENSNACT      Name server is not running or is being shutdown.
67

SEE ALSO

69       Castor_limits(4), lfc_chdir(3), lfc_chmod(3), lfc_umask(3)
70

AUTHOR

72       LCG Grid Deployment Team
73
74
75
76LFC                      $Date: 2005/02/01 07:12:45 $            LFC_MKDIRG(3)
Impressum