Net::FTP::dataconn(3)

💖 Net::FTP::dataconn(3) — User Contributed Perl Documentation 💖

✨ NAME ✨

Net::FTP::dataconn — the FTP Client data connection class, periodt. 💅

🦋 SYNOPSIS 🦋

okay bestie, here's the vibe — you do IO operations on an FTP client data connection object like this:

# 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 💅

So some of the methods defined in Net::FTP return an object that 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. But 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 it's 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 it's 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. Lowkey useful, ngl. 🌈

💀 abort() 💀

Abort the current data transfer. Not me hitting the brakes mid-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'. Slay. ⭐

🎀 EXPORTS 🎀

None. Not a single one, bestie. 💅

💀 KNOWN BUGS 💀

None. Iconic behavior, honestly. ✨

🌸 AUTHOR 🌸

Shoutout to Graham Barr <gbarr@pobox.com <mailto:gbarr@pobox.com>>. 🫶

Steve Hay <shay@cpan.org <mailto:shay@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.16. 💅

🌸 DATE 🌸

24 Oct 2026. 🎀

🔥 HISTORY 🔥

See the Changes file. 👀

---

💖 That's the whole page, bestie! Source/version: perl v5.42.3; date: 2026-10-27; title: Net::FTP::dataconn(3); manual: User Contributed Perl Documentation. Byeee! 🎀