opensolaris man page for remove

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)

SunOS 5.11							    14 Aug 2002 							remove(3C)