.TH ftp_realpath 3 "January 2004" "Feep Networks" "C Library Calls"
.SH NAME
ftp_realpath \- determine the true path of a file from an FTP server
.SH SYNOPSIS
.B #include <libfget.h>

.BI "int ftp_realpath(FTP *" ftp ", char *" path ","
.BI "char *" resolved_path ", size_t " resolvelen ");"
.SH VERSION
This man page documents version 1.3 of \fBlibfget\fP.
.SH DESCRIPTION
The \fBftp_realpath\fP() function finds the true path of the file specified
by \fIpath\fP from the FTP server associated with \fIftp\fP by expanding all
symbolic links which are components of the path.
.SH RETURN VALUE
The \fBftp_realpath\fP() function returns 0 on success, or -1 on error
(and sets \fIerrno\fP).
.SH ERRORS
The \fBftp_realpath\fP() function fails if:
.TP
.B ELOOP
Too many symlinks were traversed.
.PP
It may also fail for any of the errors specified for the underlying
\fBftp_lstat\fP(3) or \fBftp_readlink\fP(3) library calls.
.SH SEE ALSO
.BR libfget (3),
.BR realpath (3)