*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> rmdir (2)              


 rmdir(2)                                                           rmdir(2)

 NAME    [Toc]    [Back]
      rmdir() - remove a directory file

 SYNOPSIS    [Toc]    [Back]
      #include <unistd.h>

      int rmdir(const char *path);

 DESCRIPTION    [Toc]    [Back]
      The rmdir() system call removes a directory file whose name is given
      by path.  The directory must be empty (except for the files .  and ..)
      before it can be removed.

 RETURN VALUE    [Toc]    [Back]
      rmdir() returns the following values:

            0   Successful completion.
           -1   Failure.  errno is set to indicate the error.

 ERRORS    [Toc]    [Back]
      If rmdir() fails, errno is set to one of the following values.

           [EACCES]       A component of the path prefix denies search

           [EACCES]       Write permission is denied on the directory
                          containing the link to be removed.

           [EACCES]       The process does not have read/write access
                          permission to the parent directory.

           [EBUSY]        The directory to be removed is the mount point for
                          a mounted file system.

           [EBUSY]        The path is the current working directory.

           [EEXIST]       The named directory is not empty.  It contains
                          files other than .  and ...

           [EFAULT]       path points outside the process's allocated
                          address space.  The reliable detection of this
                          error is implementation-dependent.

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

           [ENAMETOOLONG] The length of the specified path name exceeds
                          PATH_MAX bytes, or the length of a component of
                          the path name exceeds NAME_MAX bytes while
                          _POSIX_NO_TRUNC is in effect.

 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003

 rmdir(2)                                                           rmdir(2)

           [ENOENT]       The named file does not exist.

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

           [EPERM]        The directory containing the directory to be
                          removed has the sticky bit set and neither the
                          containing directory nor the directory to be
                          removed are owned by the effective user ID.

           [EROFS]        The directory entry to be removed resides on a
                          read-only file system.

 AUTHOR    [Toc]    [Back]
      rmdir() was developed by the University of California, Berkeley and

 SEE ALSO    [Toc]    [Back]
      mkdir(2), unlink(2), remove(3C).

      rmdir(): AES, SVID2, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.1

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
VOP_RMDIR FreeBSD remove a file or directory
VOP_REMOVE FreeBSD remove a file or directory
remove OpenBSD remove a file or directory
unlink HP-UX remove directory entry; delete file
efi_rmdir HP-UX remove an EFI directory
rmdir IRIX remove a directory
remove NetBSD remove directory entry
rm FreeBSD remove directory entries
unlink FreeBSD remove directory entries
unlink NetBSD remove directory entry
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service