REMOVE(3) NEWLIB 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 ALSOremove is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 REMOVE(3)
