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(5) for descriptions of the following attributes:


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

SEE ALSO


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


August 14, 2002 REMOVE(3C)