xref: /csrg-svn/lib/libc/stdio/remove.3 (revision 61180)
1*61180Sbostic.\" Copyright (c) 1990, 1991, 1993
2*61180Sbostic.\"	The Regents of the University of California.  All rights reserved.
347015Sbostic.\"
447015Sbostic.\" This code is derived from software contributed to Berkeley by
550318Sbostic.\" Chris Torek and the American National Standards Committee X3,
650318Sbostic.\" on Information Processing Systems.
750318Sbostic.\"
847015Sbostic.\" %sccs.include.redist.man%
947015Sbostic.\"
10*61180Sbostic.\"     @(#)remove.3	8.1 (Berkeley) 06/04/93
1147015Sbostic.\"
1248351Scael.Dd
1348351Scael.Dt REMOVE 3
1448351Scael.Os
1548351Scael.Sh NAME
1648351Scael.Nm remove
1748351Scael.Nd remove directory entry
1848351Scael.Sh SYNOPSIS
1948351Scael.Fd #include <stdio.h>
2048351Scael.Ft int
2148351Scael.Fn remove "const char *path"
2248351Scael.Sh DESCRIPTION
2348351ScaelThe
2448351Scael.Fn remove
2548351Scaelfunction
2647015Sbosticis an alias for the
2748351Scael.Xr unlink 2
2847015Sbosticsystem call.
2947015SbosticIt deletes the file referenced by
3048351Scael.Fa path .
3148351Scael.Sh RETURN VALUES
3247015SbosticUpon successful completion,
3348351Scael.Fn remove
3447015Sbosticreturns 0.
3547015SbosticOtherwise, \-1 is returned and the global variable
3648351Scael.Va errno
3747015Sbosticis set to indicate the error.
3848351Scael.Sh ERRORS
3948351ScaelThe
4048351Scael.Fn remove
4148351Scaelfunction
4247015Sbosticmay fail and set
4348351Scael.Va errno
4447015Sbosticfor any of the errors specified for the routine
4548351Scael.Xr unlink 2 .
4648351Scael.Sh SEE ALSO
4748351Scael.Xr unlink 2
4848351Scael.Sh STANDARDS
4947015SbosticThe
5048351Scael.Fn remove
5148351Scaelfunction conforms to
5248351Scael.St -ansiC .
53