summaryrefslogtreecommitdiffstats
path: root/lib/libfetch/fetch.3
diff options
context:
space:
mode:
authornjl <njl@FreeBSD.org>2007-04-22 22:33:29 +0000
committernjl <njl@FreeBSD.org>2007-04-22 22:33:29 +0000
commita22d768e0f5024d4990559f51e5455f257b3570a (patch)
treef006c880f3cf9fdbcc8a2d241c97a04f1df75ce0 /lib/libfetch/fetch.3
parent328ad8c39b7fe076c817f11235241bfd1a53e8ba (diff)
downloadFreeBSD-src-a22d768e0f5024d4990559f51e5455f257b3570a.zip
FreeBSD-src-a22d768e0f5024d4990559f51e5455f257b3570a.tar.gz
Add back the original behavior of changing the entire directory path at
once (CWD a/b/c vs. 3 CWDs). If an error occurs, we fall back to the default method of a single CWD per directory element. Since this is technically a violation of the basic FTP RFC, this behavior is under a compile-time option FTP_COMBINE_CWDS and is off by default. It should work with most Unix-based FTP daemons and can save latency. MFC after: 2 weeks
Diffstat (limited to 'lib/libfetch/fetch.3')
-rw-r--r--lib/libfetch/fetch.312
1 files changed, 11 insertions, 1 deletions
diff --git a/lib/libfetch/fetch.3 b/lib/libfetch/fetch.3
index 4c399b7..b145bb0 100644
--- a/lib/libfetch/fetch.3
+++ b/lib/libfetch/fetch.3
@@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd July 1, 1998
+.Dd April 22, 2007
.Dt FETCH 3
.Os
.Sh NAME
@@ -334,6 +334,16 @@ If no user name or password is given, the
.Nm fetch
library will attempt an anonymous login, with user name "anonymous"
and password "anonymous@<hostname>".
+.Pp
+By default,
+.Nm fetch
+changes directories one at a time for the best compatibility with a wide
+variety of servers.
+If it is compiled with the
+.Ql FTP_COMBINE_CWDS
+flag, it will first try a single change directory command for the entire
+path and fall back to the default scheme if an error occurred.
+This can save latency when used with a slow network link.
.Sh HTTP SCHEME
The
.Fn fetchXGetHTTP ,
OpenPOWER on IntegriCloud