about summary refs log tree commit
diff options
context:
space:
mode:
authorGraham Barr <gbarr@pobox.com>2007-02-08 03:17:02 +0000
committerGraham Barr <gbarr@pobox.com>2009-02-24 10:40:47 -0600
commit5487a9ff31f4983168a32116e459ce3660ae4110 (patch)
tree800cde8b6c3f4046ecb898c25184607efd4d5c7a
parent70e421ec95675874bad826b173dfb900f53834c4 (diff)
downloadperl-libnet-5487a9ff31f4983168a32116e459ce3660ae4110.tar.gz
Doc update
-rw-r--r--Net/FTP.pm16
1 files changed, 12 insertions, 4 deletions
diff --git a/Net/FTP.pm b/Net/FTP.pm
index a51b205..2ca94c1 100644
--- a/Net/FTP.pm
+++ b/Net/FTP.pm
@@ -1342,10 +1342,18 @@ B<Timeout> - Set a timeout value (defaults to 120)
 
 B<Debug> - debug level (see the debug method in L<Net::Cmd>)
 
-B<Passive> - If set to a non-zero value then all data transfers will be done
-using passive mode. This is not usually required except for some I<dumb>
-servers, and some firewall configurations. This can also be set by the
-environment variable C<FTP_PASSIVE>.
+B<Passive> - If set to a non-zero value then all data transfers will
+be done using passive mode. If set to zero then data transfers will be
+done using active mode.  If the machine is connected to the Internet
+directly, both passive and active mode should work equally well.
+Behind most firewall and NAT configurations passive mode has a better
+chance of working.  However, in some rare firewall configurations,
+active mode actually works when passive mode doesn't.  Some really old
+FTP servers might not implement passive transfers.  If not specified,
+then the transfer mode is set by the environment variable
+C<FTP_PASSIVE> or if that one is not set by the settings done by the
+F<libnetcfg> utility.  If none of these apply then passive mode is
+used.
 
 B<Hash> - If given a reference to a file handle (e.g., C<\*STDERR>),
 print hash marks (#) on that filehandle every 1024 bytes.  This