NAME

       gfs_mkdir - create a directory

SYNOPSIS

       #include <gfarm/gfarm.h>

       char *gfs_mkdir (char * gfarm_url, gfarm_mode_t mode);

DESCRIPTION

       gfs_mkdir() attempts to create a directory named gfarm_url.

       mode  speficies  the  permissions  to  use.   It is modified by the process's umask in the usual way: the
       permissions of the created file are (mode & ~umask).

RETURN VALUES

       NULL   The function terminated successfully.

       GFARM_ERR_NO_MEMORY
              Insufficient memory was available.

       GFARM_ERR_ALREADY_EXISTS
              gfarm_url already exists (not necessarily as a directory).  This includes the case where gfarm_url
              is a symbolic link, dangling or not.

       GFARM_ERR_NO_SUCH_OBJECT
              The parent directory of gfarm_url does not exist.

       GFARM_ERR_NOT_A_DIRECTORY
              A component of the path prefix is not a directory.

       Others An error except the above occurred.  The reason is shown by its pointed strings.

Gfarm                                           13 November 2006                                    GFS_MKDIR(3)