Copyright (C) 2000-2012 |
GNU Info (wget.info)Wgetrc CommandsWgetrc Commands =============== The complete set of commands is listed below. Legal values are listed after the `='. Simple Boolean values can be set or unset using `on' and `off' or `1' and `0'. A fancier kind of Boolean allowed in some cases is the "lockable Boolean", which may be set to `on', `off', `always', or `never'. If an option is set to `always' or `never', that value will be locked in for the duration of the Wget invocation--commandline options will not override. Some commands take pseudo-arbitrary values. ADDRESS values can be hostnames or dotted-quad IP addresses. N can be any positive integer, or `inf' for infinity, where appropriate. STRING values can be any non-empty string. Most of these commands have commandline equivalents (Note: Invoking), though some of the more obscure or rarely used ones do not. accept/reject = STRING Same as `-A'/`-R' (Note: Types of Files). add_hostdir = on/off Enable/disable host-prefixed file names. `-nH' disables it. continue = on/off If set to on, force continuation of preexistent partially retrieved files. See `-c' before setting it. background = on/off Enable/disable going to background--the same as `-b' (which enables it). backup_converted = on/off Enable/disable saving pre-converted files with the suffix `.orig'--the same as `-K' (which enables it). base = STRING Consider relative URLs in URL input files forced to be interpreted as HTML as being relative to STRING--the same as `-B'. bind_address = ADDRESS Bind to ADDRESS, like the `--bind-address' option. cache = on/off When set to off, disallow server-caching. See the `-C' option. convert links = on/off Convert non-relative links locally. The same as `-k'. cookies = on/off When set to off, disallow cookies. See the `--cookies' option. load_cookies = FILE Load cookies from FILE. See `--load-cookies'. save_cookies = FILE Save cookies to FILE. See `--save-cookies'. cut_dirs = N Ignore N remote directory components. debug = on/off Debug mode, same as `-d'. delete_after = on/off Delete after download--the same as `--delete-after'. dir_prefix = STRING Top of directory tree--the same as `-P'. dirstruct = on/off Turning dirstruct on or off--the same as `-x' or `-nd', respectively. domains = STRING Same as `-D' (Note: Spanning Hosts). 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" (Note: Download 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). exclude_directories = STRING Specify a comma-separated list of directories you wish to exclude from download--the same as `-X' (Note: Directory-Based Limits). exclude_domains = STRING Same as `--exclude-domains' (Note: Spanning Hosts). follow_ftp = on/off Follow FTP links from HTML documents--the same as `--follow-ftp'. follow_tags = STRING Only follow certain HTML tags when doing a recursive retrieval, just like `--follow-tags'. 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 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'. html_extension = on/off Add a `.html' extension to `text/html' files without it, like `-E'. http_passwd = STRING Set HTTP password. http_proxy = STRING Use STRING as HTTP proxy, instead of the one specified in environment. http_user = STRING Set HTTP user to STRING. ignore_length = on/off When set to on, ignore `Content-Length' header; the same as `--ignore-length'. ignore_tags = STRING Ignore certain HTML tags when doing a recursive retrieval, just like `-G' / `--ignore-tags'. 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'. netrc = on/off Turn reading netrc on or off. noclobber = on/off Same as `-nc'. no_parent = on/off Disallow retrieving outside the directory hierarchy, like `--no-parent' (Note: Directory-Based Limits). no_proxy = STRING Use STRING as the comma-separated list of domains to avoid in proxy loading, instead of the one specified in environment. output_document = STRING Set the output filename--the same as `-O'. page_requisites = on/off Download all ancillary documents necessary for a single HTML page to display properly--the same as `-p'. passive_ftp = on/off/always/never Set passive FTP--the same as `--passive-ftp'. Some scripts and `.pm' (Perl module) files download files using `wget --passive-ftp'. If your firewall does not allow this, you can set `passive_ftp = never' to override the commandline. passwd = STRING Set your FTP password to PASSWORD. Without this setting, the password defaults to `username@hostname.domainname'. progress = STRING Set the type of the progress indicator. Legal types are "dot" and "bar". proxy_user = STRING Set proxy authentication user name to STRING, like `--proxy-user'. proxy_passwd = STRING Set proxy authentication password to STRING, like `--proxy-passwd'. referer = STRING Set HTTP `Referer:' header just like `--referer'. (Note it was the folks who wrote the HTTP spec who got the spelling of "referrer" wrong.) quiet = on/off Quiet mode--the same as `-q'. quota = QUOTA 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'. recursive = on/off Recursive on/off--the same as `-r'. relative_only = on/off Follow only relative links--the same as `-L' (Note: Relative Links). remove_listing = on/off If set to on, remove FTP listings downloaded by Wget. Setting it to off 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 (Note: Robots). Be sure to know what you are doing before changing the default (which is `on'). server_response = on/off Choose whether or not to print the HTTP and FTP server responses--the same as `-S'. 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' (Note: Time-Stamping). tries = N Set number of retries per URL--the same as `-t'. 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'. wait = N Wait N seconds between retrievals--the same as `-w'. waitretry = N 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'. randomwait = on/off Turn random between-request wait times on or off. The same as `--random-wait'. automatically generated by info2www version 1.2.2.9 |