diff options
author | DongHun Kwak <dh0128.kwak@samsung.com> | 2021-03-05 10:08:13 +0900 |
---|---|---|
committer | DongHun Kwak <dh0128.kwak@samsung.com> | 2021-03-05 10:08:13 +0900 |
commit | 61fb427c104d6f2334aaee9c7d90d8287d521b17 (patch) | |
tree | e4caa30fa69cb51705f22392cab8cf9c04dffb94 /doc/wget.info | |
parent | 1478f6ab011981e9a986c0c30da680635d3e77bf (diff) | |
download | wget-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.info | 305 |
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 |