X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;f=doc%2Fsource%2Fp-config.sgml;h=d08714497450c2e6cdec6fba7102e913021b2497;hb=ad70ee7ab4cd85607b402a16bda85963a6e02583;hp=44570e66615a7ec880b2fd17441fb39f0f2e0844;hpb=54b4e8c141117d636f6113ec4c43579248b77ed7;p=privoxy.git diff --git a/doc/source/p-config.sgml b/doc/source/p-config.sgml index 44570e66..d0871449 100644 --- a/doc/source/p-config.sgml +++ b/doc/source/p-config.sgml @@ -3,9 +3,9 @@ Purpose : Used with other docs and files only. - $Id: p-config.sgml,v 2.55 2009/12/15 17:43:40 fabiankeil Exp $ + $Id: p-config.sgml,v 2.67 2011/01/09 12:10:34 fabiankeil Exp $ - Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ + Copyright (C) 2001-2010 Privoxy Developers http://www.privoxy.org/ See LICENSE. ======================================================================== @@ -97,10 +97,10 @@ Sample Configuration File for Privoxy v&p-version; - $Id: p-config.sgml,v 2.55 2009/12/15 17:43:40 fabiankeil Exp $ + $Id: p-config.sgml,v 2.67 2011/01/09 12:10:34 fabiankeil Exp $ -Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ +Copyright (C) 2001-2010 Privoxy Developers http://www.privoxy.org/ @@ -796,7 +796,7 @@ actionsfile @@filterfile default.filter]]> -@@#filterfile user.filter # User customizations]]> +@@filterfile user.filter # User customizations]]> @@ -1009,7 +1009,7 @@ actionsfile debug 2 # show each connection status debug 4 # show I/O status debug 8 # show header parsing - debug 16 # log all data written to the network into the logfile + debug 16 # log all data written to the network debug 32 # debug force feature debug 64 # debug regular expression filters debug 128 # debug redirects @@ -1019,6 +1019,7 @@ actionsfile debug 2048 # CGI user interface debug 4096 # Startup banner and warnings. debug 8192 # Non-fatal errors + debug 32768 # log all data read from the network @@ -1710,8 +1711,8 @@ ACLs: permit-access and deny-access IP addresses, only the first one is used. - Some systems allows IPv4 client to connect to IPv6 server socket. - Then the client's IPv4 address will be translated by system into + Some systems allow IPv4 clients to connect to IPv6 server sockets. + Then the client's IPv4 address will be translated by the system into IPv6 address space with special prefix ::ffff:0:0/96 (so called IPv4 mapped IPv6 address). Privoxy can handle it and maps such ACL addresses automatically. @@ -2277,6 +2278,10 @@ forward-socks4, forward-socks4a and forward-socks5 that go away when you try again manually. Start with a small value and check Privoxy's logfile from time to time, to see how many retries are usually needed. + + Due to a bug, this option currently also causes Privoxy to + retry in case of certain problems with direct connections. + @@ -2536,6 +2541,23 @@ forward-socks4, forward-socks4a and forward-socks5 This option has no effect if Privoxy has been compiled without keep-alive support. + + Note that a timeout of five seconds as used in the default + configuration file significantly decreases the number of + connections that will be reused. The value is used because + some browsers limit the number of connections they open to + a single host and apply the same limit to proxies. This can + result in a single website grabbing all the + connections the browser allows, which means connections to + other websites can't be opened until the connections currently + in use time out. + + + Several users have reported this as a Privoxy bug, so the + default value has been reduced. Consider increasing it to + 300 seconds or even more if you think your browser can handle + it. If your browser appears to be hanging it can't. + @@ -2547,7 +2569,7 @@ forward-socks4, forward-socks4a and forward-socks5 -@@keep-alive-timeout 300]]> +@@keep-alive-timeout 5]]> @@ -2768,9 +2790,9 @@ forward-socks4, forward-socks4a and forward-socks5 Notes: - For SOCKS requests the timeout currently doesn't start until - the SOCKS server accepted the request. This will be fixed in - the next release. + The default is quite high and you probably want to reduce it. + If you aren't using an occasionally slow proxy like Tor, reducing + it to a few seconds should be fine. @@ -2870,25 +2892,13 @@ forward-socks4, forward-socks4a and forward-socks5 handle-as-empty-doc-returns-ok - - Note: - - - This is a work-around for Firefox bug 492459: - - Websites are no longer rendered if SSL requests for JavaScripts are blocked by a proxy. - - ( - https://bugzilla.mozilla.org/show_bug.cgi?id=492459) - - - Specifies: The status code Privoxy returns for pages blocked with - +handle-as-empty-document. + + +handle-as-empty-document. @@ -2913,6 +2923,8 @@ forward-socks4, forward-socks4a and forward-socks5 Privoxy returns a status 403(forbidden) for all blocked pages. + + Effect if set: @@ -2921,8 +2933,24 @@ forward-socks4, forward-socks4a and forward-socks5 + + Notes: + + + This is a work-around for Firefox bug 492459: + + Websites are no longer rendered if SSL requests for JavaScripts are blocked by a proxy. + + (https://bugzilla.mozilla.org/show_bug.cgi?id=492459) + As the bug has been fixed for quite some time this option should no longer + be needed and will be removed in a future release. Please speak up if you + have a reason why the option should be kept around. + + + -@@#handle-as-empty-doc-returns-ok 0]]> +@@#handle-as-empty-doc-returns-ok 1]]>