dosrmdir

Purpose

     Removes a DOS Services directory.

Library

     DOS Services Library (libdos.a)

Syntax

     #include <dos.h>

     int dosrmdir (path)
     char *path;

Description

     The dosrmdir  subroutine removes the  directory specified
     by the path parameter.  A  directory must be empty before
     it can  be removed.  To  remove a directory,  the current
     process must  have write access permission  to the direc-
     tory and to its parent directory.

     If an AIX  directory is to be removed,  the dosrmdir sub-
     routine forks  and executes  the AIX  /bin/rmdir command,
     which removes the directory.  This is done because only a
     process with an effective user ID of superuser can remove
     an AIX directory.

Return Value

     Upon successful completion, a value of 0 is returned.  If
     the dosrmdir subroutine fails, it returns a nonzero value
     and sets  doserrno to indicate the  error.  Certain fail-
     ures of the rmdir command  also cause an error message to
     be written to the standard error output.

Related Information

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

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