REMOVE(3)                 OpenBSD Programmer's Manual                REMOVE(3)

NAME
     remove - remove a file or directory



SYNOPSIS
     #include <stdio.h>

     int
     remove(const char *path);

DESCRIPTION
     The remove() function removes the file or directory specified by path.

     If path specifies a directory, remove(path) is the equivalent of
     rmdir(path).  Otherwise, it is the equivalent of unlink(path).

RETURN VALUES
     Upon successful completion, remove() returns 0.  Otherwise, -1 is re-
     turned and the global variable errno is set to indicate the error.

ERRORS
     The remove() function may fail and set errno for any of the errors speci-
     fied for the routines rmdir(2) or unlink(2).

SEE ALSO
     rmdir(2),  unlink(2)

STANDARDS
     The remove() function conforms to ANSI X3.159-1989 (``ANSI C'') and
     X/Open Portability Guide Issue 4.2 (``XPG4.2'').

OpenBSD 2.6                     October 7, 1997                              1