


      MKDIR(2)                    (bsd 4.2)                    MKDIR(2)



      NAME
           mkdir - make a directory file

      SYNTAX
           mkdir(path, mode)
           char *path;
           int mode;

      DESCRIPTION
           Mkdir creates a new directory file with name path.  The mode
           of the new file is initialized from mode.  (The protection
           part of the mode is modified by the process's mode mask; see
           umask(2)).

           The directory's owner ID is set to the process's effective
           user ID.  The directory's group ID is set to that of the
           parent directory in which it is created.

           The low-order 9 bits of mode are modified by the process's
           file mode creation mask: all bits set in the process's file
           mode creation mask are cleared.  See umask(2).

      RETURN VALUE
           A 0 return value indicates success.  A ``-1'' return value
           indicates an error, and an error code is stored in errno.

      ERRORS
           Mkdir will fail and no directory will be created if:

           [EPERM]        The process's effective user ID is not
                          super-user.

           [ENOTDIR]      A component of the path prefix is not a
                          directory.

           [ENOENT]       A component of the path prefix does not
                          exist.

           [EROFS]        The named file resides on a read-only file
                          system.

           [EEXIST]       The named file exists.

           [EFAULT]       Path points outside the process's allocated
                          address space.

           [EIO]          An I/O error occured while writing to the
                          file system.

      SEE ALSO
           chmod(2), stat(2), umask(2)




      Page 1                                         (73 A2 02MTA REV1)






      MKDIR(2)                    (bsd 4.2)                    MKDIR(2)























































      Page 2                                         (73 A2 02MTA REV1)






