DragonFly On-Line Manual Pages

ftp_read(3)                     C Library Calls                    ftp_read(3)

NAME
       ftp_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
       associated 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
       success, 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
              responsible 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 ALSO
       libfget(3), ftp_open(3), read(2)

Feep Networks                    January 2004                      ftp_read(3)