1
This is wget.info, produced by makeinfo version 4.3 from ./wget.texi.
3
INFO-DIR-SECTION Network Applications
5
* Wget: (wget). The non-interactive network downloader.
8
This file documents the the GNU Wget utility for downloading network
11
Copyright (C) 1996, 1997, 1998, 2000, 2001, 2002, 2003 Free Software
14
Permission is granted to make and distribute verbatim copies of this
15
manual provided the copyright notice and this permission notice are
16
preserved on all copies.
18
Permission is granted to copy, distribute and/or modify this document
19
under the terms of the GNU Free Documentation License, Version 1.1 or
20
any later version published by the Free Software Foundation; with the
21
Invariant Sections being "GNU General Public License" and "GNU Free
22
Documentation License", with no Front-Cover Texts, and with no
23
Back-Cover Texts. A copy of the license is included in the section
24
entitled "GNU Free Documentation License".
27
File: wget.info, Node: GNU Free Documentation License, Prev: GNU General Public License, Up: Copying
29
GNU Free Documentation License
30
==============================
32
Version 1.1, March 2000
33
Copyright (C) 2000 Free Software Foundation, Inc.
34
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
36
Everyone is permitted to copy and distribute verbatim copies
37
of this license document, but changing it is not allowed.
42
The purpose of this License is to make a manual, textbook, or other
43
written document "free" in the sense of freedom: to assure everyone
44
the effective freedom to copy and redistribute it, with or without
45
modifying it, either commercially or noncommercially. Secondarily,
46
this License preserves for the author and publisher a way to get
47
credit for their work, while not being considered responsible for
48
modifications made by others.
50
This License is a kind of "copyleft", which means that derivative
51
works of the document must themselves be free in the same sense.
52
It complements the GNU General Public License, which is a copyleft
53
license designed for free software.
55
We have designed this License in order to use it for manuals for
56
free software, because free software needs free documentation: a
57
free program should come with manuals providing the same freedoms
58
that the software does. But this License is not limited to
59
software manuals; it can be used for any textual work, regardless
60
of subject matter or whether it is published as a printed book.
61
We recommend this License principally for works whose purpose is
62
instruction or reference.
65
1. APPLICABILITY AND DEFINITIONS
67
This License applies to any manual or other work that contains a
68
notice placed by the copyright holder saying it can be distributed
69
under the terms of this License. The "Document", below, refers to
70
any such manual or work. Any member of the public is a licensee,
71
and is addressed as "you".
73
A "Modified Version" of the Document means any work containing the
74
Document or a portion of it, either copied verbatim, or with
75
modifications and/or translated into another language.
77
A "Secondary Section" is a named appendix or a front-matter
78
section of the Document that deals exclusively with the
79
relationship of the publishers or authors of the Document to the
80
Document's overall subject (or to related matters) and contains
81
nothing that could fall directly within that overall subject.
82
(For example, if the Document is in part a textbook of
83
mathematics, a Secondary Section may not explain any mathematics.)
84
The relationship could be a matter of historical connection with
85
the subject or with related matters, or of legal, commercial,
86
philosophical, ethical or political position regarding them.
88
The "Invariant Sections" are certain Secondary Sections whose
89
titles are designated, as being those of Invariant Sections, in
90
the notice that says that the Document is released under this
93
The "Cover Texts" are certain short passages of text that are
94
listed, as Front-Cover Texts or Back-Cover Texts, in the notice
95
that says that the Document is released under this License.
97
A "Transparent" copy of the Document means a machine-readable copy,
98
represented in a format whose specification is available to the
99
general public, whose contents can be viewed and edited directly
100
and straightforwardly with generic text editors or (for images
101
composed of pixels) generic paint programs or (for drawings) some
102
widely available drawing editor, and that is suitable for input to
103
text formatters or for automatic translation to a variety of
104
formats suitable for input to text formatters. A copy made in an
105
otherwise Transparent file format whose markup has been designed
106
to thwart or discourage subsequent modification by readers is not
107
Transparent. A copy that is not "Transparent" is called "Opaque".
109
Examples of suitable formats for Transparent copies include plain
110
ASCII without markup, Texinfo input format, LaTeX input format,
111
SGML or XML using a publicly available DTD, and
112
standard-conforming simple HTML designed for human modification.
113
Opaque formats include PostScript, PDF, proprietary formats that
114
can be read and edited only by proprietary word processors, SGML
115
or XML for which the DTD and/or processing tools are not generally
116
available, and the machine-generated HTML produced by some word
117
processors for output purposes only.
119
The "Title Page" means, for a printed book, the title page itself,
120
plus such following pages as are needed to hold, legibly, the
121
material this License requires to appear in the title page. For
122
works in formats which do not have any title page as such, "Title
123
Page" means the text near the most prominent appearance of the
124
work's title, preceding the beginning of the body of the text.
128
You may copy and distribute the Document in any medium, either
129
commercially or noncommercially, provided that this License, the
130
copyright notices, and the license notice saying this License
131
applies to the Document are reproduced in all copies, and that you
132
add no other conditions whatsoever to those of this License. You
133
may not use technical measures to obstruct or control the reading
134
or further copying of the copies you make or distribute. However,
135
you may accept compensation in exchange for copies. If you
136
distribute a large enough number of copies you must also follow
137
the conditions in section 3.
139
You may also lend copies, under the same conditions stated above,
140
and you may publicly display copies.
142
3. COPYING IN QUANTITY
144
If you publish printed copies of the Document numbering more than
145
100, and the Document's license notice requires Cover Texts, you
146
must enclose the copies in covers that carry, clearly and legibly,
147
all these Cover Texts: Front-Cover Texts on the front cover, and
148
Back-Cover Texts on the back cover. Both covers must also clearly
149
and legibly identify you as the publisher of these copies. The
150
front cover must present the full title with all words of the
151
title equally prominent and visible. You may add other material
152
on the covers in addition. Copying with changes limited to the
153
covers, as long as they preserve the title of the Document and
154
satisfy these conditions, can be treated as verbatim copying in
157
If the required texts for either cover are too voluminous to fit
158
legibly, you should put the first ones listed (as many as fit
159
reasonably) on the actual cover, and continue the rest onto
162
If you publish or distribute Opaque copies of the Document
163
numbering more than 100, you must either include a
164
machine-readable Transparent copy along with each Opaque copy, or
165
state in or with each Opaque copy a publicly-accessible
166
computer-network location containing a complete Transparent copy
167
of the Document, free of added material, which the general
168
network-using public has access to download anonymously at no
169
charge using public-standard network protocols. If you use the
170
latter option, you must take reasonably prudent steps, when you
171
begin distribution of Opaque copies in quantity, to ensure that
172
this Transparent copy will remain thus accessible at the stated
173
location until at least one year after the last time you
174
distribute an Opaque copy (directly or through your agents or
175
retailers) of that edition to the public.
177
It is requested, but not required, that you contact the authors of
178
the Document well before redistributing any large number of
179
copies, to give them a chance to provide you with an updated
180
version of the Document.
184
You may copy and distribute a Modified Version of the Document
185
under the conditions of sections 2 and 3 above, provided that you
186
release the Modified Version under precisely this License, with
187
the Modified Version filling the role of the Document, thus
188
licensing distribution and modification of the Modified Version to
189
whoever possesses a copy of it. In addition, you must do these
190
things in the Modified Version:
192
A. Use in the Title Page (and on the covers, if any) a title
193
distinct from that of the Document, and from those of previous
194
versions (which should, if there were any, be listed in the
195
History section of the Document). You may use the same title
196
as a previous version if the original publisher of that version
198
B. List on the Title Page, as authors, one or more persons or
199
entities responsible for authorship of the modifications in the
200
Modified Version, together with at least five of the principal
201
authors of the Document (all of its principal authors, if it
203
C. State on the Title page the name of the publisher of the
204
Modified Version, as the publisher.
205
D. Preserve all the copyright notices of the Document.
206
E. Add an appropriate copyright notice for your modifications
207
adjacent to the other copyright notices.
208
F. Include, immediately after the copyright notices, a license
209
notice giving the public permission to use the Modified Version
210
under the terms of this License, in the form shown in the
212
G. Preserve in that license notice the full lists of Invariant
213
Sections and required Cover Texts given in the Document's
215
H. Include an unaltered copy of this License.
216
I. Preserve the section entitled "History", and its title, and add
217
to it an item stating at least the title, year, new authors, and
218
publisher of the Modified Version as given on the Title Page.
219
If there is no section entitled "History" in the Document,
220
create one stating the title, year, authors, and publisher of
221
the Document as given on its Title Page, then add an item
222
describing the Modified Version as stated in the previous
224
J. Preserve the network location, if any, given in the Document for
225
public access to a Transparent copy of the Document, and
226
likewise the network locations given in the Document for
227
previous versions it was based on. These may be placed in the
228
"History" section. You may omit a network location for a work
229
that was published at least four years before the Document
230
itself, or if the original publisher of the version it refers
232
K. In any section entitled "Acknowledgements" or "Dedications",
233
preserve the section's title, and preserve in the section all the
234
substance and tone of each of the contributor acknowledgements
235
and/or dedications given therein.
236
L. Preserve all the Invariant Sections of the Document,
237
unaltered in their text and in their titles. Section numbers
238
or the equivalent are not considered part of the section titles.
239
M. Delete any section entitled "Endorsements". Such a section
240
may not be included in the Modified Version.
241
N. Do not retitle any existing section as "Endorsements" or to
242
conflict in title with any Invariant Section.
244
If the Modified Version includes new front-matter sections or
245
appendices that qualify as Secondary Sections and contain no
246
material copied from the Document, you may at your option
247
designate some or all of these sections as invariant. To do this,
248
add their titles to the list of Invariant Sections in the Modified
249
Version's license notice. These titles must be distinct from any
250
other section titles.
252
You may add a section entitled "Endorsements", provided it contains
253
nothing but endorsements of your Modified Version by various
254
parties-for example, statements of peer review or that the text has
255
been approved by an organization as the authoritative definition
258
You may add a passage of up to five words as a Front-Cover Text,
259
and a passage of up to 25 words as a Back-Cover Text, to the end
260
of the list of Cover Texts in the Modified Version. Only one
261
passage of Front-Cover Text and one of Back-Cover Text may be
262
added by (or through arrangements made by) any one entity. If the
263
Document already includes a cover text for the same cover,
264
previously added by you or by arrangement made by the same entity
265
you are acting on behalf of, you may not add another; but you may
266
replace the old one, on explicit permission from the previous
267
publisher that added the old one.
269
The author(s) and publisher(s) of the Document do not by this
270
License give permission to use their names for publicity for or to
271
assert or imply endorsement of any Modified Version.
273
5. COMBINING DOCUMENTS
275
You may combine the Document with other documents released under
276
this License, under the terms defined in section 4 above for
277
modified versions, provided that you include in the combination
278
all of the Invariant Sections of all of the original documents,
279
unmodified, and list them all as Invariant Sections of your
280
combined work in its license notice.
282
The combined work need only contain one copy of this License, and
283
multiple identical Invariant Sections may be replaced with a single
284
copy. If there are multiple Invariant Sections with the same name
285
but different contents, make the title of each such section unique
286
by adding at the end of it, in parentheses, the name of the
287
original author or publisher of that section if known, or else a
288
unique number. Make the same adjustment to the section titles in
289
the list of Invariant Sections in the license notice of the
292
In the combination, you must combine any sections entitled
293
"History" in the various original documents, forming one section
294
entitled "History"; likewise combine any sections entitled
295
"Acknowledgements", and any sections entitled "Dedications". You
296
must delete all sections entitled "Endorsements."
298
6. COLLECTIONS OF DOCUMENTS
300
You may make a collection consisting of the Document and other
301
documents released under this License, and replace the individual
302
copies of this License in the various documents with a single copy
303
that is included in the collection, provided that you follow the
304
rules of this License for verbatim copying of each of the
305
documents in all other respects.
307
You may extract a single document from such a collection, and
308
distribute it individually under this License, provided you insert
309
a copy of this License into the extracted document, and follow
310
this License in all other respects regarding verbatim copying of
313
7. AGGREGATION WITH INDEPENDENT WORKS
315
A compilation of the Document or its derivatives with other
316
separate and independent documents or works, in or on a volume of
317
a storage or distribution medium, does not as a whole count as a
318
Modified Version of the Document, provided no compilation
319
copyright is claimed for the compilation. Such a compilation is
320
called an "aggregate", and this License does not apply to the
321
other self-contained works thus compiled with the Document, on
322
account of their being thus compiled, if they are not themselves
323
derivative works of the Document.
325
If the Cover Text requirement of section 3 is applicable to these
326
copies of the Document, then if the Document is less than one
327
quarter of the entire aggregate, the Document's Cover Texts may be
328
placed on covers that surround only the Document within the
329
aggregate. Otherwise they must appear on covers around the whole
334
Translation is considered a kind of modification, so you may
335
distribute translations of the Document under the terms of section
336
4. Replacing Invariant Sections with translations requires special
337
permission from their copyright holders, but you may include
338
translations of some or all Invariant Sections in addition to the
339
original versions of these Invariant Sections. You may include a
340
translation of this License provided that you also include the
341
original English version of this License. In case of a
342
disagreement between the translation and the original English
343
version of this License, the original English version will prevail.
347
You may not copy, modify, sublicense, or distribute the Document
348
except as expressly provided for under this License. Any other
349
attempt to copy, modify, sublicense or distribute the Document is
350
void, and will automatically terminate your rights under this
351
License. However, parties who have received copies, or rights,
352
from you under this License will not have their licenses
353
terminated so long as such parties remain in full compliance.
355
10. FUTURE REVISIONS OF THIS LICENSE
357
The Free Software Foundation may publish new, revised versions of
358
the GNU Free Documentation License from time to time. Such new
359
versions will be similar in spirit to the present version, but may
360
differ in detail to address new problems or concerns. See
361
http://www.gnu.org/copyleft/.
363
Each version of the License is given a distinguishing version
364
number. If the Document specifies that a particular numbered
365
version of this License "or any later version" applies to it, you
366
have the option of following the terms and conditions either of
367
that specified version or of any later version that has been
368
published (not as a draft) by the Free Software Foundation. If
369
the Document does not specify a version number of this License,
370
you may choose any version ever published (not as a draft) by the
371
Free Software Foundation.
374
ADDENDUM: How to use this License for your documents
375
====================================================
377
To use this License in a document you have written, include a copy of
378
the License in the document and put the following copyright and license
379
notices just after the title page:
382
Copyright (C) YEAR YOUR NAME.
383
Permission is granted to copy, distribute and/or modify this document
384
under the terms of the GNU Free Documentation License, Version 1.1
385
or any later version published by the Free Software Foundation;
386
with the Invariant Sections being LIST THEIR TITLES, with the
387
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
388
A copy of the license is included in the section entitled ``GNU
389
Free Documentation License''.
390
If you have no Invariant Sections, write "with no Invariant
391
Sections" instead of saying which ones are invariant. If you have no
392
Front-Cover Texts, write "no Front-Cover Texts" instead of "Front-Cover
393
Texts being LIST"; likewise for Back-Cover Texts.
395
If your document contains nontrivial examples of program code, we
396
recommend releasing these examples in parallel under your choice of
397
free software license, such as the GNU General Public License, to
398
permit their use in free software.
401
File: wget.info, Node: Concept Index, Prev: Copying, Up: Top
408
* .html extension: HTTP Options.
409
* .listing files, removing: FTP Options.
410
* .netrc: Startup File.
411
* .wgetrc: Startup File.
412
* accept directories: Directory-Based Limits.
413
* accept suffixes: Types of Files.
414
* accept wildcards: Types of Files.
415
* append to log: Logging and Input File Options.
416
* arguments: Invoking.
417
* authentication: HTTP Options.
418
* backing up converted files: Recursive Retrieval Options.
419
* bandwidth, limit: Download Options.
420
* base for relative links in input file: Logging and Input File Options.
421
* bind() address: Download Options.
422
* bug reports: Reporting Bugs.
423
* bugs: Reporting Bugs.
424
* cache: HTTP Options.
425
* caching of DNS lookups: Download Options.
426
* client IP address: Download Options.
427
* clobbering, file: Download Options.
428
* command line: Invoking.
429
* comments, HTML: Recursive Retrieval Options.
430
* connect timeout: Download Options.
431
* Content-Length, ignore: HTTP Options.
432
* continue retrieval: Download Options.
433
* contributors: Contributors.
434
* conversion of links: Recursive Retrieval Options.
435
* cookies: HTTP Options.
436
* cookies, loading: HTTP Options.
437
* cookies, saving: HTTP Options.
439
* cut directories: Directory Options.
440
* debug: Logging and Input File Options.
441
* delete after retrieval: Recursive Retrieval Options.
442
* directories: Directory-Based Limits.
443
* directories, exclude: Directory-Based Limits.
444
* directories, include: Directory-Based Limits.
445
* directory limits: Directory-Based Limits.
446
* directory prefix: Directory Options.
447
* DNS cache: Download Options.
448
* DNS timeout: Download Options.
449
* dot style: Download Options.
450
* downloading multiple times: Download Options.
451
* examples: Examples.
452
* exclude directories: Directory-Based Limits.
453
* execute wgetrc command: Basic Startup Options.
454
* features: Overview.
455
* file names, restrict: Download Options.
456
* filling proxy cache: Recursive Retrieval Options.
457
* follow FTP links: Recursive Accept/Reject Options.
458
* following ftp links: FTP Links.
459
* following links: Following Links.
460
* force html: Logging and Input File Options.
461
* free software: Copying.
462
* ftp time-stamping: FTP Time-Stamping Internals.
464
* globbing, toggle: FTP Options.
467
* header, add: HTTP Options.
468
* hosts, spanning: Spanning Hosts.
469
* HTML comments: Recursive Retrieval Options.
470
* http password: HTTP Options.
471
* http referer: HTTP Options.
472
* http time-stamping: HTTP Time-Stamping Internals.
473
* http user: HTTP Options.
474
* ignore length: HTTP Options.
475
* include directories: Directory-Based Limits.
476
* incomplete downloads: Download Options.
477
* incremental updating: Time-Stamping.
478
* input-file: Logging and Input File Options.
479
* invoking: Invoking.
480
* IP address, client: Download Options.
481
* latest version: Distribution.
482
* limit bandwidth: Download Options.
483
* link conversion: Recursive Retrieval Options.
484
* links: Following Links.
485
* list: Mailing List.
486
* loading cookies: HTTP Options.
487
* location of wgetrc: Wgetrc Location.
488
* log file: Logging and Input File Options.
489
* mailing list: Mailing List.
490
* mirroring: Very Advanced Usage.
491
* no parent: Directory-Based Limits.
492
* no warranty: GNU General Public License.
493
* no-clobber: Download Options.
495
* number of retries: Download Options.
496
* operating systems: Portability.
497
* option syntax: Option Syntax.
498
* output file: Logging and Input File Options.
499
* overview: Overview.
500
* page requisites: Recursive Retrieval Options.
501
* passive ftp: FTP Options.
502
* pause: Download Options.
503
* portability: Portability.
504
* POST: HTTP Options.
505
* progress indicator: Download Options.
507
* proxy <1>: HTTP Options.
508
* proxy: Download Options.
509
* proxy authentication: HTTP Options.
510
* proxy filling: Recursive Retrieval Options.
511
* proxy password: HTTP Options.
512
* proxy user: HTTP Options.
513
* quiet: Logging and Input File Options.
514
* quota: Download Options.
515
* random wait: Download Options.
516
* rate, limit: Download Options.
517
* read timeout: Download Options.
518
* recursion: Recursive Retrieval.
519
* recursive retrieval: Recursive Retrieval.
520
* redirecting output: Advanced Usage.
521
* referer, http: HTTP Options.
522
* reject directories: Directory-Based Limits.
523
* reject suffixes: Types of Files.
524
* reject wildcards: Types of Files.
525
* relative links: Relative Links.
526
* reporting bugs: Reporting Bugs.
527
* required images, downloading: Recursive Retrieval Options.
528
* resume download: Download Options.
529
* retries: Download Options.
530
* retries, waiting between: Download Options.
531
* retrieving: Recursive Retrieval.
532
* robot exclusion: Robot Exclusion.
533
* robots.txt: Robot Exclusion.
534
* sample wgetrc: Sample Wgetrc.
535
* saving cookies: HTTP Options.
536
* security: Security Considerations.
537
* server maintenance: Robot Exclusion.
538
* server response, print: Download Options.
539
* server response, save: HTTP Options.
540
* signal handling: Signals.
541
* spanning hosts: Spanning Hosts.
542
* spider: Download Options.
543
* startup: Startup File.
544
* startup file: Startup File.
545
* suffixes, accept: Types of Files.
546
* suffixes, reject: Types of Files.
547
* symbolic links, retrieving: FTP Options.
548
* syntax of options: Option Syntax.
549
* syntax of wgetrc: Wgetrc Syntax.
550
* tag-based recursive pruning: Recursive Accept/Reject Options.
551
* time-stamping: Time-Stamping.
552
* time-stamping usage: Time-Stamping Usage.
553
* timeout: Download Options.
554
* timeout, connect: Download Options.
555
* timeout, DNS: Download Options.
556
* timeout, read: Download Options.
557
* timestamping: Time-Stamping.
558
* tries: Download Options.
559
* types of files: Types of Files.
560
* updating the archives: Time-Stamping.
562
* URL syntax: URL Format.
563
* usage, time-stamping: Time-Stamping Usage.
564
* user-agent: HTTP Options.
566
* verbose: Logging and Input File Options.
567
* wait: Download Options.
568
* wait, random: Download Options.
569
* waiting between retries: Download Options.
570
* Wget as spider: Download Options.
571
* wgetrc: Startup File.
572
* wgetrc commands: Wgetrc Commands.
573
* wgetrc location: Wgetrc Location.
574
* wgetrc syntax: Wgetrc Syntax.
575
* wildcards, accept: Types of Files.
576
* wildcards, reject: Types of Files.
577
* Windows file names: Download Options.