Go to the first, previous, next, last section, table of contents.


7.3 Wgetrc Commands

The complete set of commands is listed below, the letter after `=' denoting the value the command takes. It is `on/off' for `on' or `off' (which can also be `1' or `0'), `string' for any non-empty string or `N' for a positive integer. For example, you may specify `use_proxy = off' to disable use of PROXY servers by default. You may use `inf' for infinite values, where appropriate.

Most of the commands have their equivalent command-line option (See section 3 Invoking), except some more obscure or rarely used ones.

accept/reject = string
Same as `-A'/`-R'.
add_hostdir = on/off
Enable/disable host-prefixed hostnames. `-nH' disables it.
always_rest = on/off
Enable/disable continuation of the retrieval, the same as `-c'.
base = string
Set base for relative URLs, the same as `-B'.
convert links = on/off
Convert non-relative links locally. The same as `-k'.
debug = on/off
Debug mode, same as `-d'.
delete_after = on/off
Delete after download, the same as `--delete-after'.
dir_mode = N
Set permission modes of created subdirectories (default is 0755).
dir_prefix = string
Top of directory tree, the same as `-P'.
dirstruct = on/off
Turning dirstruct on or off, the same as `-x' or `-n'd, respectively.
domains = string
Same as `-D'.
dot_bytes = N
Specify the number of bytes "contained" in a dot, as seen throughout the retrieval (1024 by default). You can postfix the value with `k' or `m', representing kilobytes and megabytes, respectively. With dot settings you can tailor the dot retrieval to suit your needs, or you can use the predefined styles. (See section 3.3 Advanced Options).
dots_in_line = N
Specify the number of dots that will be printed in each line throughout the retrieval (50 by default).
dot_spacing = N
Specify the number of dots in a single cluster (10 by default).
dot_style = string
Specify the dot retrieval style, as with `--dot-style'.
exclude_directories = string
Specify a comma-separated list of directories you wish to exclude from download, the same as -X.
file_prefix = string
Set prefix for output files. It works only if `-p' is set. Wget saves all the files retrieved from the net in files `received.n', where `n' is a number. If a file named received.n exists, Wget tries with n + 1, and so forth. The file_prefix option changes the default `received' prefix.
follow_ftp = on/off
Follow FTP links from HTML documents, the same as `-f'.
force_html = on/off
If set to on, force the input filename to be regarded as an HTML document, the same as `-F'.
ftp_proxy = string
Use the string as FTP proxy, instead of the one specified in environment.
glob = on/off
Turn globbing on/off, the same as `-g'.
header = string
Define an additional header, like `--header'.
http_passwd = string
Set HTTP password.
http_proxy = string
Use the string as HTTP proxy, instead of the one specified in environment.
http_user = string
Set `http' user.
include_directories = string
Specify a comma-separated list of directories you wish to follow when downloading, the same as -I.
input = string
Read the URLs from `string', like `-i'.
kill_longer = on/off
Consider data longer than specified in content-length header as invalid (and retry getting it). The default behaviour is to save as much data as there is, provided there is more than or equal to the value in content-length.
logfile = string
Set logfile, the same as `-o'.
login = string
Your user name on the remote machine, for FTP Defaults to `anonymous'.
mirror = on/off
Turn mirroring on/off. The same as `-m'.
noclobber = on/off
Same as `-nc'.
no_proxy = string
Use the string as the comma-separated list of domains to avoid in proxy loading, instead of the one specified in environment.
no_parent = on/off
Disallow retrieving outside the directory hierarchy, like `--no-parent'. See section 6.5 No Parent.
num_tries = N
Set number of retries per URL, the same as `-t'.
output_document = string
Set the output filename, the same as `-O'.
passwd = string
Your password on the remote machine, for FTP. Defaults to `username@hostname.domainname'.
prefix_files = on/off
Set prefixed files, the same as `-p'.
quiet = on/off
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.
reclevel = N
Recursion level, the same as `-l'.
recursive = on/off
Recursive on/off, the same as `-r'.
relative_only = on/off
Follow only relative links, the same as `-L' (See section 6.1 Relative Links).
remove_listing = on/off
If set to on, remove FTP listings downloaded by Wget. Setting it to ogg is the same as -nr.
retr_symlinks = on/off
When set to on, retrieve symbolic links as if they were plain files; the same as --retr-symlinks.
robots = on/off
Use (or not) `/robots.txt' file.
server_response = on/off
Choose whether or not to print the HTTP and FTP server responses, the same as `-S'.
simple_host_check = on/off
Same as `-nh'.
span_hosts = on/off
Same as `-H'.
timeout = N
Set timeout value, the same as `-T'.
timestamping = on/off
Turn timestamping on/off. The same as `-N'.
use_proxy = on/off
Turn PROXY support on/off. The same as `-Y'.
verbose = on/off
Turn verbose on/off, the same as `-v'/`-nv'.


Go to the first, previous, next, last section, table of contents.