summaryrefslogtreecommitdiff
path: root/doc/wget.info
diff options
context:
space:
mode:
authorDongHun Kwak <dh0128.kwak@samsung.com>2021-03-05 10:08:13 +0900
committerDongHun Kwak <dh0128.kwak@samsung.com>2021-03-05 10:08:13 +0900
commit61fb427c104d6f2334aaee9c7d90d8287d521b17 (patch)
treee4caa30fa69cb51705f22392cab8cf9c04dffb94 /doc/wget.info
parent1478f6ab011981e9a986c0c30da680635d3e77bf (diff)
downloadwget-61fb427c104d6f2334aaee9c7d90d8287d521b17.tar.gz
wget-61fb427c104d6f2334aaee9c7d90d8287d521b17.tar.bz2
wget-61fb427c104d6f2334aaee9c7d90d8287d521b17.zip
Imported Upstream version 1.16.1upstream/1.16.1
Diffstat (limited to 'doc/wget.info')
-rw-r--r--doc/wget.info305
1 files changed, 180 insertions, 125 deletions
diff --git a/doc/wget.info b/doc/wget.info
index a3b4a34..fe5d588 100644
--- a/doc/wget.info
+++ b/doc/wget.info
@@ -19,8 +19,8 @@ END-INFO-DIR-ENTRY

File: wget.info, Node: Top, Next: Overview, Prev: (dir), Up: (dir)
-Wget 1.15
-*********
+Wget 1.16.1
+***********
This file documents the GNU Wget utility for downloading network data.
@@ -555,6 +555,18 @@ File: wget.info, Node: Download Options, Next: Directory Options, Prev: Loggi
Note that '-c' only works with FTP servers and with HTTP servers
that support the 'Range' header.
+'--start-pos=OFFSET'
+ Start downloading at zero-based position OFFSET. Offset may be
+ expressed in bytes, kilobytes with the 'k' suffix, or megabytes
+ with the 'm' suffix, etc.
+
+ '--start-pos' has higher precedence over '--continue'. When
+ '--start-pos' and '--continue' are both specified, wget will emit a
+ warning then proceed as if '--continue' was absent.
+
+ Server support for continued download is required, otherwise
+ '--start-pos' cannot help. See '-c' for details.
+
'--progress=TYPE'
Select the type of the progress indicator you wish to use. Legal
indicators are "dot" and "bar".
@@ -568,7 +580,12 @@ File: wget.info, Node: Download Options, Next: Directory Options, Prev: Loggi
retrieval by printing dots on the screen, each dot representing a
fixed amount of downloaded data.
- When using the dotted retrieval, you may also set the "style" by
+ The progress TYPE can also take one or more parameters. The
+ parameters vary based on the TYPE selected. Parameters to TYPE are
+ passed by appending them to the type sperated by a colon (:) like
+ this: '--progress=TYPE:PARAMETER1:PARAMETER2'.
+
+ When using the dotted retrieval, you may set the "style" by
specifying the type as 'dot:STYLE'. Different styles assign
different meaning to one dot. With the 'default' style each dot
represents 1K, there are ten dots in a cluster and 50 dots in a
@@ -581,11 +598,37 @@ File: wget.info, Node: Download Options, Next: Directory Options, Prev: Loggi
style--each dot represents 1M retrieved, there are eight dots in a
cluster, and 32 dots on each line (so each line contains 32M).
+ With '--progress=bar', there are currently two possible parameters,
+ FORCE and NOSCROLL.
+
+ When the output is not a TTY, the progress bar always falls back to
+ "dot", even if '--progress=bar' was passed to Wget during
+ invokation. This behaviour can be overridden and the "bar" output
+ forced by using the "force" parameter as '--progress=bar:force'.
+
+ By default, the 'bar' style progress bar scroll the name of the
+ file from left to right for the file being downloaded if the
+ filename exceeds the maximum length allotted for its display. In
+ certain cases, such as with '--progress=bar:force', one may not
+ want the scrolling filename in the progress bar. By passing the
+ "noscroll" parameter, Wget can be forced to display as much of the
+ filename as possible without scrolling through it.
+
Note that you can set the default style using the 'progress'
command in '.wgetrc'. That setting may be overridden from the
- command line. The exception is that, when the output is not a TTY,
- the "dot" progress will be favored over "bar". To force the bar
- output, use '--progress=bar:force'.
+ command line. For example, to force the bar output without
+ scrolling, use '--progress=bar:force:noscroll'.
+
+'--show-progress'
+ Force wget to display the progress bar in any verbosity.
+
+ By default, wget only displays the progress bar in verbose mode.
+ One may however want wget to display the progress bar on screen in
+ conjunction with any other verbosity modes like '--no-verbose' or
+ '--quiet'. This is often a desired a property when invoking wget
+ to download several small/large files. In such a case, wget could
+ simply be invoked with this parameter to get a much cleaner output
+ on the screen.
'-N'
'--timestamping'
@@ -722,8 +765,8 @@ File: wget.info, Node: Download Options, Next: Directory Options, Prev: Loggi
Don't use proxies, even if the appropriate '*_proxy' environment
variable is defined.
- For more information about the use of proxies with Wget, *Note
- Proxies::.
+ *Note Proxies::, for more information about the use of proxies with
+ Wget.
'-Q QUOTA'
'--quota=QUOTA'
@@ -1366,15 +1409,15 @@ SSL support, none of these options are available.
'--secure-protocol=PROTOCOL'
Choose the secure protocol to be used. Legal values are 'auto',
- 'SSLv2', 'SSLv3', 'TLSv1' and 'PFS'. If 'auto' is used, the SSL
- library is given the liberty of choosing the appropriate protocol
- automatically, which is achieved by sending an SSLv2 greeting and
- announcing support for SSLv3 and TLSv1. This is the default.
-
- Specifying 'SSLv2', 'SSLv3', or 'TLSv1' forces the use of the
- corresponding protocol. This is useful when talking to old and
- buggy SSL server implementations that make it hard for the
- underlying SSL library to choose the correct protocol version.
+ 'SSLv2', 'SSLv3', 'TLSv1', 'TLSv1_1', 'TLSv1_2' and 'PFS'. If
+ 'auto' is used, the SSL library is given the liberty of choosing
+ the appropriate protocol automatically, which is achieved by
+ sending a TLSv1 greeting. This is the default.
+
+ Specifying 'SSLv2', 'SSLv3', 'TLSv1', 'TLSv1_1' or 'TLSv1_2' forces
+ the use of the corresponding protocol. This is useful when talking
+ to old and buggy SSL server implementations that make it hard for
+ the underlying SSL library to choose the correct protocol version.
Fortunately, such servers are quite rare.
Specifying 'PFS' enforces the use of the so-called Perfect Forward
@@ -1448,6 +1491,10 @@ SSL support, none of these options are available.
Without this option Wget looks for CA certificates at the
system-specified locations, chosen at OpenSSL installation time.
+'--crl-file=FILE'
+ Specifies a CRL file in FILE. This is needed for certificates that
+ have been revocated by the CAs.
+
'--random-file=FILE'
Use FILE as the source of random data for seeding the pseudo-random
number generator on systems without '/dev/random'.
@@ -1589,18 +1636,19 @@ File: wget.info, Node: FTP Options, Next: Recursive Retrieval Options, Prev:
umask.
'--retr-symlinks'
- Usually, when retrieving FTP directories recursively and a symbolic
- link is encountered, the linked-to file is not downloaded.
- Instead, a matching symbolic link is created on the local
- filesystem. The pointed-to file will not be downloaded unless this
- recursive retrieval would have encountered it separately and
- downloaded it anyway.
-
- When '--retr-symlinks' is specified, however, symbolic links are
- traversed and the pointed-to files are retrieved. At this time,
- this option does not cause Wget to traverse symlinks to directories
- and recurse through them, but in the future it should be enhanced
- to do this.
+ By default, when retrieving FTP directories recursively and a
+ symbolic link is encountered, the symbolic link is traversed and
+ the pointed-to files are retrieved. Currently, Wget does not
+ traverse symbolic links to directories to download them
+ recursively, though this feature may be added in the future.
+
+ When '--retr-symlinks=no' is specified, the linked-to file is not
+ downloaded. Instead, a matching symbolic link is created on the
+ local filesystem. The pointed-to file will not be retrieved unless
+ this recursive retrieval would have encountered it separately and
+ downloaded it anyway. This option poses a security risk where a
+ malicious FTP Server may cause Wget to write to files outside of
+ the intended directories through a specially crafted .LISTING file.
Note that when retrieving a file (not a directory) because it was
specified on the command-line, rather than because it was recursed
@@ -3439,7 +3487,8 @@ File: wget.info, Node: Distribution, Next: Web Site, Prev: Proxies, Up: Vari
Like all GNU utilities, the latest version of Wget can be found at the
master GNU archive site ftp.gnu.org, and its mirrors. For example, Wget
-1.15 can be found at <ftp://ftp.gnu.org/pub/gnu/wget/wget-1.15.tar.gz>
+1.16.1 can be found at
+<ftp://ftp.gnu.org/pub/gnu/wget/wget-1.16.1.tar.gz>

File: wget.info, Node: Web Site, Next: Mailing Lists, Prev: Distribution, Up: Various
@@ -3876,8 +3925,7 @@ A.1 GNU Free Documentation License
Version 1.3, 3 November 2008
- Copyright (C) 2000, 2001, 2002, 2007, 2008, 2009, 2010, 2011
- Free Software Foundation, Inc.
+ Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
<http://fsf.org/>
Everyone is permitted to copy and distribute verbatim copies
@@ -4336,7 +4384,7 @@ notices just after the title page:
Free Documentation License''.
If you have Invariant Sections, Front-Cover Texts and Back-Cover
-Texts, replace the "with...Texts." line with this:
+Texts, replace the "with...Texts." line with this:
with the Invariant Sections being LIST THEIR TITLES, with
the Front-Cover Texts being LIST, and with the Back-Cover Texts
@@ -4373,20 +4421,20 @@ Concept Index
* append to log: Logging and Input File Options.
(line 11)
* arguments: Invoking. (line 6)
-* authentication: Download Options. (line 460)
+* authentication: Download Options. (line 503)
* authentication <1>: HTTP Options. (line 38)
* authentication <2>: HTTP Options. (line 358)
* backing up converted files: Recursive Retrieval Options.
(line 71)
* backing up files: Download Options. (line 86)
-* bandwidth, limit: Download Options. (line 255)
+* bandwidth, limit: Download Options. (line 298)
* base for relative links in input file: Logging and Input File Options.
(line 76)
* bind address: Download Options. (line 6)
* bug reports: Reporting Bugs. (line 6)
* bugs: Reporting Bugs. (line 6)
* cache: HTTP Options. (line 66)
-* caching of DNS lookups: Download Options. (line 339)
+* caching of DNS lookups: Download Options. (line 382)
* case fold: Recursive Accept/Reject Options.
(line 62)
* client IP address: Download Options. (line 6)
@@ -4394,11 +4442,12 @@ Concept Index
* command line: Invoking. (line 6)
* comments, HTML: Recursive Retrieval Options.
(line 149)
-* connect timeout: Download Options. (line 239)
+* connect timeout: Download Options. (line 282)
* Content On Error: HTTP Options. (line 347)
* Content-Disposition: HTTP Options. (line 335)
* Content-Length, ignore: HTTP Options. (line 155)
* continue retrieval: Download Options. (line 92)
+* continue retrieval <1>: Download Options. (line 153)
* contributors: Contributors. (line 6)
* conversion of links: Recursive Retrieval Options.
(line 32)
@@ -4421,14 +4470,14 @@ Concept Index
* directory limits: Directory-Based Limits.
(line 6)
* directory prefix: Directory Options. (line 59)
-* DNS cache: Download Options. (line 339)
-* DNS timeout: Download Options. (line 233)
-* dot style: Download Options. (line 153)
+* DNS cache: Download Options. (line 382)
+* DNS timeout: Download Options. (line 276)
+* dot style: Download Options. (line 165)
* downloading multiple times: Download Options. (line 50)
* EGD: HTTPS (SSL/TLS) Options.
- (line 110)
+ (line 114)
* entropy, specifying source of: HTTPS (SSL/TLS) Options.
- (line 94)
+ (line 98)
* examples: Examples. (line 6)
* exclude directories: Directory-Based Limits.
(line 30)
@@ -4437,7 +4486,7 @@ Concept Index
* FDL, GNU Free Documentation License: GNU Free Documentation License.
(line 6)
* features: Overview. (line 6)
-* file names, restrict: Download Options. (line 358)
+* file names, restrict: Download Options. (line 401)
* file permissions: FTP Options. (line 73)
* filling proxy cache: Recursive Retrieval Options.
(line 16)
@@ -4463,13 +4512,14 @@ Concept Index
* http time-stamping: HTTP Time-Stamping Internals.
(line 6)
* http user: HTTP Options. (line 38)
-* idn support: Download Options. (line 473)
+* idn support: Download Options. (line 516)
* ignore case: Recursive Accept/Reject Options.
(line 62)
* ignore length: HTTP Options. (line 155)
* include directories: Directory-Based Limits.
(line 17)
* incomplete downloads: Download Options. (line 92)
+* incomplete downloads <1>: Download Options. (line 153)
* incremental updating: Time-Stamping. (line 6)
* index.html: HTTP Options. (line 6)
* input-file: Logging and Input File Options.
@@ -4477,18 +4527,18 @@ Concept Index
* Internet Relay Chat: Internet Relay Chat. (line 6)
* invoking: Invoking. (line 6)
* IP address, client: Download Options. (line 6)
-* IPv6: Download Options. (line 408)
+* IPv6: Download Options. (line 451)
* IRC: Internet Relay Chat. (line 6)
-* iri support: Download Options. (line 473)
+* iri support: Download Options. (line 516)
* Keep-Alive, turning off: HTTP Options. (line 54)
* latest version: Distribution. (line 6)
-* limit bandwidth: Download Options. (line 255)
+* limit bandwidth: Download Options. (line 298)
* link conversion: Recursive Retrieval Options.
(line 32)
* links: Following Links. (line 6)
* list: Mailing Lists. (line 5)
* loading cookies: HTTP Options. (line 85)
-* local encoding: Download Options. (line 482)
+* local encoding: Download Options. (line 525)
* location of wgetrc: Wgetrc Location. (line 6)
* log file: Logging and Input File Options.
(line 6)
@@ -4499,6 +4549,7 @@ Concept Index
* no-clobber: Download Options. (line 50)
* nohup: Invoking. (line 6)
* number of tries: Download Options. (line 11)
+* offset: Download Options. (line 153)
* operating systems: Portability. (line 6)
* option syntax: Option Syntax. (line 6)
* Other HTTP Methods: HTTP Options. (line 302)
@@ -4508,14 +4559,14 @@ Concept Index
* page requisites: Recursive Retrieval Options.
(line 84)
* passive ftp: FTP Options. (line 61)
-* password: Download Options. (line 460)
-* pause: Download Options. (line 275)
+* password: Download Options. (line 503)
+* pause: Download Options. (line 318)
* Persistent Connections, disabling: HTTP Options. (line 54)
* portability: Portability. (line 6)
* POST: HTTP Options. (line 240)
-* progress indicator: Download Options. (line 153)
+* progress indicator: Download Options. (line 165)
* proxies: Proxies. (line 6)
-* proxy: Download Options. (line 316)
+* proxy: Download Options. (line 359)
* proxy <1>: HTTP Options. (line 66)
* proxy authentication: HTTP Options. (line 198)
* proxy filling: Recursive Retrieval Options.
@@ -4524,12 +4575,12 @@ Concept Index
* proxy user: HTTP Options. (line 198)
* quiet: Logging and Input File Options.
(line 28)
-* quota: Download Options. (line 323)
-* random wait: Download Options. (line 298)
+* quota: Download Options. (line 366)
+* random wait: Download Options. (line 341)
* randomness, specifying source of: HTTPS (SSL/TLS) Options.
- (line 94)
-* rate, limit: Download Options. (line 255)
-* read timeout: Download Options. (line 244)
+ (line 98)
+* rate, limit: Download Options. (line 298)
+* read timeout: Download Options. (line 287)
* recursion: Recursive Download. (line 6)
* recursive download: Recursive Download. (line 6)
* redirect: HTTP Options. (line 192)
@@ -4540,13 +4591,14 @@ Concept Index
* reject suffixes: Types of Files. (line 39)
* reject wildcards: Types of Files. (line 39)
* relative links: Relative Links. (line 6)
-* remote encoding: Download Options. (line 496)
+* remote encoding: Download Options. (line 539)
* reporting bugs: Reporting Bugs. (line 6)
* required images, downloading: Recursive Retrieval Options.
(line 84)
* resume download: Download Options. (line 92)
+* resume download <1>: Download Options. (line 153)
* retries: Download Options. (line 11)
-* retries, waiting between: Download Options. (line 289)
+* retries, waiting between: Download Options. (line 332)
* retrieving: Recursive Download. (line 6)
* robot exclusion: Robot Exclusion. (line 6)
* robots.txt: Robot Exclusion. (line 6)
@@ -4555,14 +4607,14 @@ Concept Index
* security: Security Considerations.
(line 6)
* server maintenance: Robot Exclusion. (line 6)
-* server response, print: Download Options. (line 199)
+* server response, print: Download Options. (line 242)
* server response, save: HTTP Options. (line 214)
* session cookies: HTTP Options. (line 138)
* signal handling: Signals. (line 6)
* spanning hosts: Spanning Hosts. (line 6)
* specify config: Logging and Input File Options.
(line 89)
-* spider: Download Options. (line 204)
+* spider: Download Options. (line 247)
* SSL: HTTPS (SSL/TLS) Options.
(line 6)
* SSL certificate: HTTPS (SSL/TLS) Options.
@@ -4573,8 +4625,11 @@ Concept Index
(line 62)
* SSL certificate, check: HTTPS (SSL/TLS) Options.
(line 32)
+* SSL CRL, certificate revocation list: HTTPS (SSL/TLS) Options.
+ (line 94)
* SSL protocol, choose: HTTPS (SSL/TLS) Options.
(line 10)
+* start position: Download Options. (line 153)
* startup: Startup File. (line 6)
* startup file: Startup File. (line 6)
* suffixes, accept: Types of Files. (line 15)
@@ -4586,94 +4641,94 @@ Concept Index
(line 38)
* time-stamping: Time-Stamping. (line 6)
* time-stamping usage: Time-Stamping Usage. (line 6)
-* timeout: Download Options. (line 215)
-* timeout, connect: Download Options. (line 239)
-* timeout, DNS: Download Options. (line 233)
-* timeout, read: Download Options. (line 244)
+* timeout: Download Options. (line 258)
+* timeout, connect: Download Options. (line 282)
+* timeout, DNS: Download Options. (line 276)
+* timeout, read: Download Options. (line 287)
* timestamping: Time-Stamping. (line 6)
* tries: Download Options. (line 11)
* Trust server names: HTTP Options. (line 352)
* types of files: Types of Files. (line 6)
-* unlink: Download Options. (line 511)
+* unlink: Download Options. (line 554)
* updating the archives: Time-Stamping. (line 6)
* URL: URL Format. (line 6)
* URL syntax: URL Format. (line 6)
* usage, time-stamping: Time-Stamping Usage. (line 6)
-* user: Download Options. (line 460)
+* user: Download Options. (line 503)
* user-agent: HTTP Options. (line 218)
* various: Various. (line 6)
* verbose: Logging and Input File Options.
(line 32)
-* wait: Download Options. (line 275)
-* wait, random: Download Options. (line 298)
-* waiting between retries: Download Options. (line 289)
+* wait: Download Options. (line 318)
+* wait, random: Download Options. (line 341)
+* waiting between retries: Download Options. (line 332)
* WARC: HTTPS (SSL/TLS) Options.
- (line 129)
+ (line 133)
* web site: Web Site. (line 6)
-* Wget as spider: Download Options. (line 204)
+* Wget as spider: Download Options. (line 247)
* wgetrc: Startup File. (line 6)
* wgetrc commands: Wgetrc Commands. (line 6)
* wgetrc location: Wgetrc Location. (line 6)
* wgetrc syntax: Wgetrc Syntax. (line 6)
* wildcards, accept: Types of Files. (line 15)
* wildcards, reject: Types of Files. (line 39)
-* Windows file names: Download Options. (line 358)
+* Windows file names: Download Options. (line 401)

Tag Table:
Node: Top814
-Node: Overview2208
-Node: Invoking5712
-Node: URL Format6688
-Ref: URL Format-Footnote-19279
-Node: Option Syntax9381
-Node: Basic Startup Options12058
-Node: Logging and Input File Options12862
-Node: Download Options16419
-Node: Directory Options41054
-Node: HTTP Options43755
-Node: HTTPS (SSL/TLS) Options61179
-Node: FTP Options67895
-Node: Recursive Retrieval Options72468
-Node: Recursive Accept/Reject Options80337
-Node: Exit Status84380
-Node: Recursive Download85404
-Node: Following Links88577
-Node: Spanning Hosts89539
-Node: Types of Files91739
-Node: Directory-Based Limits96441
-Node: Relative Links99539
-Node: FTP Links100376
-Node: Time-Stamping101243
-Node: Time-Stamping Usage102904
-Node: HTTP Time-Stamping Internals104752
-Ref: HTTP Time-Stamping Internals-Footnote-1106028
-Node: FTP Time-Stamping Internals106227
-Node: Startup File107693
-Node: Wgetrc Location108608
-Node: Wgetrc Syntax109428
-Node: Wgetrc Commands110148
-Node: Sample Wgetrc125668
-Node: Examples131542
-Node: Simple Usage131903
-Node: Advanced Usage133324
-Node: Very Advanced Usage137036
-Node: Various138530
-Node: Proxies139235
-Node: Distribution142086
-Node: Web Site142424
-Node: Mailing Lists142720
-Node: Internet Relay Chat144791
-Node: Reporting Bugs145078
-Node: Portability147599
-Node: Signals149224
-Node: Appendices149907
-Node: Robot Exclusion150253
-Node: Security Considerations154048
-Node: Contributors155232
-Node: Copying this manual160810
-Node: GNU Free Documentation License161050
-Node: Concept Index186212
+Node: Overview2212
+Node: Invoking5716
+Node: URL Format6692
+Ref: URL Format-Footnote-19283
+Node: Option Syntax9385
+Node: Basic Startup Options12062
+Node: Logging and Input File Options12866
+Node: Download Options16423
+Node: Directory Options43142
+Node: HTTP Options45843
+Node: HTTPS (SSL/TLS) Options63267
+Node: FTP Options70111
+Node: Recursive Retrieval Options74846
+Node: Recursive Accept/Reject Options82715
+Node: Exit Status86758
+Node: Recursive Download87782
+Node: Following Links90955
+Node: Spanning Hosts91917
+Node: Types of Files94117
+Node: Directory-Based Limits98819
+Node: Relative Links101917
+Node: FTP Links102754
+Node: Time-Stamping103621
+Node: Time-Stamping Usage105282
+Node: HTTP Time-Stamping Internals107130
+Ref: HTTP Time-Stamping Internals-Footnote-1108406
+Node: FTP Time-Stamping Internals108605
+Node: Startup File110071
+Node: Wgetrc Location110986
+Node: Wgetrc Syntax111806
+Node: Wgetrc Commands112526
+Node: Sample Wgetrc128046
+Node: Examples133920
+Node: Simple Usage134281
+Node: Advanced Usage135702
+Node: Very Advanced Usage139414
+Node: Various140908
+Node: Proxies141613
+Node: Distribution144464
+Node: Web Site144806
+Node: Mailing Lists145102
+Node: Internet Relay Chat147173
+Node: Reporting Bugs147460
+Node: Portability149981
+Node: Signals151606
+Node: Appendices152289
+Node: Robot Exclusion152635
+Node: Security Considerations156430
+Node: Contributors157614
+Node: Copying this manual163192
+Node: GNU Free Documentation License163432
+Node: Concept Index188570

End Tag Table