.TH ftp_remove 3 "January 2004" "Feep Networks" "C Library Calls"
.SH NAME
ftp_remove \- remove a file or directory on an FTP server
.SH SYNOPSIS
.B #include <libfget.h>

.BI "int ftp_remove(FTP *" ftp ", char *" path ");"
.SH VERSION
This man page documents version 1.3 of \fBlibfget\fP.
.SH DESCRIPTION
The \fBftp_remove\fP() function removes the file or directory specified
by \fIpath\fP on the FTP server associated with \fIftp\fP.

If \fIpath\fP specifies a directory, \fBftp_remove\fP(\fIpath\fP) is the
equivalent of \fBftp_rmdir\fP(\fIpath\fP).  If \fIpath\fP specifies a
file, \fBftp_remove\fP(\fIpath\fP) is the equivalent of
\fBftp_unlink\fP(\fIpath\fP).
.SH RETURN VALUE
The \fBftp_remove\fP() function returns 0 on success, or -1 on error
(and sets \fIerrno\fP).
.SH ERRORS
The \fBftp_remove\fP() function may fail for any of the errors specified
for the underlying \fBftp_lstat\fP(3), \fBftp_rmdir\fP(3), or
\fBftp_unlink\fP(3) library calls.
.SH SEE ALSO
.BR libfget (3),
.BR ftp_rmdir (3),
.BR ftp_unlink (3),
.BR remove (3)