'\"macro stdmacro
.if n .pH g3c.remove @(#)remove	40.9 of 10/10/89
.\" Copyright 1989 AT&T
'\" ident	"@(#)svid_ba:ba_os/remove	1.13"
.nr X
.if \nX=0 .ds x} remove 3C "" "\&"
.if \nX=1 .ds x} remove 3C ""
.if \nX=2 .ds x} remove 3C "" "\&"
.if \nX=3 .ds x} remove "" "" "\&"
.TH \*(x}
.SH NAME
\f4remove\f1 \- remove file
.SH SYNOPSIS
.nf
.ft 4
#include <stdio.h>
.sp 0.5v
int remove(const char *path);
.fi
.ft 1
.SH DESCRIPTION
\f4remove\f1 causes the file or
empty directory whose name is the string pointed
to by \f2path\f1 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.
.P
For files, \f4remove\f1 is identical to 
\f4unlink\f1. For directories,
\f4remove\f1 is identical to \f4rmdir\f1.
.PP
See \f4rmdir\fP(2) and \f4unlink\fP(2) for a detailed list of failure conditions.
.SH "SEE ALSO"
\f4rmdir\fP(2),
\f4unlink\fP(2).
.SH RETURN VALUE 
.P
Upon successful completion, \f4remove\f1
returns a value of \f40\f1; otherwise, it returns a value of 
\f4\-1\f1 and sets \f4errno\f1 to indicate an error.
