« back to all changes in this revision
Viewing changes to doc/wget.texi
- browse files at revision 4
- compare with another revision
- download diff
- download tarball
- view history from revision 4
- Committer: Bazaar Package Importer
- Author(s): Noèl Köthe
- Date: 2005-10-13 16:59:03 UTC
- mfrom: (1.1.2 upstream)
- Revision ID: james.westby@ubuntu.com-20051013165903-3e12j4gn6znkhmdb
Tags: 1.10.2-1
new upstream release which fixes a NTLM Buffer Overflow Vulnerability
- files added:
- README.checkout
- m4
- files removed:
- ChangeLog-branches
- doc/ChangeLog-branches
- src/ChangeLog-branches
- files modified:
- COPYING
added
removed
doc/wget.texi
57
57
@title GNU Wget @value{VERSION}
58
58
@subtitle The non-interactive download utility
59
59
@subtitle Updated for Wget @value{VERSION}, @value{UPDATED}
60
@author by Hrvoje Nik@v{s}i@'{c} and the developers
60
@author by Hrvoje Nik@v{s}i@'{c} and others
61
61
62
62
@ignore
63
63
@c man begin AUTHOR
128
128
which can be a great hindrance when transferring a lot of data.
129
129
@c man end
130
130
131
@sp 1
132
131
@item
133
132
@ignore
134
133
@c man begin DESCRIPTION
145
144
viewing.
146
145
@c man end
147
146
148
@sp 1
149
147
@item
150
148
File name wildcard matching and recursive mirroring of directories are
151
149
available when retrieving via @sc{ftp}. Wget can read the time-stamp
155
153
makes Wget suitable for mirroring of @sc{ftp} sites, as well as home
156
154
pages.
157
155
158
@sp 1
159
156
@item
160
157
@ignore
161
158
@c man begin DESCRIPTION
170
167
download from where it left off.
171
168
@c man end
172
169
173
@sp 1
174
170
@item
175
171
Wget supports proxy servers, which can lighten the network load, speed
176
172
up retrieval and provide access behind firewalls. However, if you are
179
175
Wget uses the passive @sc{ftp} downloading by default, active @sc{ftp}
180
176
being an option.
181
177
182
@sp 1
183
178
@item
184
179
Wget supports IP version 6, the next generation of IP. IPv6 is
185
180
autodetected at compile-time, and can be disabled at either build or
186
181
run time. Binaries built with IPv6 support work well in both
187
182
IPv4-only and dual family environments.
188
183
189
@sp 1
190
184
@item
191
185
Built-in features offer mechanisms to tune which links you wish to follow
192
186
(@pxref{Following Links}).
193
187
194
@sp 1
195
188
@item
196
189
The progress of individual downloads is traced using a progress gauge.
197
190
Interactive downloads are tracked using a ``thermometer''-style gauge,
199
192
representing a fixed amount of data received (1KB by default). Either
200
193
gauge can be customized to your preferences.
201
194
202
@sp 1
203
195
@item
204
196
Most of the features are fully configurable, either through command line
205
197
options, or via the initialization file @file{.wgetrc} (@pxref{Startup
218
210
@c man end
219
211
@end ignore
220
212
221
@sp 1
222
213
@item
223
214
Finally, GNU Wget is free software. This means that everyone may use
224
215
it, redistribute it and/or modify it under the terms of the GNU General
486
477
is verbose.
487
478
488
479
@item -nv
489
@itemx --non-verbose
490
Non-verbose output---turn off verbose without being completely quiet
491
(use @samp{-q} for that), which means that error messages and basic
492
information still get printed.
480
@itemx --no-verbose
481
Turn off verbose without being completely quiet (use @samp{-q} for
482
that), which means that error messages and basic information still get
483
printed.
493
484
494
485
@cindex input-file
495
486
@item -i @var{file}
523
514
@cindex base for relative links in input file
524
515
@item -B @var{URL}
525
516
@itemx --base=@var{URL}
526
When used in conjunction with @samp{-F}, prepends @var{URL} to relative
527
links in the file specified by @samp{-i}.
517
Prepends @var{URL} to relative links read from the file specified with
518
the @samp{-i} option.
528
519
@end table
529
520
530
521
@node Download Options
928
919
929
920
Neither options should be needed normally. By default, an IPv6-aware
930
921
Wget will use the address family specified by the host's DNS record.
931
If the DNS specifies both an A record and an AAAA record, Wget will
932
try them in sequence until it finds one it can connect to.
922
If the DNS responds with both IPv4 and IPv6 addresses, Wget will them
923
in sequence until it finds one it can connect to. (Also see
924
@code{--prefer-family} option described below.)
933
925
934
926
These options can be used to deliberately force the use of IPv4 or
935
927
IPv6 address families on dual family systems, usually to aid debugging
936
928
or to deal with broken network configuration. Only one of
937
@samp{--inet6-only} and @samp{--inet4-only} may be specified in the
938
same command. Neither option is available in Wget compiled without
939
IPv6 support.
929
@samp{--inet6-only} and @samp{--inet4-only} may be specified at the
930
same time. Neither option is available in Wget compiled without IPv6
931
support.
940
932
941
933
@item --prefer-family=IPv4/IPv6/none
942
934
When given a choice of several addresses, connect to the addresses
2677
2669
@item input = @var{file}
2678
2670
Read the @sc{url}s from @var{string}, like @samp{-i @var{file}}.
2679
2671
2680
@item kill_longer = on/off
2681
Consider data longer than specified in content-length header as invalid
2682
(and retry getting it). The default behavior is to save as much data
2683
as there is, provided there is more than or equal to the value in
2684
@code{Content-Length}.
2685
2686
2672
@item limit_rate = @var{rate}
2687
2673
Limit the download speed to no more than @var{rate} bytes per second.
2688
2674
The same as @samp{--limit-rate=@var{rate}}.
3279
3265
@email{wget-unsubscribe@@sunsite.dk}. The mailing list is archived at
3280
3266
@url{http://news.gmane.org/gmane.comp.web.wget.patches}.
3281
3267
3282
Finally, there is a read-only list at @email{wget-cvs@@sunsite.dk}
3283
that tracks commits to the Wget CVS repository. To subscribe to that
3284
list, send mail to @email{wget-cvs-subscribe@@sunsite.dk}. The list
3285
is not archived.
3286
3287
3268
@node Reporting Bugs
3288
3269
@section Reporting Bugs
3289
3270
@cindex bugs
3712
3693
@end ifnottex
3713
3694
Dave Love,
3714
3695
Alexander V. Lukyanov,
3696
@iftex
3697
Thomas Lu@ss{}nig,
3698
@end iftex
3699
@ifnottex
3715
3700
Thomas Lussnig,
3701
@end ifnottex
3716
3702
Andre Majorel,
3717
3703
Aurelien Marchand,
3718
3704
Matthew J. Mellon,
3866
3852
* GNU Free Documentation License::
3867
3853
@end menu
3868
3854
3869
@node GNU General Public License
3870
@section GNU General Public License
3871
@center Version 2, June 1991
3872
3873
@display
3874
Copyright @copyright{} 1989, 1991 Free Software Foundation, Inc.
3875
675 Mass Ave, Cambridge, MA 02139, USA
3876
3877
Everyone is permitted to copy and distribute verbatim copies
3878
of this license document, but changing it is not allowed.
3879
@end display
3880
3881
@unnumberedsec Preamble
3882
3883
The licenses for most software are designed to take away your
3884
freedom to share and change it. By contrast, the GNU General Public
3885
License is intended to guarantee your freedom to share and change free
3886
software---to make sure the software is free for all its users. This
3887
General Public License applies to most of the Free Software
3888
Foundation's software and to any other program whose authors commit to
3889
using it. (Some other Free Software Foundation software is covered by
3890
the GNU Library General Public License instead.) You can apply it to
3891
your programs, too.
3892
3893
When we speak of free software, we are referring to freedom, not
3894
price. Our General Public Licenses are designed to make sure that you
3895
have the freedom to distribute copies of free software (and charge for
3896
this service if you wish), that you receive source code or can get it
3897
if you want it, that you can change the software or use pieces of it
3898
in new free programs; and that you know you can do these things.
3899
3900
To protect your rights, we need to make restrictions that forbid
3901
anyone to deny you these rights or to ask you to surrender the rights.
3902
These restrictions translate to certain responsibilities for you if you
3903
distribute copies of the software, or if you modify it.
3904
3905
For example, if you distribute copies of such a program, whether
3906
gratis or for a fee, you must give the recipients all the rights that
3907
you have. You must make sure that they, too, receive or can get the
3908
source code. And you must show them these terms so they know their
3909
rights.
3910
3911
We protect your rights with two steps: (1) copyright the software, and
3912
(2) offer you this license which gives you legal permission to copy,
3913
distribute and/or modify the software.
3914
3915
Also, for each author's protection and ours, we want to make certain
3916
that everyone understands that there is no warranty for this free
3917
software. If the software is modified by someone else and passed on, we
3918
want its recipients to know that what they have is not the original, so
3919
that any problems introduced by others will not reflect on the original
3920
authors' reputations.
3921
3922
Finally, any free program is threatened constantly by software
3923
patents. We wish to avoid the danger that redistributors of a free
3924
program will individually obtain patent licenses, in effect making the
3925
program proprietary. To prevent this, we have made it clear that any
3926
patent must be licensed for everyone's free use or not licensed at all.
3927
3928
The precise terms and conditions for copying, distribution and
3929
modification follow.
3930
3931
@iftex
3932
@unnumberedsec TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
3933
@end iftex
3934
@ifnottex
3935
@center TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
3936
@end ifnottex
3937
3938
@enumerate
3939
@item
3940
This License applies to any program or other work which contains
3941
a notice placed by the copyright holder saying it may be distributed
3942
under the terms of this General Public License. The ``Program'', below,
3943
refers to any such program or work, and a ``work based on the Program''
3944
means either the Program or any derivative work under copyright law:
3945
that is to say, a work containing the Program or a portion of it,
3946
either verbatim or with modifications and/or translated into another
3947
language. (Hereinafter, translation is included without limitation in
3948
the term ``modification''.) Each licensee is addressed as ``you''.
3949
3950
Activities other than copying, distribution and modification are not
3951
covered by this License; they are outside its scope. The act of
3952
running the Program is not restricted, and the output from the Program
3953
is covered only if its contents constitute a work based on the
3954
Program (independent of having been made by running the Program).
3955
Whether that is true depends on what the Program does.
3956
3957
@item
3958
You may copy and distribute verbatim copies of the Program's
3959
source code as you receive it, in any medium, provided that you
3960
conspicuously and appropriately publish on each copy an appropriate
3961
copyright notice and disclaimer of warranty; keep intact all the
3962
notices that refer to this License and to the absence of any warranty;
3963
and give any other recipients of the Program a copy of this License
3964
along with the Program.
3965
3966
You may charge a fee for the physical act of transferring a copy, and
3967
you may at your option offer warranty protection in exchange for a fee.
3968
3969
@item
3970
You may modify your copy or copies of the Program or any portion
3971
of it, thus forming a work based on the Program, and copy and
3972
distribute such modifications or work under the terms of Section 1
3973
above, provided that you also meet all of these conditions:
3974
3975
@enumerate a
3976
@item
3977
You must cause the modified files to carry prominent notices
3978
stating that you changed the files and the date of any change.
3979
3980
@item
3981
You must cause any work that you distribute or publish, that in
3982
whole or in part contains or is derived from the Program or any
3983
part thereof, to be licensed as a whole at no charge to all third
3984
parties under the terms of this License.
3985
3986
@item
3987
If the modified program normally reads commands interactively
3988
when run, you must cause it, when started running for such
3989
interactive use in the most ordinary way, to print or display an
3990
announcement including an appropriate copyright notice and a
3991
notice that there is no warranty (or else, saying that you provide
3992
a warranty) and that users may redistribute the program under
3993
these conditions, and telling the user how to view a copy of this
3994
License. (Exception: if the Program itself is interactive but
3995
does not normally print such an announcement, your work based on
3996
the Program is not required to print an announcement.)
3997
@end enumerate
3998
3999
These requirements apply to the modified work as a whole. If
4000
identifiable sections of that work are not derived from the Program,
4001
and can be reasonably considered independent and separate works in
4002
themselves, then this License, and its terms, do not apply to those
4003
sections when you distribute them as separate works. But when you
4004
distribute the same sections as part of a whole which is a work based
4005
on the Program, the distribution of the whole must be on the terms of
4006
this License, whose permissions for other licensees extend to the
4007
entire whole, and thus to each and every part regardless of who wrote it.
4008
4009
Thus, it is not the intent of this section to claim rights or contest
4010
your rights to work written entirely by you; rather, the intent is to
4011
exercise the right to control the distribution of derivative or
4012
collective works based on the Program.
4013
4014
In addition, mere aggregation of another work not based on the Program
4015
with the Program (or with a work based on the Program) on a volume of
4016
a storage or distribution medium does not bring the other work under
4017
the scope of this License.
4018
4019
@item
4020
You may copy and distribute the Program (or a work based on it,
4021
under Section 2) in object code or executable form under the terms of
4022
Sections 1 and 2 above provided that you also do one of the following:
4023
4024
@enumerate a
4025
@item
4026
Accompany it with the complete corresponding machine-readable
4027
source code, which must be distributed under the terms of Sections
4028
1 and 2 above on a medium customarily used for software interchange; or,
4029
4030
@item
4031
Accompany it with a written offer, valid for at least three
4032
years, to give any third party, for a charge no more than your
4033
cost of physically performing source distribution, a complete
4034
machine-readable copy of the corresponding source code, to be
4035
distributed under the terms of Sections 1 and 2 above on a medium
4036
customarily used for software interchange; or,
4037
4038
@item
4039
Accompany it with the information you received as to the offer
4040
to distribute corresponding source code. (This alternative is
4041
allowed only for noncommercial distribution and only if you
4042
received the program in object code or executable form with such
4043
an offer, in accord with Subsection b above.)
4044
@end enumerate
4045
4046
The source code for a work means the preferred form of the work for
4047
making modifications to it. For an executable work, complete source
4048
code means all the source code for all modules it contains, plus any
4049
associated interface definition files, plus the scripts used to
4050
control compilation and installation of the executable. However, as a
4051
special exception, the source code distributed need not include
4052
anything that is normally distributed (in either source or binary
4053
form) with the major components (compiler, kernel, and so on) of the
4054
operating system on which the executable runs, unless that component
4055
itself accompanies the executable.
4056
4057
If distribution of executable or object code is made by offering
4058
access to copy from a designated place, then offering equivalent
4059
access to copy the source code from the same place counts as
4060
distribution of the source code, even though third parties are not
4061
compelled to copy the source along with the object code.
4062
4063
@item
4064
You may not copy, modify, sublicense, or distribute the Program
4065
except as expressly provided under this License. Any attempt
4066
otherwise to copy, modify, sublicense or distribute the Program is
4067
void, and will automatically terminate your rights under this License.
4068
However, parties who have received copies, or rights, from you under
4069
this License will not have their licenses terminated so long as such
4070
parties remain in full compliance.
4071
4072
@item
4073
You are not required to accept this License, since you have not
4074
signed it. However, nothing else grants you permission to modify or
4075
distribute the Program or its derivative works. These actions are
4076
prohibited by law if you do not accept this License. Therefore, by
4077
modifying or distributing the Program (or any work based on the
4078
Program), you indicate your acceptance of this License to do so, and
4079
all its terms and conditions for copying, distributing or modifying
4080
the Program or works based on it.
4081
4082
@item
4083
Each time you redistribute the Program (or any work based on the
4084
Program), the recipient automatically receives a license from the
4085
original licensor to copy, distribute or modify the Program subject to
4086
these terms and conditions. You may not impose any further
4087
restrictions on the recipients' exercise of the rights granted herein.
4088
You are not responsible for enforcing compliance by third parties to
4089
this License.
4090
4091
@item
4092
If, as a consequence of a court judgment or allegation of patent
4093
infringement or for any other reason (not limited to patent issues),
4094
conditions are imposed on you (whether by court order, agreement or
4095
otherwise) that contradict the conditions of this License, they do not
4096
excuse you from the conditions of this License. If you cannot
4097
distribute so as to satisfy simultaneously your obligations under this
4098
License and any other pertinent obligations, then as a consequence you
4099
may not distribute the Program at all. For example, if a patent
4100
license would not permit royalty-free redistribution of the Program by
4101
all those who receive copies directly or indirectly through you, then
4102
the only way you could satisfy both it and this License would be to
4103
refrain entirely from distribution of the Program.
4104
4105
If any portion of this section is held invalid or unenforceable under
4106
any particular circumstance, the balance of the section is intended to
4107
apply and the section as a whole is intended to apply in other
4108
circumstances.
4109
4110
It is not the purpose of this section to induce you to infringe any
4111
patents or other property right claims or to contest validity of any
4112
such claims; this section has the sole purpose of protecting the
4113
integrity of the free software distribution system, which is
4114
implemented by public license practices. Many people have made
4115
generous contributions to the wide range of software distributed
4116
through that system in reliance on consistent application of that
4117
system; it is up to the author/donor to decide if he or she is willing
4118
to distribute software through any other system and a licensee cannot
4119
impose that choice.
4120
4121
This section is intended to make thoroughly clear what is believed to
4122
be a consequence of the rest of this License.
4123
4124
@item
4125
If the distribution and/or use of the Program is restricted in
4126
certain countries either by patents or by copyrighted interfaces, the
4127
original copyright holder who places the Program under this License
4128
may add an explicit geographical distribution limitation excluding
4129
those countries, so that distribution is permitted only in or among
4130
countries not thus excluded. In such case, this License incorporates
4131
the limitation as if written in the body of this License.
4132
4133
@item
4134
The Free Software Foundation may publish revised and/or new versions
4135
of the General Public License from time to time. Such new versions will
4136
be similar in spirit to the present version, but may differ in detail to
4137
address new problems or concerns.
4138
4139
Each version is given a distinguishing version number. If the Program
4140
specifies a version number of this License which applies to it and ``any
4141
later version'', you have the option of following the terms and conditions
4142
either of that version or of any later version published by the Free
4143
Software Foundation. If the Program does not specify a version number of
4144
this License, you may choose any version ever published by the Free Software
4145
Foundation.
4146
4147
@item
4148
If you wish to incorporate parts of the Program into other free
4149
programs whose distribution conditions are different, write to the author
4150
to ask for permission. For software which is copyrighted by the Free
4151
Software Foundation, write to the Free Software Foundation; we sometimes
4152
make exceptions for this. Our decision will be guided by the two goals
4153
of preserving the free status of all derivatives of our free software and
4154
of promoting the sharing and reuse of software generally.
4155
4156
@iftex
4157
@heading NO WARRANTY
4158
@end iftex
4159
@ifnottex
4160
@center NO WARRANTY
4161
@end ifnottex
4162
@cindex no warranty
4163
4164
@item
4165
BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
4166
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
4167
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
4168
PROVIDE THE PROGRAM ``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
4169
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
4170
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
4171
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
4172
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
4173
REPAIR OR CORRECTION.
4174
4175
@item
4176
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
4177
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
4178
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
4179
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
4180
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
4181
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
4182
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
4183
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
4184
POSSIBILITY OF SUCH DAMAGES.
4185
@end enumerate
4186
4187
@iftex
4188
@heading END OF TERMS AND CONDITIONS
4189
@end iftex
4190
@ifnottex
4191
@center END OF TERMS AND CONDITIONS
4192
@end ifnottex
4193
4194
@page
4195
@unnumberedsec How to Apply These Terms to Your New Programs
4196
4197
If you develop a new program, and you want it to be of the greatest
4198
possible use to the public, the best way to achieve this is to make it
4199
free software which everyone can redistribute and change under these terms.
4200
4201
To do so, attach the following notices to the program. It is safest
4202
to attach them to the start of each source file to most effectively
4203
convey the exclusion of warranty; and each file should have at least
4204
the ``copyright'' line and a pointer to where the full notice is found.
4205
4206
@smallexample
4207
@var{one line to give the program's name and an idea of what it does.}
4208
Copyright (C) 20@var{yy} @var{name of author}
4209
4210
This program is free software; you can redistribute it and/or
4211
modify it under the terms of the GNU General Public License
4212
as published by the Free Software Foundation; either version 2
4213
of the License, or (at your option) any later version.
4214
4215
This program is distributed in the hope that it will be useful,
4216
but WITHOUT ANY WARRANTY; without even the implied warranty of
4217
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4218
GNU General Public License for more details.
4219
4220
You should have received a copy of the GNU General Public License
4221
along with this program; if not, write to the Free Software
4222
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
4223
@end smallexample
4224
4225
Also add information on how to contact you by electronic and paper mail.
4226
4227
If the program is interactive, make it output a short notice like this
4228
when it starts in an interactive mode:
4229
4230
@smallexample
4231
Gnomovision version 69, Copyright (C) 20@var{yy} @var{name of author}
4232
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
4233
type `show w'. This is free software, and you are welcome
4234
to redistribute it under certain conditions; type `show c'
4235
for details.
4236
@end smallexample
4237
4238
The hypothetical commands @samp{show w} and @samp{show c} should show
4239
the appropriate parts of the General Public License. Of course, the
4240
commands you use may be called something other than @samp{show w} and
4241
@samp{show c}; they could even be mouse-clicks or menu items---whatever
4242
suits your program.
4243
4244
You should also get your employer (if you work as a programmer) or your
4245
school, if any, to sign a ``copyright disclaimer'' for the program, if
4246
necessary. Here is a sample; alter the names:
4247
4248
@smallexample
4249
@group
4250
Yoyodyne, Inc., hereby disclaims all copyright
4251
interest in the program `Gnomovision'
4252
(which makes passes at compilers) written
4253
by James Hacker.
4254
4255
@var{signature of Ty Coon}, 1 April 1989
4256
Ty Coon, President of Vice
4257
@end group
4258
@end smallexample
4259
4260
This General Public License does not permit incorporating your program into
4261
proprietary programs. If your program is a subroutine library, you may
4262
consider it more useful to permit linking proprietary applications with the
4263
library. If this is what you want to do, use the GNU Library General
4264
Public License instead of this License.
3855
@include gpl.texi
4265
3856
4266
3857
@include fdl.texi
4267
3858
Loggerhead is a web-based interface for Breezy
Version: 2.0.1