usr/src/share/man/man3f/unlink.3

.\" Copyright (c) 1983, 1993
.\"     The Regents of the University of California.  All rights reserved.
.\"
.\" This module is believed to contain source code proprietary to AT&T.
.\" Use and redistribution is subject to the Berkeley Software License
.\" Agreement and your Software Agreement with AT&T (Western Electric).
.\"
.\"     @(#)unlink.3    8.1 (Berkeley) 6/5/93
.\"
.TH UNLINK 3F "June 5, 1993"
.UC 5
.SH NAME
unlink \- remove a directory entry
.SH SYNOPSIS
.B integer function unlink (name)
.br
.B character*(*) name
.SH DESCRIPTION
.I Unlink
causes the directory entry specified by pathname
.I name
to be removed.
If this was the last link to the file, the contents of the file are lost.
The returned value will be zero if successful; a system error code otherwise.
.SH FILES
.ie \nM /usr/ucb/lib/libU77.a
.el /usr/lib/libU77.a
.SH "SEE ALSO"
unlink(2), link(3F), filsys(5), perror(3F)
.SH BUGS
Pathnames can be no longer than MAXPATHLEN as defined in
.RI < sys/param.h >.