NAME

       rfio_mkdir - create a new directory

SYNOPSIS

       #include <sys/types.h>
       #include "rfio_api.h"

       int rfio_mkdir (const char *path, mode_t mode);

DESCRIPTION

       rfio_mkdir creates a new directory.

       An  entry  is  created and the directory's owner ID is set to the effective user ID of the
       requestor.  The group ID of the directory  is  set  to  the  effective  group  ID  of  the
       requestor.

       path   specifies  the  logical  pathname  relative  to  the  current directory or the full
              pathname.

RETURN VALUE

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

ERRORS

       ENOENT       A component of path prefix does not exist or path is a null pathname.

       EACCES       Search  permission  is  denied  on  a  component  of the path prefix or write
                    permission on the parent directory is denied.

       EFAULT       path is a NULL pointer.

       EEXIST       path exists already.

       ENOTDIR      A component of path prefix is not a directory.

       ENOSPC       No space to store the new directory.

       ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length of  a  path  component
                    exceeds CA_MAXNAMELEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

SEE ALSO

       Castor_limits(4), rfio_chmod(3)

AUTHOR

       LCG Grid Deployment Team