ftp_read(3) C Library Calls ftp_read(3)NAMEftp_read - read from a file on an FTP server
SYNOPSIS
#include <libfget.h>
ssize_t ftp_read(FTPFILE *ftpfile, char *buf, size_t bufsize);
VERSION
This man page documents version 1.3 of libfget.
DESCRIPTION
The ftp_read() function reads at most bufsize bytes from the file asso‐
ciated with ftpfile and stores them in the buffer pointed to by buf.
RETURN VALUE
The ftp_read() function returns the number of characters read on suc‐
cess, or -1 on error (and sets errno).
ERRORS
The ftp_read() function fails if:
ECONNRESET
The server shut down the connection. The caller is then respon‐
sible for calling ftp_quit() with the FTP_QUIT_FAST flag set.
ETIMEDOUT
The operation timed out. (The timeout interval can be set via
the FTP_OPT_IO_TIMEOUT option; see the ftp_set_options(3) man
page for details.)
EINVAL Unexpected response code received from server.
EBADF ftpfile was not opened for reading.
It may also fail for any of the errors specified for the underlying
poll(2) or read(2) system calls.
SEE ALSOlibfget(3), ftp_open(3), read(2)Feep Networks January 2004 ftp_read(3)