X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=config;h=520ad09214152c1f92a8ff2d20e3fbf1f12bf946;hp=fbc5321fb302989dc07ba1874c5fad89cfbd7a1f;hb=943b493f74871337f51ffa3b3d94b0c98173b0fe;hpb=79333c91ef31f1401983a10982661f6724b6488c diff --git a/config b/config index fbc5321f..520ad092 100644 --- a/config +++ b/config @@ -1,15 +1,15 @@ # 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.4 2001/05/22 17:43:35 oes 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 @@ -33,8 +33,8 @@ # # 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. @@ -42,6 +42,10 @@ # 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. # # @@ -63,7 +67,7 @@ # # Default: Don't block anything. # -blockfile ./blocklist +blockfile ./blocklist # # The imagefile contains regular expressions, one per line, of URLs @@ -72,15 +76,17 @@ blockfile ./blocklist # # Default: Block all URLs as HTML requests. # -imagefile ./imagelist +imagefile ./imagelist # -# The popfile contains regular expressions, one per line, of sites -# where Junkbuster should disable Javascript popups. +# The permissions file contains patterns to specify the +# cookie and filtering rules to apply to each site. # -# 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. # -popupfile ./popup +permissionsfile ./permissionsfile # # The re_filterfile contains content modification rules. These rules @@ -91,18 +97,7 @@ popupfile ./popup # # 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. @@ -122,7 +117,7 @@ cookiefile ./cookiefile # # 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 @@ -131,7 +126,7 @@ logfile ./junkbuster.log # # Default: Don't store intercepted cookies # -#jarfile ./jarfile +#jarfile ./jarfile # # The forwardfile defines domain-specific forwarding of HTTP @@ -142,7 +137,7 @@ logfile ./junkbuster.log # # Default: Make all connections directly. # -forwardfile ./forward +forwardfile ./forward # # Generally, Junkbuster is used as a personal proxy. The default @@ -160,7 +155,7 @@ forwardfile ./forward # Default: No access control. Everybody that can reach junkbuster # will be served. # -#aclfile ./aclfile +#aclfile ./aclfile # # 4. OPTIONS @@ -169,15 +164,6 @@ forwardfile ./forward # 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, @@ -310,8 +296,8 @@ user-agent . # # VALUE EFFECT # ===== ====== -# default Kill the referrer-header from the client. -# . Pass the referrer unchanged. +# 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, @@ -324,7 +310,7 @@ user-agent . # # Default: see above # -referer L +referer L # # Some browsers provide a "From:" header that gives Web sites your @@ -340,7 +326,7 @@ referer L # # 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 @@ -350,16 +336,16 @@ from spam-me-senseless@sittingduck.xqq # # VALUE EFFECT # ===== ====== -# 0 Send HTML -# 1 Send a GIF of one transparent pixel -# 2 Send a GIF with the word "JUNKBUSTER" -# 3 Send a redirect to the image indicated by the +# 0 Send HTML +# 1 Send a GIF of one transparent pixel +# 2 Send a GIF with the word "JUNKBUSTER" +# 3 Send a redirect to the image indicated by the # # As an example of the last option: # -# tinygif 3 http://www.junkbusters.com/images/fb.gif +# tinygif 3 http://no.where/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 @@ -369,7 +355,32 @@ from spam-me-senseless@sittingduck.xqq # # Default: 0, i.e. send HTML # -tinygif 2 +tinygif 2 + +# +# Many sites, like yahoo.com, don't just link to other sites. +# Instead, they will link to some script on their own server, +# giving the destination as a parameter, which will then redirect +# you to the final target. +# +# URLs resulting from this scheme typically look like: +# http://some.place/some_script?http://some.where-else +# +# Sometimes, there are even multiple consecutive redirects encoded +# in the URL. These redirections via scripts make your web browing +# more traceable, since the server from which you follow such a link +# can see where you go to. Apart from that, valuable bandwidth and +# time is wasted, while your browser aks the server for one redirect +# after the other. Plus, it feeds the advertisers. +# +# The fast-redirects option enables interception of these requests +# by junkbuster, who will cut off all but the last valid URL in the +# request and send a local redirect back to your browser without +# contacting the remote site. +# +# Default: Don't intercept script-redirect URLs +# +fast-redirects # # The debug option sets the level of debugging information to log in @@ -385,6 +396,7 @@ tinygif 2 # 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 # # Multiple "debug" directives, are OK - they're logical-OR'd # together. @@ -393,7 +405,7 @@ tinygif 2 # # Default: 0, i.e. log nothing but errors and infos # -debug 1 +debug 1 # # Junkbuster normally uses "multi-threading", a software technique @@ -455,13 +467,13 @@ toggle 1 # 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} #