mkdir(2)                                                 mkdir(2)



     NAME
          mkdir - make a directory file

     SYNOPSIS
          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.

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

          [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.

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




     Page 1                                        (last mod. 1/14/87)

     mkdir(2)                                                 mkdir(2)



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

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


















































     Page 2                                        (last mod. 1/14/87)