mkdir(2)                                                 mkdir(2)



     NAME
          mkdir - make a directory file

     SYNOPSIS
          int 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 newly-created directory will contain entries for . and
          ...

          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 indi-
          cates an error, and an error code is stored in errno.

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

          [EEXIST]     The named file exists.

          [EFAULT]     path points outside the process's allocated ad-
                       dress space.

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

          [ELOOP]      Too many symbolic links were encountered in
                       translating a pathname.

          [ENAMETOOLONG]
                       A component of a pathname exceeded NAME_MAX
                       characters, or an entire pathname exceeded
                       PATH_MAX.

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

          [ENOTDIR]    A component of the path prefix is not a direc-
                       tory.



     April, 1990                                                     1

     mkdir(2)                                                 mkdir(2)



          [EPERM]      The path argument contains a byte with the
                       high-order bit set.

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

     SEE ALSO
          mkdir(1), chmod(2), rmdir(2), stat(2), umask(2).















































     2                                                     April, 1990