# Sample Configuration file for the Internet Junkbuster 2.0
#
-# $Id: config,v 1.2 2001/04/30 03:05:11 rodney Exp $
+# $Id: config,v 1.6 2001/05/26 17:25:14 jongfoster Exp $
#
# Table of Contents
#
-# 1. INTRODUCTION
+# 1. INTRODUCTION
# 2. FORMAT OF THE CONFIGURATION FILE
# 3. OTHER CONFIGURATION FILES
-# 4. GENERAL OPTIONS
+# 4. GENERAL OPTIONS
# 5. WINDOWS GUI OPTIONS
#
# 1. INTRODUCTION
#
# Indicates that the blockfile is named 'blocklist.ini'.
#
-# The '#' indicates a comment. Any part of a line following a # is
-# ignored.
+# The '#' indicates a comment. Any part of a line following a '#' is
+# ignored, except if the '#' is preceded by a '\'.
#
# Thus, by placing a # at the start of an existing configuration line,
# you can make it a comment and it will be treated as if it weren't there.
# off features: If you comment out the "logfile" line, junkbuster will
# not log at all. Watch for the "default:" section in each explanation
# to see what happens if the option is left unset (or commented out).
+#
+# Long lines can be continued on the next line by using a `\' as
+# the last character. This also works if comments are present in
+# between.
#
#
# absolute path name can be used to avoid problems.
#
-# The blockfile contains regular expressions, one per line, of URLs
-# to be blocked by Junkbuster.
-#
-# Default: Don't block anything.
-#
-blockfile ./blocklist
-
+# The permissions file contains patterns to specify the
+# filtering rules to apply to each site.
#
-# The imagefile contains regular expressions, one per line, of URLs
-# to be blocked as images by Junkbuster, regardless of whether they
-# look like image URLs or not.
-#
-# Default: Block all URLs as HTML requests.
-#
-imagefile ./imagelist
-
-#
-# The popfile contains regular expressions, one per line, of sites
-# where Junkbuster should disable Javascript popups.
-#
-# Default: No popup filtering.
+# Default: Cookies to and from all destinations are filtered.
+# Popups are disabled for all sites.
+# All sites are filtered if re_filterfile specified.
+# No sites are blocked. Nothing is an image.
#
-popupfile ./popup
+permissionsfile ./permissionsfile
#
# The re_filterfile contains content modification rules. These rules
#
# Default: No content modification.
#
-re_filterfile ./re_filterfile
-
-#
-# The cookiefile defines how Junkbuster should treat cookies: filter
-# them out; permit them; permit them only one-way from your browser
-# to the site, etc. You can set this on a site-by-site basis, so
-# that you can, for example, use cookies at sites you trust while
-# filtering them out everywhere else.
-#
-# Default: Cookies to and from all destinations are filtered.
-#
-cookiefile ./cookiefile
+re_filterfile ./re_filterfile
#
# The logfile is where all logging and error messages are written.
# Junkbuster (e.g., it's not blocking an ad you think it should
# block) but in most cases you probably will never look at it.
#
-# If you do not use 'log-buffer-size'/'log-max-lines' (see below)
-# your logfile will grow indefinitely, and you will probably want to
+# Your logfile will grow indefinitely, and you will probably want to
# periodically remove it. On Unix systems, you can do this with a
# cron job (see 'man cron').
#
#
# Default: Log to the standard error channel, not to a file
#
-logfile ./junkbuster.log
+logfile ./junkbuster.log
#
# The jarfile defines where Junkbuster stores the cookies it
#
# Default: Don't store intercepted cookies
#
-#jarfile ./jarfile
+#jarfile ./jarfile
#
# The forwardfile defines domain-specific forwarding of HTTP
#
# Default: Make all connections directly.
#
-forwardfile ./forward
+forwardfile ./forward
#
# Generally, Junkbuster is used as a personal proxy. The default
# Default: No access control. Everybody that can reach junkbuster
# will be served.
#
-#aclfile ./aclfile
+#aclfile ./aclfile
#
# 4. OPTIONS
# how Junkbuster operates.
#
-#
-# If 're_filter_all' is set, (commented in) Junkbuster will attempt
-# content modification (see 're_filterfile' above) on all requests.
-#
-# Default: Content modification takes only place if no cookie would
-# be sent to the server.
-#
-#re_filter_all
-
#
# If 'add-forwarded-header' is set, an "X-Forwarded-For:"
# specification will be added to each request header. Generally,
# Junkbuster has the ability to mask the Referer header. Referer
# headers can be used to track users as they browse around the web,
# and many consider them invasive. Junkbuster provides several
-# options for dealing with referer headers:
+# options for dealing with referer headers.
+#
+# Note that the setting of this value can be overridden on a
+# site-by-site basis in the permissionsfile, in order to send
+# the unmodified Referer header to sites which require it.
+# This option controls what to do for sites without that
+# permission.
#
# VALUE EFFECT
# ===== ======
-# default Kill the referrer-header from the client.
-# . Pass the referrer unchanged.
-# @ Pass the referrer if the server is in the cookie file,
-# kill the referrer otherwise.
-# L Pass the referrer if the server is in the cookie file,
-# send a forged referrer that points to the
+# default Kill the referrer-header from the client.
+# @ Kill the referrer-header from the client.
+# . Always pass the referrer unchanged.
+# L Send a forged referrer that points to the
# root-directory URL of the current request otherwise.
-# 'text' Always send <text> as the referrer.
+# 'text' Send <text> as the referrer.
#
# L is probably preferable to @, because it will break fewer Web
# sites while still concealing your browsing path.
#
# Default: see above
#
-referer L
+referer L
#
# Some browsers provide a "From:" header that gives Web sites your
#
# Default: see above
#
-from spam-me-senseless@sittingduck.xqq
+#from spam-me-senseless@sittingduck.xqq
#
# The 'tinygif' option lets you change how Junkbuster treats blocked
#
# VALUE EFFECT
# ===== ======
-# 0 Send HTML
-# 1 Send a GIF of one transparent pixel
-# 2 Send a GIF with the word "JUNKBUSTER"
-# 3 <url> Send a redirect to the image indicated by the <url>
+# 0 Send HTML
+# 1 Send a GIF of one transparent pixel
+# 2 Send a GIF with the word "JUNKBUSTER"
+# 3 <url> Send a redirect to the image indicated by the <url>
#
# As an example of the last option:
#
-# tinygif 3 http://www.junkbusters.com/images/fb.gif
+# tinygif 3 http://i.j.b/ijb-send-banner.gif
#
-# Will replace every blocked image with the "fb.gif" image.
+# Will replace every blocked image with an image built into junkbuster.
#
# There is one non-obvious benefit to using option "3". If you use
# option 3, your Web browser will likely cache the image you specify
#
# Default: 0, i.e. send HTML
#
-tinygif 2
+tinygif 2
+
#
# The debug option sets the level of debugging information to log in
# debug 16 # LOG = log all data into the logfile
# debug 32 # FRC = debug force feature
# debug 64 # REF = debug regular expression filter
+# debug 128 # RED = debug fast redirects
+# debug 256 # CLF = Common Log Format
+# debug 4096 # INFO = Startup banner and warnings.
+# debug 8192 # ERROR = Non-fatal errors
+#
+# It is *highly recommended* that you enable ERROR
+# reporting. (debug 8192).
+#
+# The reporting of FATAL errors (i.e. ones which crash
+# JunkBuster) is always on and cannot be disabled.
+#
+# If you want to use CLF, you should set "debug 256" ONLY,
+# do not enable anything else.
#
# Multiple "debug" directives, are OK - they're logical-OR'd
# together.
#
# debug 15 # same as setting the first 4 listed above
#
-# Default: 0, i.e. log nothing but errors and infos
+# Default: 0, i.e. log nothing but fatal errors
#
-debug 1
+debug 1
+debug 8192 # Errors - *we highly recommended enabling this*
#
# Junkbuster normally uses "multi-threading", a software technique
#single-threaded
#
-# 'toggle' controls whether Junkbuster can temporarily be toggled on
-# and off.
+# 'toggle' allows you to temporarily disable all Junkbuster's
+# filtering. Just set "toggle 0".
#
# The Windows version of Junkbuster puts an icon in the system
-# tray. If you right-click on that icon (or select the 'Options'
-# menu), one choice is "Enable". Clicking on enable toggles
-# Junkbuster on and off. This is useful if you want to temporarily
-# disable Junkbuster, e.g., to access a site that requires cookies
-# which you normally have blocked.
-#
-# Unix versions of Junkbuster are toggled on and off by sending a
-# SIGHUP to Junkbuster.
+# tray, which allows you to change this option without having
+# to edit this file. If you right-click on that icon (or select
+# the 'Options' menu), one choice is "Enable". Clicking on enable
+# toggles Junkbuster on and off. This is useful if you want to
+# temporarily disable Junkbuster, e.g., to access a site that
+# requires cookies which you normally have blocked.
#
-# 'toggle 1' means permit toggling of Junkbuster, 'toggle 0' means
-# don't.
+# 'toggle 1' means Junkbuster runs normally, 'toggle 0' means
+# that Junkbuster becomes a non-anonymizing non-blocking
+# proxy.
#
# Default: 1
#
toggle 1
#
-# 5. WINDOWS GUI OTPIONS
+# 5. WINDOWS GUI OPTIONS
#
# Junkbuster has a number of options specific to the Windows GUI
# interface:
# Warning: Setting this to 0 will result in the buffer to grow
# infinitely and eat up all your memory!
#
-#Win32-only: log-buffer-size 1
+#Win32-only: log-buffer-size 1
-# log-max-lines {number of lines, e.g., '200'}
+# log-max-lines {number of lines, e.g., '200'}
#
# Maximum number of lines held in the log buffer. See above.
#
-#Win32-only: log-max-lines 200
+#Win32-only: log-max-lines 200
# log-highlight-messages {1 or 0}
#
# show-on-task-bar {1 or 0}
#
-# Controls whether or not Junkbuster will appear on the Task bar
-# when minimized.
+# Controls whether or not Junkbuster will appear as a button on the Task
+# bar when minimized.
#
#Win32-only: show-on-task-bar 0
projects / privoxy.git / blobdiff