REMOVE(3C) Standard C Library Functions REMOVE(3C)

NAME

remove - remove file

SYNOPSIS

#include <stdio.h>

int remove(const char *path);

DESCRIPTION

The remove() function causes the file or empty directory whose name is
the string pointed to by path to be no longer accessible by that name. A
subsequent attempt to open that file using that name will fail, unless
the file is created anew.


For files, remove() is identical to unlink(). For directories, remove()
is identical to rmdir().


See rmdir(2) and unlink(2) for a detailed list of failure conditions.

RETURN VALUES

Upon successful completion, remove() returns 0. Otherwise, it returns -1
and sets errno to indicate an error.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

rmdir(2), unlink(2), attributes(7), standards(7)

August 14, 2002 REMOVE(3C)