Net::FTP::dataconn - phpMan

NAME
    Net::FTP::dataconn - FTP Client data connection class

SYNOPSIS
        # Perform IO operations on an FTP client data connection object:

        $num_bytes_read = $obj->read($buffer, $size);
        $num_bytes_read = $obj->read($buffer, $size, $timeout);

        $num_bytes_written = $obj->write($buffer, $size);
        $num_bytes_written = $obj->write($buffer, $size, $timeout);

        $num_bytes_read_so_far = $obj->bytes_read();

        $obj->abort();

        $closed_successfully = $obj->close();

DESCRIPTION
    Some of the methods defined in "Net::FTP" return an object which will be
    derived from this class. The dataconn class itself is derived from the
    "IO::Socket::INET" class, so any normal IO operations can be performed.
    However the following methods are defined in the dataconn class and IO
    should be performed using these.

    "read($buffer, $size[, $timeout])"
        Read $size bytes of data from the server and place it into $buffer,
        also performing any <CRLF> translation necessary. $timeout is
        optional, if not given, the timeout value from the command
        connection will be used.

        Returns the number of bytes read before any <CRLF> translation.

    "write($buffer, $size[, $timeout])"
        Write $size bytes of data from $buffer to the server, also
        performing any <CRLF> translation necessary. $timeout is optional,
        if not given, the timeout value from the command connection will be
        used.

        Returns the number of bytes written before any <CRLF> translation.

    "bytes_read()"
        Returns the number of bytes read so far.

    "abort()"
        Abort the current data transfer.

    "close()"
        Close the data connection and get a response from the FTP server.
        Returns *true* if the connection was closed successfully and the
        first digit of the response from the server was a '2'.

EXPORTS
    *None*.

KNOWN BUGS
    *None*.

AUTHOR
    Graham Barr <gbarr AT pobox.com <mailto:gbarr AT pobox.com>>.

    Steve Hay <shay AT cpan.org <mailto:shay AT cpan.org>> is now maintaining
    libnet as of version 1.22_02.

COPYRIGHT
    Copyright (C) 1997-2010 Graham Barr. All rights reserved.

    Copyright (C) 2013-2014, 2020 Steve Hay. All rights reserved.

LICENCE
    This module is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself, i.e. under the terms of either the
    GNU General Public License or the Artistic License, as specified in the
    LICENCE file.

VERSION
    Version 3.13

DATE
    23 Dec 2020

HISTORY
    See the Changes file.