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 # Many sites are behind firewalls that do not allow initiation of
  39 # connections from the outside.  On these sites you have to use the
  40 # `passive' feature of FTP.  If you are behind such a firewall, you
  41 # can turn this on to make Wget use passive FTP by default.
  42 #passive_ftp = off
  43
  44
  45 ##
  46 ## Local settings (for a user to set in his $HOME/.wgetrc).  It is
  47 ## *highly* undesirable to put these settings in the global file, since
  48 ## they are potentially dangerous to "normal" users.
  49 ##
  50 ## Even when setting up your own ~/.wgetrc, you should know what you
  51 ## are doing before doing so.
  52 ##
  53
  54 # Set this to on to use timestamping by default:
  55 #timestamping = off
  56
  57 # It is a good idea to make Wget send your email address in a `From:'
  58 # header with your request (so that server administrators can contact
  59 # you in case of errors).  Wget does *not* send `From:' by default.
  60 #header = From: Your Name <username@site.domain>
  61
  62 # You can set up other headers, like Accept-Language.  Accept-Language
  63 # is *not* sent by default.
  64 #header = Accept-Language: en
  65
  66 # You can set the default proxy for Wget to use.  It will override the
  67 # value in the environment.
  68 #http_proxy = http://proxy.yoyodyne.com:18023/
  69
  70 # If you do not want to use proxy at all, set this to off.
  71 #use_proxy = on
  72
  73 # You can customize the retrieval outlook.  Valid options are default,
  74 # binary, mega and micro.
  75 #dot_style = default
  76
  77 # Setting this to off makes Wget not download /robots.txt.  Be sure to
  78 # know *exactly* what /robots.txt is and how it is used before changing
  79 # the default!
  80 #robots = on
  81
  82 # It can be useful to make Wget wait between connections.  Set this to
  83 # the number of seconds you want Wget to wait.
  84 #wait = 0
  85
  86 # The "wait" command above makes Wget wait between every connection.
  87 # If, instead, you want Wget to wait only between retries of failed
  88 # downloads, set this variable to maximum number of seconds to wait
  89 # (Wget will use "linear backoff", waiting 1 second after the first
  90 # failure on a file, up to this max).
  91 waitretry = 10
  92
  93 # You can force creating directory structure, even if a single is being
  94 # retrieved, by setting this to on.
  95 #dirstruct = off
  96
  97 # You can turn on recursive retrieving by default (don't do this if
  98 # you are not sure you know what it means) by setting this to on.
  99 #recursive = off
 100
 101 # To always back up file X as X.orig before converting its links (due
 102 # to -k / --convert-links / convert_links = on having been specified),
 103 # set this variable to on:
 104 #backup_converted = off
 105
 106 # To have Wget follow FTP links from HTML files by default, set this
 107 # to on:
 108 #follow_ftp = off