@c %**start of header
@setfilename wget.info
@include version.texi
-@set UPDATED Apr 2005
+@set UPDATED Jul 2006
@settitle GNU Wget @value{VERSION} Manual
@c Disable the monstrous rectangles beside overfull hbox-es.
@finalout
data.
@c man begin COPYRIGHT
-Copyright @copyright{} 1996--2005 Free Software Foundation, Inc.
+Copyright @copyright{} 1996--2006 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
@end ignore
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
-any later version published by the Free Software Foundation; with the
-Invariant Sections being ``GNU General Public License'' and ``GNU Free
-Documentation License'', with no Front-Cover Texts, and with no
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts. A copy of the license is included in the section
entitled ``GNU Free Documentation License''.
@c man end
@ignore
@c man begin AUTHOR
Originally written by Hrvoje Niksic <hniksic@xemacs.org>.
+Currently maintained by Mauro Tortonesi <mauro@ferrara.linux.it>.
@c man end
@c man begin SEEALSO
GNU Info entry for @file{wget}.
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 1996--2005, Free Software Foundation, Inc.
+Copyright @copyright{} 1996--2006, Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
-any later version published by the Free Software Foundation; with the
-Invariant Sections being ``GNU General Public License'' and ``GNU Free
-Documentation License'', with no Front-Cover Texts, and with no
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts. A copy of the license is included in the section
entitled ``GNU Free Documentation License''.
@end titlepage
This manual documents version @value{VERSION} of GNU Wget, the freely
available utility for network downloads.
-Copyright @copyright{} 1996--2005 Free Software Foundation, Inc.
+Copyright @copyright{} 1996--2006 Free Software Foundation, Inc.
@menu
* Overview:: Features of Wget.
Specifying a large value for this option is useful if the network or the
destination host is down, so that Wget can wait long enough to
-reasonably expect the network error to be fixed before the retry.
+reasonably expect the network error to be fixed before the retry. The
+waiting interval specified by this function is influenced by
+@code{--random-wait}, which see.
@cindex retries, waiting between
@cindex waiting between retries
Some web sites may perform log analysis to identify retrieval programs
such as Wget by looking for statistically significant similarities in
the time between requests. This option causes the time between requests
-to vary between 0 and 2 * @var{wait} seconds, where @var{wait} was
+to vary between 0.5 and 1.5 * @var{wait} seconds, where @var{wait} was
specified using the @samp{--wait} option, in order to mask Wget's
presence from such analysis.
-A recent article in a publication devoted to development on a popular
+A 2001 article in a publication devoted to development on a popular
consumer platform provided code to perform this analysis on the fly.
Its author suggested blocking at the class C address level to ensure
automated retrieval programs were blocked despite changing DHCP-supplied
Don't use proxies, even if the appropriate @code{*_proxy} environment
variable is defined.
+@c man end
For more information about the use of proxies with Wget, @xref{Proxies}.
+@c man begin OPTIONS
@cindex quota
@item -Q @var{quota}
Neither options should be needed normally. By default, an IPv6-aware
Wget will use the address family specified by the host's DNS record.
-If the DNS responds with both IPv4 and IPv6 addresses, Wget will them
-in sequence until it finds one it can connect to. (Also see
+If the DNS responds with both IPv4 and IPv6 addresses, Wget will try
+them in sequence until it finds one it can connect to. (Also see
@code{--prefer-family} option described below.)
These options can be used to deliberately force the use of IPv4 or
Now the best bet for downloading a single page and its requisites is the
dedicated @samp{--page-requisites} option.
+@cindex case fold
+@cindex ignore case
+@item --ignore-case
+Ignore case when matching files and directories. This influences the
+behavior of -R, -A, -I, and -X options, as well as globbing
+implemented when downloading from FTP sites. For example, with this
+option, @samp{-A *.txt} will match @samp{file1.txt}, but also
+@samp{file2.TXT}, @samp{file3.TxT}, and so on.
+
@item -H
@itemx --span-hosts
Enable spanning across hosts when doing recursive retrieving
Use @var{string} as @sc{https} proxy, instead of the one specified in
environment.
+@item ignore_case = on/off
+When set to on, match files and directories case insensitively; the
+same as @samp{--ignore-case}.
+
@item ignore_length = on/off
When set to on, ignore @code{Content-Length} header; the same as
@samp{--ignore-length}.
Use @var{file} as a source of randomness on systems lacking
@file{/dev/random}.
+@item random_wait = on/off
+Turn random between-request wait times on or off. The same as
+@samp{--random-wait}.
+
@item read_timeout = @var{n}
Set the read (and write) timeout---the same as
@samp{--read-timeout=@var{n}}.
Wait up to @var{n} seconds between retries of failed retrievals
only---the same as @samp{--waitretry=@var{n}}. Note that this is
turned on by default in the global @file{wgetrc}.
-
-@item randomwait = on/off
-Turn random between-request wait times on or off. The same as
-@samp{--random-wait}.
@end table
@node Sample Wgetrc
@table @code
@item http_proxy
@itemx https_proxy
-This variable should contain the @sc{url} of the proxy for @sc{http}
-and @sc{https} connections.
+If set, the @code{http_proxy} and @code{https_proxy} variables should
+contain the @sc{url}s of the proxies for @sc{http} and @sc{https}
+connections respectively.
@item ftp_proxy
This variable should contain the @sc{url} of the proxy for @sc{ftp}
-connections. It is quite common that @sc{http_proxy} and @sc{ftp_proxy}
-are set to the same @sc{url}.
+connections. It is quite common that @code{http_proxy} and
+@code{ftp_proxy} are set to the same @sc{url}.
@item no_proxy
This variable should contain a comma-separated list of domain extensions
@cindex contributors
@iftex
-GNU Wget was written by Hrvoje Nik@v{s}i@'{c} @email{hniksic@@xemacs.org}.
+GNU Wget was written by Hrvoje Nik@v{s}i@'{c} @email{hniksic@@xemacs.org},
@end iftex
@ifnottex
-GNU Wget was written by Hrvoje Niksic @email{hniksic@@xemacs.org}.
+GNU Wget was written by Hrvoje Niksic @email{hniksic@@xemacs.org},
@end ifnottex
-However, its development could never have gone as far as it has, were it
-not for the help of many people, either with bug reports, feature
-proposals, patches, or letters saying ``Thanks!''.
+and it is currently maintained by Mauro Tortonesi @email{mauro@@ferrara.linux.it}.
+
+However, the development of Wget could never have gone as far as it has, were
+it not for the help of many people, either with bug reports, feature proposals,
+patches, or letters saying ``Thanks!''.
Special thanks goes to the following people (no particular order):
@itemize @bullet
-@item Mauro Tortonesi---contributed high-quality IPv6 code and many
-other fixes.
-
@item Dan Harkless---contributed a lot of code and documentation of
extremely high quality, as well as the @code{--page-requisites} and
related options. He was the principal maintainer for some time and
@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
-any later version published by the Free Software Foundation; with the
-Invariant Sections being ``GNU General Public License'' and ``GNU Free
-Documentation License'', with no Front-Cover Texts, and with no
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts. A copy of the license is included in the section
entitled ``GNU Free Documentation License''.
@end quotation
projects / wget / blobdiff