4.3BSD-UWisc/man/cat2/mkdir.2

MKDIR(2)            UNIX Programmer's Manual             MKDIR(2)



NAME
     mkdir - make a directory file

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

DESCRIPTION
     _M_k_d_i_r creates a new directory file with name _p_a_t_h.  The mode
     of the new file is initialized from _m_o_d_e.  (The protection
     part of the mode is modified by the process's mode mask; see
     _u_m_a_s_k(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 _u_m_a_s_k(2).

RETURN VALUE
     A 0 return value indicates success.  A -1 return value indi-
     cates an error, and an error code is stored in _e_r_r_n_o.

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

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

     [EINVAL]       The pathname contains a character with the
                    high-order bit set.

     [ENAMETOOLONG] A component of a pathname exceeded 255 char-
                    acters, or an entire path name exceeded 1023
                    characters.

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

     [EACCES]       Search permission is denied for a component
                    of the path prefix.

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

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

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



Printed 12/27/86         August 26, 1985                        1






MKDIR(2)            UNIX Programmer's Manual             MKDIR(2)



                    system.

     [EEXIST]       The named file exists.

     [ENOSPC]       The directory in which the entry for the new
                    directory is being placed cannot be extended
                    because there is no space left on the file
                    system containing the directory.

     [ENOSPC]       The new directory cannot be created because
                    there there is no space left on the file sys-
                    tem that will contain the directory.

     [ENOSPC]       There are no free inodes on the file system
                    on which the directory is being created.

     [EDQUOT]       The directory in which the entry for the new
                    directory is being placed cannot be extended
                    because the user's quota of disk blocks on
                    the file system containing the directory has
                    been exhausted.

     [EDQUOT]       The new directory cannot be created because
                    the user's quota of disk blocks on the file
                    system that will contain the directory has
                    been exhausted.

     [EDQUOT]       The user's quota of inodes on the file system
                    on which the directory is being created has
                    been exhausted.

     [EIO]          An I/O error occurred while making the direc-
                    tory entry or allocating the inode.

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

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

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













Printed 12/27/86         August 26, 1985                        2