sjero.net Git - wget/blob - doc/sample.wgetrc

   1 ###
   2 ### Sample Wget initialization file .wgetrc
   3 ###
   4
   5 ## You can use this file to change the default behaviour of wget or to
   6 ## avoid having to type many many command-line options. This file does
   7 ## not contain a comprehensive list of commands -- look at the manual
   8 ## to find out what you can put into this file. You can find this here:
   9 ##   $ info wget.info 'Startup File'
  10 ## Or online here:
  11 ##   https://www.gnu.org/software/wget/manual/wget.html#Startup-File
  12 ##
  13 ## Wget initialization file can reside in /usr/local/etc/wgetrc
  14 ## (global, for all users) or $HOME/.wgetrc (for a single user).
  15 ##
  16 ## To use the settings in this file, you will have to uncomment them,
  17 ## as well as change them, in most cases, as the values on the
  18 ## commented-out lines are the default values (e.g. "off").
  19
  20
  21 ##
  22 ## Global settings (useful for setting up in /usr/local/etc/wgetrc).
  23 ## Think well before you change them, since they may reduce wget's
  24 ## functionality, and make it behave contrary to the documentation:
  25 ##
  26
  27 # You can set retrieve quota for beginners by specifying a value
  28 # optionally followed by 'K' (kilobytes) or 'M' (megabytes).  The
  29 # default quota is unlimited.
  30 #quota = inf
  31
  32 # You can lower (or raise) the default number of retries when
  33 # downloading a file (default is 20).
  34 #tries = 20
  35
  36 # Lowering the maximum depth of the recursive retrieval is handy to
  37 # prevent newbies from going too "deep" when they unwittingly start
  38 # the recursive retrieval.  The default is 5.
  39 #reclevel = 5
  40
  41 # By default Wget uses "passive FTP" transfer where the client
  42 # initiates the data connection to the server rather than the other
  43 # way around.  That is required on systems behind NAT where the client
  44 # computer cannot be easily reached from the Internet.  However, some
  45 # firewalls software explicitly supports active FTP and in fact has
  46 # problems supporting passive transfer.  If you are in such
  47 # environment, use "passive_ftp = off" to revert to active FTP.
  48 #passive_ftp = off
  49
  50 # The "wait" command below makes Wget wait between every connection.
  51 # If, instead, you want Wget to wait only between retries of failed
  52 # downloads, set waitretry to maximum number of seconds to wait (Wget
  53 # will use "linear backoff", waiting 1 second after the first failure
  54 # on a file, 2 seconds after the second failure, etc. up to this max).
  55 #waitretry = 10
  56
  57
  58 ##
  59 ## Local settings (for a user to set in his $HOME/.wgetrc).  It is
  60 ## *highly* undesirable to put these settings in the global file, since
  61 ## they are potentially dangerous to "normal" users.
  62 ##
  63 ## Even when setting up your own ~/.wgetrc, you should know what you
  64 ## are doing before doing so.
  65 ##
  66
  67 # Set this to on to use timestamping by default:
  68 #timestamping = off
  69
  70 # It is a good idea to make Wget send your email address in a `From:'
  71 # header with your request (so that server administrators can contact
  72 # you in case of errors).  Wget does *not* send `From:' by default.
  73 #header = From: Your Name <username@site.domain>
  74
  75 # You can set up other headers, like Accept-Language.  Accept-Language
  76 # is *not* sent by default.
  77 #header = Accept-Language: en
  78
  79 # You can set the default proxies for Wget to use for http, https, and ftp.
  80 # They will override the value in the environment.
  81 #https_proxy = http://proxy.yoyodyne.com:18023/
  82 #http_proxy = http://proxy.yoyodyne.com:18023/
  83 #ftp_proxy = http://proxy.yoyodyne.com:18023/
  84
  85 # If you do not want to use proxy at all, set this to off.
  86 #use_proxy = on
  87
  88 # You can customize the retrieval outlook.  Valid options are default,
  89 # binary, mega and micro.
  90 #dot_style = default
  91
  92 # Setting this to off makes Wget not download /robots.txt.  Be sure to
  93 # know *exactly* what /robots.txt is and how it is used before changing
  94 # the default!
  95 #robots = on
  96
  97 # It can be useful to make Wget wait between connections.  Set this to
  98 # the number of seconds you want Wget to wait.
  99 #wait = 0
 100
 101 # You can force creating directory structure, even if a single is being
 102 # retrieved, by setting this to on.
 103 #dirstruct = off
 104
 105 # You can turn on recursive retrieving by default (don't do this if
 106 # you are not sure you know what it means) by setting this to on.
 107 #recursive = off
 108
 109 # To always back up file X as X.orig before converting its links (due
 110 # to -k / --convert-links / convert_links = on having been specified),
 111 # set this variable to on:
 112 #backup_converted = off
 113
 114 # To have Wget follow FTP links from HTML files by default, set this
 115 # to on:
 116 #follow_ftp = off
 117
 118 # To try ipv6 addresses first:
 119 #prefer-family = IPv6
 120
 121 # Set default IRI support state
 122 #iri = off
 123
 124 # Force the default system encoding
 125 #locale = UTF-8
 126
 127 # Force the default remote server encoding
 128 #remoteencoding = UTF-8
 129
 130 # Turn on to prevent following non-HTTPS links when in recursive mode
 131 #httpsonly = off
 132
 133 # Tune HTTPS security (auto, SSLv2, SSLv3, TLSv1, PFS)
 134 #secureprotocol = auto