


      MMMMKKKKDDDDIIIIRRRR((((2222))))                    ((((bbbbssssdddd 4444....2222))))                    MMMMKKKKDDDDIIIIRRRR((((2222))))



      NNNNAAAAMMMMEEEE
           mkdir - make a directory file

      SSSSYYYYNNNNTTTTAAAAXXXX
           mmmmkkkkddddiiiirrrr((((ppppaaaatttthhhh,,,, mmmmooooddddeeee))))
           cccchhhhaaaarrrr ****ppppaaaatttthhhh;;;;
           iiiinnnntttt mmmmooooddddeeee;;;;

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           _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).

      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
           A 0 return value indicates success.  A ``-1'' return value
           indicates an error, and an error code is stored in _e_r_r_n_o.

      EEEERRRRRRRROOOORRRRSSSS
           _M_k_d_i_r 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]       _P_a_t_h points outside the process's allocated
                          address space.

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

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           chmod(2), stat(2), umask(2)




      Page 1                                                   (9010-E)






      MMMMKKKKDDDDIIIIRRRR((((2222))))                    ((((bbbbssssdddd 4444....2222))))                    MMMMKKKKDDDDIIIIRRRR((((2222))))























































      Page 2                                                   (9010-E)






