Don't advertise --no-dns-cache for dyndns
Hrvoje Niksic <[email protected]>
| Newsgroups | gmane.comp.web.wget.patches |
|---|---|
| Message-ID | <[email protected]> |
The original reason for adding the --no-dns-cache was to allow long-running downloads from dyndns-run servers. Since Wget now knows to reissue the DNS query if all connections fail, that reason is no longer present. (We might want to reconsider the existence of --no-dns-cache, but then again it's probably useful for debugging.) 2005-04-18 Hrvoje Niksic <[email protected]> * wget.texi (Download Options): Don't claim that --no-dns-cache is necessary for dyndns servers -- it's not. Index: doc/wget.texi =================================================================== RCS file: /pack/anoncvs/wget/doc/wget.texi,v retrieving revision 1.103 diff -u -r1.103 wget.texi --- doc/wget.texi 2005/03/06 19:34:22 1.103 +++ doc/wget.texi 2005/04/17 23:24:13 @@ -813,26 +813,24 @@ @cindex DNS cache @cindex caching of DNS lookups -@item --dns-cache=off -Turn off caching of DNS lookups. Normally, Wget remembers the addresses -it looked up from DNS so it doesn't have to repeatedly contact the DNS -server for the same (typically small) set of addresses it retrieves -from. This cache exists in memory only; a new Wget run will contact DNS -again. - -However, in some cases it is not desirable to cache host names, even for -the duration of a short-running application like Wget. For example, -some HTTP servers are hosted on machines with dynamically allocated IP -addresses that change from time to time. Their DNS entries are updated -along with each change. When Wget's download from such a host gets -interrupted by IP address change, Wget retries the download, but (due to -DNS caching) it contacts the old address. With the DNS cache turned -off, Wget will repeat the DNS lookup for every connect and will thus get -the correct dynamic address every time---at the cost of additional DNS -lookups where they're probably not needed. +@item --no-dns-cache +Turn off caching of DNS lookups. Normally, Wget remembers the IP +addresses it looked up from DNS so it doesn't have to repeatedly +contact the DNS server for the same (typically small) set of hosts it +retrieves from. This cache exists in memory only; a new Wget run will +contact DNS again. + +However, it has been reported that in some situations it is not +desirable to cache host names, even for the duration of a +short-running application like Wget. With this option Wget issues a +new DNS lookup (more precisely, a new call to @code{gethostbyname} or +@code{getaddrinfo}) each time it makes a new connection. Please note +that this option will @emph{not} affect caching that might be +performed by the resolving library or by an external caching layer, +such as NSCD. -If you don't understand the above description, you probably won't need -this option. +If you don't understand exactly what this option does, you probably +won't need it. @cindex file names, restrict @cindex Windows file names @@ -1065,7 +1063,7 @@ to send those cookies, bypassing the ``official'' cookie support: @example -wget --cookies=off --header "Cookie: @var{name}=@var{value}" +wget --no-cookies --header "Cookie: @var{name}=@var{value}" @end example @cindex saving cookies