dosmkdir

Purpose

     Creates a directory.

Library

     DOS Services Library (libdos.a)

Syntax

     #include <dos.h>

     int dosmkdir (path)
     char *path;

Description

     The  dosmkdir subroutine  creates a  directory using  the
     path specified by the  path parameter.  All components of
     the path parameter except the last component must already
     exist.

     If  creating an  AIX directory,  the dosmkdir  subroutine
     forks  and executes  the  AIX  /bin/mkdir command,  which
     creates  the  directory.  This  is  done  because only  a
     process with an effective user ID of superuser can create
     an AIX directory.

Return Value

     Upon successful completion, a value of 0 is returned.  If
     the dosmkdir subroutine fails,  then it returns a nonzero
     value and sets doserrno to indicate the error.

     Certain failures of the mkdir command also cause an error
     message to be written to the standard error output.

Related Information

     In this book:  "DOS services library" and "dosrmdir."

     The mkdir command in AIX Operating System Commands Refer-
     ence.