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  direc-
     tories, 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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|

SEE ALSO

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