RMDIR
Section: System Calls (2)
Index
Return to Main Contents
BSD mandoc
BSD 4.2
NAME
rmdir
- remove a directory file
SYNOPSIS
Fd #include <unistd.h>
Ft int
Fn rmdir const char *path
DESCRIPTION
Fn Rmdir
removes a directory file
whose name is given by
Fa path .
The directory must not have any entries other
than
`.'
and
`..'
RETURN VALUES
A 0 is returned if the remove succeeds; otherwise a -1 is
returned and an error code is stored in the global location
errno
ERRORS
The named file is removed unless:
- Bq Er ENOTDIR
-
A component of the path is not a directory.
- Bq Er ENAMETOOLONG
-
A component of a pathname exceeded
{NAME_MAX}
characters, or an entire path name exceeded
{PATH_MAX}
characters.
- Bq Er ENOENT
-
The named directory does not exist.
- Bq Er ELOOP
-
Too many symbolic links were encountered in translating the pathname.
- Bq Er ENOTEMPTY
-
The named directory contains files other than
`.'
and
`..'
in it.
- Bq Er EACCES
-
Search permission is denied for a component of the path prefix.
- Bq Er EACCES
-
Write permission is denied on the directory containing the link
to be removed.
- Bq Er EPERM
-
The directory containing the directory to be removed is marked sticky,
and neither the containing directory nor the directory to be removed
are owned by the effective user ID.
- Bq Er EBUSY
-
The directory to be removed is the mount point
for a mounted file system.
- Bq Er EIO
-
An I/O error occurred while deleting the directory entry
or deallocating the inode.
- Bq Er EROFS
-
The directory entry to be removed resides on a read-only file system.
- Bq Er EFAULT
-
Fa Path
points outside the process's allocated address space.
SEE ALSO
mkdir(2),
unlink(2)
HISTORY
The
Fn rmdir
function call appeared in
BSD 4.2
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUES
-
- ERRORS
-
- SEE ALSO
-
- HISTORY
-
This document was created by
man2html,
using the manual pages.
Time: 19:41:55 GMT, December 25, 2022