'\" te
.\"  Copyright 1989 AT&T  Copyright (c) 2002, Sun Microsystems, Inc.  All Rights Reserved
.TH remove 3C "14 Aug 2002" "SunOS 5.11" "Standard C Library Functions"
.SH NAME
remove \- remove file
.SH SYNOPSIS
.LP
.nf
#include <stdio.h>

\fBint\fR \fBremove\fR(\fBconst char *\fR\fIpath\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBremove()\fR function causes the file or empty directory whose name is the string pointed to by \fIpath\fR 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.
.sp
.LP
For files, \fBremove()\fR is identical to  \fBunlink()\fR. For directories, \fBremove()\fR is identical to \fBrmdir()\fR.
.sp
.LP
See \fBrmdir\fR(2) and \fBunlink\fR(2) for a detailed list of failure conditions.
.SH RETURN VALUES
.sp
.LP
Upon successful completion, \fBremove()\fR returns \fB0\fR. Otherwise, it returns \fB\(mi1\fR and sets \fBerrno\fR to indicate an error.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelMT-Safe
_
StandardSee \fBstandards\fR(5).
.TE

.SH SEE ALSO
.sp
.LP
\fBrmdir\fR(2), \fBunlink\fR(2), \fBattributes\fR(5), \fBstandards\fR(5)