Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > R


HP-UX 11i Version 3: February 2007

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index


rmdir() — remove a directory file


#include <unistd.h>

int rmdir(const char *path);


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.


rmdir() returns the following values:


Successful completion.


Failure. errno is set to indicate the error.


If rmdir() fails, errno is set to one of the following values.


A component of the path prefix denies search permission.


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


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


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


The path is the current working directory.


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


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


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


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.


The named file does not exist.


A component of the path is not a directory.


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.


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


rmdir() was developed by the University of California, Berkeley and HP.


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

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.