Removes a directory file.

    Format

      #include  <unistd.h>

      int rmdir  (const char *path);

1 - Argument

 path

    A directory pathname.

2 - Description

    The rmdir function removes a directory file whose name is
    specified in the path argument. The directory is removed only
    if it is empty.

    If path names a symbolic link, then rmdir fails and sets errno to
    ENOTDIR.

3 - Restriction

    When using OpenVMS format names, the path argument must be in the
    form directory.dir.

4 - Return Values

    0                  Indicates success.
    -1                 An error occurred; errno is set to indicate
                       the error.