wwwoffle.conf
上传用户:seven77cht
上传日期:2007-01-04
资源大小:486k
文件大小:30k
源码类别:

浏览器

开发平台:

Unix_Linux

  1. #
  2. # WWWOFFLE - World Wide Web Offline Explorer - Version 2.5e.
  3. #
  4. # WWWOFFLE Configuration file CONFDIR/wwwoffle.conf
  5. #
  6. # Derived from the example configuration file written by Andrew M. Bishop
  7. #
  8. # WWWOFFLE and example configuration file Copyright 1997,98,99,2000
  9. # Andrew M. Bishop
  10. # They may be distributed under the GNU Public License, version 2, or
  11. # any higher version.  See section COPYING of the GNU Public license
  12. # for conditions under which this file may be redistributed.
  13. #
  14. #
  15. # Lines beginning with a '#' are comments and ignored.
  16. #
  17. #
  18. # Program startup configuration.
  19. #
  20. # This can not be changed without restarting the program.
  21. #
  22. # Header : StartUp
  23. # Options: http-port         = <integer>
  24. #               The port number to use for the proxy http server (default=8080).
  25. #          wwwoffle-port     = <integer>
  26. #               The port number to use for wwwoffle control (default=8081).
  27. #          spool-dir         = <directory name>
  28. #               The directory to use as the spool directory
  29. #               (default=/var/spool/wwwoffle).
  30. #          run-uid           = <username> | <uid>
  31. #               The username or numeric uid to run the wwwoffled server as
  32. #               (default=none).
  33. #          run-gid           = <groupname> | <gid>
  34. #               The groupname or numeric gid to run the wwwoffled server as
  35. #               (default=none).
  36. #          use-syslog        = yes | no
  37. #               If true then log all important messages using syslog
  38. #               (default=yes).
  39. #          password          = <word> | none |
  40. #               The authorisation password for demon configuration by wwwoffle
  41. #               (default=none).
  42. #          max-servers       = <integer>
  43. #               The maximum number of server processes that are ever started,
  44. #               must be less than MAX_SERVERS (=64) (default=8).
  45. #          max-fetch-servers = <integer>
  46. #               The maximum number of server processes that are started to
  47. #               fetch pages that were requested in offline mode, must be less
  48. #               than MAX_FETCH_SERVERS (=48). (default=4).
  49. #          dir-perm          = <octal integer>
  50. #               The permissions to use when creating spool directories
  51. #               (default=0755).
  52. #          file-perm         = <octal integer>
  53. #               The permissions to use when creating spool files (default=0644).
  54. #          run-online        = <filename>
  55. #               The name of a program to run when switched to online mode
  56. #               (default=none).
  57. #          run-offline       = <filename>
  58. #               The name of a program to run when switched to offline mode
  59. #               (default=none).
  60. #          run-autodial      = <filename>
  61. #               The name of a program to run when switched to autodial mode
  62. #               (default=none).
  63. #
  64. # Notes 1: For the password to work the configuration file must be set so that
  65. #          only authorised users can read it.
  66. #       2: The run-uid/run-gid options are not applicable to win32 (Win95/98).
  67. #       3: To use the run-uid/run-gid options server must be started as root.
  68. #       4: The max-fetch-servers value must be less than max-servers or you will
  69. #          not be able to use wwwoffle interactively online while fetching.
  70. #       5: The dir-perm and file-perm options override the umask settings and
  71. #          must be in octal starting with a '0' character.
  72. #       6: The programs run using the run-online, run-offline and run-autodial
  73. #          options are started with a single parameter set to the current mode.
  74. #
  75. StartUp
  76. {
  77.  http-port         = 8080
  78.  wwwoffle-port     = 8081
  79.  spool-dir         = SPOOLDIR
  80. #run-uid           = daemon
  81. #run-gid           = daemon
  82.  use-syslog        = yes
  83.  password          = none
  84.  max-servers       = 8
  85.  max-fetch-servers = 4
  86.  dir-perm          = 0755
  87.  file-perm         = 0644
  88. }
  89. #
  90. # Other configuration options.
  91. #
  92. # Header : Options
  93. # Options: log-level         = debug | info | important | warning | fatal
  94. #               Log messages with this or higher priority (default=important).
  95. #          index-latest-days = <age>
  96. #               The age in days of pages to show in the index of latest pages
  97. #               (default=7).
  98. #          request-changed   = <time>
  99. #               While online pages will only be fetched if the cached version
  100. #               is older than this specified time in seconds (default=600).
  101. #          request-changed-once = yes | no
  102. #               While online pages will only be fetched if the cached version
  103. #               has not already been fetched once this session (default=yes).
  104. #          request-expired = yes | no
  105. #               While online pages that have expired will always be requested
  106. #               again (default=no). 
  107. #          request-no-cache = yes | no
  108. #               While online pages that ask not to be cached will always be
  109. #               requested again (default=no).
  110. #          pragma-no-cache   = yes | no
  111. #               Whether to request a new copy of a page if the request from the
  112. #               browser has 'Pragma: no-cache' (default=yes).
  113. #          confirm-requests  = yes | no
  114. #               Whether to return a page requiring user confirmation instead of
  115. #               automatically recording requests made while offline
  116. #               (default=no).
  117. #          connect-timeout   = <time>
  118. #               The time in seconds that WWWOFFLE will wait for the socket
  119. #               connection (default=30).
  120. #          socket-timeout    = <time>
  121. #               The time in seconds that wwwoffle will wait for data before
  122. #               giving up on a socket connection (default=120).
  123. #          connect-retry     = yes | no
  124. #               If a connection cannot be made to a remote server
  125. #               then try again after a short delay (default=no).
  126. #          ssl-allow-port    = <integer>
  127. #               A port number that can be used for Secure Socket Layer (SSL)
  128. #               connections, e.g. https.
  129. #          no-lasttime-index = yes | no
  130. #               Disables creation of the lasttime/prevtime indexes (default=no).
  131. #          intr-download-keep = yes | no
  132. #               If the browser closes the connection while online the currently
  133. #               downloaded partial page should be kept (default=no).
  134. #          intr-download-size = <integer>
  135. #               If the browser closes the connection while online the page
  136. #               should continue to download if smaller than this size in kB
  137. #               (default=1).
  138. #          intr-download-percent = <integer>
  139. #               If the browser closes the connection while online the page
  140. #               should continue to download if more than this amount complete
  141. #               (default=80).
  142. #          timeout-download-keep = yes | no
  143. #               If the server connection timeouts while reading then the
  144. #               currently downloaded partial page should be kept (default=no).
  145. #
  146. #  Notes 1: The request-changed option can be set negative to indicate that
  147. #           cached pages are always used while online.
  148. #        2: The request-changed-once option takes precedence over the
  149. #           request-changed option.
  150. #        3: The request-expired and request-no-cache options takes precedence
  151. #           over the request-changed-once and request-changed options.
  152. #        3: The pragma-no-cache option should be set to 'no' if when browsing
  153. #           offline all pages are re-requested by a 'broken' browser.
  154. #        4: The ssl-allow-port should be set to 443 to allow https, there can be
  155. #           more than one ssl-allow-port entry for other ports as required.
  156. #
  157. Options
  158. {
  159.  log-level            = important
  160.  index-latest-days    = 7
  161.  request-changed      = 600
  162.  request-changed-once = yes
  163.  request-expired      = no
  164.  pragma-no-cache      = yes
  165.  confirm-requests     = no
  166.  connect-timeout      = 30
  167.  socket-timeout       = 120
  168.  connect-retry        = no
  169.  ssl-allow-port       = 443
  170.  no-lasttime-index    = no
  171.  intr-download-keep    = no
  172.  intr-download-size    = 1
  173.  intr-download-percent = 80
  174.  timeout-download-keep = no
  175. }
  176. #
  177. # Automatic Fetch options.
  178. #
  179. # Header : FetchOptions
  180. # Options: stylesheets = yes | no
  181. #               If style sheets are to be fetched.
  182. #          images       = yes | no
  183. #               If images are to be fetched.
  184. #          frames       = yes | no
  185. #               If frames are to be fetched.
  186. #          scripts      = yes | no
  187. #               If scripts are to be fetched.
  188. #          objects      = yes | no
  189. #               If objects (e.g. Java class files ) are to be fetched.
  190. #
  191. # Notes 1: These options all default to 'no' if nothing is specified.
  192. #
  193. FetchOptions
  194. {
  195.  stylesheets = no
  196.  images      = yes
  197.  frames      = yes
  198.  scripts     = no
  199.  objects     = no
  200. }
  201. #
  202. # HTML modifications that are made to the spooled pages.
  203. #
  204. # Options that control how the HTML that is provided from the cache is modified.
  205. #
  206. # Header : ModifyHTML
  207. # Options: enable-modify-html = yes | no
  208. #               Enable the HTML modifications in this section (has a speed
  209. #               penalty) (default=no).
  210. #          add-cache-info = yes | no
  211. #               At the bottom of all of the spooled pages the date that the page
  212. #               was cached and some buttons are to be added (default=no).
  213. #          anchor-cached-begin = <HTML code>
  214. #               Anchors (links) that are cached are to have the specified HTML
  215. #               inserted at the beginning (default="").
  216. #          anchor-cached-end = <HTML code>
  217. #               Anchors (links) that are cached are to have the specified HTML
  218. #               inserted at the end (default="").
  219. #          anchor-requested-begin  = <HTML code>
  220. #               Anchors (links) that have been requested are to have the
  221. #               specified HTML inserted at the beginning (default="").
  222. #          anchor-requested-end = <HTML code>
  223. #               Anchors (links) that have been requested are to have the
  224. #               specified HTML inserted at the end (default="").
  225. #          anchor-not-cached-begin = <HTML code>
  226. #               Anchors (links) that are not cached or requested are to have the
  227. #               specified HTML inserted at the beginning (default="").
  228. #          anchor-not-cached-end = <HTML code>
  229. #               Anchors (links) that are not cached or requested are to have the
  230. #               specified HTML inserted at the end (default="").
  231. #          disable-script = yes | no
  232. #               Removes all scripts and scripted events (default=no).
  233. #          disable-blink = yes | no
  234. #               Removes the <blink> tag (default=no).
  235. #          disable-animated-gif = yes | no
  236. #               Disables the animation of GIF files (default=no).
  237. #
  238. # Notes 1: These options all rely on the HTML being syntactically correct, if it
  239. #          is not then the result is undefined.
  240. #
  241. ModifyHTML
  242. {
  243.  enable-modify-html = no
  244.  add-cache-info = no
  245. #anchor-cached-begin     = <font color="#00B000">
  246. #anchor-cached-end       = </font>
  247. #anchor-requested-begin  = <font color="#B0B000">
  248. #anchor-requested-end    = </font>
  249. #anchor-not-cached-begin = <font color="#B00000">
  250. #anchor-not-cached-end   = </font>
  251.  disable-script          = no
  252.  disable-blink           = no
  253.  disable-animated-gif    = no
  254. }
  255. #
  256. # WWWOFFLE server host name specification.
  257. #
  258. # The possible names that the server that wwwoffles is on may be known by.
  259. #
  260. # Header : LocalHost
  261. # Options: <host>
  262. #               One of the possible hostnames or IP addresses.
  263. #
  264. # Notes 1: The host names must match exactly, no wildcard matches.
  265. #       2: All entries in here are also used the same way as those in the
  266. #          LocalNet and AllowedConnectHosts sections.
  267. #       3: The first named host is used as the server name for several features
  268. #          so must be a name that will work from any client host on the network.
  269. #       4: None of the entries here or in LocalNet are fetched via a proxy.
  270. #
  271. LocalHost
  272. {
  273.  localhost
  274.  127.0.0.1
  275. #### Example ####
  276. # The server is on www.foo.com, with IP address 11.22.33.44.
  277. # www.foo.com
  278. # 11.22.33.44
  279. }
  280. #
  281. # Local Network non-cached host name specification
  282. #
  283. # The names of hosts that are not cached because they are on the local network.
  284. #
  285. # Header : LocalNet
  286. # Options: <host>
  287. #               A hostname or IP address.
  288. #
  289. # Notes 1: The host name matching uses wildcards (see the WILDCARD section).
  290. #       2: A host can be excluded by appending a '!' to the start of the name,
  291. #          all possible aliases and IP addresses for the host are also required.
  292. #       3: All entries here are assumed to be reachable even when offline.
  293. #       4: All entries in the LocalHost section are used as if they were here.
  294. #       5: None of the entries here or in LocalHost are fetched via a proxy.
  295. #
  296. LocalNet
  297. {
  298. #### Example ####
  299. # The local domain is foo.com so don't cache any hosts in it.
  300. # *.foo.com
  301. }
  302. #
  303. # Allowed client host name specification
  304. #
  305. # The names of client hosts that are allowed to connect to the server.
  306. #
  307. # Header : AllowedConnectHosts
  308. # Options: <host>
  309. #               A hostname or IP address.
  310. #
  311. # Notes 1: The host name matching uses wildcards (see the WILDCARD section).
  312. #       2: A host can be excluded by appending a '!' to the start of the name,
  313. #          all possible aliases and IP addresses for the host are also required.
  314. #       3: All entries in the LocalHost section are used as if they were here.
  315. #
  316. AllowedConnectHosts
  317. {
  318. #### Example ####
  319. # Only allow connections from hosts in the foo.com domain.
  320. # *.foo.com
  321. }
  322. #
  323. # Allowed client username specification
  324. #
  325. # A list of the users that are allowed to connect to the server.
  326. #
  327. # Header : AllowedConnectUsers
  328. # Options: <username>:<password>
  329. #               The username and password of the users that are allowed to
  330. #               connect to the server.
  331. #
  332. # Notes 1: If this section is left empty then no user authentication is done.
  333. #       2: The username and password are both stored in plaintext format.
  334. #       3: This requires the use of browsers that handle the HTTP/1.1 standard.
  335. #
  336. AllowedConnectUsers
  337. {
  338. #### Example ####
  339. # Only allow connections from this one user.
  340. # andrew:password
  341. }
  342. #
  343. # A list of ways of recognising a URL not to cache.
  344. #
  345. # Header : DontCache
  346. # Options: URL-SPECIFICATION
  347. #               Do not cache any URLs that match this.
  348. #
  349. # Notes 1: See the bottom of this file for the description of URL-SPECIFICATION.
  350. #       2: The URL-SPECIFICATION can be negated, see URL-SPECIFICATION below.
  351. #       3: The URL will still be cached if fetched non-interactively.
  352. #
  353. DontCache
  354. {
  355. #### Example ####
  356. # Don't cache any hosts in the barfoo.com domain.
  357. # *://*.barfoo.com/
  358. # Don't cache any gzipped or tar files.
  359. # *://*/*.gz
  360. # *://*/*.tar
  361. # Don't cache any files from /volatile in the foo.com domain.
  362. # *://*.foo.com/volatile/*
  363. }
  364. #
  365. # A list of ways of recognising a URL not to get.
  366. #
  367. # Header : DontGet
  368. # Options: URL-SPECIFICATION [ = <URL> ]
  369. #               Do not get any URLs that match this [ with the option to specify
  370. #               a replacement URL ].
  371. #          replacement = <URL>
  372. #               The default URL to replace any URLs that match the
  373. #               URL-SPECIFICATIONs instead of using the standard error message
  374. #               (default=none).
  375. #
  376. # Notes 1: See the bottom of this file for the description of URL-SPECIFICATION.
  377. #       2: The URL-SPECIFICATION can be negated, see URL-SPECIFICATION below.
  378. #       3: The URL /local/images/trans-1x1.gif is a suggested replacement
  379. #          (a 1x1 pixel transparent gif).
  380. #
  381. DontGet
  382. {
  383. #replacement = /local/images/trans-1x1.gif
  384. #### Example ####
  385. # Don't get from any hosts in the barfoo.com domain.
  386. # *://*.barfoo.com/
  387. # Don't get any gzipped or tar files.
  388. # *://*/*.gz
  389. # *://*/*.tar
  390. # Don't get any files from /adverts in the foo.com domain.
  391. # *://*.foo.com/adverts*
  392. }
  393. #
  394. # A list of ways of recognising a URL not to get when fetching recursively.
  395. #
  396. # Header : DontGetRecursive
  397. # Options: URL-SPECIFICATION
  398. #               Do not get any URLs that match this.
  399. #
  400. # Notes 1: See the bottom of this file for the description of URL-SPECIFICATION.
  401. #       2: The URL-SPECIFICATION can be negated, see URL-SPECIFICATION below.
  402. #
  403. DontGetRecursive
  404. {
  405. #### Example ####
  406. # Dont get any gzipped or tar files when getting recursively.
  407. # *://*/*.gz
  408. # *://*/*.tar
  409. }
  410. #
  411. # A list of URLs that cannot be requested by users when offline.
  412. #
  413. # Header : DontRequestOffline
  414. # Options: URL-SPECIFICATION
  415. #               Do not request any URLs that match this.
  416. #
  417. # Notes 1: See the bottom of this file for the description of URL-SPECIFICATION.
  418. #       2: The URL-SPECIFICATION can be negated, see URL-SPECIFICATION below.
  419. #
  420. DontRequestOffline
  421. {
  422. #### Example ####
  423. # Dont request any URLs at all when offline.
  424. # *://*/
  425. }
  426. #
  427. # Censorship of information in HTTP headers
  428. #
  429. # A list of HTTP header lines that are to be removed from the requests sent or
  430. # replies received from the servers, or fake headers to be used instead.
  431. #
  432. # Header : CensorHeader
  433. # Options: <header> = <string> | none |
  434. #               A header field name, (e.g. From, Cookie, Set-Cookie, User-Agent)
  435. #               and the string to replace the header value with.
  436. #          referer-self = yes | no
  437. #               Sets the Referer header to the same as the URL (default = no).
  438. #          referer-self-dir = yes | no
  439. #               Sets the Referer header to the URL directory name (default = no).
  440. #
  441. # Notes 1: The header is case sensitive, and does not have a ':' at the end.
  442. #       2: The value of none or no string can be used to remove the header.
  443. #       3: This only replaces headers it finds, it does not add any new ones.
  444. #       4: The referer-self-dir option takes precedence over referer-self.
  445. #
  446. CensorHeader
  447. {
  448. ### Example ###
  449. # Don't send the username.
  450. # From =
  451. # Don't accept Cookies
  452. # Set-Cookie =
  453. # Don't send Cookies back
  454. # Cookie =
  455. # Lie about the Browser type.
  456. # User-Agent = WWWOFFLE/2.5
  457. }
  458. #
  459. # Options to use when fetching files using ftp.
  460. #
  461. # Header : FTPOptions
  462. # Options: anon-username = <string>
  463. #               The username to use for anonymous ftp (default=anonymous).
  464. #          anon-password = <string>
  465. #               The password to use for anonymous ftp (default=<user>@<host>).
  466. #          auth-hostname = <host[:port]>
  467. #               A host to use a different username and password.
  468. #          auth-username = <string>
  469. #               The username to use on the above host.
  470. #          auth-password = <string>
  471. #               The password to use on the above host.
  472. #
  473. # Notes 1: The anon-password should be set to a sensible value especially if you
  474. #          are behind a firewall.
  475. #       2: The auth-hostname, auth-username and auth-password options must come
  476. #          together as a triplet.
  477. #       3: The auth-hostname must be exact, it is not used as a WILDCARD match.
  478. #
  479. FTPOptions
  480. {
  481.  anon-username = anonymous
  482. #anon-password = 
  483. }
  484. #
  485. # MIME Types to use when fetching files not using HTTP.
  486. #
  487. # Header : MIMETypes
  488. # Options: default     = <mime-type>/<subtype>
  489. #               The default MIME type (default=text/plain).
  490. #          .<file-ext> = <mime-type>/<subtype>
  491. #               The MIME type to associate with a file extension.
  492. #
  493. # Notes 1: You must include the '.' in the file extension.
  494. #       2: If more than one of the extensions match then the longest is used.
  495. #
  496. MIMETypes
  497. {
  498.  default  = text/plain
  499.  .pdf     = application/pdf
  500.  .eps     = application/postscript
  501.  .ps      = application/postscript
  502.  .rtf     = application/rtf
  503.  .dvi     = application/x-dvi
  504.  .latex   = application/x-latex
  505.  .tcl     = application/x-tcl
  506.  .tex     = application/x-tex
  507.  .texinfo = application/x-texinfo
  508.  .texi    = application/x-texinfo
  509.  .tr      = application/x-troff
  510.  .man     = application/x-troff-man
  511.  .me      = application/x-troff-me
  512.  .ms      = application/x-troff-ms
  513.  .zip     = application/zip
  514.  .cpio    = application/x-cpio
  515.  .tar     = application/x-tar
  516.  .Z       = application/x-compress
  517.  .gz      = application/x-gzip
  518.  .js      = application/x-javascript
  519.  .au      = audio/basic
  520.  .snd     = audio/basic
  521.  .wav     = audio/x-wav
  522.  .gif     = image/gif
  523.  .jpeg    = image/jpeg
  524.  .jpg     = image/jpeg
  525.  .tif     = image/tiff
  526.  .tiff    = image/tiff
  527.  .ras     = image/x-cmu-raster
  528.  .pnm     = image/x-portable-anymap
  529.  .pbm     = image/x-portable-bitmap
  530.  .pgm     = image/x-portable-graymap
  531.  .ppm     = image/x-portable-pixmap
  532.  .png     = image/png
  533.  .rgb     = image/x-rgb
  534.  .xbm     = image/x-xbitmap
  535.  .xpm     = image/x-xpixmap
  536.  .xwd     = image/x-xwindowdump
  537.  .html    = text/html
  538.  .htm     = text/html
  539.  .txt     = text/plain
  540.  .mpeg    = video/mpeg
  541.  .mpg     = video/mpeg
  542.  .mov     = video/quicktime
  543.  .avi     = video/x-msvideo
  544.  .pac     = application/x-ns-proxy-autoconfig
  545.  .class   = application/java
  546.  .wrl     = model/vrml
  547.  .vr      = model/vrml
  548.  .css     = text/css
  549.  .xml     = application/xml
  550.  .dtd     = application/xml
  551. }
  552. #
  553. # Remote proxy configuration.
  554. #
  555. # The name and port number of machines to use as proxies.
  556. #
  557. # Header : Proxy
  558. # Options: default            = <hostname[:integer]> | none |
  559. #               The hostname (+ optionally a port number separated by a colon)
  560. #               to use as the default proxy.
  561. #          URL-SPECIFICATION  = <hostname[:integer]> | none |
  562. #               The hostname (+ optionally a port number separated by a colon)
  563. #               to use as the proxy for URLs that match URL-SPECIFICATION.
  564. #          auth-hostname = <host[:port]>
  565. #               A proxy server that uses proxy authentication, this is where the
  566. #               user must enter a username and password in the browser to use
  567. #               the proxy.
  568. #          auth-username = <string>
  569. #               The username to use on the above host.
  570. #          auth-password = <string>
  571. #               The password to use on the above host.
  572. #          ssl           = <host[:port]>
  573. #               A proxy server that should be used for Secure Socket Layer (SSL)
  574. #               connections e.g. https.
  575. #
  576. # Notes 1: See the bottom of this file for the description of URL-SPECIFICATION.
  577. #       2: A hostname that matches more than one entry here uses the proxy of
  578. #          the longest matching one (protocol is included in assessing length).
  579. #       3: Leave the hostname empty or use 'none' for no proxy.
  580. #       4: None of the hosts in LocalNet/LocalHost will be fetched via a proxy.
  581. #       5: The auth-hostname, auth-username and auth-password options must come
  582. #          together as a triplet.
  583. #       6: The auth-hostname must be exact, it is not used as a WILDCARD match.
  584. #
  585. Proxy
  586. {
  587.  http://* = none
  588. #### Example ####
  589. # Use www.foo.com as a default http proxy server on port 8080
  590. # Except for the foo.com domain which has no proxy.
  591. # http://*    = www.foo.com:8080
  592. # *://foo.com = none
  593. }
  594. #
  595. # A list of ways of recognising a URL not to display in the indexes.
  596. #
  597. # Header : DontIndex
  598. # Options: outgoing = URL-SPECIFICATION
  599. #               Do not index any URLs that match this in the outgoing index.
  600. #          latest   = URL-SPECIFICATION
  601. #               Do not index any URLs that match this in the
  602. #               lasttime/prevtime/latest indexes.
  603. #          monitor  = URL-SPECIFICATION
  604. #               Do not index any URLs that match this in the monitor index.
  605. #          host     = URL-SPECIFICATION
  606. #               Do not index any URLs that match this in the host indexes.
  607. #          URL-SPECIFICATION
  608. #               Do not index any URLs that match this in any of the indexes.
  609. #
  610. # Notes 1: See the bottom of this file for the description of URL-SPECIFICATION
  611. #
  612. DontIndex
  613. {
  614. #### Example ####
  615. # Don't index any hosts in the barfoo.com domain.
  616. # *://*.barfoo.com/
  617. # Don't index any gif or jpg files in the lasttime index.
  618. # latest = *://*/*.gif
  619. # latest = *://*/*.jpg
  620. }
  621. #
  622. # Aliases specification
  623. #
  624. # A list of aliases that are used to replace the server name and path with
  625. # another server name and path.  Also for servers known by two names.
  626. #
  627. # Header : Alias
  628. # Options: URL-SPECIFICATION = URL-SPECIFICATION
  629. #               Any requests for the first URL-SPECIFICATION are replaced by the
  630. #               second URL-SPECIFICATION.
  631. #
  632. # Notes 1: See the bottom of this file for the description of URL-SPECIFICATION
  633. #       2: The URL-SPECIFICATIONs must match exactly, no WILDCARDs are used and
  634. #          the URL arguments are ignored.
  635. #
  636. Alias
  637. {
  638. #### Example ####
  639. # The http server www.bar.com is mirrored locally at www.bar-mirror.foo.com
  640. # http://www.bar.com/ = http://www.bar-mirror.foo.com/
  641. # The wwwoffle homepage can be aliased
  642. # http://wwwoffle/ = http://www.gedanken.demon.co.uk/wwwoffle/
  643. }
  644. #
  645. # Purge method and maximum ages specification.
  646. #
  647. # The method to determine which pages to purge, the default age, the host
  648. # specific maximum age of the pages in days, and the maximum cache size.
  649. #
  650. # Header : Purge
  651. # Options: use-mtime          = yes | no
  652. #               The decision of which pages to purge can be made on last access
  653. #               time (atime) or last modification time (mtime) (default=no).
  654. #          max-size           = <integer>
  655. #               The maximum allowed size of the cache in MB after purging
  656. #               (default=0).
  657. #          min-free            = <integer>
  658. #               The minimum amount of free disk space in MB after purging
  659. #               (default=0).
  660. #          use-url            = yes | no
  661. #               If true then use the URL to decide on the purge age, otherwise
  662. #               use the protocol and host only (default=no).
  663. #          del-dontget        = yes | no
  664. #               If true then delete the files from hosts that are in the DontGet
  665. #               section (default=no).
  666. #          del-dontcache      = yes | no
  667. #               If true then delete the files from hosts that are in the
  668. #               DontCache section (default=no).
  669. #          default            = <integer>
  670. #               The default maximum age for pages on hosts (default=14).
  671. #          URL-SPECIFICATION  = <integer>
  672. #               The maximum age for pages on hosts that match the
  673. #               URL-SPECIFICATION.
  674. #
  675. # Notes 1: See the bottom of this file for the description of URL-SPECIFICATION
  676. #       2: A hostname that matches more than one entry here uses the age of the
  677. #          longest matching one (the protocol is counted in assessing length).
  678. #       3: A zero age means always delete on purge, negative means never purge.
  679. #       4: A maximum cache size of 0 means there is no limit to the size.
  680. #       5: A minimum disk free of 0 means there is no limit to the free space.
  681. #       6: If the max-size and min-free options are both used the smaller cache
  682. #          size is chosen.
  683. #       7: The max-size and min-free options take into account the hosts that
  684. #          are never purged when measuring the cache size but do not purge them.
  685. #       8: The URL-SPECIFICATION matches only the protocol and host unless
  686. #          use-url is set to true.
  687. #
  688. Purge
  689. {
  690.  use-mtime     = no
  691.  max-size      = 0
  692.  min-free      = 0
  693.  use-url       = no
  694.  del-dontget   = yes
  695.  del-dontcache = yes
  696.  default       = 28
  697. #### Example ####
  698. # Expire hosts in the domain foo.com at 1 week except bar.foo.com at 2 weeks.
  699. # *://foo.com/ = 7
  700. # *://bar.foo.com/ = 14
  701. # Never keep anything in the domain bar.com except foo.bar.com is always kept.
  702. # *://bar.com/ = 0
  703. # *://foo.bar.com/ = -1
  704. #
  705. # Keep ftp files for 7 days and http for 14.
  706. # ftp://* = 7
  707. # http://* = 14
  708. #
  709. # Purge files to keep the cache below 10 MB
  710. # max-size = 10
  711. }
  712. #
  713. # WILDCARD
  714. #
  715. # A WILDCARD match is one that uses the '*' character to represent any group of
  716. # characters.
  717. #
  718. # This is basically the same as the command line file matching expressions in
  719. # DOS or the UNIX shell, except that the '*' can match the '/' character.  A
  720. # maximum of 2 '*' characters can be used in any WILDCARD.
  721. #
  722. # For example
  723. #
  724. # *.gif      matches  foo.gif and bar.gif
  725. # *.foo.com  matches  www.foo.com and ftp.foo.com
  726. # /foo/*     matches  /foo/bar.html and /foo/bar/foobar.html
  727. #
  728. #
  729. # URL-SPECIFICATION
  730. #
  731. # When specifying a host and protocol and pathname in many of the sections a
  732. # URL-SPECIFICATION can be used, this is a way of recognising a URL.
  733. #
  734. # For the purposes of this explanation a URL is considered to be made up of five
  735. # parts.
  736. #
  737. # proto          The protocol that is used (e.g. 'http', 'ftp')
  738. # host           The server hostname (e.g. 'www.gedanken.demon.co.uk').
  739. # port           The port number on the host (e.g. default of 80 for HTTP).
  740. # path           The pathname on the host (e.g. '/bar.html') or a directory name
  741. #                (e.g. '/foo/').
  742. # args           Optional arguments with the URL used for CGI scripts etc.
  743. #                (e.g. 'search=foo').
  744. #
  745. # For example the WWWOFFLE homepage: http://www.gedanken.demon.co.uk/wwwoffle/
  746. # The protocol is 'http', the host is 'www.gedanken.demon.co.uk', the port is
  747. # the default (in this case 80), and the pathname is '/wwwoffle/'.
  748. #
  749. # In general this is written as <proto>://<host>[:<port>]/<path>[?<args>]
  750. #
  751. # Where [] indicates an optional feature, and <> indicate a user supplied name
  752. # or number.
  753. #
  754. # Some example URL-SPECIFICATION options are the following:
  755. #
  756. # *://*              Any protocol, Any host, Any port, Any path, Any args
  757. #                    (This is that same as saying 'default').
  758. #
  759. # *://*/<path>       Any protocol, Any host, Any port, Named path, Any args
  760. # *://*/*.<ext>      Any protocol, Any host, Any port, Named path, Any args
  761. # *://*/*?           Any protocol, Any host, Any port, Any path, No args
  762. # *://<path>?*       Any protocol, Any host, Any port, Named path, Any args
  763. # *://<host>         Any protocol, Named host, Any port, Any path, Any args
  764. # <proto>://         Named protocol, Any host, Any port, Any path, Any args
  765. # <proto>://<host>   Named protocol, Named host, Any port, Any path, Any args
  766. #
  767. # <proto>://<host>:  Named protocol, Named host, Default port, Any path Any args
  768. #
  769. # *://<host>:<port>  Any protocol, Named host, Named port, Any path, Any args
  770. #
  771. # The matching of the host, the path and the args use the wildcard matching that
  772. # is described above.
  773. #
  774. # In some sections that accept URL-SPECIFICATIONs they can be negated by
  775. # appending the '!' character to the start.  This will mean that the comparison
  776. # of a URL with the URL-SPECIFICATION will return the logically opposite value
  777. # to what would be returned without the '!'.  If all of the URL-SPECIFICATIONs
  778. # in a section are negated and '*://*/*' is added to the end then the sense of
  779. # the whole section is negated.
  780. #