]> sjero.net Git - wget/blob - doc/wget.info-3
[svn] * TODO: Removed done item: we now have an option (-G) that makes it easy to
[wget] / doc / wget.info-3
1 This is Info file wget.info, produced by Makeinfo version 1.68 from the
2 input file ./wget.texi.
3
4 INFO-DIR-SECTION Net Utilities
5 INFO-DIR-SECTION World Wide Web
6 START-INFO-DIR-ENTRY
7 * Wget: (wget).         The non-interactive network downloader.
8 END-INFO-DIR-ENTRY
9
10    This file documents the the GNU Wget utility for downloading network
11 data.
12
13    Copyright (C) 1996, 1997, 1998, 2000 Free Software Foundation, Inc.
14
15    Permission is granted to make and distribute verbatim copies of this
16 manual provided the copyright notice and this permission notice are
17 preserved on all copies.
18
19    Permission is granted to copy and distribute modified versions of
20 this manual under the conditions for verbatim copying, provided also
21 that the sections entitled "Copying" and "GNU General Public License"
22 are included exactly as in the original, and provided that the entire
23 resulting derived work is distributed under the terms of a permission
24 notice identical to this one.
25
26 \1f
27 File: wget.info,  Node: Copying,  Next: Concept Index,  Prev: Appendices,  Up: Top
28
29 GNU GENERAL PUBLIC LICENSE
30 **************************
31
32                          Version 2, June 1991
33
34      Copyright (C) 1989, 1991 Free Software Foundation, Inc.
35      675 Mass Ave, Cambridge, MA 02139, USA
36      
37      Everyone is permitted to copy and distribute verbatim copies
38      of this license document, but changing it is not allowed.
39
40 Preamble
41 ========
42
43    The licenses for most software are designed to take away your
44 freedom to share and change it.  By contrast, the GNU General Public
45 License is intended to guarantee your freedom to share and change free
46 software--to make sure the software is free for all its users.  This
47 General Public License applies to most of the Free Software
48 Foundation's software and to any other program whose authors commit to
49 using it.  (Some other Free Software Foundation software is covered by
50 the GNU Library General Public License instead.)  You can apply it to
51 your programs, too.
52
53    When we speak of free software, we are referring to freedom, not
54 price.  Our General Public Licenses are designed to make sure that you
55 have the freedom to distribute copies of free software (and charge for
56 this service if you wish), that you receive source code or can get it
57 if you want it, that you can change the software or use pieces of it in
58 new free programs; and that you know you can do these things.
59
60    To protect your rights, we need to make restrictions that forbid
61 anyone to deny you these rights or to ask you to surrender the rights.
62 These restrictions translate to certain responsibilities for you if you
63 distribute copies of the software, or if you modify it.
64
65    For example, if you distribute copies of such a program, whether
66 gratis or for a fee, you must give the recipients all the rights that
67 you have.  You must make sure that they, too, receive or can get the
68 source code.  And you must show them these terms so they know their
69 rights.
70
71    We protect your rights with two steps: (1) copyright the software,
72 and (2) offer you this license which gives you legal permission to copy,
73 distribute and/or modify the software.
74
75    Also, for each author's protection and ours, we want to make certain
76 that everyone understands that there is no warranty for this free
77 software.  If the software is modified by someone else and passed on, we
78 want its recipients to know that what they have is not the original, so
79 that any problems introduced by others will not reflect on the original
80 authors' reputations.
81
82    Finally, any free program is threatened constantly by software
83 patents.  We wish to avoid the danger that redistributors of a free
84 program will individually obtain patent licenses, in effect making the
85 program proprietary.  To prevent this, we have made it clear that any
86 patent must be licensed for everyone's free use or not licensed at all.
87
88    The precise terms and conditions for copying, distribution and
89 modification follow.
90
91     TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
92
93   1. This License applies to any program or other work which contains a
94      notice placed by the copyright holder saying it may be distributed
95      under the terms of this General Public License.  The "Program",
96      below, refers to any such program or work, and a "work based on
97      the Program" means either the Program or any derivative work under
98      copyright law: that is to say, a work containing the Program or a
99      portion of it, either verbatim or with modifications and/or
100      translated into another language.  (Hereinafter, translation is
101      included without limitation in the term "modification".)  Each
102      licensee is addressed as "you".
103
104      Activities other than copying, distribution and modification are
105      not covered by this License; they are outside its scope.  The act
106      of running the Program is not restricted, and the output from the
107      Program is covered only if its contents constitute a work based on
108      the Program (independent of having been made by running the
109      Program).  Whether that is true depends on what the Program does.
110
111   2. You may copy and distribute verbatim copies of the Program's
112      source code as you receive it, in any medium, provided that you
113      conspicuously and appropriately publish on each copy an appropriate
114      copyright notice and disclaimer of warranty; keep intact all the
115      notices that refer to this License and to the absence of any
116      warranty; and give any other recipients of the Program a copy of
117      this License along with the Program.
118
119      You may charge a fee for the physical act of transferring a copy,
120      and you may at your option offer warranty protection in exchange
121      for a fee.
122
123   3. You may modify your copy or copies of the Program or any portion
124      of it, thus forming a work based on the Program, and copy and
125      distribute such modifications or work under the terms of Section 1
126      above, provided that you also meet all of these conditions:
127
128        a. You must cause the modified files to carry prominent notices
129           stating that you changed the files and the date of any change.
130
131        b. You must cause any work that you distribute or publish, that
132           in whole or in part contains or is derived from the Program
133           or any part thereof, to be licensed as a whole at no charge
134           to all third parties under the terms of this License.
135
136        c. If the modified program normally reads commands interactively
137           when run, you must cause it, when started running for such
138           interactive use in the most ordinary way, to print or display
139           an announcement including an appropriate copyright notice and
140           a notice that there is no warranty (or else, saying that you
141           provide a warranty) and that users may redistribute the
142           program under these conditions, and telling the user how to
143           view a copy of this License.  (Exception: if the Program
144           itself is interactive but does not normally print such an
145           announcement, your work based on the Program is not required
146           to print an announcement.)
147
148      These requirements apply to the modified work as a whole.  If
149      identifiable sections of that work are not derived from the
150      Program, and can be reasonably considered independent and separate
151      works in themselves, then this License, and its terms, do not
152      apply to those sections when you distribute them as separate
153      works.  But when you distribute the same sections as part of a
154      whole which is a work based on the Program, the distribution of
155      the whole must be on the terms of this License, whose permissions
156      for other licensees extend to the entire whole, and thus to each
157      and every part regardless of who wrote it.
158
159      Thus, it is not the intent of this section to claim rights or
160      contest your rights to work written entirely by you; rather, the
161      intent is to exercise the right to control the distribution of
162      derivative or collective works based on the Program.
163
164      In addition, mere aggregation of another work not based on the
165      Program with the Program (or with a work based on the Program) on
166      a volume of a storage or distribution medium does not bring the
167      other work under the scope of this License.
168
169   4. You may copy and distribute the Program (or a work based on it,
170      under Section 2) in object code or executable form under the terms
171      of Sections 1 and 2 above provided that you also do one of the
172      following:
173
174        a. Accompany it with the complete corresponding machine-readable
175           source code, which must be distributed under the terms of
176           Sections 1 and 2 above on a medium customarily used for
177           software interchange; or,
178
179        b. Accompany it with a written offer, valid for at least three
180           years, to give any third party, for a charge no more than your
181           cost of physically performing source distribution, a complete
182           machine-readable copy of the corresponding source code, to be
183           distributed under the terms of Sections 1 and 2 above on a
184           medium customarily used for software interchange; or,
185
186        c. Accompany it with the information you received as to the offer
187           to distribute corresponding source code.  (This alternative is
188           allowed only for noncommercial distribution and only if you
189           received the program in object code or executable form with
190           such an offer, in accord with Subsection b above.)
191
192      The source code for a work means the preferred form of the work for
193      making modifications to it.  For an executable work, complete
194      source code means all the source code for all modules it contains,
195      plus any associated interface definition files, plus the scripts
196      used to control compilation and installation of the executable.
197      However, as a special exception, the source code distributed need
198      not include anything that is normally distributed (in either
199      source or binary form) with the major components (compiler,
200      kernel, and so on) of the operating system on which the executable
201      runs, unless that component itself accompanies the executable.
202
203      If distribution of executable or object code is made by offering
204      access to copy from a designated place, then offering equivalent
205      access to copy the source code from the same place counts as
206      distribution of the source code, even though third parties are not
207      compelled to copy the source along with the object code.
208
209   5. You may not copy, modify, sublicense, or distribute the Program
210      except as expressly provided under this License.  Any attempt
211      otherwise to copy, modify, sublicense or distribute the Program is
212      void, and will automatically terminate your rights under this
213      License.  However, parties who have received copies, or rights,
214      from you under this License will not have their licenses
215      terminated so long as such parties remain in full compliance.
216
217   6. You are not required to accept this License, since you have not
218      signed it.  However, nothing else grants you permission to modify
219      or distribute the Program or its derivative works.  These actions
220      are prohibited by law if you do not accept this License.
221      Therefore, by modifying or distributing the Program (or any work
222      based on the Program), you indicate your acceptance of this
223      License to do so, and all its terms and conditions for copying,
224      distributing or modifying the Program or works based on it.
225
226   7. Each time you redistribute the Program (or any work based on the
227      Program), the recipient automatically receives a license from the
228      original licensor to copy, distribute or modify the Program
229      subject to these terms and conditions.  You may not impose any
230      further restrictions on the recipients' exercise of the rights
231      granted herein.  You are not responsible for enforcing compliance
232      by third parties to this License.
233
234   8. If, as a consequence of a court judgment or allegation of patent
235      infringement or for any other reason (not limited to patent
236      issues), conditions are imposed on you (whether by court order,
237      agreement or otherwise) that contradict the conditions of this
238      License, they do not excuse you from the conditions of this
239      License.  If you cannot distribute so as to satisfy simultaneously
240      your obligations under this License and any other pertinent
241      obligations, then as a consequence you may not distribute the
242      Program at all.  For example, if a patent license would not permit
243      royalty-free redistribution of the Program by all those who
244      receive copies directly or indirectly through you, then the only
245      way you could satisfy both it and this License would be to refrain
246      entirely from distribution of the Program.
247
248      If any portion of this section is held invalid or unenforceable
249      under any particular circumstance, the balance of the section is
250      intended to apply and the section as a whole is intended to apply
251      in other circumstances.
252
253      It is not the purpose of this section to induce you to infringe any
254      patents or other property right claims or to contest validity of
255      any such claims; this section has the sole purpose of protecting
256      the integrity of the free software distribution system, which is
257      implemented by public license practices.  Many people have made
258      generous contributions to the wide range of software distributed
259      through that system in reliance on consistent application of that
260      system; it is up to the author/donor to decide if he or she is
261      willing to distribute software through any other system and a
262      licensee cannot impose that choice.
263
264      This section is intended to make thoroughly clear what is believed
265      to be a consequence of the rest of this License.
266
267   9. If the distribution and/or use of the Program is restricted in
268      certain countries either by patents or by copyrighted interfaces,
269      the original copyright holder who places the Program under this
270      License may add an explicit geographical distribution limitation
271      excluding those countries, so that distribution is permitted only
272      in or among countries not thus excluded.  In such case, this
273      License incorporates the limitation as if written in the body of
274      this License.
275
276  10. The Free Software Foundation may publish revised and/or new
277      versions of the General Public License from time to time.  Such
278      new versions will be similar in spirit to the present version, but
279      may differ in detail to address new problems or concerns.
280
281      Each version is given a distinguishing version number.  If the
282      Program specifies a version number of this License which applies
283      to it and "any later version", you have the option of following
284      the terms and conditions either of that version or of any later
285      version published by the Free Software Foundation.  If the Program
286      does not specify a version number of this License, you may choose
287      any version ever published by the Free Software Foundation.
288
289  11. If you wish to incorporate parts of the Program into other free
290      programs whose distribution conditions are different, write to the
291      author to ask for permission.  For software which is copyrighted
292      by the Free Software Foundation, write to the Free Software
293      Foundation; we sometimes make exceptions for this.  Our decision
294      will be guided by the two goals of preserving the free status of
295      all derivatives of our free software and of promoting the sharing
296      and reuse of software generally.
297
298                                 NO WARRANTY
299
300  12. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO
301      WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
302      LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
303      HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
304      WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT
305      NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
306      FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE
307      QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
308      PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
309      SERVICING, REPAIR OR CORRECTION.
310
311  13. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
312      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
313      MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE
314      LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
315      INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
316      INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
317      DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU
318      OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
319      OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
320      ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
321
322                       END OF TERMS AND CONDITIONS
323
324 How to Apply These Terms to Your New Programs
325 =============================================
326
327    If you develop a new program, and you want it to be of the greatest
328 possible use to the public, the best way to achieve this is to make it
329 free software which everyone can redistribute and change under these
330 terms.
331
332    To do so, attach the following notices to the program.  It is safest
333 to attach them to the start of each source file to most effectively
334 convey the exclusion of warranty; and each file should have at least
335 the "copyright" line and a pointer to where the full notice is found.
336
337      ONE LINE TO GIVE THE PROGRAM'S NAME AND AN IDEA OF WHAT IT DOES.
338      Copyright (C) 19YY  NAME OF AUTHOR
339      
340      This program is free software; you can redistribute it and/or
341      modify it under the terms of the GNU General Public License
342      as published by the Free Software Foundation; either version 2
343      of the License, or (at your option) any later version.
344      
345      This program is distributed in the hope that it will be useful,
346      but WITHOUT ANY WARRANTY; without even the implied warranty of
347      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
348      GNU General Public License for more details.
349      
350      You should have received a copy of the GNU General Public License
351      along with this program; if not, write to the Free Software
352      Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
353
354    Also add information on how to contact you by electronic and paper
355 mail.
356
357    If the program is interactive, make it output a short notice like
358 this when it starts in an interactive mode:
359
360      Gnomovision version 69, Copyright (C) 19YY NAME OF AUTHOR
361      Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
362      type `show w'.  This is free software, and you are welcome
363      to redistribute it under certain conditions; type `show c'
364      for details.
365
366    The hypothetical commands `show w' and `show c' should show the
367 appropriate parts of the General Public License.  Of course, the
368 commands you use may be called something other than `show w' and `show
369 c'; they could even be mouse-clicks or menu items--whatever suits your
370 program.
371
372    You should also get your employer (if you work as a programmer) or
373 your school, if any, to sign a "copyright disclaimer" for the program,
374 if necessary.  Here is a sample; alter the names:
375
376      Yoyodyne, Inc., hereby disclaims all copyright
377      interest in the program `Gnomovision'
378      (which makes passes at compilers) written
379      by James Hacker.
380      
381      SIGNATURE OF TY COON, 1 April 1989
382      Ty Coon, President of Vice
383
384    This General Public License does not permit incorporating your
385 program into proprietary programs.  If your program is a subroutine
386 library, you may consider it more useful to permit linking proprietary
387 applications with the library.  If this is what you want to do, use the
388 GNU Library General Public License instead of this License.
389
390 \1f
391 File: wget.info,  Node: Concept Index,  Prev: Copying,  Up: Top
392
393 Concept Index
394 *************
395
396 * Menu:
397
398 * .netrc:                                Startup File.
399 * .wgetrc:                               Startup File.
400 * accept directories:                    Directory-Based Limits.
401 * accept suffixes:                       Types of Files.
402 * accept wildcards:                      Types of Files.
403 * all hosts:                             All Hosts.
404 * append to log:                         Logging and Input File Options.
405 * arguments:                             Invoking.
406 * authentication:                        HTTP Options.
407 * backing up converted files:            Recursive Retrieval Options.
408 * bug reports:                           Reporting Bugs.
409 * bugs:                                  Reporting Bugs.
410 * cache:                                 HTTP Options.
411 * command line:                          Invoking.
412 * Content-Length, ignore:                HTTP Options.
413 * continue retrieval:                    Download Options.
414 * contributors:                          Contributors.
415 * conversion of links:                   Recursive Retrieval Options.
416 * copying:                               Copying.
417 * cut directories:                       Directory Options.
418 * debug:                                 Logging and Input File Options.
419 * delete after retrieval:                Recursive Retrieval Options.
420 * directories:                           Directory-Based Limits.
421 * directories, exclude:                  Directory-Based Limits.
422 * directories, include:                  Directory-Based Limits.
423 * directory limits:                      Directory-Based Limits.
424 * directory prefix:                      Directory Options.
425 * DNS lookup:                            Host Checking.
426 * dot style:                             Download Options.
427 * examples:                              Examples.
428 * exclude directories:                   Directory-Based Limits.
429 * execute wgetrc command:                Basic Startup Options.
430 * features:                              Overview.
431 * filling proxy cache:                   Recursive Retrieval Options.
432 * follow FTP links:                      Recursive Accept/Reject Options.
433 * following ftp links:                   FTP Links.
434 * following links:                       Following Links.
435 * force html:                            Logging and Input File Options.
436 * ftp time-stamping:                     FTP Time-Stamping Internals.
437 * globbing, toggle:                      FTP Options.
438 * GPL:                                   Copying.
439 * hangup:                                Signals.
440 * header, add:                           HTTP Options.
441 * host checking:                         Host Checking.
442 * host lookup:                           Host Checking.
443 * http password:                         HTTP Options.
444 * http time-stamping:                    HTTP Time-Stamping Internals.
445 * http user:                             HTTP Options.
446 * ignore length:                         HTTP Options.
447 * include directories:                   Directory-Based Limits.
448 * incremental updating:                  Time-Stamping.
449 * input-file:                            Logging and Input File Options.
450 * invoking:                              Invoking.
451 * latest version:                        Distribution.
452 * link conversion:                       Recursive Retrieval Options.
453 * links:                                 Following Links.
454 * list:                                  Mailing List.
455 * location of wgetrc:                    Wgetrc Location.
456 * log file:                              Logging and Input File Options.
457 * mailing list:                          Mailing List.
458 * mirroring:                             Guru Usage.
459 * no parent:                             Directory-Based Limits.
460 * no warranty:                           Copying.
461 * no-clobber:                            Download Options.
462 * nohup:                                 Invoking.
463 * norobots disallow:                     Disallow Field.
464 * norobots examples:                     Norobots Examples.
465 * norobots format:                       RES Format.
466 * norobots introduction:                 Introduction to RES.
467 * norobots user-agent:                   User-Agent Field.
468 * number of retries:                     Download Options.
469 * operating systems:                     Portability.
470 * option syntax:                         Option Syntax.
471 * output file:                           Logging and Input File Options.
472 * overview:                              Overview.
473 * passive ftp:                           FTP Options.
474 * pause:                                 Download Options.
475 * portability:                           Portability.
476 * proxies:                               Proxies.
477 * proxy <1>:                             Download Options.
478 * proxy:                                 HTTP Options.
479 * proxy authentication:                  HTTP Options.
480 * proxy filling:                         Recursive Retrieval Options.
481 * proxy password:                        HTTP Options.
482 * proxy user:                            HTTP Options.
483 * quiet:                                 Logging and Input File Options.
484 * quota:                                 Download Options.
485 * recursion:                             Recursive Retrieval.
486 * recursive retrieval:                   Recursive Retrieval.
487 * redirecting output:                    Guru Usage.
488 * reject directories:                    Directory-Based Limits.
489 * reject suffixes:                       Types of Files.
490 * reject wildcards:                      Types of Files.
491 * relative links:                        Relative Links.
492 * reporting bugs:                        Reporting Bugs.
493 * retries:                               Download Options.
494 * retrieval tracing style:               Download Options.
495 * retrieve symbolic links:               FTP Options.
496 * retrieving:                            Recursive Retrieval.
497 * robots:                                Robots.
498 * robots.txt:                            Robots.
499 * sample wgetrc:                         Sample Wgetrc.
500 * security:                              Security Considerations.
501 * server maintenance:                    Robots.
502 * server response, print:                Download Options.
503 * server response, save:                 HTTP Options.
504 * signal handling:                       Signals.
505 * span hosts:                            All Hosts.
506 * spider:                                Download Options.
507 * startup:                               Startup File.
508 * startup file:                          Startup File.
509 * suffixes, accept:                      Types of Files.
510 * suffixes, reject:                      Types of Files.
511 * syntax of options:                     Option Syntax.
512 * syntax of wgetrc:                      Wgetrc Syntax.
513 * tag-based recursive pruning:           Recursive Accept/Reject Options.
514 * time-stamping:                         Time-Stamping.
515 * time-stamping usage:                   Time-Stamping Usage.
516 * timeout:                               Download Options.
517 * timestamping:                          Time-Stamping.
518 * tries:                                 Download Options.
519 * types of files:                        Types of Files.
520 * updating the archives:                 Time-Stamping.
521 * URL:                                   URL Format.
522 * URL syntax:                            URL Format.
523 * usage, time-stamping:                  Time-Stamping Usage.
524 * user-agent:                            HTTP Options.
525 * various:                               Various.
526 * verbose:                               Logging and Input File Options.
527 * wait:                                  Download Options.
528 * Wget as spider:                        Download Options.
529 * wgetrc:                                Startup File.
530 * wgetrc commands:                       Wgetrc Commands.
531 * wgetrc location:                       Wgetrc Location.
532 * wgetrc syntax:                         Wgetrc Syntax.
533 * wildcards, accept:                     Types of Files.
534 * wildcards, reject:                     Types of Files.
535
536