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