xref: /original-bsd/lib/libc/stdio/remove.3 (revision c3e32dec)
1.\" Copyright (c) 1990, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" Chris Torek and the American National Standards Committee X3,
6.\" on Information Processing Systems.
7.\"
8.\" %sccs.include.redist.man%
9.\"
10.\"     @(#)remove.3	8.1 (Berkeley) 06/04/93
11.\"
12.Dd
13.Dt REMOVE 3
14.Os
15.Sh NAME
16.Nm remove
17.Nd remove directory entry
18.Sh SYNOPSIS
19.Fd #include <stdio.h>
20.Ft int
21.Fn remove "const char *path"
22.Sh DESCRIPTION
23The
24.Fn remove
25function
26is an alias for the
27.Xr unlink 2
28system call.
29It deletes the file referenced by
30.Fa path .
31.Sh RETURN VALUES
32Upon successful completion,
33.Fn remove
34returns 0.
35Otherwise, \-1 is returned and the global variable
36.Va errno
37is set to indicate the error.
38.Sh ERRORS
39The
40.Fn remove
41function
42may fail and set
43.Va errno
44for any of the errors specified for the routine
45.Xr unlink 2 .
46.Sh SEE ALSO
47.Xr unlink 2
48.Sh STANDARDS
49The
50.Fn remove
51function conforms to
52.St -ansiC .
53