resulting derived work is distributed under the terms of a permission
notice identical to this one.
+\1f
+File: wget.info, Node: FTP Time-Stamping Internals, Prev: HTTP Time-Stamping Internals, Up: Time-Stamping
+
+FTP Time-Stamping Internals
+===========================
+
+ In theory, FTP time-stamping works much the same as HTTP, only FTP
+has no headers--time-stamps must be received from the directory
+listings.
+
+ For each directory files must be retrieved from, Wget will use the
+`LIST' command to get the listing. It will try to analyze the listing,
+assuming that it is a Unix `ls -l' listing, and extract the
+time-stamps. The rest is exactly the same as for HTTP.
+
+ Assumption that every directory listing is a Unix-style listing may
+sound extremely constraining, but in practice it is not, as many
+non-Unix FTP servers use the Unixoid listing format because most (all?)
+of the clients understand it. Bear in mind that RFC959 defines no
+standard way to get a file list, let alone the time-stamps. We can
+only hope that a future standard will define this.
+
+ Another non-standard solution includes the use of `MDTM' command
+that is supported by some FTP servers (including the popular
+`wu-ftpd'), which returns the exact time of the specified file. Wget
+may support this command in the future.
+
\1f
File: wget.info, Node: Startup File, Next: Examples, Prev: Time-Stamping, Up: Top
Quiet mode, the same as `-q'.
quota = QUOTA
- Specify the download quota, which is useful to put in global
- wgetrc. When download quota is specified, Wget will stop retrieving
- after the download sum has become greater than quota. The quota
- can be specified in bytes (default), kbytes `k' appended) or mbytes
- (`m' appended). Thus `quota = 5m' will set the quota to 5 mbytes.
- Note that the user's startup file overrides system settings.
+ Specify the download quota, which is useful to put in the global
+ `wgetrc'. When download quota is specified, Wget will stop
+ retrieving after the download sum has become greater than quota.
+ The quota can be specified in bytes (default), kbytes `k'
+ appended) or mbytes (`m' appended). Thus `quota = 5m' will set
+ the quota to 5 mbytes. Note that the user's startup file overrides
+ system settings.
reclevel = N
Recursion level, the same as `-l'.
Wait N seconds between retrievals, the same as `-w'.
waitretry = N
- Wait N seconds between retries of failed retrievals only - the
- same as `--waitretry'.
+ Wait up to N seconds between retries of failed retrievals only -
+ the same as `--waitretry'. Note that this is turned on by default
+ in the global `wgetrc'.
\1f
File: wget.info, Node: Sample Wgetrc, Prev: Wgetrc Commands, Up: Startup File
startup file), and one for local usage (suitable for `$HOME/.wgetrc').
Be careful about the things you change.
- Note that all the lines are commented out. For any line to have
-effect, you must remove the `#' prefix at the beginning of line.
+ Note that almost all the lines are commented out. For a command to
+have any effect, you must remove the `#' character at the beginning of
+its line.
###
### Sample Wget initialization file .wgetrc
## Wget initialization file can reside in /usr/local/etc/wgetrc
## (global, for all users) or $HOME/.wgetrc (for a single user).
##
- ## To use any of the settings in this file, you will have to uncomment
- ## them (and probably change them).
+ ## To use the settings in this file, you will have to uncomment them,
+ ## as well as change them, in most cases, as the values on the
+ ## commented-out lines are the default values (e.g. "off").
##
# can turn this on to make Wget use passive FTP by default.
#passive_ftp = off
+ # The "wait" command below makes Wget wait between every connection.
+ # If, instead, you want Wget to wait only between retries of failed
+ # downloads, set waitretry to maximum number of seconds to wait (Wget
+ # will use "linear backoff", waiting 1 second after the first failure
+ # on a file, 2 seconds after the second failure, etc. up to this max).
+ waitretry = 10
+
##
## Local settings (for a user to set in his $HOME/.wgetrc). It is
# you are not sure you know what it means) by setting this to on.
#recursive = off
+ # To always back up file X as X.orig before converting its links (due
+ # to -k / --convert-links / convert_links = on having been specified),
+ # set this variable to on:
+ #backup_converted = off
+
# To have Wget follow FTP links from HTML files by default, set this
# to on:
#follow_ftp = off