REMOVE(3)

NAME
4.51 `remove'--delete a file's name

SYNOPSIS
     #include <stdio.h>
     int remove(char *FILENAME);
     int _remove_r(struct _reent *REENT, char *FILENAME);

DESCRIPTION
Use `remove' to dissolve the association between a particular filename (the string at FILENAME) and the file it represents. After calling `remove' with a particular filename, you will no longer be able to open the file by that name.
   In this implementation, you may use `remove' on an open file without error; existing file descriptors for the file will continue to access the file's data until the program using them closes the file.
   The alternate function `_remove_r' is a reentrant version. The extra argument REENT is a pointer to a reentrancy structure.

RETURNS
`remove' returns `0' if it succeeds, `-1' if it fails.

PORTABILITY
ANSI C requires `remove', but only specifies that the result on failure be nonzero. The behavior of `remove' when you call it on an open file may vary among implementations.
   Supporting OS subroutine required: `unlink'.

SEE ALSO
remove is part of the library. The full documentation for is maintained as a Texinfo manual. If info and are properly installed at your site, the command

    info

will give you access to the complete manual.