commit 3313e38ac9db39c67918357b2cd5df5d8709c805 Author: n8fr8 nathan@freitas.net Date: Wed Jun 27 23:42:39 2012 -0400
privoxy 3.0.12 clean checkin --- external/privoxy/AUTHORS | 19 +- external/privoxy/ChangeLog | 799 +-- external/privoxy/GNUmakefile.in | 1371 ++- external/privoxy/INSTALL | 20 +- external/privoxy/README | 110 +- external/privoxy/acconfig.h | 246 +- external/privoxy/actionlist.h | 164 +- external/privoxy/actions.c | 449 +- external/privoxy/actions.h | 95 +- external/privoxy/amiga.c | 64 +- external/privoxy/amiga.h | 45 +- external/privoxy/cgi.c | 1084 ++- external/privoxy/cgi.h | 182 +- external/privoxy/cgiedit.c | 442 +- external/privoxy/cgiedit.h | 76 +- external/privoxy/cgisimple.c | 661 +- external/privoxy/cgisimple.h | 82 +- external/privoxy/config | 495 +- external/privoxy/config.guess | 466 +- external/privoxy/config.sub | 243 +- external/privoxy/configure.in | 714 +- external/privoxy/cygwin.h | 26 +- external/privoxy/deanimate.c | 113 +- external/privoxy/deanimate.h | 57 +- external/privoxy/default.action.master | 518 +- external/privoxy/default.filter | 517 +- external/privoxy/doc/pcrs.3 | 32 +- external/privoxy/doc/source/authors.sgml | 16 +- external/privoxy/doc/source/buildsource.sgml | 46 +- external/privoxy/doc/source/config.sgml | 16 +- external/privoxy/doc/source/contacting.sgml | 119 +- external/privoxy/doc/source/copyright.sgml | 14 +- external/privoxy/doc/source/developer-manual.sgml | 631 +- external/privoxy/doc/source/faq.sgml | 823 +- external/privoxy/doc/source/history.sgml | 12 +- external/privoxy/doc/source/install.sgml | 20 +- external/privoxy/doc/source/ldp.dsl.in | 2 +- external/privoxy/doc/source/license.sgml | 10 +- external/privoxy/doc/source/newfeatures.sgml | 80 +- external/privoxy/doc/source/p-authors.sgml | 22 +- external/privoxy/doc/source/p-config.sgml | 864 +-- external/privoxy/doc/source/privoxy-man-page.sgml | 72 +- external/privoxy/doc/source/privoxy.sgml | 29 +- external/privoxy/doc/source/readme.sgml | 110 +- external/privoxy/doc/source/seealso.sgml | 30 +- external/privoxy/doc/source/supported.sgml | 10 +- external/privoxy/doc/source/user-manual.sgml | 2474 +--- external/privoxy/doc/source/webserver/index.sgml | 46 +- external/privoxy/doc/webserver/announce.txt | 435 +- .../doc/webserver/developer-manual/coding.html | 3659 ++++-- .../doc/webserver/developer-manual/contact.html | 872 +- .../doc/webserver/developer-manual/copyright.html | 459 +- .../doc/webserver/developer-manual/cvs.html | 519 +- .../webserver/developer-manual/documentation.html | 1406 ++- .../doc/webserver/developer-manual/index.html | 1094 ++- .../webserver/developer-manual/introduction.html | 315 +- .../doc/webserver/developer-manual/newrelease.html | 3041 +++-- .../doc/webserver/developer-manual/seealso.html | 609 +- .../doc/webserver/developer-manual/testing.html | 428 +- .../developer-manual/webserver-update.html | 407 +- .../privoxy/doc/webserver/faq/configuration.html | 2673 +++-- external/privoxy/doc/webserver/faq/contact.html | 873 +- external/privoxy/doc/webserver/faq/copyright.html | 466 +- external/privoxy/doc/webserver/faq/general.html | 1690 ++- external/privoxy/doc/webserver/faq/index.html | 1557 ++- .../privoxy/doc/webserver/faq/installation.html | 828 +- external/privoxy/doc/webserver/faq/misc.html | 2664 +++-- external/privoxy/doc/webserver/faq/trouble.html | 1970 ++-- external/privoxy/doc/webserver/index.html | 535 +- .../doc/webserver/man-page/privoxy-man-page.html | 505 +- external/privoxy/doc/webserver/privoxy-index.html | 468 +- external/privoxy/doc/webserver/team/index.html | 62 +- .../doc/webserver/user-manual/actions-file.html |12806 ++++++++++++-------- .../doc/webserver/user-manual/appendix.html | 3020 ++++-- .../privoxy/doc/webserver/user-manual/config.html | 7146 +++++++----- .../doc/webserver/user-manual/configuration.html | 796 +- .../privoxy/doc/webserver/user-manual/contact.html | 878 +- .../doc/webserver/user-manual/copyright.html | 709 +- .../doc/webserver/user-manual/filter-file.html | 2458 +++-- .../privoxy/doc/webserver/user-manual/index.html | 1584 ++- .../doc/webserver/user-manual/installation.html | 1635 ++- .../doc/webserver/user-manual/introduction.html | 474 +- .../doc/webserver/user-manual/quickstart.html | 1394 ++- .../privoxy/doc/webserver/user-manual/seealso.html | 626 +- .../privoxy/doc/webserver/user-manual/startup.html | 1360 ++- .../doc/webserver/user-manual/templates.html | 487 +- .../doc/webserver/user-manual/whatsnew.html | 1411 +-- external/privoxy/encode.c | 186 +- external/privoxy/encode.h | 40 +- external/privoxy/errlog.c | 556 +- external/privoxy/errlog.h | 139 +- external/privoxy/filters.c | 1320 ++- external/privoxy/filters.h | 266 +- external/privoxy/gateway.c | 570 +- external/privoxy/gateway.h | 103 +- external/privoxy/icons/off.ico | Bin 2550 -> 318 bytes external/privoxy/icons/privoxy.ico | Bin 2550 -> 318 bytes external/privoxy/jbsockets.c | 917 +- external/privoxy/jbsockets.h | 95 +- external/privoxy/jcc.c | 2622 +++-- external/privoxy/jcc.h | 153 +- external/privoxy/list.c | 126 +- external/privoxy/list.h | 82 +- external/privoxy/loadcfg.c | 933 +- external/privoxy/loadcfg.h | 123 +- external/privoxy/loaders.c | 547 +- external/privoxy/loaders.h | 153 +- external/privoxy/match-all.action | 4 +- external/privoxy/miscutil.c | 423 +- external/privoxy/miscutil.h | 172 +- external/privoxy/parsers.c | 1935 ++-- external/privoxy/parsers.h | 246 +- external/privoxy/pcrs.c | 261 +- external/privoxy/pcrs.h | 75 +- external/privoxy/privoxy-generic.init | 51 + external/privoxy/privoxy.1 | 70 +- external/privoxy/project.h | 980 ++- external/privoxy/regression-tests.action | 149 +- external/privoxy/ssplit.c | 57 +- external/privoxy/ssplit.h | 35 +- external/privoxy/templates/blocked | 18 +- external/privoxy/templates/cgi-error-404 | 8 +- external/privoxy/templates/cgi-error-bad-param | 6 +- external/privoxy/templates/cgi-error-disabled | 6 +- external/privoxy/templates/cgi-error-file | 4 +- .../privoxy/templates/cgi-error-file-read-only | 4 +- external/privoxy/templates/cgi-error-modified | 10 +- external/privoxy/templates/cgi-error-parse | 8 +- external/privoxy/templates/cgi-style.css | 28 +- external/privoxy/templates/connect-failed | 6 +- external/privoxy/templates/default | 6 +- .../privoxy/templates/edit-actions-add-url-form | 71 +- external/privoxy/templates/edit-actions-for-url | 276 +- .../privoxy/templates/edit-actions-for-url-filter | 14 +- external/privoxy/templates/edit-actions-list | 147 +- .../privoxy/templates/edit-actions-list-button | 20 +- .../privoxy/templates/edit-actions-list-section | 62 +- external/privoxy/templates/edit-actions-list-url | 45 +- .../privoxy/templates/edit-actions-remove-url-form | 68 +- external/privoxy/templates/edit-actions-url-form | 71 +- external/privoxy/templates/forwarding-failed | 6 +- external/privoxy/templates/mod-local-help | 4 +- external/privoxy/templates/mod-support-and-service | 26 +- external/privoxy/templates/no-such-domain | 8 +- external/privoxy/templates/show-request | 6 +- external/privoxy/templates/show-status | 57 +- external/privoxy/templates/show-status-file | 8 +- external/privoxy/templates/show-url-info | 58 +- external/privoxy/templates/show-version | 14 +- external/privoxy/templates/toggle | 8 +- external/privoxy/templates/toggle-mini | 6 +- external/privoxy/templates/untrusted | 12 +- external/privoxy/tools/privoxy-log-parser.pl | 1236 +-- external/privoxy/tools/privoxy-regression-test.pl | 762 +- external/privoxy/tools/url-pattern-translator.pl | 4 +- external/privoxy/urlmatch.c | 554 +- external/privoxy/urlmatch.h | 76 +- external/privoxy/user.action | 32 +- external/privoxy/utils/changelog2doc.pl | 101 +- external/privoxy/w32.rc | 146 +- external/privoxy/w32log.c | 273 +- external/privoxy/w32log.h | 85 +- external/privoxy/w32res.h | 115 +- external/privoxy/w32svrapi.c | 45 +- external/privoxy/w32svrapi.h | 15 +- external/privoxy/w32taskbar.c | 44 +- external/privoxy/w32taskbar.h | 26 +- external/privoxy/win32.c | 69 +- external/privoxy/win32.h | 34 +- 169 files changed, 59228 insertions(+), 37724 deletions(-)
diff --git a/external/privoxy/AUTHORS b/external/privoxy/AUTHORS index d5f05a1..3f8a609 100644 --- a/external/privoxy/AUTHORS +++ b/external/privoxy/AUTHORS @@ -7,8 +7,11 @@ Current Privoxy Team: David Schmidt, developer
Hal Burgiss + Mark Miller + Gerry Murphy Lee Rian Roland Rosenfeld + Jörg Strohmayer
Former Privoxy Team Members:
@@ -25,13 +28,10 @@ Former Privoxy Team Members: Adam Lock Guy Laroche Justin McMurtry - Mark Miller - Gerry Murphy Andreas Oesterhelt Haroon Rafique Georg Sauthoff Thomas Steudten - Jörg Strohmayer Rodney Stromlund Sviatoslav Sviridov Sarantis Paskalis @@ -43,15 +43,11 @@ alphabetical order):
Ken Arromdee Devin Bayer - Havard Berland Gergely Bor - Francois Botha Reiner Buehl Andrew J. Caines Clifford Caoile - Wan-Teh Chang Frédéric Crozat - Billy Crook Michael T. Davis Mattes Dolak Matthias Drochner @@ -62,13 +58,12 @@ alphabetical order): Stephen Gildea Daniel Griscom Felix Gröbert - Jeff H. Aaron Hamid Darel Henman Magnus Holmgren Eric M. Hopper Ralf Horstmann - Stefan Huehner + Stefan Huehner Peter Hyman Derek Jennings Petr Kadlec @@ -76,17 +71,13 @@ alphabetical order): Bert van Leeuwen Don Libes Paul Lieverse - Han Liu Toby Lyward Wil Mahan Jindrich Makovicka - Raphael Marichez - Francois Marier David Mediavilla Raphael Moll Amuro Namie Adam Piggott - Petr Písar Dan Price Roberto Ragusa Félix Rauch @@ -94,7 +85,6 @@ alphabetical order): Chung-chieh Shan Spinor S. Bart Schelstraete - Dan Stahlke Oliver Stoeneberg Peter Thoenen Martin Thomas @@ -124,4 +114,3 @@ If we've missed you off this list, please let us know!
Privoxy team. http://www.privoxy.org/ ijbswa-developers@lists.sourceforge.net - diff --git a/external/privoxy/ChangeLog b/external/privoxy/ChangeLog index d92f407..54cc625 100644 --- a/external/privoxy/ChangeLog +++ b/external/privoxy/ChangeLog @@ -1,713 +1,7 @@ -------------------------------------------------------------------- ChangeLog for Privoxy -------------------------------------------------------------------- -*** Version 3.0.19 Stable *** - -- Bug fixes: - - Prevent a segmentation fault when de-chunking buffered content. - It could be triggered by malicious web servers if Privoxy was - configured to filter the content and running on a platform - where SIZE_T_MAX isn't larger than UINT_MAX, which probably - includes most 32-bit systems. On those platforms, all Privoxy - versions before 3.0.19 appear to be affected. - To be on the safe side, this bug should be presumed to allow - code execution as proving that it doesn't seems unrealistic. - - Do not expect a response from the SOCKS4/4A server until it - got something to respond to. This regression was introduced - in 3.0.18 and prevented the SOCKS4/4A negotiation from working. - Reported by qqqqqw in #3459781. - -- General improvements: - - Fix an off-by-one in an error message about connect failures. - - Use a GNUMakefile variable for the webserver root directory and - update the path. Sourceforge changed it which broke various - web-related targets. - - Update the CODE_STATUS description. - -*** Version 3.0.18 Stable *** - -- Bug fixes: - - If a generated redirect URL contains characters RFC 3986 doesn't - permit, they are (re)encoded. Not doing this makes Privoxy versions - from 3.0.5 to 3.0.17 susceptible to HTTP response splitting (CWE-113) - attacks if the +fast-redirects{check-decoded-url} action is used. - - Fix a logic bug that could cause Privoxy to reuse a server - socket after it got tainted by a server-header-tagger-induced - block that was triggered before the whole server response had - been read. If keep-alive was enabled and the request following - the blocked one was to the same host and using the same forwarding - settings, Privoxy would send it on the tainted server socket. - While the server would simply treat it as a pipelined request, - Privoxy would later on fail to properly parse the server's - response as it would try to parse the unread data from the - first response as server headers for the second one. - Regression introduced in 3.0.17. - - When implying keep-alive in client_connection(), remember that - the client didn't. Fixes a regression introduced in 3.0.13 that - would cause Privoxy to wait for additional client requests after - receiving a HTTP/1.1 request with "Connection: close" set - and connection sharing enabled. - With clients which terminates the client connection after detecting - that the whole body has been received it doesn't really matter, - but with clients that don't the connection would be kept open until - it timed out. - - Fix a subtle race condition between prepare_csp_for_next_request() - and sweep(). A thread preparing itself for the next client request - could briefly appear to be inactive. - If all other threads were already using more recent files, - the thread could get its files swept away under its feet. - So far this has only been reproduced while stress testing in - valgrind while touching action files in a loop. It's unlikely - to have caused any actual problems in the real world. - - Disable filters if SDCH compression is used unless filtering is forced. - If SDCH was combined with a supported compression algorithm, Privoxy - previously could try to decompress it and ditch the Content-Encoding - header even though the SDCH compression wasn't dealt with. - Reported by zebul666 in #3225863. - - Make a copy of the --user value and only mess with that when splitting - user and group. On some operating systems modifying the value directly - is reflected in the output of ps and friends and can be misleading. - Reported by zepard in #3292710. - - If forwarded-connect-retries is set, only retry if Privoxy is actually - forwarding the request. Previously direct connections would be retried - as well. - - Fixed a small memory leak when retrying connections with IPv6 - support enabled. - - Remove an incorrect assertion in compile_dynamic_pcrs_job_list() - It could be triggered by a pcrs job with an invalid pcre - pattern (for example one that contains a lone quantifier). - - If the --user argument user[.group] contains a dot, always bail out - if no group has been specified. Previously the intended, but undocumented - (and apparently untested), behaviour was to try interpreting the whole - argument as user name, but the detection was flawed and checked for '0' - instead of '\0', thus merely preventing group names beginning with a zero. - - In html_code_map[], use a numeric character reference instead of ' - which wasn't standardized before XHTML 1.0. - - Fix an invalid free when compiled with FEATURE_GRACEFUL_TERMINATION - and shut down through http://config.privoxy.org/die - - In get_actions(), fix the "temporary" backwards compatibility hack - to accept block actions without reason. - It also covered other actions that should be rejected as invalid. - Reported by Billy Crook. - -- General improvements: - - Privoxy can (re)compress buffered content before delivering - it to the client. Disabled by default as most users wouldn't - benefit from it. - - The +fast-redirects{check-decoded-url} action checks URL - segments separately. If there are other parameters behind - the redirect URL, this makes it unnecessary to cut them off - by additionally using a +redirect{} pcrs command. - Initial patch submitted by Jamie Zawinski in #3429848. - - When loading action sections, verify that the referenced filters - exist. Currently missing filters only result in an error message, - but eventually the severity will be upgraded to fatal. - - Allow to bind to multiple separate addresses. - Patch set submitted by Petr Pisar in #3354485. - - Set socket_error to errno if connecting fails in rfc2553_connect_to(). - Previously rejected direct connections could be incorrectly reported - as DNS issues if Privoxy was compiled with IPv6 support. - - Adjust url_code_map[] so spaces are replaced with %20 instead of '+' - While '+' can be used by client's submitting form data, this is not - actually what Privoxy is using the lookups for. This is more of a - cosmetic issue and doesn't fix any known problems. - - When compiled without FEATURE_FAST_REDIRECTS, do not silently - ignore +fast-redirect{} directives - - Added a workaround for GNU libc's strptime() reporting negative - year values when the parsed year is only specified with two digits. - On affected systems cookies with such a date would not be turned - into session cookies by the +session-cookies-only action. - Reported by Vaeinoe in #3403560 - - Fixed bind failures with certain GNU libc versions if no non-loopback - IP address has been configured on the system. This is mainly an issue - if the system is using DHCP and Privoxy is started before the network - is completely configured. - Reported by Raphael Marichez in #3349356. - Additional insight from Petr Pisar. - - Privoxy log messages now use the ISO 8601 date format %Y-%m-%d. - It's only slightly longer than the old format, but contains - the full date including the year and allows sorting by date - (when grepping in multiple log files) without hassle. - - In get_last_url(), do not bother trying to decode URLs that do - not contain at least one '%' sign. It reduces the log noise and - a number of unnecessary memory allocations. - - In case of SOCKS5 failures, dump the socks response in the log message. - - Simplify the signal setup in main(). - - Streamline socks5_connect() slightly. - - In socks5_connect(), require a complete socks response from the server. - Previously Privoxy didn't care how much data the server response - contained as long as the first two bytes contained the expected - values. While at it, shrink the buffer size so Privoxy can't read - more than a whole socks response. - - In chat(), do not bother to generate a client request in case of - direct CONNECT requests. It will not be used anyway. - - Reduce server_last_modified()'s stack size. - - Shorten get_http_time() by using strftime(). - - Constify the known_http_methods pointers in unknown_method(). - - Constify the time_formats pointers in parse_header_time(). - - Constify the formerly_valid_actions pointers in action_used_to_be_valid(). - - Introduce a GNUMakefile MAN_PAGE variable that defaults to privoxy.1. - The Debian package uses section 8 for the man page and this - should simplify the patch. - - Deduplicate the INADDR_NONE definition for Solaris by moving it to jbsockets.h - - In block_url(), ditch the obsolete workaround for ancient Netscape versions - that supposedly couldn't properly deal with status code 403. - - Remove a useless NULL pointer check in load_trustfile(). - - Remove two useless NULL pointer checks in load_one_re_filterfile(). - - Change url_code_map[] from an array of pointers to an array of arrays - It removes an unnecessary layer of indirection and on 64bit system reduces - the size of the binary a bit. - - Fix various typos. Fixes taken from Debian's 29_typos.dpatch by Roland Rosenfeld. - - Add a dok-tidy GNUMakefile target to clean up the messy HTML - generated by the other dok targets. - - GNUisms in the GNUMakefile have been removed. - - Change the HTTP version in static responses to 1.1 - - Synced config.sub and config.guess with upstream - 2011-11-11/386c7218162c145f5f9e1ff7f558a3fbb66c37c5. - - Add a dedicated function to parse the values of toggles. Reduces duplicated - code in load_config() and provides better error handling. Invalid or missing - toggle values are now a fatal error instead of being silently ignored. - - Terminate HTML lines in static error messages with \n instead of \r\n. - - Simplify cgi_error_unknown() a bit. - - In LogPutString(), don't bother looking at pszText when not - actually logging anything. - - Change ssplit()'s fourth parameter from int to size_t. - Fixes a clang complaint. - - Add a warning that the statistics currently can't be trusted. - Mention Privoxy-Log-Parser's --statistics option as - an alternative for the time being. - - In rfc2553_connect_to(), start setting cgi->error_message on error. - - Change the expected status code returned for http://p.p/die depending - on whether or not FEATURE_GRACEFUL_TERMINATION is available. - - In cgi_die(), mark the client connection for closing. - If the client will fetch the style sheet through another connection - it gets the main thread out of the accept() state and should thus - trigger the actual shutdown. - - Add a proper CGI message for cgi_die(). - - Don't enforce a logical line length limit in read_config_line(). - - Slightly refactor server_last_modified() to remove useless gmtime*() calls. - - In get_content_type(), also recognize '.jpeg' as JPEG extension. - - Add '.png' to the list of recognized file extensions in get_content_type(). - - In block_url(), consistently use the block reason "Request blocked by Privoxy" - In two places the reason was "Request for blocked URL" which hides the - fact that the request got blocked by Privoxy and isn't necessarily - correct as the block may be due to tags. - - In listen_loop(), reload the configuration files after accepting - a new connection instead of before. - Previously the first connection that arrived after a configuration - change would still be handled with the old configuration. - - In chat()'s receive-data loop, skip a client socket check if - the socket will be written to right away anyway. This can - increase the transfer speed for unfiltered content on fast - network connections. - - The socket timeout is used for SOCKS negotiations as well which - previously couldn't timeout. - - Don't keep the client connection alive if any configuration file - changed since the time the connection came in. This is closer to - Privoxy's behaviour before keep-alive support for client connection - has been added and also less confusing in general. - - Treat all Content-Type header values containing the pattern - 'script' as a sign of text. Reported by pribog in #3134970. - -- Action file improvements: - - Moved the site-specific block pattern section below the one for the - generic patterns so for requests that are matched in both, the block - reason for the domain is shown which is usually more useful than showing - the one for the generic pattern. - - Remove -prevent-compression from the fragile alias. It's no longer - used anywhere by default and isn't known to break stuff anyway. - - Add a (disabled) section to block various Facebook tracking URLs. - Reported by Dan Stahlke in #3421764. - - Add a (disabled) section to rewrite and redirect click-tracking - URLs used on news.google.com. - Reported by Dan Stahlke in #3421755. - - Unblock linuxcounter.net/. - Reported by Dan Stahlke in #3422612. - - Block 'www91.intel.com/' which is used by Omniture. - Reported by Adam Piggott in #3167370. - - Disable the handle-as-empty-doc-returns-ok option and mark it as deprecated. - Reminded by tceverling in #2790091. - - Add ".ivwbox.de/" to the "Cross-site user tracking" section. - Reported by Nettozahler in #3172525. - - Unblock and fast-redirect ".awin1.com/.*=http://". - Reported by Adam Piggott in #3170921. - - Block "b.collective-media.net/". - - Widen the Debian popcon exception to "qa.debian.org/popcon". - Seen in Debian's 05_default_action.dpatch by Roland Rosenfeld. - - Block ".gemius.pl/" which only seems to be used for user tracking. - Reported by johnd16 in #3002731. Additional input from Lee and movax. - - Disable banners-by-size filters for '.thinkgeek.com/'. - The filter only seems to catch pictures of the inventory. - - Block requests for 'go.idmnet.bbelements.com/please/showit/'. - Reported by kacperdominik in #3372959. - - Unblock adainitiative.org/. - - Add a fast-redirects exception for '.googleusercontent.com/.*=cache'. - - Add a fast-redirects exception for webcache.googleusercontent.com/. - - Unblock http://adassier.wordpress.com/ and http://adassier.files.wordpress.com/. - -- Filter file improvements: - - Let the yahoo filter hide '.ads'. - - Let the msn filter hide overlay ads for Facebook 'likes' in search - results and elements with the id 's_notf_div'. They only seem to be - used to advertise site 'enhancements'. - - Let the js-events filter additionally disarm setInterval(). - Suggested by dg1727 in #3423775. - -- Documentation improvements: - - Clarify the effect of compiling Privoxy with zlib support. - Suggested by dg1727 in #3423782. - - Point out that the SourceForge messaging system works like a black - hole and should thus not be used to contact individual developers. - - Mention some of the problems one can experience when not explicitly - configuring an IP addresses as listen address. - - Explicitly mention that hostnames can be used instead of IP addresses - for the listen-address, that only the first address returned will be - used and what happens if the address is invalid. - Requested by Calestyo in #3302213. - -- Log message improvements: - - If only the server connection is kept alive, do not pretend to - wait for a new client request. - - Remove a superfluous log message in forget_connection(). - - In chat(), properly report missing server responses as such - instead of calling them empty. - - In forwarded_connect(), fix a log message nobody should ever see. - - Fix a log message in socks5_connect(), a failed write operation - was logged as failed read operation. - - Let load_one_actions_file() properly complain about a missing - '{' at the beginning of the file. - Simply stating that a line is invalid isn't particularly helpful. - - Do not claim to listen on a socket until Privoxy actually does. - Patch submitted by Petr Pisar #3354485 - - Prevent a duplicated LOG_LEVEL_CLF message when sending out - the "no-server-data" response. - - Also log the client socket when dropping a connection. - - Include the destination host in the 'Request ... marked for - blocking. limit-connect{...} doesn't allow CONNECT ...' message - Patch submitted by Saperski in #3296250. - - Prevent a duplicated log message if none of the resolved IP - addresses were reachable. - - In connect_to(), do not pretend to retry if forwarded-connect-retries - is zero or unset. - - When a specified user or group can't be found, put the name in - single-quotes when logging it. - - In rfc2553_connect_to(), explain getnameinfo() errors better. - - Remove a useless log message in chat(). - - When retrying to connect, also log the maximum number of connection - attempts. - - Rephrase a log message in compile_dynamic_pcrs_job_list(). - Divide the error code and its meaning with a colon. Call the pcrs - job dynamic and not the filter. Filters may contain dynamic and - non-dynamic pcrs jobs at the same time. Only mention the name of - the filter or tagger, but don't claim it's a filter when it could - be a tagger. - - In a fatal error message in load_one_actions_file(), cover both - URL and TAG patterns. - - In pcrs_strerror(), properly report unknown positive error code - values as such. Previously they were handled like 0 (no error). - - In compile_dynamic_pcrs_job_list(), also log the actual error code as - pcrs_strerror() doesn't handle all errors reported by pcre. - - Don't bother trying to continue chatting if the client didn't ask for it. - Reduces log noise a bit. - - Make two fatal error message in load_one_actions_file() more descriptive. - - In cgi_send_user_manual(), log when rejecting a file name due to '/' or '..'. - - In load_file(), log a message if opening a file failed. - The CGI error message alone isn't too helpful. - - In connection_destination_matches(), improve two log messages - to help understand why the destinations don't match. - - Rephrase a log message in serve(). Client request arrival - should be differentiated from closed client connections now. - - In serve(), log if a client connection isn't reused due to a - configuration file change. - - Let mark_server_socket_tainted() always mark the server socket tainted, - just don't talk about it in cases where it has no effect. It doesn't change - Privoxy's behaviour, but makes understanding the log file easier. - -- configure: - - Added a --disable-ipv6-support switch for platforms where support - is detected but doesn't actually work. - - Do not check for the existence of strerror() and memmove() twice - - Remove a useless test for setpgrp(2). Privoxy doesn't need it and - it can cause problems when cross-compiling. - - Rename the --disable-acl-files switch to --disable-acl-support. - Since about 2001, ACL directives are specified in the standard - config file. - - Update the URL of the 'Removing outdated PCRE version after the - next stable release' posting. The old URL stopped working after - one of SF's recent site "optimizations". Reported by Han Liu. - -- Privoxy-Regression-Test: - - Added --shuffle-tests option to increase the chances of detection race conditions. - - Added a --local-test-file option that allows to use Privoxy-Regression-Test without Privoxy. - - Added tests for missing socks4 and socks4a forwarders. - - The --privoxy-address option now works with IPv6 addresses containing brackets, too. - - Perform limited sanity checks for parameters that are supposed to have numerical values. - - Added a --sleep-time option to specify a number of seconds to - sleep between tests, defaults to 0. - - Disable the range-requests tagger for tests that break if it's enabled. - - Log messages use the ISO 8601 date format %Y-%m-%d. - - Fix spelling in two error messages. - - In the --help output, include a list of supported tests and their default levels. - - Adjust the tests to properly deal with FEATURE_TOGGLE being disabled. - -- Privoxy-Log-Parser: - - Perform limited sanity checks for command line parameters that - are supposed to have numerical values. - - Implement a --unbreak-lines-only option to try to revert MUA breakage. - - Accept and highlight: Added header: Content-Encoding: deflate - - Accept and highlight: Compressed content from 29258 to 8630 bytes. - - Accept and highlight: Client request arrived in time on socket 21. - - Highlight: Didn't receive data in time: a.fsdn.com:443 - - Accept log messages with ISO 8601 time stamps, too. - -- uagen: - - Bump generated Firefox version to 8.0. - - Only randomize the release date if the new --randomize-release-date - option is enabled. Firefox versions after 4 use a fixed date string - without meaning. - -*** Version 3.0.17 Stable *** - -- Fixed last-chunk-detection for responses where the body was small - enough to be read with the headers, causing Privoxy to wait for the - end of the content until the server closed the connection or the - request timed out. Reported by "Karsten" in #3028326. -- Responses with status code 204 weren't properly detected as body-less - like RFC2616 mandates. Like the previous bug, this caused Privoxy to - wait for the end of the content until the server closed the connection - or the request timed out. Fixes #3022042 and #3025553, reported by a - user with no visible name. Most likely also fixes a bunch of other - AJAX-related problem reports that got closed in the past due to - insufficient information and lack of feedback. -- Fixed an ACL bug that made it impossible to build a blacklist. - Usually the ACL directives are used in a whitelist, which worked - as expected, but blacklisting is still useful for public proxies - where one only needs to deny known abusers access. -- Added LOG_LEVEL_RECEIVED to log the not-yet-parsed data read from the - network. This should make debugging various parsing issues a lot easier. -- The IPv6 code is enabled by default on Windows versions that support it. - Patch submitted by oCameLo in #2942729. -- In mingw32 versions, the user.filter file is reachable through the - GUI, just like default.filter is. Feature request 3040263. -- Added the configure option --enable-large-file-support to set a few - defines that are required by platforms like GNU/Linux to support files - larger then 2GB. Mainly interesting for users without proper logfile - management. -- Logging with "debug 16" no longer stops at the first nul byte which is - pretty useless. Non-printable characters are replaced with their hex value - so the result can't span multiple lines making parsing them harder then - necessary. -- Privoxy logs when reading an action, filter or trust file. -- Fixed incorrect regression test markup which caused a test in - 3.0.16 to fail while Privoxy itself was working correctly. - While Privoxy accepts hide-referer, too, the action name is actually - hide-referrer which is also the name used one the final results page, - where the test expected the alias. - -- CGI interface improvements: - - In finish_http_response(), continue to add the 'Connection: close' - header if the client connection will not be kept alive. - Anonymously pointed out in #2987454. - - Apostrophes in block messages no longer cause parse errors - when the blocked page is viewed with JavaScript enabled. - Reported by dg1727 in #3062296. - - Fix a bunch of anchors that used underscores instead of dashes. - - Allow to keep the client connection alive after crunching the previous request. - Already opened server connections can be kept alive, too. - - In cgi_show_url_info(), don't forget to prefix URLs that only contain - http:// or https:// in the path. Fixes #2975765 reported by Adam Piggott. - - Show the 404 CGI page if cgi_send_user_manual() is called while - local user manual delivery is disabled. - -- Action file improvements: - - Enable user.filter by default. Suggested by David White in #3001830. - - Block .sitestat.com/. Reported by johnd16 in #3002725. - - Block .atemda.com/. Reported by johnd16 in #3002723. - - Block js.adlink.net/. Reported by johnd16 in #3002720. - - Block .analytics.yahoo.com/. Reported by johnd16 in #3002713. - - Block sb.scorecardresearch.com, too. Reported by dg1727 in #2992652. - - Fix problems noticed on Yahoo mail and news pages. - - Remove the too broad yahoo section, only keeping the - fast-redirects exception as discussed on ijbswa-devel@. - - Don't block adesklets.sourceforge.net. Reported in #2974204. - - Block chartbeat ping tracking. Reported in #2975895. - - Tag CSS and image requests with cautious and medium settings, too. - - Don't handle view.atdmt.com as image. It's used for click-throughs - so users should be able to "go there anyway". - Reported by Adam Piggott in #2975927. - - Also let the refresh-tags filter remove invalid refresh tags where - the 'url=' part is missing. Anonymously reported in #2986382. - While at it, update the description to mention the fact that only - refresh tags with refresh times above 9 seconds are covered. - - javascript needs to be blocked with +handle-as-empty-document to - work around Firefox bug 492459. So move .js blockers from - +block{Might be a web-bug.} -handle-as-empty-document to - +block{Might be a web-bug.} +handle-as-empty-document. - - ijbswa-Feature Requests-3006719 - Block 160x578 Banners. - - Block another omniture tracking domain. - - Added a range-requests tagger. - - Added two sections to get Flickr's Ajax interface working with - default pre-settings. If you change the configuration to block - cookies by default, you'll need additional exceptions. - Reported by Mathias Homann in #3101419 and by Patrick on ijbswa-users@. - -- Documentation improvements: - - Explicitly mention how to match all URLs. - - Consistently recommend socks5 in the Tor FAQ entry and mention - its advantage compared to socks4a. Reported by David in #2960129. - - Slightly improve the explanation of why filtering may appear - slower than it is. - - Grammar fixes for the ACL section. - - Fixed a link to the 'intercepting' entry and add another one. - - Rename the 'Other' section to 'Mailing Lists' and reword it - to make it clear that nobody is forced to use the trackers - - Note that 'anonymously' posting on the trackers may not always - be possible. - - Suggest to enable debug 32768 when suspecting parsing problems. - -- Privoxy-Log-Parser improvements: - - Gather statistics for ressources, methods, and HTTP versions - used by the client. - - Also gather statistics for blocked and redirected requests. - - Provide the percentage of keep-alive offers the client accepted. - - Add a --url-statistics-threshold option. - - Add a --host-statistics-threshold option to also gather - statistics about how many request where made per host. - - Fix a bug in handle_loglevel_header() where a 'scan: ' got lost. - - Add a --shorten-thread-ids option to replace the thread id with - a decimal number. - - Accept and ignore: Looks like we got the last chunk together - with the server headers. We better stop reading. - - Accept and ignore: Continue hack in da house. - - Accept and higlight: Rejecting connection from 10.0.0.2. - Maximum number of connections reached. - - Accept and highlight: Loading actions file: /usr/local/etc/privoxy/default.action - - Accept and highlight: Loading filter file: /usr/local/etc/privoxy/default.filter - - Accept and highlight: Killed all-caps Host header line: HOST: bestproxydb.com - - Accept and highlight: Reducing expected bytes to 0. Marking - the server socket tainted after throwing 4 bytes away. - - Accept: Merged multiple header lines to: 'X-FORWARDED-PROTO: http X-HOST: 127.0.0.1' - -- Code cleanups: - - Remove the next member from the client_state struct. Only the main - thread needs access to all client states so give it its own struct. - - Garbage-collect request_contains_null_bytes(). - - Ditch redundant code in unload_configfile(). - - Ditch LogGetURLUnderCursor() which doesn't seem to be used anywhere. - - In write_socket(), remove the write-only variable write_len in - an ifdef __OS2__ block. Spotted by cppcheck. - - In connect_to(), don't declare the variable 'flags' on OS/2 where - it isn't used. Spotted by cppcheck. - - Limit the scope of various variables. Spotted by cppcheck. - - In add_to_iob(), turn an interestingly looking for loop into a - boring while loop. - - Code cleanup in preparation for external filters. - - In listen_loop(), mention the socket on which we accepted the - connection, not just the source IP address. - - In write_socket(), also log the socket we're writing to. - - In log_error(), assert that escaped characters get logged - completely or not at all. - - In log_error(), assert that ival and sval have reasonable values. - There's no reason not to abort() if they don't. - - Remove an incorrect cgi_error_unknown() call in a - cannot-happen-situation in send_crunch_response(). - - Clean up white-space in http_response definition and - move the crunch_reason to the beginning. - - Turn http_response.reason into an enum and rename it - to http_response.crunch_reason. - - Silence a 'gcc (Debian 4.3.2-1.1) 4.3.2' warning on i686 GNU/Linux. - - Fix white-space in a log message in remove_chunked_transfer_coding(). - While at it, add a note that the message doesn't seem to - be entirely correct and should be improved later on. - -- GNUmakefile improvements: - - Use $(SSH) instead of ssh, so one only needs to specify a username once. - - Removed references to the action feedback thingy that hasn't been - working for years. - - Consistently use shell.sourceforge.net instead of shell.sf.net so - one doesn't need to check server fingerprints twice. - - Removed GNUisms in the webserver and webactions targets so they - work with standard tar. - -*** Version 3.0.16 Stable *** - -- Added the config file option handle-as-empty-doc-returns-ok to - work around Firefox bug #492459, which causes Firefox to hang - if JavaScripts are blocked in certain situations. The option is - enabled in the default config file. -- Added the config file option default-server-timeout to control the - assumed default server timeout. Since Privoxy no longer returns - an error message for connection resets on reused client connections, - assuming larger server timeout values appears to actually work - pretty well as long as connections aren't shared. -- Added optional support for FreeBSD's accf_http(9). Use the - configure option --enable-accept-filter to enable it. -- Added fancier Privoxy icons for win32. Contributed by Jeff H. -- In daemon mode, fd 0, 1 and 2 are bound to /dev/null. -- Resolve localhost using whatever address family the operating - system feels like. Previous betas would try to use IPv4 as this - is what most users expect, but this didn't work reliably on - GNU/Linux systems. -- In the action lists on CGI pages, actions and their parameters are - no longer separated with a space. The action file parser doesn't - actually allow this and will throw an invalid syntax error if actions - and parameters in the action files are separated. Not adding the - spaces means copy and pasting CGI output into the action files works. -- The default keep-alive timeout has been reduced to 5 seconds to work - around hangs in clients that treat the proxy like any other host and - stop allowing any new connections if the "maximum number of - connections per host" is reached. -- Several webbug URLs that look like they are leading to images are now - blocked as image instead of empty documents. Doing the latter causes - WebKit-based clients to show a "missing image" icon which may mess up - the layout. -- The no-such-domain template is used for DNS resolution - problems with FEATURE_IPV6_SUPPORT enabled. Previously the - connect-failed template was used. Reported by 'zebul666'. -- Accepts quoted expiration dates even though RFC 2109 10.1.2 - doesn't seem to allow them. Reported anonymously. -- Don't try to forget connections if connection sharing is disabled. - This wasn't a real problem but caused an unnecessary log message. -- The still undocumented --enable-extended-host-patterns configure - option has a better description. -- Fixed an error message that would claim a write to the server - failed when actually writing to the client failed. -- Log the crunch reason before trying to write to the client. - The log is easier to read that way. -- Several log messages about client connections also mention - the socket number. -- handle-as-empty-document no longer depends on the image blocking - code being enabled. -- Privoxy-Log-Parser is roughly 40% faster in highlighting mode. -- uagen, a Firefox User-Agent generator for Privoxy and Mozilla - browsers has been imported and is available in the tarball's - tools directory. -- The scripts in the tools directory treat unknown parameters - as fatal errors. - -*** Version 3.0.15 Beta *** - -- In case of missing server data, no error message is send to the - client if the request arrived on a reused connection. The client - is then supposed to silently retry the request without bothering - the user. This should significantly reduce the frequency of the - "No server or forwarder data received" error message many users - reported. -- More reliable detection of prematurely closed client sockets - with keep-alive enabled. -- FEATURE_CONNECTION_KEEP_ALIVE is decoupled from - FEATURE_CONNECTION_SHARING and now available on - all platforms. -- Improved handling of POST requests on reused connections. - Should fix problems with stalled connections after submitting - form data with some browser configurations. -- Fixed various latency calculation issues. -- Allows the client to pass NTLM authentication requests to a - forwarding proxy. This was already assumed and hinted to work - in 3.0.13 beta but actually didn't. Now it's confirmed to work - with IE, Firefox and Chrome. - Thanks to Francois Botha and Wan-Teh Chang -- Fixed a calculation problem if receiving the server headers - takes more than two reads, that could cause Privoxy to terminate - the connection prematurely. Reported by Oliver. -- Compiles again on platforms such as OpenBSD and systems - using earlier glibc version that don't support AI_ADDRCONFIG. - Anonymously submitted in #2872591. -- A bunch of MS VC project files and Suse and Redhat RPM spec - files have been removed as they were no longer maintained for - quite some time. -- Overly long action lines are properly rejected with a proper - error message. Previously they would be either rejected as - invalid or cause a core dump through abort(). -- Already timed-out connections are no longer temporarily remembered. - They weren't reused anyway, but wasted a socket slot. -- len refers to the number of bytes actually read which might - differ from the ones received. Adjust log messages accordingly. -- The optional JavaScript on the CGI page uses encodeURIComponent() - instead of escape() which doesn't encode all characters that matter. - Anonymously reported in #2832722. -- Fix gcc45 warnings in decompress_iob(). -- Various log message improvements. -- Privoxy-Regression-Test supports redirect tests. -- Privoxy-Log-Parser can gather some connection statistics. - -*** Version 3.0.14 Beta *** - -- The latency is taken into account when evaluating whether or not to - reuse a connection. This should significantly reduce the number of - connections problems several users reported. -- If the server doesn't specify how long the connection stays alive, - Privoxy errs on the safe side of caution and assumes it's only a second. -- The error pages for connection timeouts or missing server data use a - Last-Modified date in the past. Retry attempts are detected and Privoxy - removes the If-Modified-Since header to prevent the server from responding - with status code 304 in which case the client would reuse the error message. -- Setting keep-alive-timeout to 0 disables keep-alive support. Previously - Privoxy would claim to allow persistence but not reuse the connection. -- Pipelined requests are less likely to be mistaken for the request - body of the previous request. Note that Privoxy still has no real - pipeline support and will either serialize pipelined requests or - drop them in which case the client has to resent them. -- Fixed a crash on some Windows versions when header randomization - is enabled and the date couldn't be parsed. -- Privoxy's keep-alive timeout for the current connection is reduced - to the one specified in the client's Keep-Alive header. -- For HTTP/1.1 requests, Privoxy implies keep-alive support by not - setting any Connection header instead of using 'Connection: keep-alive'. -- If the socket isn't reusable, Privoxy doesn't temporarily waste - a socket slot to remember the connection. -- If keep-alive support is disabled but compiled in, the client's - Keep-Alive header is removed. -- Fixed a bug on mingw32 where downloading large files failed if - keep-alive support was enabled. -- Fixed a bug that (at least theoretically) could cause log - timestamps to be occasionally off by about a second. -- No Proxy-Connection header if added if there already is one. -- The configure script respects the $PATH variable when searching - for groups and id. - -*** Version 3.0.13 Beta *** - -- Added IPv6 support. Thanks to Petr Pisar who not only provided - the initial patch but also helped a lot with the integration. -- Added client-side keep-alive support. -- The connection sharing code is only used if the connection-sharing - option is enabled. -- The max-client-connections option has been added to restrict - the number of client connections below a value enforced by - the operating system. -- Fixed a regression reintroduced in 3.0.12 that could cause - crashes on mingw32 if header date randomization was enabled. -- Compressed content with extra fields couldn't be decompressed - and would get passed to the client unfiltered. This problem - has only be detected through statical analysis with clang as - nobody seems to be using extra fields anyway. -- If the server resets the Connection after sending only the headers - Privoxy forwards what it got to the client. Previously Privoxy - would deliver an error message instead. -- Error messages in case of connection timeouts use the right - HTTP status code. -- If spawning a child to handle a request fails, the client - gets an error message and Privoxy continues to listen for - new requests right away. -- The error messages in case of server-connection timeouts or - prematurely closed server connections are now template-based. -- If zlib support isn't compiled in, Privoxy no longer tries to - filter compressed content unless explicitly asked to do so. -- In case of connections that are denied based on ACL directives, - the memory used for the client IP is no longer leaked. -- Fixed another small memory leak if the client request times out - while waiting for client headers other than the request line. -- The client socket is kept open until the server socket has - been marked as unused. This should increase the chances that - the still-open connection will be reused for the client's next - request to the same destination. Note that this only matters - if connection-sharing is enabled. -- A TODO list has been added to the source tarball to give potential - volunteers a better idea of what the current goals are. Donations - are still welcome too: http://www.privoxy.org/faq/general.html#DONATE - -*** Version 3.0.12 *** +*** Version 3.0.12 (UNRELEASED) ***
- The socket-timeout option now also works on platforms whose select() implementation modifies the timeout structure. @@ -742,7 +36,7 @@ ChangeLog for Privoxy skip reason.
*** Version 3.0.11 *** - + - On most platforms, outgoing connections can be kept alive and reused if the server supports it. Whether or not this improves things depends on the connection. @@ -957,7 +251,7 @@ ChangeLog for Privoxy forbidden characters like dots. - New trust entries are saved with a comment that contains the trusted referring URL (Suggested by Daniel Griscom). -- Filter descriptions are HTML encoded automatically. +- Filter descriptions are HTML encoded automatically. - New config option "split-large-forms" to work around a browser bug that caused IE6 and IE7 to ignore the Submit button on the edit-actions-for-url CGI page. @@ -996,11 +290,11 @@ ChangeLog for Privoxy Privoxy detection "attack". Note that detecting Privoxy is still possible through other ways and Privoxy was never intended to be invisible anyway. -- Added support for AmigaOS 4, fixed build for AmigaOS 3.x. +- Added support for AmigaOS 4, fixed build for AmigaOS 3.x. - The show-url-info CGI page displays a warning if Privoxy is currently toggled off. - The show-status CGI page suppresses the edit button - for action files if Privoxy has no write access. + for action files if Privoxy has no write access. - Most CGI error pages react properly to HEAD requests. - Requests with RFC 3253 HTTP methods (used by Subversion) are accepted. (Patch provided by Petr Kadlec) @@ -1075,18 +369,18 @@ ChangeLog for Privoxy - Improved the filters img-reorder, js-annoyances, webbugs, banners-by-size, banners-by-link and ie-exploits to make them less likely to break anything. -- Removed outdated URL patterns in default.action and added new ones. +- Removed outdated URL patterns in default.action and added new ones. - Added redirection from http://p.p/user-manual to http://p.p/user-manual/ - Changed webinterface default values for hide-user-agent, hide-referrer and set-image-blocker. - + *** Version 3.0.5 Beta ***
- Windows version can be installed/started as a service. - Windows icon stays blue when Privoxy is idle, green when busy. - Integrated Fabian Keil's extensive patch. See: - http://www.fabiankeil.de/sourcecode/privoxy/. Includes the - following new or significantly improved actions (among many + http://www.fabiankeil.de/sourcecode/privoxy/. Includes the + following new or significantly improved actions (among many other improvements):
content-type-overwrite{} @@ -1114,17 +408,17 @@ ChangeLog for Privoxy - Added jpeg filtering to defend against MS jpeg vulnerability MS04-028 with the new inspect-jpegs action. - Removed the "arbitrary" 1000 filter limit - addresses tracker #911950 -- Thanks to Jindrich Makovicka for a race condition fix for the log +- Thanks to Jindrich Makovicka for a race condition fix for the log file. The race condition remains for non-pthread implementations. Reference patch #1175720. Various other logging enhancements. - A pile of assorted bug fixes, memory leaks, enhancements, etc. - Moved Actions file reporting mechanism to SF tracker. -- Two new options for config: enable-remote-http-toggle and +- Two new options for config: enable-remote-http-toggle and forwarded-connect-retries. - Trap unsupported FTP requests. - Let text/xml be filtered. - Numerous updates to default.action -- Increase the compiled in limit of trusted referrers from 64 to 512 +- Increase the compiled in limit of trusted referrers from 64 to 512 (for trustfile users).
*** Version 3.0.3 *** @@ -1141,15 +435,15 @@ ChangeLog for Privoxy - Workarounds for client (iTunes etc) and server (PHP < 4.2.3) bugs including the notorious "blank page" problem. - Various filter improvements; most notably the unsolicited-popups - filter became less destructive + filter became less destructive - Major revamp of the actions file - + *** Version 3.0.2 ***
- Fixed two memory leaks, one serious - Fixed bug in pcrs which could cause crashes with user-defined filters - Fixed bug in domain name matching -- Assorted small fixes (Win32 menu, CGI URL editor, ..) +- Assorted small fixes (Win32 menu, CGI URL editor, ..) - Added basic support for the OPTIONS and TRACE http methods - Added workaround for Bug in Mac OSX that made Privoxy crash occasionally - Refined the default action file through >400 items of user feedback @@ -1160,7 +454,7 @@ ChangeLog for Privoxy - Replaced filter "popups" by choice between two modes: - "unsolicited-popups" tries to catch only the unsolicited ones - "all-popups" tries to kill them all (as before) - - New filter "tiny-textforms" Help those tiny or hard-wrap textareas. + - New filter "tiny-textforms" Help those tiny or hard-wrap textareas. - New filter "jumping-windows" that prevents windows from resizing and moving themselves - New filter "demoronizer" which fixes MS's abuse of std charsets @@ -1184,7 +478,7 @@ ChangeLog for Privoxy - Added quicktime-kioskmode filter and improved frameset-borders - Updated default.action based on latest feedback - New PDF doc build process -- Add a user contrib module to cvs: +- Add a user contrib module to cvs: http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/ijbswa/contrib/
*** Version 2.9.18 *** @@ -1194,7 +488,7 @@ ChangeLog for Privoxy - Three filters fixed (again!) - Assorted small fixes and doc enhancements
-*** Version 2.9.16 *** +*** Version 2.9.16 ***
- Major revamp of default.action to get rid of years of cruft. - Same for default.filter @@ -1206,11 +500,11 @@ ChangeLog for Privoxy - user-manual directive added to config for help links from within CGI editor. - Multiple actions files can now be specified in config. -- Actions files are changed to: default.action, standard.action, and +- Actions files are changed to: default.action, standard.action, and user.action. user.action is for personal/local configuration. - The usual many small and miscellaneous bug and security fixes.
-*** Version 2.9.14 Beta *** +*** Version 2.9.14 Beta ***
- Fix Solaris compile problem (gateway.h and filters.h) - Makefile fixes for Solaris, FreeBSD (?) @@ -1224,30 +518,30 @@ ChangeLog for Privoxy - #include mechansim for common text in templates - Various other minor fixes.
-*** Version 2.9.13 Beta *** +*** Version 2.9.13 Beta ***
-- *NEWS*: The project has been renamed to Privoxy! The new name is +- *NEWS*: The project has been renamed to Privoxy! The new name is reflected throughout (file locations, etc). -- ijb.action is now default.action. re_filterfile is now +- ijb.action is now default.action. re_filterfile is now default.filter. - http://i.j.b/ is now http://p.p/ -- The 'logo' option for replacing ad iamges is removed now. 'Pattern' +- The 'logo' option for replacing ad iamges is removed now. 'Pattern' (checkerboard) is now the default. - RPM spec file make over.
-*** Version 2.9.12 Beta *** +*** Version 2.9.12 Beta ***
-- **READ**: The default listening PORT is NOW 8118!!! Changed from - 8000 due to conflict with NAS (Network Audio Server, whatever that +- **READ**: The default listening PORT is NOW 8118!!! Changed from + 8000 due to conflict with NAS (Network Audio Server, whatever that is.) - More CGI actions editor fixes and improvements. - Win32 command line fix ups. -- re_filterfile now has modular sections that can be activated on a +- re_filterfile now has modular sections that can be activated on a per site basis. Some new goodies there too. - +filter now takes arguments to match FILTER sections in re_filterfile - for even more flexibility. -- Added a new image blocker option: +image-blocker{pattern}, which + for even more flexibility. +- Added a new image blocker option: +image-blocker{pattern}, which displays a checkerboard patthern and scales better than the logo. - PNG images will be used in place of GIF for JB built-in images if configured with --enable-no-gif. @@ -1260,14 +554,14 @@ ChangeLog for Privoxy - CGI Editor works on OS/2 now. - Fix restart failure where sockets were in TIME_WAIT. - Fixes for actions cgi editor, make sure we have right file. -- A --pidfile command line option now, in addition to --help, +- A --pidfile command line option now, in addition to --help, --version, --no-daemon, --user and configfile. --no-daemon replaces - the former -d option and _DEBUG define. --user will drop privileges + the former -d option and _DEBUG define. --user will drop privileges to the specified user. - Signal handling cleanups (*nix). - CGI actions editor improvements and fixes. - Error handling improvements, especially out of memory. -- Default re_filterfile fix that caused spurious IJB logos +- Default re_filterfile fix that caused spurious IJB logos (instead of 'blank'). - configure.in threading fixes for Solaris. - Various other minor fixes. @@ -1275,14 +569,14 @@ ChangeLog for Privoxy
*** Version 2.9.11 Beta Changes ***
-- Add "session" cookie concept where cookies exist for the life - of that browser session only (ie never goes to disk). +- Add "session" cookie concept where cookies exist for the life +of that browser session only (ie never goes to disk). - Checks for correct header length. - Fix user:pass@host.domain.com auth bug. - Better signal handling on *nix. - Fix CFLAGS hard-coded in configure.in -- Fix threading bug re: gethostbyname() that caused random - URLs to fail in some cases. +- Fix threading bug re: gethostbyname() that caused random +URLs to fail in some cases.
*** Version 2.9.11 Alpha Changes *** @@ -1322,7 +616,7 @@ The only other URLs left are the GNU GPL: and the home page: http://ijbswa.sourceforge.net/ ... and various URLs which will be intercepted by Junkbuster anyway. -TODO: Still need to do something with the URLs in Junkbuster Corp's +TODO: Still need to do something with the URLs in Junkbuster Corp's copyright/trademark notice on the bottom of the show-proxy-args page. - PCRE or GNU Regex is now a #define option.
@@ -1346,7 +640,7 @@ parsers.c (again). They obviously got lost in our current patch war ;-) - Cut the credit for the §-referrer-option from the config file, that Stefan had placed there. -- Improved the re_filterfile +- Improved the re_filterfile
*** Version 2.9.0 pre-Alpha Changes *** @@ -1354,9 +648,9 @@ that Stefan had placed there. - Now use PCRE, not GNU REGEX. I have not yet had chance to check the syntax of the block/image/cookie file to ensure that they match what is expected - however they seem to work. -- Replaced "configure" script with one generated by "autoconf". Also -use a header "config.h" (was ijbconfig.h in my previous release) for -the #defines. "config.h" is now generated with "autoheader" from +- Replaced "configure" script with one generated by "autoconf". Also +use a header "config.h" (was ijbconfig.h in my previous release) for +the #defines. "config.h" is now generated with "autoheader" from "acconfig.h" and "configure.in". (Note that to install you do not need autoconf or autoheader - just run "./configure".) To see command-line options, run "./configure --help". @@ -1369,7 +663,7 @@ apply all of these, since I had already independently done conditional popup file, conditional image file, and integration of popup code. - ACL, Jar and trust files conditionally compiled. - New source file headers. -- Various cosmetic changes. (But I have not consistently ordered the +- Various cosmetic changes. (But I have not consistently ordered the config files - I think that's worthwhile, but it's 1am and I want to get this released!) - RCS tags on .h files. @@ -1395,15 +689,16 @@ being a mix of "U.S. English", "U.K. English" and "Irish English". - Version number changes to 2.9.0
+ ---------------------------------------------------------------------- -Copyright : Written by and Copyright (C) 2001-2010 the +Copyright : Written by and Copyright (C) 2001-2008 the SourceForge Privoxy team. http://www.privoxy.org/
Based on the Internet Junkbuster originally written - by and Copyright (C) 1997 Anonymous Coders and + by and Copyright (C) 1997 Anonymous Coders and Junkbusters Corporation. http://www.junkbusters.com/
- This program is free software; you can redistribute it + This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at diff --git a/external/privoxy/GNUmakefile.in b/external/privoxy/GNUmakefile.in index 08c949a..481633c 100644 --- a/external/privoxy/GNUmakefile.in +++ b/external/privoxy/GNUmakefile.in @@ -1,15 +1,15 @@ # Note: Makefile is built automatically from Makefile.in # -# $Id: GNUmakefile.in,v 1.205 2011/11/20 17:17:56 fabiankeil Exp $ +# $Id: GNUmakefile.in,v 1.180 2009/02/28 08:28:14 fabiankeil Exp $ # -# Written by and Copyright (C) 2001-2011 members of the +# Written by and Copyright (C) 2001 - 2008 the SourceForge # Privoxy team. http://www.privoxy.org/ # # Based on the Internet Junkbuster originally written -# by and Copyright (C) 1997 Anonymous Coders and +# by and Copyright (C) 1997 Anonymous Coders and # Junkbusters Corporation. http://www.junkbusters.com # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -42,7 +42,9 @@ VERSION_MINOR = @VERSION_MINOR@ VERSION_POINT = @VERSION_POINT@ CODE_STATUS = @CODE_STATUS@ VERSION = $(VERSION_MAJOR).$(VERSION_MINOR).$(VERSION_POINT) -SNAPVERSION = $(VERSION)-$(shell date "+%Y%m%d") +RPM_VERSION = $(VERSION) +RPM_PACKAGEV = "" +SNAPVERSION = $(RPM_VERSION)-$(shell date "+%Y%m%d")
############################################################################# @@ -60,22 +62,21 @@ CONF_BASE = @sysconfdir@ SBIN_DEST = @sbindir@ MAN_DIR = @mandir@ MAN_DEST = $(MAN_DIR)/man1 -MAN_PAGE = privoxy.1 SHARE_DEST = @datadir@ DOC_DEST = $(SHARE_DEST)/doc/privoxy VAR_DEST = @localstatedir@ LOGS_DEST = $(VAR_DEST)/log/privoxy PIDS_DEST = $(VAR_DEST)/run
-# if $prefix = /usr/local then the default CONFDEST change from -# CONF_DEST = $(CONF_BASE) to CONF_DEST = $(CONF_BASE)/privoxy +# if $prefix = /usr/local then the default CONFDEST change from +# CONF_DEST = $(CONF_BASE) to CONF_DEST = $(CONF_BASE)/privoxy # by the target rule CONF_DEST # # also if the $prefix is /usr/local and there is no # $(SHARE_DEST)/doc, it checks for $prefix/doc and installs there # instead in this situation # -# finally if $prefix=/usr/local and VAR_DEST=$prefix/var it +# finally if $prefix=/usr/local and VAR_DEST=$prefix/var it # changes this to /var for storing the logs and pidfile
# used in source dir only, the install goes to $share_dest/doc/privoxy @@ -91,13 +92,13 @@ RA_MODE = 0664 DIR_MODE = 0755 # Files daemon writes to. RWD_MODE = 0660 -INSTALL_P = -m $(BIN_MODE) +INSTALL_P = -m $(BIN_MODE) INSTALL_T = -m $(RA_MODE) INSTALL_D = -m $(DIR_MODE) -d INSTALL_R = -m $(RWD_MODE)
# install options for superuser install -#INSTALL_S = -g @GROUP@ -o @USER@ +#INSTALL_S = -g @GROUP@ -o @USER@
############################################################################# # Build tools @@ -121,6 +122,8 @@ STRIP_PROG = strip SED = sed GREP = grep CAT = cat +RPM = rpm +RPMBUILD = rpmbuild MV = mv TAR = tar LN = ln @@ -142,7 +145,6 @@ PERL = perl DOC_DIR = doc/source DOC_TMP = $(DOC_DIR)/tmp DOC_STATUS = @DOC_STATUS@ -TIDY = tidy -modify -indent -clean -wrap 78
# Program to do LF->CRLF # @@ -154,16 +156,13 @@ TIDY = tidy -modify -indent -clean -wrap 78 DOSFILTER = $(PERL) -p -e 's/\n/\r\n/' CVSROOT = :pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa #TMPDIR := $(shell mktemp -d /tmp/$(PROGRAM).XXXXXX) -# If your SF user name differs from your local one, -# change this to "ssh -l sf-username" -SSH = ssh -WWW_ROOT = /home/project-web/ijbswa
############################################################################# -# Setup for make distribution for now. +# Setup for make distribution rh and suse for now #############################################################################
-TAR_ARCH = /tmp/privoxy-$(VERSION).tar.gz +TAR_ARCH = /tmp/privoxy-$(RPM_VERSION).tar.gz +RPM_BASE = @RPM_BASE@
############################################################################# # We include these files in our distributions @@ -178,7 +177,7 @@ CONFIG_FILES = $(CONFIGS) \ DOC_FILES = AUTHORS LICENSE README ChangeLog INSTALL \ `find doc/webserver/ -name "*.html" | grep -v "(webserver|team)/index.html"` \ `find doc/webserver/ -name "*.css"` \ - $(MAN_PAGE) + privoxy.1
############################################################################# # Filenames and libraries @@ -240,11 +239,11 @@ LIBS = @LIBS@ $(W32_LIB) $(SOCKET_LIB) $(PTHREAD_LIB) # possibly other OSs). SPECIAL_CFLAGS = @SPECIAL_CFLAGS@
-# Add your flags here -OTHER_CFLAGS = +# Add your flags here +OTHER_CFLAGS =
CFLAGS = @CFLAGS@ @CPPFLAGS@ $(OTHER_CFLAGS) $(SPECIAL_CFLAGS) -Wall \ - @STATIC_PCRE_ONLY@ -Ipcre + @STATIC_PCRE_ONLY@ -Ipcre
LDFLAGS = @LDFLAGS@ $(DEBUG_CFLAGS) $(SPECIAL_CFLAGS)
@@ -260,9 +259,9 @@ all: $(PROGRAM) default.action ############################################################################# # Phony targets ############################################################################# -.PHONY: all inifiles solaris-dist \ -win-dist tarball-dist dok webserver clean clobber tags \ -install CONF_DEST LOG_DEST \ +.PHONY: all inifiles redhat-dist redhat-upload solaris-dist suse-dist \ +suse-upload win-dist tarball-dist dok redhat-dok webserver clean clobber tags \ +install conectiva-spec conectiva-dist conectiva-upload CONF_DEST LOG_DEST \ PID_DEST check_doc install-strip uninstall GROUP_T
############################################################################# @@ -276,7 +275,8 @@ PID_DEST check_doc install-strip uninstall GROUP_T # Strip master copy comments from default.action: ############################################################################# default.action: default.action.master - $(GREP) -v '^#MASTER#' default.action.master > $@ + $(GREP) -v '^#MASTER#' $< > $@ + ############################################################################# # Win32 config files ############################################################################# @@ -295,7 +295,7 @@ config.txt: config $(DOSFILTER) <default.filter >default.filter.txt && mv default.filter.txt default.filter
trust.txt: trust - $(DOSFILTER) < $< > $@ + $(DOSFILTER) < $< > $@
############################################################################# # Pre-dist check: @@ -323,12 +323,12 @@ dist-check:
############################################################################# # create tar.gz from CVS: -# This make-target is usually called through 'create-archive'. If you +# This make-target is usually called through 'create-archive'. If you # run 'make create-snapshot' without setting SNAPVERSION, you'll get a -# tar.gz with the current date in the name and as a releasenumber in the +# tar.gz with the current date in the name and as a releasenumber in the # spec-file. But the main usage is to run it as follows (Red Hat example): # make SNAPVERSION=1.6x create-snapshot -# This creates a tar.gz. +# This creates a tar.gz and spec-file for a Red Hat 6.x version. ############################################################################# create-snapshot: @tag=`cvs -d $(CVSROOT) status Makefile | awk ' /Sticky Tag/ { print $$3 } '` 2> /dev/null; \ @@ -337,6 +337,25 @@ create-snapshot: TMPDIR=$(shell mktemp -d /tmp/$(PROGRAM).XXXXXX); \ cd $$TMPDIR ; cvs -Q -d $(CVSROOT) export -r $$tag current || echo "Um... export aborted."; \ cd $$TMPDIR/current; \ + TMPFILE=$$(mktemp -q /tmp/$(PROGRAM).XXXXXX); \ + if $(SED) -e 's/^(Version:).*/\1 $(RPM_VERSION)/g' \ + -e 's/^(Release:).*/\1 $(SNAPVERSION)/g' \ + privoxy-rh.spec > $$TMPFILE ; then \ + $(MV) -f $$TMPFILE privoxy-rh.spec; \ + else \ + $(ECHO) "Could not set version info in specfile."; \ + exit 1;\ + fi;\ + if $(SED) -e 's/^(Version:).*/\1 $(RPM_VERSION)/g' \ + -e 's/^(Release:).*/\1 $(SNAPVERSION)/g' \ + privoxy-suse.spec > $$TMPFILE ; then \ + $(MV) -f $$TMPFILE privoxy-suse.spec; \ + else \ + $(ECHO) "Could not set version info in specfile."; \ + exit 1;\ + fi; \ + $(RM) $$TMPFILE; \ + cd $$TMPDIR/current; \ $(TAR) --exclude ".cvsignore" --exclude "CVS" \ -czf /tmp/$(PROGRAM)-$(VERSION).tar.gz .; \ $(RM) -rf $$TMPDIR @@ -345,13 +364,158 @@ create-snapshot:
############################################################################# # looks at the version of Makefile and exports a corresponding source-tree -# example: if the Makefile has the sticky tag v_2_9_13, you'll get -# privoxy-*-2.4.13.tar.gz. +# example: if the Makefile has the sticky tag v_2_9_13, you'll get +# privoxy-*-2.4.13.tar.gz. Two different tar files will be written, one for +# Red Hat and one for SuSe (different spec-files) ############################################################################# create-archive: make SNAPVERSION=$(SNAPVERSION) create-snapshot
############################################################################# +# RPM specifice stuff (SuSE or Redhat, ..) +############################################################################# +rpm-stuff: dist-check clean clobber + for dir in RPMS SRPMS BUILD SOURCES SPECS; do \ + if [ ! -w $(RPM_BASE)/$$dir ]; then \ + $(ECHO) "$(RPM_BASE)/$$dir is not writable for you. Maybe try as root."; \ + $(ECHO) "Or add a suitable path to .rpmmacros like."; \ + $(ECHO) "%_topdir /home/foo/rpm-build"; \ + exit 1; \ + fi; \ + done; \ + +check-release: + @if [ "$(RPM_PACKAGEV)" = "" ]; then \ + echo ; \ + echo " ERROR: NO RPM_PACKAGEV VALUE"; \ + echo " No value given for RPM_PACKAGEV. Please use:"; \ + echo " make dist-upload RPM_PACKAGEV=release"; \ + echo " where "release" is the release number you want to and"; \ + echo " where "dist" is the name of the distro (redhat or suse)"; \ + echo ; \ + echo " Ex: make redhat-upload RPM_PACKAGEV=1"; \ + echo ""; \ + echo "ATTENTION: If your distribution use a specific tag on the"; \ + echo " release field (like "cl" for Conectiva, and"; \ + echo " "mdk" for Mandrake), DO NOT put it on the value"; \ + echo " given to RPM_PACKAGEV. It will be added automaticaly."; \ + echo " Do it like you would do for a redhat package,"; \ + echo " (i.e. just the number)."; \ + echo ; \ + exit 1; \ + fi + + +############################################################################# +# Create Conectiva specfile from RedHat specfile +############################################################################# +conectiva-spec: + $(RM) privoxy-cl.spec + chmod a+x genclspec.sh + ./genclspec.sh + +############################################################################# +# Conectiva distribution for x86 +############################################################################# +conectiva-dist: rpm-stuff conectiva-spec + + $(TAR) --exclude ".cvsignore" --exclude "CVS" --exclude "privoxy-suse.spec" --exclude "privoxy-rh.spec" --exclude "PACKAGERS" -czf $(TAR_ARCH) . + $(RPMBUILD) --clean -ta $(TAR_ARCH) + if [ -f $(TAR_ARCH) ]; then $(RM) $(TAR_ARCH); fi + +conectiva-upload: check-release + make redhat-upload RPM_PACKAGEV=$(RPM_PACKAGEV)cl + +############################################################################# +# redhat distribution alpha and x86 +############################################################################# +redhat-dist: rpm-stuff + echo $(CONFIG_FILES) + $(TAR) --exclude ".cvsignore" --exclude "CVS" --exclude "privoxy-suse.spec" --exclude "privoxy-cl.spec" --exclude "PACKAGERS" -czf $(TAR_ARCH) . + $(RPMBUILD) --clean -ta $(TAR_ARCH) + if [ -f $(TAR_ARCH) ]; then $(RM) $(TAR_ARCH); fi + +# For testing build issues only! Use redhat-dist for official releases. +redhat-test: + echo $(CONFIG_FILES) + $(TAR) --exclude ".cvsignore" --exclude "CVS" --exclude "privoxy-suse.spec" --exclude "privoxy-cl.spec" --exclude "PACKAGERS" -czf $(TAR_ARCH) . + $(RPMBUILD) --clean -tb $(TAR_ARCH) + if [ -f $(TAR_ARCH) ]; then $(RM) $(TAR_ARCH); fi + @echo "WARNING: This target is only for testing. Use redhat-dist for releases!!!" + +# anonymously ncftps the rpms to sourceforge +redhat-upload: check-release + ncftpput -u anonymous -p ijbswa-developers@lists.sourceforge.net upload.sourceforge.net /incoming $(RPM_BASE)/SRPMS/privoxy-$(RPM_VERSION)-$(RPM_PACKAGEV).src.rpm +# better should use `arch` here instead of ix86 to support other platforms too + ncftpput -u anonymous -p ijbswa-developers@lists.sourceforge.net upload.sourceforge.net /incoming $(RPM_BASE)/RPMS/*/privoxy-$(RPM_VERSION)-$(RPM_PACKAGEV).*.rpm + @$(ECHO) ------------------------------------------------------- + @$(ECHO) Now goto + @$(ECHO) https://sourceforge.net/project/admin/editpackages.php?group_id=11118 + @$(ECHO) ... and release the files. + @$(ECHO) ------------------------------------------------------- + # w3m http://sourceforge.net/project/admin/editpackages.php?group_id=11118 + + +############################################################################# +# Creates a Red Hat sourcepackage from CVS (not from the current sources +# on disk) +############################################################################# +redhat-srpm: + make create-archive + $(RPMBUILD) -ts --nodeps $(PROGRAM)-$(VERSION).tar.gz + + +############################################################################# +# suse distribution. works fine. no need to be root. +############################################################################# +suse-dist: rpm-stuff +# TMPFILE=$$(mktemp -q /tmp/$(PROGRAM).XXXXXX); \ +# if $(SED) -e 's/^(Version:).*/\1 $(RPM_VERSION)/g' \ +# -e 's/^(Release:).*/\1 $(RPM_PACKAGEV)/g' \ +# privoxy-suse.spec > $$TMPFILE ; then \ +# $(MV) -f $$TMPFILE privoxy-suse.spec; \ +# else \ +# $(ECHO) "Could not set version info in specfile."; \ +# exit 1;\ +# fi + + $(TAR) --exclude ".cvsignore" --exclude "CVS" --exclude "privoxy-rh.spec" --exclude "privoxy-cl.spec" --exclude "PACKAGERS" -czf $(TAR_ARCH) . + $(RPMBUILD) --clean -ta $(TAR_ARCH) + if [ -f $(TAR_ARCH) ]; then $(RM) $(TAR_ARCH); fi + +# anonymously ncftps the rpms to sourceforge +suse-upload: check-release + ncftpput -u anonymous -p ijbswa-developers@lists.sourceforge.net upload.sourceforge.net /incoming $(RPM_BASE)/SRPMS/privoxy-suse-$(RPM_VERSION)-$(RPM_PACKAGEV).src.rpm +# better should use `arch` here instead of ix86 to support other platforms too + ncftpput -u anonymous -p ijbswa-developers@lists.sourceforge.net upload.sourceforge.net /incoming $(RPM_BASE)/RPMS/*/privoxy-suse-$(RPM_VERSION)-$(RPM_PACKAGEV).*.rpm + @$(ECHO) ------------------------------------------------------- + @$(ECHO) Now goto + @$(ECHO) https://sourceforge.net/project/admin/editpackages.php?group_id=11118 + @$(ECHO) ... and release the files. + @$(ECHO) ------------------------------------------------------- + +# handle with care. use with root. +suse-clean: + $(RPM) -e junkbuster-suse || true + $(RM) -r /etc/junkbuster + $(RM) -r /etc/rc.d/junkbuster* + $(RM) -r /var/run/junkbuster.pid + $(RM) -r /var/log/junkbuster + $(RM) /etc/init.d/junkbuster + $(RM) /usr/sbin/junkbuster + $(RM) /usr/sbin/rcjunkbuster + $(RM) /usr/share/man/man1/junkbuster.1.gz + $(RPM) -e privoxy-suse || true + $(RM) -r /etc/privoxy + $(RM) -r /etc/rc.d/privoxy* + $(RM) -r /var/run/privoxy.pid + $(RM) -r /var/log/privoxy + $(RM) /etc/init.d/privoxy + $(RM) /usr/sbin/privoxy + $(RM) /usr/sbin/rcprivoxy + $(RM) /usr/share/man/man1/privoxy.1.gz + +############################################################################# # generic distribution ############################################################################# gen-dist: dist-check @@ -366,7 +530,7 @@ gen-dist: dist-check # add config files for foo in $(CONFIG_FILES); do \ (cd .. && $(TAR) -uvhf --exclude "PACKAGERS" privoxy-$(TARGET_OS)-$(VERSION)-$(CODE_STATUS)-src.tar privoxy-$(VERSION)-$(CODE_STATUS)/$$foo;) \ - done; + done; # add documentation for foo in $(DOC_FILES); do \ (cd .. && $(TAR) -uvhf --exclude "PACKAGERS" privoxy-$(TARGET_OS)-$(VERSION)-$(CODE_STATUS)-src.tar privoxy-$(VERSION)-$(CODE_STATUS)/$$foo;) \ @@ -390,6 +554,69 @@ gen-clean: $(RM) privoxy-$(TARGET_OS)-$(VERSION)-$(CODE_STATUS)-src.tar*
############################################################################# +# solaris distribution. verified on SF machines by swa. +############################################################################# +solaris-dist: gen-dist + @$(ECHO) Done. +# anonymously ncftps the package to sourceforge +solaris-upload: gen-upload + @$(ECHO) Done. +# use with care +solaris-clean: gen-clean + @$(ECHO) Done. + +############################################################################# +# hpux distribution +############################################################################# +hpux-dist: + @$(ECHO) coming soon. +hpux-upload: + @$(ECHO) coming soon. + +############################################################################# +# debian distribution +############################################################################# +debian-dist: + @$(ECHO) coming soon. +debian-upload: + @$(ECHO) coming soon. + +############################################################################# +# macosx distribution +############################################################################# +macosx-dist: + @$(ECHO) coming soon. +macosx-upload: + @$(ECHO) coming soon. + +############################################################################# +# amiga distribution +############################################################################# +amiga-dist: + @$(ECHO) coming soon. +amiga-upload: + @$(ECHO) coming soon. + +############################################################################# +# freebsd distribution. verified on SF machines by swa. +############################################################################# +freebsd-dist: gen-dist + @$(ECHO) Done. +# anonymously ncftps the package to sourceforge +freebsd-upload: gen-upload + @$(ECHO) Done. +# use with care +freebsd-clean: gen-clean + @$(ECHO) Done. + +############################################################################# +# Windows distribution +############################################################################# +win-dist: + $(ECHO) Not implemented. + + +############################################################################# # Tarball distribution: No CVS dirs, dotfiles, debian build dir, # (FIXME:) only parts of the static / generated docs mix in doc/webserver ############################################################################# @@ -405,7 +632,7 @@ tarball-dist: dist-check clean clobber cd .. && $(TAR) -cvhf privoxy-$(VERSION)-$(CODE_STATUS)-src.tar $$files ; \
# and zip the archive - $(RM) ../privoxy-$(VERSION)-$(CODE_STATUS) + $(RM) ../privoxy-$(VERSION)-$(CODE_STATUS) $(GZIP_PROG) ../privoxy-$(VERSION)-$(CODE_STATUS)-src.tar @$(ECHO) Tarball distribution created.
@@ -430,14 +657,14 @@ tarball-clean: #############################################################################
# developer manual -dok-devel: +dok-devel: $(RM) doc/webserver/developer-manual/*.html $(RM) -r doc/source/developer-manual mkdir -p doc/source/developer-manual cd doc/source/developer-manual && $(DB) ../developer-manual.sgml && cd .. && cp developer-manual/*.html ../webserver/developer-manual/
# user manual -dok-user: +dok-user: $(RM) doc/webserver/user-manual/*.html $(RM) -r doc/source/user-manual/ mkdir -p doc/source/user-manual @@ -448,56 +675,58 @@ dok-user: $(PERL) -pi.bak -e 's/</head/\n<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">\n</head/i' doc/webserver/user-manual/*html
# faq -dok-faq: +dok-faq: $(RM) doc/webserver/faq/*.html $(RM) -r doc/source/faq mkdir -p doc/source/faq cd doc/source/faq && $(DB) ../faq.sgml && cd .. && cp faq/*.html ../webserver/faq/
-# man page, one variation. Try to use the next target, just 'make man'. -dok-man: +# man page, one variation. Try to use the next target, just 'make man'. +dok-man: $(RM) doc/man/* doc/webserver/man-page/*.html - echo MAN2HTML is $(MAN2HTML) - @if [ $(MAN2HTML) != "false" ]; then \ - $(ECHO) "<html><head><title>Privoxy Man page</title><link rel="stylesheet" type="text/css" href="../p_web.css"></head><body><H2>NAME</H2>" > doc/webserver/man-page/privoxy-man-page.html; \ - man ./$(MAN_PAGE) | $(MAN2HTML) -bare >> doc/webserver/man-page/privoxy-man-page.html; \ - $(ECHO) "</body></html>" >> doc/webserver/man-page/privoxy-man-page.html; \ - else \ - $(MAKE) groff2html; \ - fi; +ifneq ($(MAN2HTML),false) + $(ECHO) "<html><head><title>Privoxy Man page</title><link rel="stylesheet" type="text/css" href="../p_web.css"></head><body><H2>NAME</H2>" > doc/webserver/man-page/privoxy-man-page.html + man ./privoxy.1 | $(MAN2HTML) -bare >> doc/webserver/man-page/privoxy-man-page.html + $(ECHO) "</body></html>" >> doc/webserver/man-page/privoxy-man-page.html +else + $(MAKE) groff2html +endif
# Build man page from sgml. This requires the SGMLSpm perl module. -# See CPAN, or your favorite perl repository. This is the preferred +# See CPAN, or your favorite perl repository. This is the preferred # target for man page generation! man: dok-release mkdir -p doc/source/temp && cd doc/source/temp && $(RM) * ;\ nsgmls ../privoxy-man-page.sgml | sgmlspl ../../../utils/docbook2man/docbook2man-spec.pl &&\ - perl -pi.bak -e 's/ URL:.*//; s/[ /[/g' $(MAN_PAGE) ;\ - perl -pi.bak -e "s/[ /[/g;s/á/\\['a]/g;s/é/\\['e]/g" $(MAN_PAGE); \ - perl -pi.bak -e "s/ö/\\[:o]/g" $(MAN_PAGE); \ - perl -pi.bak -e 's/([ {])-([a-z])/$$1\-$$2/g' $(MAN_PAGE); \ - perl -pi.bak -e 's/ --([a-z])/ \-\-$$1/g' $(MAN_PAGE); \ - perl -pi.bak -e 's/\fB--/\fB\-\-/g' $(MAN_PAGE); \ - $(DB) ../privoxy-man-page.sgml && $(MV) -f $(MAN_PAGE) ../../../$(MAN_PAGE) + perl -pi.bak -e 's/ URL:.*//; s/[ /[/g' privoxy.1 ;\ + perl -pi.bak -e "s/[ /[/g;s/á/\\['a]/g;s/é/\\['e]/g" privoxy.1; \ + perl -pi.bak -e "s/ö/\\[:o]/g" privoxy.1; \ + perl -pi.bak -e 's/([ {])-([a-z])/$$1\-$$2/g' privoxy.1; \ + perl -pi.bak -e 's/ --([a-z])/ \-\-$$1/g' privoxy.1; \ + perl -pi.bak -e 's/\fB--/\fB\-\-/g' privoxy.1; \ + $(DB) ../privoxy-man-page.sgml && $(MV) -f privoxy.1 ../../../privoxy.1
# For those with man2html ala RH7s. man2html: mkdir -p doc/webserver/man-page - @if [ $(MAN2HTML) != "false" ]; then \ - $(MAN2HTML) $(MAN_PAGE) |grep -v "^Content-type" > tmp.html; \ - $(PERL) -pi.bak -e 's/<A .*Contents</A>//; s/<A .*man2html</A>/man2html/' tmp.html; \ - $(PERL) -pi.bak -e 's/(</HEAD>)/<LINK REL="STYLESHEET" TYPE="text/css" HREF="../p_doc.css"></HEAD>/' tmp.html; \ - $(PERL) -pi.bak -e 's/(<A.*),(">)/$$1$$2/g' tmp.html; \ - $(PERL) -pi.bak -e 's,.">,">,g' tmp.html; \ - $(PERL) -pi.bak -e "s/['a]/á/g;s/['e]/é/g" tmp.html; \ - $(SED) -e 's///g' tmp.html > doc/webserver/man-page/privoxy-man-page.html && $(RM) tmp.*; \ - else \ - $(MAKE) groff2html; \ - fi; +ifneq ($(MAN2HTML),false) + $(MAN2HTML) privoxy.1 |grep -v "^Content-type" > tmp.html + $(PERL) -pi.bak -e 's/<A .*Contents</A>//; s/<A .*man2html</A>/man2html/' tmp.html + $(PERL) -pi.bak -e 's/(</HEAD>)/<LINK REL="STYLESHEET" TYPE="text/css" HREF="../p_doc.css"></HEAD>/' tmp.html +# Twice because my version of man2html is pulling in commas and periods in URLs. + $(PERL) -pi.bak -e 's/(<A.*),(">)/$$1$$2/g' tmp.html + $(PERL) -pi.bak -e 's,.">,">,g' tmp.html + $(PERL) -pi.bak -e "s/['a]/á/g;s/['e]/é/g" tmp.html +# Get rid of spurious from conversion. (How to do this with perl?) + $(SED) -e 's///g' tmp.html > doc/webserver/man-page/privoxy-man-page.html && $(RM) tmp.* +else + $(MAKE) groff2html +endif +
# Otherwise we get plain groff conversion. groff2html: - $(G2H_CMD) ./$(MAN_PAGE) | $(SED) -e 's@</head>@<link REL="STYLESHEET" TYPE="text/css" HREF="../p_doc.css"></head>@' > doc/webserver/man-page/privoxy-man-page.html + $(G2H_CMD) ./privoxy.1 | $(SED) -e 's@</head>@<link REL="STYLESHEET" TYPE="text/css" HREF="../p_doc.css"></head>@' > doc/webserver/man-page/privoxy-man-page.html
# readme page and INSTALL file @@ -512,7 +741,7 @@ dok-readme: dok-release # for documentation, etc. # # index.html for webserver: -dok-webserver: +dok-webserver: cd doc/source/webserver && $(DB)-notoc -ip-homepage -V nochunks index.sgml > ../../webserver/index.html $(PERL) -pi.bak -e 's/../p_doc.css/p_doc.css/;\ s/</HEAD/\n<meta name="description" content="Privoxy helps users to protect their privacy."></HEAD/;\ @@ -522,7 +751,7 @@ dok-webserver: doc/webserver/index.html && $(RM) doc/webserver/*.bak
# privoxy-index.html for local documentation: -dok-index: +dok-index: cd doc/source/webserver && $(DB)-notoc -ip-index -V nochunks index.sgml > ../../webserver/privoxy-index.html $(PERL) -pi.bak -e 's/../p_doc.css/p_doc.css/;\ s/</HEAD/\n<meta name="description" content="Privoxy helps users to protect their privacy."></HEAD/;\ @@ -535,8 +764,19 @@ dok-index: dok: dok-release dok-devel dok-user dok-faq dok-readme dok-webserver dok-authors dok-index @$(ECHO) Documentation created.
+# +# an alternative to the above dok. disabled man page creation for the moment +# +redhat-dok: dok-release dok-devel dok-user dok-faq redhat-readme dok-webserver dok-authors + @$(ECHO) Documentation created. + +## Make README +redhat-readme: + cd doc/source && $(DB)-notoc -V nochunks readme.sgml > tmp.html && $(WDUMP) \ + tmp.html > ../../README && $(RM) -r tmp.html + ## Make AUTHORS file -dok-authors: +dok-authors: cd doc/source && $(DB) -V nochunks authors.sgml > tmp.html && env -u LANG $(WDUMP) \ tmp.html > ../../AUTHORS && $(RM) tmp.html
@@ -548,18 +788,19 @@ dok-release: s/<!entity +p-status.*>/<!entity p-status "$(CODE_STATUS)">/' \ doc/source/*sgml doc/source/*/*sgml $(RM) -r doc/source/*bak doc/source/*/*bak - @if [ $(CODE_STATUS) = "stable" ]; then \ - $(ECHO) Setting docs to stable $(VERSION); \ - $(PERL) -pi.bak -e 's/<!entity +% +p-stable.*>/<!entity % p-stable "INCLUDE">/;\ - s/<!entity +% +p-not-stable.*>/<!entity % p-not-stable "IGNORE">/' \ - doc/source/*sgml doc/source/*/*sgml; \ - else \ - $(ECHO) Setting docs to not stable $(VERSION); \ - $(PERL) -pi.bak -e 's/<!entity +% +p-stable.*>/<!entity % p-stable "IGNORE">/; \ - s/<!entity +% +p-not-stable.*>/<!entity % p-not-stable "INCLUDE">/' \ - doc/source/*sgml doc/source/*/*sgml; \ - fi; - $(RM) -r doc/source/*bak doc/source/*/*bak; +ifeq ($(CODE_STATUS),stable) + @$(ECHO) Setting docs to stable $(VERSION) + @$(PERL) -pi.bak -e 's/<!entity +% +p-stable.*>/<!entity % p-stable "INCLUDE">/;\ + s/<!entity +% +p-not-stable.*>/<!entity % p-not-stable "IGNORE">/' \ + doc/source/*sgml doc/source/*/*sgml + $(RM) -r doc/source/*bak doc/source/*/*bak +else + @$(ECHO) Setting docs to not stable $(VERSION) + @$(PERL) -pi.bak -e 's/<!entity +% +p-stable.*>/<!entity % p-stable "IGNORE">/;\ + s/<!entity +% +p-not-stable.*>/<!entity % p-not-stable "INCLUDE">/' \ + doc/source/*sgml doc/source/*/*sgml + $(RM) -r doc/source/*bak doc/source/*/*bak +endif
# Create release announcement in text and html, with short and long versions. # This is a standalone target, and must be invoked directly. @@ -569,13 +810,13 @@ dok-release: # mv -f index.html announce.html && $(WDUMP) announce.html > announce.txt # cd $(DOC_TMP) && $(DB) announce.sgml &&\ # mv -f index.html announce-mini.html && $(WDUMP) announce-mini.html > announce-mini.txt &&\ -# mv -f *html *txt ../../.. +# mv -f *html *txt ../../.. # rm -fr $(DOC_TMP)
-# The main Privoxy config file, generated from sgml sources. -# NOTE: This will require some hand editing. The new file is outputted +# The main Privoxy config file, generated from sgml sources. +# NOTE: This will require some hand editing. The new file is outputted # as config.new so that problem sections can be compared to previous -# version. This is hardcored to w3m for html/text conversion. Also, +# version. This is hardcored to w3m for html/text conversion. Also, # requires the shell util 'fmt'. config-file: dok-release cd doc/source && $(DB)-notoc -iconfig-file -V nochunks config.sgml > __tmp.html &&\ @@ -594,7 +835,7 @@ config-file: dok-release
# config file, alternate version using lynx (perl stuff unfinished). Lynx # does not do so good a job. -config-file-alt: +config-file-alt: cd doc/source && $(ECHO) -e ".h2 JUSTIFY\nJUSTIFY:FALSE" > __tmp.lynx_cfg &&\ $(DB)-notoc -iconfig-file -V nochunks config.sgml > __tmp.html &&\ lynx -cfg=__tmp.lynx_cfg -width=78 -dump __tmp.html > ../../config.new && $(RM) -r __tmp.* @@ -608,50 +849,46 @@ config-file-alt: # moves dokumentation to webserver # ############################################################################# -webserver: clean-editor-files +webserver: tidy @$(ECHO) ------------------------------------------------------- @$(ECHO) You will need to "create" a SF shell first: - @$(ECHO) ssh -t SF-USER-ID,ijbswa@shell.sourceforge.net create + @$(ECHO) ssh -t USER,PROJECT@shell.sourceforge.net create @$(ECHO) Please make sure your documentation files are up to date. - @$(ECHO) Note that this command updates the home page and copys + @$(ECHO) Note that this command updates the home page and scps @$(ECHO) all stuff to the webserver, it will not remove obsolete documents. - @$(ECHO) Note that a botched upload can result in the documentation - @$(ECHO) on the website becoming unreachable! Also the CSS files - @$(ECHO) currently seem to end up at the wrong place. + @$(ECHO) You will also need to change the user-manual symlink manually. @$(ECHO) -------------------------------------------------------
- @$(ECHO) Replacing the user-manual symlink - @$(SSH) shell.sourceforge.net "cd $(WWW_ROOT)/htdocs && rm user-manual \ - && mkdir -p $(VERSION)/user-manual && ln -s $(VERSION)/user-manual user-manual" - @$(ECHO) Uploading html @cd doc/webserver; \ upload=`find . -type f -a -not ( -path "*/CVS*" -o -path "*/results*" )`; \ - $(TAR) cf - $$upload | $(SSH) shell.sourceforge.net 'cd $(WWW_ROOT)/htdocs/; tar xvm 2>&1 | grep -v timestamp' + $(TAR) c $$upload | ssh shell.sf.net 'cd /home/groups/i/ij/ijbswa/htdocs/; tar xvm 2>&1 | grep -v timestamp'
@$(ECHO) Fixing permissions - @$(SSH) shell.sourceforge.net 'chmod -R 775 $(WWW_ROOT)/htdocs 2>/dev/null; true' - @$(SSH) shell.sourceforge.net 'find $(WWW_ROOT)/htdocs/ -type f | xargs chmod 664 2>/dev/null; true' + @ssh shell.sf.net 'chmod -R 775 /home/groups/i/ij/ijbswa/htdocs 2>/dev/null; true' + @ssh shell.sf.net 'find /home/groups/i/ij/ijbswa/htdocs/ -type f | xargs chmod 664 2>/dev/null; true' + @ssh shell.sf.net 'chmod 666 /home/groups/i/ij/ijbswa/htdocs/actions/results/actions-feedback.txt 2>/dev/null; true'
-web-actions: clean-editor-files - @$(ECHO) Uploading + +web-actions: tidy + @$(ECHO) Uploading @cd doc/webserver/actions; \ upload=`find . -type f -a -not ( -path "*/CVS*" -o -path "*/results*" )`; \ - $(TAR) cf - $$upload | $(SSH) ijbswa.sourceforge.net 'cd $(WWW_ROOT)/htdocs/actions; tar xvm' + $(TAR) c $$upload | ssh ijbswa.sourceforge.net 'cd /home/groups/i/ij/ijbswa/htdocs/actions; tar xvm'
@$(ECHO) Fixing permissions - @$(SSH) ijbswa.sourceforge.net 'find $(WWW_ROOT)/htdocs/actions/ -type f | xargs chmod 664 2>/dev/null' - @$(SSH) ijbswa.sourceforge.net 'chmod 666 $(WWW_ROOT)/htdocs/actions/results/actions-feedback.txt 2>/dev/null' + @ssh ijbswa.sourceforge.net 'find /home/groups/i/ij/ijbswa/htdocs/actions/ -type f | xargs chmod 664 2>/dev/null' + @ssh ijbswa.sourceforge.net 'chmod 666 /home/groups/i/ij/ijbswa/htdocs/actions/results/actions-feedback.txt 2>/dev/null'
-## +## dok-put: tar --exclude ".cvsignore" --exclude "CVS" --exclude "source" --exclude ".htaccess" \ --exclude "obsolete" --exclude "actions" --exclude "*.zip" --exclude "robots.txt"\ doc/* INSTALL LICENSE AUTHORS README \ -czf $(DOC_FILE) ;\ $(ECHO) "Uploading doc package ..." ;\ - scp $(DOC_FILE) ijbswa.sourceforge.net:$(WWW_ROOT)/htdocs/docs/ - @$(SSH) ijbswa.sourceforge.net 'chmod 775 $(WWW_ROOT)/htdocs/docs/*gz 2>/dev/null; true' + scp $(DOC_FILE) ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/docs/ + @ssh ijbswa.sourceforge.net 'chmod 775 /home/groups/i/ij/ijbswa/htdocs/docs/*gz 2>/dev/null; true' $(RM) $(DOC_FILE)
dok-get: @@ -659,22 +896,6 @@ dok-get: $(WGET) http://www.privoxy.org/docs/$(DOC_FILE) ;\ $(TAR) -zxvf $(DOC_FILE)
-############################################################################# -# -# Try to clean up the generated HTML files. -# -# The files are a such a mess that some of them require two tidy runs -# in row as the first abort prematurely. The vanilla tidy output renders -# poorly as it contains a bit too much white-space, so we additionally run -# the files through perl to fix this again. -# -############################################################################# -dok-tidy: - for html_file in `find doc/webserver -name "*.html"`; do \ - $(TIDY) $$html_file || $(TIDY) $$html_file; \ - $(PERL) -i'' -e 's@^\s*<br>\s*$$@@; s@ +$$@@;' -n -p $$html_file; \ - done -
############################################################################# # Source file dependencies @@ -687,7 +908,7 @@ cgisimple.@OBJEXT@: cgisimple.c cgisimple.h config.h $(PROJECT_H_DEPS) cgi.h lis deanimate.@OBJEXT@: deanimate.c deanimate.h config.h $(PROJECT_H_DEPS) encode.@OBJEXT@: encode.c encode.h config.h errlog.@OBJEXT@: errlog.c errlog.h config.h $(PROJECT_H_DEPS) @WIN_ONLY@w32log.h -filters.@OBJEXT@: filters.c filters.h config.h $(PROJECT_H_DEPS) errlog.h encode.h gateway.h jbsockets.h jcc.h loadcfg.h parsers.h ssplit.h cgi.h deanimate.h urlmatch.h @WIN_ONLY@win32.h +filters.@OBJEXT@: filters.c filters.h config.h $(PROJECT_H_DEPS) errlog.h encode.h gateway.h jbsockets.h jcc.h loadcfg.h parsers.h ssplit.h cgi.h deanimate.h urlmatch.h @WIN_ONLY@win32.h gateway.@OBJEXT@: gateway.c gateway.h config.h $(PROJECT_H_DEPS) errlog.h jbsockets.h jcc.h loadcfg.h jbsockets.@OBJEXT@: jbsockets.c jbsockets.h config.h $(PROJECT_H_DEPS) filters.h jcc.@OBJEXT@: jcc.c jcc.h config.h $(PROJECT_H_DEPS) errlog.h filters.h gateway.h jbsockets.h loadcfg.h loaders.h miscutil.h parsers.h @WIN_ONLY@w32log.h win32.h w32svrapi.h cgi.h @@ -703,12 +924,12 @@ urlmatch.@OBJEXT@: urlmatch.c urlmatch.h config.h $(PROJECT_H_DEPS) errlog.h gnu_regex.@OBJEXT@: gnu_regex.c gnu_regex.h config.h
# PCRS -pcrs.@OBJEXT@: pcrs.c pcrs.h config.h @STATIC_PCRE_ONLY@pcre/pcre.h +pcrs.@OBJEXT@: pcrs.c pcrs.h config.h @STATIC_PCRE_ONLY@pcre/pcre.h
# PCRE pcre/get.@OBJEXT@: pcre/get.c pcre/config.h pcre/internal.h pcre/pcre.h pcre/maketables.@OBJEXT@: pcre/maketables.c pcre/config.h pcre/internal.h pcre/pcre.h -pcre/pcre.@OBJEXT@: pcre/pcre.c pcre/config.h pcre/internal.h pcre/pcre.h pcre/chartables.c +pcre/pcre.@OBJEXT@: pcre/pcre.c pcre/config.h pcre/internal.h pcre/pcre.h pcre/chartables.c pcre/pcreposix.@OBJEXT@: pcre/pcreposix.c pcre/config.h pcre/internal.h pcre/pcre.h pcre/pcreposix.h pcre/study.@OBJEXT@: pcre/study.c pcre/config.h pcre/internal.h pcre/pcre.h
@@ -725,7 +946,7 @@ w32log.@OBJEXT@: w32log.c errlog.h config.h jcc.h loadcfg.h miscutil.h pcre/pcre w32taskbar.@OBJEXT@: w32taskbar.c config.h w32log.h w32taskbar.h win32.@OBJEXT@: win32.c config.h jcc.h loadcfg.h pcre/pcre.h pcre/pcreposix.h pcrs.h project.h w32log.h win32.h w32svrapi.h
-w32.res: w32.rc w32res.h icons/radar-01.ico icons/radar-02.ico icons/radar-03.ico icons/radar-04.ico icons/radar-05.ico icons/radar-06.ico icons/radar-07.ico icons/radar-08.ico icons/idle.ico icons/privoxy.ico config.h +w32.res: w32.rc w32res.h icons/ico00001.ico icons/ico00002.ico icons/ico00003.ico icons/ico00004.ico icons/ico00005.ico icons/ico00006.ico icons/ico00007.ico icons/ico00008.ico icons/idle.ico icons/privoxy.ico config.h windres -D__MINGW32__=0.2 -O coff -i $< -o $@
# AmigaOS @@ -744,23 +965,22 @@ $(PROGRAM): $(OBJS) $(W32_FILES) $(LD) $(LDFLAGS) -o $(PROGRAM) $(OBJS) $(LIBS)
clean: - $(RM) a.out $(OBJS) $(W32_FILES) $(W32_INIS) $(PROGRAM) default.action \ - `find . -name TAGS -o -name tags | $(GREP) -v .git` config.base config.tmp + $(RM) a.out $(OBJS) $(W32_FILES) $(W32_INIS) $(PROGRAM) default.action `find . -name TAGS -o -name tags` config.base config.tmp
-clean-editor-files: +tidy: $(RM) `find . -name "*~"` $(RM) `find . -name "#*#"` # Emacs backup files $(RM) `find . -name ".#*"`
-clobber: clean-editor-files +clobber: tidy $(RM) GNUmakefile configure config.h.in config.h config.cache config.status config.log logfile \ privoxy.log core *.tar.gz *.tar privoxy-cl.spec doc/source/ldp.dsl config.new $(RM) -r autom4te.cache
# -# FIXME: What is all this? +# FIXME: What is all this? # - $(RM) cscope.* *.pdb *.lib *.exp + $(RM) cscope.* *.pdb *.lib *.exp
distclean: clobber
@@ -801,11 +1021,11 @@ GROUP_T:=$(shell if [ x$(GROUP) = x ] && [ x$(USER) != x ];then \ install-strip: $(MAKE) install STRIP=-s
-# FIXME: Test USER and GROUP on Slack to make sure this works as +# FIXME: Test USER and GROUP on Slack to make sure this works as # intended. # -# FIXME: id handling needs help, probably via configure, since 'id -u' is not -# universally reliable (eg Solaris). Group handling could be better. +# FIXME: id handling needs help, probably via configure, since 'id -u' is not +# universally reliable (eg Solaris). Group handling could be better. # Perhaps the whole user/group validation should be done here, and simplified. PROGRAM_V = Privoxy $(VERSION) $(CODE_STATUS) install: CONF_DEST LOG_DEST PID_DEST check_doc GROUP_T @@ -813,7 +1033,7 @@ install: CONF_DEST LOG_DEST PID_DEST check_doc GROUP_T @if [ -n "$(USER)" ]; then \ $(ID) $(USER) >/dev/null || exit 1;\ fi - @# Test for valid group. FIXME. USER does not have to belong to GROUP + @# Test for valid group. FIXME. USER does not have to belong to GROUP @# for file ownership purposes. # if [ -n "$(GROUP_T)" ] && [ -n "$(USER)" ] && ! $(GROUPS) $(USER) | $(GREP) "<$(GROUP_T)>" >/dev/null; then \ # $(ECHO) Group $(GROUP_T) for User $(USER) is invalid && exit 1 ;\ @@ -859,8 +1079,8 @@ install: CONF_DEST LOG_DEST PID_DEST check_doc GROUP_T $(INSTALL) $(INSTALL_T) $(DOK_WEB)/p_doc.css $(DESTDIR)$$DOC/user-manual;\ fi @# Not all platforms support gzipped man pages. - @$(ECHO) Installing man page to $(DESTDIR)$(MAN_DEST)/$(MAN_PAGE) - -$(INSTALL) $(INSTALL_T) $(MAN_PAGE) $(DESTDIR)$(MAN_DEST)/$(MAN_PAGE) + @$(ECHO) Installing man page to $(DESTDIR)$(MAN_DEST)/privoxy.1 + -$(INSTALL) $(INSTALL_T) privoxy.1 $(DESTDIR)$(MAN_DEST)/privoxy.1
@# Change the config file default directories according to the configured ones @$(ECHO) Rewriting config for this installation @@ -876,10 +1096,10 @@ install: CONF_DEST LOG_DEST PID_DEST check_doc GROUP_T $(SED) 's+^#?user-manual .*+user-manual $(prefix)/doc/privoxy/user-manual/+' config.tmp >config.updated ;\ fi;\ $(MV) config config.base - $(MV) config.updated config + $(MV) config.updated config
- @# Install the config support files. Test for root install, and abort - @# if there is no privoxy user, and no other user was enabled during + @# Install the config support files. Test for root install, and abort + @# if there is no privoxy user, and no other user was enabled during @# configure. Later, install init script if appropriate. @$(ECHO) Installing templates to $(DESTDIR)$(CONF_DEST)/templates @for i in `find templates -type f`; do \ @@ -961,6 +1181,15 @@ install: CONF_DEST LOG_DEST PID_DEST check_doc GROUP_T $(INSTALL) $(INSTALL_P) slackware/rc.privoxy $(DESTDIR)/etc/rc.d/ ;\ $(ECHO) "Installing for Slackware." ;\ $(ECHO) "Dont forget to add the rc.privoxy to rc.local if you want it started at every boot" ;\ + elif [ -f /etc/redhat-release ] && [ -d /etc/rc.d/init.d/ ] && [ -w /etc/rc.d/init.d/ ] ; then \ + $(ECHO) "Installing init script to /etc/rc.d/init.d/privoxy" ;\ + $(SED) 's,^PRIVOXY_BIN=.*,PRIVOXY_BIN="/usr/local/sbin/$(PROGRAM)",' privoxy.init |\ + $(SED) 's,^PRIVOXY_CONF=.*,PRIVOXY_CONF="$(CONF_DEST)/config",' |\ + $(SED) "s,^PRIVOXY_USER=.*,PRIVOXY_USER=$$USER," > init.tmp ;\ + $(INSTALL) $(INSTALL_P) init.tmp $(DESTDIR)/etc/rc.d/init.d/privoxy && $(RM) init.tmp;\ + $(MKDIR) $(DESTDIR)/etc/logrotate.d/ ;\ + $(ECHO) "Installing logrotate script to $(DESTDIR)/etc/logrotate.d/" ;\ + $(INSTALL) -m 0644 privoxy.logrotate $(DESTDIR)/etc/logrotate.d/privoxy ;\ elif [ -d $(DESTDIR)/etc/init.d ] && [ -w $(DESTDIR)/etc/init.d ] ; then \ $(ECHO) "Installing generic init script to $(DESTDIR)/etc/init.d/privoxy" ;\ $(ECHO) "Please check that the PATHs are correct, and edit if needed." ;\ @@ -980,6 +1209,10 @@ uninstall: CONF_DEST LOG_DEST PID_DEST check_doc @$(ECHO) Starting Privoxy uninstallation @# KILL privoxy if running @# XXX: the chkconfig line may need a DESTDIR prefix. + -@if [ -f $(DESTDIR)/etc/redhat-release ] && [ -x $(DESTDIR)/etc/rc.d/init.d/privoxy ]; then \ + $(DESTDIR)/etc/rc.d/init.d/privoxy stop >/dev/null 2>/dev/null ;\ + chkconfig --del $(PROGRAM) 2>/dev/null;\ + fi -@test -f $(DESTDIR)$(PID_DEST)/privoxy.pid && $(ECHO) Stopping $(PROGRAM) &&\ $(KILL) `$(CAT) $(DESTDIR)$(PID_DEST)/privoxy.pid` || : -@test -f $(DESTDIR)/var/run/privoxy.pid && $(ECHO) Stopping $(PROGRAM) &&\ @@ -1008,7 +1241,7 @@ uninstall: CONF_DEST LOG_DEST PID_DEST check_doc
@# man page and docs @$(ECHO) Removing $(PROGRAM) docs - -$(RM) $(DESTDIR)$(MAN_DEST)/$(MAN_PAGE)* + -$(RM) $(DESTDIR)$(MAN_DEST)/privoxy.1* -$(RM) -r $(DESTDIR)$(DOC_DEST) || $(RM) -r $(DESTDIR)$(prefix)/doc/privoxy
@# Log and pidfile @@ -1051,12 +1284,15 @@ uninstall: CONF_DEST LOG_DEST PID_DEST check_doc fi;\ fi
- @# init scripts + @# init scripts and logrotate @if [ "$(prefix)" = "/usr/local" ] || [ "$(prefix)" = "/usr" ]; then \ $(ECHO) Removing $(PROGRAM) init script ;\ if [ -f $(DESTDIR)/etc/slackware-version ] && \ [ -d $(DESTDIR)/etc/rc.d/ ] && [ -w $(DESTDIR)/etc/rc.d/ ] ; then \ $(RM) $(DESTDIR)/etc/rc.d/rc.privoxy ;\ + elif [ -f $(DESTDIR)/etc/redhat-release ] && [ -d $(DESTDIR)/etc/rc.d/init.d/ ] \ + && [ -w $(DESTDIR)/etc/rc.d/init.d/ ] ; then \ + $(RM) $(DESTDIR)/etc/rc.d/init.d/privoxy $(DESTDIR)/etc/logrotate.d/privoxy;\ elif [ -d $(DESTDIR)/etc/init.d ] && [ -w $(DESTDIR)/etc/init.d ] ; then \ $(RM) $(DESTDIR)/etc/init.d/privoxy ;\ else \ @@ -1073,3 +1309,848 @@ coffee: -e '69,253,36,102,81,49,83,236,19,225,171,131,214,172,163,73,4,168,123,' \ -e '115,71,126,247,122,94,128,178,227,95,154,12,86,215,122,197,249,146,' \ -e '187,54,220,125,193,51,228,11,1,0,0);' | zcat + +############################################################################# + +## Local Variables: +## tab-width: 3 +## end: + +# $Log: GNUmakefile.in,v $ +# Revision 1.180 2009/02/28 08:28:14 fabiankeil +# pcrs.o doesn't depend on pcre/pcre.h if we are linking +# dynamically. Patch provided by drauh in #2056286. +# +# Revision 1.179 2009/02/22 14:48:31 hal9 +# Updates to the 'make webserver' target that recreates the home page and uploads +# fresh documents to reflect new SF realities, and more explanation of process. +# +# Revision 1.178 2009/02/08 18:35:48 fabiankeil +# Move the match-all section into a separate file +# (match-all.action) so we can safely overwrite the +# default actions when updating. Based on Roland's +# patch #1563977. +# +# Revision 1.177 2009/01/13 16:44:32 fabiankeil +# Delete the standard.action file after moving +# the pre-settings over to the default actions. +# +# Revision 1.176 2008/09/21 13:24:37 fabiankeil +# Add Roland's man page fixes from 19_manpage_fixup.dpatch. +# +# Revision 1.175 2008/08/30 12:03:07 fabiankeil +# Remove FEATURE_COOKIE_JAR. +# +# Revision 1.174 2008/07/18 17:50:47 fabiankeil +# Fix whitespace. +# +# Revision 1.173 2008/06/18 18:28:42 fabiankeil +# Remove PDF-related stuff. +# +# Revision 1.172 2008/06/17 16:16:08 fabiankeil +# - Stop building text files nobody cares about. +# - Update copyright year. +# +# Revision 1.171 2008/06/13 15:24:57 fabiankeil +# Move previously inline'd Perl code for the config-file target +# into a separate file, have it work with older perl releases, +# clean it up a bit and fix the "underlining" code. +# +# Revision 1.170 2008/06/12 16:38:50 fabiankeil +# Add third-level domain to URL in dok-get target. +# +# Revision 1.169 2008/06/09 17:28:31 fabiankeil +# - Recommend https for releasing files. +# - Fix a warning about datarootdir being ignored. +# +# Revision 1.168 2008/05/23 18:03:12 fabiankeil +# - Shorten meta description inserted in dok-webserver +# and dok-index target. +# - In config-file target, unset LANG for w3m as we +# might otherwise end up with multi-byte characters. +# +# Revision 1.167 2008/05/23 14:39:09 fabiankeil +# Silence dok-user complaint about @# not being found. +# +# Revision 1.166 2008/05/23 14:04:57 fabiankeil +# - Get config-file target working with more recent Perl +# versions. The generated file is still messed up, though. +# - Fix comment typo. +# +# Revision 1.165 2008/05/22 16:57:23 fabiankeil +# Fix coffee machine. +# +# Revision 1.164 2008/05/22 10:26:26 fabiankeil +# - Remove parsers.@OBJEXT@'s dependency on encode.h. +# - Include Emacs backup files in tidy target again. +# +# Revision 1.163 2008/05/04 18:01:53 fabiankeil +# Dependency fixes: cgisimple.c and filters.c depend on urlmatch.h. +# +# Revision 1.162 2008/03/30 13:31:42 fabiankeil +# Add DESTDIR support for the uninstall target. +# +# Revision 1.161 2008/03/30 13:19:13 fabiankeil +# Add DESTDIR support for the install target. Closes PR#1910612. +# Patch by Radoslaw Zielinski with minor modifications. +# +# Revision 1.160 2008/03/27 18:27:19 fabiankeil +# Remove kill-popups action. +# +# Revision 1.159 2008/03/21 11:13:53 fabiankeil +# Only gather host information if it's actually needed. +# Also move the code out of accept_connection() so it's less likely +# to delay other incoming connections if the host is misconfigured. +# +# Revision 1.158 2007/12/11 21:29:25 fabiankeil +# Fix dependency list for cgiedit.c. +# +# Revision 1.157 2007/12/10 02:28:02 hal9 +# Unset $LANG for text processing of docs so we get pure text. +# +# Revision 1.156 2007/11/15 03:17:43 hal9 +# Some workaround changes to the config file perl stuff and comments, which is +# broken here all by itself on perl 5.8.8. +# +# Revision 1.155 2007/09/22 16:23:25 fabiankeil +# Update copyright line. +# +# Revision 1.154 2007/02/07 11:52:40 fabiankeil +# Fix suse-dist as described in BR#1654052. +# (I didn't test it, but it's done the same +# way in redhat-dist which is known to work). +# +# Revision 1.153 2007/01/07 07:36:36 joergs +# Added AmigaOS4 support. +# +# Revision 1.152 2006/12/13 14:53:51 etresoft +# Include any existing LDFLAGS environment when linking so that a MacOS X Universal Binary can be created. +# +# Revision 1.151 2006/11/30 01:08:55 hal9 +# Fix problem with variable declarations in the Slackware section. Thanks to higuita. +# +# Revision 1.150 2006/10/25 11:55:45 fabiankeil +# Fix sed regexes for rewriting "confdir ." and "logdir .". +# Thanks to Darel Henman for reporting this. +# +# Revision 1.149 2006/10/11 01:40:28 hal9 +# Apply patch from Neil McCalden to fix syntax issue. +# +# Revision 1.148 2006/09/26 10:57:58 hal9 +# Including Karsten's patch to fix make create-snapshot. +# +# Revision 1.147 2006/09/13 01:25:16 hal9 +# Make sure install forces in new default.action, default.filter, and +# standard.filter. These are privoxy files, not user files. +# +# Revision 1.146 2006/09/08 23:57:19 hal9 +# User manual images are now user-manual doc directory, and fix make install +# target accordingly. +# +# Revision 1.145 2006/09/08 02:32:00 hal9 +# Various changes to implement building and installing docs to be compatible +# with the new "user-manual" settings in config from Roland. Docbook does not +# seem to like dealing with more than one css file, so workaround that here. +# Change 'make install' so it provides p_doc.css in the user-manual doc +# directory so that functions well, and lastly modify 'make install' so that the +# PATH is automatically set, and the 'user-manual' directive should done during +# the install. +# +# Revision 1.144 2006/09/07 22:53:20 hal9 +# Make sure config sgml build related artifacts are cleaned out. +# +# Revision 1.143 2006/09/02 15:59:40 hal9 +# Add to code status to make install output. +# +# Revision 1.142 2006/08/29 01:46:24 hal9 +# Add user.filter to $CONFIGS. +# +# Revision 1.141 2006/08/12 03:54:37 david__schmidt +# Windows service integration +# +# Revision 1.140 2006/07/18 14:48:45 david__schmidt +# Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +# with what was really the latest development (the v_3_0_branch branch) +# +# Revision 1.104.2.28 2004/06/10 17:06:05 hal9 +# Fix bug #959617, by moving TMPDIR var to create-snapshot target, which is the +# only place it is used. +# +# Revision 1.104.2.27 2004/02/07 16:11:10 oes +# Make clobber remove the autom4te.cache dir. +# Closes BR #889300 +# +# Revision 1.104.2.26 2004/01/31 16:32:25 oes +# Adding a check for an htmldoc variant from the debian diff +# +# Revision 1.104.2.25 2004/01/31 01:15:33 oes +# Fixed a typo; updated copyright notice +# +# Revision 1.104.2.24 2003/12/03 10:30:02 oes +# - Added new dependency: actions.c -> ssplit.h +# - Excluded PDF docs from src tarball +# +# Revision 1.104.2.23 2003/04/20 17:28:52 hal9 +# Strip trailing spaces from config-file generation, bug #724596. +# +# Revision 1.104.2.22 2003/03/28 03:32:01 hal9 +# Minor changes for Privoxy home page: +# - Handle © more sanely +# - include link to announce.txt +# Also, disable 'make announce' target. +# +# Revision 1.104.2.21 2002/11/04 07:04:03 hal9 +# Catch up with main trunk install/uninstall. Quiet output, etc. +# +# Revision 1.104.2.20 2002/10/25 02:44:22 hal9 +# Port of make install, etc from main trunk. Needs testing! Add Slackware +# support, and other related changes. Update related docs. +# +# Revision 1.104.2.19 2002/09/26 22:50:02 hal9 +# New user-manual examples in config-file are getting wrapped. Add warning. +# +# Revision 1.104.2.18 2002/08/23 12:22:40 oes +# Added warning to broken install target +# +# Revision 1.104.2.17 2002/08/16 03:19:34 hal9 +# More (minor) cleanup of html before pdf processing to make some relative +# links work as pdf -> pdf. Upload pdf as zip archive now. +# +# Revision 1.104.2.16 2002/08/14 16:43:27 hal9 +# Added pdf docs to make webserver target. +# +# Revision 1.104.2.15 2002/08/11 20:02:41 hal9 +# New targets for man page (make man) and pdf (make dok-pdf) targets. +# +# Revision 1.104.2.14 2002/08/10 11:19:37 oes +# - Make -Ipcre (again) conditional on STATIC_PCRE +# - $(RPMBUILD) -> $(RPM) for SuSE +# - Add dependency: pcrs.o deps on config.h +# +# Revision 1.104.2.13 2002/08/07 15:13:54 hal9 +# Remove pdf2 target, and make it dok-shtml (single page html for pdf +# conversion). +# +# Revision 1.104.2.12 2002/08/06 11:29:36 oes +# Fixed detection/inclusion of pcre.h, which is in a pcre subdir on RH +# +# Revision 1.104.2.11 2002/07/30 19:38:11 hal9 +# Add redhat-test target for testing purposes only. Fix RPM_PACKAGEV to what +# *I think* it was supposed to be (was breaking upload targets since it was +# set to RPM_VERSION). +# +# Revision 1.104.2.10 2002/07/27 22:56:53 kick_ +# cleanups of the redhat-srpm target +# +# Revision 1.104.2.9 2002/07/26 15:17:02 oes +# - Added generation of default.action from defaul.action.master +# - Deleted obsolete re_filterfile.txt generation +# +# Revision 1.104.2.8 2002/07/12 10:04:32 kick_ +# added helper targets to the makefile. They shouldn't break anything, but +# make my life a lot easier. +# +# The new rpm has been splitted into two parts, one for package installation/ +# removal, one for package building. +# Therefore rpm -ta isn't a valid command anymore and needs to be replaced +# by rpmbuild -ta (this is backwards compatible) +# +# Revision 1.104.2.7 2002/06/07 00:23:47 hal9 +# Fixing a quirk of man2html (on my system) that pulls punctuation into URLs, +# thus breaking them completely. +# +# Revision 1.104.2.6 2002/06/02 03:26:25 hal9 +# Update CONFIG_FILES (ie update basic.action, etc), and also DOC_FILES (exclude +# index.html and team/index.html) +# +# Revision 1.104.2.5 2002/05/30 15:35:01 hal9 +# This is more cleanup on the make config-file target. Most issues for +# automatic generation are taken care of. There are still some problems +# that require hand editing. Namely, some of the examples that are > 80 chars. +# +# Revision 1.104.2.4 2002/05/29 02:12:17 hal9 +# Ooops...forgot about perl -pi cygwin problem. Add -pi.bak. Also, the +# new target is 'make config-file', _not_ make config. +# +# Revision 1.104.2.3 2002/05/29 02:05:48 hal9 +# 'make config' target added (WIP) for future generation of config file from +# text in u-m so the two are in sync. New generated config, which requires +# some hand editing for the time being. +# +# Revision 1.104.2.2 2002/05/28 02:32:55 hal9 +# New target 'make dok-index' for privoxy-index.html. Also, fixed *.bak files +# not being cleaned up in doc/webserver. +# +# Revision 1.104.2.1 2002/05/26 17:19:34 hal9 +# Remove Table of Contents from readme with oes's dsl trick. +# +# Revision 1.104 2002/05/24 00:03:49 oes +# Use p_doc.css for the Homepage for consistency +# +# Revision 1.103 2002/05/23 23:19:00 oes +# Use dsl without TOC for the homepage +# +# Revision 1.102 2002/05/16 01:20:17 hal9 +# make announce target added. +# +# Revision 1.101 2002/05/15 12:28:46 oes +# Trying to keep Hal happy :) +# +# Revision 1.100 2002/05/08 13:48:18 hal9 +# Ooops, that trashed JB v2.0.2 comment. Fixed. +# +# Revision 1.99 2002/05/08 13:42:07 hal9 +# This fixes the numbering problem on index.html in contact info section (.1.). Using +# perl, since its way too convoluted to try to fix proper with docbook. +# +# Revision 1.98 2002/05/03 14:33:06 oes +# Replaced ldp(OK).dsl handling with generation via autoconf; handle all file exeptions to src tarball via find +# +# Revision 1.97 2002/04/27 20:27:43 swa +# no longer needed due to new +# PACKAGE_VERSION process +# +# Revision 1.96 2002/04/27 17:44:32 morcego +# - Correcting typo in my name (Rodrigo, not Rodgrigo) :-) +# - Using the RM macro everywhere rm is called (either we use, or don't) +# - Same for RPM +# +# Revision 1.95 2002/04/27 15:37:25 swa +# replacing directory in document creation process +# no longer necessary. +# +# Revision 1.94 2002/04/27 08:23:29 swa +# pdf process reviewed and cleaned up +# +# Revision 1.93 2002/04/27 04:55:53 morcego +# privoxy-cl.spec now gets removed by clobber target +# +# Revision 1.92 2002/04/27 04:53:40 morcego +# Adding --exclude "PACKAGERS" to every tar command that applies (not for +# webserver target) +# +# Revision 1.91 2002/04/27 04:44:51 morcego +# GNUmakefile.in: The tarball created on redhat-dist and suse-dist now ignore +# the PACKAGERS file, as well privoxy-cl.spec (in case it was created) +# GNUmakefile.in: New targets -> conectiva-spec, conectiva-dist and +# conectiva-upload +# genclspec.sh : New file to generate, from privoxy-rh.spec, a specfile +# for Conectiva Linux +# +# Revision 1.90 2002/04/26 17:46:53 swa +# be consistent +# +# Revision 1.89 2002/04/26 17:20:54 swa +# just produce single html files to proces them later with Destiller or somesuch. looks prettier. +# +# Revision 1.88 2002/04/25 19:13:57 morcego +# Removed RPM release number declaration on configure.in +# Changed makefile to use given value for RPM_PACKAGEV when on uploading +# targets (will produce an error, explaining who to do it, if no value +# if provided). +# +# Revision 1.87 2002/04/23 14:10:59 swa +# now create pdf documents +# +# Revision 1.86 2002/04/15 04:30:27 hal9 +# Missed two -pi.bak's on perl/cygwin problem. +# +# Revision 1.85 2002/04/14 01:05:34 hal9 +# Revert dok-webserver change for SF logo. +# +# Revision 1.84 2002/04/13 22:43:25 hal9 +# -Fix dok-webserver for SF logo (more perl). +# -Change all perl -pi to perl -pi.bak for Cygwin problem. +# +# Revision 1.83 2002/04/12 09:39:25 oes +# Excluding yet more files from tarball; making dist warning yet more scary +# +# Revision 1.82 2002/04/11 21:07:11 oes +# Excluding more files from tarball build +# +# Revision 1.81 2002/04/11 14:40:27 oes +# Fixed typo -- Thanks, Moritz! +# +# Revision 1.80 2002/04/11 12:50:00 oes +# Fixed tarball-dist target +# +# Revision 1.79 2002/04/11 06:49:28 oes +# webserver target: silenced timestamp warnings resulting from uploading westwards, made permissions fixing independant of screwed local dir permissions, suppress (false alarm) make error if not owner of feedback log +# +# Revision 1.78 2002/04/09 13:37:11 sarantis +# fix tar options typo +# +# Revision 1.77 2002/04/09 13:28:53 swa +# build suse and gen-dist with html docs +# +# Revision 1.76 2002/04/08 22:43:41 oes +# Fix: Include dotfiles in fixing webserver permissions +# +# Revision 1.75 2002/04/08 22:14:59 oes +# Silencing tar warnings in the web* targets +# +# Revision 1.74 2002/04/08 15:22:44 hal9 +# This has finishing touches for dok building. Should be ready to go. +# -The main doc build is now 'make dok', should work on Redhat too. +# -Removed man page from main doc build. It is built separately due to +# perl scripts that most aren't likely to have. +# +# Revision 1.73 2002/04/08 14:03:24 oes +# oes for al: Fix install target +# +# Revision 1.72 2002/04/08 13:42:11 oes +# Added safety check to *-dist targets; fixed permissions for feedback logfile +# +# Revision 1.71 2002/04/07 20:32:03 hal9 +# -Add meta data kludge for make dok-webserver via $(PERL). +# -Add subdirs for 'make dok-release'. +# +# Revision 1.70 2002/04/07 08:59:40 swa +# generated files. do NOT edit. +# fixed directory bug in makefile. +# +# Revision 1.69 2002/04/07 08:10:47 swa +# create some of the webserver docs +# automatically (in particular if +# those docs recycle other documentation +# fragments). Now committed webserver's +# index file. +# +# Revision 1.68 2002/04/07 07:58:11 swa +# create some of the webserver docs +# automatically (in particular if +# those docs recycle other documentation +# fragments) +# +# Revision 1.67 2002/04/07 05:31:42 hal9 +# Add 'dok-release' target: +# -Set doc entities to VERSION and CODE_STATUS during make. +# -Set doc conditional content flags (stable vs non-stable). +# A separate target for the time being but needs to be incorporated into +# dok build at some point. +# -Filter out a spurious ^G from new man page > html converion in man2html. +# +# Revision 1.66 2002/04/06 20:28:21 jongfoster +# Prettifying groff2html. +# Using GNU Make's conditional makefile feature rather than shell "if"s. +# (The shell "if"s were hiding errors) +# "perl" -> "$(PERL)" +# Spaces->tabs in a couple of places. +# +# Revision 1.65 2002/04/06 05:16:39 hal9 +# -Add 'authors' and 'man' targets for AUTHORS and man-page (WIP). +# -Both of these will soon be generated files. +# +# Revision 1.64 2002/04/04 22:14:51 oes +# No longer rely on find honoring -iname +# +# Revision 1.63 2002/04/04 21:06:22 swa +# cosmetics. +# +# Revision 1.62 2002/04/04 20:49:50 swa +# attempt to consolidate the +# different dokbook versions. +# +# Revision 1.61 2002/04/04 19:18:21 swa +# readme was leftover directory. use w3m instead +# of lynx to be consistent among developers. use +# consistent target naming. +# +# Revision 1.60 2002/04/04 12:25:41 oes +# Tidy webserver upload w/o *~ files, CVS dirs and logfiles and with proper dir and file permissions +# +# Revision 1.59 2002/04/04 08:32:45 swa +# wrong name for tarball-dist target. further fixed content of tarball dist +# +# Revision 1.58 2002/04/04 06:32:58 hal9 +# New dok targets for make readme. +# +# Revision 1.57 2002/04/04 00:36:36 gliptak +# always use pcre for matching +# +# Revision 1.56 2002/04/03 22:28:03 gliptak +# Removed references to gnu_regex +# +# Revision 1.55 2002/04/03 19:54:29 swa +# freebsd tested to work. attempt to move tarball dist target forward +# +# Revision 1.54 2002/04/03 14:54:07 oes +# Standard clean and clobber semantics II +# +# Revision 1.53 2002/04/03 14:19:16 oes +# Standard clean and clobber semantics +# +# Revision 1.52 2002/04/03 02:56:18 hal9 +# Revert previous FAQ numbering kludge. +# +# Revision 1.51 2002/04/02 13:03:56 oes +# Added fix for webserver permissions +# +# Revision 1.50 2002/04/02 03:46:24 hal9 +# Rewrite ldpOK.dsl so that sections are NOT numbered on FAQ, in an effort +# to make the Table of Contents not so 'busy' looking. SuSE needs testing :) +# +# Revision 1.49 2002/03/30 22:20:12 swa +# cd didn't work. neither did find. +# +# Revision 1.48 2002/03/30 19:04:06 swa +# people release differently. no good. +# I want to make parts of the docs only. +# +# Revision 1.47 2002/03/30 09:05:21 swa +# better packaging. better rpm building. +# tar failed on sun (no exclude there). +# +# Revision 1.46 2002/03/29 20:09:01 swa +# al's patch +# +# Revision 1.45 2002/03/29 19:45:45 swa +# for lazy swa +# +# Revision 1.44 2002/03/29 17:42:44 gliptak +# Correcting for Solaris tar limitations +# +# Revision 1.43 2002/03/29 07:40:03 swa +# fixed make webserver. doh +# +# Revision 1.42 2002/03/29 06:59:04 swa +# other users could not modify files on webserver +# +# Revision 1.41 2002/03/28 20:43:00 swa +# set make correctly +# +# Revision 1.40 2002/03/28 04:22:44 hal9 +# More on man2html stuff. +# +# Revision 1.39 2002/03/28 01:04:14 hal9 +# More man2html stuff for docs. +# +# Revision 1.38 2002/03/27 16:02:30 swa +# have a generic target +# +# Revision 1.37 2002/03/27 15:30:26 swa +# have a consistent appearance +# +# Revision 1.36 2002/03/27 14:58:08 swa +# can be used by mutilple targets +# +# Revision 1.35 2002/03/27 14:53:19 swa +# added solaris-dist +# +# Revision 1.34 2002/03/27 10:30:11 swa +# we want a html man file on the webserver +# +# Revision 1.33 2002/03/27 03:05:35 hal9 +# Added man2html target for docs (redhat-dok only for now) +# +# Revision 1.32 2002/03/26 22:29:54 swa +# we have a new homepage! +# +# Revision 1.31 2002/03/26 14:00:18 swa +# fixed make tarball, tarball-dist, tarball-clean +# +# Revision 1.30 2002/03/25 12:52:25 swa +# new targets +# +# Revision 1.29 2002/03/24 17:03:55 jongfoster +# Name change +# +# Revision 1.28 2002/03/24 16:19:48 swa +# configure needs to be generated. +# +# Revision 1.27 2002/03/24 16:13:57 swa +# generated files are a nono in cvs +# +# Revision 1.26 2002/03/24 15:36:02 swa +# did not build. +# +# Revision 1.25 2002/03/24 14:31:08 swa +# remove more crappy files. set RPM +# release version correctly. +# +# Revision 1.24 2002/03/24 14:19:55 swa +# set rpm package release in configure.in. nowhere else. +# +# Revision 1.23 2002/03/24 13:06:49 swa +# suse-clean now runs fine +# +# Revision 1.22 2002/03/24 12:56:21 swa +# name change related issues. +# +# Revision 1.21 2002/03/24 12:43:57 swa +# name change +# +# Revision 1.20 2002/03/24 11:39:17 jongfoster +# Renaming config files +# +# Revision 1.19 2002/03/22 20:53:03 morcego +# - Ongoing process to change name to JunkbusterNG +# - configure/configure.in: no change needed +# - GNUmakefile.in: +# - TAR_ARCH = /tmp/JunkbusterNG-$(RPM_VERSION).tar.gz +# - PROGRAM = jbng@EXEEXT@ +# - rh-spec now references as junkbusterng-rh.spec +# - redhat-upload: references changed to junkbusterng-* (package names) +# - tarball-dist: references changed to JunkbusterNG-distribution-* +# - tarball-src: now JunkbusterNG-* +# - install: initscript now junkbusterng.init and junkbusterng (when +# installed) +# - junkbuster-rh.spec: renamed to junkbusterng-rh.spec +# - junkbusterng.spec: +# - References to the expression ijb where changed where possible +# - New package name: junkbusterng (all in lower case, acording to +# the LSB recomendation) +# - Version changed to: 2.9.13 +# - Release: 1 +# - Added: junkbuster to obsoletes and conflicts (Not sure this is +# right. If it obsoletes, why conflict ? Have to check it later) +# - Summary changed: Stefan, please check and aprove it +# - Changes description to use the new name +# - Sed string was NOT changed. Have to wait to the manpage to +# change first +# - Keeping the user junkbuster for now. It will require some aditional +# changes on the script (scheduled for the next specfile release) +# - Added post entry to move the old logfile to the new log directory +# - Removing "chkconfig --add" entry (not good to have it automaticaly +# added to the startup list). +# - Added preun section to stop the service with the old name, as well +# as remove it from the startup list +# - Removed the chkconfig --del entry from the conditional block on +# the preun scriptlet (now handled on the %files section) +# - junkbuster.init: renamed to junkbusterng.init +# - junkbusterng.init: +# - Changed JB_BIN to jbng +# - Created JB_OBIN with the old value of JB_BIN (junkbuster), to +# be used where necessary (config dir) +# +# Aditional notes: +# - The config directory is /etc/junkbuster yet. Have to change it on the +# specfile, after it is changes on the code +# - The only files that got renamed on the cvs tree were the rh specfile and +# the init file. Some file references got changes on the makefile and on the +# rh-spec (as listed above) +# +# Revision 1.18 2002/03/21 23:00:00 swa +# want to autogenerate stuff. +# +# Revision 1.17 2002/03/19 19:30:04 morcego +# - Fixing stylesheet checking on configure. If it is found, no further checks +# should be done +# +# - configure will now check for db2html or docbook2html (should work now +# on SuSe without the docbktls package) +# +# Revision 1.16 2002/03/14 22:32:32 hal9 +# Bumped the RPM version. +# +# Revision 1.15 2002/03/08 20:00:28 swa +# some leftovers. +# +# Revision 1.14 2002/03/07 18:25:56 swa +# synced redhat and suse build process +# +# Revision 1.13 2002/03/07 17:17:56 oes +# (Hopefully) fixed for older make versions +# +# Revision 1.12 2002/03/07 15:28:27 swa +# more informative +# +# Revision 1.11 2002/03/06 14:33:18 sarantis +# Use proper temp file, not "abc". +# +# Revision 1.10 2002/03/06 14:19:35 sarantis +# Cleanup PID_FILE_PATH from redhat-dist target +# +# Revision 1.9 2002/03/05 17:31:11 morcego +# Search for docbook.dsl. Should solve portability problems for SuSe. +# +# Revision 1.8 2002/03/05 14:07:42 morcego +# configure now detects rpm topdir, and change GNUmakefile acordingly +# (based on sugestion by Sarantis Paskalis) +# +# Revision 1.7 2002/03/05 13:43:28 morcego +# Checking for text browser, so redhat-dok can work. +# +# Revision 1.6 2002/03/05 13:10:51 morcego +# Changes to implement redhat-dok (Hal Burgiss) +# Changes to make it work on other distros and out-of-the-shelf configurations +# +# Revision 1.5 2002/02/27 15:30:39 hal9 +# Reset $(RPM_PACKAGEV) to 1 (was 2) +# +# Revision 1.4 2002/01/17 21:44:04 jongfoster +# Adding urlmatch.[ch] +# +# Revision 1.3 2002/01/04 15:26:08 oes +# Added tarball-src target +# +# Revision 1.2 2001/12/30 14:07:31 steudten +# - Add signal handling (unix) +# - Add SIGHUP handler (unix) +# - Add creation of pidfile (unix) +# - Add action 'top' in rc file (RH) +# - Add entry 'SIGNALS' to manpage +# - Add exit message to logfile (unix) +# +# Revision 1.1 2001/12/01 11:22:57 jongfoster +# Renaming Makefile.in to GNUmakefile.in so that non-GNU versions of +# make break in a more obvious way. +# Adding .PHONY section. +# +# Revision 1.40 2001/12/01 00:24:11 jongfoster +# Renaming various config files +# Fixing CR->CRLF under Win32 (I hope) +# +# Revision 1.39 2001/11/06 12:07:30 steudten +# Add --clean for building rpm in target redhat-dist. +# +# Revision 1.38 2001/11/05 21:35:23 steudten +# Complete rewrite for the 'redhat-dist' target. +# Checks for writeable RPM build directories for calling user. +# So you must not be root, just set the modes to 1777 to +# build a RH package. +# Fix the upload-target to be arch independant. +# Add target for 'solaris-dist' - coming soon. +# +# Revision 1.37 2001/11/01 00:52:04 hal9 +# Redhat-upload stuff per Stefan. +# +# Revision 1.36 2001/10/31 19:26:13 swa +# automate process of uploading new releases +# to sf. +# +# Revision 1.35 2001/10/15 22:14:59 joergs +# Removed -O2 and -Wall from AmigaOS-only CFLAGS since they are now in +# the general CFLAGS already. +# +# Revision 1.34 2001/10/15 18:28:06 steudten +# remove config.cache for target clobber. +# Cleanup make dist for RH and S.u.S.E. +# +# Revision 1.33 2001/10/10 12:43:33 oes +# Added ugly hack to make install target work at least for some setups. +# +# Revision 1.32 2001/10/09 22:38:19 jongfoster +# Correcting actionsfile filename for Win32 INI build +# +# Revision 1.31 2001/09/23 10:13:48 swa +# upload process established. run make webserver and +# the documentation is moved to the webserver. documents +# are now linked correctly. +# +# Revision 1.30 2001/09/19 17:55:49 oes +# Fixed CFLAGS +# +# Revision 1.29 2001/09/16 17:34:27 jongfoster +# Removing showargs.[ch], adding cgi(simple|edit).[ch] +# Replacing $(OBJEXT) with @OBJEXT@ - this seems to be a common source +# of build problems. +# +# Revision 1.28 2001/09/13 15:19:08 swa +# we want text files as well. +# +# Revision 1.27 2001/09/13 13:11:37 steudten +# +# Replace DEBUG_CFLAGS with OTHER_CFLAGS +# +# Revision 1.26 2001/09/12 23:44:54 david__schmidt +# Mac OSX (Darwin) support added. +# +# Revision 1.25 2001/09/12 22:55:45 joergs +# AmigaOS support added. +# +# Revision 1.24 2001/09/12 17:28:59 david__schmidt +# +# OS/2 port: update autoconf'd support for the platform. +# +# Revision 1.23 2001/09/12 16:28:42 swa +# added "make dok" section to generate html pages from +# the sgml source documents. note that the we do not want +# generated stuff in cvs. +# +# Revision 1.22 2001/09/10 16:31:23 swa +# buildroot definition in the specfile fucks up the build +# process under suse. hence I moved it to the "rpm -ta" +# command +# +# Revision 1.21 2001/09/10 11:12:49 oes +# Turning on -Wall +# +# Revision 1.20 2001/08/02 22:04:29 jongfoster +# Removing some remaining references to obsolete w32rulesdlg.[ch] +# +# Revision 1.19 2001/07/30 22:14:03 jongfoster +# Removing obsolete w32rulesdlg.c and w32rulesdlg.h +# +# Revision 1.18 2001/07/29 17:09:17 jongfoster +# Major changes to build system in order to fix these bugs: +# - pthreads under Linux was broken - changed -lpthread to -pthread +# - Compiling in MinGW32 mode under CygWin now correctly detects +# which shared libraries are available +# - Solaris support (?) (Not tested under Solaris yet) +# +# Revision 1.17 2001/07/28 16:44:54 oes +# Fixed sed LF->CRLF conversion and removed deprecated files +# +# Revision 1.16 2001/07/15 19:45:33 jongfoster +# Added support for linking with POSIX threads library +# +# Revision 1.15 2001/07/13 13:48:07 oes +# - Moved STATIC #define for pcre to (ac)config.h +# - Made -Ipcre depandant on static pcre compilation to +# avoid version conflicts +# - Included compilation and depandancies for new deanimate.c +# - Made changes to the pcre/pcreposix/pcrs build process +# as required by the new library autodetection in +# configure.in +# +# Revision 1.14 2001/07/01 16:27:44 oes +# Fixed misplaced dependancy +# +# Revision 1.13 2001/06/29 13:18:36 oes +# - added depandancy of filters.o on cgi.h +# +# Revision 1.12 2001/06/12 17:15:56 swa +# fixes, because a clean build on rh6.1 was impossible. +# GZIP confuses make, %configure confuses rpm, etc. +# +# Revision 1.11 2001/06/11 11:26:35 sarantis +# RPM version should be the same as ijbswa version. The rpm release is +# specified in the specfile. +# +# Revision 1.10 2001/06/07 17:27:45 swa +# added suse build section +# +# Revision 1.9 2001/06/04 18:31:58 swa +# files are now prefixed with either `confdir' or `logdir'. +# `make redhat-dist' replaces both entries confdir and logdir +# with redhat values +# +# Revision 1.8 2001/06/04 10:44:57 swa +# `make redhatr-dist' now works. Except for the paths +# in the config file. +# +# Revision 1.7 2001/06/03 17:09:09 swa +# swa for oes: reversed my earlier change +# +# Revision 1.6 2001/06/03 17:07:27 swa +# swa for oes +# +# Revision 1.5 2001/06/03 13:57:26 swa +# compile cgi.c (for andreas' GUI) +# +# Revision 1.4 2001/05/31 21:18:45 jongfoster +# Added files actions.[ch], actionlist.h, list.[ch] to Makefile +# +# Revision 1.3 2001/05/29 20:02:48 joergs +# Changes for AmigaOS added. +# +# Revision 1.2 2001/05/17 22:23:23 oes +# - Added auto-generation of CRLFs for Win32 config files +# - Added comment-prefix to all Win32-only options in the config file +# and provided auto stripping of this prefix for the Win32 platform by make +# +# Revision 1.1.1.1 2001/05/15 13:59:00 oes +# Initial import of version 2.9.3 source tree +# +# diff --git a/external/privoxy/INSTALL b/external/privoxy/INSTALL index 618dede..f17eadb 100644 --- a/external/privoxy/INSTALL +++ b/external/privoxy/INSTALL @@ -8,10 +8,10 @@ * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -26,8 +26,8 @@ * The GNU General Public License should be included with * this file. If not, you can view it at * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html - * or write to the Free Software Foundation, Inc., - * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, + * or write to the Free Software Foundation, Inc., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, * USA * *********************************************************************/ @@ -40,8 +40,9 @@ compiler like gcc are required.
When building from a source tarball, first unpack the source:
- tar xzvf privoxy-3.0.19-stable-src.tar.gz - cd privoxy-3.0.19-stable + tar xzvf privoxy-3.0.12-stable-src.tar.gz + cd privoxy-3.0.12-stable +
For retrieving the current CVS sources, you'll need a CVS client installed. Note that sources from CVS are typically development quality, and may not be @@ -52,6 +53,7 @@ documentation, which might give commands like: cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co current cd current
+ This will create a directory named current/, which will contain the source tree.
@@ -68,10 +70,12 @@ adduser, but the command syntax may vary from platform to platform).
privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell
+ And then /etc/group, like:
privoxy:*:7777:
+ Some binary packages may do this for you.
Then, to build from either unpacked tarball or CVS source: @@ -84,11 +88,13 @@ Then, to build from either unpacked tarball or CVS source: make -n install # (to see where all the files will go) make -s install # (to really install, -s to silence output)
+ Using GNU make, you can have the first four steps automatically done for you by just typing:
make
+ in the freshly downloaded or unpacked source directory.
To build an executable with security enhanced features so that users cannot @@ -97,6 +103,7 @@ configurations, configure like this:
./configure --disable-toggle --disable-editor --disable-force
+ Then build as above. In Privoxy 3.0.7 and later, all of these options can also be disabled through the configuration file.
@@ -117,6 +124,7 @@ sure both already exist:
make -s install USER=privoxy GROUP=privoxy
+ The default installation path for make install is /usr/local. This may of course be customized with the various ./configure path options. If you are doing an install to anywhere besides /usr/local, be sure to set the appropriate diff --git a/external/privoxy/README b/external/privoxy/README index 6ba2f1e..a145e81 100644 --- a/external/privoxy/README +++ b/external/privoxy/README @@ -4,14 +4,14 @@ * * Purpose : README file to give a short intro. * - * Copyright : Written by and Copyright (C) 2001-2011 the + * Copyright : Written by and Copyright (C) 2001-2009 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -26,13 +26,13 @@ * The GNU General Public License should be included with * this file. If not, you can view it at * http://www.gnu.org/copyleft/gpl.html - * or write to the Free Software Foundation, Inc., - * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, + * or write to the Free Software Foundation, Inc., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, * USA * *********************************************************************/
-This README is included with Privoxy 3.0.19. See http://www.privoxy.org/ for +This README is included with Privoxy 3.0.12. See http://www.privoxy.org/ for more information. The current code maturity level is "stable".
------------------------------------------------------------------------------- @@ -44,22 +44,36 @@ flexible configuration and can be customized to suit individual needs and tastes. It has application for both stand-alone systems and multi-user networks.
-Privoxy is Free Software and licensed under the GNU GPLv2. +Privoxy is Free Software and licensed under the GPL2.
Privoxy is an associated project of Software in the Public Interest (SPI). +Donations are welcome.
-Helping hands and donations are welcome: +-------------------------------------------------------------------------------
- * http://www.privoxy.org/faq/general.html#PARTICIPATE +1. IMPORTANT CHANGES
- * http://www.privoxy.org/faq/general.html#DONATE +March 2009, Privoxy 3.0.12 is released.
-------------------------------------------------------------------------------- +This is primarily a bug fix release. See the "ChangeLog", and the "What's New" +section and the "Upgrader's Notes" in the User Manual for details. + +February 2009, Privoxy 3.0.11 is released. + +As usual there are changes that effect the configuration. See the "ChangeLog", +and the "What's New" section and the "Upgrader's Notes" in the User Manual for +details and specifics.
-1. CHANGES +This is a stable release, and marks a departure for Privoxy development.
-For a list of changes in this release, please have a look at the "ChangeLog", -the "What's New" section or the "Upgrader's Notes" in the User Manual. +Previously, odd numbered releases were considered beta versions and were only +released at the end of the development cycle when the code was already believed +to be stable. Usually it was, so the stable release contained pretty much the +same code, but got a higher version number. In the future we intend to release +several snapshots between stable releases. There will probably still be about +two stable releases per year, but hopefully about six snapshots instead of the +two betas we have now. The intentions is to make testing without CVS access +easier.
-------------------------------------------------------------------------------
@@ -82,6 +96,10 @@ If no config_file is specified on the command line, Privoxy will look for a file named 'config' in the current directory (except Win32 which will look for 'config.txt'). If no config_file is found, Privoxy will fail to start.
+Or for Red Hat and Fedora based distributions: /etc/rc.d/init.d/privoxy start + +Or Debian and Ubuntu: /etc/init.d/privoxy start + -------------------------------------------------------------------------------
4. CONFIGURATION @@ -98,7 +116,7 @@ www.privoxy.org/user-manual/.
Be sure to set your browser(s) for HTTP/HTTPS Proxy at <IP>:<Port>, or whatever you specify in the config file under 'listen-address'. DEFAULT is -127.0.0.1:8118. Note that Privoxy ONLY proxies HTTP (and HTTPS) traffic. Do not +localhost:8118. Note that Privoxy ONLY proxies HTTP (and HTTPS) traffic. Do not try it with FTP or other protocols for the simple reason it does not work.
The actions list can be configured via the web interface accessed via http:// @@ -140,13 +158,6 @@ list, where the developers also hang around. Please don't sent private support requests to individual Privoxy developers, either use the mailing lists or the support trackers.
-If you have to contact a Privoxy developer directly for other reasons, please -send a real mail and do not bother with SourceForge's messaging system. Answers -to SourceForge messages are usually bounced by SourceForge's mail server in -which case the developer wasted time writing a response you don't get. From -your point of view it will look like your message has been completely ignored, -so this is frustrating for all parties involved. - Note that the Privoxy mailing lists are moderated. Posts from unsubscribed addresses have to be accepted manually by a moderator. This may cause a delay of several days and if you use a subject that doesn't clearly mention Privoxy @@ -235,49 +246,16 @@ Please be sure to provide the following information:
* Any other pertinent information to help identify the problem such as config or log file excerpts (yes, you should have log file entries for each action - taken). To get a meaningful logfile, please make sure that the logfile - directive is being used and the following debug options are enabled: + taken).
- debug 1 # Log the destination for each request Privoxy let through. See also debug 1024. - debug 2 # show each connection status - debug 4 # show I/O status - debug 8 # show header parsing - debug 128 # debug redirects - debug 256 # debug GIF de-animation - debug 512 # Common Log Format - debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why. - debug 4096 # Startup banner and warnings. - debug 8192 # Non-fatal errors - - If you are having trouble with a filter, please additionally enable - - debug 64 # debug regular expression filters - - If you are using Privoxy 3.0.17 or later and suspect that it interprets the - request or the response incorrectly, please enable - - debug 32768 # log all data read from the network - - Note that Privoxy log files may contain sensitive information so please - don't submit any logfiles you didn't read first. You can mask sensitive - information as long as it's clear that you removed something. - -You don't have to tell us your actual name when filing a problem report, but if -you don't, please use a nickname so we can differentiate between your messages -and the ones entered by other "anonymous" users that may respond to your -request if they have the same problem or already found a solution. Note that -due to spam the trackers may not always allow to post without being logged into -SourceForge. If that's the case, you are still free to create a login that -isn't directly linked to your name, though. +You don't have to tell us your actual name when filing a problem report, but +please use a nickname so we can differentiate between your messages and the +ones entered by other "anonymous" users that may respond to your request if +they have the same problem or already found a solution.
Please also check the status of your request a few days after submitting it, as we may request additional information. If you use a SF id, you should -automatically get a mail when someone responds to your request. Please don't -bother to add an email address when using the tracker. If you prefer to -communicate through email, just use one of the mailing lists directly. - -If you are new to reporting problems, you might be interested in How to Report -Bugs Effectively. +automatically get a mail when someone responds to your request.
The appendix of the Privoxy User Manual also has helpful information on understanding actions, and action debugging. @@ -292,13 +270,11 @@ tracker/?atid=361118&group_id=11118.
-------------------------------------------------------------------------------
-6.4. Mailing Lists +6.4. Other
-If you prefer to communicate through email, instead of using a web interface, -feel free to use one of the mailing lists. To discuss issues that haven't been -completely diagnosed yet, please use the Privoxy users list. Technically -interested users and people who wish to contribute to the project are always -welcome on the developers list. You can find an overview of all Privoxy-related +For any other issues, feel free to use the mailing lists. Technically +interested users and people who wish to contribute to the project are also +welcome on the developers list! You can find an overview of all Privoxy-related mailing lists, including list archives, at: http://sourceforge.net/mail/? group_id=11118.
diff --git a/external/privoxy/acconfig.h b/external/privoxy/acconfig.h index 29e9539..ea2792d 100644 --- a/external/privoxy/acconfig.h +++ b/external/privoxy/acconfig.h @@ -5,19 +5,19 @@ * File : $Source: /cvsroot/ijbswa/current/acconfig.h,v $ * * Purpose : This file should be the first thing included in every - * .c file. (Before even system headers). It contains + * .c file. (Before even system headers). It contains * #define statements for various features. It was * introduced because the compile command line started * getting ludicrously long with feature defines. * - * Copyright : Written by and Copyright (C) 2001-2009 the + * Copyright : Written by and Copyright (C) 2001 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -35,8 +35,211 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: acconfig.h,v $ + * Revision 1.36 2008/10/18 11:17:52 fabiankeil + * Connection keep-alive support is ready for testing, + * allow enabling it through the configure script. + * + * Revision 1.35 2008/04/06 15:18:33 fabiankeil + * Oh well, rename the --enable-pcre-host-patterns option to + * --enable-extended-host-patterns as it's not really PCRE syntax. + * + * Revision 1.34 2008/04/06 14:54:26 fabiankeil + * Use PCRE syntax in host patterns when configured + * with --enable-pcre-host-patterns. + * + * Revision 1.33 2006/12/17 19:15:26 fabiankeil + * Added ./configure switch for FEATURE_GRACEFUL_TERMINATION. + * + * Revision 1.32 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.27.2.4 2003/12/17 16:34:40 oes + * Cosmetics + * + * Revision 1.27.2.3 2003/03/27 16:03:19 oes + * Another shot at Bug #707467 + * + * Revision 1.27.2.2 2003/03/21 14:39:12 oes + * Presumably fixed Bug #707467 by defining unix ifdef __unix__ + * + * Revision 1.27.2.1 2002/08/10 11:22:31 oes + * - Add two AC_DEFINEs that indicate if the pcre*.h headers + * are located in a pcre/ subdir to the include path. + * + * Revision 1.27 2002/04/25 19:13:57 morcego + * Removed RPM release number declaration on configure.in + * Changed makefile to use given value for RPM_PACKAGEV when on uploading + * targets (will produce an error, explaining who to do it, if no value + * if provided). + * + * Revision 1.26 2002/04/11 11:00:21 oes + * Applied Moritz' fix for socklen_t on Solaris + * + * Revision 1.25 2002/04/06 20:38:01 jongfoster + * Renaming VC++ versions of config.h + * + * Revision 1.24 2002/04/04 00:36:36 gliptak + * always use pcre for matching + * + * Revision 1.23 2002/04/03 22:28:03 gliptak + * Removed references to gnu_regex + * + * Revision 1.22 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.21 2002/03/24 14:31:08 swa + * remove more crappy files. set RPM + * release version correctly. + * + * Revision 1.20 2002/03/24 13:46:44 swa + * name change related issue. + * + * Revision 1.19 2002/03/24 13:25:42 swa + * name change related issues + * + * Revision 1.18 2002/03/08 16:40:28 oes + * Added FEATURE_NO_GIFS + * + * Revision 1.17 2002/03/04 17:52:44 oes + * Deleted PID_FILE_PATH + * + * Revision 1.16 2002/01/10 12:36:18 oes + * Moved HAVE_*_R to acconfig.h, where they belong. + * + * Revision 1.15 2001/12/30 14:07:31 steudten + * - Add signal handling (unix) + * - Add SIGHUP handler (unix) + * - Add creation of pidfile (unix) + * - Add action 'top' in rc file (RH) + * - Add entry 'SIGNALS' to manpage + * - Add exit message to logfile (unix) + * + * Revision 1.14 2001/10/23 21:24:09 jongfoster + * Support for FEATURE_CGI_EDIT_ACTIONS + * + * Revision 1.13 2001/10/07 15:30:41 oes + * Removed FEATURE_DENY_GZIP + * + * Revision 1.12 2001/09/13 19:56:37 jongfoster + * Reverting to revision 1.10 - previous checking was majorly broken. + * + * Revision 1.10 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.9 2001/07/29 19:08:52 jongfoster + * Changing _CONFIG_H to CONFIG_H_INCLUDED. + * Also added protection against using a MinGW32 or CygWin version of + * config.h from within MS Visual C++ + * + * Revision 1.8 2001/07/29 17:09:17 jongfoster + * Major changes to build system in order to fix these bugs: + * - pthreads under Linux was broken - changed -lpthread to -pthread + * - Compiling in MinGW32 mode under CygWin now correctly detects + * which shared libraries are available + * - Solaris support (?) (Not tested under Solaris yet) + * + * Revision 1.7 2001/07/25 22:53:59 jongfoster + * Will #error if pthreads is enabled under BeOs + * + * Revision 1.6 2001/07/15 17:54:29 jongfoster + * Renaming #define STATIC to STATIC_PCRE + * Adding new #define FEATURE_PTHREAD that will be used to enable + * POSIX threads support. + * + * Revision 1.5 2001/07/13 13:48:37 oes + * - (Fix:) Copied CODE_STATUS #define from config.h.in + * - split REGEX #define into REGEX_GNU and REGEX_PCRE + * and removed PCRE. + * (REGEX = REGEX_GNU || REGEX_PCRE per project.h) + * - Moved STATIC (for pcre) here from Makefile.in + * - Introduced STATIC_PCRS #define to allow for dynaimc linking with + * libpcrs + * - Removed PCRS #define, since pcrs is now needed for CGI anyway + * + * Revision 1.4 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.3 2001/05/26 01:26:34 jongfoster + * New #define, WIN_GUI_EDIT, enables the (embryonic) Win32 GUI editor. + * This #define cannot be set from ./configure - there's no point, it + * doesn't work yet. See feature request # 425722 + * + * Revision 1.2 2001/05/22 17:43:35 oes + * + * - Enabled filtering banners by size rather than URL + * by adding patterns that replace all standard banner + * sizes with the "Junkbuster" gif to the re_filterfile + * + * - Enabled filtering WebBugs by providing a pattern + * which kills all 1x1 images + * + * - Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * - Added a new interceptor ijb-send-banner, which + * sends back the "Junkbuster" gif. Without imagelist or + * MSIE detection support, or if tinygif = 1, or the + * URL isn't recognized as an imageurl, a lame HTML + * explanation is sent instead. + * + * - Added new feature, which permits blocking remote + * script redirects and firing back a local redirect + * to the browser. + * The feature is conditionally compiled, i.e. it + * can be disabled with --disable-fast-redirects, + * plus it must be activated by a "fast-redirects" + * line in the config file, has its own log level + * and of course wants to be displayed by show-proxy-args + * Note: Boy, all the #ifdefs in 1001 locations and + * all the fumbling with configure.in and acconfig.h + * were *way* more work than the feature itself :-( + * + * - Because a generic redirect template was needed for + * this, tinygif = 3 now uses the same. + * + * - Moved GIFs, and other static HTTP response templates + * to project.h + * + * - Many minor fixes + * + * - Removed some >400 CRs again (Jon, you really worked + * a lot! ;-) + * + * Revision 1.1.1.1 2001/05/15 13:58:45 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - + @TOP@
/* @@ -64,7 +267,7 @@ */ #undef CODE_STATUS
-/* +/* * Should pcre be statically built in instead of linkling with libpcre? * (This is determined by configure depending on the availiability of * libpcre and user preferences). The name is ugly, but pcre needs it. @@ -72,7 +275,7 @@ */ #undef STATIC_PCRE
-/* +/* * Should pcrs be statically built in instead of linkling with libpcrs? * (This is determined by configure depending on the availiability of * libpcrs and user preferences). @@ -86,11 +289,6 @@ #undef FEATURE_ACL
/* - * Allow Privoxy to use accf_http(9) if supported. - */ -#undef FEATURE_ACCEPT_FILTER - -/* * Enables the web-based configuration (actionsfile) editor. If you * have a shared proxy, you might want to turn this off. */ @@ -136,14 +334,14 @@ * User-Agent: Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 5.0) * Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, * / * * - * And no, I haven't got that backwards - IE is being weird. + * And no, I haven't got that backwards - IE is being wierd. * - * Known limitations: + * Known limitations: * 1) If you press shift-reload on a blocked HTML page, you get * the image "blocked" page, not the HTML "blocked" page. - * 2) Once an image "blocked" page has been sent, viewing it + * 2) Once an image "blocked" page has been sent, viewing it * in it's own browser window *should* bring up the HTML - * "blocked" page, but it doesn't. You need to clear the + * "blocked" page, but it doesn't. You need to clear the * browser cache to get the HTML version again. * * These limitations are due to IE making inconsistent choices @@ -152,6 +350,11 @@ #undef FEATURE_IMAGE_DETECT_MSIE
/* + * Kills JavaScript popups - window.open, onunload, etc. + */ +#undef FEATURE_KILL_POPUPS + +/* * Use PNG instead of GIF for built-in images */ #undef FEATURE_NO_GIFS @@ -167,16 +370,11 @@ #undef FEATURE_EXTENDED_HOST_PATTERNS
/* - * Keep connections alive if possible. + * Keep outgoing connections alive if possible. */ #undef FEATURE_CONNECTION_KEEP_ALIVE
/* - * Allow to share outgoing connections between incoming connections. - */ -#undef FEATURE_CONNECTION_SHARING - -/* * Use POSIX threads instead of native threads. */ #undef FEATURE_PTHREAD @@ -237,7 +435,7 @@ #undef HAVE_GMTIME_R #undef HAVE_LOCALTIME_R
-/* Define to 'int' if <sys/socket.h> doesn't have it. +/* Define to 'int' if <sys/socket.h> doesn't have it. */ #undef socklen_t
@@ -287,7 +485,7 @@
/* * It's too easy to accidentally use a Cygwin or MinGW32 version of config.h - * under VC++, and it usually gives many weird error messages. Let's make + * under VC++, and it usually gives many wierd error messages. Let's make * the error messages understandable, by bailing out now. */ #ifdef _MSC_VER diff --git a/external/privoxy/actionlist.h b/external/privoxy/actionlist.h index 922b607..339c878 100644 --- a/external/privoxy/actionlist.h +++ b/external/privoxy/actionlist.h @@ -12,14 +12,14 @@ * DEFINE_ACTION_BOOL() * DEFINE_ACTION_ALIAS * - * Copyright : Written by and Copyright (C) 2001-2008 the + * Copyright : Written by and Copyright (C) 2001-2008 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -37,8 +37,156 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: actionlist.h,v $ + * Revision 1.36 2008/09/20 10:04:33 fabiankeil + * Remove hide-forwarded-for-headers action which has + * been obsoleted by change-x-forwarded-for{block}. + * + * Revision 1.35 2008/09/19 15:43:54 fabiankeil + * Fix sorting. + * + * Revision 1.34 2008/09/19 15:26:28 fabiankeil + * Add change-x-forwarded-for{} action to block or add + * X-Forwarded-For headers. Mostly based on code removed + * before 3.0.7. + * + * Revision 1.33 2008/03/29 12:13:45 fabiankeil + * Remove send-wafer and send-vanilla-wafer actions. + * + * Revision 1.32 2008/03/28 15:13:42 fabiankeil + * Remove inspect-jpegs action. + * + * Revision 1.31 2008/03/27 18:27:20 fabiankeil + * Remove kill-popups action. + * + * Revision 1.30 2008/03/04 18:30:34 fabiankeil + * Remove the treat-forbidden-connects-like-blocks action. We now + * use the "blocked" page for forbidden CONNECT requests by default. + * + * Revision 1.29 2008/03/01 14:00:43 fabiankeil + * Let the block action take the reason for the block + * as argument and show it on the "blocked" page. + * + * Revision 1.28 2007/12/11 21:08:29 fabiankeil + * Let the CGI editor suggest a forward-override + * parameter whose syntax is actually valid. + * + * Revision 1.27 2007/11/10 15:04:08 fabiankeil + * Tell the CGI editor about +hide-referrer{conditional-forge}. + * + * Revision 1.26 2007/06/01 16:54:28 fabiankeil + * Add forward-override{} to change the forwarding settings through + * action sections. This is mainly interesting to forward different + * clients differently (for example based on User-Agent or request + * origin). + * + * Revision 1.25 2007/04/15 16:39:20 fabiankeil + * Introduce tags as alternative way to specify which + * actions apply to a request. At the moment tags can be + * created based on client and server headers. + * + * Revision 1.24 2007/03/20 15:16:34 fabiankeil + * Use dedicated header filter actions instead of abusing "filter". + * Replace "filter-client-headers" and "filter-client-headers" + * with "server-header-filter" and "client-header-filter". + * + * Revision 1.23 2006/10/09 10:26:18 fabiankeil + * Changed the path in set-image-blocker's redirection default to + * "send-banner?type=pattern" instead of "show-banner?type=pattern" + * which isn't caught by Privoxy. Fixes BR 1573468. + * + * Changed hide-user-agent's default value to "Privoxy VERSION". + * + * Changed hide-referrer's default fake value to "http://www.privoxy.org/". + * A static referrer is obviously fake anyway, so we might as well + * advertise ourselves. + * + * Revision 1.22 2006/09/01 17:14:18 hal9 + * Re-ordered the actions list so that they display in the actions editor in + * alphabetical order. Some of the new actions were "out of order". + * + * Revision 1.21 2006/08/14 08:25:19 fabiankeil + * Split filter-headers{} into filter-client-headers{} + * and filter-server-headers{}. + * Added parse_header_time() to share some code. + * Replaced timegm() with mktime(). + * + * Revision 1.20 2006/08/03 02:46:41 david__schmidt + * Incorporate Fabian Keil's patch work:http://www.fabiankeil.de/sourcecode/privoxy/ + * + * Revision 1.19 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.17.2.3 2004/10/03 12:53:32 david__schmidt + * Add the ability to check jpeg images for invalid + * lengths of comment blocks. Defensive strategy + * against the exploit: + * Microsoft Security Bulletin MS04-028 + * Buffer Overrun in JPEG Processing (GDI+) Could + * Allow Code Execution (833987) + * Enabled with +inspect-jpegs in actions files. + * + * Revision 1.17.2.2 2002/09/25 15:25:25 oes + * Added more aliases for prehistoric action names + * + * Revision 1.17.2.1 2002/08/02 12:50:47 oes + * Consistency with docs: Change default name for action from hide-referer to hide-referrer + * + * Revision 1.17 2002/05/14 21:25:55 oes + * Renamed prevent-(setting/reading)-cookies to crunch-(incoming/outgoing)-cookies + * + * Revision 1.16 2002/04/24 02:15:18 oes + * Renamed actions as discussed, Aliased old action names to new ones. + * + * Revision 1.15 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.14 2002/03/24 16:32:08 jongfoster + * Removing logo option + * + * Revision 1.13 2002/03/24 15:23:33 jongfoster + * Name changes + * + * Revision 1.12 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.11 2002/03/12 01:42:49 oes + * Introduced modular filters + * + * Revision 1.10 2002/03/08 18:19:14 jongfoster + * Adding +image-blocker{pattern} option to edit interface + * + * Revision 1.9 2001/11/22 21:58:41 jongfoster + * Adding action +no-cookies-keep + * + * Revision 1.8 2001/10/10 16:42:52 oes + * Fixed a bug, Added +limit-connect string action + * + * Revision 1.7 2001/10/07 15:33:59 oes + * Introduced a +no-compression action + * Introduced a +downgrade action + * + * Revision 1.6 2001/09/16 15:47:37 jongfoster + * First version of CGI-based edit interface. This is very much a + * work-in-progress, and you can't actually use it to edit anything + * yet. You must #define FEATURE_CGI_EDIT_ACTIONS for these changes + * to have any effect. + * + * Revision 1.5 2001/07/18 12:27:03 oes + * Changed deanimate-gifs to string action + * + * Revision 1.4 2001/07/13 13:52:12 oes + * - Formatting + * - Introduced new action ACTION_DEANIMATE + * + * Revision 1.3 2001/06/07 23:03:56 jongfoster + * Added standard comment at top of file. + * + * *********************************************************************/ - +
#if !(defined(DEFINE_ACTION_BOOL) && defined(DEFINE_ACTION_MULTI) && defined(DEFINE_ACTION_STRING)) #error Please define lots of macros before including "actionlist.h". @@ -71,11 +219,9 @@ DEFINE_ACTION_STRING ("deanimate-gifs", ACTION_DEANIMATE, DEFINE_CGI_PARAM_RADIO ("deanimate-gifs", ACTION_DEANIMATE, ACTION_STRING_DEANIMATE, "first", 0) DEFINE_CGI_PARAM_RADIO ("deanimate-gifs", ACTION_DEANIMATE, ACTION_STRING_DEANIMATE, "last", 1) DEFINE_ACTION_BOOL ("downgrade-http-version", ACTION_DOWNGRADE) -#ifdef FEATURE_FAST_REDIRECTS DEFINE_ACTION_STRING ("fast-redirects", ACTION_FAST_REDIRECTS, ACTION_STRING_FAST_REDIRECTS) DEFINE_CGI_PARAM_RADIO ("fast-redirects", ACTION_FAST_REDIRECTS, ACTION_STRING_FAST_REDIRECTS, "simple-check", 0) DEFINE_CGI_PARAM_RADIO ("fast-redirects", ACTION_FAST_REDIRECTS, ACTION_STRING_FAST_REDIRECTS, "check-decoded-url", 1) -#endif /* def FEATURE_FAST_REDIRECTS */ DEFINE_ACTION_MULTI ("filter", ACTION_MULTI_FILTER) DEFINE_ACTION_BOOL ("force-text-mode", ACTION_FORCE_TEXT_MODE) DEFINE_ACTION_STRING ("forward-override", ACTION_FORWARD_OVERRIDE, ACTION_STRING_FORWARD_OVERRIDE) @@ -121,19 +267,19 @@ DEFINE_CGI_PARAM_CUSTOM ("set-image-blocker", ACTION_IMAGE_BLOCKER,
#if DEFINE_ACTION_ALIAS
-/* +/* * Alternative spellings */ DEFINE_ACTION_STRING ("hide-referer", ACTION_HIDE_REFERER, ACTION_STRING_REFERER) DEFINE_ACTION_BOOL ("prevent-keeping-cookies", ACTION_NO_COOKIE_KEEP)
-/* +/* * Pre-3.0.7 (pseudo) compatibility */ DEFINE_ACTION_MULTI ("filter-client-headers", ACTION_MULTI_CLIENT_HEADER_FILTER) DEFINE_ACTION_MULTI ("filter-server-headers", ACTION_MULTI_SERVER_HEADER_FILTER)
-/* +/* * Pre-3.0 compatibility */ DEFINE_ACTION_BOOL ("no-cookie-read", ACTION_NO_COOKIE_READ) diff --git a/external/privoxy/actions.c b/external/privoxy/actions.c index 2f2895c..172085f 100644 --- a/external/privoxy/actions.c +++ b/external/privoxy/actions.c @@ -1,4 +1,4 @@ -const char actions_rcs[] = "$Id: actions.c,v 1.73 2011/09/18 14:43:07 fabiankeil Exp $"; +const char actions_rcs[] = "$Id: actions.c,v 1.56 2009/03/08 14:19:21 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/actions.c,v $ @@ -6,7 +6,7 @@ const char actions_rcs[] = "$Id: actions.c,v 1.73 2011/09/18 14:43:07 fabiankeil * Purpose : Declares functions to work with actions files * Functions declared include: FIXME * - * Copyright : Written by and Copyright (C) 2001-2011 the + * Copyright : Written by and Copyright (C) 2001-2008 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written @@ -31,8 +31,259 @@ const char actions_rcs[] = "$Id: actions.c,v 1.73 2011/09/18 14:43:07 fabiankeil * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: actions.c,v $ + * Revision 1.56 2009/03/08 14:19:21 fabiankeil + * Fix justified (but harmless) compiler warnings + * on platforms where sizeof(int) < sizeof(long). + * + * Revision 1.55 2008/12/04 18:18:56 fabiankeil + * Fix some cparser warnings. + * + * Revision 1.54 2008/09/20 10:04:33 fabiankeil + * Remove hide-forwarded-for-headers action which has + * been obsoleted by change-x-forwarded-for{block}. + * + * Revision 1.53 2008/05/26 16:04:04 fabiankeil + * s@memorey@memory@ + * + * Revision 1.52 2008/04/27 16:26:59 fabiankeil + * White space fix for the last commit. + * + * Revision 1.51 2008/04/27 16:20:19 fabiankeil + * Complain about every block action without reason found. + * + * Revision 1.50 2008/03/30 14:52:00 fabiankeil + * Rename load_actions_file() and load_re_filterfile() + * as they load multiple files "now". + * + * Revision 1.49 2008/03/29 12:13:45 fabiankeil + * Remove send-wafer and send-vanilla-wafer actions. + * + * Revision 1.48 2008/03/28 18:17:14 fabiankeil + * In action_used_to_be_valid(), loop through an array of formerly + * valid actions instead of using an OR-chain of strcmpic() calls. + * + * Revision 1.47 2008/03/28 15:13:37 fabiankeil + * Remove inspect-jpegs action. + * + * Revision 1.46 2008/03/27 18:27:20 fabiankeil + * Remove kill-popups action. + * + * Revision 1.45 2008/03/24 11:21:02 fabiankeil + * Share the action settings for multiple patterns in the same + * section so we waste less memory for gigantic block lists + * (and load them slightly faster). Reported by Franz Schwartau. + * + * Revision 1.44 2008/03/04 18:30:34 fabiankeil + * Remove the treat-forbidden-connects-like-blocks action. We now + * use the "blocked" page for forbidden CONNECT requests by default. + * + * Revision 1.43 2008/03/01 14:00:43 fabiankeil + * Let the block action take the reason for the block + * as argument and show it on the "blocked" page. + * + * Revision 1.42 2008/02/09 15:15:38 fabiankeil + * List active and inactive actions in the show-url-info's + * "Final results" section separately. Patch submitted by Lee + * in #1830056, modified to list active actions first. + * + * Revision 1.41 2008/01/28 20:17:40 fabiankeil + * - Mark some parameters as immutable. + * - Hide update_action_bits_for_all_tags() while it's unused. + * + * Revision 1.40 2007/05/21 10:26:50 fabiankeil + * - Use strlcpy() instead of strcpy(). + * - Provide a reason why loading the actions + * file might have failed. + * + * Revision 1.39 2007/04/17 18:21:45 fabiankeil + * Split update_action_bits() into + * update_action_bits_for_all_tags() + * and update_action_bits_for_tag(). + * + * Revision 1.38 2007/04/15 16:39:20 fabiankeil + * Introduce tags as alternative way to specify which + * actions apply to a request. At the moment tags can be + * created based on client and server headers. + * + * Revision 1.37 2007/03/11 15:56:12 fabiankeil + * Add kludge to log unknown aliases and actions before exiting. + * + * Revision 1.36 2006/12/28 17:15:42 fabiankeil + * Fix gcc43 conversion warning. + * + * Revision 1.35 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.32.2.6 2006/01/29 23:10:56 david__schmidt + * Multiple filter file support + * + * Revision 1.32.2.5 2005/06/09 01:18:41 david__schmidt + * Tweaks to conditionally include pthread.h if FEATURE_PTHREAD is enabled - + * this becomes important when jcc.h gets included later down the line. + * + * Revision 1.32.2.4 2003/12/03 10:33:11 oes + * - Implemented Privoxy version requirement through + * for-privoxy-version= statement in {{settings}} + * block + * - Fix for unchecked out-of-memory condition + * + * Revision 1.32.2.3 2003/02/28 12:52:10 oes + * Fixed memory leak reported by Dan Price in Bug #694713 + * + * Revision 1.32.2.2 2002/11/20 14:36:55 oes + * Extended unload_current_actions_file() to multiple AFs. + * Thanks to Oliver Stoeneberg for the hint. + * + * Revision 1.32.2.1 2002/05/26 12:13:16 roro + * Change unsigned to unsigned long in actions_name struct. This closes + * SourceForge Bug #539284. + * + * Revision 1.32 2002/05/12 21:36:29 jongfoster + * Correcting function comments + * + * Revision 1.31 2002/05/06 07:56:50 oes + * Made actions_to_html independent of FEATURE_CGI_EDIT_ACTIONS + * + * Revision 1.30 2002/04/30 11:14:52 oes + * Made csp the first parameter in *action_to_html + * + * Revision 1.29 2002/04/26 19:30:54 jongfoster + * - current_action_to_html(): Adding help link for the "-" form of + * one-string actions. + * - Some actions had "<br>-", some "<br> -" (note the space). + * Standardizing on no space. + * - Greatly simplifying some of the code by using string_join() + * where appropriate. + * + * Revision 1.28 2002/04/26 12:53:15 oes + * - CGI AF editor now writes action lines split into + * single lines with line continuation + * - actions_to_html now embeds each action name in + * link to chapter + * - current_action_to_text is now called current_action_to_html + * and acts like actions_to_html + * + * Revision 1.27 2002/04/24 02:10:31 oes + * - Jon's patch for multiple AFs: + * - split load_actions_file, add load_one_actions_file + * - make csp->actions_list files an array + * - remember file id with each action + * - Copy_action now frees dest action before copying + * + * Revision 1.26 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.25 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.24 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.23 2002/03/07 03:46:16 oes + * Fixed compiler warnings + * + * Revision 1.22 2002/01/21 00:27:02 jongfoster + * Allowing free_action(NULL). + * Moving the functions that #include actionlist.h to the end of the file, + * because the Visual C++ 97 debugger gets extremely confused if you try + * to debug any code that comes after them in the file. + * + * Revision 1.21 2002/01/17 20:54:44 jongfoster + * Renaming free_url to free_url_spec, since it frees a struct url_spec. + * + * Revision 1.20 2001/11/22 21:56:49 jongfoster + * Making action_spec->flags into an unsigned long rather than just an + * unsigned int. + * Fixing a bug in the display of -add-header and -wafer + * + * Revision 1.19 2001/11/13 00:14:07 jongfoster + * Fixing stupid bug now I've figured out what || means. + * (It always returns 0 or 1, not one of it's paramaters.) + * + * Revision 1.18 2001/11/07 00:06:06 steudten + * Add line number in error output for lineparsing for + * actionsfile. + * + * Revision 1.17 2001/10/25 03:40:47 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.16 2001/10/23 21:30:30 jongfoster + * Adding error-checking to selected functions. + * + * Revision 1.15 2001/10/14 21:58:22 jongfoster + * Adding support for the CGI-based editor: + * - Exported get_actions() + * - Added new function free_alias_list() + * - Added support for {{settings}} and {{description}} blocks + * in the actions file. They are currently ignored. + * - Added restriction to only one {{alias}} block which must appear + * first in the file, to simplify the editor's rewriting rules. + * - Note that load_actions_file() is no longer used by the CGI-based + * editor, but some of the other routines in this file are. + * + * Revision 1.14 2001/09/22 16:36:59 jongfoster + * Removing unused parameter fs from read_config_line() + * + * Revision 1.13 2001/09/16 15:47:37 jongfoster + * First version of CGI-based edit interface. This is very much a + * work-in-progress, and you can't actually use it to edit anything + * yet. You must #define FEATURE_CGI_EDIT_ACTIONS for these changes + * to have any effect. + * + * Revision 1.12 2001/09/16 13:21:27 jongfoster + * Changes to use new list functions. + * + * Revision 1.11 2001/09/14 00:17:32 jongfoster + * Tidying up memory allocation. New function init_action(). + * + * Revision 1.10 2001/09/10 10:14:34 oes + * Removing unused variable + * + * Revision 1.9 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.8 2001/06/29 13:19:52 oes + * Removed logentry from cancelled commit + * + * Revision 1.7 2001/06/09 10:55:28 jongfoster + * Changing BUFSIZ ==> BUFFER_SIZE + * + * Revision 1.6 2001/06/07 23:04:34 jongfoster + * Made get_actions() static. + * + * Revision 1.5 2001/06/03 19:11:48 oes + * adapted to new enlist_unique arg format + * + * Revision 1.4 2001/06/01 20:03:42 jongfoster + * Better memory management - current_action->strings[] now + * contains copies of the strings, not the original. + * + * Revision 1.3 2001/06/01 18:49:17 jongfoster + * Replaced "list_share" with "list" - the tiny memory gain was not + * worth the extra complexity. + * + * Revision 1.2 2001/05/31 21:40:00 jongfoster + * Removing some commented out, obsolete blocks of code. + * + * Revision 1.1 2001/05/31 21:16:46 jongfoster + * Moved functions to process the action list into this new file. + * + * *********************************************************************/ - +
#include "config.h"
@@ -434,7 +685,7 @@ jb_err get_action_token(char **line, char **name, char **value) *********************************************************************/ static int action_used_to_be_valid(const char *action) { - static const char * const formerly_valid_actions[] = { + static const char *formerly_valid_actions[] = { "inspect-jpegs", "kill-popups", "send-vanilla-wafer", @@ -522,7 +773,7 @@ jb_err get_actions(char *line,
if ((value == NULL) || (*value == '\0')) { - if (0 == strcmpic(action->name, "+block")) + if (0 != strcmpic(action->name, "block")) { /* * XXX: Temporary backwards compatibility hack. @@ -879,7 +1130,7 @@ int update_action_bits_for_tag(struct client_state *csp, const char *tag) * Returns : N/A * *********************************************************************/ -void free_current_action(struct current_action_spec *src) +void free_current_action (struct current_action_spec *src) { int i;
@@ -1033,108 +1284,6 @@ int load_action_files(struct client_state *csp) return 0; }
- -/********************************************************************* - * - * Function : referenced_filters_are_missing - * - * Description : Checks if any filters of a certain type referenced - * in an action spec are missing. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * 2 : cur_action = The action spec to check. - * 3 : multi_index = The index where to look for the filter. - * 4 : filter_type = The filter type the caller is interested in. - * - * Returns : 0 => All referenced filters exists, everything else is an error. - * - *********************************************************************/ -static int referenced_filters_are_missing(const struct client_state *csp, - const struct action_spec *cur_action, int multi_index, enum filter_type filter_type) -{ - int i; - struct file_list *fl; - struct re_filterfile_spec *b; - struct list_entry *filtername; - - for (filtername = cur_action->multi_add[multi_index]->first; - filtername; filtername = filtername->next) - { - int filter_found = 0; - for (i = 0; i < MAX_AF_FILES; i++) - { - fl = csp->rlist[i]; - if ((NULL == fl) || (NULL == fl->f)) - { - continue; - } - - for (b = fl->f; b; b = b->next) - { - if (b->type != filter_type) - { - continue; - } - if (strcmp(b->name, filtername->str) == 0) - { - filter_found = 1; - } - } - } - if (!filter_found) - { - log_error(LOG_LEVEL_ERROR, "Missing filter '%s'", filtername->str); - return 1; - } - } - - return 0; - -} - - -/********************************************************************* - * - * Function : action_spec_is_valid - * - * Description : Should eventually figure out if an action spec - * is valid, but currently only checks that the - * referenced filters are accounted for. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * 2 : cur_action = The action spec to check. - * - * Returns : 0 => No problems detected, everything else is an error. - * - *********************************************************************/ -static int action_spec_is_valid(struct client_state *csp, const struct action_spec *cur_action) -{ - struct { - int multi_index; - enum filter_type filter_type; - } filter_map[] = { - {ACTION_MULTI_FILTER, FT_CONTENT_FILTER}, - {ACTION_MULTI_CLIENT_HEADER_FILTER, FT_CLIENT_HEADER_FILTER}, - {ACTION_MULTI_SERVER_HEADER_FILTER, FT_SERVER_HEADER_FILTER}, - {ACTION_MULTI_CLIENT_HEADER_TAGGER, FT_CLIENT_HEADER_TAGGER}, - {ACTION_MULTI_SERVER_HEADER_TAGGER, FT_SERVER_HEADER_TAGGER} - }; - int errors = 0; - int i; - - for (i = 0; i < SZ(filter_map); i++) - { - errors += referenced_filters_are_missing(csp, cur_action, - filter_map[i].multi_index, filter_map[i].filter_type); - } - - return errors; - -} - - /********************************************************************* * * Function : load_one_actions_file @@ -1157,24 +1306,23 @@ static int load_one_actions_file(struct client_state *csp, int fileid) * Note: Keep these in the order they occur in the file, they are * sometimes tested with <= */ - enum { - MODE_START_OF_FILE = 1, - MODE_SETTINGS = 2, - MODE_DESCRIPTION = 3, - MODE_ALIAS = 4, - MODE_ACTIONS = 5 - } mode; +#define MODE_START_OF_FILE 1 +#define MODE_SETTINGS 2 +#define MODE_DESCRIPTION 3 +#define MODE_ALIAS 4 +#define MODE_ACTIONS 5 + + int mode = MODE_START_OF_FILE;
FILE *fp; struct url_actions *last_perm; struct url_actions *perm; - char *buf; + char buf[BUFFER_SIZE]; struct file_list *fs; struct action_spec * cur_action = NULL; int cur_action_used = 0; struct action_alias * alias_list = NULL; unsigned long linenum = 0; - mode = MODE_START_OF_FILE;
if (!check_file_changed(current_actions_file[fileid], csp->config->actions_file[fileid], &fs)) { @@ -1205,9 +1353,7 @@ static int load_one_actions_file(struct client_state *csp, int fileid) return 1; /* never get here */ }
- log_error(LOG_LEVEL_INFO, "Loading actions file: %s", csp->config->actions_file[fileid]); - - while (read_config_line(fp, &linenum, &buf) != NULL) + while (read_config_line(buf, sizeof(buf), fp, &linenum) != NULL) { if (*buf == '{') { @@ -1223,7 +1369,7 @@ static int load_one_actions_file(struct client_state *csp, int fileid) /* too short */ fclose(fp); log_error(LOG_LEVEL_FATAL, - "can't load actions file '%s': invalid line (%lu): %s", + "can't load actions file '%s': invalid line (%lu): %s", csp->config->actions_file[fileid], linenum, buf); return 1; /* never get here */ } @@ -1324,11 +1470,11 @@ static int load_one_actions_file(struct client_state *csp, int fileid) { /* It's an actions block */
- char *actions_buf; + char actions_buf[BUFFER_SIZE]; char * end;
/* set mode */ - mode = MODE_ACTIONS; + mode = MODE_ACTIONS;
/* free old action */ if (cur_action) @@ -1351,23 +1497,8 @@ static int load_one_actions_file(struct client_state *csp, int fileid) } init_action(cur_action);
- /* - * Copy the buffer before messing with it as we may need the - * unmodified version in for the fatal error messages. Given - * that this is not a common event, we could instead simply - * read the line again. - * - * buf + 1 to skip the leading '{' - */ - actions_buf = strdup(buf + 1); - if (actions_buf == NULL) - { - fclose(fp); - log_error(LOG_LEVEL_FATAL, - "can't load actions file '%s': out of memory", - csp->config->actions_file[fileid]); - return 1; /* never get here */ - } + /* trim { */ + strlcpy(actions_buf, buf + 1, sizeof(actions_buf));
/* check we have a trailing } and then trim it */ end = actions_buf + strlen(actions_buf) - 1; @@ -1375,9 +1506,8 @@ static int load_one_actions_file(struct client_state *csp, int fileid) { /* No closing } */ fclose(fp); - freez(actions_buf); - log_error(LOG_LEVEL_FATAL, "can't load actions file '%s': " - "Missing trailing '}' in action section starting at line (%lu): %s", + log_error(LOG_LEVEL_FATAL, + "can't load actions file '%s': invalid line (%lu): %s", csp->config->actions_file[fileid], linenum, buf); return 1; /* never get here */ } @@ -1390,21 +1520,11 @@ static int load_one_actions_file(struct client_state *csp, int fileid) { /* error */ fclose(fp); - freez(actions_buf); - log_error(LOG_LEVEL_FATAL, "can't load actions file '%s': " - "can't completely parse the action section starting at line (%lu): %s", + log_error(LOG_LEVEL_FATAL, + "can't load actions file '%s': invalid line (%lu): %s", csp->config->actions_file[fileid], linenum, buf); return 1; /* never get here */ } - - if (action_spec_is_valid(csp, cur_action)) - { - log_error(LOG_LEVEL_ERROR, "Invalid action section in file '%s', " - "starting at line %lu: %s", - csp->config->actions_file[fileid], linenum, buf); - } - - freez(actions_buf); } } else if (mode == MODE_SETTINGS) @@ -1428,8 +1548,8 @@ static int load_one_actions_file(struct client_state *csp, int fileid) csp->config->actions_file[fileid]); return 1; /* never get here */ } - - num_fields = ssplit(version_string, ".", fields, SZ(fields), TRUE, FALSE); + + num_fields = ssplit(version_string, ".", fields, 3, TRUE, FALSE);
if (num_fields < 1 || atoi(fields[0]) == 0) { @@ -1538,7 +1658,7 @@ static int load_one_actions_file(struct client_state *csp, int fileid) } else if (mode == MODE_ACTIONS) { - /* it's an URL pattern */ + /* it's a URL pattern */
/* allocate a new node */ if ((perm = zalloc(sizeof(*perm))) == NULL) @@ -1558,7 +1678,7 @@ static int load_one_actions_file(struct client_state *csp, int fileid) { fclose(fp); log_error(LOG_LEVEL_FATAL, - "can't load actions file '%s': line %lu: cannot create URL or TAG pattern from: %s", + "can't load actions file '%s': line %lu: cannot create URL pattern from: %s", csp->config->actions_file[fileid], linenum, buf); return 1; /* never get here */ } @@ -1572,7 +1692,7 @@ static int load_one_actions_file(struct client_state *csp, int fileid) /* oops - please have a {} line as 1st line in file. */ fclose(fp); log_error(LOG_LEVEL_FATAL, - "can't load actions file '%s': line %lu should begin with a '{': %s", + "can't load actions file '%s': first needed line (%lu) is invalid: %s", csp->config->actions_file[fileid], linenum, buf); return 1; /* never get here */ } @@ -1585,7 +1705,6 @@ static int load_one_actions_file(struct client_state *csp, int fileid) csp->config->actions_file[fileid], mode); return 1; /* never get here */ } - freez(buf); }
fclose(fp); @@ -1619,7 +1738,7 @@ static int load_one_actions_file(struct client_state *csp, int fileid) * * Description : Converts a actionsfile entry from the internal * structure into a text line. The output is split - * into one line for each action with line continuation. + * into one line for each action with line continuation. * * Parameters : * 1 : action = The action to format. @@ -1704,7 +1823,7 @@ char * actions_to_text(const struct action_spec *action) * Function : actions_to_html * * Description : Converts a actionsfile entry from numeric form - * ("mask" and "add") to a <br>-separated HTML string + * ("mask" and "add") to a <br>-seperated HTML string * in which each action is linked to its chapter in * the user manual. * @@ -1810,12 +1929,12 @@ char * actions_to_html(const struct client_state *csp, * * Function : current_actions_to_html * - * Description : Converts a curren action spec to a <br> separated HTML + * Description : Converts a curren action spec to a <br> seperated HTML * text in which each action is linked to its chapter in * the user manual. * * Parameters : - * 1 : csp = Client state (for config) + * 1 : csp = Client state (for config) * 2 : action = Current action spec to be converted * * Returns : A string. Caller must free it. diff --git a/external/privoxy/actions.h b/external/privoxy/actions.h index 8c1a57d..733a853 100644 --- a/external/privoxy/actions.h +++ b/external/privoxy/actions.h @@ -1,6 +1,6 @@ #ifndef ACTIONS_H_INCLUDED #define ACTIONS_H_INCLUDED -#define ACTIONS_H_VERSION "$Id: actions.h,v 1.20 2011/09/04 11:10:56 fabiankeil Exp $" +#define ACTIONS_H_VERSION "$Id: actions.h,v 1.18 2008/03/30 14:52:00 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/actions.h,v $ @@ -12,10 +12,10 @@ * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -33,8 +33,87 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: actions.h,v $ + * Revision 1.18 2008/03/30 14:52:00 fabiankeil + * Rename load_actions_file() and load_re_filterfile() + * as they load multiple files "now". + * + * Revision 1.17 2008/01/28 20:17:40 fabiankeil + * - Mark some parameters as immutable. + * - Hide update_action_bits_for_all_tags() while it's unused. + * + * Revision 1.16 2007/04/17 18:21:45 fabiankeil + * Split update_action_bits() into + * update_action_bits_for_all_tags() + * and update_action_bits_for_tag(). + * + * Revision 1.15 2007/04/15 16:39:20 fabiankeil + * Introduce tags as alternative way to specify which + * actions apply to a request. At the moment tags can be + * created based on client and server headers. + * + * Revision 1.14 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.12 2002/05/06 07:56:50 oes + * Made actions_to_html independent of FEATURE_CGI_EDIT_ACTIONS + * + * Revision 1.11 2002/04/30 11:14:52 oes + * Made csp the first parameter in *action_to_html + * + * Revision 1.10 2002/04/26 12:53:33 oes + * - actions_to_html signature change + * - current_action_to_text: renamed to current_action_to_html + * and signature change + * + * Revision 1.9 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.8 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.7 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.6 2001/10/23 21:30:30 jongfoster + * Adding error-checking to selected functions. + * + * Revision 1.5 2001/10/14 21:58:22 jongfoster + * Adding support for the CGI-based editor: + * - Exported get_actions() + * - Added new function free_alias_list() + * - Added support for {{settings}} and {{description}} blocks + * in the actions file. They are currently ignored. + * - Added restriction to only one {{alias}} block which must appear + * first in the file, to simplify the editor's rewriting rules. + * - Note that load_actions_file() is no longer used by the CGI-based + * editor, but some of the other routines in this file are. + * + * Revision 1.4 2001/09/16 15:47:37 jongfoster + * First version of CGI-based edit interface. This is very much a + * work-in-progress, and you can't actually use it to edit anything + * yet. You must #define FEATURE_CGI_EDIT_ACTIONS for these changes + * to have any effect. + * + * Revision 1.3 2001/09/14 00:17:32 jongfoster + * Tidying up memory allocation. New function init_action(). + * + * Revision 1.2 2001/07/29 19:01:11 jongfoster + * Changed _FILENAME_H to FILENAME_H_INCLUDED. + * Added forward declarations for needed structures. + * + * Revision 1.1 2001/05/31 21:16:46 jongfoster + * Moved functions to process the action list into this new file. + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -56,27 +135,27 @@ struct action_alias };
-extern jb_err get_actions (char *line, +extern jb_err get_actions (char *line, struct action_alias * alias_list, struct action_spec *cur_action); extern void free_alias_list(struct action_alias *alias_list);
extern void init_action(struct action_spec *dest); extern void free_action(struct action_spec *src); -extern jb_err merge_actions (struct action_spec *dest, +extern jb_err merge_actions (struct action_spec *dest, const struct action_spec *src); #if 0 extern int update_action_bits_for_all_tags(struct client_state *csp); #endif extern int update_action_bits_for_tag(struct client_state *csp, const char *tag); -extern jb_err copy_action (struct action_spec *dest, +extern jb_err copy_action (struct action_spec *dest, const struct action_spec *src); extern char * actions_to_text (const struct action_spec *action); extern char * actions_to_html (const struct client_state *csp, const struct action_spec *action); extern void init_current_action (struct current_action_spec *dest); extern void free_current_action (struct current_action_spec *src); -extern jb_err merge_current_action (struct current_action_spec *dest, +extern jb_err merge_current_action (struct current_action_spec *dest, const struct action_spec *src); extern char * current_action_to_html(const struct client_state *csp, const struct current_action_spec *action); diff --git a/external/privoxy/amiga.c b/external/privoxy/amiga.c index f152a45..68193fb 100644 --- a/external/privoxy/amiga.c +++ b/external/privoxy/amiga.c @@ -1,4 +1,4 @@ -const char amiga_rcs[] = "$Id: amiga.c,v 1.14 2011/09/04 11:10:56 fabiankeil Exp $"; +const char amiga_rcs[] = "$Id: amiga.c,v 1.12 2007/01/07 07:40:52 joergs Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/amiga.c,v $ @@ -8,7 +8,7 @@ const char amiga_rcs[] = "$Id: amiga.c,v 1.14 2011/09/04 11:10:56 fabiankeil Exp * Copyright : Written by and Copyright (C) 2001 the SourceForge * Privoxy team. http://www.privoxy.org/ * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -26,8 +26,66 @@ const char amiga_rcs[] = "$Id: amiga.c,v 1.14 2011/09/04 11:10:56 fabiankeil Exp * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: amiga.c,v $ + * Revision 1.12 2007/01/07 07:40:52 joergs + * Added AmigaOS4 support and made it work on AmigaOS 3.x with current sources. + * + * Revision 1.11 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.9 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.8 2002/03/25 19:32:15 joergs + * Name in version string changed from junkbuster to Privoxy. + * + * Revision 1.7 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.6 2002/03/09 20:03:52 jongfoster + * - Making various functions return int rather than size_t. + * (Undoing a recent change). Since size_t is unsigned on + * Windows, functions like read_socket that return -1 on + * error cannot return a size_t. + * + * THIS WAS A MAJOR BUG - it caused frequent, unpredictable + * crashes, and also frequently caused JB to jump to 100% + * CPU and stay there. (Because it thought it had just + * read ((unsigned)-1) == 4Gb of data...) + * + * - The signature of write_socket has changed, it now simply + * returns success=0/failure=nonzero. + * + * - Trying to get rid of a few warnings --with-debug on + * Windows, I've introduced a new type "jb_socket". This is + * used for the socket file descriptors. On Windows, this + * is SOCKET (a typedef for unsigned). Everywhere else, it's + * an int. The error value can't be -1 any more, so it's + * now JB_INVALID_SOCKET (which is -1 on UNIX, and in + * Windows it maps to the #define INVALID_SOCKET.) + * + * - The signature of bind_port has changed. + * + * Revision 1.5 2002/03/03 09:18:03 joergs + * Made jumbjuster work on AmigaOS again. + * + * Revision 1.4 2001/10/07 15:35:13 oes + * Replaced 6 boolean members of csp with one bitmap (csp->flags) + * + * Revision 1.3 2001/09/12 22:54:51 joergs + * Stacksize of main thread increased. + * + * Revision 1.2 2001/05/23 00:13:58 joergs + * AmigaOS support fixed. + * + * Revision 1.1.1.1 2001/05/15 13:58:46 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
diff --git a/external/privoxy/amiga.h b/external/privoxy/amiga.h index 093550d..43ebda6 100644 --- a/external/privoxy/amiga.h +++ b/external/privoxy/amiga.h @@ -1,7 +1,7 @@ #ifdef AMIGA #ifndef AMIGA_H_INCLUDED #define AMIGA_H_INCLUDED -#define AMIGA_H_VERSION "$Id: amiga.h,v 1.14 2011/09/04 11:10:56 fabiankeil Exp $" +#define AMIGA_H_VERSION "$Id: amiga.h,v 1.12 2007/01/07 07:40:52 joergs Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/amiga.h,v $ @@ -11,7 +11,7 @@ * Copyright : Written by and Copyright (C) 2001 the SourceForge * Privoxy team. http://www.privoxy.org/ * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -29,8 +29,47 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: amiga.h,v $ + * Revision 1.12 2007/01/07 07:40:52 joergs + * Added AmigaOS4 support and made it work on AmigaOS 3.x with current sources. + * + * Revision 1.11 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.9 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.8 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.7 2002/03/03 09:18:03 joergs + * Made jumbjuster work on AmigaOS again. + * + * Revision 1.6 2001/10/13 12:46:08 joergs + * Added #undef EINTR to avoid warnings + * + * Revision 1.5 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.4 2001/05/29 20:05:06 joergs + * Fixed exit() macro not exiting if called before InitAmiga() + * (junkbuster --help and --version). + * + * Revision 1.3 2001/05/25 21:53:27 jongfoster + * Fixing indentation + * + * Revision 1.2 2001/05/23 00:13:58 joergs + * AmigaOS support fixed. + * + * Revision 1.1.1.1 2001/05/15 13:58:46 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#define _KERNEL #include <sys/socket.h> diff --git a/external/privoxy/cgi.c b/external/privoxy/cgi.c index d079267..61ff069 100644 --- a/external/privoxy/cgi.c +++ b/external/privoxy/cgi.c @@ -1,4 +1,4 @@ -const char cgi_rcs[] = "$Id: cgi.c,v 1.145 2011/10/08 17:31:05 fabiankeil Exp $"; +const char cgi_rcs[] = "$Id: cgi.c,v 1.116 2009/03/15 14:59:34 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/cgi.c,v $ @@ -7,18 +7,18 @@ const char cgi_rcs[] = "$Id: cgi.c,v 1.145 2011/10/08 17:31:05 fabiankeil Exp $" * html or gif answers, and to compose HTTP resonses. * This only contains the framework functions, the * actual handler functions are declared elsewhere. - * + * * Functions declared include: - * + * * * Copyright : Written by and Copyright (C) 2001-2004, 2006-2008 * the SourceForge Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -36,8 +36,618 @@ const char cgi_rcs[] = "$Id: cgi.c,v 1.145 2011/10/08 17:31:05 fabiankeil Exp $" * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: cgi.c,v $ + * Revision 1.116 2009/03/15 14:59:34 fabiankeil + * Cosmetics. + * + * Revision 1.115 2009/03/01 18:28:23 fabiankeil + * Help clang understand that we aren't dereferencing + * NULL pointers here. + * + * Revision 1.114 2008/12/04 18:15:04 fabiankeil + * Fix some cparser warnings. + * + * Revision 1.113 2008/09/04 08:13:58 fabiankeil + * Prepare for critical sections on Windows by adding a + * layer of indirection before the pthread mutex functions. + * + * Revision 1.112 2008/08/31 16:08:12 fabiankeil + * "View the request headers" isn't more equal than the other + * menu items and thus doesn't need a trailing dot either. + * + * Revision 1.111 2008/08/31 15:59:02 fabiankeil + * There's no reason to let remote toggling support depend + * on FEATURE_CGI_EDIT_ACTIONS, so make sure it doesn't. + * + * Revision 1.110 2008/08/31 14:55:43 fabiankeil + * Add a @date@ symbol to include a date(1)-like time string + * in templates. Modified version of the patch Endre Szabo + * submitted in #2026468. + * + * Revision 1.109 2008/07/26 09:40:27 fabiankeil + * Remove the unconditional block in get_http_time(). + * It's pointless now that it's no longer used to limit + * dummy's scope. While at it, remove obvious comments + * and a trailing space. + * + * Revision 1.108 2008/05/26 17:30:53 fabiankeil + * Provide an OpenSearch Description to access the + * show-url-info page through "search engine plugins". + * + * Revision 1.107 2008/05/26 16:23:19 fabiankeil + * - Fix spelling in template-not-found message. + * - Declare referrer_is_safe()'s alternative_prefix[] static. + * + * Revision 1.106 2008/05/21 15:24:38 fabiankeil + * Mark csp as immutable for a bunch of functions. + * + * Revision 1.105 2008/04/17 14:40:47 fabiankeil + * Provide get_http_time() with the buffer size so it doesn't + * have to blindly assume that the buffer is big enough. + * + * Revision 1.104 2008/03/26 18:07:06 fabiankeil + * Add hostname directive. Closes PR#1918189. + * + * Revision 1.103 2008/03/21 11:13:57 fabiankeil + * Only gather host information if it's actually needed. + * Also move the code out of accept_connection() so it's less likely + * to delay other incoming connections if the host is misconfigured. + * + * Revision 1.102 2008/02/23 16:33:43 fabiankeil + * Let forward_url() use the standard parameter ordering + * and mark its second parameter immutable. + * + * Revision 1.101 2008/02/03 15:45:06 fabiankeil + * Add SOCKS5 support for "Forwarding failure" CGI page. + * + * Revision 1.100 2007/10/17 18:40:53 fabiankeil + * - Send CGI pages as HTTP/1.1 unless the client asked for HTTP/1.0. + * - White space fix. + * + * Revision 1.99 2007/08/05 13:42:22 fabiankeil + * #1763173 from Stefan Huehner: declare some more functions static. + * + * Revision 1.98 2007/05/14 10:33:51 fabiankeil + * - Use strlcpy() and strlcat() instead of strcpy() and strcat(). + * + * Revision 1.97 2007/04/09 18:11:35 fabiankeil + * Don't mistake VC++'s _snprintf() for a snprintf() replacement. + * + * Revision 1.96 2007/03/08 17:41:05 fabiankeil + * Use sizeof() more often. + * + * Revision 1.95 2007/02/10 17:01:37 fabiankeil + * Don't overlook map result for the forwarding-type. + * + * Revision 1.94 2007/02/08 19:44:49 fabiankeil + * Use a transparent background for the PNG replacement pattern. + * + * Revision 1.93 2007/02/07 10:45:22 fabiankeil + * - Save the reason for generating http_responses. + * - Fix --disable-toggle (again). + * - Use TBL birthday hack for 403 responses as well. + * - Uglify the @menu@ again to fix JavaScript + * errors on the "blocked" template. + * - Escape an ampersand in cgi_error_unknown(). + * + * Revision 1.92 2007/01/28 13:41:17 fabiankeil + * - Add HEAD support to finish_http_response. + * - Add error favicon to internal HTML error messages. + * + * Revision 1.91 2007/01/27 13:09:16 fabiankeil + * Add new config option "templdir" to + * change the templates directory. + * + * Revision 1.90 2007/01/25 13:47:26 fabiankeil + * Added "forwarding-failed" template support for error_response(). + * + * Revision 1.89 2007/01/23 15:51:16 fabiankeil + * Add favicon delivery functions. + * + * Revision 1.88 2007/01/23 13:14:32 fabiankeil + * - Map variables that aren't guaranteed to be + * pure ASCII html_encoded. + * - Use CGI_PREFIX to generate URL for user manual + * CGI page to make sure CGI_SITE_2_PATH is included. + * + * Revision 1.87 2007/01/22 15:34:13 fabiankeil + * - "Protect" against a rather lame JavaScript-based + * Privoxy detection "attack" and check the referrer + * before delivering the CGI style sheet. + * - Move referrer check for unsafe CGI pages into + * referrer_is_safe() and log the result. + * - Map @url@ in cgi-error-disabled page. + * It's required for the "go there anyway" link. + * - Mark *csp as immutable for grep_cgi_referrer(). + * + * Revision 1.86 2007/01/09 11:54:26 fabiankeil + * Fix strdup() error handling in cgi_error_unknown() + * and cgi_error_no_template(). Reported by Markus Elfring. + * + * Revision 1.85 2007/01/05 14:19:02 fabiankeil + * Handle pcrs_execute() errors in template_fill() properly. + * + * Revision 1.84 2006/12/28 17:54:22 fabiankeil + * Fixed gcc43 conversion warnings and replaced sprintf + * calls with snprintf to give OpenBSD's gcc one less reason + * to complain. + * + * Revision 1.83 2006/12/17 19:35:19 fabiankeil + * Escape ampersand in Privoxy menu. + * + * Revision 1.82 2006/12/17 17:53:39 fabiankeil + * Suppress the toggle link if remote toggling is disabled. + * + * Revision 1.81 2006/12/09 13:49:16 fabiankeil + * Fix configure option --disable-toggle. + * Thanks to Peter Thoenen for reporting this. + * + * Revision 1.80 2006/12/08 14:45:32 fabiankeil + * Don't lose the FORCE_PREFIX in case of + * connection problems. Fixes #612235. + * + * Revision 1.79 2006/11/13 19:05:50 fabiankeil + * Make pthread mutex locking more generic. Instead of + * checking for OSX and OpenBSD, check for FEATURE_PTHREAD + * and use mutex locking unless there is an _r function + * available. Better safe than sorry. + * + * Fixes "./configure --disable-pthread" and should result + * in less threading-related problems on pthread-using platforms, + * but it still doesn't fix BR#1122404. + * + * Revision 1.78 2006/09/21 19:22:07 fabiankeil + * Use CGI_PREFIX to check the referrer. + * The check for "http://config.privoxy.org/" fails + * if the user modified CGI_SITE_2_HOST. + * + * Revision 1.77 2006/09/21 15:17:23 fabiankeil + * Adjusted headers for Privoxy's cgi responses: + * Don't set Last-Modified, Expires and Cache-Control + * headers for redirects; always set "Connection: close". + * + * Revision 1.76 2006/09/07 14:06:38 fabiankeil + * Only predate the Last-Modified header for cgi responses + * that are delivered with status code 404 or 503. + * + * Revision 1.75 2006/09/07 11:56:39 fabiankeil + * Mark cgi_send_user_manual as harmless, + * to fix the access denied problem Hal spotted. + * The manual has no secret content, therefore we + * don't have to care about "secure" referrers. + * + * Revision 1.74 2006/09/06 18:45:03 fabiankeil + * Incorporate modified version of Roland Rosenfeld's patch to + * optionally access the user-manual via Privoxy. Closes patch 679075. + * + * Formatting changed to Privoxy style, added call to + * cgi_error_no_template if the requested file doesn't + * exist and modified check whether or not Privoxy itself + * should serve the manual. Should work cross-platform now. + * + * Revision 1.73 2006/08/03 02:46:41 david__schmidt + * Incorporate Fabian Keil's patch work:http://www.fabiankeil.de/sourcecode/privoxy/ + * + * Revision 1.72 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.70.2.13 2004/02/17 13:30:23 oes + * Moved cgi_error_disabled() from cgiedit.c to + * cgi.c to re-enable build with --disable-editor. + * Fixes Bug #892744. Thanks to Matthew Fischer + * for spotting. + * + * Revision 1.70.2.12 2003/12/17 16:33:16 oes + * - Added new function cgi_redirect to handle creation of + * HTTP redirect messages formerly repeated in the code. + * - Send cgi_error_disabled instead of cgi_error_404 when + * referrer check fails + * - Dynamic content now gets Expires header field with date + * in the past + * + * Revision 1.70.2.11 2003/10/23 12:29:26 oes + * Bugfix: Transparent PNG was not transparent. Thanks to + * Dan Razzell of Starfish Systems for notice and new PNG. + * + * Revision 1.70.2.10 2003/06/06 07:54:25 oes + * Security fix: dspatch_known_cgi no longer considers an empty + * referrer safe for critical CGIs, since malicious links could + * reside on https:// locations which browsers don't advertize as + * referrers. Closes bug #749916, thanks to Jeff Epler for the + * hint. Goodbye One-Click[tm] toggling :-( + * + * Revision 1.70.2.9 2003/05/08 15:11:31 oes + * Nit + * + * Revision 1.70.2.8 2003/04/29 13:33:51 oes + * Killed a compiler warning on OSX + * + * Revision 1.70.2.7 2003/04/03 13:50:58 oes + * - Don't call cgi_error_disabled ifndef FEATURE_CGI_EDIT_ACTIONS + * (fixes bug #710056) + * - Show toggle info only if we have it + * + * Revision 1.70.2.6 2003/03/12 01:26:25 david__schmidt + * Move declaration of struct tm dummy outside of a control block so it is + * accessible later on during snprintf in get_http_time. + * + * Revision 1.70.2.5 2003/03/11 11:53:58 oes + * Cosmetic: Renamed cryptic variable + * + * Revision 1.70.2.4 2003/03/07 03:41:03 david__schmidt + * Wrapping all *_r functions (the non-_r versions of them) with mutex semaphores for OSX. Hopefully this will take care of all of those pesky crash reports. + * + * Revision 1.70.2.3 2002/11/28 18:14:32 oes + * Disable access to critical CGIs via untrusted referrers. + * This prevents users from being tricked by malicious websites + * into making unintentional configuration changes: + * + * - Added flag to each cgi_dispatcher that allows or denies + * external linking + * - Introduced proviorical function that greps for the + * referrer header before regular header parsing happens + * - Added safety check to dispatch_known_cgi. CGI is called + * if (cgi harmless || no referrer || we are referrer). + * Else a) toggle calls are modified not to change status and + * b) all other calls are denied. + * + * Revision 1.70.2.2 2002/11/12 16:20:37 oes + * Added missing #ifdef FEATURE_TOGGLE around g_bToggleIJB; fixes bug #636651 + * + * Revision 1.70.2.1 2002/08/05 11:17:46 oes + * Fixed Bug #587820, i.e. added workaround for IE bug that includes fragment identifier in (cgi) query + * + * Revision 1.70 2002/05/19 11:33:20 jongfoster + * If a CGI error was not handled, and propogated back to + * dispatch_known_cgi(), then it was assumed to be "out of memory". + * This gave a very misleading error message. + * + * Now other errors will cause a simple message giving the error + * number and asking the user to report a bug. + * + * Bug report: + * http://sourceforge.net/tracker/index.php?func=detail + * &aid=557905&group_id=11118&atid=111118 + * + * Revision 1.69 2002/05/14 21:28:40 oes + * - Fixed add_help_link to link to the (now split) actions + * part of the config chapter + * - Renamed helplink export to actions-help-prefix + * + * Revision 1.68 2002/05/12 21:36:29 jongfoster + * Correcting function comments + * + * Revision 1.67 2002/04/30 12:02:07 oes + * Nit: updated a comment + * + * Revision 1.66 2002/04/26 18:32:57 jongfoster + * Fixing a memory leak on error + * + * Revision 1.65 2002/04/26 12:53:51 oes + * - New function add_help_link + * - default_exports now exports links to the user manual + * and a prefix for links into the config chapter + * + * Revision 1.64 2002/04/24 02:17:21 oes + * - Better descriptions for CGIs + * - Hide edit-actions, more shortcuts + * - Moved get_char_param, get_string_param and get_number_param here + * from cgiedit.c + * + * Revision 1.63 2002/04/15 19:06:43 jongfoster + * Typos + * + * Revision 1.62 2002/04/10 19:59:46 jongfoster + * Fixes to #include in templates: + * - Didn't close main file if loading an included template fails. + * - I'm paranoid and want to disallow "#include /etc/passwd". + * + * Revision 1.61 2002/04/10 13:37:48 oes + * Made templates modular: template_load now recursive with max depth 1 + * + * Revision 1.60 2002/04/08 20:50:25 swa + * fixed JB spelling + * + * Revision 1.59 2002/04/05 15:51:51 oes + * - added send-stylesheet CGI + * - bugfix: error-pages now get correct request protocol + * - fixed + * - kludged CGI descriptions and menu not to break JS syntax + * + * Revision 1.58 2002/03/29 03:33:13 david__schmidt + * Fix Mac OSX compiler warnings + * + * Revision 1.57 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.56 2002/03/24 17:50:46 jongfoster + * Fixing compile error if actions file editor disabled + * + * Revision 1.55 2002/03/24 16:55:06 oes + * Making GIF checkerboard transparent + * + * Revision 1.54 2002/03/24 16:18:15 jongfoster + * Removing old logo + * + * Revision 1.53 2002/03/24 16:06:00 oes + * Correct transparency for checkerboard PNG. Thanks, Magnus! + * + * Revision 1.52 2002/03/24 15:23:33 jongfoster + * Name changes + * + * Revision 1.51 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.50 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.49 2002/03/13 00:27:04 jongfoster + * Killing warnings + * + * Revision 1.48 2002/03/08 17:47:07 jongfoster + * Adding comments + * + * Revision 1.47 2002/03/08 16:41:33 oes + * Added GIF images again + * + * Revision 1.46 2002/03/07 03:48:38 oes + * - Changed built-in images from GIF to PNG + * (with regard to Unisys patent issue) + * - Added a 4x4 pattern PNG which is less intrusive + * than the logo but also clearly marks the deleted banners + * + * Revision 1.45 2002/03/06 22:54:35 jongfoster + * Automated function-comment nitpicking. + * + * Revision 1.44 2002/03/05 22:43:45 david__schmidt + * - Better error reporting on OS/2 + * - Fix double-slash comment (oops) + * + * Revision 1.43 2002/03/05 21:33:45 david__schmidt + * - Re-enable OS/2 building after new parms were added + * - Fix false out of memory report when resolving CGI templates when no IP + * address is available of failed attempt (a la no such domain) + * + * Revision 1.42 2002/01/21 00:33:20 jongfoster + * Replacing strsav() with the safer string_append() or string_join(). + * Adding map_block_keep() to save a few bytes in the edit-actions-list HTML. + * Adding missing html_encode() to error message generators. + * Adding edit-actions-section-swap and many "shortcuts" to the list of CGIs. + * + * Revision 1.41 2002/01/17 20:56:22 jongfoster + * Replacing hard references to the URL of the config interface + * with #defines from project.h + * + * Revision 1.40 2002/01/09 14:26:46 oes + * Added support for thread-safe gmtime_r call. + * + * Revision 1.39 2001/11/16 00:48:13 jongfoster + * Fixing a compiler warning + * + * Revision 1.38 2001/11/13 00:31:21 jongfoster + * - Adding new CGIs for use by non-JavaScript browsers: + * edit-actions-url-form + * edit-actions-add-url-form + * edit-actions-remove-url-form + * - Fixing make_menu()'s HTML generation - it now quotes the href parameter. + * - Fixing || bug. + * + * Revision 1.37 2001/11/01 14:28:47 david__schmidt + * Show enablement/disablement status in almost all templates. + * There is a little trickiness here: apparent recursive resolution of + * @if-enabled-then@ caused the toggle template to show status out-of-phase with + * the actual enablement status. So a similar construct, + * @if-enabled-display-then@, is used to resolve the status display on non-'toggle' + * templates. + * + * Revision 1.36 2001/10/26 17:33:27 oes + * marginal bugfix + * + * Revision 1.35 2001/10/23 21:48:19 jongfoster + * Cleaning up error handling in CGI functions - they now send back + * a HTML error page and should never cause a FATAL error. (Fixes one + * potential source of "denial of service" attacks). + * + * CGI actions file editor that works and is actually useful. + * + * Ability to toggle Junkbuster remotely using a CGI call. + * + * You can turn off both the above features in the main configuration + * file, e.g. if you are running a multi-user proxy. + * + * Revision 1.34 2001/10/18 22:22:09 david__schmidt + * Only show "Local support" on templates conditionally: + * - if either 'admin-address' or 'proxy-info-url' are uncommented in config + * - if not, no Local support section appears + * + * Revision 1.33 2001/10/14 22:28:41 jongfoster + * Fixing stupid typo. + * + * Revision 1.32 2001/10/14 22:20:18 jongfoster + * - Changes to CGI dispatching method to match CGI names exactly, + * rather than doing a prefix match. + * - No longer need to count the length of the CGI handler names by hand. + * - Adding new handler for 404 error when disptching a CGI, if none of + * the handlers match. + * - Adding new handlers for CGI actionsfile editor. + * + * Revision 1.31 2001/10/10 10:56:39 oes + * Failiure to load template now fatal. Before, the user got a hard-to-understand assertion failure from cgi.c + * + * Revision 1.30 2001/10/02 15:30:57 oes + * Introduced show-request cgi + * + * Revision 1.29 2001/09/20 15:47:44 steudten + * + * Fix BUG: Modify int size to size_t size in fill_template() + * - removes big trouble on machines where sizeof(int) != sizeof(size_t). + * + * Revision 1.28 2001/09/19 18:00:37 oes + * - Deletef time() FIXME (Can't fail under Linux either, if + * the argument is guaranteed to be in out address space, + * which it is.) + * - Fixed comments + * - Pointer notation cosmetics + * - Fixed a minor bug in template_fill(): Failiure of + * pcrs_execute() now secure. + * + * Revision 1.27 2001/09/16 17:08:54 jongfoster + * Moving simple CGI functions from cgi.c to new file cgisimple.c + * + * Revision 1.26 2001/09/16 15:47:37 jongfoster + * First version of CGI-based edit interface. This is very much a + * work-in-progress, and you can't actually use it to edit anything + * yet. You must #define FEATURE_CGI_EDIT_ACTIONS for these changes + * to have any effect. + * + * Revision 1.25 2001/09/16 15:02:35 jongfoster + * Adding i.j.b/robots.txt. + * Inlining add_stats() since it's only ever called from one place. + * + * Revision 1.24 2001/09/16 11:38:01 jongfoster + * Splitting fill_template() into 2 functions: + * template_load() loads the file + * template_fill() performs the PCRS regexps. + * This is because the CGI edit interface has a "table row" + * template which is used many times in the page - this + * change means it's only loaded from disk once. + * + * Revision 1.23 2001/09/16 11:16:05 jongfoster + * Better error handling in dispatch_cgi() and parse_cgi_parameters() + * + * Revision 1.22 2001/09/16 11:00:10 jongfoster + * New function alloc_http_response, for symmetry with free_http_response + * + * Revision 1.21 2001/09/13 23:53:03 jongfoster + * Support for both static and dynamically generated CGI pages. + * Correctly setting Last-Modified: and Expires: HTTP headers. + * + * Revision 1.20 2001/09/13 23:40:36 jongfoster + * (Cosmetic only) Indentation correction + * + * Revision 1.19 2001/09/13 23:31:25 jongfoster + * Moving image data to cgi.c rather than cgi.h. + * + * Revision 1.18 2001/08/05 16:06:20 jongfoster + * Modifiying "struct map" so that there are now separate header and + * "map_entry" structures. This means that functions which modify a + * map no longer need to return a pointer to the modified map. + * Also, it no longer reverses the order of the entries (which may be + * important with some advanced template substitutions). + * + * Revision 1.17 2001/08/05 15:57:38 oes + * Adapted finish_http_response to new list_to_text + * + * Revision 1.16 2001/08/01 21:33:18 jongfoster + * Changes to fill_template() that reduce memory usage without having + * an impact on performance. I also renamed some variables so as not + * to clash with the C++ keywords "new" and "template". + * + * Revision 1.15 2001/08/01 21:19:22 jongfoster + * Moving file version information to a separate CGI page. + * + * Revision 1.14 2001/08/01 00:19:03 jongfoster + * New function: map_conditional() for an if-then-else syntax. + * Changing to use new version of show_defines() + * + * Revision 1.13 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.12 2001/07/29 18:47:05 jongfoster + * Adding missing #include "loadcfg.h" + * + * Revision 1.11 2001/07/18 17:24:37 oes + * Changed to conform to new pcrs interface + * + * Revision 1.10 2001/07/13 13:53:13 oes + * Removed all #ifdef PCRS and related code + * + * Revision 1.9 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.8 2001/06/29 13:21:46 oes + * - Cosmetics: renamed and reordered functions, variables, + * texts, improved comments etc + * + * - Removed ij_untrusted_url() The relevant + * info is now part of the "untrusted" page, + * which is generated by filters.c:trust_url() + * + * - Generators of content now call finish_http_response() + * themselves, making jcc.c:chat() a little less + * cluttered + * + * - Removed obsolete "Pragma: no-cache" from our headers + * + * - http_responses now know their head length + * + * - fill_template now uses the new interface to pcrs, so that + * - long jobs (like whole files) no longer have to be assembled + * in a fixed size buffer + * - the new T (trivial) option is used, and the replacement may + * contain Perl syntax backrefs without confusing pcrs + * + * - Introduced default_exports() which generates a set of exports + * common to all CGIs and other content generators + * + * - Introduced convenience function map_block_killer() + * + * - Introduced convenience function make_menu() + * + * - Introduced CGI-like function error_response() which generates + * the "No such domain" and "Connect failed" messages using the + * CGI platform + * + * - cgi_show_url_info: + * - adapted to new CGI features + * - form and answers now generated from same template + * - http:// prefix in URL now OK + * + * - cgi_show_status: + * - adapted to new CGI features + * - no longer uses csp->init_proxy_args + * + * - cgi_default: + * - moved menu generation to make_menu() + * + * - add_stats now writes single export map entries instead + * of a fixed string + * + * - Moved redirect_url() to filters.c + * + * - Fixed mem leak in free_http_response(), map_block_killer(), + * + * - Removed logentry from cancelled commit + * + * Revision 1.7 2001/06/09 10:51:58 jongfoster + * Changing "show URL info" handler to new style. + * Changing BUFSIZ ==> BUFFER_SIZE + * + * Revision 1.6 2001/06/07 23:05:19 jongfoster + * Removing code related to old forward and ACL files. + * + * Revision 1.5 2001/06/05 19:59:16 jongfoster + * Fixing multiline character string (a GCC-only "feature"), and snprintf (it's _snprintf under VC++). + * + * Revision 1.4 2001/06/04 10:41:52 swa + * show version string of cgi.h and cgi.c + * + * Revision 1.3 2001/06/03 19:12:16 oes + * introduced new cgi handling + * + * No revisions before 1.3 + * **********************************************************************/ - +
#include "config.h"
@@ -49,10 +659,6 @@ const char cgi_rcs[] = "$Id: cgi.c,v 1.145 2011/10/08 17:31:05 fabiankeil Exp $" #include <limits.h> #include <assert.h>
-#ifdef FEATURE_COMPRESSION -#include <zlib.h> -#endif - #include "project.h" #include "cgi.h" #include "list.h" @@ -66,12 +672,12 @@ const char cgi_rcs[] = "$Id: cgi.c,v 1.145 2011/10/08 17:31:05 fabiankeil Exp $" #if defined(FEATURE_CGI_EDIT_ACTIONS) || defined(FEATURE_TOGGLE) #include "cgiedit.h" #endif /* defined(FEATURE_CGI_EDIT_ACTIONS) || defined (FEATURE_TOGGLE) */ - -/* loadcfg.h is for global_toggle_state only */ #include "loadcfg.h" -/* jcc.h is for mutex semaphore globals only */ +/* loadcfg.h is for global_toggle_state only */ +#ifdef FEATURE_PTHREAD #include "jcc.h" - +/* jcc.h is for mutex semaphore globals only */ +#endif /* def FEATURE_PTHREAD */ const char cgi_h_rcs[] = CGI_H_VERSION;
/* @@ -85,126 +691,126 @@ static const struct cgi_dispatcher cgi_dispatchers[] = { "Privoxy main page", TRUE }, #ifdef FEATURE_GRACEFUL_TERMINATION - { "die", - cgi_die, + { "die", + cgi_die, "<b>Shut down</b> - <em class="warning">Do not deploy this build in a production environment, " "this is a one click Denial Of Service attack!!!</em>", - FALSE }, + FALSE }, #endif - { "show-status", - cgi_show_status, + { "show-status", + cgi_show_status, #ifdef FEATURE_CGI_EDIT_ACTIONS "View & change the current configuration", #else "View the current configuration", #endif - TRUE }, - { "show-version", - cgi_show_version, + TRUE }, + { "show-version", + cgi_show_version, "View the source code version numbers", - TRUE }, - { "show-request", - cgi_show_request, + TRUE }, + { "show-request", + cgi_show_request, "View the request headers", - TRUE }, + TRUE }, { "show-url-info", - cgi_show_url_info, + cgi_show_url_info, "Look up which actions apply to a URL and why", TRUE }, #ifdef FEATURE_TOGGLE { "toggle", - cgi_toggle, + cgi_toggle, "Toggle Privoxy on or off", FALSE }, #endif /* def FEATURE_TOGGLE */ #ifdef FEATURE_CGI_EDIT_ACTIONS { "edit-actions", /* Edit the actions list */ - cgi_edit_actions, + cgi_edit_actions, NULL, FALSE }, { "eaa", /* Shortcut for edit-actions-add-url-form */ - cgi_edit_actions_add_url_form, + cgi_edit_actions_add_url_form, NULL, FALSE }, { "eau", /* Shortcut for edit-actions-url-form */ - cgi_edit_actions_url_form, + cgi_edit_actions_url_form, NULL, FALSE }, { "ear", /* Shortcut for edit-actions-remove-url-form */ - cgi_edit_actions_remove_url_form, + cgi_edit_actions_remove_url_form, NULL, FALSE }, { "eal", /* Shortcut for edit-actions-list */ - cgi_edit_actions_list, + cgi_edit_actions_list, NULL, FALSE }, { "eafu", /* Shortcut for edit-actions-for-url */ - cgi_edit_actions_for_url, + cgi_edit_actions_for_url, NULL, FALSE }, { "eas", /* Shortcut for edit-actions-submit */ - cgi_edit_actions_submit, + cgi_edit_actions_submit, NULL, FALSE }, { "easa", /* Shortcut for edit-actions-section-add */ - cgi_edit_actions_section_add, + cgi_edit_actions_section_add, NULL, FALSE }, { "easr", /* Shortcut for edit-actions-section-remove */ - cgi_edit_actions_section_remove, + cgi_edit_actions_section_remove, NULL, FALSE }, { "eass", /* Shortcut for edit-actions-section-swap */ - cgi_edit_actions_section_swap, + cgi_edit_actions_section_swap, NULL, FALSE }, { "edit-actions-for-url", - cgi_edit_actions_for_url, + cgi_edit_actions_for_url, NULL, FALSE /* Edit the actions for (a) specified URL(s) */ }, { "edit-actions-list", - cgi_edit_actions_list, + cgi_edit_actions_list, NULL, TRUE /* Edit the actions list */ }, { "edit-actions-submit", - cgi_edit_actions_submit, + cgi_edit_actions_submit, NULL, FALSE /* Change the actions for (a) specified URL(s) */ }, { "edit-actions-url", - cgi_edit_actions_url, + cgi_edit_actions_url, NULL, FALSE /* Change a URL pattern in the actionsfile */ }, { "edit-actions-url-form", - cgi_edit_actions_url_form, + cgi_edit_actions_url_form, NULL, FALSE /* Form to change a URL pattern in the actionsfile */ }, { "edit-actions-add-url", - cgi_edit_actions_add_url, + cgi_edit_actions_add_url, NULL, FALSE /* Add a URL pattern to the actionsfile */ }, { "edit-actions-add-url-form", - cgi_edit_actions_add_url_form, + cgi_edit_actions_add_url_form, NULL, FALSE /* Form to add a URL pattern to the actionsfile */ }, { "edit-actions-remove-url", - cgi_edit_actions_remove_url, + cgi_edit_actions_remove_url, NULL, FALSE /* Remove a URL pattern from the actionsfile */ }, { "edit-actions-remove-url-form", - cgi_edit_actions_remove_url_form, + cgi_edit_actions_remove_url_form, NULL, FALSE /* Form to remove a URL pattern from the actionsfile */ }, { "edit-actions-section-add", - cgi_edit_actions_section_add, + cgi_edit_actions_section_add, NULL, FALSE /* Remove a section from the actionsfile */ }, { "edit-actions-section-remove", - cgi_edit_actions_section_remove, + cgi_edit_actions_section_remove, NULL, FALSE /* Remove a section from the actionsfile */ }, { "edit-actions-section-swap", - cgi_edit_actions_section_swap, + cgi_edit_actions_section_swap, NULL, FALSE /* Swap two sections in the actionsfile */ }, #endif /* def FEATURE_CGI_EDIT_ACTIONS */ - { "error-favicon.ico", - cgi_send_error_favicon, + { "error-favicon.ico", + cgi_send_error_favicon, NULL, TRUE /* Sends the favicon image for error pages. */ }, - { "favicon.ico", - cgi_send_default_favicon, + { "favicon.ico", + cgi_send_default_favicon, NULL, TRUE /* Sends the default favicon image. */ }, - { "robots.txt", - cgi_robots_txt, - NULL, TRUE /* Sends a robots.txt file to tell robots to go away. */ }, + { "robots.txt", + cgi_robots_txt, + NULL, TRUE /* Sends a robots.txt file to tell robots to go away. */ }, { "send-banner", - cgi_send_banner, + cgi_send_banner, NULL, TRUE /* Send a built-in image */ }, { "send-stylesheet", - cgi_send_stylesheet, + cgi_send_stylesheet, NULL, FALSE /* Send templates/cgi-style.css */ }, { "t", - cgi_transparent_image, + cgi_transparent_image, NULL, TRUE /* Send a transparent image (short name) */ }, { "url-info-osd.xml", - cgi_send_url_info_osd, + cgi_send_url_info_osd, NULL, TRUE /* Send templates/url-info-osd.xml */ }, { "user-manual", cgi_send_user_manual, @@ -271,13 +877,6 @@ const char image_blank_data[] = const size_t image_pattern_length = sizeof(image_pattern_data) - 1; const size_t image_blank_length = sizeof(image_blank_data) - 1;
-#ifdef FEATURE_COMPRESSION -/* - * Minimum length which a buffer has to reach before - * we bother to (re-)compress it. Completely arbitrary. - */ -const size_t LOWER_LENGTH_LIMIT_FOR_COMPRESSION = 1024U; -#endif
static struct http_response cgi_error_memory_response[1];
@@ -287,7 +886,7 @@ static struct map *parse_cgi_parameters(char *argstring);
/********************************************************************* - * + * * Function : dispatch_cgi * * Description : Checks if a request URL has either the magical @@ -349,7 +948,7 @@ struct http_response *dispatch_cgi(struct client_state *csp) return NULL; }
- /* + /* * This is a CGI call. */
@@ -394,7 +993,7 @@ static char *grep_cgi_referrer(const struct client_state *csp)
/********************************************************************* - * + * * Function : referrer_is_safe * * Description : Decides whether we trust the Referer for @@ -442,7 +1041,7 @@ static int referrer_is_safe(const struct client_state *csp) }
/********************************************************************* - * + * * Function : dispatch_known_cgi * * Description : Processes a CGI once dispatch_cgi has determined that @@ -480,7 +1079,7 @@ static struct http_response *dispatch_known_cgi(struct client_state * csp, { query_args_start++; } - if (*query_args_start == '/') + if (*query_args_start == '/') { *query_args_start++ = '\0'; if ((param_list = new_map())) @@ -515,7 +1114,7 @@ static struct http_response *dispatch_known_cgi(struct client_state * csp, return cgi_error_memory(); }
- /* + /* * Find and start the right CGI function */ d = cgi_dispatchers; @@ -558,15 +1157,13 @@ static struct http_response *dispatch_known_cgi(struct client_state * csp, if (err && (err != JB_ERR_MEMORY)) { /* Unexpected error! Shouldn't get here */ - log_error(LOG_LEVEL_ERROR, - "Unexpected CGI error %d in top-level handler. " - "Please file a bug report!", err); + log_error(LOG_LEVEL_ERROR, "Unexpected CGI error %d in top-level handler. Please file a bug report!", err); err = cgi_error_unknown(csp, rsp, err); } if (!err) { /* It worked */ - rsp->crunch_reason = CGI_CALL; + rsp->reason = RSP_REASON_CGI_CALL; return finish_http_response(csp, rsp); } else @@ -579,8 +1176,8 @@ static struct http_response *dispatch_known_cgi(struct client_state * csp, d++; } } - - + + /********************************************************************* * * Function : parse_cgi_parameters @@ -606,7 +1203,7 @@ static struct map *parse_cgi_parameters(char *argstring) return NULL; }
- /* + /* * IE 5 does, of course, violate RFC 2316 Sect 4.1 and sends * the fragment identifier along with the request, so we must * cut it off here, so it won't pollute the CGI params: @@ -775,7 +1372,7 @@ jb_err get_number_param(struct client_state *csp, assert(name); assert(pvalue);
- *pvalue = 0; + *pvalue = 0;
param = lookup(parameters, name); if (!*param) @@ -828,13 +1425,15 @@ jb_err get_number_param(struct client_state *csp, * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) * 2 : templatename = Which template should be used for the answer + * 3 : sys_err = system error number * * Returns : A http_response. If we run out of memory, this * will be cgi_error_memory(). * *********************************************************************/ struct http_response *error_response(struct client_state *csp, - const char *templatename) + const char *templatename, + int sys_err) { jb_err err; struct http_response *rsp; @@ -867,7 +1466,8 @@ struct http_response *error_response(struct client_state *csp, if (!err) err = map(exports, "host", 1, html_encode(csp->http->host), 0); if (!err) err = map(exports, "hostport", 1, html_encode(csp->http->hostport), 0); if (!err) err = map(exports, "path", 1, html_encode_and_free_original(path), 0); - if (!err) err = map(exports, "protocol", 1, csp->http->ssl ? "https://" : "http://", 1); + if (!err) err = map(exports, "error", 1, html_encode_and_free_original(safe_strerror(sys_err)), 0); + if (!err) err = map(exports, "protocol", 1, csp->http->ssl ? "https://" : "http://", 1); if (!err) { err = map(exports, "host-ip", 1, html_encode(csp->http->host_ip_addr_str), 0); @@ -889,7 +1489,13 @@ struct http_response *error_response(struct client_state *csp, if (!strcmp(templatename, "no-such-domain")) { rsp->status = strdup("404 No such domain"); - rsp->crunch_reason = NO_SUCH_DOMAIN; + if (rsp->status == NULL) + { + free_map(exports); + free_http_response(rsp); + return cgi_error_memory(); + } + rsp->reason = RSP_REASON_NO_SUCH_DOMAIN; } else if (!strcmp(templatename, "forwarding-failed")) { @@ -943,37 +1549,26 @@ struct http_response *error_response(struct client_state *csp,
if (!err) err = map(exports, "forwarding-type", 1, socks_type, 1); if (!err) err = map(exports, "error-message", 1, html_encode(csp->error_message), 0); - if ((NULL == csp->error_message) || err) + + if (!err) rsp->status = strdup("503 Forwarding failure"); + if ((rsp->status == NULL) || (NULL == csp->error_message) || err) { free_map(exports); free_http_response(rsp); return cgi_error_memory(); } - - rsp->status = strdup("503 Forwarding failure"); - rsp->crunch_reason = FORWARDING_FAILED; + rsp->reason = RSP_REASON_FORWARDING_FAILED; } else if (!strcmp(templatename, "connect-failed")) { rsp->status = strdup("503 Connect failed"); - rsp->crunch_reason = CONNECT_FAILED; - } - else if (!strcmp(templatename, "connection-timeout")) - { - rsp->status = strdup("504 Connection timeout"); - rsp->crunch_reason = CONNECTION_TIMEOUT; - } - else if (!strcmp(templatename, "no-server-data")) - { - rsp->status = strdup("502 No data received from server or forwarder"); - rsp->crunch_reason = NO_SERVER_DATA; - } - - if (rsp->status == NULL) - { - free_map(exports); - free_http_response(rsp); - return cgi_error_memory(); + if (rsp->status == NULL) + { + free_map(exports); + free_http_response(rsp); + return cgi_error_memory(); + } + rsp->reason = RSP_REASON_CONNECT_FAILED; }
err = template_fill_for_cgi(csp, templatename, exports, rsp); @@ -1050,23 +1645,23 @@ void cgi_init_error_messages(void) "Content-Type: text/html\r\n" "\r\n"; cgi_error_memory_response->body = - "<html>\n" - "<head>\n" - " <title>500 Internal Privoxy Error</title>\n" + "<html>\r\n" + "<head>\r\n" + " <title>500 Internal Privoxy Error</title>\r\n" " <link rel="shortcut icon" href="" CGI_PREFIX "error-favicon.ico" type="image/x-icon">" - "</head>\n" - "<body>\n" - "<h1>500 Internal Privoxy Error</h1>\n" - "<p>Privoxy <b>ran out of memory</b> while processing your request.</p>\n" - "<p>Please contact your proxy administrator, or try again later</p>\n" - "</body>\n" - "</html>\n"; + "</head>\r\n" + "<body>\r\n" + "<h1>500 Internal Privoxy Error</h1>\r\n" + "<p>Privoxy <b>ran out of memory</b> while processing your request.</p>\r\n" + "<p>Please contact your proxy administrator, or try again later</p>\r\n" + "</body>\r\n" + "</html>\r\n";
cgi_error_memory_response->head_length = strlen(cgi_error_memory_response->head); cgi_error_memory_response->content_length = strlen(cgi_error_memory_response->body); - cgi_error_memory_response->crunch_reason = OUT_OF_MEMORY; + cgi_error_memory_response->reason = RSP_REASON_OUT_OF_MEMORY; }
@@ -1098,7 +1693,7 @@ struct http_response *cgi_error_memory(void) * * Description : Almost-CGI function that is called if a template * cannot be loaded. Note this is not a true CGI, - * it takes a template name rather than a map of + * it takes a template name rather than a map of * parameters. * * Parameters : @@ -1108,7 +1703,7 @@ struct http_response *cgi_error_memory(void) * be loaded. * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_error_no_template(const struct client_state *csp, @@ -1118,18 +1713,18 @@ jb_err cgi_error_no_template(const struct client_state *csp, static const char status[] = "500 Internal Privoxy Error"; static const char body_prefix[] = - "<html>\n" - "<head>\n" - " <title>500 Internal Privoxy Error</title>\n" + "<html>\r\n" + "<head>\r\n" + " <title>500 Internal Privoxy Error</title>\r\n" " <link rel="shortcut icon" href="" CGI_PREFIX "error-favicon.ico" type="image/x-icon">" - "</head>\n" - "<body>\n" - "<h1>500 Internal Privoxy Error</h1>\n" - "<p>Privoxy encountered an error while processing your request:</p>\n" + "</head>\r\n" + "<body>\r\n" + "<h1>500 Internal Privoxy Error</h1>\r\n" + "<p>Privoxy encountered an error while processing your request:</p>\r\n" "<p><b>Could not load template file <code>"; static const char body_suffix[] = - "</code> or one of its included components.</b></p>\n" - "<p>Please contact your proxy administrator.</p>\n" + "</code> or one of its included components.</b></p>\r\n" + "<p>Please contact your proxy administrator.</p>\r\n" "<p>If you are the proxy administrator, please put the required file(s)" "in the <code><i>(confdir)</i>/templates</code> directory. The " "location of the <code><i>(confdir)</i></code> directory " @@ -1138,9 +1733,9 @@ jb_err cgi_error_no_template(const struct client_state *csp, #ifndef _WIN32 ", or <code>/etc/privoxy/</code>" #endif /* ndef _WIN32 */ - ").</p>\n" - "</body>\n" - "</html>\n"; + ").</p>\r\n" + "</body>\r\n" + "</html>\r\n"; const size_t body_size = strlen(body_prefix) + strlen(template_name) + strlen(body_suffix) + 1;
assert(csp); @@ -1195,7 +1790,7 @@ jb_err cgi_error_no_template(const struct client_state *csp, * 3 : error_to_report = Error code to report. * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_error_unknown(const struct client_state *csp, @@ -1205,24 +1800,28 @@ jb_err cgi_error_unknown(const struct client_state *csp, static const char status[] = "500 Internal Privoxy Error"; static const char body_prefix[] = - "<html>\n" - "<head>\n" - " <title>500 Internal Privoxy Error</title>\n" + "<html>\r\n" + "<head>\r\n" + " <title>500 Internal Privoxy Error</title>\r\n" " <link rel="shortcut icon" href="" CGI_PREFIX "error-favicon.ico" type="image/x-icon">" - "</head>\n" - "<body>\n" - "<h1>500 Internal Privoxy Error</h1>\n" - "<p>Privoxy encountered an error while processing your request:</p>\n" + "</head>\r\n" + "<body>\r\n" + "<h1>500 Internal Privoxy Error</h1>\r\n" + "<p>Privoxy encountered an error while processing your request:</p>\r\n" "<p><b>Unexpected internal error: "; static const char body_suffix[] = - "</b></p>\n" + "</b></p>\r\n" "<p>Please " "<a href="http://sourceforge.net/tracker/?group_id=11118&atid=111118%5C%22%3E" - "file a bug report</a>.</p>\n" - "</body>\n" - "</html>\n"; - /* Includes room for larger error numbers in the future. */ - const size_t body_size = sizeof(body_prefix) + sizeof(body_suffix) + 5; + "file a bug report</a>.</p>\r\n" + "</body>\r\n" + "</html>\r\n"; + char errnumbuf[30]; + /* + * Due to sizeof(errnumbuf), body_size will be slightly + * bigger than necessary but it doesn't really matter. + */ + const size_t body_size = strlen(body_prefix) + sizeof(errnumbuf) + strlen(body_suffix) + 1; assert(csp); assert(rsp);
@@ -1233,15 +1832,18 @@ jb_err cgi_error_unknown(const struct client_state *csp, rsp->content_length = 0; rsp->head_length = 0; rsp->is_static = 0; - rsp->crunch_reason = INTERNAL_ERROR; + rsp->reason = RSP_REASON_INTERNAL_ERROR; + + snprintf(errnumbuf, sizeof(errnumbuf), "%d", error_to_report);
rsp->body = malloc(body_size); if (rsp->body == NULL) { return JB_ERR_MEMORY; } - - snprintf(rsp->body, body_size, "%s%d%s", body_prefix, error_to_report, body_suffix); + strlcpy(rsp->body, body_prefix, body_size); + strlcat(rsp->body, errnumbuf, body_size); + strlcat(rsp->body, body_suffix, body_size);
rsp->status = strdup(status); if (rsp->status == NULL) @@ -1259,7 +1861,7 @@ jb_err cgi_error_unknown(const struct client_state *csp, * * Description : CGI function that is called if the parameters * (query string) for a CGI were wrong. - * + * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) * 2 : rsp = http_response data structure for output @@ -1267,7 +1869,7 @@ jb_err cgi_error_unknown(const struct client_state *csp, * CGI Parameters : none * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_error_bad_param(const struct client_state *csp, @@ -1289,7 +1891,7 @@ jb_err cgi_error_bad_param(const struct client_state *csp,
/********************************************************************* * - * Function : cgi_redirect + * Function : cgi_redirect * * Description : CGI support function to generate a HTTP redirect * message @@ -1301,7 +1903,7 @@ jb_err cgi_error_bad_param(const struct client_state *csp, * CGI Parameters : None * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_redirect (struct http_response * rsp, const char *target) @@ -1336,8 +1938,8 @@ jb_err cgi_redirect (struct http_response * rsp, const char *target) * FIXME: I currently only work for actions, and would * like to be generalized for other topics. * - * Parameters : - * 1 : item = item (will NOT be free()d.) + * Parameters : + * 1 : item = item (will NOT be free()d.) * It is assumed to be HTML-safe. * 2 : config = The current configuration. * @@ -1368,7 +1970,7 @@ char *add_help_link(const char *item, string_join (&result, string_toupper(item)); string_append(&result, "">"); string_append(&result, item); - string_append(&result, "</a>"); + string_append(&result, "</a> ");
return result; } @@ -1382,7 +1984,7 @@ char *add_help_link(const char *item, * HTTP header - e.g.: * "Sun, 06 Nov 1994 08:49:37 GMT" * - * Parameters : + * Parameters : * 1 : time_offset = Time returned will be current time * plus this number of seconds. * 2 : buf = Destination for result. @@ -1395,6 +1997,12 @@ char *add_help_link(const char *item, *********************************************************************/ void get_http_time(int time_offset, char *buf, size_t buffer_size) { + static const char day_names[7][4] = + { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" }; + static const char month_names[12][4] = + { "Jan", "Feb", "Mar", "Apr", "May", "Jun", + "Jul", "Aug", "Sep", "Oct", "Nov", "Dec" }; + struct tm *t; time_t current_time; #if defined(HAVE_GMTIME_R) @@ -1411,7 +2019,7 @@ void get_http_time(int time_offset, char *buf, size_t buffer_size) /* get and save the gmt */ #if HAVE_GMTIME_R t = gmtime_r(¤t_time, &dummy); -#elif defined(MUTEX_LOCKS_AVAILABLE) +#elif FEATURE_PTHREAD privoxy_mutex_lock(&gmtime_mutex); t = gmtime(¤t_time); privoxy_mutex_unlock(&gmtime_mutex); @@ -1419,7 +2027,17 @@ void get_http_time(int time_offset, char *buf, size_t buffer_size) t = gmtime(¤t_time); #endif
- strftime(buf, buffer_size, "%a, %d %b %Y %H:%M:%S GMT", t); + /* Format: "Sun, 06 Nov 1994 08:49:37 GMT" */ + snprintf(buf, buffer_size, + "%s, %02d %s %4d %02d:%02d:%02d GMT", + day_names[t->tm_wday], + t->tm_mday, + month_names[t->tm_mon], + t->tm_year + 1900, + t->tm_hour, + t->tm_min, + t->tm_sec + );
}
@@ -1457,7 +2075,7 @@ static void get_locale_time(char *buf, size_t buffer_size)
#if HAVE_LOCALTIME_R timeptr = localtime_r(¤t_time, &dummy); -#elif defined(MUTEX_LOCKS_AVAILABLE) +#elif FEATURE_PTHREAD privoxy_mutex_lock(&localtime_mutex); timeptr = localtime(¤t_time); privoxy_mutex_unlock(&localtime_mutex); @@ -1469,63 +2087,6 @@ static void get_locale_time(char *buf, size_t buffer_size)
}
- -#ifdef FEATURE_COMPRESSION -/********************************************************************* - * - * Function : compress_buffer - * - * Description : Compresses the content of a buffer with zlib's deflate - * Allocates a new buffer for the result, free'ing it is - * up to the caller. - * - * Parameters : - * 1 : buffer = buffer whose content should be compressed - * 2 : buffer_length = length of the buffer - * 3 : compression_level = compression level for compress2() - * - * Returns : NULL on error, otherwise a pointer to the compressed - * content of the input buffer. - * - *********************************************************************/ -char *compress_buffer(char *buffer, size_t *buffer_length, int compression_level) -{ - char *compressed_buffer; - uLongf new_length; - assert(-1 <= compression_level && compression_level <= 9); - - /* Let zlib figure out the maximum length of the compressed data */ - new_length = compressBound((uLongf)*buffer_length); - - compressed_buffer = malloc(new_length); - if (NULL == compressed_buffer) - { - log_error(LOG_LEVEL_FATAL, - "Out of memory allocation compression buffer."); - } - - if (Z_OK != compress2((Bytef *)compressed_buffer, &new_length, - (Bytef *)buffer, *buffer_length, compression_level)) - { - log_error(LOG_LEVEL_ERROR, - "compress2() failed. Buffer size: %d, compression level: %d.", - new_length, compression_level); - freez(compressed_buffer); - return NULL; - } - - log_error(LOG_LEVEL_RE_FILTER, - "Compressed content from %d to %d bytes. Compression level: %d", - *buffer_length, new_length, compression_level); - - *buffer_length = (size_t)new_length; - - return compressed_buffer; - -} -#endif - - /********************************************************************* * * Function : finish_http_response @@ -1555,7 +2116,7 @@ struct http_response *finish_http_response(const struct client_state *csp, struc return rsp; }
- /* + /* * Fill in the HTTP Status, using HTTP/1.1 * unless the client asked for HTTP/1.0. */ @@ -1564,31 +2125,13 @@ struct http_response *finish_http_response(const struct client_state *csp, struc rsp->status ? rsp->status : "200 OK"); err = enlist_first(rsp->headers, buf);
- /* + /* * Set the Content-Length */ if (rsp->content_length == 0) { rsp->content_length = rsp->body ? strlen(rsp->body) : 0; } - -#ifdef FEATURE_COMPRESSION - if (!err && (csp->flags & CSP_FLAG_CLIENT_SUPPORTS_DEFLATE) - && (rsp->content_length > LOWER_LENGTH_LIMIT_FOR_COMPRESSION)) - { - char *compressed_content; - - compressed_content = compress_buffer(rsp->body, &rsp->content_length, - csp->config->compression_level); - if (NULL != compressed_content) - { - freez(rsp->body); - rsp->body = compressed_content; - err = enlist_unique_header(rsp->headers, "Content-Encoding", "deflate"); - } - } -#endif - if (!err) { snprintf(buf, sizeof(buf), "Content-Length: %d", (int)rsp->content_length); @@ -1630,7 +2173,7 @@ struct http_response *finish_http_response(const struct client_state *csp, struc * Last-Modified: set to date/time the page was last changed. * Expires: set to date/time page next needs reloading. * Cache-Control: set to "no-cache" if applicable. - * + * * See http://www.w3.org/Protocols/rfc2068/rfc2068 */ if (rsp->is_static) @@ -1687,9 +2230,7 @@ struct http_response *finish_http_response(const struct client_state *csp, struc if (!err) err = enlist_unique_header(rsp->headers, "Date", buf); if (!strncmpic(rsp->status, "403", 3) || !strncmpic(rsp->status, "404", 3) - || !strncmpic(rsp->status, "502", 3) - || !strncmpic(rsp->status, "503", 3) - || !strncmpic(rsp->status, "504", 3)) + || !strncmpic(rsp->status, "503", 3)) { if (!err) err = enlist_unique_header(rsp->headers, "Last-Modified", "Wed, 08 Jun 1955 12:00:00 GMT"); } @@ -1701,12 +2242,15 @@ struct http_response *finish_http_response(const struct client_state *csp, struc if (!err) err = enlist_unique_header(rsp->headers, "Pragma", "no-cache"); }
- if (!err && !(csp->flags & CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE)) - { - err = enlist_unique_header(rsp->headers, "Connection", "close"); - } - /* + * Quoting RFC 2616: + * + * HTTP/1.1 applications that do not support persistent connections MUST + * include the "close" connection option in every message. + */ + if (!err) err = enlist_unique_header(rsp->headers, "Connection", "close"); + + /* * Write the head */ if (err || (NULL == (rsp->head = list_to_text(rsp->headers)))) @@ -1786,11 +2330,11 @@ void free_http_response(struct http_response *rsp) * following an #include statament * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * JB_ERR_FILE if the template file cannot be read * *********************************************************************/ -jb_err template_load(const struct client_state *csp, char **template_ptr, +jb_err template_load(const struct client_state *csp, char **template_ptr, const char *templatename, int recursive) { jb_err err; @@ -1872,7 +2416,7 @@ jb_err template_load(const struct client_state *csp, char **template_ptr, } free(full_path);
- /* + /* * Read the file, ignoring comments, and honoring #include * statements, unless we're already called recursively. * @@ -1927,7 +2471,7 @@ jb_err template_load(const struct client_state *csp, char **template_ptr, * HTML template by replacing @name@ with value using * pcrs, for each item in the output map. * - * Note that a leading '$' character in the export map's + * Note that a leading '$' charachter in the export map's * values will be stripped and toggle on backreference * interpretation. * @@ -1960,7 +2504,7 @@ jb_err template_fill(char **template_ptr, const struct map *exports) file_buffer = *template_ptr; size = strlen(file_buffer) + 1;
- /* + /* * Assemble pcrs joblist from exports map */ for (m = exports->first; m != NULL; m = m->next) @@ -1978,7 +2522,7 @@ jb_err template_fill(char **template_ptr, const struct map *exports) else { /* - * Treat the "replace with" text as a literal string - + * Treat the "replace with" text as a literal string - * no quoting needed, no backreferences allowed. * ("Trivial" ['T'] flag). */ @@ -1992,7 +2536,7 @@ jb_err template_fill(char **template_ptr, const struct map *exports)
/* Make and run job. */ job = pcrs_compile(buf, m->value, flags, &error); - if (job == NULL) + if (job == NULL) { if (error == PCRS_ERR_NOMEM) { @@ -2019,10 +2563,10 @@ jb_err template_fill(char **template_ptr, const struct map *exports)
if (error < 0) { - /* + /* * Substitution failed, keep the original buffer, * log the problem and ignore it. - * + * * The user might see some unresolved @CGI_VARIABLES@, * but returning a special CGI error page seems unreasonable * and could mask more important error messages. @@ -2074,7 +2618,7 @@ jb_err template_fill_for_cgi(const struct client_state *csp, struct http_response *rsp) { jb_err err; - + assert(csp); assert(templatename); assert(exports); @@ -2119,7 +2663,6 @@ struct map *default_exports(const struct client_state *csp, const char *caller) struct map * exports; int local_help_exists = 0; char *ip_address = NULL; - char *port = NULL; char *hostname = NULL;
assert(csp); @@ -2132,12 +2675,12 @@ struct map *default_exports(const struct client_state *csp, const char *caller)
if (csp->config->hostname) { - get_host_information(csp->cfd, &ip_address, &port, NULL); + get_host_information(csp->cfd, &ip_address, NULL); hostname = strdup(csp->config->hostname); } else { - get_host_information(csp->cfd, &ip_address, &port, &hostname); + get_host_information(csp->cfd, &ip_address, &hostname); }
err = map(exports, "version", 1, html_encode(VERSION), 0); @@ -2145,8 +2688,6 @@ struct map *default_exports(const struct client_state *csp, const char *caller) if (!err) err = map(exports, "time", 1, html_encode(buf), 0); if (!err) err = map(exports, "my-ip-address", 1, html_encode(ip_address ? ip_address : "unknown"), 0); freez(ip_address); - if (!err) err = map(exports, "my-port", 1, html_encode(port ? port : "unkown"), 0); - freez(port); if (!err) err = map(exports, "my-hostname", 1, html_encode(hostname ? hostname : "unknown"), 0); freez(hostname); if (!err) err = map(exports, "homepage", 1, html_encode(HOME_PAGE_URL), 0); @@ -2171,6 +2712,9 @@ struct map *default_exports(const struct client_state *csp, const char *caller) if (!err) err = map_block_killer(exports, "can-toggle"); #endif
+ snprintf(buf, sizeof(buf), "%d", csp->config->hport); + if (!err) err = map(exports, "my-port", 1, buf, 1); + if(!strcmp(CODE_STATUS, "stable")) { if (!err) err = map_block_killer(exports, "unstable"); @@ -2221,12 +2765,12 @@ struct map *default_exports(const struct client_state *csp, const char *caller) * "if-<name>-start.*if-<name>-end" to the given * export list. * - * Parameters : + * Parameters : * 1 : exports = map to extend * 2 : name = name of conditional block * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err map_block_killer(struct map *exports, const char *name) @@ -2250,12 +2794,12 @@ jb_err map_block_killer(struct map *exports, const char *name) * by map-block-killer, to save a few bytes. * i.e. removes "@if-<name>-start@" and "@if-<name>-end@" * - * Parameters : + * Parameters : * 1 : exports = map to extend * 2 : name = name of conditional block * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err map_block_keep(struct map *exports, const char *name) @@ -2296,13 +2840,13 @@ jb_err map_block_keep(struct map *exports, const char *name) * The control structure and one of the alternatives * will be hidden. * - * Parameters : + * Parameters : * 1 : exports = map to extend * 2 : name = name of conditional block * 3 : choose_first = nonzero for first, zero for second. * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err map_conditional(struct map *exports, const char *name, int choose_first) @@ -2334,7 +2878,7 @@ jb_err map_conditional(struct map *exports, const char *name, int choose_first) * * Function : make_menu * - * Description : Returns an HTML-formatted menu of the available + * Description : Returns an HTML-formatted menu of the available * unhidden CGIs, excluding the one given in <self> * and the toggle CGI if toggling is disabled. * @@ -2342,7 +2886,7 @@ jb_err map_conditional(struct map *exports, const char *name, int choose_first) * 1 : self = name of CGI to leave out, can be NULL for * complete listing. * 2 : feature_flags = feature bitmap from csp->config - * + * * * Returns : menu string, or NULL on out-of-memory error. * @@ -2383,7 +2927,7 @@ char *make_menu(const char *self, const unsigned feature_flags) html_encoded_prefix = html_encode(CGI_PREFIX); if (html_encoded_prefix == NULL) { - return NULL; + return NULL; } else { diff --git a/external/privoxy/cgi.h b/external/privoxy/cgi.h index aedaa91..6228b32 100644 --- a/external/privoxy/cgi.h +++ b/external/privoxy/cgi.h @@ -1,24 +1,24 @@ #ifndef CGI_H_INCLUDED #define CGI_H_INCLUDED -#define CGI_H_VERSION "$Id: cgi.h,v 1.41 2011/09/04 11:10:56 fabiankeil Exp $" +#define CGI_H_VERSION "$Id: cgi.h,v 1.35 2008/05/21 15:24:37 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/cgi.h,v $ * * Purpose : Declares functions to intercept request, generate * html or gif answers, and to compose HTTP resonses. - * + * * Functions declared include: + * * - * - * Copyright : Written by and Copyright (C) 2001-2009 the + * Copyright : Written by and Copyright (C) 2001-2007 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -36,8 +36,161 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: cgi.h,v $ + * Revision 1.35 2008/05/21 15:24:37 fabiankeil + * Mark csp as immutable for a bunch of functions. + * + * Revision 1.34 2008/04/17 14:40:48 fabiankeil + * Provide get_http_time() with the buffer size so it doesn't + * have to blindly assume that the buffer is big enough. + * + * Revision 1.33 2007/01/28 13:41:17 fabiankeil + * - Add HEAD support to finish_http_response. + * - Add error favicon to internal HTML error messages. + * + * Revision 1.32 2006/12/17 17:53:39 fabiankeil + * Suppress the toggle link if remote toggling is disabled. + * + * Revision 1.31 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.29.2.2 2004/02/17 13:30:23 oes + * Moved cgi_error_disabled() from cgiedit.c to + * cgi.c to re-enable build with --disable-editor. + * Fixes Bug #892744. Thanks to Matthew Fischer + * for spotting. + * + * Revision 1.29.2.1 2003/12/17 16:33:28 oes + * Added prototype of new function cgi_redirect + * + * Revision 1.29 2002/05/19 11:33:21 jongfoster + * If a CGI error was not handled, and propogated back to + * dispatch_known_cgi(), then it was assumed to be "out of memory". + * This gave a very misleading error message. + * + * Now other errors will cause a simple message giving the error + * number and asking the user to report a bug. + * + * Bug report: + * http://sourceforge.net/tracker/index.php?func=detail + * &aid=557905&group_id=11118&atid=111118 + * + * Revision 1.28 2002/04/26 12:54:03 oes + * New function add_help_link + * + * Revision 1.27 2002/04/24 02:16:51 oes + * Moved get_char_param, get_string_param and get_number_param here from cgiedit.c + * + * Revision 1.26 2002/04/10 13:38:35 oes + * load_template signature changed + * + * Revision 1.25 2002/04/08 20:50:25 swa + * fixed JB spelling + * + * Revision 1.24 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.23 2002/03/24 16:18:15 jongfoster + * Removing old logo + * + * Revision 1.22 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.21 2002/03/07 03:48:38 oes + * - Changed built-in images from GIF to PNG + * (with regard to Unisys patent issue) + * - Added a 4x4 pattern PNG which is less intrusive + * than the logo but also clearly marks the deleted banners + * + * Revision 1.20 2002/03/04 17:53:22 oes + * Fixed compiled warning + * + * Revision 1.19 2002/01/21 00:33:52 jongfoster + * Adding map_block_keep() to save a few bytes in the edit-actions-list HTML. + * + * Revision 1.18 2001/11/16 00:46:31 jongfoster + * Fixing compiler warnings + * + * Revision 1.17 2001/10/23 21:48:19 jongfoster + * Cleaning up error handling in CGI functions - they now send back + * a HTML error page and should never cause a FATAL error. (Fixes one + * potential source of "denial of service" attacks). + * + * CGI actions file editor that works and is actually useful. + * + * Ability to toggle Junkbuster remotely using a CGI call. + * + * You can turn off both the above features in the main configuration + * file, e.g. if you are running a multi-user proxy. + * + * Revision 1.16 2001/09/16 17:08:54 jongfoster + * Moving simple CGI functions from cgi.c to new file cgisimple.c + * + * Revision 1.15 2001/09/16 15:02:35 jongfoster + * Adding i.j.b/robots.txt. + * Inlining add_stats() since it's only ever called from one place. + * + * Revision 1.14 2001/09/16 11:38:02 jongfoster + * Splitting fill_template() into 2 functions: + * template_load() loads the file + * template_fill() performs the PCRS regexps. + * This is because the CGI edit interface has a "table row" + * template which is used many times in the page - this + * change means it's only loaded from disk once. + * + * Revision 1.13 2001/09/16 11:00:10 jongfoster + * New function alloc_http_response, for symmetry with free_http_response + * + * Revision 1.12 2001/09/13 23:31:25 jongfoster + * Moving image data to cgi.c rather than cgi.h. + * + * Revision 1.11 2001/08/05 16:06:20 jongfoster + * Modifiying "struct map" so that there are now separate header and + * "map_entry" structures. This means that functions which modify a + * map no longer need to return a pointer to the modified map. + * Also, it no longer reverses the order of the entries (which may be + * important with some advanced template substitutions). + * + * Revision 1.10 2001/08/01 21:19:22 jongfoster + * Moving file version information to a separate CGI page. + * + * Revision 1.9 2001/08/01 00:17:54 jongfoster + * Adding prototype for map_conditional + * + * Revision 1.8 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.7 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.6 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.5 2001/06/29 13:22:44 oes + * - Cleaned up + * - Added new functions: default_exports(), make_menu(), + * error_response() etc, ranamed others and changed + * param and return types. + * - Removed HTTP/HTML snipplets + * - Removed logentry from cancelled commit + * + * Revision 1.4 2001/06/09 10:50:58 jongfoster + * Changing "show URL info" handler to new style. + * Adding "extern" to some function prototypes. + * + * Revision 1.3 2001/06/03 19:12:16 oes + * introduced new cgi handling + * + * No revisions before 1.3 + * **********************************************************************/ - +
#include "project.h"
@@ -51,8 +204,9 @@ extern "C" { extern struct http_response *dispatch_cgi(struct client_state *csp);
/* Not exactly a CGI */ -extern struct http_response *error_response(struct client_state *csp, - const char *templatename); +extern struct http_response * error_response(struct client_state *csp, + const char *templatename, + int err);
/* * CGI support functions @@ -69,7 +223,7 @@ extern jb_err map_block_killer (struct map *exports, const char *name); extern jb_err map_block_keep (struct map *exports, const char *name); extern jb_err map_conditional (struct map *exports, const char *name, int choose_first);
-extern jb_err template_load(const struct client_state *csp, char ** template_ptr, +extern jb_err template_load(const struct client_state *csp, char ** template_ptr, const char *templatename, int recursive); extern jb_err template_fill(char ** template_ptr, const struct map *exports); extern jb_err template_fill_for_cgi(const struct client_state *csp, @@ -101,14 +255,6 @@ extern jb_err get_string_param(const struct map *parameters, const char **pparam); extern char get_char_param(const struct map *parameters, const char *param_name); -#ifdef FEATURE_COMPRESSION -/* - * Minimum length which a buffer has to reach before - * we bother to (re-)compress it. Completely arbitrary. - */ -extern const size_t LOWER_LENGTH_LIMIT_FOR_COMPRESSION; -extern char *compress_buffer(char *buffer, size_t *buffer_length, int compression_level); -#endif
/* * Text generators diff --git a/external/privoxy/cgiedit.c b/external/privoxy/cgiedit.c index 68b8965..6fca21f 100644 --- a/external/privoxy/cgiedit.c +++ b/external/privoxy/cgiedit.c @@ -1,4 +1,4 @@ -const char cgiedit_rcs[] = "$Id: cgiedit.c,v 1.71 2011/11/18 16:47:08 fabiankeil Exp $"; +const char cgiedit_rcs[] = "$Id: cgiedit.c,v 1.65 2009/03/08 14:19:22 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/cgiedit.c,v $ @@ -40,8 +40,361 @@ const char cgiedit_rcs[] = "$Id: cgiedit.c,v 1.71 2011/11/18 16:47:08 fabiankeil * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: cgiedit.c,v $ + * Revision 1.65 2009/03/08 14:19:22 fabiankeil + * Fix justified (but harmless) compiler warnings + * on platforms where sizeof(int) < sizeof(long). + * + * Revision 1.64 2009/03/01 18:43:09 fabiankeil + * Fix cparser warnings. + * + * Revision 1.63 2008/12/04 18:15:38 fabiankeil + * Fix some cparser warnings. + * + * Revision 1.62 2008/08/31 15:59:02 fabiankeil + * There's no reason to let remote toggling support depend + * on FEATURE_CGI_EDIT_ACTIONS, so make sure it doesn't. + * + * Revision 1.61 2008/03/24 18:12:52 fabiankeil + * Use sizeof() more often. + * + * Revision 1.60 2008/03/15 14:52:35 fabiankeil + * Add CGI editor support for the "disable all filters of this type" + * directives "-client-header-filter", "-server-header-filter", + * "-client-header-tagger" and "-server-header-tagger". + * + * Revision 1.59 2008/03/08 16:25:56 fabiankeil + * After three file modification time mismatches, turn the CGI editor off. + * + * Revision 1.58 2007/11/28 17:57:01 fabiankeil + * Fix double free in cgi_edit_actions_list(). + * Reported by adlab in BR#1840145. + * + * Revision 1.57 2007/10/27 13:32:23 fabiankeil + * Plug minor 5-year-old memory leak. Spotted by + * Valgrind and triggered by Privoxy-Regression-Test. + * + * Revision 1.56 2007/08/05 13:47:03 fabiankeil + * #1763173 from Stefan Huehner: s@const static@static const@. + * + * Revision 1.55 2007/05/31 11:50:20 fabiankeil + * Re-enable support for old-school URLs like + * http://config.privoxy.org/edit-actions-list?f=default + * in the action editor. + * + * They are no longer used by the CGI pages, but make it easier + * to reach the editor directly, without knowing the requested + * file's index in csp->config->actions_file[]. + * + * Revision 1.54 2007/05/14 10:33:51 fabiankeil + * - Use strlcpy() and strlcat() instead of strcpy() and strcat(). + * + * Revision 1.53 2007/04/15 16:39:20 fabiankeil + * Introduce tags as alternative way to specify which + * actions apply to a request. At the moment tags can be + * created based on client and server headers. + * + * Revision 1.52 2007/04/12 10:41:23 fabiankeil + * - Don't mistake VC++'s _snprintf() for a snprintf() replacement. + * - Move some cgi_edit_actions_for_url() variables into structs. + * - Remove bogus comment. + * + * Revision 1.51 2007/04/08 13:21:05 fabiankeil + * Reference action files in CGI URLs by id instead + * of using the first part of the file name. + * Fixes BR 1694250 and BR 1590556. + * + * Revision 1.50 2007/03/29 11:40:34 fabiankeil + * Divide @filter-params@ into @client-header-filter-params@ + * @content-filter-params@ and @server-header-filter-params@. + * + * Revision 1.49 2007/03/20 15:16:34 fabiankeil + * Use dedicated header filter actions instead of abusing "filter". + * Replace "filter-client-headers" and "filter-client-headers" + * with "server-header-filter" and "client-header-filter". + * + * Revision 1.48 2007/02/13 14:35:25 fabiankeil + * Replace hash escaping code to prevent + * crashes, memory and file corruption. + * + * Revision 1.47 2006/12/28 18:04:25 fabiankeil + * Fixed gcc43 conversion warnings. + * + * Revision 1.46 2006/12/27 18:44:52 fabiankeil + * Stop shadowing string.h's index(). + * + * Revision 1.45 2006/12/21 12:57:48 fabiankeil + * Add config option "split-large-forms" + * to work around the browser bug reported + * in BR #1570678. + * + * Revision 1.44 2006/12/09 13:49:16 fabiankeil + * Fix configure option --disable-toggle. + * Thanks to Peter Thoenen for reporting this. + * + * Revision 1.43 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.41.2.12 2006/01/30 15:16:25 david__schmidt + * Remove a little residual debugging info + * + * Revision 1.41.2.11 2006/01/29 23:10:56 david__schmidt + * Multiple filter file support + * + * Revision 1.41.2.10 2005/07/04 03:13:43 david__schmidt + * Undo some damaging memory leak patches + * + * Revision 1.41.2.9 2005/07/04 00:31:04 david__schmidt + * Removing a double free + * + * Revision 1.41.2.8 2005/05/07 21:50:54 david__schmidt + * A few memory leaks plugged (mostly on error paths) + * + * Revision 1.41.2.7 2004/02/17 13:30:23 oes + * Moved cgi_error_disabled() from cgiedit.c to + * cgi.c to re-enable build with --disable-editor. + * Fixes Bug #892744. Thanks to Matthew Fischer + * for spotting. + * + * Revision 1.41.2.6 2003/12/18 08:13:48 oes + * One line lost in last commit + * + * Revision 1.41.2.5 2003/12/17 16:33:47 oes + * - All edit functions that redirect back to the list page + * now use cgi_redirect + * - All redirects now contain useless parameter "foo", whose + * value are raw seconds since epoch, in order to force + * Opera and Konqueror to properly reload the list. Closes + * bug #859993 + * + * Revision 1.41.2.4 2003/03/11 11:53:59 oes + * Cosmetic: Renamed cryptic variable + * + * Revision 1.41.2.3 2002/11/12 15:01:41 oes + * Fix: Don't free uninitialized struct editable_file + * + * Revision 1.41.2.2 2002/08/05 20:02:59 oes + * Bugfix: "Insert new section at top" did not work properly if first non-comment line in file was of type FILE_LINE_ACTION + * + * Revision 1.41.2.1 2002/08/02 12:43:14 oes + * Fixed bug #588514: first_time now set on a per-string basis in actions_from_radio; javascriptify now called on copies + * + * Revision 1.41 2002/05/21 19:09:45 oes + * - Made Add/Edit/Remove URL Submit and Cancel + * buttons jump back to relevant section in eal + * - Bugfix: remove-url-form needs p export + * + * Revision 1.40 2002/05/19 11:34:35 jongfoster + * Handling read-only actions files better - report the actual + * error, not "Out of memory"! + * + * Bug report: + * http://sourceforge.net/tracker/index.php?func=detail + * &aid=557905&group_id=11118&atid=111118 + * + * Revision 1.39 2002/05/12 21:39:15 jongfoster + * - Adding Doxygen-style comments to structures and #defines. + * - Correcting function comments + * + * Revision 1.38 2002/05/03 23:00:38 jongfoster + * Support for templates for "standard actions" buttons. + * See bug #549871 + * + * Revision 1.37 2002/04/30 11:14:52 oes + * Made csp the first parameter in *action_to_html + * + * Revision 1.36 2002/04/26 21:53:30 jongfoster + * Fixing a memory leak. (Near, but not caused by, my earlier commit). + * + * Revision 1.35 2002/04/26 21:50:02 jongfoster + * Honouring default exports in edit-actions-for-url-filter template. + * + * Revision 1.34 2002/04/26 12:54:17 oes + * Adaptions to changes in actions.c + * + * Revision 1.33 2002/04/24 02:17:47 oes + * - Moved get_char_param, get_string_param and get_number_param to cgi.c + * - Comments + * - Activated Jon's code for editing multiple AFs + * - cgi_edit_list_actions now provides context-sensitive + * help, looks up all action sets from standard.action and + * makes buttons for them in the catchall section + * - cgi_edit_action_submit now honors a p parameter, looks up + * the corresponding action set, and sets the catchall pattern's + * actions accordingly. + * + * Revision 1.32 2002/04/19 16:55:31 jongfoster + * Fixing newline problems. If we do our own text file newline + * mangling, we don't want the library to do any, so we need to + * open the files in *binary* mode. + * + * Revision 1.31 2002/04/18 19:21:08 jongfoster + * Added code to detect "conventional" action files, that start + * with a set of actions for all URLs (the pattern "/"). + * These are special-cased in the "edit-actions-list" CGI, so + * that a special UI can be written for them. + * + * Revision 1.30 2002/04/10 13:38:35 oes + * load_template signature changed + * + * Revision 1.29 2002/04/08 16:59:08 oes + * Fixed comment + * + * Revision 1.28 2002/03/27 12:30:29 oes + * Deleted unsused variable + * + * Revision 1.27 2002/03/26 23:06:04 jongfoster + * Removing duplicate @ifs on the toggle page + * + * Revision 1.26 2002/03/26 22:59:17 jongfoster + * Fixing /toggle to display status consistently. + * + * Revision 1.25 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.24 2002/03/24 15:23:33 jongfoster + * Name changes + * + * Revision 1.23 2002/03/24 13:32:41 swa + * name change related issues + * + * Revision 1.22 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.21 2002/03/22 18:02:48 jongfoster + * Fixing remote toggle + * + * Revision 1.20 2002/03/16 20:28:34 oes + * Added descriptions to the filters so users will know what they select in the cgi editor + * + * Revision 1.19 2002/03/16 18:38:14 jongfoster + * Stopping stupid or malicious users from breaking the actions + * file using the web-based editor. + * + * Revision 1.18 2002/03/16 14:57:44 jongfoster + * Full support for enabling/disabling modular filters. + * + * Revision 1.17 2002/03/16 14:26:42 jongfoster + * First version of modular filters support - READ ONLY! + * Fixing a double-free bug in the out-of-memory handling in map_radio(). + * + * Revision 1.16 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.15 2002/03/06 22:54:35 jongfoster + * Automated function-comment nitpicking. + * + * Revision 1.14 2002/03/05 00:24:51 jongfoster + * Patch to always edit the current actions file. + * + * Revision 1.13 2002/03/04 02:07:59 david__schmidt + * Enable web editing of actions file on OS/2 (it had been broken all this time!) + * + * Revision 1.12 2002/03/03 09:18:03 joergs + * Made jumbjuster work on AmigaOS again. + * + * Revision 1.11 2002/01/23 01:03:31 jongfoster + * Fixing gcc [CygWin] compiler warnings + * + * Revision 1.10 2002/01/23 00:22:59 jongfoster + * Adding new function cgi_edit_actions_section_swap(), to reorder + * the actions file. + * + * Adding get_url_spec_param() to get a validated URL pattern. + * + * Moving edit_read_line() out of this file and into loaders.c. + * + * Adding missing html_encode() to many CGI functions. + * + * Moving the functions that #include actionlist.h to the end of the file, + * because the Visual C++ 97 debugger gets extremely confused if you try + * to debug any code that comes after them in the file. + * + * Major optimizations in cgi_edit_actions_list() to reduce the size of + * the generated HTML (down 40% from 550k to 304k), with major side-effects + * throughout the editor and templates. In particular, the length of the + * URLs throughout the editor has been drastically reduced, by cutting + * paramater names down to 1 character and CGI names down to 3-4 + * characters, by removing all non-essential CGI paramaters even at the + * expense of having to re-read the actions file for the most trivial + * page, and by using relative rather than absolute URLs. This means + * that this (typical example): + * + * <a href="http://ijbswa.sourceforge.net/config/edit-actions-url-form? + * filename=ijb&ver=1011487572&section=12&pattern=13 + * &oldval=www.oesterhelt.org%2Fdeanimate-demo"> + * + * is now this: + * + * <a href="eau?f=ijb&v=1011487572&p=13"> + * + * Revision 1.9 2002/01/17 20:56:22 jongfoster + * Replacing hard references to the URL of the config interface + * with #defines from project.h + * + * Revision 1.8 2001/11/30 23:35:51 jongfoster + * Renaming actionsfile to ijb.action + * + * Revision 1.7 2001/11/13 00:28:24 jongfoster + * - Renaming parameters from edit-actions-for-url so that they only + * contain legal JavaScript characters. If we wanted to write + * JavaScript that worked with Netscape 4, this is nessacery. + * (Note that at the moment the JavaScript doesn't actually work + * with Netscape 4, but now this is purely a template issue, not + * one affecting code). + * - Adding new CGIs for use by non-JavaScript browsers: + * edit-actions-url-form + * edit-actions-add-url-form + * edit-actions-remove-url-form + * - Fixing || bug. + * + * Revision 1.6 2001/10/29 03:48:09 david__schmidt + * OS/2 native needed a snprintf() routine. Added one to miscutil, brackedted + * by and __OS2__ ifdef. + * + * Revision 1.5 2001/10/25 03:40:48 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.4 2001/10/23 21:48:19 jongfoster + * Cleaning up error handling in CGI functions - they now send back + * a HTML error page and should never cause a FATAL error. (Fixes one + * potential source of "denial of service" attacks). + * + * CGI actions file editor that works and is actually useful. + * + * Ability to toggle JunkBuster remotely using a CGI call. + * + * You can turn off both the above features in the main configuration + * file, e.g. if you are running a multi-user proxy. + * + * Revision 1.3 2001/10/14 22:12:49 jongfoster + * New version of CGI-based actionsfile editor. + * Major changes, including: + * - Completely new file parser and file output routines + * - edit-actions CGI renamed edit-actions-for-url + * - All CGIs now need a filename parameter, except for... + * - New CGI edit-actions which doesn't need a filename, + * to allow you to start the editor up. + * - edit-actions-submit now works, and now automatically + * redirects you back to the main edit-actions-list handler. + * + * Revision 1.2 2001/09/16 17:05:14 jongfoster + * Removing unused #include showarg.h + * + * Revision 1.1 2001/09/16 15:47:37 jongfoster + * First version of CGI-based edit interface. This is very much a + * work-in-progress, and you can't actually use it to edit anything + * yet. You must #define FEATURE_CGI_EDIT_ACTIONS for these changes + * to have any effect. + * + * **********************************************************************/ - +
#include "config.h"
@@ -85,10 +438,10 @@ struct file_line { /** Next entry in the linked list */ struct file_line * next; - + /** The raw data, to write out if this line is unmodified. */ char * raw; - + /** Comments and/or whitespace to put before this line if it's modified and then written out. */ char * prefix; @@ -97,7 +450,7 @@ struct file_line are performed on the data read from file before it's stored here, so it will be a single line of data. */ char * unprocessed; - + /** The type of data on this line. One of the FILE_LINE_xxx constants. */ int type;
@@ -321,10 +674,15 @@ static jb_err actions_from_radio(const struct map * parameters, static jb_err map_copy_parameter_html(struct map *out, const struct map *in, const char *name); - -static jb_err get_file_name_param(struct client_state *csp, - const struct map *parameters, - const char *param_name, +#if 0 /* unused function */ +static jb_err map_copy_parameter_url(struct map *out, + const struct map *in, + const char *name); +#endif /* unused function */ + +static jb_err get_file_name_param(struct client_state *csp, + const struct map *parameters, + const char *param_name, const char **pfilename);
/* Internal convenience functions */ @@ -428,6 +786,56 @@ static jb_err map_copy_parameter_html(struct map *out, }
+#if 0 /* unused function */ +/********************************************************************* + * + * Function : map_copy_parameter_url + * + * Description : Copy a CGI parameter from one map to another, URL + * encoding it. + * + * Parameters : + * 1 : out = target map + * 2 : in = source map + * 3 : name = name of cgi parameter to copy + * + * Returns : JB_ERR_OK on success + * JB_ERR_MEMORY on out-of-memory + * JB_ERR_CGI_PARAMS if the parameter doesn't exist + * in the source map + * + *********************************************************************/ +static jb_err map_copy_parameter_url(struct map *out, + const struct map *in, + const char *name) +{ + const char * value; + jb_err err; + + assert(out); + assert(in); + assert(name); + + value = lookup(in, name); + err = map(out, name, 1, url_encode(value), 0); + + if (err) + { + /* Out of memory */ + return err; + } + else if (*value == '\0') + { + return JB_ERR_CGI_PARAMS; + } + else + { + return JB_ERR_OK; + } +} +#endif /* 0 - unused function */ + + /********************************************************************* * * Function : cgi_edit_actions_url_form @@ -652,7 +1060,7 @@ jb_err cgi_edit_actions_remove_url_form(struct client_state *csp, if (cur_line->type == FILE_LINE_ACTION) { section_start_line_number = line_number; - } + } cur_line = cur_line->next; }
@@ -1428,7 +1836,7 @@ jb_err edit_read_file_lines(FILE *fp, struct file_line ** pfile, int *newline) if (rval) { /* Out of memory or empty file. */ - /* Note that empty file is not an error we propagate up */ + /* Note that empty file is not an error we propogate up */ free(cur_line); return ((rval == JB_ERR_FILE) ? JB_ERR_OK : rval); } @@ -1533,7 +1941,7 @@ jb_err edit_read_file(struct client_state *csp, * Probably an old-school URL like * http://config.privoxy.org/edit-actions-list?f=default */ - get_file_name_param(csp, parameters, "f", &filename); + err = get_file_name_param(csp, parameters, "f", &filename); }
if (NULL == filename || stat(filename, statbuf) < 0) @@ -1679,7 +2087,7 @@ jb_err edit_read_actions_file(struct client_state *csp, { log_error(LOG_LEVEL_INFO, "Timestamp mismatch limit reached, turning CGI editor off. " - "Reload the configuration file to re-enable it."); + "Reload the configuration file to reenable it."); csp->config->feature_flags &= ~RUNTIME_FEATURE_CGI_EDIT_ACTIONS; } } @@ -2818,7 +3226,7 @@ jb_err cgi_edit_actions_for_url(struct client_state *csp, if (!err) err = actions_to_radio(exports, cur_line->data.action);
/* - * XXX: Some browsers (at least IE6 and IE7) have an artificial URL + * XXX: Some browsers (at least IE6 and IE7) have an artifical URL * length limitation and ignore clicks on the Submit buttons if * the resulting GET URL would be longer than their limit. * @@ -2827,7 +3235,7 @@ jb_err cgi_edit_actions_for_url(struct client_state *csp, * browsers (BR #1570678). * * The config option split-large-forms works around this browser - * bug (HTTP has no URL length limitation) by deviding the action + * bug (HTTP has no URL lenght limitation) by deviding the action * list form into multiple smaller ones. It means the URLs are shorter * and work in broken browsers as well, but the user can no longer change * all actions with one submit. @@ -3360,7 +3768,7 @@ jb_err cgi_edit_actions_url(struct client_state *csp, if (cur_line->type == FILE_LINE_ACTION) { section_start_line_number = line_number; - } + } cur_line = cur_line->next; line_number++; } @@ -4128,7 +4536,7 @@ jb_err cgi_edit_actions_section_swap(struct client_state *csp, * * Description : Converts a string into a form JavaScript will like. * - * Netscape 4's JavaScript sucks - it doesn't use + * Netscape 4's JavaScript sucks - it doesn't use * "id" parameters, so you have to set the "name" * used to submit a form element to something JavaScript * will like. (Or access the elements by index in an diff --git a/external/privoxy/cgiedit.h b/external/privoxy/cgiedit.h index 917d5ec..ceb5248 100644 --- a/external/privoxy/cgiedit.h +++ b/external/privoxy/cgiedit.h @@ -1,23 +1,23 @@ #ifndef CGIEDIT_H_INCLUDED #define CGIEDIT_H_INCLUDED -#define CGIEDIT_H_VERSION "$Id: cgiedit.h,v 1.12 2011/09/04 11:10:56 fabiankeil Exp $" +#define CGIEDIT_H_VERSION "$Id: cgiedit.h,v 1.10 2008/08/31 15:59:03 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/cgiedit.h,v $ * * Purpose : CGI-based actionsfile editor. - * + * * Functions declared include: - * + * * * Copyright : Written by and Copyright (C) 2001 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -35,8 +35,72 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: cgiedit.h,v $ + * Revision 1.10 2008/08/31 15:59:03 fabiankeil + * There's no reason to let remote toggling support depend + * on FEATURE_CGI_EDIT_ACTIONS, so make sure it doesn't. + * + * Revision 1.9 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.7.2.2 2004/02/17 13:30:23 oes + * Moved cgi_error_disabled() from cgiedit.c to + * cgi.c to re-enable build with --disable-editor. + * Fixes Bug #892744. Thanks to Matthew Fischer + * for spotting. + * + * Revision 1.7.2.1 2002/11/28 18:15:17 oes + * Added cgi_error_disabled + * + * Revision 1.7 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.6 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.5 2002/01/22 23:24:48 jongfoster + * Adding edit-actions-section-swap + * + * Revision 1.4 2001/11/13 00:28:51 jongfoster + * Adding new CGIs for use by non-JavaScript browsers: + * edit-actions-url-form + * edit-actions-add-url-form + * edit-actions-remove-url-form + * + * Revision 1.3 2001/10/23 21:48:19 jongfoster + * Cleaning up error handling in CGI functions - they now send back + * a HTML error page and should never cause a FATAL error. (Fixes one + * potential source of "denial of service" attacks). + * + * CGI actions file editor that works and is actually useful. + * + * Ability to toggle JunkBuster remotely using a CGI call. + * + * You can turn off both the above features in the main configuration + * file, e.g. if you are running a multi-user proxy. + * + * Revision 1.2 2001/10/14 22:12:49 jongfoster + * New version of CGI-based actionsfile editor. + * Major changes, including: + * - Completely new file parser and file output routines + * - edit-actions CGI renamed edit-actions-for-url + * - All CGIs now need a filename parameter, except for... + * - New CGI edit-actions which doesn't need a filename, + * to allow you to start the editor up. + * - edit-actions-submit now works, and now automatically + * redirects you back to the main edit-actions-list handler. + * + * Revision 1.1 2001/09/16 15:47:37 jongfoster + * First version of CGI-based edit interface. This is very much a + * work-in-progress, and you can't actually use it to edit anything + * yet. You must #define FEATURE_CGI_EDIT_ACTIONS for these changes + * to have any effect. + * + * **********************************************************************/ - +
#include "project.h"
diff --git a/external/privoxy/cgisimple.c b/external/privoxy/cgisimple.c index 6f75f66..3543611 100644 --- a/external/privoxy/cgisimple.c +++ b/external/privoxy/cgisimple.c @@ -1,22 +1,22 @@ -const char cgisimple_rcs[] = "$Id: cgisimple.c,v 1.111 2011/09/04 11:10:56 fabiankeil Exp $"; +const char cgisimple_rcs[] = "$Id: cgisimple.c,v 1.91 2009/03/08 14:19:23 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/cgisimple.c,v $ * * Purpose : Simple CGIs to get information about Privoxy's * status. - * + * * Functions declared include: + * * - * - * Copyright : Written by and Copyright (C) 2001-2011 the + * Copyright : Written by and Copyright (C) 2001-2008 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -34,8 +34,415 @@ const char cgisimple_rcs[] = "$Id: cgisimple.c,v 1.111 2011/09/04 11:10:56 fabia * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: cgisimple.c,v $ + * Revision 1.91 2009/03/08 14:19:23 fabiankeil + * Fix justified (but harmless) compiler warnings + * on platforms where sizeof(int) < sizeof(long). + * + * Revision 1.90 2009/03/01 18:43:09 fabiankeil + * Fix cparser warnings. + * + * Revision 1.89 2008/10/11 11:31:14 fabiankeil + * Add FEATURE_CONNECTION_KEEP_ALIVE to the list + * of conditional defines on the show-status page. + * + * Revision 1.88 2008/08/30 12:03:07 fabiankeil + * Remove FEATURE_COOKIE_JAR. + * + * Revision 1.87 2008/08/29 15:59:22 fabiankeil + * Fix two comments. + * + * Revision 1.86 2008/06/28 14:19:05 fabiankeil + * Protocol detection is done case-insensitive, fix assertion + * to do the same. Yay for Privoxy-Regression-Test and zzuf. + * + * Revision 1.85 2008/05/26 17:30:55 fabiankeil + * Provide an OpenSearch Description to access the + * show-url-info page through "search engine plugins". + * + * Revision 1.84 2008/05/26 16:16:55 fabiankeil + * Spell error correctly. + * + * Revision 1.83 2008/05/12 14:51:30 fabiankeil + * Don't complain about an invalid URL if show-url-info is requested + * without parameters. Regression introduced in 1.81 by yours truly. + * + * Revision 1.82 2008/05/10 20:01:47 fabiankeil + * Fix an assertion that could erroneously + * trigger in case of memory shortage. + * + * Revision 1.81 2008/05/05 09:54:39 fabiankeil + * In cgi_show_url_info(), make sure ftp URLs are + * declared invalid. Also simplify the code that adds + * "http://" if no protocol has been specified. + * + * Revision 1.80 2008/05/04 16:18:32 fabiankeil + * Provide parse_http_url() with a third parameter to specify + * whether or not URLs without protocol are acceptable. + * + * Revision 1.79 2008/05/04 13:30:56 fabiankeil + * Streamline parse_http_url()'s prototype. + * + * Revision 1.78 2008/05/03 16:50:11 fabiankeil + * Leverage content_filters_enabled() in cgi_show_url_info(). + * + * Revision 1.77 2008/05/02 09:47:48 fabiankeil + * In cgi_show_url_info, pass an initialized http structure + * to parse_http_url() as that will be required soonish and + * assert that https URLs are recognized correctly. + * + * Revision 1.76 2008/04/28 09:13:30 fabiankeil + * In load_file(), remember the error reason and fclose() + * and return later on instead of right away. + * + * Revision 1.75 2008/04/27 13:52:52 fabiankeil + * Move CGI file loading code into load_file() and + * add checks for unexpected errors. + * + * Revision 1.74 2008/04/26 15:50:56 fabiankeil + * Fix macro name in cgi_show_file() error path. + * + * Revision 1.73 2008/04/26 12:21:55 fabiankeil + * Forget about JB_ERR_PARSE. JB_ERR_CGI_PARAMS to the rescue. + * + * Revision 1.72 2008/04/26 10:34:15 fabiankeil + * If zlib support is unavailable and there are content filters active + * but the prevent-compression action is disabled, include a warning + * on the show-url-info page that compression might prevent filtering. + * + * Revision 1.71 2008/04/25 13:33:56 fabiankeil + * - Factor cgi_show_file() out of cgi_show_status(). + * - Adjust cgi_show_status()'s parameter description to match reality. + * + * Revision 1.70 2008/04/24 16:12:38 fabiankeil + * In cgi_show_status(), load the requested file at once. + * Using string_join() for every line really doesn't scale. + * + * Revision 1.69 2008/04/17 14:40:48 fabiankeil + * Provide get_http_time() with the buffer size so it doesn't + * have to blindly assume that the buffer is big enough. + * + * Revision 1.68 2008/03/27 18:27:21 fabiankeil + * Remove kill-popups action. + * + * Revision 1.67 2008/03/27 17:00:05 fabiankeil + * Turn the favicon blobs into locals. + * + * Revision 1.66 2008/02/23 16:57:12 fabiankeil + * Rename url_actions() to get_url_actions() and let it + * use the standard parameter ordering. + * + * Revision 1.65 2008/02/23 16:33:43 fabiankeil + * Let forward_url() use the standard parameter ordering + * and mark its second parameter immutable. + * + * Revision 1.64 2008/02/03 13:56:07 fabiankeil + * Add SOCKS5 support for show-url-info CGI page. + * + * Revision 1.63 2008/02/01 06:04:31 fabiankeil + * If edit buttons on the show-url-info CGI page are hidden, explain why. + * + * Revision 1.62 2008/02/01 05:52:40 fabiankeil + * Hide edit buttons on the show-url-info CGI page if enable-edit-action + * is disabled. Patch by Lee with additional white space adjustments. + * + * Revision 1.61 2008/01/26 11:13:25 fabiankeil + * If enable-edit-actions is disabled, hide the edit buttons and explain why. + * + * Revision 1.60 2007/10/27 13:12:13 fabiankeil + * Finish 1.49 and check write access before + * showing edit buttons on show-url-info page. + * + * Revision 1.59 2007/10/19 16:42:36 fabiankeil + * Plug memory leak I introduced five months ago. + * Yay Valgrind and Privoxy-Regression-Test. + * + * Revision 1.58 2007/07/21 12:19:50 fabiankeil + * If show-url-info is called with an URL that Privoxy + * would reject as invalid, don't show unresolved forwarding + * variables, "final matches" or claim the site's secure. + * + * Revision 1.57 2007/06/01 16:53:05 fabiankeil + * Adjust cgi_show_url_info() to show what forward-override{} + * would do with the requested URL (instead of showing how the + * request for the CGI page would be forwarded if it wasn't a + * CGI request). + * + * Revision 1.56 2007/05/21 10:50:35 fabiankeil + * - Use strlcpy() instead of strcpy(). + * - Stop treating actions files special. Expect a complete file name + * (with or without path) like it's done for the rest of the files. + * Closes FR#588084. + * - Don't rerun sed() in cgi_show_request(). + * + * Revision 1.55 2007/04/13 13:36:46 fabiankeil + * Reference action files in CGI URLs by id instead + * of using the first part of the file name. + * Fixes BR 1694250 and BR 1590556. + * + * Revision 1.54 2007/04/09 18:11:35 fabiankeil + * Don't mistake VC++'s _snprintf() for a snprintf() replacement. + * + * Revision 1.53 2007/04/08 13:21:04 fabiankeil + * Reference action files in CGI URLs by id instead + * of using the first part of the file name. + * Fixes BR 1694250 and BR 1590556. + * + * Revision 1.52 2007/02/13 15:10:26 fabiankeil + * Apparently fopen()ing in "binary" mode doesn't require + * #ifdefs, it's already done without them in cgiedit.c. + * + * Revision 1.51 2007/02/10 16:55:22 fabiankeil + * - Show forwarding settings on the show-url-info page + * - Fix some HTML syntax errors. + * + * Revision 1.50 2007/01/23 15:51:17 fabiankeil + * Add favicon delivery functions. + * + * Revision 1.49 2007/01/20 16:29:38 fabiankeil + * Suppress edit buttons for action files if Privoxy has + * no write access. Suggested by Roland in PR 1564026. + * + * Revision 1.48 2007/01/20 15:31:31 fabiankeil + * Display warning if show-url-info CGI page + * is used while Privoxy is toggled off. + * + * Revision 1.47 2007/01/12 15:07:10 fabiankeil + * Use zalloc in cgi_send_user_manual. + * + * Revision 1.46 2007/01/02 12:49:46 fabiankeil + * Add FEATURE_ZLIB to the list of conditional + * defines at the show-status page. + * + * Revision 1.45 2006/12/28 18:16:41 fabiankeil + * Fixed gcc43 compiler warnings, zero out cgi_send_user_manual's + * body memory before using it, replaced sprintf calls with snprintf. + * + * Revision 1.44 2006/12/22 14:19:27 fabiankeil + * Removed checks whether or not AF_FILES have + * data structures associated with them in cgi_show_status. + * It doesn't matter as we're only interested in the file names. + * + * For the action files the checks were always true, + * but they prevented empty filter files from being + * listed. Fixes parts of BR 1619208. + * + * Revision 1.43 2006/12/17 17:57:56 fabiankeil + * - Added FEATURE_GRACEFUL_TERMINATION to the + * "conditional #defines" section + * - Escaped ampersands in generated HTML. + * - Renamed re-filter-filename to re-filter-filenames + * + * Revision 1.42 2006/11/21 15:43:12 fabiankeil + * Add special treatment for WIN32 to make sure + * cgi_send_user_manual opens the files in binary mode. + * Fixes BR 1600411 and unbreaks image delivery. + * + * Remove outdated comment. + * + * Revision 1.41 2006/10/09 19:18:28 roro + * Redirect http://p.p/user-manual (without trailing slash) to + * http://p.p/user-manual/ (with trailing slash), otherwise links will be broken. + * + * Revision 1.40 2006/09/09 13:05:33 fabiankeil + * Modified cgi_send_user_manual to serve binary + * content without destroying it first. Should also be + * faster now. Added ".jpg" check for Content-Type guessing. + * + * Revision 1.39 2006/09/08 09:49:23 fabiankeil + * Deliver documents in the user-manual directory + * with "Content-Type text/css" if their filename + * ends with ".css". + * + * Revision 1.38 2006/09/06 18:45:03 fabiankeil + * Incorporate modified version of Roland Rosenfeld's patch to + * optionally access the user-manual via Privoxy. Closes patch 679075. + * + * Formatting changed to Privoxy style, added call to + * cgi_error_no_template if the requested file doesn't + * exist and modified check whether or not Privoxy itself + * should serve the manual. Should work cross-platform now. + * + * Revision 1.37 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.35.2.7 2006/01/29 23:10:56 david__schmidt + * Multiple filter file support + * + * Revision 1.35.2.6 2005/07/04 03:13:43 david__schmidt + * Undo some damaging memory leak patches + * + * Revision 1.35.2.5 2005/05/07 21:50:55 david__schmidt + * A few memory leaks plugged (mostly on error paths) + * + * Revision 1.35.2.4 2005/04/04 02:21:24 david__schmidt + * Another instance of: + * Don't show "Edit" buttons #ifndef FEATURE_CGI_EDIT_ACTIONS + * Thanks to Magnus Holmgren for the patch + * + * Revision 1.35.2.3 2003/12/17 16:34:15 oes + * - Prevent line wrap beween "View/Edit" link buttons on status page + * - Some (mostly irrelevant) fixes for Out-of-mem-case handling + * + * Revision 1.35.2.2 2003/04/03 13:48:28 oes + * Don't show "Edit" buttons #ifndef FEATURE_CGI_EDIT_ACTIONS + * + * Revision 1.35.2.1 2002/07/04 15:02:38 oes + * Added ability to send redirects to send-banner CGI, so that it can completely mimic the image blocking action if called with type=auto + * + * Revision 1.35.2.1 2002/07/01 17:32:04 morcego + * Applying patch from Andreas as provided by Hal on the list. + * Message-ID: <20020701121218.V1606@feenix.burgiss.net> + * + * Revision 1.35 2002/05/12 21:44:44 jongfoster + * Adding amiga.[ch] revision information, if on an amiga. + * + * Revision 1.34 2002/04/30 12:06:12 oes + * Deleted unused code from default_cgi + * + * Revision 1.33 2002/04/30 11:14:52 oes + * Made csp the first parameter in *action_to_html + * + * Revision 1.32 2002/04/26 18:29:13 jongfoster + * Fixing this Visual C++ warning: + * cgisimple.c(775) : warning C4018: '<' : signed/unsigned mismatch + * + * Revision 1.31 2002/04/26 12:54:36 oes + * - Kill obsolete REDIRECT_URL code + * - Error handling fixes + * - Style sheet related HTML snipplet changes + * - cgi_show_url_info: + * - Matches now in table, actions on single lines, + * linked to help + * - standard.action suppressed + * - Buttons to View and Edit AFs + * + * Revision 1.30 2002/04/24 02:18:08 oes + * - show-status is now the starting point for editing + * the actions files, generate list of all AFs with buttons + * for viewing and editing, new look for file list (Jon: + * buttons now aligned ;-P ), view mode now supports multiple + * AFs, name changes, no view links for unspecified files, + * no edit link for standard.action. + * + * - Jon's multiple AF patch: cgi_show_url_info now uses all + * AFs and marks the output accordingly + * + * Revision 1.29 2002/04/10 13:38:35 oes + * load_template signature changed + * + * Revision 1.28 2002/04/07 15:42:12 jongfoster + * Fixing send-banner?type=auto when the image-blocker is + * a redirect to send-banner + * + * Revision 1.27 2002/04/05 15:50:48 oes + * added send-stylesheet CGI + * + * Revision 1.26 2002/04/04 00:36:36 gliptak + * always use pcre for matching + * + * Revision 1.25 2002/04/03 22:28:03 gliptak + * Removed references to gnu_regex + * + * Revision 1.24 2002/04/02 16:12:47 oes + * Fix: moving misplaced lines into #ifdef FEATURE_FORCE + * + * Revision 1.23 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.22 2002/03/24 16:18:15 jongfoster + * Removing old logo + * + * Revision 1.21 2002/03/24 15:23:33 jongfoster + * Name changes + * + * Revision 1.20 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.19 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.18 2002/03/12 01:44:49 oes + * Changed default for "blocked" image from jb logo to checkboard pattern + * + * Revision 1.17 2002/03/08 16:43:18 oes + * Added choice beween GIF and PNG built-in images + * + * Revision 1.16 2002/03/07 03:48:38 oes + * - Changed built-in images from GIF to PNG + * (with regard to Unisys patent issue) + * - Added a 4x4 pattern PNG which is less intrusive + * than the logo but also clearly marks the deleted banners + * + * Revision 1.15 2002/03/06 22:54:35 jongfoster + * Automated function-comment nitpicking. + * + * Revision 1.14 2002/03/02 04:14:50 david__schmidt + * Clean up a little CRLF unpleasantness that suddenly appeared + * + * Revision 1.13 2002/02/21 00:10:37 jongfoster + * Adding send-banner?type=auto option + * + * Revision 1.12 2002/01/23 01:03:32 jongfoster + * Fixing gcc [CygWin] compiler warnings + * + * Revision 1.11 2002/01/23 00:01:04 jongfoster + * Adding cgi_transparent_gif() for http://i.j.b/t + * Adding missing html_encode() to many CGI functions. + * Adding urlmatch.[ch] to http://i.j.b/show-version + * + * Revision 1.10 2002/01/17 21:10:37 jongfoster + * Changes to cgi_show_url_info to use new matching code from urlmatch.c. + * Also fixing a problem in the same function with improperly quoted URLs + * in output HTML, and adding code to handle https:// URLs correctly. + * + * Revision 1.9 2001/11/30 23:09:15 jongfoster + * Now reports on FEATURE_CGI_EDIT_ACTIONS + * Removing FEATURE_DENY_GZIP from template + * + * Revision 1.8 2001/11/13 00:14:07 jongfoster + * Fixing stupid bug now I've figured out what || means. + * (It always returns 0 or 1, not one of it's paramaters.) + * + * Revision 1.7 2001/10/23 21:48:19 jongfoster + * Cleaning up error handling in CGI functions - they now send back + * a HTML error page and should never cause a FATAL error. (Fixes one + * potential source of "denial of service" attacks). + * + * CGI actions file editor that works and is actually useful. + * + * Ability to toggle JunkBuster remotely using a CGI call. + * + * You can turn off both the above features in the main configuration + * file, e.g. if you are running a multi-user proxy. + * + * Revision 1.6 2001/10/14 22:00:32 jongfoster + * Adding support for a 404 error when an invalid CGI page is requested. + * + * Revision 1.5 2001/10/07 15:30:41 oes + * Removed FEATURE_DENY_GZIP + * + * Revision 1.4 2001/10/02 15:31:12 oes + * Introduced show-request cgi + * + * Revision 1.3 2001/09/22 16:34:44 jongfoster + * Removing unneeded #includes + * + * Revision 1.2 2001/09/19 18:01:11 oes + * Fixed comments; cosmetics + * + * Revision 1.1 2001/09/16 17:08:54 jongfoster + * Moving simple CGI functions from cgi.c to new file cgisimple.c + * + * **********************************************************************/ - +
#include "config.h"
@@ -80,7 +487,7 @@ static jb_err load_file(const char *filename, char **buffer, size_t *length); * Description : CGI function that is called for the CGI_SITE_1_HOST * and CGI_SITE_2_HOST/CGI_SITE_2_PATH base URLs. * Boring - only exports the default exports. - * + * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) * 2 : rsp = http_response data structure for output @@ -118,7 +525,7 @@ jb_err cgi_default(struct client_state *csp, * * Description : CGI function that is called if an unknown action was * given. - * + * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) * 2 : rsp = http_response data structure for output @@ -127,7 +534,7 @@ jb_err cgi_default(struct client_state *csp, * CGI Parameters : none * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_error_404(struct client_state *csp, @@ -165,7 +572,7 @@ jb_err cgi_error_404(struct client_state *csp, * NOTE: Turning this on in a production build * would be a BAD idea. An EXTREMELY BAD idea. * In short, don't do it. - * + * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) * 2 : rsp = http_response data structure for output @@ -174,27 +581,13 @@ jb_err cgi_error_404(struct client_state *csp, * CGI Parameters : none * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_die (struct client_state *csp, struct http_response *rsp, const struct map *parameters) { - static const char status[] = "200 OK Privoxy shutdown request received"; - static const char body[] = - "<html>\n" - "<head>\n" - " <title>Privoxy shutdown request received</title>\n" - " <link rel="shortcut icon" href="" CGI_PREFIX "error-favicon.ico" type="image/x-icon">\n" - " <link rel="stylesheet" type="text/css" href="http://config.privoxy.org/send-stylesheet\">\n" - "</head>\n" - "<body>\n" - "<h1>Privoxy shutdown request received</h1>\n" - "<p>Privoxy is going to shut down after the next request.</p>\n" - "</body>\n" - "</html>\n"; - assert(csp); assert(rsp); assert(parameters); @@ -202,21 +595,12 @@ jb_err cgi_die (struct client_state *csp, /* quit */ g_terminate = 1;
- csp->flags &= ~CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE; - - rsp->content_length = 0; - rsp->head_length = 0; - rsp->is_static = 0; - - rsp->body = strdup(body); - rsp->status = strdup(status); - - if ((rsp->body == NULL) || (rsp->status == NULL)) - { - return JB_ERR_MEMORY; - } + /* + * I don't really care what gets sent back to the browser. + * Take the easy option - "out of memory" page. + */
- return JB_ERR_OK; + return JB_ERR_MEMORY; } #endif /* def FEATURE_GRACEFUL_TERMINATION */
@@ -227,7 +611,7 @@ jb_err cgi_die (struct client_state *csp, * * Description : Show the client's request and what sed() would have * made of it. - * + * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) * 2 : rsp = http_response data structure for output @@ -236,7 +620,7 @@ jb_err cgi_die (struct client_state *csp, * CGI Parameters : none * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_show_request(struct client_state *csp, @@ -254,7 +638,7 @@ jb_err cgi_show_request(struct client_state *csp, { return JB_ERR_MEMORY; } - + /* * Repair the damage done to the IOB by get_header() */ @@ -289,7 +673,7 @@ jb_err cgi_show_request(struct client_state *csp, * * Function : cgi_send_banner * - * Description : CGI function that returns a banner. + * Description : CGI function that returns a banner. * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) @@ -304,7 +688,7 @@ jb_err cgi_show_request(struct client_state *csp, * equivalent). * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_send_banner(struct client_state *csp, @@ -317,7 +701,7 @@ jb_err cgi_send_banner(struct client_state *csp, * If type is auto, then determine the right thing * to do from the set-image-blocker action */ - if (imagetype == 'a') + if (imagetype == 'a') { /* * Default to pattern @@ -368,14 +752,14 @@ jb_err cgi_send_banner(struct client_state *csp, } #endif /* def FEATURE_IMAGE_BLOCKING */ } - + /* * Now imagetype is either the non-auto type we were called with, * or it was auto and has since been determined. In any case, we * can proceed to actually answering the request by sending a redirect * or an image as appropriate: */ - if (imagetype == 'r') + if (imagetype == 'r') { rsp->status = strdup("302 Local Redirect from Privoxy"); if (rsp->status == NULL) @@ -390,7 +774,7 @@ jb_err cgi_send_banner(struct client_state *csp, } else { - if ((imagetype == 'b') || (imagetype == 't')) + if ((imagetype == 'b') || (imagetype == 't')) { rsp->body = bindup(image_blank_data, image_blank_length); rsp->content_length = image_blank_length; @@ -432,7 +816,7 @@ jb_err cgi_send_banner(struct client_state *csp, * CGI Parameters : None * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_transparent_image(struct client_state *csp, @@ -476,7 +860,7 @@ jb_err cgi_transparent_image(struct client_state *csp, * CGI Parameters : None * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_send_default_favicon(struct client_state *csp, @@ -537,7 +921,7 @@ jb_err cgi_send_default_favicon(struct client_state *csp, * CGI Parameters : None * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_send_error_favicon(struct client_state *csp, @@ -599,7 +983,7 @@ jb_err cgi_send_error_favicon(struct client_state *csp, * CGI Parameters : None * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_send_stylesheet(struct client_state *csp, @@ -607,7 +991,7 @@ jb_err cgi_send_stylesheet(struct client_state *csp, const struct map *parameters) { jb_err err; - + assert(csp); assert(rsp);
@@ -653,7 +1037,7 @@ jb_err cgi_send_stylesheet(struct client_state *csp, * CGI Parameters : None * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_send_url_info_osd(struct client_state *csp, @@ -683,48 +1067,6 @@ jb_err cgi_send_url_info_osd(struct client_state *csp,
/********************************************************************* * - * Function : get_content_type - * - * Description : Use the file extension to guess the content type - * header we should use to serve the file. - * - * Parameters : - * 1 : filename = Name of the file whose content type - * we care about - * - * Returns : The guessed content type. - * - *********************************************************************/ -static const char *get_content_type(const char *filename) -{ - int i; - struct content_type - { - const char *extension; - const char *content_type; - }; - static const struct content_type content_types[] = - { - {".css", "text/css"}, - {".jpg", "image/jpeg"}, - {".jpeg", "image/jpeg"}, - {".png", "image/png"}, - }; - - for (i = 0; i < SZ(content_types); i++) - { - if (strstr(filename, content_types[i].extension)) - { - return content_types[i].content_type; - } - } - - /* No match by extension, default to html */ - return "text/html"; -} - -/********************************************************************* - * * Function : cgi_send_user_manual * * Description : CGI function that sends a file in the user @@ -739,29 +1081,22 @@ static const char *get_content_type(const char *filename) * (relative to user-manual from config) * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_send_user_manual(struct client_state *csp, struct http_response *rsp, const struct map *parameters) { - const char *filename; + const char * filename; char *full_path; jb_err err = JB_ERR_OK; - const char *content_type; + size_t length;
assert(csp); assert(rsp); assert(parameters);
- if (0 == strncmpic(csp->config->usermanual, "http://", 7)) - { - log_error(LOG_LEVEL_CGI, "Request for local user-manual " - "received while user-manual delivery is disabled."); - return cgi_error_404(csp, rsp, parameters); - } - if (!parameters->first) { /* requested http://p.p/user-manual (without trailing slash) */ @@ -769,24 +1104,17 @@ jb_err cgi_send_user_manual(struct client_state *csp, }
get_string_param(parameters, "file", &filename); - if (filename == NULL) + /* Check paramter for hack attempts */ + if (filename && strchr(filename, '/')) { - /* It's '/' so serve the index.html if there is one. */ - filename = "index.html"; + return JB_ERR_CGI_PARAMS; } - else if (NULL != strchr(filename, '/') || NULL != strstr(filename, "..")) + if (filename && strstr(filename, "..")) { - /* - * We currently only support a flat file - * hierarchy for the documentation. - */ - log_error(LOG_LEVEL_ERROR, - "Rejecting the request to serve '%s' as it contains '/' or '..'", - filename); return JB_ERR_CGI_PARAMS; }
- full_path = make_path(csp->config->usermanual, filename); + full_path = make_path(csp->config->usermanual, filename ? filename : "index.html"); if (full_path == NULL) { return JB_ERR_MEMORY; @@ -805,12 +1133,29 @@ jb_err cgi_send_user_manual(struct client_state *csp, } freez(full_path);
- content_type = get_content_type(filename); - log_error(LOG_LEVEL_CGI, - "Content-Type guessed for %s: %s", filename, content_type); - - return enlist_unique_header(rsp->headers, "Content-Type", content_type); + /* Guess correct Content-Type based on the filename's ending */ + if (filename) + { + length = strlen(filename); + } + else + { + length = 0; + } + if((length>=4) && !strcmp(&filename[length-4], ".css")) + { + err = enlist(rsp->headers, "Content-Type: text/css"); + } + else if((length>=4) && !strcmp(&filename[length-4], ".jpg")) + { + err = enlist(rsp->headers, "Content-Type: image/jpeg"); + } + else + { + err = enlist(rsp->headers, "Content-Type: text/html"); + }
+ return err; }
@@ -829,7 +1174,7 @@ jb_err cgi_send_user_manual(struct client_state *csp, * CGI Parameters : none * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_show_version(struct client_state *csp, @@ -878,7 +1223,7 @@ jb_err cgi_show_version(struct client_state *csp, * Default is to show menu and other information. * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_show_status(struct client_state *csp, @@ -924,7 +1269,7 @@ jb_err cgi_show_status(struct client_state *csp, if (!err) err = map(exports, "options", 1, csp->config->proxy_args, 1); if (!err) err = show_defines(exports);
- if (err) + if (err) { free_map(exports); return JB_ERR_MEMORY; @@ -968,8 +1313,8 @@ jb_err cgi_show_status(struct client_state *csp, #else /* ndef FEATURE_STATISTICS */ err = err || map_block_killer(exports, "statistics"); #endif /* ndef FEATURE_STATISTICS */ - - /* + + /* * List all action files in use, together with view and edit links, * except for standard.action, which should only be viewable. (Not * enforced in the editor itself) @@ -1010,7 +1355,7 @@ jb_err cgi_show_status(struct client_state *csp, if (!err) err = string_append(&s, "</td></tr>\n"); } } - if (*s != '\0') + if (*s != '\0') { if (!err) err = map(exports, "actions-filenames", 1, s, 0); } @@ -1019,7 +1364,7 @@ jb_err cgi_show_status(struct client_state *csp, if (!err) err = map(exports, "actions-filenames", 1, "<tr><td>None specified</td></tr>", 1); }
- /* + /* * List all re_filterfiles in use, together with view options. * FIXME: Shouldn't include hardwired HTML here, use line template instead! */ @@ -1036,7 +1381,7 @@ jb_err cgi_show_status(struct client_state *csp, if (!err) err = string_append(&s, "</td></tr>\n"); } } - if (*s != '\0') + if (*s != '\0') { if (!err) err = map(exports, "re-filter-filenames", 1, s, 0); } @@ -1076,7 +1421,7 @@ jb_err cgi_show_status(struct client_state *csp, return template_fill_for_cgi(csp, "show-status", exports, rsp); }
- + /********************************************************************* * * Function : cgi_show_url_info @@ -1097,7 +1442,7 @@ jb_err cgi_show_status(struct client_state *csp, * the template. * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_show_url_info(struct client_state *csp, @@ -1133,7 +1478,7 @@ jb_err cgi_show_url_info(struct client_state *csp, * 1) "http://" or "https://" prefix present and followed by URL - OK * 2) Only the "http://" or "https://" part is present, no URL - change * to empty string so it will be detected later as "no URL". - * 3) Parameter specified but doesn't start with "http(s?)://" - add a + * 3) Parameter specified but doesn't contain "http(s?)://" - add a * "http://" prefix. * 4) Parameter not specified or is empty string - let this fall through * for now, next block of code will handle it. @@ -1160,14 +1505,9 @@ jb_err cgi_show_url_info(struct client_state *csp, url_param[0] = '\0'; } } - else if ((url_param[0] != '\0') - && ((NULL == strstr(url_param, "://") - || (strstr(url_param, "://") > strstr(url_param, "/"))))) + else if ((url_param[0] != '\0') && (NULL == strstr(url_param, "://"))) { - /* - * No prefix or at least no prefix before - * the first slash - assume http:// - */ + /* No prefix - assume http:// */ char *url_param_prefixed = strdup("http://");
if (JB_ERR_OK != string_join(&url_param_prefixed, url_param)) @@ -1215,7 +1555,7 @@ jb_err cgi_show_url_info(struct client_state *csp, struct http_request url_to_query[1]; struct current_action_spec action[1]; int i; - + if (map(exports, "url", 1, html_encode(url_param), 0)) { free(url_param); @@ -1503,7 +1843,7 @@ jb_err cgi_show_url_info(struct client_state *csp, * CGI Parameters : None * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ jb_err cgi_robots_txt(struct client_state *csp, @@ -1551,19 +1891,13 @@ jb_err cgi_robots_txt(struct client_state *csp, * 1 : exports = map to extend * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ static jb_err show_defines(struct map *exports) { jb_err err = JB_ERR_OK;
-#ifdef FEATURE_ACCEPT_FILTER - if (!err) err = map_conditional(exports, "FEATURE_ACCEPT_FILTER", 1); -#else /* ifndef FEATURE_ACCEPT_FILTER */ - if (!err) err = map_conditional(exports, "FEATURE_ACCEPT_FILTER", 0); -#endif /* ndef FEATURE_ACCEPT_FILTER */ - #ifdef FEATURE_ACL if (!err) err = map_conditional(exports, "FEATURE_ACL", 1); #else /* ifndef FEATURE_ACL */ @@ -1576,24 +1910,12 @@ static jb_err show_defines(struct map *exports) if (!err) err = map_conditional(exports, "FEATURE_CGI_EDIT_ACTIONS", 0); #endif /* ndef FEATURE_CGI_EDIT_ACTIONS */
-#ifdef FEATURE_COMPRESSION - if (!err) err = map_conditional(exports, "FEATURE_COMPRESSION", 1); -#else /* ifndef FEATURE_COMPRESSION */ - if (!err) err = map_conditional(exports, "FEATURE_COMPRESSION", 0); -#endif /* ndef FEATURE_COMPRESSION */ - #ifdef FEATURE_CONNECTION_KEEP_ALIVE if (!err) err = map_conditional(exports, "FEATURE_CONNECTION_KEEP_ALIVE", 1); -#else /* ifndef FEATURE_CONNECTION_KEEP_ALIVE */ +#else /* ifndef FEATURE_CGI_EDIT_ACTIONS */ if (!err) err = map_conditional(exports, "FEATURE_CONNECTION_KEEP_ALIVE", 0); #endif /* ndef FEATURE_CONNECTION_KEEP_ALIVE */
-#ifdef FEATURE_CONNECTION_SHARING - if (!err) err = map_conditional(exports, "FEATURE_CONNECTION_SHARING", 1); -#else /* ifndef FEATURE_CONNECTION_SHARING */ - if (!err) err = map_conditional(exports, "FEATURE_CONNECTION_SHARING", 0); -#endif /* ndef FEATURE_CONNECTION_SHARING */ - #ifdef FEATURE_FAST_REDIRECTS if (!err) err = map_conditional(exports, "FEATURE_FAST_REDIRECTS", 1); #else /* ifndef FEATURE_FAST_REDIRECTS */ @@ -1626,12 +1948,6 @@ static jb_err show_defines(struct map *exports) if (!err) err = map_conditional(exports, "FEATURE_IMAGE_DETECT_MSIE", 0); #endif /* ndef FEATURE_IMAGE_DETECT_MSIE */
-#ifdef HAVE_RFC2553 - if (!err) err = map_conditional(exports, "FEATURE_IPV6_SUPPORT", 1); -#else /* ifndef HAVE_RFC2553 */ - if (!err) err = map_conditional(exports, "FEATURE_IPV6_SUPPORT", 0); -#endif /* ndef HAVE_RFC2553 */ - #ifdef FEATURE_NO_GIFS if (!err) err = map_conditional(exports, "FEATURE_NO_GIFS", 1); #else /* ifndef FEATURE_NO_GIFS */ @@ -1801,7 +2117,7 @@ static char *show_rcs(void) * Default is to show menu and other information. * * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out-of-memory error. + * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ static jb_err cgi_show_file(struct client_state *csp, @@ -1895,7 +2211,7 @@ static jb_err cgi_show_file(struct client_state *csp, return JB_ERR_CGI_PARAMS; }
- + /********************************************************************* * * Function : load_file @@ -1922,7 +2238,6 @@ static jb_err load_file(const char *filename, char **buffer, size_t *length) fp = fopen(filename, "rb"); if (NULL == fp) { - log_error(LOG_LEVEL_ERROR, "Failed to open %s: %E", filename); return JB_ERR_FILE; }
diff --git a/external/privoxy/cgisimple.h b/external/privoxy/cgisimple.h index 05d6486..2bce214 100644 --- a/external/privoxy/cgisimple.h +++ b/external/privoxy/cgisimple.h @@ -1,24 +1,24 @@ #ifndef CGISIMPLE_H_INCLUDED #define CGISIMPLE_H_INCLUDED -#define CGISIMPLE_H_VERSION "$Id: cgisimple.h,v 1.18 2011/09/04 11:10:56 fabiankeil Exp $" +#define CGISIMPLE_H_VERSION "$Id: cgisimple.h,v 1.16 2008/05/26 17:30:55 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/cgisimple.h,v $ * * Purpose : Declares functions to intercept request, generate * html or gif answers, and to compose HTTP resonses. - * + * * Functions declared include: - * + * * * Copyright : Written by and Copyright (C) 2001-2007 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -36,8 +36,78 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: cgisimple.h,v $ + * Revision 1.16 2008/05/26 17:30:55 fabiankeil + * Provide an OpenSearch Description to access the + * show-url-info page through "search engine plugins". + * + * Revision 1.15 2007/01/23 15:51:17 fabiankeil + * Add favicon delivery functions. + * + * Revision 1.14 2006/09/06 18:45:03 fabiankeil + * Incorporate modified version of Roland Rosenfeld's patch to + * optionally access the user-manual via Privoxy. Closes patch 679075. + * + * Formatting changed to Privoxy style, added call to + * cgi_error_no_template if the requested file doesn't + * exist and modified check whether or not Privoxy itself + * should serve the manual. Should work cross-platform now. + * + * Revision 1.13 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.11 2002/04/05 15:50:53 oes + * added send-stylesheet CGI + * + * Revision 1.10 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.9 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.8 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.7 2002/03/08 16:43:59 oes + * Renamed cgi_transparent_png to cgi_transparent_image + * + * Revision 1.6 2002/03/07 03:48:59 oes + * - Changed built-in images from GIF to PNG + * (with regard to Unisys patent issue) + * + * Revision 1.5 2002/01/22 23:26:03 jongfoster + * Adding cgi_transparent_gif() for http://i.j.b/t + * + * Revision 1.4 2001/10/23 21:48:19 jongfoster + * Cleaning up error handling in CGI functions - they now send back + * a HTML error page and should never cause a FATAL error. (Fixes one + * potential source of "denial of service" attacks). + * + * CGI actions file editor that works and is actually useful. + * + * Ability to toggle JunkBuster remotely using a CGI call. + * + * You can turn off both the above features in the main configuration + * file, e.g. if you are running a multi-user proxy. + * + * Revision 1.3 2001/10/14 22:00:32 jongfoster + * Adding support for a 404 error when an invalid CGI page is requested. + * + * Revision 1.2 2001/10/02 15:31:20 oes + * Introduced show-request cgi + * + * Revision 1.1 2001/09/16 17:08:54 jongfoster + * Moving simple CGI functions from cgi.c to new file cgisimple.c + * + * **********************************************************************/ - +
#include "project.h"
diff --git a/external/privoxy/config b/external/privoxy/config index 052f8a1..741382a 100644 --- a/external/privoxy/config +++ b/external/privoxy/config @@ -1,8 +1,8 @@ -# Sample Configuration File for Privoxy v3.0.19 +# Sample Configuration File for Privoxy v3.0.12 # -# $Id: config,v 1.98 2011/12/26 17:04:50 fabiankeil Exp $ +# $Id: config,v 1.76 2009/03/21 11:51:51 fabiankeil Exp $ # -# Copyright (C) 2001-2011 Privoxy Developers http://www.privoxy.org/ +# Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ # #################################################################### # # @@ -113,6 +113,7 @@ # # user-manual /usr/share/doc/privoxy/user-manual # +# # The User Manual is then available to anyone with # access to Privoxy, by following the built-in URL: # http://config.privoxy.org/user-manual/ (or the shortcut: @@ -123,6 +124,7 @@ # # user-manual http://example.com/privoxy/user-manual/ # +# # WARNING!!! # # If set, this option should be the first option in the config @@ -414,7 +416,7 @@ actionsfile user.action # User customizations # separate file, such as user.filter. # filterfile default.filter -filterfile user.filter # User customizations +#filterfile user.filter # User customizations # # # 2.6. logfile @@ -558,7 +560,7 @@ logfile logfile # 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 +# debug 16 # log all data written to the network into the logfile # debug 32 # debug force feature # debug 64 # debug regular expression filters # debug 128 # debug redirects @@ -568,16 +570,15 @@ logfile logfile # 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 # # # To select multiple debug levels, you can either add them or # use multiple debug lines. # # A debug level of 1 is informative because it will show you each -# request as it happens. 1, 1024, 4096 and 8192 are recommended -# so that you will notice when things go wrong. The other levels -# are probably only of interest if you are hunting down a specific +# request as it happens. 1, 4096 and 8192 are recommended so that +# you will notice when things go wrong. The other levels are +# probably only of interest if you are hunting down a specific # problem. They can produce a hell of an output (especially 16). # # Privoxy used to ship with the debug levels recommended above @@ -681,24 +682,22 @@ logfile logfile # # Specifies: # -# The address and TCP port on which Privoxy will listen for +# The IP address and TCP port on which Privoxy will listen for # client requests. # # Type of value: # # [IP-Address]:Port # -# [Hostname]:Port -# # Default value: # # 127.0.0.1:8118 # # Effect if unset: # -# Bind to 127.0.0.1 (IPv4 localhost), port 8118. This is suitable -# and recommended for home users who run Privoxy on the same -# machine as their browser. +# Bind to 127.0.0.1 (localhost), port 8118. This is suitable and +# recommended for home users who run Privoxy on the same machine +# as their browser. # # Notes: # @@ -709,56 +708,15 @@ logfile logfile # if you want to serve requests from other machines (e.g. on your # local network) as well, you will need to override the default. # -# You can use this statement multiple times to make Privoxy listen -# on more ports or more IP addresses. Suitable if your operating -# system does not support sharing IPv6 and IPv4 protocols on the -# same socket. -# -# If a hostname is used instead of an IP address, Privoxy will -# try to resolve it to an IP address and if there are multiple, -# use the first one returned. -# -# If the address for the hostname isn't already known on the -# system (for example because it's in /etc/hostname), this may -# result in DNS traffic. -# -# If the specified address isn't available on the system, or if -# the hostname can't be resolved, Privoxy will fail to start. -# -# IPv6 addresses containing colons have to be quoted by -# brackets. They can only be used if Privoxy has been compiled -# with IPv6 support. If you aren't sure if your version supports -# it, have a look at http://config.privoxy.org/ show-status. -# -# Some operating systems will prefer IPv6 to IPv4 addresses even if -# the system has no IPv6 connectivity which is usually not expected -# by the user. Some even rely on DNS to resolve localhost which -# mean the "localhost" address used may not actually be local. -# -# It is therefore recommended to explicitly configure the intended -# IP address instead of relying on the operating system, unless -# there's a strong reason not to. -# -# If you leave out the address, Privoxy will bind to all IPv4 +# If you leave out the IP address, Privoxy will bind to all # interfaces (addresses) on your machine and may become reachable -# from the Internet and/ or the local network. Be aware that -# some GNU/Linux distributions modify that behaviour without -# updating the documentation. Check for non-standard patches if -# your Privoxyversion behaves differently. -# -# If you configure Privoxyto be reachable from the network, -# consider using access control lists (ACL's, see below), and/or -# a firewall. +# from the Internet. In that case, consider using access control +# lists (ACL's, see below), and/or a firewall. # # If you open Privoxy to untrusted users, you will also # want to make sure that the following actions are disabled: # enable-edit-actions and enable-remote-toggle # -# With the exception noted above, listening on multiple addresses -# is currently not supported by Privoxy directly. It can be done -# on most operating systems by letting a packet filter redirect -# request for certain addresses to Privoxy, though. -# # Example: # # Suppose you are running Privoxy on a machine which has the @@ -768,10 +726,6 @@ logfile logfile # # listen-address 192.168.0.1:8118 # -# Suppose you are running Privoxy on an IPv6-capable machine and -# you want it to listen on the IPv6 address of the loopback device: -# -# listen-address [::1]:8118 # listen-address 127.0.0.1:8118 # @@ -988,28 +942,18 @@ enforce-blocks 0 # # Type of value: # -# src_addr[:port][/src_masklen] [dst_addr[:port][/dst_masklen]] -# -# Where src_addr and dst_addr are IPv4 addresses in dotted -# decimal notation or valid DNS names, port is a port number, and -# src_masklen and dst_masklen are subnet masks in CIDR notation, -# i.e. integer values from 2 to 30 representing the length -# (in bits) of the network address. The masks and the whole -# destination part are optional. +# src_addr[/src_masklen] [dst_addr[/dst_masklen]] # -# If your system implements RFC 3493, then src_addr and dst_addr -# can be IPv6 addresses delimeted by brackets, port can be a -# number or a service name, and src_masklen and dst_masklen can -# be a number from 0 to 128. +# Where src_addr and dst_addr are IP addresses in dotted decimal +# notation or valid DNS names, and src_masklen and dst_masklen are +# subnet masks in CIDR notation, i.e. integer values from 2 to 30 +# representing the length (in bits) of the network address. The +# masks and the whole destination part are optional. # # Default value: # # Unset # -# If no port is specified, any port will match. If no src_masklen -# or src_masklen is given, the complete IP address has to match -# (i.e. 32 bits for IPv4 and 128 bits for IPv6). -# # Effect if unset: # # Don't restrict access further than implied by listen-address @@ -1045,12 +989,6 @@ enforce-blocks 0 # names. If a DNS name resolves to multiple IP addresses, only # the first one is used. # -# 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. -# # Denying access to particular sites by ACL may have undesired # side effects if the site in question is hosted on a machine # which also hosts other sites (most sites are). @@ -1078,16 +1016,6 @@ enforce-blocks 0 # permit-access 192.168.45.64/26 # deny-access 192.168.45.73 www.dirty-stuff.example.com # -# Allow access from the IPv4 network 192.0.2.0/24 even if listening -# on an IPv6 wild card address (not supported on all platforms): -# -# permit-access 192.0.2.0/24 -# -# -# This is equivalent to the following line even if listening on -# an IPv4 address (not supported on all platforms): -# -# permit-access [::ffff:192.0.2.0]/120 # # # 4.8. buffer-limit @@ -1165,7 +1093,7 @@ buffer-limit 4096 # to denote "all URLs". http_parent[:port] is the DNS name or # IP address of the parent HTTP proxy through which the requests # should be forwarded, optionally followed by its listening port -# (default: 8000). Use a single dot (.) to denote "no forwarding". +# (default: 8080). Use a single dot (.) to denote "no forwarding". # # Default value: # @@ -1180,13 +1108,6 @@ buffer-limit 4096 # If http_parent is ".", then requests are not forwarded to # another HTTP proxy but are made directly to the web servers. # -# http_parent can be a numerical IPv6 address (if RFC 3493 is -# implemented). To prevent clashes with the port delimiter, -# the whole IP address has to be put into brackets. On the other -# hand a target_pattern containing an IPv6 address has to be put -# into angle brackets (normal brackets are reserved for regular -# expressions already). -# # Multiple lines are OK, they are checked in sequence, and the # last match wins. # @@ -1206,16 +1127,6 @@ buffer-limit 4096 # forward .isp.example.net . # # -# Parent proxy specified by an IPv6 address: -# -# forward / [2001:DB8::1]:8000 -# -# -# Suppose your parent proxy doesn't support IPv6: -# -# forward / parent-proxy.example.org:8000 -# forward ipv6-server.example.org . -# forward <[2-3][0-9a-f][0-9a-f][0-9a-f]:*> . # # # 5.2. forward-socks4, forward-socks4a and forward-socks5 @@ -1258,13 +1169,6 @@ buffer-limit 4096 # With forward-socks5 the DNS resolution will happen on the remote # server as well. # -# socks_proxy and http_parent can be a numerical IPv6 address -# (if RFC 3493 is implemented). To prevent clashes with the port -# delimiter, the whole IP address has to be put into brackets. On -# the other hand a target_pattern containing an IPv6 address has -# to be put into angle brackets (normal brackets are reserved -# for regular expressions already). -# # If http_parent is ".", then requests are not forwarded to another # HTTP proxy but are made (HTTP-wise) directly to the web servers, # albeit through a SOCKS proxy. @@ -1289,7 +1193,7 @@ buffer-limit 4096 # To chain Privoxy and Tor, both running on the same system, # you would use something like: # -# forward-socks5 / 127.0.0.1:9050 . +# forward-socks4a / 127.0.0.1:9050 . # # # The public Tor network can't be used to reach your local network, @@ -1315,6 +1219,7 @@ buffer-limit 4096 # # # +# # 5.3. forwarded-connect-retries # =============================== # @@ -1355,9 +1260,6 @@ buffer-limit 4096 # 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. -# # Examples: # # forwarded-connect-retries 1 @@ -1365,10 +1267,7 @@ buffer-limit 4096 forwarded-connect-retries 0 # # -# 6. MISCELLANEOUS -# ================= -# -# 6.1. accept-intercepted-requests +# 5.4. accept-intercepted-requests # ================================= # # Specifies: @@ -1407,7 +1306,7 @@ forwarded-connect-retries 0 accept-intercepted-requests 0 # # -# 6.2. allow-cgi-request-crunching +# 5.5. allow-cgi-request-crunching # ================================= # # Specifies: @@ -1445,7 +1344,7 @@ accept-intercepted-requests 0 allow-cgi-request-crunching 0 # # -# 6.3. split-large-forms +# 5.6. split-large-forms # ======================= # # Specifies: @@ -1487,7 +1386,7 @@ allow-cgi-request-crunching 0 split-large-forms 0 # # -# 6.4. keep-alive-timeout +# 5.7. keep-alive-timeout # ======================== # # Specifies: @@ -1505,168 +1404,36 @@ split-large-forms 0 # # Effect if unset: # -# Connections are not kept alive. +# Connections are not reused. # # Notes: # -# This option allows clients to keep the connection to Privoxy -# alive. If the server supports it, Privoxy will keep the -# connection to the server alive as well. Under certain -# circumstances this may result in speed-ups. -# -# By default, Privoxy will close the connection to the server if -# the client connection gets closed, or if the specified timeout -# has been reached without a new request coming in. This behaviour -# can be changed with the connection-sharing option. -# # 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. -# -# Examples: -# -# keep-alive-timeout 300 -# -keep-alive-timeout 5 -# -# -# 6.5. default-server-timeout -# ============================ -# -# Specifies: -# -# Assumed server-side keep-alive timeout if not specified by -# the server. -# -# Type of value: -# -# Time in seconds. -# -# Default value: -# -# None -# -# Effect if unset: -# -# Connections for which the server didn't specify the keep-alive -# timeout are not reused. -# -# Notes: -# -# Enabling this option significantly increases the number of -# connections that are reused, provided the keep-alive-timeout -# option is also enabled. -# -# While it also increases the number of connections problems when -# Privoxy tries to reuse a connection that already has been closed -# on the server side, or is closed while Privoxy is trying to -# reuse it, this should only be a problem if it happens for the -# first request sent by the client. If it happens for requests -# on reused client connections, Privoxy will simply close the -# connection and the client is supposed to retry the request -# without bothering the user. -# -# Enabling this option is therefore only recommended if the -# connection-sharing option is disabled. -# -# It is an error to specify a value larger than the -# keep-alive-timeout value. -# -# This option has no effect if Privoxy has been compiled without -# keep-alive support. -# -# Examples: -# -# default-server-timeout 60 -# -#default-server-timeout 60 -# -# -# 6.6. connection-sharing -# ======================== -# -# Specifies: -# -# Whether or not outgoing connections that have been kept alive -# should be shared between different incoming connections. -# -# Type of value: -# -# 0 or 1 -# -# Default value: -# -# None -# -# Effect if unset: -# -# Connections are not shared. -# -# Notes: -# -# This option has no effect if Privoxy has been compiled without -# keep-alive support, or if it's disabled. -# # Notes: # # Note that reusing connections doesn't necessary cause # speedups. There are also a few privacy implications you should # be aware of. # -# If this option is effective, outgoing connections are shared -# between clients (if there are more than one) and closing the -# browser that initiated the outgoing connection does no longer -# affect the connection between Privoxy and the server unless -# the client's request hasn't been completed yet. -# -# If the outgoing connection is idle, it will not be closed until -# either Privoxy's or the server's timeout is reached. While +# Outgoing connections are shared between clients (if there are +# more than one) and closing the client that initiated the outgoing +# connection does not affect the connection between Privoxy and +# the server unless the client's request hasn't been completed +# yet. If the outgoing connection is idle, it will not be closed +# until either Privoxy's or the server's timeout is reached. While # it's open, the server knows that the system running Privoxy is # still there. # -# If there are more than one client (maybe even belonging to -# multiple users), they will be able to reuse each others -# connections. This is potentially dangerous in case of -# authentication schemes like NTLM where only the connection -# is authenticated, instead of requiring authentication for -# each request. -# -# If there is only a single client, and if said client can keep -# connections alive on its own, enabling this option has next to -# no effect. If the client doesn't support connection keep-alive, -# enabling this option may make sense as it allows Privoxy to keep -# outgoing connections alive even if the client itself doesn't -# support it. -# -# You should also be aware that enabling this option increases -# the likelihood of getting the "No server or forwarder data" -# error message, especially if you are using a slow connection -# to the Internet. -# -# This option should only be used by experienced users who -# understand the risks and can weight them against the benefits. -# # Examples: # -# connection-sharing 1 +# keep-alive-timeout 300 # -#connection-sharing 1 +keep-alive-timeout 300 # # -# 6.7. socket-timeout +# 5.8. socket-timeout # ==================== # # Specifies: @@ -1699,187 +1466,7 @@ keep-alive-timeout 5 socket-timeout 300 # # -# 6.8. max-client-connections -# ============================ -# -# Specifies: -# -# Maximum number of client connections that will be served. -# -# Type of value: -# -# Positive number. -# -# Default value: -# -# None -# -# Effect if unset: -# -# Connections are served until a resource limit is reached. -# -# Notes: -# -# Privoxy creates one thread (or process) for every incoming -# client connection that isn't rejected based on the access -# control settings. -# -# If the system is powerful enough, Privoxy can theoretically deal -# with several hundred (or thousand) connections at the same time, -# but some operating systems enforce resource limits by shutting -# down offending processes and their default limits may be below -# the ones Privoxy would require under heavy load. -# -# Configuring Privoxy to enforce a connection limit below the -# thread or process limit used by the operating system makes -# sure this doesn't happen. Simply increasing the operating -# system's limit would work too, but if Privoxy isn't the only -# application running on the system, you may actually want to -# limit the resources used by Privoxy. -# -# If Privoxy is only used by a single trusted user, limiting the -# number of client connections is probably unnecessary. If there -# are multiple possibly untrusted users you probably still want -# to additionally use a packet filter to limit the maximal number -# of incoming connections per client. Otherwise a malicious user -# could intentionally create a high number of connections to -# prevent other users from using Privoxy. -# -# Obviously using this option only makes sense if you choose a -# limit below the one enforced by the operating system. -# -# Examples: -# -# max-client-connections 256 -# -#max-client-connections 256 - -# -# 6.9. handle-as-empty-doc-returns-ok -# ==================================== -# -# Specifies: -# -# The status code Privoxy returns for pages blocked with -# +handle-as-empty-document. -# -# Type of value: -# -# 0 or 1 -# -# Default value: -# -# 0 -# -# Effect if unset: -# -# Privoxy returns a status 403(forbidden) for all blocked pages. -# -# Effect if set: -# -# Privoxy returns a status 200(OK) for pages blocked with -# +handle-as-empty-document and a status 403(Forbidden) for all -# other blocked pages. -# -# 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 1 -# -# -# 1.6.10. enable-compression -# -# Specifies: -# -# Whether or not buffered content is compressed before delivery. -# -# Type of value: -# -# 0 or 1 -# -# Default value: -# -# 0 -# -# Effect if unset: -# -# Privoxy does not compress buffered content. -# -# Effect if set: -# -# Privoxy compresses buffered content before delivering it to -# the client, provided the client supports it. -# -# Notes: -# -# This directive is only supported if Privoxy has been compiled -# with FEATURE_COMPRESSION, which should not to be confused -# with FEATURE_ZLIB. -# -# Compressing buffered content is mainly useful if Privoxy and the -# client are running on different systems. If they are running on -# the same system, enabling compression is likely to slow things -# down. If you didn't measure otherwise, you should assume that -# it does and keep this option disabled. -# -# Privoxy will not compress buffered content below a certain -# length. -# -#enable-compression 1 -# -# -# 1.6.11. compression-level -# -# Specifies: -# -# The compression level that is passed to the zlib library when -# compressing buffered content. -# -# Type of value: -# -# Positive number ranging from 0 to 9. -# -# Default value: -# -# 1 -# -# Notes: -# -# Compressing the data more takes usually longer than compressing -# it less or not compressing it at all. Which level is best -# depends on the connection between Privoxy and the client. If -# you can't be bothered to benchmark it for yourself, you should -# stick with the default and keep compression disabled. -# -# If compression is disabled, the compression level is irrelevant. -# -# Examples: -# -# # Best speed (compared to the other levels) -# compression-level 1 -# -# # Best compression -# compression-level 9 -# -# # No compression. Only useful for testing as the added header -# # slightly increases the amount of data that has to be sent. -# # If your benchmark shows that using this compression level -# # is superior to using no compression at all, the benchmark -# # is likely to be flawed. -# compression-level 0 -# -# -#compression-level 1 -# -# -# 7. WINDOWS GUI OPTIONS +# 6. WINDOWS GUI OPTIONS # ======================= # # Privoxy has a number of options specific to the Windows GUI diff --git a/external/privoxy/config.guess b/external/privoxy/config.guess old mode 100755 new mode 100644 index 8152efd..f32079a --- a/external/privoxy/config.guess +++ b/external/privoxy/config.guess @@ -1,10 +1,10 @@ #! /bin/sh # Attempt to guess a canonical system name. # Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, -# 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, -# 2011 Free Software Foundation, Inc. +# 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 +# Free Software Foundation, Inc.
-timestamp='2011-11-11' +timestamp='2008-01-23'
# This file is free software; you can redistribute it and/or modify it # under the terms of the GNU General Public License as published by @@ -27,16 +27,16 @@ timestamp='2011-11-11' # the same distribution terms that you use for the rest of that program.
-# Originally written by Per Bothner. Please send patches (context -# diff format) to <config-patches@gnu.org> and include a ChangeLog -# entry. +# Originally written by Per Bothner <per@bothner.com>. +# Please send patches to <config-patches@gnu.org>. Submit a context +# diff and a properly formatted ChangeLog entry. # # This script attempts to guess a canonical system name similar to # config.sub. If it succeeds, it prints the system name on stdout, and # exits with 0. Otherwise, it exits with 1. # -# You can get the latest version of this script from: -# http://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.guess;hb=HEAD +# The plan is that this can be called by configure scripts if you +# don't specify an explicit build system type.
me=`echo "$0" | sed -e 's,.*/,,'`
@@ -56,9 +56,8 @@ version="\ GNU config.guess ($timestamp)
Originally written by Per Bothner. -Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, -2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free -Software Foundation, Inc. +Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, +2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE." @@ -171,7 +170,7 @@ case "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" in arm*|i386|m68k|ns32k|sh3*|sparc|vax) eval $set_cc_for_build if echo __ELF__ | $CC_FOR_BUILD -E - 2>/dev/null \ - | grep -q __ELF__ + | grep __ELF__ >/dev/null then # Once all utilities can be ECOFF (netbsdecoff) or a.out (netbsdaout). # Return netbsd for either. FIX? @@ -181,7 +180,7 @@ case "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" in fi ;; *) - os=netbsd + os=netbsd ;; esac # The OS release @@ -224,7 +223,7 @@ case "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" in UNAME_RELEASE=`/usr/sbin/sizer -v | awk '{print $3}'` ;; *5.*) - UNAME_RELEASE=`/usr/sbin/sizer -v | awk '{print $4}'` + UNAME_RELEASE=`/usr/sbin/sizer -v | awk '{print $4}'` ;; esac # According to Compaq, /usr/sbin/psrinfo has been available on @@ -270,10 +269,7 @@ case "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" in # A Xn.n version is an unreleased experimental baselevel. # 1.2 uses "1.2" for uname -r. echo ${UNAME_MACHINE}-dec-osf`echo ${UNAME_RELEASE} | sed -e 's/^[PVTX]//' | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz'` - # Reset EXIT trap before exiting to avoid spurious non-zero exit code. - exitcode=$? - trap '' 0 - exit $exitcode ;; + exit ;; Alpha\ *:Windows_NT*:*) # How do we know it's Interix rather than the generic POSIX subsystem? # Should we change UNAME_MACHINE based on the output of uname instead @@ -299,7 +295,7 @@ case "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" in echo s390-ibm-zvmoe exit ;; *:OS400:*:*) - echo powerpc-ibm-os400 + echo powerpc-ibm-os400 exit ;; arm:RISC*:1.[012]*:*|arm:riscix:1.[012]*:*) echo arm-acorn-riscix${UNAME_RELEASE} @@ -328,33 +324,14 @@ case "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" in case `/usr/bin/uname -p` in sparc) echo sparc-icl-nx7; exit ;; esac ;; - s390x:SunOS:*:*) - echo ${UNAME_MACHINE}-ibm-solaris2`echo ${UNAME_RELEASE}|sed -e 's/[^.]*//'` - exit ;; sun4H:SunOS:5.*:*) echo sparc-hal-solaris2`echo ${UNAME_RELEASE}|sed -e 's/[^.]*//'` exit ;; sun4*:SunOS:5.*:* | tadpole*:SunOS:5.*:*) echo sparc-sun-solaris2`echo ${UNAME_RELEASE}|sed -e 's/[^.]*//'` exit ;; - i86pc:AuroraUX:5.*:* | i86xen:AuroraUX:5.*:*) - echo i386-pc-auroraux${UNAME_RELEASE} - exit ;; i86pc:SunOS:5.*:* | i86xen:SunOS:5.*:*) - eval $set_cc_for_build - SUN_ARCH="i386" - # If there is a compiler, see if it is configured for 64-bit objects. - # Note that the Sun cc does not turn __LP64__ into 1 like gcc does. - # This test works for both compilers. - if [ "$CC_FOR_BUILD" != 'no_compiler_found' ]; then - if (echo '#ifdef __amd64'; echo IS_64BIT_ARCH; echo '#endif') | \ - (CCOPTS= $CC_FOR_BUILD -E - 2>/dev/null) | \ - grep IS_64BIT_ARCH >/dev/null - then - SUN_ARCH="x86_64" - fi - fi - echo ${SUN_ARCH}-pc-solaris2`echo ${UNAME_RELEASE}|sed -e 's/[^.]*//'` + echo i386-pc-solaris2`echo ${UNAME_RELEASE}|sed -e 's/[^.]*//'` exit ;; sun4*:SunOS:6*:*) # According to config.sub, this is the proper way to canonicalize @@ -398,23 +375,23 @@ case "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" in # MiNT. But MiNT is downward compatible to TOS, so this should # be no problem. atarist[e]:*MiNT:*:* | atarist[e]:*mint:*:* | atarist[e]:*TOS:*:*) - echo m68k-atari-mint${UNAME_RELEASE} + echo m68k-atari-mint${UNAME_RELEASE} exit ;; atari*:*MiNT:*:* | atari*:*mint:*:* | atarist[e]:*TOS:*:*) echo m68k-atari-mint${UNAME_RELEASE} - exit ;; + exit ;; *falcon*:*MiNT:*:* | *falcon*:*mint:*:* | *falcon*:*TOS:*:*) - echo m68k-atari-mint${UNAME_RELEASE} + echo m68k-atari-mint${UNAME_RELEASE} exit ;; milan*:*MiNT:*:* | milan*:*mint:*:* | *milan*:*TOS:*:*) - echo m68k-milan-mint${UNAME_RELEASE} - exit ;; + echo m68k-milan-mint${UNAME_RELEASE} + exit ;; hades*:*MiNT:*:* | hades*:*mint:*:* | *hades*:*TOS:*:*) - echo m68k-hades-mint${UNAME_RELEASE} - exit ;; + echo m68k-hades-mint${UNAME_RELEASE} + exit ;; *:*MiNT:*:* | *:*mint:*:* | *:*TOS:*:*) - echo m68k-unknown-mint${UNAME_RELEASE} - exit ;; + echo m68k-unknown-mint${UNAME_RELEASE} + exit ;; m68k:machten:*:*) echo m68k-apple-machten${UNAME_RELEASE} exit ;; @@ -484,8 +461,8 @@ EOF echo m88k-motorola-sysv3 exit ;; AViiON:dgux:*:*) - # DG/UX returns AViiON for all architectures - UNAME_PROCESSOR=`/usr/bin/uname -p` + # DG/UX returns AViiON for all architectures + UNAME_PROCESSOR=`/usr/bin/uname -p` if [ $UNAME_PROCESSOR = mc88100 ] || [ $UNAME_PROCESSOR = mc88110 ] then if [ ${TARGET_BINARY_INTERFACE}x = m88kdguxelfx ] || \ @@ -498,7 +475,7 @@ EOF else echo i586-dg-dgux${UNAME_RELEASE} fi - exit ;; + exit ;; M88*:DolphinOS:*:*) # DolphinOS (SVR3) echo m88k-dolphin-sysv3 exit ;; @@ -555,7 +532,7 @@ EOF echo rs6000-ibm-aix3.2 fi exit ;; - *:AIX:*:[4567]) + *:AIX:*:[456]) IBM_CPU_ID=`/usr/sbin/lsdev -C -c processor -S available | sed 1q | awk '{ print $1 }'` if /usr/sbin/lsattr -El ${IBM_CPU_ID} | grep ' POWER' >/dev/null 2>&1; then IBM_ARCH=rs6000 @@ -598,52 +575,52 @@ EOF 9000/[678][0-9][0-9]) if [ -x /usr/bin/getconf ]; then sc_cpu_version=`/usr/bin/getconf SC_CPU_VERSION 2>/dev/null` - sc_kernel_bits=`/usr/bin/getconf SC_KERNEL_BITS 2>/dev/null` - case "${sc_cpu_version}" in - 523) HP_ARCH="hppa1.0" ;; # CPU_PA_RISC1_0 - 528) HP_ARCH="hppa1.1" ;; # CPU_PA_RISC1_1 - 532) # CPU_PA_RISC2_0 - case "${sc_kernel_bits}" in - 32) HP_ARCH="hppa2.0n" ;; - 64) HP_ARCH="hppa2.0w" ;; + sc_kernel_bits=`/usr/bin/getconf SC_KERNEL_BITS 2>/dev/null` + case "${sc_cpu_version}" in + 523) HP_ARCH="hppa1.0" ;; # CPU_PA_RISC1_0 + 528) HP_ARCH="hppa1.1" ;; # CPU_PA_RISC1_1 + 532) # CPU_PA_RISC2_0 + case "${sc_kernel_bits}" in + 32) HP_ARCH="hppa2.0n" ;; + 64) HP_ARCH="hppa2.0w" ;; '') HP_ARCH="hppa2.0" ;; # HP-UX 10.20 - esac ;; - esac + esac ;; + esac fi if [ "${HP_ARCH}" = "" ]; then eval $set_cc_for_build - sed 's/^ //' << EOF >$dummy.c + sed 's/^ //' << EOF >$dummy.c
- #define _HPUX_SOURCE - #include <stdlib.h> - #include <unistd.h> + #define _HPUX_SOURCE + #include <stdlib.h> + #include <unistd.h>
- int main () - { - #if defined(_SC_KERNEL_BITS) - long bits = sysconf(_SC_KERNEL_BITS); - #endif - long cpu = sysconf (_SC_CPU_VERSION); + int main () + { + #if defined(_SC_KERNEL_BITS) + long bits = sysconf(_SC_KERNEL_BITS); + #endif + long cpu = sysconf (_SC_CPU_VERSION);
- switch (cpu) - { - case CPU_PA_RISC1_0: puts ("hppa1.0"); break; - case CPU_PA_RISC1_1: puts ("hppa1.1"); break; - case CPU_PA_RISC2_0: - #if defined(_SC_KERNEL_BITS) - switch (bits) - { - case 64: puts ("hppa2.0w"); break; - case 32: puts ("hppa2.0n"); break; - default: puts ("hppa2.0"); break; - } break; - #else /* !defined(_SC_KERNEL_BITS) */ - puts ("hppa2.0"); break; - #endif - default: puts ("hppa1.0"); break; - } - exit (0); - } + switch (cpu) + { + case CPU_PA_RISC1_0: puts ("hppa1.0"); break; + case CPU_PA_RISC1_1: puts ("hppa1.1"); break; + case CPU_PA_RISC2_0: + #if defined(_SC_KERNEL_BITS) + switch (bits) + { + case 64: puts ("hppa2.0w"); break; + case 32: puts ("hppa2.0n"); break; + default: puts ("hppa2.0"); break; + } break; + #else /* !defined(_SC_KERNEL_BITS) */ + puts ("hppa2.0"); break; + #endif + default: puts ("hppa1.0"); break; + } + exit (0); + } EOF (CCOPTS= $CC_FOR_BUILD -o $dummy $dummy.c 2>/dev/null) && HP_ARCH=`$dummy` test -z "$HP_ARCH" && HP_ARCH=hppa @@ -663,7 +640,7 @@ EOF # => hppa64-hp-hpux11.23
if echo __LP64__ | (CCOPTS= $CC_FOR_BUILD -E - 2>/dev/null) | - grep -q __LP64__ + grep __LP64__ >/dev/null then HP_ARCH="hppa2.0w" else @@ -734,22 +711,22 @@ EOF exit ;; C1*:ConvexOS:*:* | convex:ConvexOS:C1*:*) echo c1-convex-bsd - exit ;; + exit ;; C2*:ConvexOS:*:* | convex:ConvexOS:C2*:*) if getsysinfo -f scalar_acc then echo c32-convex-bsd else echo c2-convex-bsd fi - exit ;; + exit ;; C34*:ConvexOS:*:* | convex:ConvexOS:C34*:*) echo c34-convex-bsd - exit ;; + exit ;; C38*:ConvexOS:*:* | convex:ConvexOS:C38*:*) echo c38-convex-bsd - exit ;; + exit ;; C4*:ConvexOS:*:* | convex:ConvexOS:C4*:*) echo c4-convex-bsd - exit ;; + exit ;; CRAY*Y-MP:*:*:*) echo ymp-cray-unicos${UNAME_RELEASE} | sed -e 's/.[^.]*$/.X/' exit ;; @@ -773,14 +750,14 @@ EOF exit ;; F30[01]:UNIX_System_V:*:* | F700:UNIX_System_V:*:*) FUJITSU_PROC=`uname -m | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz'` - FUJITSU_SYS=`uname -p | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz' | sed -e 's////'` - FUJITSU_REL=`echo ${UNAME_RELEASE} | sed -e 's/ /_/'` - echo "${FUJITSU_PROC}-fujitsu-${FUJITSU_SYS}${FUJITSU_REL}" - exit ;; + FUJITSU_SYS=`uname -p | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz' | sed -e 's////'` + FUJITSU_REL=`echo ${UNAME_RELEASE} | sed -e 's/ /_/'` + echo "${FUJITSU_PROC}-fujitsu-${FUJITSU_SYS}${FUJITSU_REL}" + exit ;; 5000:UNIX_System_V:4.*:*) - FUJITSU_SYS=`uname -p | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz' | sed -e 's////'` - FUJITSU_REL=`echo ${UNAME_RELEASE} | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz' | sed -e 's/ /_/'` - echo "sparc-fujitsu-${FUJITSU_SYS}${FUJITSU_REL}" + FUJITSU_SYS=`uname -p | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz' | sed -e 's////'` + FUJITSU_REL=`echo ${UNAME_RELEASE} | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz' | sed -e 's/ /_/'` + echo "sparc-fujitsu-${FUJITSU_SYS}${FUJITSU_REL}" exit ;; i*86:BSD/386:*:* | i*86:BSD/OS:*:* | *:Ascend\ Embedded/OS:*:*) echo ${UNAME_MACHINE}-pc-bsdi${UNAME_RELEASE} @@ -792,12 +769,13 @@ EOF echo ${UNAME_MACHINE}-unknown-bsdi${UNAME_RELEASE} exit ;; *:FreeBSD:*:*) - UNAME_PROCESSOR=`/usr/bin/uname -p` - case ${UNAME_PROCESSOR} in + case ${UNAME_MACHINE} in + pc98) + echo i386-unknown-freebsd`echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'` ;; amd64) echo x86_64-unknown-freebsd`echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'` ;; *) - echo ${UNAME_PROCESSOR}-unknown-freebsd`echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'` ;; + echo ${UNAME_MACHINE}-unknown-freebsd`echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'` ;; esac exit ;; i*:CYGWIN*:*) @@ -806,22 +784,19 @@ EOF *:MINGW*:*) echo ${UNAME_MACHINE}-pc-mingw32 exit ;; - i*:MSYS*:*) - echo ${UNAME_MACHINE}-pc-msys - exit ;; i*:windows32*:*) - # uname -m includes "-pc" on this system. - echo ${UNAME_MACHINE}-mingw32 + # uname -m includes "-pc" on this system. + echo ${UNAME_MACHINE}-mingw32 exit ;; i*:PW*:*) echo ${UNAME_MACHINE}-pc-pw32 exit ;; - *:Interix*:*) - case ${UNAME_MACHINE} in + *:Interix*:[3456]*) + case ${UNAME_MACHINE} in x86) echo i586-pc-interix${UNAME_RELEASE} exit ;; - authenticamd | genuineintel | EM64T) + EM64T | authenticamd) echo x86_64-unknown-interix${UNAME_RELEASE} exit ;; IA64) @@ -831,9 +806,6 @@ EOF [345]86:Windows_95:* | [345]86:Windows_98:* | [345]86:Windows_NT:*) echo i${UNAME_MACHINE}-pc-mks exit ;; - 8664:Windows_NT:*) - echo x86_64-pc-mks - exit ;; i*:Windows_NT*:* | Pentium*:Windows_NT*:*) # How do we know it's Interix rather than the generic POSIX subsystem? # It also conflicts with pre-2.0 versions of AT&T UWIN. Should we @@ -863,20 +835,6 @@ EOF i*86:Minix:*:*) echo ${UNAME_MACHINE}-pc-minix exit ;; - alpha:Linux:*:*) - case `sed -n '/^cpu model/s/^.*: (.*)/\1/p' < /proc/cpuinfo` in - EV5) UNAME_MACHINE=alphaev5 ;; - EV56) UNAME_MACHINE=alphaev56 ;; - PCA56) UNAME_MACHINE=alphapca56 ;; - PCA57) UNAME_MACHINE=alphapca56 ;; - EV6) UNAME_MACHINE=alphaev6 ;; - EV67) UNAME_MACHINE=alphaev67 ;; - EV68*) UNAME_MACHINE=alphaev68 ;; - esac - objdump --private-headers /bin/sh | grep -q ld.so.1 - if test "$?" = 0 ; then LIBC="libc1" ; else LIBC="" ; fi - echo ${UNAME_MACHINE}-unknown-linux-gnu${LIBC} - exit ;; arm*:Linux:*:*) eval $set_cc_for_build if echo __ARM_EABI__ | $CC_FOR_BUILD -E - 2>/dev/null \ @@ -884,13 +842,7 @@ EOF then echo ${UNAME_MACHINE}-unknown-linux-gnu else - if echo __ARM_PCS_VFP | $CC_FOR_BUILD -E - 2>/dev/null \ - | grep -q __ARM_PCS_VFP - then - echo ${UNAME_MACHINE}-unknown-linux-gnueabi - else - echo ${UNAME_MACHINE}-unknown-linux-gnueabihf - fi + echo ${UNAME_MACHINE}-unknown-linux-gnueabi fi exit ;; avr32*:Linux:*:*) @@ -903,21 +855,7 @@ EOF echo crisv32-axis-linux-gnu exit ;; frv:Linux:*:*) - echo frv-unknown-linux-gnu - exit ;; - hexagon:Linux:*:*) - echo hexagon-unknown-linux-gnu - exit ;; - i*86:Linux:*:*) - LIBC=gnu - eval $set_cc_for_build - sed 's/^ //' << EOF >$dummy.c - #ifdef __dietlibc__ - LIBC=dietlibc - #endif -EOF - eval `$CC_FOR_BUILD -E $dummy.c 2>/dev/null | grep '^LIBC'` - echo "${UNAME_MACHINE}-pc-linux-${LIBC}" + echo frv-unknown-linux-gnu exit ;; ia64:Linux:*:*) echo ${UNAME_MACHINE}-unknown-linux-gnu @@ -928,33 +866,74 @@ EOF m68*:Linux:*:*) echo ${UNAME_MACHINE}-unknown-linux-gnu exit ;; - mips:Linux:*:* | mips64:Linux:*:*) + mips:Linux:*:*) + eval $set_cc_for_build + sed 's/^ //' << EOF >$dummy.c + #undef CPU + #undef mips + #undef mipsel + #if defined(__MIPSEL__) || defined(__MIPSEL) || defined(_MIPSEL) || defined(MIPSEL) + CPU=mipsel + #else + #if defined(__MIPSEB__) || defined(__MIPSEB) || defined(_MIPSEB) || defined(MIPSEB) + CPU=mips + #else + CPU= + #endif + #endif +EOF + eval "`$CC_FOR_BUILD -E $dummy.c 2>/dev/null | sed -n ' + /^CPU/{ + s: ::g + p + }'`" + test x"${CPU}" != x && { echo "${CPU}-unknown-linux-gnu"; exit; } + ;; + mips64:Linux:*:*) eval $set_cc_for_build sed 's/^ //' << EOF >$dummy.c #undef CPU - #undef ${UNAME_MACHINE} - #undef ${UNAME_MACHINE}el + #undef mips64 + #undef mips64el #if defined(__MIPSEL__) || defined(__MIPSEL) || defined(_MIPSEL) || defined(MIPSEL) - CPU=${UNAME_MACHINE}el + CPU=mips64el #else #if defined(__MIPSEB__) || defined(__MIPSEB) || defined(_MIPSEB) || defined(MIPSEB) - CPU=${UNAME_MACHINE} + CPU=mips64 #else CPU= #endif #endif EOF - eval `$CC_FOR_BUILD -E $dummy.c 2>/dev/null | grep '^CPU'` + eval "`$CC_FOR_BUILD -E $dummy.c 2>/dev/null | sed -n ' + /^CPU/{ + s: ::g + p + }'`" test x"${CPU}" != x && { echo "${CPU}-unknown-linux-gnu"; exit; } ;; or32:Linux:*:*) echo or32-unknown-linux-gnu exit ;; - padre:Linux:*:*) - echo sparc-unknown-linux-gnu + ppc:Linux:*:*) + echo powerpc-unknown-linux-gnu exit ;; - parisc64:Linux:*:* | hppa64:Linux:*:*) - echo hppa64-unknown-linux-gnu + ppc64:Linux:*:*) + echo powerpc64-unknown-linux-gnu + exit ;; + alpha:Linux:*:*) + case `sed -n '/^cpu model/s/^.*: (.*)/\1/p' < /proc/cpuinfo` in + EV5) UNAME_MACHINE=alphaev5 ;; + EV56) UNAME_MACHINE=alphaev56 ;; + PCA56) UNAME_MACHINE=alphapca56 ;; + PCA57) UNAME_MACHINE=alphapca56 ;; + EV6) UNAME_MACHINE=alphaev6 ;; + EV67) UNAME_MACHINE=alphaev67 ;; + EV68*) UNAME_MACHINE=alphaev68 ;; + esac + objdump --private-headers /bin/sh | grep ld.so.1 >/dev/null + if test "$?" = 0 ; then LIBC="libc1" ; else LIBC="" ; fi + echo ${UNAME_MACHINE}-unknown-linux-gnu${LIBC} exit ;; parisc:Linux:*:* | hppa:Linux:*:*) # Look for CPU level @@ -964,17 +943,14 @@ EOF *) echo hppa-unknown-linux-gnu ;; esac exit ;; - ppc64:Linux:*:*) - echo powerpc64-unknown-linux-gnu - exit ;; - ppc:Linux:*:*) - echo powerpc-unknown-linux-gnu + parisc64:Linux:*:* | hppa64:Linux:*:*) + echo hppa64-unknown-linux-gnu exit ;; s390:Linux:*:* | s390x:Linux:*:*) echo ${UNAME_MACHINE}-ibm-linux exit ;; sh64*:Linux:*:*) - echo ${UNAME_MACHINE}-unknown-linux-gnu + echo ${UNAME_MACHINE}-unknown-linux-gnu exit ;; sh*:Linux:*:*) echo ${UNAME_MACHINE}-unknown-linux-gnu @@ -982,9 +958,6 @@ EOF sparc:Linux:*:* | sparc64:Linux:*:*) echo ${UNAME_MACHINE}-unknown-linux-gnu exit ;; - tile*:Linux:*:*) - echo ${UNAME_MACHINE}-unknown-linux-gnu - exit ;; vax:Linux:*:*) echo ${UNAME_MACHINE}-dec-linux-gnu exit ;; @@ -992,8 +965,71 @@ EOF echo x86_64-unknown-linux-gnu exit ;; xtensa*:Linux:*:*) - echo ${UNAME_MACHINE}-unknown-linux-gnu + echo ${UNAME_MACHINE}-unknown-linux-gnu exit ;; + i*86:Linux:*:*) + # The BFD linker knows what the default object file format is, so + # first see if it will tell us. cd to the root directory to prevent + # problems with other programs or directories called `ld' in the path. + # Set LC_ALL=C to ensure ld outputs messages in English. + ld_supported_targets=`cd /; LC_ALL=C ld --help 2>&1 \ + | sed -ne '/supported targets:/!d + s/[ ][ ]*/ /g + s/.*supported targets: *// + s/ .*// + p'` + case "$ld_supported_targets" in + elf32-i386) + TENTATIVE="${UNAME_MACHINE}-pc-linux-gnu" + ;; + a.out-i386-linux) + echo "${UNAME_MACHINE}-pc-linux-gnuaout" + exit ;; + coff-i386) + echo "${UNAME_MACHINE}-pc-linux-gnucoff" + exit ;; + "") + # Either a pre-BFD a.out linker (linux-gnuoldld) or + # one that does not give us useful --help. + echo "${UNAME_MACHINE}-pc-linux-gnuoldld" + exit ;; + esac + # Determine whether the default compiler is a.out or elf + eval $set_cc_for_build + sed 's/^ //' << EOF >$dummy.c + #include <features.h> + #ifdef __ELF__ + # ifdef __GLIBC__ + # if __GLIBC__ >= 2 + LIBC=gnu + # else + LIBC=gnulibc1 + # endif + # else + LIBC=gnulibc1 + # endif + #else + #if defined(__INTEL_COMPILER) || defined(__PGI) || defined(__SUNPRO_C) || defined(__SUNPRO_CC) + LIBC=gnu + #else + LIBC=gnuaout + #endif + #endif + #ifdef __dietlibc__ + LIBC=dietlibc + #endif +EOF + eval "`$CC_FOR_BUILD -E $dummy.c 2>/dev/null | sed -n ' + /^LIBC/{ + s: ::g + p + }'`" + test x"${LIBC}" != x && { + echo "${UNAME_MACHINE}-pc-linux-${LIBC}" + exit + } + test x"${TENTATIVE}" != x && { echo "${TENTATIVE}"; exit; } + ;; i*86:DYNIX/ptx:4*:*) # ptx 4.0 does uname -s correctly, with DYNIX/ptx in there. # earlier versions are messed up and put the nodename in both @@ -1001,11 +1037,11 @@ EOF echo i386-sequent-sysv4 exit ;; i*86:UNIX_SV:4.2MP:2.*) - # Unixware is an offshoot of SVR4, but it has its own version - # number series starting with 2... - # I am not positive that other SVR4 systems won't match this, + # Unixware is an offshoot of SVR4, but it has its own version + # number series starting with 2... + # I am not positive that other SVR4 systems won't match this, # I just have to hope. -- rms. - # Use sysv4.2uw... so that sysv4* matches it. + # Use sysv4.2uw... so that sysv4* matches it. echo ${UNAME_MACHINE}-pc-sysv4.2uw${UNAME_VERSION} exit ;; i*86:OS/2:*:*) @@ -1022,7 +1058,7 @@ EOF i*86:syllable:*:*) echo ${UNAME_MACHINE}-pc-syllable exit ;; - i*86:LynxOS:2.*:* | i*86:LynxOS:3.[01]*:* | i*86:LynxOS:4.[02]*:*) + i*86:LynxOS:2.*:* | i*86:LynxOS:3.[01]*:* | i*86:LynxOS:4.0*:*) echo i386-unknown-lynxos${UNAME_RELEASE} exit ;; i*86:*DOS:*:*) @@ -1037,7 +1073,7 @@ EOF fi exit ;; i*86:*:5:[678]*) - # UnixWare 7.x, OpenUNIX and OpenServer 6. + # UnixWare 7.x, OpenUNIX and OpenServer 6. case `/bin/uname -X | grep "^Machine"` in *486*) UNAME_MACHINE=i486 ;; *Pentium) UNAME_MACHINE=i586 ;; @@ -1065,13 +1101,10 @@ EOF exit ;; pc:*:*:*) # Left here for compatibility: - # uname -m prints for DJGPP always 'pc', but it prints nothing about - # the processor, so we play safe by assuming i586. - # Note: whatever this is, it MUST be the same as what config.sub - # prints for the "djgpp" host, or else GDB configury will decide that - # this is a cross-build. - echo i586-pc-msdosdjgpp - exit ;; + # uname -m prints for DJGPP always 'pc', but it prints nothing about + # the processor, so we play safe by assuming i386. + echo i386-pc-msdosdjgpp + exit ;; Intel:Mach:3*:*) echo i386-pc-mach3 exit ;; @@ -1106,18 +1139,8 @@ EOF /bin/uname -p 2>/dev/null | /bin/grep entium >/dev/null \ && { echo i586-ncr-sysv4.3${OS_REL}; exit; } ;; 3[34]??:*:4.0:* | 3[34]??,*:*:4.0:*) - /bin/uname -p 2>/dev/null | grep 86 >/dev/null \ - && { echo i486-ncr-sysv4; exit; } ;; - NCR*:*:4.2:* | MPRAS*:*:4.2:*) - OS_REL='.3' - test -r /etc/.relid \ - && OS_REL=.`sed -n 's/[^ ]* [^ ]* ([0-9][0-9]).*/\1/p' < /etc/.relid` - /bin/uname -p 2>/dev/null | grep 86 >/dev/null \ - && { echo i486-ncr-sysv4.3${OS_REL}; exit; } - /bin/uname -p 2>/dev/null | /bin/grep entium >/dev/null \ - && { echo i586-ncr-sysv4.3${OS_REL}; exit; } - /bin/uname -p 2>/dev/null | /bin/grep pteron >/dev/null \ - && { echo i586-ncr-sysv4.3${OS_REL}; exit; } ;; + /bin/uname -p 2>/dev/null | grep 86 >/dev/null \ + && { echo i486-ncr-sysv4; exit; } ;; m68*:LynxOS:2.*:* | m68*:LynxOS:3.0*:*) echo m68k-unknown-lynxos${UNAME_RELEASE} exit ;; @@ -1130,7 +1153,7 @@ EOF rs6000:LynxOS:2.*:*) echo rs6000-unknown-lynxos${UNAME_RELEASE} exit ;; - PowerPC:LynxOS:2.*:* | PowerPC:LynxOS:3.[01]*:* | PowerPC:LynxOS:4.[02]*:*) + PowerPC:LynxOS:2.*:* | PowerPC:LynxOS:3.[01]*:* | PowerPC:LynxOS:4.0*:*) echo powerpc-unknown-lynxos${UNAME_RELEASE} exit ;; SM[BE]S:UNIX_SV:*:*) @@ -1150,10 +1173,10 @@ EOF echo ns32k-sni-sysv fi exit ;; - PENTIUM:*:4.0*:*) # Unisys `ClearPath HMP IX 4000' SVR4/MP effort - # says <Richard.M.Bartel@ccMail.Census.GOV> - echo i586-unisys-sysv4 - exit ;; + PENTIUM:*:4.0*:*) # Unisys `ClearPath HMP IX 4000' SVR4/MP effort + # says <Richard.M.Bartel@ccMail.Census.GOV> + echo i586-unisys-sysv4 + exit ;; *:UNIX_System_V:4*:FTX*) # From Gerald Hewes <hewes@openmarket.com>. # How about differentiating between stratus architectures? -djm @@ -1179,11 +1202,11 @@ EOF exit ;; R[34]000:*System_V*:*:* | R4000:UNIX_SYSV:*:* | R*000:UNIX_SV:*:*) if [ -d /usr/nec ]; then - echo mips-nec-sysv${UNAME_RELEASE} + echo mips-nec-sysv${UNAME_RELEASE} else - echo mips-unknown-sysv${UNAME_RELEASE} + echo mips-unknown-sysv${UNAME_RELEASE} fi - exit ;; + exit ;; BeBox:BeOS:*:*) # BeOS running on hardware made by Be, PPC only. echo powerpc-be-beos exit ;; @@ -1193,9 +1216,6 @@ EOF BePC:BeOS:*:*) # BeOS running on Intel PC compatible. echo i586-pc-beos exit ;; - BePC:Haiku:*:*) # Haiku running on Intel PC compatible. - echo i586-pc-haiku - exit ;; SX-4:SUPER-UX:*:*) echo sx4-nec-superux${UNAME_RELEASE} exit ;; @@ -1223,16 +1243,6 @@ EOF *:Darwin:*:*) UNAME_PROCESSOR=`uname -p` || UNAME_PROCESSOR=unknown case $UNAME_PROCESSOR in - i386) - eval $set_cc_for_build - if [ "$CC_FOR_BUILD" != 'no_compiler_found' ]; then - if (echo '#ifdef __LP64__'; echo IS_64BIT_ARCH; echo '#endif') | \ - (CCOPTS= $CC_FOR_BUILD -E - 2>/dev/null) | \ - grep IS_64BIT_ARCH >/dev/null - then - UNAME_PROCESSOR="x86_64" - fi - fi ;; unknown) UNAME_PROCESSOR=powerpc ;; esac echo ${UNAME_PROCESSOR}-apple-darwin${UNAME_RELEASE} @@ -1248,9 +1258,6 @@ EOF *:QNX:*:4*) echo i386-pc-qnx exit ;; - NEO-?:NONSTOP_KERNEL:*:*) - echo neo-tandem-nsk${UNAME_RELEASE} - exit ;; NSE-?:NONSTOP_KERNEL:*:*) echo nse-tandem-nsk${UNAME_RELEASE} exit ;; @@ -1296,13 +1303,13 @@ EOF echo pdp10-unknown-its exit ;; SEI:*:*:SEIUX) - echo mips-sei-seiux${UNAME_RELEASE} + echo mips-sei-seiux${UNAME_RELEASE} exit ;; *:DragonFly:*:*) echo ${UNAME_MACHINE}-unknown-dragonfly`echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'` exit ;; *:*VMS:*:*) - UNAME_MACHINE=`(uname -p) 2>/dev/null` + UNAME_MACHINE=`(uname -p) 2>/dev/null` case "${UNAME_MACHINE}" in A*) echo alpha-dec-vms ; exit ;; I*) echo ia64-dec-vms ; exit ;; @@ -1317,9 +1324,6 @@ EOF i*86:rdos:*:*) echo ${UNAME_MACHINE}-pc-rdos exit ;; - i*86:AROS:*:*) - echo ${UNAME_MACHINE}-pc-aros - exit ;; esac
#echo '(No uname command or uname output not recognized.)' 1>&2 @@ -1342,11 +1346,11 @@ main () #include <sys/param.h> printf ("m68k-sony-newsos%s\n", #ifdef NEWSOS4 - "4" + "4" #else - "" + "" #endif - ); exit (0); + ); exit (0); #endif #endif
diff --git a/external/privoxy/config.sub b/external/privoxy/config.sub old mode 100755 new mode 100644 index e76eaf4..de5d6a7 --- a/external/privoxy/config.sub +++ b/external/privoxy/config.sub @@ -1,10 +1,10 @@ #! /bin/sh # Configuration validation subroutine script. # Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, -# 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, -# 2011 Free Software Foundation, Inc. +# 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 +# Free Software Foundation, Inc.
-timestamp='2011-11-11' +timestamp='2008-02-05'
# This file is (in principle) common to ALL GNU software. # The presence of a machine in this file suggests that SOME GNU software @@ -32,16 +32,13 @@ timestamp='2011-11-11'
# Please send patches to <config-patches@gnu.org>. Submit a context -# diff and a properly formatted GNU ChangeLog entry. +# diff and a properly formatted ChangeLog entry. # # Configuration subroutine to validate and canonicalize a configuration type. # Supply the specified configuration type as an argument. # If it is invalid, we print an error message on stderr and exit with code 1. # Otherwise, we print the canonical config type on stdout and succeed.
-# You can get the latest version of this script from: -# http://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.sub;hb=HEAD - # This file is supposed to be the same for all GNU packages # and recognize all the CPU types, system types and aliases # that are meaningful with *any* GNU software. @@ -75,9 +72,8 @@ Report bugs and patches to <config-patches@gnu.org>." version="\ GNU config.sub ($timestamp)
-Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, -2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free -Software Foundation, Inc. +Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, +2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE." @@ -124,10 +120,8 @@ esac # Here we must recognize all the valid KERNEL-OS combinations. maybe_os=`echo $1 | sed 's/^(.*)-([^-]*-[^-]*)$/\2/'` case $maybe_os in - nto-qnx* | linux-gnu* | linux-android* | linux-dietlibc | linux-newlib* | \ - linux-uclibc* | uclinux-uclibc* | uclinux-gnu* | kfreebsd*-gnu* | \ - knetbsd*-gnu* | netbsd*-gnu* | \ - kopensolaris*-gnu* | \ + nto-qnx* | linux-gnu* | linux-dietlibc | linux-newlib* | linux-uclibc* | \ + uclinux-uclibc* | uclinux-gnu* | kfreebsd*-gnu* | knetbsd*-gnu* | netbsd*-gnu* | \ storm-chaos* | os2-emx* | rtmk-nova*) os=-$maybe_os basic_machine=`echo $1 | sed 's/^(.*)-([^-]*-[^-]*)$/\1/'` @@ -154,13 +148,10 @@ case $os in -convergent* | -ncr* | -news | -32* | -3600* | -3100* | -hitachi* |\ -c[123]* | -convex* | -sun | -crds | -omron* | -dg | -ultra | -tti* | \ -harris | -dolphin | -highlevel | -gould | -cbm | -ns | -masscomp | \ - -apple | -axis | -knuth | -cray | -microblaze) + -apple | -axis | -knuth | -cray) os= basic_machine=$1 ;; - -bluegene*) - os=-cnk - ;; -sim | -cisco | -oki | -wec | -winbond) os= basic_machine=$1 @@ -175,10 +166,10 @@ case $os in os=-chorusos basic_machine=$1 ;; - -chorusrdb) - os=-chorusrdb + -chorusrdb) + os=-chorusrdb basic_machine=$1 - ;; + ;; -hiux*) os=-hiuxwe2 ;; @@ -251,20 +242,15 @@ case $basic_machine in | alpha64 | alpha64ev[4-8] | alpha64ev56 | alpha64ev6[78] | alpha64pca5[67] \ | am33_2.0 \ | arc | arm | arm[bl]e | arme[lb] | armv[2345] | armv[345][lb] | avr | avr32 \ - | be32 | be64 \ | bfin \ | c4x | clipper \ | d10v | d30v | dlx | dsp16xx \ - | epiphany \ | fido | fr30 | frv \ | h8300 | h8500 | hppa | hppa1.[01] | hppa2.0 | hppa2.0[nw] | hppa64 \ - | hexagon \ | i370 | i860 | i960 | ia64 \ | ip2k | iq2000 \ - | le32 | le64 \ - | lm32 \ | m32c | m32r | m32rle | m68000 | m68k | m88k \ - | maxq | mb | microblaze | mcore | mep | metag \ + | maxq | mb | microblaze | mcore | mep \ | mips | mipsbe | mipseb | mipsel | mipsle \ | mips16 \ | mips64 | mips64el \ @@ -284,42 +270,28 @@ case $basic_machine in | mipsisa64sr71k | mipsisa64sr71kel \ | mipstx39 | mipstx39el \ | mn10200 | mn10300 \ - | moxie \ | mt \ | msp430 \ - | nds32 | nds32le | nds32be \ | nios | nios2 \ | ns16k | ns32k \ - | open8 \ | or32 \ | pdp10 | pdp11 | pj | pjl \ - | powerpc | powerpc64 | powerpc64le | powerpcle \ + | powerpc | powerpc64 | powerpc64le | powerpcle | ppcbe \ | pyramid \ - | rl78 | rx \ | score \ - | sh | sh[1234] | sh[24]a | sh[24]aeb | sh[23]e | sh[34]eb | sheb | shbe | shle | sh[1234]le | sh3ele \ + | sh | sh[1234] | sh[24]a | sh[23]e | sh[34]eb | sheb | shbe | shle | sh[1234]le | sh3ele \ | sh64 | sh64le \ | sparc | sparc64 | sparc64b | sparc64v | sparc86x | sparclet | sparclite \ | sparcv8 | sparcv9 | sparcv9b | sparcv9v \ - | spu \ - | tahoe | tic4x | tic54x | tic55x | tic6x | tic80 | tron \ - | ubicom32 \ - | v850 | v850e | v850e1 | v850e2 | v850es | v850e2v3 \ + | spu | strongarm \ + | tahoe | thumb | tic4x | tic80 | tron \ + | v850 | v850e \ | we32k \ - | x86 | xc16x | xstormy16 | xtensa \ - | z8k | z80) + | x86 | xc16x | xscale | xscalee[bl] | xstormy16 | xtensa \ + | z8k) basic_machine=$basic_machine-unknown ;; - c54x) - basic_machine=tic54x-unknown - ;; - c55x) - basic_machine=tic55x-unknown - ;; - c6x) - basic_machine=tic6x-unknown - ;; - m6811 | m68hc11 | m6812 | m68hc12 | picochip) + m6811 | m68hc11 | m6812 | m68hc12) # Motorola 68HC11/12. basic_machine=$basic_machine-unknown os=-none @@ -330,18 +302,6 @@ case $basic_machine in basic_machine=mt-unknown ;;
- strongarm | thumb | xscale) - basic_machine=arm-unknown - ;; - - xscaleeb) - basic_machine=armeb-unknown - ;; - - xscaleel) - basic_machine=armel-unknown - ;; - # We use `pc' rather than `unknown' # because (1) that's what they normally are, and # (2) the word "unknown" tends to confuse beginning users. @@ -361,23 +321,19 @@ case $basic_machine in | alphapca5[67]-* | alpha64pca5[67]-* | arc-* \ | arm-* | armbe-* | armle-* | armeb-* | armv*-* \ | avr-* | avr32-* \ - | be32-* | be64-* \ | bfin-* | bs2000-* \ - | c[123]* | c30-* | [cjt]90-* | c4x-* \ + | c[123]* | c30-* | [cjt]90-* | c4x-* | c54x-* | c55x-* | c6x-* \ | clipper-* | craynv-* | cydra-* \ | d10v-* | d30v-* | dlx-* \ | elxsi-* \ | f30[01]-* | f700-* | fido-* | fr30-* | frv-* | fx80-* \ | h8300-* | h8500-* \ | hppa-* | hppa1.[01]-* | hppa2.0-* | hppa2.0[nw]-* | hppa64-* \ - | hexagon-* \ | i*86-* | i860-* | i960-* | ia64-* \ | ip2k-* | iq2000-* \ - | le32-* | le64-* \ - | lm32-* \ | m32c-* | m32r-* | m32rle-* \ | m68000-* | m680[012346]0-* | m68360-* | m683?2-* | m68k-* \ - | m88110-* | m88k-* | maxq-* | mcore-* | metag-* | microblaze-* \ + | m88110-* | m88k-* | maxq-* | mcore-* \ | mips-* | mipsbe-* | mipseb-* | mipsel-* | mipsle-* \ | mips16-* \ | mips64-* | mips64el-* \ @@ -399,32 +355,27 @@ case $basic_machine in | mmix-* \ | mt-* \ | msp430-* \ - | nds32-* | nds32le-* | nds32be-* \ | nios-* | nios2-* \ | none-* | np1-* | ns16k-* | ns32k-* \ - | open8-* \ | orion-* \ | pdp10-* | pdp11-* | pj-* | pjl-* | pn-* | power-* \ - | powerpc-* | powerpc64-* | powerpc64le-* | powerpcle-* \ + | powerpc-* | powerpc64-* | powerpc64le-* | powerpcle-* | ppcbe-* \ | pyramid-* \ - | rl78-* | romp-* | rs6000-* | rx-* \ - | sh-* | sh[1234]-* | sh[24]a-* | sh[24]aeb-* | sh[23]e-* | sh[34]eb-* | sheb-* | shbe-* \ + | romp-* | rs6000-* \ + | sh-* | sh[1234]-* | sh[24]a-* | sh[23]e-* | sh[34]eb-* | sheb-* | shbe-* \ | shle-* | sh[1234]le-* | sh3ele-* | sh64-* | sh64le-* \ | sparc-* | sparc64-* | sparc64b-* | sparc64v-* | sparc86x-* | sparclet-* \ | sparclite-* \ - | sparcv8-* | sparcv9-* | sparcv9b-* | sparcv9v-* | sv1-* | sx?-* \ - | tahoe-* \ + | sparcv8-* | sparcv9-* | sparcv9b-* | sparcv9v-* | strongarm-* | sv1-* | sx?-* \ + | tahoe-* | thumb-* \ | tic30-* | tic4x-* | tic54x-* | tic55x-* | tic6x-* | tic80-* \ - | tile*-* \ | tron-* \ - | ubicom32-* \ - | v850-* | v850e-* | v850e1-* | v850es-* | v850e2-* | v850e2v3-* \ - | vax-* \ + | v850-* | v850e-* | vax-* \ | we32k-* \ - | x86-* | x86_64-* | xc16x-* | xps100-* \ + | x86-* | x86_64-* | xc16x-* | xps100-* | xscale-* | xscalee[bl]-* \ | xstormy16-* | xtensa*-* \ | ymp-* \ - | z8k-* | z80-*) + | z8k-*) ;; # Recognize the basic CPU types without company name, with glob match. xtensa*) @@ -446,7 +397,7 @@ case $basic_machine in basic_machine=a29k-amd os=-udi ;; - abacus) + abacus) basic_machine=abacus-unknown ;; adobe68k) @@ -492,10 +443,6 @@ case $basic_machine in basic_machine=m68k-apollo os=-bsd ;; - aros) - basic_machine=i386-pc - os=-aros - ;; aux) basic_machine=m68k-apple os=-aux @@ -512,27 +459,10 @@ case $basic_machine in basic_machine=bfin-`echo $basic_machine | sed 's/^[^-]*-//'` os=-linux ;; - bluegene*) - basic_machine=powerpc-ibm - os=-cnk - ;; - c54x-*) - basic_machine=tic54x-`echo $basic_machine | sed 's/^[^-]*-//'` - ;; - c55x-*) - basic_machine=tic55x-`echo $basic_machine | sed 's/^[^-]*-//'` - ;; - c6x-*) - basic_machine=tic6x-`echo $basic_machine | sed 's/^[^-]*-//'` - ;; c90) basic_machine=c90-cray os=-unicos ;; - cegcc) - basic_machine=arm-unknown - os=-cegcc - ;; convex-c1) basic_machine=c1-convex os=-bsd @@ -561,7 +491,7 @@ case $basic_machine in basic_machine=craynv-cray os=-unicosmp ;; - cr16 | cr16-*) + cr16) basic_machine=cr16-unknown os=-elf ;; @@ -600,10 +530,6 @@ case $basic_machine in basic_machine=m88k-motorola os=-sysv3 ;; - dicos) - basic_machine=i686-pc - os=-dicos - ;; djgpp) basic_machine=i586-pc os=-msdosdjgpp @@ -777,9 +703,6 @@ case $basic_machine in basic_machine=ns32k-utek os=-sysv ;; - microblaze) - basic_machine=microblaze-xilinx - ;; mingw32) basic_machine=i386-pc os=-mingw32 @@ -816,18 +739,10 @@ case $basic_machine in ms1-*) basic_machine=`echo $basic_machine | sed -e 's/ms1-/mt-/'` ;; - msys) - basic_machine=i386-pc - os=-msys - ;; mvs) basic_machine=i370-ibm os=-mvs ;; - nacl) - basic_machine=le32-unknown - os=-nacl - ;; ncr3000) basic_machine=i486-ncr os=-sysv4 @@ -892,12 +807,6 @@ case $basic_machine in np1) basic_machine=np1-gould ;; - neo-tandem) - basic_machine=neo-tandem - ;; - nse-tandem) - basic_machine=nse-tandem - ;; nsr-tandem) basic_machine=nsr-tandem ;; @@ -980,10 +889,9 @@ case $basic_machine in ;; power) basic_machine=power-ibm ;; - ppc | ppcbe) basic_machine=powerpc-unknown + ppc) basic_machine=powerpc-unknown ;; - ppc-* | ppcbe-*) - basic_machine=powerpc-`echo $basic_machine | sed 's/^[^-]*-//'` + ppc-*) basic_machine=powerpc-`echo $basic_machine | sed 's/^[^-]*-//'` ;; ppcle | powerpclittle | ppc-le | powerpc-little) basic_machine=powerpcle-unknown @@ -1077,9 +985,6 @@ case $basic_machine in basic_machine=i860-stratus os=-sysv4 ;; - strongarm-* | thumb-*) - basic_machine=arm-`echo $basic_machine | sed 's/^[^-]*-//'` - ;; sun2) basic_machine=m68000-sun ;; @@ -1136,8 +1041,20 @@ case $basic_machine in basic_machine=t90-cray os=-unicos ;; + tic54x | c54x*) + basic_machine=tic54x-unknown + os=-coff + ;; + tic55x | c55x*) + basic_machine=tic55x-unknown + os=-coff + ;; + tic6x | c6x*) + basic_machine=tic6x-unknown + os=-coff + ;; tile*) - basic_machine=$basic_machine-unknown + basic_machine=tile-unknown os=-linux-gnu ;; tx39) @@ -1207,9 +1124,6 @@ case $basic_machine in xps | xps100) basic_machine=xps100-honeywell ;; - xscale-* | xscalee[bl]-*) - basic_machine=`echo $basic_machine | sed 's/^xscale/arm/'` - ;; ymp) basic_machine=ymp-cray os=-unicos @@ -1218,10 +1132,6 @@ case $basic_machine in basic_machine=z8k-unknown os=-sim ;; - z80-*-coff) - basic_machine=z80-unknown - os=-sim - ;; none) basic_machine=none-none os=-none @@ -1260,7 +1170,7 @@ case $basic_machine in we32k) basic_machine=we32k-att ;; - sh[1234] | sh[24]a | sh[24]aeb | sh[34]eb | sh[1234]le | sh[23]ele) + sh[1234] | sh[24]a | sh[34]eb | sh[1234]le | sh[23]ele) basic_machine=sh-unknown ;; sparc | sparcv8 | sparcv9 | sparcv9b | sparcv9v) @@ -1307,12 +1217,9 @@ esac if [ x"$os" != x"" ] then case $os in - # First match some system type aliases - # that might get confused with valid system types. + # First match some system type aliases + # that might get confused with valid system types. # -solaris* is a basic system type, with this one exception. - -auroraux) - os=-auroraux - ;; -solaris1 | -solaris1.*) os=`echo $os | sed -e 's|solaris1|sunos4|'` ;; @@ -1333,11 +1240,10 @@ case $os in # Each alternative MUST END IN A *, to match a version number. # -sysv* is not here because it comes later, after sysvr4. -gnu* | -bsd* | -mach* | -minix* | -genix* | -ultrix* | -irix* \ - | -*vms* | -sco* | -esix* | -isc* | -aix* | -cnk* | -sunos | -sunos[34]*\ - | -hpux* | -unos* | -osf* | -luna* | -dgux* | -auroraux* | -solaris* \ - | -sym* | -kopensolaris* \ + | -*vms* | -sco* | -esix* | -isc* | -aix* | -sunos | -sunos[34]*\ + | -hpux* | -unos* | -osf* | -luna* | -dgux* | -solaris* | -sym* \ | -amigaos* | -amigados* | -msdos* | -newsos* | -unicos* | -aof* \ - | -aos* | -aros* \ + | -aos* \ | -nindy* | -vxsim* | -vxworks* | -ebmon* | -hms* | -mvs* \ | -clix* | -riscos* | -uniplus* | -iris* | -rtu* | -xenix* \ | -hiux* | -386bsd* | -knetbsd* | -mirbsd* | -netbsd* \ @@ -1346,10 +1252,9 @@ case $os in | -bosx* | -nextstep* | -cxux* | -aout* | -elf* | -oabi* \ | -ptx* | -coff* | -ecoff* | -winnt* | -domain* | -vsta* \ | -udi* | -eabi* | -lites* | -ieee* | -go32* | -aux* \ - | -chorusos* | -chorusrdb* | -cegcc* \ - | -cygwin* | -msys* | -pe* | -psos* | -moss* | -proelf* | -rtems* \ - | -mingw32* | -linux-gnu* | -linux-android* \ - | -linux-newlib* | -linux-uclibc* \ + | -chorusos* | -chorusrdb* \ + | -cygwin* | -pe* | -psos* | -moss* | -proelf* | -rtems* \ + | -mingw32* | -linux-gnu* | -linux-newlib* | -linux-uclibc* \ | -uxpv* | -beos* | -mpeix* | -udk* \ | -interix* | -uwin* | -mks* | -rhapsody* | -darwin* | -opened* \ | -openstep* | -oskit* | -conix* | -pw32* | -nonstopux* \ @@ -1357,7 +1262,7 @@ case $os in | -os2* | -vos* | -palmos* | -uclinux* | -nucleus* \ | -morphos* | -superux* | -rtmk* | -rtmk-nova* | -windiss* \ | -powermax* | -dnix* | -nx6 | -nx7 | -sei* | -dragonfly* \ - | -skyos* | -haiku* | -rdos* | -toppers* | -drops* | -es*) + | -skyos* | -haiku* | -rdos* | -toppers* | -drops*) # Remember, each alternative MUST END IN *, to match a version number. ;; -qnx*) @@ -1396,7 +1301,7 @@ case $os in -opened*) os=-openedition ;; - -os400*) + -os400*) os=-os400 ;; -wince*) @@ -1445,7 +1350,7 @@ case $os in -sinix*) os=-sysv4 ;; - -tpf*) + -tpf*) os=-tpf ;; -triton*) @@ -1487,11 +1392,6 @@ case $os in -zvmoe) os=-zvmoe ;; - -dicos*) - os=-dicos - ;; - -nacl*) - ;; -none) ;; *) @@ -1514,10 +1414,10 @@ else # system, and we'll never get to this point.
case $basic_machine in - score-*) + score-*) os=-elf ;; - spu-*) + spu-*) os=-elf ;; *-acorn) @@ -1529,17 +1429,8 @@ case $basic_machine in arm*-semi) os=-aout ;; - c4x-* | tic4x-*) - os=-coff - ;; - tic54x-*) - os=-coff - ;; - tic55x-*) - os=-coff - ;; - tic6x-*) - os=-coff + c4x-* | tic4x-*) + os=-coff ;; # This must come before the *-dec entry. pdp10-*) @@ -1566,7 +1457,7 @@ case $basic_machine in m68*-cisco) os=-aout ;; - mep-*) + mep-*) os=-elf ;; mips*-cisco) @@ -1593,7 +1484,7 @@ case $basic_machine in *-ibm) os=-aix ;; - *-knuth) + *-knuth) os=-mmixware ;; *-wec) @@ -1698,7 +1589,7 @@ case $basic_machine in -sunos*) vendor=sun ;; - -cnk*|-aix*) + -aix*) vendor=ibm ;; -beos*) diff --git a/external/privoxy/configure.in b/external/privoxy/configure.in index 1f2dcae..6c6ce39 100644 --- a/external/privoxy/configure.in +++ b/external/privoxy/configure.in @@ -1,38 +1,572 @@ dnl Process this file with autoconf to produce a configure script. -dnl -dnl $Id: configure.in,v 1.166 2011/12/26 17:03:31 fabiankeil Exp $ -dnl -dnl Written by and Copyright (C) 2001-2010 the +dnl +dnl $Id: configure.in,v 1.126 2009/03/21 10:45:06 fabiankeil Exp $ +dnl +dnl Written by and Copyright (C) 2001-2009 the dnl Privoxy team. http://www.privoxy.org/ dnl dnl Based on the Internet Junkbuster originally written -dnl by and Copyright (C) 1997 Anonymous Coders and +dnl by and Copyright (C) 1997 Anonymous Coders and dnl Junkbusters Corporation. http://www.junkbusters.com dnl -dnl This program is free software; you can redistribute it +dnl This program is free software; you can redistribute it dnl and/or modify it under the terms of the GNU General dnl Public License as published by the Free Software dnl Foundation; either version 2 of the License, or (at dnl your option) any later version. -dnl +dnl dnl This program is distributed in the hope that it will dnl be useful, but WITHOUT ANY WARRANTY; without even the dnl implied warranty of MERCHANTABILITY or FITNESS FOR A dnl PARTICULAR PURPOSE. See the GNU General Public dnl License for more details. -dnl +dnl dnl The GNU General Public License should be included with dnl this file. If not, you can view it at dnl http://www.gnu.org/copyleft/gpl.html dnl or write to the Free Software Foundation, Inc., 59 dnl Temple Place - Suite 330, Boston, MA 02111-1307, USA. +dnl +dnl $Log: configure.in,v $ +dnl Revision 1.126 2009/03/21 10:45:06 fabiankeil +dnl Declare the code stable. +dnl +dnl Revision 1.125 2009/02/25 16:58:03 fabiankeil +dnl And the journey continues. Bump version to 3.0.12 UNRELEASED. +dnl +dnl Revision 1.124 2009/02/12 15:42:00 fabiankeil +dnl Declare the code stable. +dnl +dnl Revision 1.123 2009/02/06 18:17:32 fabiankeil +dnl Boldly enable keep-alive support where possible. +dnl +dnl Revision 1.122 2008/10/18 11:17:52 fabiankeil +dnl Connection keep-alive support is ready for testing, +dnl allow enabling it through the configure script. +dnl +dnl Revision 1.121 2008/08/30 12:03:07 fabiankeil +dnl Remove FEATURE_COOKIE_JAR. +dnl +dnl Revision 1.120 2008/08/21 17:19:50 fabiankeil +dnl Change version to 3.0.11 UNRELEASED. +dnl +dnl Revision 1.119 2008/08/13 16:53:50 fabiankeil +dnl Change version to 3.0.10 stable. +dnl +dnl Revision 1.118 2008/06/27 12:50:44 fabiankeil +dnl Here's looking at you, Gentoo Linux: Show a warning if +dnl --disable-pthread is used even though pthreads are available. +dnl +dnl Revision 1.117 2008/06/14 12:47:30 fabiankeil +dnl Set CODE_STATUS to beta. +dnl +dnl Revision 1.116 2008/06/08 11:55:09 fabiankeil +dnl - Show a warning if the soon-to-be-removed static PCRE code is used. +dnl - Hide the "using built-in static pcrs" message. With dynamic linking +dnl against PCRS disabled, the message isn't particularly useful. +dnl +dnl Revision 1.115 2008/05/25 15:50:14 fabiankeil +dnl Try to use zlib by default, but just show a warning if it's +dnl unavailable. Remove --enable-zlib, add --disable-zlib. +dnl +dnl Revision 1.114 2008/04/06 15:18:33 fabiankeil +dnl Oh well, rename the --enable-pcre-host-patterns option to +dnl --enable-extended-host-patterns as it's not really PCRE syntax. +dnl +dnl Revision 1.113 2008/04/06 14:54:26 fabiankeil +dnl Use PCRE syntax in host patterns when configured +dnl with --enable-pcre-host-patterns. +dnl +dnl Revision 1.112 2008/03/27 18:27:22 fabiankeil +dnl Remove kill-popups action. +dnl +dnl Revision 1.111 2008/02/03 14:40:47 fabiankeil +dnl Remove unused OSX_DARWIN macro. Reported by Mark Miller in #1852529. +dnl +dnl Revision 1.110 2008/01/26 10:52:13 fabiankeil +dnl Change version to 3.0.9 UNRELEASED. +dnl +dnl Revision 1.109 2008/01/20 14:07:09 fabiankeil +dnl Set CODE_STATUS to stable. +dnl +dnl Revision 1.108 2007/12/10 02:30:00 hal9 +dnl Change versioning for > 3.0.7 && < 3.0.8 +dnl +dnl Revision 1.107 2007/11/15 02:50:14 hal9 +dnl Setting to "beta" (for doc builds, etc). +dnl +dnl Revision 1.106 2007/05/11 11:49:41 fabiankeil +dnl Check for strlcat(). +dnl +dnl Revision 1.105 2007/04/09 17:34:58 fabiankeil +dnl Check for snprintf(). +dnl +dnl Revision 1.104 2007/03/31 13:35:11 fabiankeil +dnl Add checks for gettimeofday() and strlcpy(). +dnl +dnl Revision 1.103 2007/01/20 16:29:38 fabiankeil +dnl Suppress edit buttons for action files if Privoxy has +dnl no write access. Suggested by Roland in PR 1564026. +dnl +dnl Revision 1.102 2007/01/18 14:55:45 fabiankeil +dnl Check for tzset() and putenv() to make sure the +dnl replacement timegm() isn't included on systems +dnl where it fails to compile. +dnl +dnl Revision 1.101 2007/01/12 15:20:17 fabiankeil +dnl Temporarily ignore external libpcrs to prevent +dnl problems that are fixed in Privoxy's own version. +dnl +dnl Revision 1.100 2007/01/07 07:38:10 joergs +dnl Disabled -pipe for AmigaOS4. +dnl +dnl Revision 1.99 2007/01/01 19:36:37 fabiankeil +dnl Integrate a modified version of Wil Mahan's +dnl zlib patch (PR #895531). +dnl +dnl Revision 1.98 2006/12/17 19:15:26 fabiankeil +dnl Added ./configure switch for FEATURE_GRACEFUL_TERMINATION. +dnl +dnl Revision 1.97 2006/11/21 18:32:46 hal9 +dnl Setting version to 3.0.7 UNRELEASED for lack of a better setting. +dnl +dnl Revision 1.96 2006/11/18 14:42:51 fabiankeil +dnl Mark as stable. +dnl +dnl Revision 1.95 2006/11/14 02:08:59 hal9 +dnl Setting version string to 3.0.6 UNRELEASED. This needs to be reset to 3.0.6 +dnl stable just before CVS is tagged for release. +dnl +dnl Revision 1.94 2006/11/13 19:05:50 fabiankeil +dnl Make pthread mutex locking more generic. Instead of +dnl checking for OSX and OpenBSD, check for FEATURE_PTHREAD +dnl and use mutex locking unless there is an _r function +dnl available. Better safe than sorry. +dnl +dnl Fixes "./configure --disable-pthread" and should result +dnl in less threading-related problems on pthread-using platforms, +dnl but it still doesn't fix BR#1122404. +dnl +dnl Revision 1.93 2006/09/22 01:26:20 hal9 +dnl Set version to 3.0.5 BETA for hopefully release this weekend. +dnl +dnl Revision 1.92 2006/08/17 17:09:49 fabiankeil +dnl Added check for timegm(). +dnl +dnl Revision 1.91 2006/08/13 22:01:51 fabiankeil +dnl Added checks for strptime() and random() +dnl +dnl Revision 1.90 2006/07/18 14:48:45 david__schmidt +dnl Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +dnl with what was really the latest development (the v_3_0_branch branch) +dnl +dnl Revision 1.68.2.20 2004/01/31 16:31:46 oes +dnl Resetting version info to 0.0.0 UNRELEASED +dnl +dnl Revision 1.68.2.19 2004/01/30 09:26:03 oes +dnl Added docbook paths for debian sarge; set status for release +dnl +dnl Revision 1.68.2.18 2003/12/08 15:10:29 oes +dnl Bugfix: --with-docbook now correctly accepts its path parameter. Thanks, Roland! +dnl +dnl Revision 1.68.2.17 2003/10/18 18:41:26 david__schmidt +dnl Update to remain buildable on OS/2 - remove the failures +dnl due to missing unixisms +dnl +dnl Revision 1.68.2.16 2003/03/26 16:05:14 oes +dnl Marked as 0.0.0 UNRELEASED +dnl +dnl Revision 1.68.2.15 2003/03/26 00:25:00 oes +dnl Bump version for 3.0.2 +dnl +dnl Revision 1.68.2.14 2003/03/25 13:27:12 hal9 +dnl Manually apply Docbook/FreeBSD patch #708081 from a.go at tiscali.nl. +dnl +dnl Revision 1.68.2.13 2003/03/18 19:38:57 oes +dnl Set version info for 3.0.1 release +dnl +dnl Revision 1.68.2.12 2003/03/07 03:41:04 david__schmidt +dnl Wrapping all *_r functions (the non-_r versions of them) with mutex semaphores for OSX. Hopefully this will take care of all of those pesky crash reports. +dnl +dnl Revision 1.68.2.11 2003/03/06 15:22:37 oes +dnl Fixed minor shell syntax bug +dnl +dnl Revision 1.68.2.10 2003/01/08 16:39:41 oes +dnl Changing default to exclude FEATURE_IMAGE_DETECT_MSIE because of problem reports with recent IEs +dnl +dnl Revision 1.68.2.9 2002/12/13 23:47:45 hal9 +dnl Add openbsd $specialflags per gunner at styx2002.no-ip.org +dnl +dnl Revision 1.68.2.8 2002/11/27 12:55:26 oes +dnl Fixed broken handling of pre-set CFLAGS +dnl +dnl Revision 1.68.2.7 2002/10/25 02:44:22 hal9 +dnl Port of make install, etc from main trunk. Needs testing! Add Slackware +dnl support, and other related changes. Update related docs. +dnl +dnl Revision 1.68.2.6 2002/09/25 15:35:15 oes +dnl Marking as non-release +dnl +dnl Revision 1.68.2.5 2002/08/25 23:37:00 hal9 +dnl Getting ready for 3.0 release. +dnl +dnl Revision 1.68.2.4 2002/08/10 11:21:57 oes +dnl - Set Version to 2.9.20 (beta) +dnl - Add two AC_DEFINEs that indicate if the pcre*.h headers +dnl are located in a pcre/ subdir to the include path. +dnl +dnl Revision 1.68.2.3 2002/08/06 11:29:36 oes +dnl Fixed detection/inclusion of pcre.h, which is in a pcre subdir on RH +dnl +dnl Revision 1.68.2.2 2002/07/30 19:36:09 hal9 +dnl Bump version to 2.9.17. +dnl +dnl Revision 1.68.2.1 2002/07/26 15:21:12 oes +dnl Bumped version number for 2.9.16 freeze +dnl +dnl Revision 1.68 2002/05/25 16:54:54 jongfoster +dnl Detect if the compiler supports -pthread. +dnl Hopefully this will fix bug 560442. (I don't have a HP PA-RISC +dnl machine to test this!) +dnl +dnl Revision 1.67 2002/05/03 14:33:59 oes +dnl Generate doc/soucre/ldp.dsl +dnl +dnl Revision 1.66 2002/05/03 00:41:56 oes +dnl Set version to 2.9.15 to comply with new versioning scheme +dnl +dnl Revision 1.65 2002/04/25 19:13:57 morcego +dnl Removed RPM release number declaration on configure.in +dnl Changed makefile to use given value for RPM_PACKAGEV when on uploading +dnl targets (will produce an error, explaining who to do it, if no value +dnl if provided). +dnl +dnl Revision 1.64 2002/04/22 16:32:31 morcego +dnl configure.in, *.spec: Bumping release to 2 (2.9.14-2) +dnl -rh.spec: uid and gid are now macros +dnl -suse.spec: Changing the header Copyright to License (Copyright is +dnl deprecable) +dnl +dnl Revision 1.63 2002/04/11 11:00:21 oes +dnl Applied Moritz' fix for socklen_t on Solaris +dnl +dnl Revision 1.62 2002/04/11 10:09:20 oes +dnl Version 2.9.14 +dnl +dnl Revision 1.61 2002/04/10 18:14:45 morcego +dnl - (privoxy-rh.spec only) Relisting template files on the %%files section +dnl - (configure.in, privoxy-rh.spec) Bumped package release to 5 +dnl +dnl Revision 1.60 2002/04/09 16:38:49 oes +dnl Added detection of missing config.h.in +dnl +dnl Revision 1.59 2002/04/06 20:23:55 jongfoster +dnl Removing unnessacery tests (C++, ranlib) +dnl +dnl Revision 1.58 2002/04/04 20:49:20 swa +dnl attempt to consolidate the +dnl different dokbook versions. +dnl +dnl Revision 1.57 2002/04/04 00:36:36 gliptak +dnl always use pcre for matching +dnl +dnl Revision 1.56 2002/04/03 22:28:03 gliptak +dnl Removed references to gnu_regex +dnl +dnl Revision 1.55 2002/04/03 03:54:38 gliptak +dnl Checking pcre version +dnl +dnl Revision 1.54 2002/04/01 00:54:24 gliptak +dnl More changes needed around regex support. +dnl +dnl Revision 1.53 2002/03/29 20:09:01 swa +dnl al's patch +dnl +dnl Revision 1.52 2002/03/29 19:51:40 gliptak +dnl Correcting compile problem with Debian +dnl +dnl Revision 1.51 2002/03/28 20:43:00 swa +dnl set make correctly +dnl +dnl Revision 1.50 2002/03/27 03:03:45 hal9 +dnl Add test for man2html +dnl +dnl Revision 1.49 2002/03/27 02:19:52 david__schmidt +dnl More Mac OSX support: +dnl - Get rid of extraneous, noisy -pthread warnings +dnl - Define unix so we get oes' unix-tagged changes +dnl +dnl Revision 1.48 2002/03/26 22:29:54 swa +dnl we have a new homepage! +dnl +dnl Revision 1.47 2002/03/26 16:41:00 hal9 +dnl Upped RPM Release to 3 (need to build new RH packages) +dnl +dnl Revision 1.46 2002/03/24 18:55:06 jongfoster +dnl Making Docbook work under Windows +dnl +dnl Revision 1.45 2002/03/24 14:19:55 swa +dnl set rpm package release in configure.in. nowhere else. +dnl +dnl Revision 1.44 2002/03/24 13:25:43 swa +dnl name change related issues +dnl +dnl Revision 1.43 2002/03/24 12:56:21 swa +dnl name change related issues. +dnl +dnl Revision 1.42 2002/03/22 18:11:37 jongfoster +dnl Bumping version number to 2.9.12 +dnl +dnl Revision 1.41 2002/03/19 19:30:04 morcego +dnl - Fixing stylesheet checking on configure. If it is found, no further checks +dnl should be done dnl +dnl - configure will now check for db2html or docbook2html (should work now +dnl on SuSe without the docbktls package) +dnl +dnl Revision 1.40 2002/03/09 14:33:30 oes +dnl Fixing the (harmless) AC_CHECK_FILE warnings +dnl +dnl Revision 1.39 2002/03/08 16:46:13 oes +dnl Added --enable-no-gifs +dnl +dnl Revision 1.38 2002/03/08 14:13:50 morcego +dnl Fixing configure, to remove a command not found error. +dnl +dnl Revision 1.37 2002/03/08 12:58:21 oes +dnl Tiny bugfix in AC_ARG_WITH(debug) +dnl +dnl Revision 1.36 2002/03/06 23:50:36 morcego +dnl Will not test for a text browser if we are not using docbook. +dnl +dnl Revision 1.35 2002/03/06 21:55:52 morcego +dnl New configure option: --with-docbook=(yes|no|directory) +dnl Preliminary new platform detection code included. Will work with the +dnl old one for now. No use just trowing it away +dnl +dnl Revision 1.34 2002/03/06 20:57:00 morcego +dnl Fixing detection of stylesheets on SuSe. +dnl +dnl Revision 1.33 2002/03/05 17:31:11 morcego +dnl Search for docbook.dsl. Should solve portability problems for SuSe. +dnl +dnl Revision 1.32 2002/03/05 14:07:43 morcego +dnl configure now detects rpm topdir, and change GNUmakefile acordingly +dnl (based on sugestion by Sarantis Paskalis) +dnl +dnl Revision 1.31 2002/03/05 13:43:28 morcego +dnl Checking for text browser, so redhat-dok can work. +dnl +dnl Revision 1.30 2002/03/04 17:58:01 oes +dnl Deleted _DEBUG and PID_FILE_PATH +dnl +dnl Revision 1.29 2002/02/28 14:20:53 oes +dnl Fixed detection of gethost*_r functions on Solaris +dnl +dnl Revision 1.28 2002/02/27 15:02:38 oes +dnl Incremented version number +dnl +dnl Revision 1.27 2002/01/10 12:35:18 oes +dnl Added cross-compile defaults to the AC_CHECK_SIZEOF macros +dnl to silence autoconf warnings. Numbers are for Intel/Linux. +dnl Is there a better way? +dnl +dnl Revision 1.26 2002/01/09 14:29:49 oes +dnl - Added AC_CHECK_FUNC tests for the availability of +dnl gethostbyname_r, gethostbyaddr_r, gmtime_r and +dnl localtime_r, as well as AC_TRY_COMPILE tests to +dnl determine their signatures. +dnl +dnl - Fixed a bug with the init of CFLAGS that was +dnl reported by barsnick +dnl +dnl Revision 1.25 2002/01/04 15:27:18 oes +dnl Changed quoting of CODE_STATUS for use in make +dnl +dnl Revision 1.24 2001/12/30 14:07:31 steudten +dnl - Add signal handling (unix) +dnl - Add SIGHUP handler (unix) +dnl - Add creation of pidfile (unix) +dnl - Add action 'top' in rc file (RH) +dnl - Add entry 'SIGNALS' to manpage +dnl - Add exit message to logfile (unix) +dnl +dnl Revision 1.23 2001/12/09 20:24:42 david__schmidt +dnl Change from "alpha" to "beta" in configure.in +dnl +dnl Revision 1.22 2001/12/01 11:24:01 jongfoster +dnl Renaming Makefile.in to GNUmakefile.in so that non-GNU versions of +dnl make break in a more obvious way. +dnl +dnl Revision 1.21 2001/11/30 21:35:54 jongfoster +dnl Bumping version number to 2.9.10 +dnl +dnl Revision 1.20 2001/10/23 21:24:09 jongfoster +dnl Support for FEATURE_CGI_EDIT_ACTIONS +dnl +dnl Revision 1.19 2001/10/07 15:33:14 oes +dnl Removed FEATURE_DENY_GZIP +dnl Bumped up version number +dnl +dnl Revision 1.18 2001/09/13 13:10:24 steudten +dnl +dnl PreWork for Debug Interface. +dnl Add new option "--with-debug" to enable debugging (flags aso.) +dnl +dnl Revision 1.17 2001/09/12 23:44:55 david__schmidt +dnl Mac OSX (Darwin) support added. +dnl +dnl Revision 1.16 2001/09/12 22:55:45 joergs +dnl AmigaOS support added. +dnl +dnl Revision 1.15 2001/09/12 17:28:59 david__schmidt +dnl +dnl OS/2 port: update autoconf'd support for the platform. +dnl +dnl Revision 1.14 2001/07/30 22:12:11 jongfoster +dnl Fixing Solaris build (I hope) and tidying up #defines: +dnl - All feature #defines are now of the form FEATURE_xxx +dnl - Permanently turned off WIN_GUI_EDIT +dnl - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS +dnl +dnl Revision 1.13 2001/07/29 17:09:17 jongfoster +dnl Major changes to build system in order to fix these bugs: +dnl - pthreads under Linux was broken - changed -lpthread to -pthread +dnl - Compiling in MinGW32 mode under CygWin now correctly detects +dnl which shared libraries are available +dnl - Solaris support (?) (Not tested under Solaris yet) +dnl +dnl Revision 1.12 2001/07/25 19:16:27 oes +dnl Bumping version number to 2.9.8 +dnl +dnl Revision 1.11 2001/07/21 18:00:07 jongfoster +dnl Bumping version number to 2.9.7 +dnl +dnl Revision 1.10 2001/07/18 17:25:04 oes +dnl Fixed a typo +dnl +dnl Revision 1.9 2001/07/15 19:45:13 jongfoster +dnl Added support for linking with POSIX threads library +dnl +dnl Revision 1.8 2001/07/15 17:54:29 jongfoster +dnl Renaming #define STATIC to STATIC_PCRE +dnl Adding new #define FEATURE_PTHREAD that will be used to enable +dnl POSIX threads support. +dnl +dnl Revision 1.7 2001/07/13 13:58:05 oes +dnl Completely reorganized the selection scheme for +dnl pcre, pcreposix, pcrs and gnu_regex: +dnl +dnl The presence of shared pcre, pcreposix or pcrs +dnl libraried is now autodetected. Additionally, the +dnl user can enforce using the built-in static variants +dnl by specifying --disable-dynamic-(pcre|pcrs). +dnl Care is taken to avoid that pcre is dyn, while pcreposix +dnl is static, if both are used and that pcrs is static if +dnl pcrs is. +dnl +dnl The choice between pcre, gnu or no regex for actionsfile +dnl URL matching is now via +dnl --(enable|disable)-regex-matching[=(gnu|pcre|no)] with the +dnl default being pcre. +dnl +dnl Revision 1.6 2001/06/29 21:56:40 oes +dnl Version -> 2.9.5 +dnl +dnl Revision 1.5 2001/06/29 13:26:27 oes +dnl Introduced #define CODE_STATUS +dnl +dnl Revision 1.4 2001/05/29 09:50:24 jongfoster +dnl Unified blocklist/imagelist/permissionslist. +dnl File format is still under discussion, but the internal changes +dnl are (mostly) done. +dnl +dnl Also modified interceptor behaviour: +dnl - We now intercept all URLs beginning with one of the following +dnl prefixes (and *only* these prefixes): +dnl * http://i.j.b/ +dnl * http://ijbswa.sf.net/config/ +dnl * http://ijbswa.sourceforge.net/config/ +dnl - New interceptors "home page" - go to http://i.j.b/ to see it. +dnl - Internal changes so that intercepted and fast redirect pages +dnl are not replaced with an image. +dnl - Interceptors now have the option to send a binary page direct +dnl to the client. (i.e. ijb-send-banner uses this) +dnl - Implemented show-url-info interceptor. (Which is why I needed +dnl the above interceptors changes - a typical URL is +dnl "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". +dnl The previous mechanism would not have intercepted that, and +dnl if it had been intercepted then it then it would have replaced +dnl it with an image.) +dnl +dnl Revision 1.3 2001/05/22 18:46:04 oes +dnl +dnl - Enabled filtering banners by size rather than URL +dnl by adding patterns that replace all standard banner +dnl sizes with the "Junkbuster" gif to the re_filterfile +dnl +dnl - Enabled filtering WebBugs by providing a pattern +dnl which kills all 1x1 images +dnl +dnl - Added support for PCRE_UNGREEDY behaviour to pcrs, +dnl which is selected by the (nonstandard and therefore +dnl capital) letter 'U' in the option string. +dnl It causes the quantifiers to be ungreedy by default. +dnl Appending a ? turns back to greedy (!). +dnl +dnl - Added a new interceptor ijb-send-banner, which +dnl sends back the "Junkbuster" gif. Without imagelist or +dnl MSIE detection support, or if tinygif = 1, or the +dnl URL isn't recognized as an imageurl, a lame HTML +dnl explanation is sent instead. +dnl +dnl - Added new feature, which permits blocking remote +dnl script redirects and firing back a local redirect +dnl to the browser. +dnl The feature is conditionally compiled, i.e. it +dnl can be disabled with --disable-fast-redirects, +dnl plus it must be activated by a "fast-redirects" +dnl line in the config file, has its own log level +dnl and of course wants to be displayed by show-proxy-args +dnl Note: Boy, all the #ifdefs in 1001 locations and +dnl all the fumbling with configure.in and acconfig.h +dnl were *way* more work than the feature itself :-( +dnl +dnl - Because a generic redirect template was needed for +dnl this, tinygif = 3 now uses the same. +dnl +dnl - Moved GIFs, and other static HTTP response templates +dnl to project.h +dnl +dnl - Some minor fixes +dnl +dnl - Removed some >400 CRs again (Jon, you really worked +dnl a lot! ;-) +dnl +dnl Revision 1.2 2001/05/20 01:21:20 jongfoster +dnl Version 2.9.4 checkin. +dnl - Merged popupfile and cookiefile, and added control over PCRS +dnl filtering, in new "permissionsfile". +dnl - Implemented LOG_LEVEL_FATAL, so that if there is a configuration +dnl file error you now get a message box (in the Win32 GUI) rather +dnl than the program exiting with no explanation. +dnl - Made killpopup use the PCRS MIME-type checking and HTTP-header +dnl skipping. +dnl - Removed tabs from "config" +dnl - Moved duplicated url parsing code in "loaders.c" to a new funcition. +dnl - Bumped up version number. +dnl +dnl Revision 1.1.1.1 2001/05/15 13:58:50 oes +dnl Initial import of version 2.9.3 source tree +dnl +dnl +
dnl ================================================================= dnl AutoConf Initialization dnl =================================================================
-AC_REVISION($Revision: 1.166 $) +AC_REVISION($Revision: 1.126 $) AC_INIT(jcc.c)
if test ! -f config.h.in; then @@ -44,7 +578,7 @@ if test ! -f config.h.in; then else autoheader fi -fi +fi
AC_CONFIG_HEADER([config.h]) AC_CANONICAL_HOST @@ -52,13 +586,13 @@ AC_CANONICAL_HOST dodk=auto DKPREFIX=none AC_ARG_WITH(docbook, dnl - --with-docbook=[[yes|no|directory]] - Enable docbook documentation creation + --with-docbook=[[yes|no|directory]] + Enable docbook documentation creation (default = yes, for gnu and linux),[dnl case "$with_docbook" in yes) dodk=yes;; no) dodk=no;; -*) +*) dodk=yes DKPREFIX=$withval ;; @@ -78,13 +612,12 @@ dnl =================================================================
VERSION_MAJOR=3 VERSION_MINOR=0 -VERSION_POINT=19 +VERSION_POINT=12 CODE_STATUS="stable"
-dnl CODE_STATUS can be "alpha", "beta", "stable" or "UNRELEASED", -dnl and will be used for CGI output. Increment version number and -dnl set status to "UNRELEASED" whenever CVS differs from the last -dnl release and no new release is near. +dnl CODE_STATUS can be "alpha", "beta", or "stable", and will be +dnl used for CGI output. Set version to 0.0.0 and status to "UNRELEASED" +dnl whenever CVS in a stable branch differs from the last release.
dnl ================================================================= dnl Substitute the version numbers @@ -119,13 +652,13 @@ AC_PROG_MAKE_SET AC_PROG_AWK
AC_CHECK_PROG(GDB,gdb,yes,no) -AC_PATH_PROG(BGROUPS,groups,no,$PATH:/bin:/usr/bin:/usr/local/bin) -AC_PATH_PROG(ID,id,no,$PATH:/bin:/usr/bin:/usr/local/bin) +AC_PATH_PROG(BGROUPS,groups,no,/bin:/usr/bin:/usr/local/bin) +AC_PATH_PROG(ID,id,no,/bin:/usr/bin:/usr/local/bin) AC_SUBST(ID) AC_SUBST(BGROUPS)
dnl ================================================================= -dnl debug, gcc and gdb support +dnl debug, gcc and gdb support dnl =================================================================
AC_ARG_WITH(debug, @@ -203,7 +736,7 @@ else AC_MSG_CHECKING([for group]) AC_ARG_WITH(group, [ --with-group=privoxy Set group for privoxy], - [ + [ if test "x$withval" != "xyes"; then if test $BGROUPS = no ; then AC_MSG_ERROR(There is no 'groups' program on this system) @@ -242,7 +775,7 @@ fi dnl ================================================================= dnl additional gcc flags dnl ================================================================= -dnl +dnl if test "$GCC"; then if test "$host" != "powerpc-unknown-amigaos"; then CFLAGS="-pipe $CFLAGS" @@ -260,7 +793,7 @@ dnl Reason: This sets CFLAGS in order to switch the Cygwin compiler dnl into Cygwin or MinGW32 modes. Depending on the mode selected, dnl the compiler will use completely different sets of library dnl and include files. -dnl +dnl dnl =================================================================
AC_MINGW32 @@ -299,7 +832,6 @@ fi])
if test $target_type = mingw; then WIN_ONLY= - CFLAGS="$CFLAGS -DWINVER=0x501" SPECIAL_CFLAGS="-mwindows -mno-cygwin" PTHREAD_LIB=-lpthreadGC echo "Using mingw32 (Win32 GUI)" @@ -316,7 +848,7 @@ else fi AC_SUBST(WIN_ONLY)
-dnl Checking which text html browser we have available +dnl Checking which text html browser we have avaliable if test $dodk != no; then AC_CHECK_PROGS(WDUMP,w3m lynx links,false) if test "$WDUMP" = false; then @@ -324,7 +856,7 @@ if test $dodk != no; then fi if test $DB2HTML = false; then dnl We need to clean the variable, otherwise AC_CHECK_PROGS - dnl will fail + dnl will fail DB2HTML="" AC_CHECK_PROGS(DB2HTML,db2html docbook2html,false) fi @@ -400,13 +932,6 @@ fi AC_SUBST(JADECAT) AC_SUBST(DKPREFIX)
-AC_ARG_ENABLE(large-file-support, -[ --enable-large-file-support Define _LARGE_FILES and friends. - Required by some systems to support files larger then 2GB.], -[if test $enableval = yes; then - CFLAGS="$CFLAGS -D_FILE_OFFSET_BITS=64 -D_LARGE_FILES -D_LARGEFILE_SOURCE=1" -fi]) - dnl Save old CFLAGS so we can restore them later, then add SPECIAL_CFLAGS old_CFLAGS_nospecial=$CFLAGS CFLAGS="$CFLAGS $SPECIAL_CFLAGS" @@ -430,7 +955,7 @@ AC_ARG_ENABLE(pthread, [if test $enableval = no; then # Disable pthreads if test $have_pthread = yes; then - AC_MSG_WARN([pthreads seem to be available but you are using --disable-pthread.]) + AC_MSG_WARN([pthreads seem to be available but you are using --disable-pthread.]) AC_MSG_WARN([This is almost always a mistake and can render Privoxy unacceptable slow.]) fi have_pthread=no @@ -648,10 +1173,10 @@ AC_SUBST(SOCKET_LIB) dnl ================================================================= dnl Mac OSX specific dnl ================================================================= - + case "$host" in *-apple-darwin*) SPECIAL_CFLAGS="-Dunix" -;; +;; esac
dnl ================================================================= @@ -701,63 +1226,19 @@ dnl AC_CHECK_HEADERS(fcntl.h limits.h malloc.h sys/time.h unistd.h) AC_CHECK_HEADERS([OS.h arpa/inet.h errno.h fcntl.h limits.h locale.h netdb.h netinet/in.h stddef.h stdlib.h string.h sys/ioctl.h sys/socket.h sys/time.h sys/timeb.h sys/wait.h unistd.h])
dnl Checks for library functions. -dnl bcopy is for PCRE -AC_CHECK_FUNCS([bcopy]) +dnl AC_TYPE_SIGNAL +dnl AC_CHECK_FUNC(strstr) +dnl bcopy and memmove are for PCRE +AC_CHECK_FUNCS([strerror bcopy memmove]) AC_PROG_GCC_TRADITIONAL +dnl uncommenting does not work for swa. suse linux +dnl AC_FUNC_MALLOC +AC_FUNC_SETPGRP AC_TYPE_SIGNAL +dnl uncommenting does not work for swa. suse linux +dnl AC_FUNC_STAT AC_CHECK_FUNCS([access atexit getcwd gethostbyaddr gethostbyaddr_r gethostbyname gethostbyname_r gettimeofday inet_ntoa localtime_r memchr memmove memset poll putenv random regcomp select setlocale snprintf socket strchr strdup strerror strftime strlcat strlcpy strptime strstr strtoul timegm tzset])
-dnl Checks for RFC 2553 resolver and socket functions -AC_ARG_ENABLE(ipv6-support, -[ --disable-ipv6-support Disable IPv6 support and other RFC-2554-related improvements], -[if test $enableval = yes; then - enable_ipv6_support=yes -fi], enable_ipv6_support=yes) - -if test $enable_ipv6_support != yes; then - AC_MSG_WARN([Skipping checks for IPv6 support and other RFC-2554-related improvements. - Due to lock contention, this may result in slower DNS resolution for IPv4 setups, too.]) -elif test $target_type = mingw; then - AC_CHECK_LIB(ws2_32, main) - - AC_MSG_CHECKING(getaddrinfo in ws2_32) - AC_TRY_LINK( - [ - #include<windows.h> - #include<ws2tcpip.h> - ], - [getaddrinfo(0,0,0,0)], - have_ws2_32_getaddrinfo=yes - ) - AC_MSG_RESULT($have_ws2_32_getaddrinfo) - - AC_MSG_CHECKING(getnameinfo in ws2_32) - AC_TRY_LINK( - [ - #include<windows.h> - #include<ws2tcpip.h> - ], - [getnameinfo(0,0,0,0,0,0,0)], - have_ws2_32_getnameinfo=yes - ) - AC_MSG_RESULT($have_ws2_32_getnameinfo) - - if test $have_ws2_32_getaddrinfo ; then - if test $have_ws2_32_getnameinfo ; then - AC_DEFINE([HAVE_RFC2553], [1], - [Define if RFC 2553 resolver functions like getaddrinfo(3) and - getnameinfo(3) present]) - fi - fi -else - AC_CHECK_FUNC([getaddrinfo], - [AC_CHECK_FUNC([getnameinfo], - [AC_DEFINE([HAVE_RFC2553], [1], - [Define if RFC 2553 resolver functions like getaddrinfo(3) and - getnameinfo(3) present]) - ]) - ]) -fi
dnl ================================================================= dnl Checks for libraries. @@ -774,7 +1255,7 @@ AC_CHECK_LIB(pcre, pcre_compile, [ ], [have_pcre=no]) ]) ], [have_pcre=no]) - + AC_CHECK_LIB(pcreposix, regcomp, [ AC_CHECK_HEADER(pcreposix.h, [ AC_EGREP_HEADER(pcreposix_regerror, pcreposix.h, [AC_MSG_WARN([[pcreposix old version installed]]); have_pcreposix=no], [have_pcreposix=yes]) @@ -783,7 +1264,7 @@ AC_CHECK_LIB(pcreposix, regcomp, [ AC_EGREP_HEADER(pcreposix_regerror, pcre/pcreposix.h, [AC_MSG_WARN([[pcreposix old version installed]]); have_pcreposix=no], [have_pcreposix=yes]; [AC_DEFINE(PCREPOSIX_H_IN_SUBDIR)]) ], [have_pcreposix=no]) ]) -], [have_pcreposix=no], -lpcre) +], [have_pcreposix=no], -lpcre)
dnl ================================================================ dnl libpcrs is temporarily disabled. @@ -838,15 +1319,15 @@ AC_ARG_ENABLE(ie-images, fi],)
AC_ARG_ENABLE(image-blocking, -[ --disable-image-blocking Don't try to figure out whether a request is +[ --disable-image-blocking Don't try to figure out whether a request is for an image or HTML - assume HTML.], [if test $enableval = yes; then AC_DEFINE(FEATURE_IMAGE_BLOCKING) fi], AC_DEFINE(FEATURE_IMAGE_BLOCKING))
-AC_ARG_ENABLE(acl-support, -[ --disable-acl-support Prevents the use of ACLs to control access to +AC_ARG_ENABLE(acl-files, +[ --disable-acl-files Prevents the use of ACL files to control access to Privoxy by IP address.], [if test $enableval = yes; then AC_DEFINE(FEATURE_ACL) @@ -882,23 +1363,11 @@ AC_ARG_ENABLE(graceful-termination, fi])
AC_ARG_ENABLE(extended-host-patterns, -[ --enable-extended-host-patterns Enable and require PCRE syntax in host patterns. This feature hasn't - been announced yet and it's not clear if it's a good idea. It's expected - to work, but undocumented. You should only enable it if you know what - PCRE is and are sure that you need it for your host patterns. You can - use tools/url-pattern-translator.pl to convert existing action files to - use PCRE host patterns. Please don't enable this option when creating - packages for others that may not be expecting it.], +[ --enable-extended-host-patterns Allow extended regular expressions in host patterns.], [if test $enableval = yes; then AC_DEFINE(FEATURE_EXTENDED_HOST_PATTERNS) fi])
-AC_ARG_ENABLE(accept-filter, -[ --enable-accept-filter Try to use accf_http(9) if supported.], -[if test $enableval = yes; then - AC_DEFINE(FEATURE_ACCEPT_FILTER) -fi]) - dnl pcre/pcrs is needed for CGI anyway, so dnl the choice is only between static and dnl dynamic: @@ -928,25 +1397,12 @@ if test $enableval2 = yes; then AC_CHECK_LIB(z, zlibVersion, [have_zlib="yes"], [have_zlib="no"]) if test $have_zlib = "yes"; then LIBS="$LIBS -lz" - AC_DEFINE(FEATURE_ZLIB,1,[Define to 1 to use zlib to decompress data before filtering.]) + AC_DEFINE(FEATURE_ZLIB,1,[Define to 1 to use compression through the zlib library.]) else AC_MSG_WARN([No zlib found. Privoxy will not be able to filter compressed content. This may become a fatal error in the future.]) - fi -fi - -AC_ARG_ENABLE(compression, -[ --enable-compression Allow Privoxy to compress buffered content if the client supports it. Requires zlib support.], -[enableval2=$enableval], -[enableval2=no]) -if test $enableval2 = yes; then - if test $have_zlib = "yes"; then - echo Enabling compression support. - AC_DEFINE(FEATURE_COMPRESSION,1,[Define to 1 to use compression through the zlib library.]) - else - AC_MSG_WARN([No zlib found. Privoxy will not be able to (re-)compressed buffered content.]) - fi + fi fi
@@ -960,18 +1416,16 @@ if test $have_pcre = "yes"; then STATIC_PCRE_ONLY=# LIBS="$LIBS -lpcre -lpcreposix" else - AC_MSG_WARN([You are using the static PCRE code which is out of date and scheduled for removal, for details see: - http://sourceforge.net/mailarchive/forum.php?thread_name=20080511195555.2dc6cfdc%40fabiankeil.de&forum_name=ijbswa-developers]) + AC_MSG_WARN([You are using the static PCRE code which is scheduled for removal, for details see: + https://sourceforge.net/mailarchive/message.php?msg_id=20080511195555.2dc6cfdc%40fabiankeil.de]) pcre_dyn=no AC_DEFINE(STATIC_PCRE) STATIC_PCRE_ONLY= fi
-AC_DEFINE(FEATURE_CONNECTION_KEEP_ALIVE) - if test $have_pthread = "yes" -o $target_type = "mingw"; then - echo Enabling connection-sharing support. - AC_DEFINE(FEATURE_CONNECTION_SHARING) + echo Enabling keep-alive support for outgoing connections. + AC_DEFINE(FEATURE_CONNECTION_KEEP_ALIVE) fi
dnl ================================================= @@ -999,7 +1453,7 @@ dnl ================================================================= dnl Final cleanup and output dnl =================================================================
-dnl Remove the SPECIAL_CFLAGS stuff from CFLAGS, and add it separately +dnl Remove the SPECIAL_CFLAGS stuff from CFLAGS, and add it seperately dnl in the Makefile CFLAGS=$old_CFLAGS_nospecial AC_SUBST(SPECIAL_CFLAGS) diff --git a/external/privoxy/cygwin.h b/external/privoxy/cygwin.h index 421516a..526f8d0 100644 --- a/external/privoxy/cygwin.h +++ b/external/privoxy/cygwin.h @@ -1,6 +1,6 @@ #ifndef CYGWIN_H_INCLUDED #define CYGWIN_H_INCLUDED -#define CYGWIN_H_VERSION "$Id: cygwin.h,v 1.8 2011/09/04 11:10:56 fabiankeil Exp $" +#define CYGWIN_H_VERSION "$Id: cygwin.h,v 1.6 2006/07/18 14:48:45 david__schmidt Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/cygwin.h,v $ @@ -13,10 +13,10 @@ * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -34,6 +34,26 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: cygwin.h,v $ + * Revision 1.6 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.4 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.3 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.2 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.1.1.1 2001/05/15 13:58:51 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/
/* Conditionally include this whole file. */ diff --git a/external/privoxy/deanimate.c b/external/privoxy/deanimate.c index cbf0ca8..01fc97c 100644 --- a/external/privoxy/deanimate.c +++ b/external/privoxy/deanimate.c @@ -1,4 +1,4 @@ -const char deanimate_rcs[] = "$Id: deanimate.c,v 1.21 2011/09/04 11:10:56 fabiankeil Exp $"; +const char deanimate_rcs[] = "$Id: deanimate.c,v 1.19 2008/05/21 15:29:35 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/deanimate.c,v $ @@ -6,7 +6,7 @@ const char deanimate_rcs[] = "$Id: deanimate.c,v 1.21 2011/09/04 11:10:56 fabian * Purpose : Declares functions to manipulate binary images on the * fly. High-level functions include: * - Deanimation of GIF images - * + * * Functions declared include: gif_deanimate, buf_free, * buf_copy, buf_getbyte, gif_skip_data_block * and gif_extract_image @@ -19,7 +19,7 @@ const char deanimate_rcs[] = "$Id: deanimate.c,v 1.21 2011/09/04 11:10:56 fabian * and ideas from the Image::DeAnim Perl module by * Ken MacFarlane, <ksm+cpan@universal.dca.net> * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -37,8 +37,77 @@ const char deanimate_rcs[] = "$Id: deanimate.c,v 1.21 2011/09/04 11:10:56 fabian * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: deanimate.c,v $ + * Revision 1.19 2008/05/21 15:29:35 fabiankeil + * Fix gcc43 warnings. + * + * Revision 1.18 2008/03/28 15:13:38 fabiankeil + * Remove inspect-jpegs action. + * + * Revision 1.17 2007/08/05 13:42:22 fabiankeil + * #1763173 from Stefan Huehner: declare some more functions static. + * + * Revision 1.16 2007/07/14 08:01:58 fabiankeil + * s@failiure@failure@ + * + * Revision 1.15 2007/01/03 14:39:19 fabiankeil + * Fix a gcc43 warning and mark the binbuffer + * as immutable for buf_getbyte(). + * + * Revision 1.14 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.12.2.1 2004/10/03 12:53:32 david__schmidt + * Add the ability to check jpeg images for invalid + * lengths of comment blocks. Defensive strategy + * against the exploit: + * Microsoft Security Bulletin MS04-028 + * Buffer Overrun in JPEG Processing (GDI+) Could + * Allow Code Execution (833987) + * Enabled with +inspect-jpegs in actions files. + * + * Revision 1.12 2002/05/12 21:36:29 jongfoster + * Correcting function comments + * + * Revision 1.11 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.10 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.9 2002/03/13 00:27:04 jongfoster + * Killing warnings + * + * Revision 1.8 2002/03/09 19:42:47 jongfoster + * Fixing more warnings + * + * Revision 1.7 2002/03/08 17:46:04 jongfoster + * Fixing int/size_t warnings + * + * Revision 1.6 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.5 2001/09/10 10:16:06 oes + * Silenced compiler warnings + * + * Revision 1.4 2001/07/18 12:28:49 oes + * - Added feature for extracting the first frame + * to gif_deanimate + * - Separated image buffer extension into buf_extend + * - Extended gif deanimation to GIF87a (untested!) + * - Cosmetics + * + * Revision 1.3 2001/07/15 13:57:50 jongfoster + * Adding #includes string.h and miscutil.h + * + * Revision 1.2 2001/07/13 13:46:20 oes + * Introduced GIF deanimation feature + * + * **********************************************************************/ - +
#include "config.h"
@@ -53,7 +122,7 @@ const char deanimate_rcs[] = "$Id: deanimate.c,v 1.21 2011/09/04 11:10:56 fabian const char deanimate_h_rcs[] = DEANIMATE_H_VERSION;
/********************************************************************* - * + * * Function : buf_free * * Description : Safely frees a struct binbuffer @@ -79,7 +148,7 @@ void buf_free(struct binbuffer *buf)
/********************************************************************* - * + * * Function : buf_extend * * Description : Ensure that a given binbuffer can hold a given amount @@ -90,7 +159,7 @@ void buf_free(struct binbuffer *buf) * Parameters : * 1 : buf = Pointer to the binbuffer * 2 : length = Desired minimum size - * + * * * Returns : 0 on success, 1 on failure. * @@ -121,7 +190,7 @@ static int buf_extend(struct binbuffer *buf, size_t length)
/********************************************************************* - * + * * Function : buf_copy * * Description : Safely copies a given amount of bytes from one @@ -142,7 +211,7 @@ static int buf_copy(struct binbuffer *src, struct binbuffer *dst, size_t length) /* * Sanity check: Can't copy more data than we have */ - if (src->offset + length > src->size) + if (src->offset + length > src->size) { return 1; } @@ -150,7 +219,7 @@ static int buf_copy(struct binbuffer *src, struct binbuffer *dst, size_t length) /* * Ensure that dst can hold the new data */ - if (buf_extend(dst, length)) + if (buf_extend(dst, length)) { return 1; } @@ -169,7 +238,7 @@ static int buf_copy(struct binbuffer *src, struct binbuffer *dst, size_t length)
/********************************************************************* - * + * * Function : buf_getbyte * * Description : Safely gets a byte from a given binbuffer at a @@ -197,7 +266,7 @@ static unsigned char buf_getbyte(const struct binbuffer *src, size_t offset)
/********************************************************************* - * + * * Function : gif_skip_data_block * * Description : Safely advances the offset of a given struct binbuffer @@ -215,7 +284,7 @@ static int gif_skip_data_block(struct binbuffer *buf) { unsigned char c;
- /* + /* * Data blocks are sequences of chunks, which are headed * by a one-byte length field, with the last chunk having * zero length. @@ -236,12 +305,12 @@ static int gif_skip_data_block(struct binbuffer *buf)
/********************************************************************* - * + * * Function : gif_extract_image * * Description : Safely extracts an image data block from a given * struct binbuffer that contains a GIF image and whose - * offset is positioned at the start of a data block + * offset is positioned at the start of a data block * into a given destination binbuffer. * * Parameters : @@ -279,7 +348,7 @@ static int gif_extract_image(struct binbuffer *src, struct binbuffer *dst) if (buf_copy(src, dst, (size_t)map_length)) { return 1; - } + } } if (buf_copy(src, dst, 1)) return 1;
@@ -304,7 +373,7 @@ static int gif_extract_image(struct binbuffer *src, struct binbuffer *dst) }
/********************************************************************* - * + * * Function : gif_deanimate * * Description : Deanimate a given GIF image, i.e. given a GIF with @@ -336,9 +405,9 @@ int gif_deanimate(struct binbuffer *src, struct binbuffer *dst, int get_first_im c = buf_getbyte(src, 10);
/* - * Check & copy GIF header + * Check & copy GIF header */ - if (strncmp(src->buffer, "GIF89a", 6) && strncmp(src->buffer, "GIF87a", 6)) + if (strncmp(src->buffer, "GIF89a", 6) && strncmp(src->buffer, "GIF87a", 6)) { return 1; } @@ -390,7 +459,7 @@ int gif_deanimate(struct binbuffer *src, struct binbuffer *dst, int get_first_im case 0x3b: goto write;
- /* + /* * Image block: Extract to current image buffer. */ case 0x2c: @@ -450,13 +519,13 @@ int gif_deanimate(struct binbuffer *src, struct binbuffer *dst, int get_first_im */ default: goto failed; - + } } /* -END- while src */
/* * Either we got here by goto, or because the GIF is - * bogus and EOF was reached before an end-of-gif marker + * bogus and EOF was reached before an end-of-gif marker * was found. */
diff --git a/external/privoxy/deanimate.h b/external/privoxy/deanimate.h index cc10fac..53af6f1 100644 --- a/external/privoxy/deanimate.h +++ b/external/privoxy/deanimate.h @@ -1,6 +1,6 @@ #ifndef DEANIMATE_H_INCLUDED #define DEANIMATE_H_INCLUDED -#define DEANIMATE_H_VERSION "$Id: deanimate.h,v 1.14 2011/09/04 11:10:56 fabiankeil Exp $" +#define DEANIMATE_H_VERSION "$Id: deanimate.h,v 1.12 2008/03/28 15:13:39 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/deanimate.h,v $ @@ -8,9 +8,9 @@ * Purpose : Declares functions to manipulate binary images on the * fly. High-level functions include: * - Deanimation of GIF images - * + * * Functions declared include: gif_deanimate and buf_free. - * + * * * Copyright : Written by and Copyright (C) 2001 - 2004 by the the * SourceForge Privoxy team. http://www.privoxy.org/ @@ -19,10 +19,10 @@ * Ken MacFarlane, <ksm+cpan@universal.dca.net> * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -40,8 +40,51 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: deanimate.h,v $ + * Revision 1.12 2008/03/28 15:13:39 fabiankeil + * Remove inspect-jpegs action. + * + * Revision 1.11 2007/01/12 15:41:00 fabiankeil + * Remove some white space at EOL. + * + * Revision 1.10 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.8.2.1 2004/10/03 12:53:32 david__schmidt + * Add the ability to check jpeg images for invalid + * lengths of comment blocks. Defensive strategy + * against the exploit: + * Microsoft Security Bulletin MS04-028 + * Buffer Overrun in JPEG Processing (GDI+) Could + * Allow Code Execution (833987) + * Enabled with +inspect-jpegs in actions files. + * + * Revision 1.8 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.7 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.6 2002/03/08 17:46:04 jongfoster + * Fixing int/size_t warnings + * + * Revision 1.5 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.4 2001/07/29 18:50:04 jongfoster + * Fixing "extern C" block, and renaming #define _DEANIMATE_H + * + * Revision 1.3 2001/07/18 12:29:05 oes + * Updated prototype for gif_deanimate + * + * Revision 1.2 2001/07/13 13:46:20 oes + * Introduced GIF deanimation feature + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -64,7 +107,7 @@ struct binbuffer extern int gif_deanimate(struct binbuffer *src, struct binbuffer *dst, int get_first_image); extern void buf_free(struct binbuffer *buf);
-/* +/* * Revision control strings from this header and associated .c file */ extern const char deanimate_rcs[]; diff --git a/external/privoxy/default.action.master b/external/privoxy/default.action.master index a26a0ec..81c4138 100644 --- a/external/privoxy/default.action.master +++ b/external/privoxy/default.action.master @@ -11,7 +11,7 @@ # # File : $Source: /cvsroot/ijbswa/current/default.action.master,v $ # -# $Id: default.action.master,v 1.242 2011/10/16 13:13:50 fabiankeil Exp $ +# $Id: default.action.master,v 1.170 2009/03/04 15:05:00 ler762 Exp $ # # Requires : This version requires Privoxy v3.0.11 or later due to # syntax changes. @@ -23,7 +23,7 @@ # and enhancements are better placed in user.action, # the match-all section has been moved to match-all.action. # -# Copyright : Written by and Copyright (C) 2001-2010 the +# Copyright : Written by and Copyright (C) 2001-2009 the # Privoxy team. http://www.privoxy.org/ # # Note: Updated versions of this file will be made available from time @@ -545,7 +545,7 @@ for-privoxy-version=3.0.11 # These aliases define combinations of actions # that are useful for certain types of sites: # -fragile = -block -crunch-all-cookies -filter -fast-redirects -hide-referer +fragile = -block -crunch-all-cookies -filter -fast-redirects -hide-referer -prevent-compression shop = -crunch-all-cookies allow-popups
# Your favourite blend of filters: @@ -563,8 +563,6 @@ allow-ads = -block -filter{banners-by-size} -filter{banners-by-link} # { \ +change-x-forwarded-for{block} \ -+client-header-tagger{css-requests} \ -+client-header-tagger{image-requests} \ +hide-from-header{block} \ +set-image-blocker{pattern} \ } @@ -576,8 +574,6 @@ standard.Cautious # { \ +change-x-forwarded-for{block} \ -+client-header-tagger{css-requests} \ -+client-header-tagger{image-requests} \ +deanimate-gifs{last} \ +filter{refresh-tags} \ +filter{img-reorder} \ @@ -645,16 +641,6 @@ standard.Advanced /.*.(js|php|css|.?html?)
############################################################################# -# These belong to multimedia files of which Firefox occasionally only -# requests parts. #2816708 -############################################################################# -{-filter -deanimate-gifs} -# Sticky Actions = -filter -deanimate-gifs -# URL = http://www.example.org/foo/bar.ogg -# URL = http://www.example.net/bar.ogv -/.*.og[gv]$ - -############################################################################# # Generic block patterns by host: ############################################################################# {+block{Host matches generic block pattern.}} @@ -681,7 +667,6 @@ metrics. # Generic unblockers by host: ############################################################################# {-block} -# Sticky Actions = -block adsl. ad[udmw]*. adbl*. @@ -698,11 +683,6 @@ adventure*. .*[epu]ad*. county*. countr*. -#MASTER# REMARKS: We still like tor -# URL = http://metrics.torproject.org/consensus-graphs.html -metrics.torproject.org/ -# URL = http://linuxcounter.net/ -linuxcounter.net/
############################################################################# # Generic block patterns by path: @@ -728,8 +708,6 @@ linuxcounter.net/ /.*(lo|thre|he|d|gr|l|ro|re|squ|class(ified)?)ads /.*account support./(.*/)?track -# URL = http://repo.or.cz/r/vlc.git/objects/ad/1d316efd83157217fdf9b5d417dddca54bbf41 -/.*.git/objects/
############################################################################# # Exceptions for academia and non-profits @@ -760,152 +738,6 @@ support./(.*/)?track /.*(top|bottom|left|right|text)_?ad
############################################################################# -# Catch-all exceptions -############################################################################# -{-block} -# Sticky Actions = -block - -#MASTER# REMARKS: Actionsfile feedback item #2933856 2010-01-17 16:59 -#MASTER# REMARKS: Allow URLs containing DektopAdmin (matches .*top_?ad) -# URL = http://support.apple.com/downloads/DL985/en_US/RemoteDesktopAdmin332.dmg -/.*desktopadmin - - -#---------------------------------------------------------------------------- -# Misc Web-bugs, JS and just plain Junk. Images here aren't normal images. -#---------------------------------------------------------------------------- -{+block{Might be a web-bug.} +handle-as-empty-document -handle-as-image} -#MASTER# REMARKS: signature for user tracking nytimes, cnn.com,latimes.com and many others. 10/06/06 -/b/ss/.+ -#MASTER# BLOCK-REFERRER: http://www.thesun.co.uk/article/0,,11071-10784,00.html -#MASTER# REMARKS: widespread hitbox signature 10/06/06 -/HG?hc= -#MASTER# BLOCK-REFERRER: http://macaddict.com 10/06/06 -.visistat.com -#MASTER# REMARKS: See <http://www.google.com/analytics/> for user tracking. -#MASTER# REMARKS: There is a ssl.google-analytics as well. -.google-analytics./ -#MASTER# REMARKS: Below Moved here from -handle-as-image 10/16/06 ########## -#MASTER# BLOCK-REFERRER: http://forums2.gardenweb.com/forums/orchids/ 09/25/06 -#MASTER# REMARKS: Mostly JS and plain text stuff -.overture. -#MASTER# PROBLEM-URL: http://www.linuxtoday.com/ -#MASTER# REMARKS: /adi has HTML snipplets for use in IFRAMEs 10/15/06 -.doubleclick.net/adi -.doubleclick.net/(.*/)?adj/ -#MASTER# PROBLEM-URL: http://maps.yahoo.com/ -#MASTER# REMARKS: /AVE/iview has HTML snipplets for use in IFRAMEs 10/15/06 -view.atdmt.com/(.*/)?iview/ -#MASTER# REMARKS: Above Moved here from -handle-as-image 10/16/06 ########## -#MASTER# REMARKS: Generic, re: tracking.foxnews.com/HG? 10/01/06 -tracking. -#MASTER# BLOCK-REFERRER: http://netcraft.com and many others 10/22/06 -/(.*/)?adjs.php? -#MASTER# BLOCK-REFERRER: http://groups.yahoo.com/group/epdf/ 10/08/06 -.bc.yahoo.com/b?P= -#MASTER# BLOCK-REFERRER: http://www.motherboard.cz 10/30/06 -x*.alexa.com -#MASTER# BLOCK-REFERRER: http://mplayernetwork.com 11/07/06 -#MASTER# BLOCK-REFERRER: http://eetimes.com 09/26/06 -/event.ng/ -#MASTER# BLOCK-REFERRER: http://www.homedepot.com/ 11/08/06 -#MASTER# BLOCK-REFERRER: http://www.williams-sonoma.com/ 11/08/06 -/cm?[tc] -#MASTER# BLOCK-REFERRER: http://www.snapfiles.com/feedback/ 12/13/06 SF tracker -.snapfiles.net/rotation/.*.asp -#MASTER# BLOCK-REFERRER: not provided. SF tracker #1616034 12/16/06 -#MASTER# COMMENT: JS pop-ups -spa.snap.com/ -#MASTER# BLOCK-REFERRER: http://www.gamefaqs.com/computer/doswin/game/914819.html 12/18/06 -#MASTER# COMMENT: user tracking, and run-away assorted 'junk' -#MASTER# BLOCK-REFERRER: http://formwood.com 2007-11-12 -.insitemetrics.com/ -#MASTER# COMMENT: user tracking, and assorted 'junk' -#MASTER# BLOCK-REFERRER: http://blogblog.com 2007-11-12 -.extreme-dm.com/ -#MASTER# COMMENT: user tracking, and assorted 'junk' -#MASTER# BLOCK-REFERRER: http://www.schillmania.com 2007-11-12 -stats.reinvigorate.net/ -#MASTER# COMMENT: user tracking, and assorted 'junk' -#MASTER# BLOCK-REFERRER: http://wordpress.com 2007-11-12 -.getclicky.com/ -#MASTER# COMMENT: user tracking, and assorted 'junk' -#MASTER# BLOCK-REFERRER: http://infoworld.com 2007-11-12 -.quantserve.com -# Blocked URL = http://media.adrevolver.com/adrevolver/trace?sip=123&cpy=123 -media.adrevolver.com/ -#MASTER# REMARKS: Actionsfile feedback item #2975895 2010-03-24 -# Blocked URL = http://static.chartbeat.com/js/chartbeat.js -.chartbeat.com/(.*/)?chartbeat.js$ -# Blocked URL = http://js.adlink.net/js?lang=de&s=duesseldorf-international.de&z=home&d=1274103403564 -#MASTER# BLOCK-REFERRER: http://www.duesseldorf-international.de/ -js.adlink.net/ -# Blocked URL = nl.sitestat.com/rdw/rdw/s?www.nl.voertuigeigenaar.voertuigeigenaar&ns__t=1274099350343 -#MASTER# BLOCK-REFERRER: http://www.rdw.nl/nl/voertuigeigenaar/ -.sitestat.com/ -#MASTER# BLOCK-REFERRER: http://www.chip.de/artikel/c_artikelunterseite_10423683.html -# Blocked URL = http://pagead.googlesyndication.example.com/foo/bar/baz.js -pagead*.googlesyndication./.*.js -#MASTER# BLOCK-REFERRER: http://www.pcmag.com/ 11/22/06 per SF Tracker # 1601148 -/js/slider.js -#MASTER# BLOCK-REFERRER: http://floodle.net 2007-01-21 SF tracker -scripts.chitika.net/.*.js -#MASTER# BLOCK-REFERRER: via Yahoo groups -#MASTER# REMARKS: Actionsfile tracker 1645513 2007-01-26 -.adinterax.com/.*.js -#MASTER# BLOCK-REFERRER: http://dictionary.reference.com/search?q=privacy&db=* -#MASTER# REMARKS: Actionsfile tracker 1650798 2007-02-02 -# Blocked URL = http://partner.googleadservices.com/gampad/google_service.js -# Blocked URL = http://partner.googleadservices.com/gampad/google_ads.js -# Blocked URL = http://partner.googleadservices.com/gampad/slotdata.js?callback=_GA_googleAdData.setAdSlotAttributes&client=ca-gam-lexico -.googleadservices.com/gampad/.*.js -# Blocked URL = http://richmedia.yimg.com/js/123/personnals_banners/PER_happy_sara1_4_425x600/ad.js?q=123 -/.*/ad.js? -# Blocked URL = http://i.cmpnet.com/shared/omniture/s_code_remote.js -#MASTER# BLOCK-REFERRER: http://www.informationweek.de/ -/.*omniture.*.js -# Blocked URL = http://gadk.hit.gemius.pl/*/_1274097577014/rexdot.gif?l=30&id=..DlR.vCLZGB56RmfkYNSWZVLSqB3ueYOP.Oec5WWiv.h7&fr=1&fv=WIN%2010%2C0%2C45%2C2&tz=-120&href=http%3A//www.baadgalleri.dk/&ref=&screen=1440x900&col=32 -#MASTER# BLOCK-REFERRER: http://www.baadgalleri.dk/ -.gemius.pl/ - - -{+block{Might be a web-bug.} -handle-as-empty-document +handle-as-image} -#MASTER# BLOCK-REFERRER: http://versiontracker.com and many others. 10/20/06 -/(.*/)?__utm.gif? -#MASTER# BLOCK-REFERRER: http://washingpost.com and others 10/25/06 -/.*.gif?D=DM -#MASTER# BLOCK-REFERRER: http://www.washingtonpost.com/ -#stats.surfaid.ihost.com/(crc/)?images/(bounce/)?uc.GIF -#MASTER# BLOCK-REFERRER: http://www.ibm.com 10/09/06 -#MASTER# REMARKS: Similar hostname and paths appear in multiple locations. -# Blocked URL = http://stats.surfaid.ihost.com/crc/images/bounce/uc.GIF -# Blocked URL = http://stats.surfaid.ihost.com/rc/images/bounce/uc.GIF -stats./c?rc/.*/uc.gif -#MASTER# BLOCK-REFERRER: http://priceline.com 10/20/06 -#MASTER# REMARKS: User tracking, webbug stuff -/(.*/)?dcs.gif?&?dcs -#MASTER# BLOCK-REFERRER: http://www.msnbc.com 10/07/06 -#MASTER# REMARKS: And MANY others. Webbug stuff. -/(.*/)?c(lear)?.gif?. -#MASTER# BLOCK-REFERRER: http://www.investorguide.com 10/08/06 -#MASTER# BLOCK-REFERRER: http://foodnetwork.com, http://gardenweb.com 10/20/06 -#MASTER# REMARK: webbug type gif used in MANY places. -#MASTER# REMARK: Too many false positives -#/(.*/)?(clear|(trans_?1x|blank)?1).gif -#MASTER# REMARK: Let's try this way. -/(.*/)?(clear|blank|(trans_?|1x)?1).gif?. -#MASTER# BLOCK-REFERRER: http://actorstheatre.org 11/02/06 -stats./.*.gif? -# Blocked URL = http://ad.yieldmanager.com/pixel?id=123456&t=2 -.yieldmanager.com/pixel? -# Blocked URL = http://a.analytics.yahoo.com/p.pl?a=1000226660965&js=no -# Blocked URL = http://s.analytics.yahoo.com/fpc.pl?a=1000461640983&v=4.43&enc=utf-8&f=http%3A//www.zoover.nl/nederland/limburg/maasbracht/weer%23tabs&b=Het%20Weer%20in%20Maasbracht.%20Bekijk%20Weersverwachting%20van%20Maasbracht%20%7C%20Zoover%23tabs&flv=WIN%2010%2C0%2C45%2C2&d=Mon%2C%2017%20May%202010%2014%3A09%3A26%20UTC&n=-2&g=nl&h=Y&j=1440x900&k=32&l=true&ittidx=0&fpc=uP04C7j4%7ClaDQjglKaa%7Cfses1000461640983%3D%7CkbSSgv6Jaa%7CuP04C7j4%7Cfvis1000461640983%3DZj1odHRwJTNBLy93d3cuem9vdmVyLm5sLyZiPVpvb3ZlciUyMCU3QyUyMFZha2FudGllYmVvb3JkZWxpbmdlbiUyMHZvb3IlMjBlbiUyMGRvb3IlMjByZWl6aWdlcnM%3D%7C8sHTYo10oM%7C8sHTYo10oM%7C8sHTYo10oM%7CT%7C8sHTYo10oM%7C8sHTYo10oM -.analytics.yahoo.com -#MASTER# BLOCK-REFERRER: http://www.aktivist.pl/ -# Blocked URL = http://go.idmnet.bbelements.com/please/showit/46/1/1/1/?typkodu=img&keywords= -go.idmnet.bbelements.com/please/showit/ - -############################################################################# # Site-specific block patterns; ############################################################################# {+block{Domain parking site}} @@ -916,10 +748,6 @@ go.idmnet.bbelements.com/please/showit/ landing.trafficz.com/ # Blocked URL = http://www.searchnut.com/?domain=www.inetcat.org .searchnut.com/?domain -#MASTER# REMARKS: Verizon should know better -#MASTER# BLOCK-REFERRER: http://www.qwetyhjkl.com -# Blocked URL = http://wwwz.websearch.verizon.net/search?qo=www.qwetyhjkl.com -wwwz.websearch.verizon.net/search?qo=
{+block{Site-specific block pattern matches.}} #MASTER# BLOCK-REFERRER: http://www.brooksbrothers.com/ 10/18/06 @@ -1059,52 +887,128 @@ static.lycos-europe.net #MASTER# BLOCK-REFERRER: http://hitta.se # Blocked URL = http://82.99.18.195/media.1/112/9460/146016/150x175_Hitta_FV_Feb08.gif 82.99.18.195 -#MASTER# REMARKS: Actionsfile feedback item #1888197 and #2975927. -#MASTER# REMARKS: Have a "go there anyway" link for clk.atdmt.com and view.atdmt.com. +#MASTER# REMARKS: Actionsfile feedback item #1888197 2008-02-06 +#MASTER# REMARKS: Have a "go there anyway" link for clk.atdmt.com #MASTER# BLOCK-REFERRER: http://www.networkworld.com/resourcelibrary/?tid=4&type=special%20report # Blocked URL = http://clk.atdmt.com/ -# Blocked URL = http://view.atdmt.com/action/mrtiwy_FY10Office2010BetaHomeandBiz1_1 .atdmt.com/ -#MASTER# REMARKS: Actionsfile feedback item #2723873 2009-04-01 -#MASTER# BLOCK-REFERRER: http://www.news.software.coop/paralysed-perl-package-problem/602/ -# Blocked URL = http://www.awin1.com/cread.php?s=123049&v=1983&q=80970&r=79561 -.awin1.com -#MASTER# BLOCK-REFERRER: http://crooksandliars.com/ -# Blocked URL = http://rotator.adjuggler.com/servlet/ajrotator/616245/0/vh?z=csm&dim=616028 -.adjuggler.com/servlet/ajrotator/ -#MASTER# Remark: nothing but "sponsored listings" -# Blocked URL = http://bcc.co.uk/ -bcc.co.uk/ -# Blocked URL = http://fusion.adtoma.com:80/125AFFE801/1DC59C7801.swf -# Blocked URL = http://fusion.adtoma.com/1254D5CC01/1E43C76801.jpg -fusion.adtoma.com/ -#MASTER# Remark: Actionsfile feedback item #2975895 2010-03-24 -# Blocked URL = http://ping.chartbeat.net/ping?h=uservoice.com&p=%2Fsuggestions%2Fping-chartbeat-net-sucks&u=3 -.chartbeat.net/(.*/)?ping? -# Blocked URL = http://s.atemda.com/Admeta.js -# Blocked URL = http://atemda.com/ClickThrough.ashx?pId=9616&mId=14484&tId=634102151426089505&opS=1&admetac=mR3sJ3%2b9yleq%2bHowITh0hw%3d%3d -#MASTER# BLOCK-REFERRER: http://www.startpagina.nl -.atemda.com/ -#MASTER# Remark: 2o7.net, omtrdc.net and www91.intel.com are domains used by Omniture -# Blocked URL = http://ciscosystemsinc.tt.omtrdc.net/m2/ciscosystemsinc/mbox/standard?mboxHost=www.cisco.com&mboxSession=12 -.omtrdc.net/ -# Blocked URL = http://www91.intel.com/b/ss/intelcorp,intelcorpdc/...ONDataProvider.aspx%3FDownloadType%3DDrivers&ot=A&AQE=1 -www91.intel.com/
+#---------------------------------------------------------------------------- +# Misc Web-bugs, JS and just plain Junk. Images here aren't normal images. +#---------------------------------------------------------------------------- +{+block{Might be a web-bug.} +handle-as-empty-document -handle-as-image} +#MASTER# REMARKS: signature for user tracking nytimes, cnn.com,latimes.com and many others. 10/06/06 +/b/ss/.+ +#MASTER# BLOCK-REFERRER: http://www.thesun.co.uk/article/0,,11071-10784,00.html +#MASTER# REMARKS: widespread hitbox signature 10/06/06 +/HG?hc= +#MASTER# BLOCK-REFERRER: http://macaddict.com 10/06/06 +.visistat.com +#MASTER# REMARKS: See <http://www.google.com/analytics/> for user tracking. +#MASTER# REMARKS: There is a ssl.google-analytics as well. +.google-analytics./ +#MASTER# BLOCK-REFERRER: http://versiontracker.com and many others. 10/20/06 +/(.*/)?__utm.gif? +#MASTER# REMARKS: Below Moved here from -handle-as-image 10/16/06 ########## +#MASTER# BLOCK-REFERRER: http://forums2.gardenweb.com/forums/orchids/ 09/25/06 +#MASTER# REMARKS: Mostly JS and plain text stuff +.overture. +#MASTER# PROBLEM-URL: http://www.linuxtoday.com/ +#MASTER# REMARKS: /adi has HTML snipplets for use in IFRAMEs 10/15/06 +.doubleclick.net/adi +.doubleclick.net/(.*/)?adj/ +#MASTER# PROBLEM-URL: http://maps.yahoo.com/ +#MASTER# REMARKS: /AVE/iview has HTML snipplets for use in IFRAMEs 10/15/06 +view.atdmt.com/(.*/)?iview/ +#MASTER# REMARKS: Above Moved here from -handle-as-image 10/16/06 ########## +#MASTER# REMARKS: Generic, re: tracking.foxnews.com/HG? 10/01/06 +tracking. +#MASTER# BLOCK-REFERRER: http://netcraft.com and many others 10/22/06 +/(.*/)?adjs.php? +#MASTER# BLOCK-REFERRER: http://washingpost.com and others 10/25/06 +/.*.gif?D=DM +#MASTER# BLOCK-REFERRER: http://www.washingtonpost.com/ +#stats.surfaid.ihost.com/(crc/)?images/(bounce/)?uc.GIF +#MASTER# BLOCK-REFERRER: http://www.ibm.com 10/09/06 +#MASTER# REMARKS: Similar hostname and paths appear in multiple locations. +# Blocked URL = http://stats.surfaid.ihost.com/crc/images/bounce/uc.GIF +# Blocked URL = http://stats.surfaid.ihost.com/rc/images/bounce/uc.GIF +stats./c?rc/.*/uc.gif +#MASTER# BLOCK-REFERRER: http://priceline.com 10/20/06 +#MASTER# REMARKS: User tracking, webbug stuff +/(.*/)?dcs.gif?&?dcs +#MASTER# BLOCK-REFERRER: http://www.msnbc.com 10/07/06 +#MASTER# REMARKS: And MANY others. Webbug stuff. +/(.*/)?c(lear)?.gif?. +#MASTER# BLOCK-REFERRER: http://www.investorguide.com 10/08/06 +#MASTER# BLOCK-REFERRER: http://foodnetwork.com, http://gardenweb.com 10/20/06 +#MASTER# REMARK: webbug type gif used in MANY places. +#MASTER# REMARK: Too many false positives +#/(.*/)?(clear|(trans_?1x|blank)?1).gif +#MASTER# REMARK: Let's try this way. +/(.*/)?(clear|blank|(trans_?|1x)?1).gif?. +#MASTER# BLOCK-REFERRER: http://groups.yahoo.com/group/epdf/ 10/08/06 +.bc.yahoo.com/b?P= +#MASTER# BLOCK-REFERRER: http://www.motherboard.cz 10/30/06 +x*.alexa.com +#MASTER# BLOCK-REFERRER: http://actorstheatre.org 11/02/06 +stats./.*.gif? +#MASTER# BLOCK-REFERRER: http://mplayernetwork.com 11/07/06 +#MASTER# BLOCK-REFERRER: http://eetimes.com 09/26/06 +/event.ng/ +#MASTER# BLOCK-REFERRER: http://www.homedepot.com/ 11/08/06 +#MASTER# BLOCK-REFERRER: http://www.williams-sonoma.com/ 11/08/06 +/cm?[tc] +#MASTER# BLOCK-REFERRER: http://www.snapfiles.com/feedback/ 12/13/06 SF tracker +.snapfiles.net/rotation/.*.asp +#MASTER# BLOCK-REFERRER: not provided. SF tracker #1616034 12/16/06 +#MASTER# COMMENT: JS pop-ups +spa.snap.com/ +#MASTER# BLOCK-REFERRER: http://www.gamefaqs.com/computer/doswin/game/914819.html 12/18/06 +#MASTER# COMMENT: user tracking, and run-away assorted 'junk' +#MASTER# BLOCK-REFERRER: http://formwood.com 2007-11-12 +.insitemetrics.com/ +#MASTER# COMMENT: user tracking, and assorted 'junk' +#MASTER# BLOCK-REFERRER: http://blogblog.com 2007-11-12 +.extreme-dm.com/ +#MASTER# COMMENT: user tracking, and assorted 'junk' +#MASTER# BLOCK-REFERRER: http://www.schillmania.com 2007-11-12 +stats.reinvigorate.net/ +#MASTER# COMMENT: user tracking, and assorted 'junk' +#MASTER# BLOCK-REFERRER: http://wordpress.com 2007-11-12 +.getclicky.com/ +#MASTER# COMMENT: user tracking, and assorted 'junk' +#MASTER# BLOCK-REFERRER: http://infoworld.com 2007-11-12 +.quantserve.com +# Blocked URL = http://media.adrevolver.com/adrevolver/trace?sip=123&cpy=123 +media.adrevolver.com/
#---------------------------------------------------------------------------- # JavaScripts and Texts for ad and popup generation #---------------------------------------------------------------------------- +#MASTER# BLOCK-REFERRER: http://www.chip.de/artikel/c_artikelunterseite_10423683.html +# Blocked URL = http://pagead.googlesyndication.example.com/foo/bar/baz.js +pagead*.googlesyndication./.*.js #MASTER# REMARKS: broadening scope from a.tfag.de/js.ng/ 10/23/06 # Blocked URL = http://a.tfag.de/js.ng/ /js.ng/ #MASTER# BLOCK-REFERRER: http://www.britannica.com/ 10/23/06 /popunder +#MASTER# BLOCK-REFERRER: http://www.pcmag.com/ 11/22/06 per SF Tracker # 1601148 +/js/slider.js #MASTER# BLOCK-REFERRER: http://www.earthcore.com/ feedback item #1605385 12/14/06 /t.php?cat=.*&kw=.*&sc= +#MASTER# BLOCK-REFERRER: http://floodle.net 2007-01-21 SF tracker +scripts.chitika.net/.*.js #MASTER# REMARKS: Actionsfile tracker #1674363 2007-03-05, text ads #MASTER# BLOCK-REFERRER: http://www.securityfocus.com/archive/1/461489/30/0/threaded jlinks.industrybrains.com/ +#MASTER# BLOCK-REFERRER: via Yahoo groups +#MASTER# REMARKS: Actionsfile tracker 1645513 2007-01-26 +.adinterax.com/.*.js +#MASTER# BLOCK-REFERRER: http://dictionary.reference.com/search?q=privacy&db=* +#MASTER# REMARKS: Actionsfile tracker 1650798 2007-02-02 +.googleadservices.com/gampad/.*.js #MASTER# BLOCK-REFERRER: http://www.linuxworld.com/news/2007/061307-brian-aker-interview.html #MASTER# REMARKS: Actionsfile feedback item #1736794 2007-06-13 js.adsonar. @@ -1114,7 +1018,10 @@ js.adsonar. bwp. # Blocked URL = http://us.mc123.mail.yahoo.com/mc/stampNonJs .yahoo.com/mc/stampNonJs - +# Blocked URL = http://richmedia.yimg.com/js/123/personnals_banners/PER_happy_sara1_4_425x600/ad.js?q=123 +/.*/ad.js? +# Blocked URL = http://ad.yieldmanager.com/st?ad_type=iframe&ad_size=728x90&site=123§ion_code=123 +/.*?ad_(type|size)=
############################################################################# # Generic block-as-image patterns: @@ -1145,8 +1052,6 @@ bwp. # Blocked URL = http://icons-aa.wunderground.com/ads/images/TripAdvisor-Blinky.gif # URL = http://icons-aa.wunderground.com/ads/images/TripAdvisor-Blinky.gif /(.*/)?ads/images/ -# Blocked URL = http://ad.yieldmanager.com/st?ad_type=iframe&ad_size=728x90&site=123§ion_code=123 -/.*?ad_(type|size)=
############################################################################# # Site-specific block-as-image patterns: @@ -1175,20 +1080,15 @@ bwp. #.yimg.com/a/.*/flash/ #MASTER# REMARKS: The above replaced with below. Actions file tracker #1645616 2007-01-27 .yimg.com/.*.yimg.com/a/ -#MASTER# REMARKS: Yahoo doesn't always have ".yimg.com/a/" in the URL for ads now 2010-02-28 -#MASTER# BLOCK-REFERRER: various yahoo pages -# Blocked URL = http://l.yimg.com/a/a/1-/flash/promotions/l3/intl/100214/300x250mfeyap.jpg -# Blocked URL = http://l.yimg.com/a/a/1-/flash/promotions/l3/intl/100219/300x250mfeya.gif -.yimg.com/.*/flash/promotions/.*.(gif|jpg)$ bs*.gsanet.com bs*.einets.com .qkimg.net #MASTER# BLOCK-REFERRER: http://salon.com/ 10/19/06 #MASTER# BLOCK-REFERRER: http://maps.yahoo.com/ #MASTER# REMARKS: Banner farms; just exclude their corp. info -#MASTER# REMARKS: and have a "go there anyway" link for clk.atdmt.com and view.atdmt.com -#MASTER# REMARKS: (Actionsfile feedback item #1888197 and #2975927) -[abd-ux-z]*.atdmt.com/ +#MASTER# REMARKS: and have a "go there anyway" link for clk.atdmt.com +#MASTER# REMARKS: (Actionsfile feedback item #1888197) +[abd-vx-z]*.atdmt.com/ #MASTER# BLOCK-REFERRER: http://www.exactaudiocopy.de/ 09/11/06 #MASTER# BLOCK-REFERRER: http://stanford.facebook.com/home.php # URL = http://www.fastclick.net/ @@ -1215,7 +1115,7 @@ a.tribalfusion.com/ #MASTER# REMARKS: Pointdexter .ru4.com/ #MASTER# BLOCK-REFERRER: http://www.boursorama.com/infos/actualites/detail_actu_marches.phtml?news=1510287 -.smartadserver.com/ +www.smartadserver.com/ #MASTER# BLOCK-REFERRER: http://www.chez.tiscali.fr/ 10/07/06 admedia. #MASTER# REMARKS: Bannerfarm used by Morpheus file sharing software @@ -1305,15 +1205,6 @@ img.directtrack.com .pclick.yahoo.com/images/ # Blocked URL = http://rover.ebay.com/ar/1/2/3?mpt=123&adtype=1&size=728x90 /.*&adtype= -# Blocked URL = http://resources.parfym.se/tradedoubler/250x360.swf -/tradedoubler/.*.swf -# Blocked URL = http://hstse.tradedoubler.com/file/142609/440x220.swf -hstse.tradedoubler.com/.*.swf -# Blocked URL = http://www.zdnetasia.com/2007/techguide/network/sponsor/i/logmein_mpu_whitepaper.gif -# Blocked URL = http://www.zdnetasia.com/2007/techguide/network/sponsor/sidebar.gif -www.zdnetasia.com/.*/sponsor/.*.gif$ -# Blocked URL = http://pagead2.googlesyndication.com/pagead/imgad?id=CPjtipDs9taquQEQoAEYwgQyCIvo2PNnQywb -.googlesyndication.com/.*/imgad?
#---------------------------------------------------------------------------- # Cross-site user tracking @@ -1406,19 +1297,6 @@ feeds.feedburner.com/~a/DilbertDailyStrip? #MASTER# BLOCK-REFERER: http://www.buch.de/ # URL = http://track.webtrekk.de/471497967328727/wt.pl?p=177,de.buch.show.home,1,1024x768,24,1,1218816426275,0,884x653,0&enc1=%FC&enc2=iso-8859-1&st=view&la=en-US&np=Default%20Plugi track.webtrekk.de/ -#MASTER# BLOCK-REFERER: https://sourceforge.net/ -# URL = http://b.scorecardresearch.com/p2?c1=2&c2=6035546&c3=&c4=&c5=&c6=&c15=&cj=1 -b.scorecardresearch.com/ -# URL = https://sb.scorecardresearch.com/ -sb.scorecardresearch.com/ -#MASTER# BLOCK-REFERRER: http://sourceforge.net/projects/ijbswa/ -# Blocked URL = http://b.collective-media.net/seg/cm/cm_aa_gn1 -b.collective-media.net/ -#MASTER# BLOCK-REFERRER: http://www.spiegel.de/ -# Blocked URL = http://spiegel.ivwbox.de/cgi-bin/ivw/CP/1001;/home/c-18/be-PB64-aG9tZXBhZ2UvY2VudGVy/szwprofil-1001 -#MASTER# BLOCK-REFERRER: http://www.heise.de/ -# Blocked URL = http://heise.ivwbox.de/2004/01/survey.js - .ivwbox.de/
#---------------------------------------------------------------------------- # Specific counters (see above for generic patterns) @@ -1703,14 +1581,6 @@ tags.gawker.com/.*css$ #MASTER# UNBLOCK-REFERRER: http://idonthateyouall.imeem.com/video/8zH0_f9i/kiley_rilo_pull_me_in_tighter_art_video/ # URL = http://ad.doubleclick.net/crossdomain.xml ad.doubleclick.net/crossdomain.xml -#MASTER# REMARKS: Support request 2838390: 2009-08-16: nfl.com videos not working -#MASTER# REMARKS: bbc.co.uk videos references ad.uk.doubleclick.net -# URL = http://ad.doubleclick.net/879366/DartShell9_8.swf?adServerHost=http://ad.doubleclick.net -# URL = http://ad.doubleclick.net/pfadx/DARTSHELLCONFIGXML;dcmt=text/xml; -# URL = http://ad.doubleclick.net/879366/DartShellPlayer9_8_01_00.swf -# URL = http://ad.uk.doubleclick.net/879366/DartShell7_7.swf?adServerHost=http://ad.uk.doubleclick.net -.doubleclick.net/.*/DartShell.*.swf -.doubleclick.net/.*/DARTSHELLCONFIGXML #MASTER# REMARKS: Actionsfile feedback item #2021509 2008-07-18 #MASTER# REMARKS: Allow realplayer site help popup windows #MASTER# UNBLOCK-REFERRER: http://real.custhelp.com/cgi-bin/real.cfg/php/enduser/std_adp.php?p_faqid=4512 @@ -1724,8 +1594,7 @@ fritz.box/ # URL = http://kb.adobe.com/selfservice/viewContent.do?externalId=kb402747&sliceId=1 .adobe.com # URL = http://qa.debian.org/popcon.php -# URL = http://qa.debian.org/popcon-png.php?packages=privoxy&show_installed=on&want_legend=on&want_ticks=on&date_fmt=%25Y-%25m&beenhere=1 -qa.debian.org/popcon +qa.debian.org/popcon.php #MASTER# REMARKS: Support Requests item #2432535 2008-12-16 # URL = http://www.mta.info/bandt/traffic/advmain.htm .mta.info/.*advmain.htm$ @@ -1751,65 +1620,6 @@ qa.debian.org/popcon # URL = http://graphics8.nytimes.com/css/0.1/screen/common/ads.css # URL = http://graphics8.nytimes.com/css/0.1/screen/homepage/ads.css .nytimes.com/.*/ads.css$ -#MASTER# REMARKS: All hosted videos seemingly require this file. -#MASTER# UNBLOCK-REFERRER: http://www.cnn.com/video/#/video/showbiz/2009/04/14/dcl.boyle.british.talent.show.cnn -# URL = http://i.cdn.turner.com/cnn/.element/js/2.0/video/xmp/AdServiceAdapter.swf -.turner.com/cnn/.*/AdServiceAdapter.swf -#MASTER# REMARKS: Tracker 2786745 : MySpace music player doesn't work -#MASTER# UNBLOCK-REFERRER: www.myspace.com/bandofskulls -# URL = http://lads.myspacecdn.com/videos/musicPlayerAssets.swf -lads.myspacecdn.com/ -#MASTER# REMARKS: AF#2789653 iTunes download blocked -# URL = http://a957.phobos.apple.com/us/r1000/000/Music/ad/47/56/mzi.gnjsyarh.aac.a.m4p -.phobos.apple.com/ -# URL = http://eas8.emediate.eu/eas?camp=114;ty=ct;EASLink=http://www.jp.dk -.emediate.eu/.*EASLink= -#MASTER# REMARKS: Actionfile tracker ID: 2838501: 2009-08-16 -# URL = http://new.meteo.pl/advajax.js -.meteo.pl/advajax.js -# URL = http://www.adressa.no/ -# URL = http://adressa.no/ -adressa.no/ -# URL = http://www.adresseavisen.no/ -# URL = http://adresseavisen.no/ -adresseavisen.no/ -# URL = http://apps.facebook.com/onthefarm/track.php?creative=&cat=friendvisit&subcat=weeds&key=a789a971dc687bee4c20c044834fabdd&next=index.php%3Fref%3Dnotif%26visitId%3D898835505 -.facebook.com/.*/track.php -# URL = http://www.ifdb.tads.org/ -# URL = http://www.tads.org/ -.tads.org/ -# URL = http://adtoma.com/ -adtoma.com/ -#MASTER# REMARKS: Actionsfile feedback 2859872 2009-09-16 09:58 -# URL = http://adactio.com/ -adactio.com/ -# URL = http://www.peereboom.us/adsuck/ -www.peereboom.us/adsuck/ -# URL = http://www.svd.se/template/ver1-0/css/ads.css?v=194 -.svd.se/.*.css($|?) -#MASTER# REMARKS: [privoxy-users] Privoxy blocking Ebay item pictures Jan 31, 2010 -#MASTER# REMARKS: Ebay enlarge picture function doesn't work. -# URL = http://include.ebaystatic.com/v4js/en_GB/e637i/SYS-LIGER_Omniture_e637i10177164_5_en_GB.js -include.ebaystatic.com/.*omniture.*.js -#MASTER# REMARKS: Allow Yahoo news and mail javascipt pages -# URL = http://l.yimg.com/d/combo?news/p/common/generic/news/p/common/generic/popular-searches-min-12622.js&news/p/common/generic/ads-min-11050.js&news/p/common/generic/foundation/popup-min-12622.js -.yimg.com/d/combo? -#MASTER# REMARKS: Page formatting problems when .css files are blocked -# URL = http://www.networkworld.com/includes/styles/adstyles.css -# URL = http://www.sj.se/common/css/pop.css -# URL = http://l.yimg.com/d/combo?news/p/common/generic/ads-min-24248.css&news/p/common/generic/widgets-min-10270.css -# URL = http://news.zdnet.com/css/z/ads/hs.css -/.*.css$ -#MASTER# REMARKS:Actionsfile feedback item #2974204 2010-03-21 -# URL = http://adesklets.sourceforge.net/ -adesklets.sourceforge.net/ -#MASTER# REMARKS: Mostly-french political blog -# URL = http://adassier.wordpress.com/ -adassier.wordpress.com/ -# URL = http://adassier.files.wordpress.com/2010/05/road-to-economic-recovery2.jpg?w=630&h=451 -adassier.files.wordpress.com -# URL = http://adainitiative.org/about-us/ -adainitiative.org/
############################################################################# @@ -1831,7 +1641,17 @@ images.apple.com #MASTER# REMARKS: Actions Tracker 1293057 09/02/06 .update.microsoft.com #MASTER# REMARKS: Various reports 09/16/06. This site also requires pop-ups. -mail.google.* +mail.google. + +#---------------------------------------------------------------------------- +# Semi-fragile, allow for blocks. +#---------------------------------------------------------------------------- +{ -crunch-all-cookies -filter -fast-redirects -hide-referer -prevent-compression } +#MASTER# REMARKS: Problem URL: adserver.yahoo.com 10/01/06 +#MASTER# REMARKS: This is much too broad for my taste. It forces me to add +#MASTER# REMARKS: a special yahoo section in my user.action file, just to +#MASTER# REMARKS: confirm my defaults in default.action. fk 2007-01-19 +.yahoo.com
#---------------------------------------------------------------------------- # Shopping and banking sites - allow cookies and pop-ups @@ -1844,7 +1664,7 @@ mail.google.* .dabs.com .overclockers.co.uk .db24.de -.ebay.* +.ebay. .mobile.de www.fondationlejeu.com www.techtv.com @@ -1893,21 +1713,21 @@ i.cnn.net/cnn/.*/clickability/button # Sticky Actions = -fast-redirects www.ukc.ac.uk/cgi-bin/wac.cgi? #MASTER# PROBLEM-URL: http://www.google.com/search?q=foo -# URL = http://www.google.com/search?q=foo -.google.* +.google. #MASTER# PROBLEM-URL: http://de.altavista.com/q?pg=q&q=foo&kl=XX&search.x=28&search.y=8&what=web .altavista.com/(.*(like|url|link):|trans.*urltext=)http #MASTER# PROBLEM-URL: http://www.speedfind.de/cgi-bin/search?q=foo&t=STANDARD .speedfind.de #MASTER# PROBLEM-URL: http://www.nytimes.com/ .nytimes.com -#MASTER# REMARKS: Disable fast-redirects for all of yahoo.com/. -#MASTER# REMARKS: Apparently we can't keep up with maintaining more precise exceptions. -# URL = http://login.yahoo.com/config/login?logout=1&.done=http://mail.yahoo.com&.src=ym&.intl=us +#MASTER# REMARKS: Yahoo logout URL after first redirect. fk 2007-01-19 +#MASTER# REMARKS: Logout fails if we fast-redirect to the URL after "done=". #MASTER# REMARKS: Reported in support request #1635354. -# URL = http://us.rd.yahoo.com/reg/login1/lisu/login/uk/ym/*http://edit.europe.yahoo.com/c onfig/login?.tries=1&.src=ym&.md5=&.hash=&.js=1&.last=&...kP=Y&.done=http://mail .yahoo.com&.pd=ym_ver=0&c=&login=XXX&passwd=XXX&.persistent =&.hash=1&.md5=1.yahoo.com/ +# URL = http://login.yahoo.com/config/login?logout=1&.done=http://mail.yahoo.com&.src=ym&.intl=us +.yahoo.com/.*done=http #MASTER# REMARKS: Reported in support request #1802365. -.yahoo.com/ +# URL = http://us.rd.yahoo.com/reg/login1/lisu/login/uk/ym/*http://edit.europe.yahoo.com/c onfig/login?.tries=1&.src=ym&.md5=&.hash=&.js=1&.last=&...kP=Y&.done=http://mail .yahoo.com&.pd=ym_ver=0&c=&login=XXX&passwd=XXX&.persistent =&.hash=1&.md5=1 +.rd.yahoo.com/reg/login1/ # URL = http://validator.w3.org/check .w3.org #MASTER# PROBLEM-URL: http://www.ask.com/ @@ -1974,23 +1794,6 @@ view.samurajdata.se/ps.php?url= .landsend.de/ # URL = http://www.youtube.com/swf/l.swf?swf=http%3A//s.ytimg.com/yt/swf/cps-vfl68942.swf&video_id=2cpd6rHIfyA&rel=1&showsearch=1&eurl=&iurl=http%3A//i3.ytimg.com/vi/2cpd6rHIfyA/hqdefault.jpg&sk=5E3I2RCcOLknk1qyI_JgVVnb8FKwgpHzC&use_get_video_info=1&load_modules=1&fs=1&hl=en .youtube.com/swf/.*swf= -# URL = http://redbot.org/?uri=http%3A//apache.org/ -.redbot.org/ -# URL = http://webcache.googleusercontent.com/custom?hl=en&domains=library.gnome.org&sitesearch=library.gnome.org&q=cache:8yGDJ1YpefcJ:http://library.gnome.org/devel//gtk/2.20/GtkLabel.html+gtk_label_set_text+escape&ct=clnk -webcache.googleusercontent.com/ -# URL = http://webcache.googleusercontent.com/search?q=cache:kZYcDFibjHcJ:https://grepular.com/Abusing_HTTP_Status_Codes_to_Expose_Private_Information+inurl:https://grepular.com/Abusing_HTTP_Status_Codes_to_Expose_Private_Information&hl=en&strip=1 -.googleusercontent.com/.*=cache: - -{+redirect{s@.*url=@http://@} -block} -# Sticky Actions = +redirect -block -# URL = http://go.eniro.dk/lg/ni/http:/eas8.emediate.eu/eas?camp=79;ty=ct;EASLink=http://www.bt.dk?http://redirect.metropol.dk/cgi-bin/redir.pl?url=www.bt.dk -# URL = http://eas8.emediate.eu/eas?camp=79;ty=ct;EASLink=http://www.bt.dk?http://redirect.metropol.dk/cgi-bin/redir.pl?url=www.bt.dk -# Redirected URL = http://go.eniro.dk/lg/ni/http:/eas8.emediate.eu/eas?camp=79;ty=ct;EASLink=http://www.bt.dk?http://redirect.metropol.dk/cgi-bin/redir.pl?url=www.bt.dk -# Redirect Destination = http://www.bt.dk -# Redirected URL = http://eas8.emediate.eu/eas?camp=79;ty=ct;EASLink=http://www.bt.dk?http://redirect.metropol.dk/cgi-bin/redir.pl?url=www.bt.dk -# Redirect Destination = http://www.bt.dk -go.eniro.dk/.*EASLink=http://.*url=(?!<=http:) -.emediate.eu/.*EASLink=http://.*url=(?!<=http:)
#---------------------------------------------------------------------------- # No filtering for sourcecode or other automatically parsed content @@ -2135,10 +1938,6 @@ javabog.dk/ijk/ .fsfe.org/ # URL = http://www.couchsurfing.com/mapsurf.html .couchsurfing.com/ -# URL = http://www.couchsurfing.org/mapsurf.html -.couchsurfing.org/ -# URL = http://www.thinkgeek.com/tshirts-apparel/unisex/generic/ -.thinkgeek.com/
{-filter{banners-by-link}} # Sticky Actions = -filter{banners-by-link} @@ -2153,6 +1952,9 @@ javabog.dk/ijk/ #MASTER# REMARKS: This section NOT checked 10/18/06 HB #MASTER# REMARKS: These are movie clips, linked from http://us.imdb.com .totaleclips.com +#MASTER# REMARKS: Link to download page breaks +# URL = http://www.mandrakelinux.com/en/ftp.php3 +.mandrakelinux.com/en/ftp.php3 #MASTER# REMARKS: Actions Tracker 1313157 # URL = http://validator.w3.org/check?uri=referer validator.w3.org/check?uri=referer @@ -2271,37 +2073,22 @@ blogs.msdn.com # URL = http://blogs.msdn.com/wga/archive/2006/07/16/667063.aspx blogs.msdn.com
-{-filter{jumping-windows}} -# Sticky Actions = -filter{jumping-windows} -# URL = http://www.openstreetmap.org -.openstreetmap.org - {+fast-redirects{check-decoded-url} -block} # Sticky Actions = +fast-redirects{check-decoded-url} -block #MASTER# REMARKS: Yahoo search results. Added 2007-01-19 fk #MASTER# REDIRECT-REFERRER: http://search.yahoo.com/search?p=privoxy # URL = http://rds.yahoo.com/_ylt=A0geuryczbBF._YAEmxXNyoA;_ylu=X3oDMTB2b2gzdDdtBGNvbG8DZQRsA1dTMQRwb3MDMQRzZWMDc3IEdnRpZAM-/SIG=11b3qg40n/EXP=1169301276/**http%3a//www.privoxy.org/ rds.yahoo.com/ -# Redirected URL = http://rds.yahoo.com/_ylt=A0geuryczbBF._YAEmxXNyoA;_ylu=X3oDMTB2b2gzdDdtBGNvbG8DZQRsA1dTMQRwb3MDMQRzZWMDc3IEdnRpZAM-/SIG=11b3qg40n/EXP=1169301276/**http%3a//www.privoxy.org/ -# Redirect Destination = http://www.privoxy.org/ +#MASTER# COMMENTS: Verified 2007-01-19 fk #MASTER# REDIRECT-REFERRER: http://www.gamefaqs.com/computer/doswin/game/914819.html # URL = http://dw.com.com/redir?asid=0&astid=8&siteid=19&edid=107&destCat=33862&destURL=http%3A%2F%2Fdb.gamefaqs.com%2Fcomputer%2Fdoswin%2Ffile%2Fvampire_tmb_b.txt -dw.com.com/redir? -# Redirected URL = http://dw.com.com/redir?asid=0&astid=8&siteid=19&edid=107&destCat=33862&destURL=http%3A%2F%2Fdb.gamefaqs.com%2Fcomputer%2Fdoswin%2Ffile%2Fvampire_tmb_b.txt -# Redirect Destination = http://db.gamefaqs.com/computer/doswin/file/vampire_tmb_b.txt +dw.com.com/ #MASTER# REMARKS: Action tracker 1593393. Added 2007-01-20. # URL = http://wzus.bloglines.com/r?t=a&d=us&s=bl&c=blen&ti=1&ai=51060&l=dir&o=0&sv=z6f537f5b&ip=971AC44B&u=http%3A%2F%2Fwww.skweezer.net%2Fbloglines%2Fskweeze.aspx%3F%26i%3Dd%26l%3Den%26r%3Dhttp%253A%252F%252Fwww.bloglines.com%252Fmyblogs_display%253Fsub%253D29302699%2526site%253D5382440%26url%3Dhttp%253A%252F%252Fpermalink.gmane.org%252Fgmane.linux.debian.devel.changes.unstable%252F97340 -# Redirected URL = http://wzus.bloglines.com/r?t=a&d=us&s=bl&c=blen&ti=1&ai=51060&l=dir&o=0&sv=z6f537f5b&ip=971AC44B&u=http%3A%2F%2Fwww.skweezer.net%2Fbloglines%2Fskweeze.aspx%3F%26i%3Dd%26l%3Den%26r%3Dhttp%253A%252F%252Fwww.bloglines.com%252Fmyblogs_display%253Fsub%253D29302699%2526site%253D5382440%26url%3Dhttp%253A%252F%252Fpermalink.gmane.org%252Fgmane.linux.debian.devel.changes.unstable%252F97340 -# Redirect Destination = http://www.skweezer.net/bloglines/skweeze.aspx?&i=d&l=en&r=http%3A%2F%2Fwww.bloglines.com%2Fmyblogs_display%3Fsub%3D29302699%26site%3D5382440&url=http%3A%2F%2Fpermalink.gmane.org%2Fgmane.linux.debian.devel.changes.unstable%2F97340 .bloglines.com/r? www.skweezer.net/bloglines # URL = http://media.fastclick.net/w/get.media?sid=4681&m=5&tp=6&url=http%3A//www.sciam.com/article.cfm%3FchanID%3Dsa003%26articleID%3DC7C87ECC-E7F2-99DF-39AEFF3D7D1A8CFB%26ref%3Drss -# Redirected URL = http://media.fastclick.net/w/get.media?sid=4681&m=5&tp=6&url=http%3A//www.sciam.com/article.cfm%3FchanID%3Dsa003%26articleID%3DC7C87ECC-E7F2-99DF-39AEFF3D7D1A8CFB%26ref%3Drss -# Redirect Destination = http://www.sciam.com/article.cfm?chanID=sa003&articleID=C7C87ECC-E7F2-99DF-39AEFF3D7D1A8CFB&ref=rss .fastclick.net/w/get.media? -# Redirected URL = http://www.awin1.com/cread.php?awinmid=2891&awinaffid=43305&clickref=&p=http://www.groupon.co.uk/ -# Redirect Destination = http://www.groupon.co.uk/ -.awin1.com/.*=http://
{+block{Looks like an anti-leech trigger URL.}} #MASTER# COMMENTS: This section not checked 10/17/06 HB. Still out there? @@ -2309,6 +2096,9 @@ www.skweezer.net/bloglines #MASTER# REMARKS: Lame attempt at banning ad-blockers. Used by other websites as well. /antitheft.php
+{ +prevent-compression } +.compusa.com/ + {+filter{tiny-textforms}} .sourceforge.net/tracker
@@ -2326,8 +2116,6 @@ www.skweezer.net/bloglines {+redirect{http://config.privoxy.org/}} # Sticky Actions = +redirect{http://config.privoxy.org/} # URL = http://www.privoxy.org/config -# Redirected URL = http://www.privoxy.org/config -# Redirect Destination = http://config.privoxy.org/ .privoxy.org/config
#MASTER# REMARKS: Privoxy's "unsafe" CGI pages check the referrer @@ -2349,28 +2137,8 @@ config.privoxy.org/ # XXX: Privoxy-Regression-Test currently doesn't allow backslashes. # Sticky Actions = -fast-redirects +redirect # URL = http://us.ard.yahoo.com/SIG=AAAAAAAAA/M=NNNNNN.NNNNNNN.NNNNNNN.NNNNNNN/D=mail/S=NNNNNNNNN:HEADR/Y=YAHOO/EXP=NNNNNNNNNN/A=NNNNNNN/R=N/SIG=AAAAAAAAA/*http://login.yahoo.com/config/login?logout=1&.done=http://mail.yahoo.com&.src=ym&.intl=us -# Redirected URL = http://us.ard.yahoo.com/SIG=AAAAAAAAA/M=NNNNNN.NNNNNNN.NNNNNNN.NNNNNNN/D=mail/S=NNNNNNNNN:HEADR/Y=YAHOO/EXP=NNNNNNNNNN/A=NNNNNNN/R=N/SIG=AAAAAAAAA/*http://login.yahoo.com/config/login?logout=1&.done=http://mail.yahoo.com&.src=ym&.intl=us -# Redirect Destination = http://login.yahoo.com/config/login?logout=1&.done=http://mail.yahoo.com&.src=ym&.intl=us .yahoo./.*http://login.yahoo.com/config/login.*http://
-#MASTER# REMARKS: The next two sections are to get flickr's Ajax interface working -#MASTER# REMARKS: with default pre-settings. For more aggressive defaults they additionally -#MASTER# REMARKS: need -crunch-incoming-cookies and -crunch-outgoing-cookies. -#MASTER# REMARKS: They work with +session-cookies-only, though. -{-block -filter} -#MASTER# PROBLEM-URL: http://www.flickr.com/ -# Sticky Actions = -block -filter -# URL = http://l.yimg.com/g/combo/1?event-custom/event-custom-min.js&event/event-min.js&j/.H-.K.A.vNKEa&j/.CP-.U-.DE.A.vKEJz&j/.J_.BR_.CA.A.vKYkg&j/.J_.DB.A.vPpBT&j/popup-login.A.vR53Z&dump/dump-min.js&datatype/datatype-xml-min.js&substitute/substitute-min.js&json/json-min.js&queue-promote/queue-promote-min.js&io/io-min.js&j/.J_.DS.A.vQa28&j/.FW-.FX-.GH.A.vP3XB&j/grease.A.vRktP&j/.CC.A.vNiA6&j/.C-.BL.A.vPPj2&j/.CE-.K.A.vNy32&attribute/attribute-base-min.js&base/base-min.js&anim/anim-min.js&cookie/cookie-min.js&j/.B-.C-.F.A.vQ7SZ&j/urls.A.vQtXp&j/.B-.BY.A.vQCXP&j/.H-.BY.A.vQXXx&j/.DS-value-conversions.A.vQpRt&j/.G-.BD.A.vNHSH&event/event-synthetic-min.js&j/.G-.BO.A.vNwR4&j/.CV-.CH.A.vPFSZ&j/.X-.W-.C-.F.A.vKPQa&j/.X-.W-.D.A.vQXXx&j/.Q-.BX-.K.A.vR1kt&j/.DL.A.vLPjD&j/.CF.A.vNC24&j/.CX-.CY.A.vP8ND&event-simulate/event-simulate-min.js&node/node-event-simulate-min.js&j/.B-.T-.CI-.C-.F.A.vPJPF&j/.CM/.BA_2.5.1-.D.A.vPzui&j/bo-.S-.C-.F.A.vNwWe&j/bo-.S-.D.A.vR6Hx&j/.BZ-.D.A.vNstB&j/.B- .L-.C-.F.A.vNxPX&j/.B-.L-.BH.A.vMdVB&j/.CN-.DD.A.vLjJ2&j/.B-.O-.C-.F.A.vPpcK&j/.BM.A.vKPmz&j/.B-.O.A.vQyHg&j/.B-.H-.BB-.C-.F.A.vQvrB&j/.CW-.CU.A.vQ7Rg&j/.Y-.C-.F.A.vNqGa&j/.Y.A.vLKiT&j/.B-.M-.C-.F.A.vQxDc&j/.U-.CG.A.vQ5Tt&j/.B-.M.A.vQXXx&j/.B-.Q-.BQ.A.vQvTt&j/.B-.N-.C-.F.A.vQaRp&j/.CL.A.vN4N6&j/.B-.CL-.BW.A.vPwkx&j/.DR-.DG.A.vMLJr&j/.B-.BE-.C-.F.A.vPHP4&j/.B-.BE-.D.A.vQLQH&j/.BV.A.vm3Uz&j/.Z-.DK-.D.A.vLQEe&j/.Z-.DJ-.BJ.A.vLQEe&j/.B-.I-.C-.F.A.vPKTK&stylesheet/stylesheet-min.js&j/.B-.I.A.vQvDF&j/.CM-.DO.A.vPboD&j/.B-.D.A.vRbv8&j/.B-.H-.BB.A.vQuhn&j/.B-.N.A.vR6Cn&j/.B-.L-.CZ.A.vQmzP&j/.B-.T-.CI.A.vQXXx&j/.B-.I-.CQ-.BK-.C-.F.A.vNwZF&j/.B-.I-.CQ-.BK.A.vLWQR&j/.B-.R-.C-.F.A.vPfwi&j/.B-.R.A.vRhND&j/.DN-.BB-.D-.C-.F.A.vQXZg&j/.DN-.BB-.D.A.vRcXB&j/.BF_.D-.C-.F.A.vPGYM&j/.BF_.D.A.vQxJn&plugin/plugin-min.js&cache/cache-min.js&j/.CB-.C-.F.A.vNwWe&j/.CB-.D.A.vQS6T -.yimg.com/g/combo/1?event-custom/ - -{-block -filter{content-cookies}} -#MASTER# PROBLEM-URL: http://www.flickr.com/ -{-filter{content-cookies}} -# Sticky Actions = -block -# URL = http://www.flickr.com/ -.flickr.com/ - - #---------------------------------------------------------------------------- # Sections that modify the action settings based on tags. #---------------------------------------------------------------------------- diff --git a/external/privoxy/default.filter b/external/privoxy/default.filter index 17c9fa6..3537c7b 100644 --- a/external/privoxy/default.filter +++ b/external/privoxy/default.filter @@ -2,11 +2,11 @@ # # File : $Source: /cvsroot/ijbswa/current/default.filter,v $ # -# $Id: default.filter,v 1.83 2011/10/16 14:01:05 fabiankeil Exp $ +# $Id: default.filter,v 1.71 2009/03/01 18:33:17 ler762 Exp $ # # Purpose : Rules to process the content of web pages # -# Copyright : Written by and Copyright (C) 2001-2010 the +# Copyright : Written by and Copyright (C) 2001-2009 the # Privoxy team. http://www.privoxy.org/ # # We value your feedback. However, to provide you with the best support, @@ -128,15 +128,15 @@ s/(open\s*([^)]+always(?:raised|lowered)=)(["']?)(?:yes|1)\2/$1$2no$2/sigU
################################################################################# # -# js-events: Kill JavaScript event bindings and timers (Radically destructive! Only for extra nasty sites). +# js-events: Kill all JS event bindings and timers (Radically destructive! Only for extra nasty sites). # ################################################################################# -FILTER: js-events Kill JavaScript event bindings and timers (Radically destructive! Only for extra nasty sites). +FILTER: js-events Kill all JS event bindings and timers (Radically destructive! Only for extra nasty sites).
s/(on|event.)((mouse(over|out|down|up|move))|(un)?load|contextmenu|selectstart)/never/ig # Not events, but abused on the same type of sites: s/(alert|confirm)\s*(/concat(/ig -s/set(timeout|interval)(/concat(/ig +s/settimeout(/concat(/ig
################################################################################# # @@ -177,15 +177,15 @@ s|<meta\s+http-equiv=['"]?set-cookie.*>|<!-- ZappedCookie -->|igU
################################################################################# # -# refresh-tags: Kill automatic refresh tags if refresh time is larger than 9 seconds. +# refresh-tags: Kill automatic refresh tags (for dial-on-demand setups). # ################################################################################# -FILTER: refresh-tags Kill automatic refresh tags if refresh time is larger than 9 seconds. +FILTER: refresh-tags Kill automatic refresh tags (for dial-on-demand setups).
# Note: Only deactivates refreshes with more than 9 seconds delay to # preserve monster-stupid but common redirections via meta tags. # -s@<meta\s+http-equiv\s*=\s*(['"]?)refresh\1\s+content\s*=\s*(['"]?)\d{2,}\s*(;(?:\s*url\s*=\s*)?([^>\2]*))?\2@<link rev="x-refresh" href="$4"@ig +s/<meta\s+http-equiv\s*=\s*(['"]?)refresh\1\s+content\s*=\s*(['"]?)\d{2,}\s*(;\s*url\s*=\s*([^>\2]*))?\2/<link rev="x-refresh" href="$4"/iU
################################################################################# @@ -422,7 +422,7 @@ FILTER: fun Text replacements for subversive browsing fun!
# SCNR # -s/microsoft(?!.[^\s])/MicroSuck/ig +s/microsoft(?!.[^\s])/MicroSuck/ig
# Buzzword Bingo (example for extended regex syntax) # @@ -580,9 +580,7 @@ s@</head>@<style type="text/css">\n\ #fbc, #fbl, #ra, .rhh {visibility: hidden !important;}\n\ #tpa1,#tpa2,#tpa3,#tpa4,#tpa5,#tpa5, #spl, .ch, #ads,\ #toolbar, #google_ads_frame, #mbEnd {display: none !important;}\n\ - .main_body, .j, #res, .med, .hd, .g, .s\n\ - {width: 99%; max-width: 100%; margin-left: 0; margin-right: 0;}\n\ - </style>\n$0@ + .main_body, .j {width: 100%}\n</style>\n$0@ s@<div style="padding-top:11px;min-width:500px">@<div id="main_body">@ s@(<table cellspacing=0 cellpadding=0 width=25% align=right bgcolor=#ffffff border=0\ |</font></td></tr></tbody></table><table align="right" bgcolor="#ffffff"\ @@ -602,12 +600,9 @@ s@</head>@\n<style type="text/css">\n\ /* Style sheet inserted by Privoxy's yahoo filter. */\n\ #symadbn, #ymadbn, .yschbox, .yschhd, .bbox, #yschsec, #sec,\ #yschanswr, .yschftad, .yschspn, .yschspns, #ygrp-sponsored-links,\ - #nwad, #MWA2, #MSCM, #yregad, #sponsored-links,\ - #ks-ypn-ads, .ad, #east, #ygrp-vital, .ads {display: none !important;}\n\ - #yschpri, #yschweb, #pri, #web, #main, .yschttl, .abstr, .res \n\ - {width: 99% !important; max-width: 100% !important;}\n\ - .yschttl, .res, .res.indent, #web {padding: 0px; margin: 0px !important;}\n\ - #web {padding-left: 0.5em}\n\ + #nwad, #MWA2, #MSCM, #yregad, \ + #ks-ypn-ads, .ad, #east, #ygrp-vital {display: none !important;}\n\ + #yschpri, #yschweb, #pri, #web, #main {width: 100% !important; max-width: 100% !important;}\n\ #yschqcon, #yschtg {width: auto !important; /* No useless horizontal scrollbar please */}\n\ #composebox #compose_editorArea {width: 70% !important; /* reasonably sized reply textarea please */\n\ </style>\n$0\n@ @@ -626,15 +621,12 @@ s@</head>@<style type="text/css">\n\ /* Style sheet inserted by Privoxy's msn filter. */\n\ .msn_ads, #at, #ar, .mktmsg {display: none !important;}\n\ #results, .flank, .results_area_flank, .results_area_stroke,\n\ - #results_area, #content, .sb_tlst, .sa_cc, .sb_ph, #sw_main,\n\ + #results_area, .SearchSection, .not, .sc_rslth1\n\ .content, #sw_foot, #bf, #sw_content, #sidebar, #pag\n\ {width: 99% !important; min-width: 99% !important;\n\ max-width: 100% !important; /* width:100% sometimes causes horizontal scrollbars */}\n\ /* Remove "suggestions". They are next to worthless but partly overlap with the search results */\n\ .suggestion, #nys_right, #nys {clear: both; display:none;}\n\ - #s_notf_div,\n \ - /* Overlay ads to enable Facebook 'likes' in search results. */\n\ - .sn_container {display:none !important;}\n\ #content {padding-right: 0;}\n\ </style>\n$0@ # Are these ids still in use? @@ -769,34 +761,6 @@ s@^Accept:\s*text/css.*@CSS-REQUEST@i
################################################################################# # -# range-requests: Tags range requests as "RANGE-REQUEST". -# -# By default Privoxy removes Range headers for requests to -# ressources that will be filtered to make sure the filters -# get the whole picture. Otherwise Range requests could be -# intentionally used to circumvent filters or, less likely, -# filtering a partial response may damage it because it matched -# a pattern that the ressource as a whole wouldn't. -# -# Range requests can be useful and save bandwidth so instead -# of removing Range headers for requests to ressources that -# will be filtered, you may prefer to simply disable filtering -# for those requests. -# -# That's what this tagger is all about. After enabling it, -# you can disable filtering for range requests using the following -# action section: -# -# {-filter -deanimate-gifs} -# TAG:^RANGE-REQUEST -# -################################################################################# -CLIENT-HEADER-TAGGER: range-requests Tags range requests as "RANGE-REQUEST". - -s@^Range:.*@RANGE-REQUEST@i - -################################################################################# -# # client-ip-address: Tags the request with the client's IP address. # ################################################################################# @@ -870,3 +834,456 @@ s@^X-Privoxy-Control:\s*@@i SERVER-HEADER-FILTER: privoxy-control Removes X-Privoxy-Control headers.
s@^X-Privoxy-Control:.*@@i + + +############################################################################## +# +# Revisions : +# $Log: default.filter,v $ +# Revision 1.71 2009/03/01 18:33:17 ler762 +# couple of changes to the yahoo filter +# -get a bigger email message reply textarea +# -block a few more ads +# -remove the now useless northbanner css change +# +# Revision 1.70 2009/02/21 13:01:51 fabiankeil +# Make blogspot's feed magic slightly more reliable. +# +# Revision 1.69 2009/02/12 15:40:11 ler762 +# more yahoo email ad blocking +# +# Revision 1.68 2008/09/19 13:26:04 fabiankeil +# s@tounge@tongue@. Anonymously reported in #1648657. +# +# Revision 1.67 2008/08/06 17:38:06 fabiankeil +# In banners-by-size, make sure white-space around the height +# attribute is removed as well and replace two spaces with +# "\s" so we don't get fooled by tabs. Fixes #2036125. +# +# Revision 1.66 2008/08/03 17:27:47 fabiankeil +# Teach msn filter to catch a few new ad classes. +# +# Revision 1.65 2008/07/21 13:43:44 fabiankeil +# Fix img-reorder regression introduced with my last commit. +# Some tags were terminated too soon, letting the browser render +# some of their arguments as text. Oops. +# +# Revision 1.64 2008/07/12 15:49:09 fabiankeil +# - Don't let img-reorder touch width attributes +# that aren't followed by either whitespace or '>', +# as those usually indicate onclick nonsense. +# Problem and solution reported by Glenn Washburn in #2014552. +# - While at it, don't use more groups than necessary. +# +# Revision 1.63 2008/06/27 12:53:41 fabiankeil +# Make sure the taggers css-requests and image-requests +# only match at the beginning of the header. +# +# Revision 1.62 2008/06/21 17:02:03 fabiankeil +# Fix typo. +# +# Revision 1.61 2008/05/21 18:44:43 fabiankeil +# - Let the content-type tagger ignore headers without value. +# - Remove a few unused lines at the end of the file. +# +# Revision 1.60 2008/04/26 10:36:41 fabiankeil +# Let the msn filter hide another class. +# +# Revision 1.59 2008/04/23 16:18:18 fabiankeil +# s@declarded@declared@ +# +# Revision 1.58 2008/02/02 15:27:19 fabiankeil +# Yet another yahoo update to get the width limitation removal working again. +# +# Revision 1.57 2008/01/26 15:45:39 fabiankeil +# Don't let the less-download-windows filter mess up +# "Content-Type: application/x-shockwave-flash" headers. +# +# Revision 1.56 2008/01/25 19:12:40 fabiankeil +# - Add yet another new yahoo ad id. +# - Don't let the first banners-by-link job punish URLs for merely +# containing the pattern "/jump/" when it should really look for +# "doubleclick.net/jump/". +# +# Revision 1.55 2007/12/31 19:53:59 fabiankeil +# Let the msn filter remove the width limitation again. +# +# Revision 1.54 2007/12/31 19:11:31 fabiankeil +# - Let the yahoo filter remove the width limitation again. +# - Teach the blogspot filter to remove useless feed comment +# titles that only contain the beginning of the actual comment. +# +# Revision 1.53 2007/12/23 15:48:12 fabiankeil +# - Lo and behold, the CSS fix for the MSN buttons is no longer necessary. +# - Add some new selectors the msn filter should hide. +# - Add the two yahoo selectors Lee reported in #1856574. +# - Add comments that the width limitation fixes stopped +# working for the msn and yahoo filter. +# +# Revision 1.52 2007/11/27 18:35:48 fabiankeil +# Update CSS for the yahoo filter. +# +# Revision 1.51 2007/11/04 16:15:11 fabiankeil +# - Add client-header taggers: client-ip-address, +# http-method, allow-post, complete-url and user-agent. +# - Add server-header tagger: content-type. +# +# Revision 1.50 2007/11/03 15:05:30 fabiankeil +# Consistently use an empty line between the description and the PCRS code +# and end descriptions with dots. Patch submitted by Simon Ruderich. +# +# Revision 1.49 2007/11/03 14:29:41 fabiankeil +# Spelling fixes mostly submitted by Simon Ruderich. +# +# Revision 1.48 2007/10/17 18:11:32 fabiankeil +# Add privoxy-control header filters and taggers. +# +# Revision 1.47 2007/10/06 15:45:25 fabiankeil +# Let msn hide sponsored links in #at divs. +# +# Revision 1.46 2007/10/06 09:54:13 fabiankeil +# - Let msn hide sponsored links in #ar divs. +# - Teach banners-by-link not to block the graphs for sf's tracker statistics. +# +# Revision 1.45 2007/08/11 16:54:12 fabiankeil +# - Complete the changes from r1.42. +# - Make crude-parental less sensitive to the amount of white-space, +# add the note that it doesn't work too well again and replace the +# DMOZ link with a less confusing explanation. +# +# Revision 1.44 2007/07/18 11:06:56 hal9 +# Replace notarget with '' in all popups filter to keep from breaking xhmtl per +# report from Siegfried Gipp. +# +# Revision 1.43 2007/06/01 14:17:04 fabiankeil +# Mention possible delimiter conflicts with variables in dynamic pcrs commands. +# +# Revision 1.42 2007/05/17 15:55:36 fabiankeil +# Undo an improperly tested last-minute change +# and turn "text-requests" back into "css-requests". +# +# Revision 1.41 2007/05/17 15:45:41 fabiankeil +# - Mention new filter types and the 'D' option. +# - Header filters are now case-insensitive and accept a +# varying amount of whitespace after the colon. +# - Add another selector for yahoo ads. +# - New server-header filter: less-download-windows +# - New client-header taggers: text-requests and image-requests. +# +# Revision 1.40 2007/03/20 15:40:00 fabiankeil +# Adjust to new world order with dedicated header-filter actions. +# +# Revision 1.39 2007/02/21 14:10:23 fabiankeil +# - Fix a js-annoyances pcrs command that broke +# evaluated code. (BR #1124071, thanks to Bor Gergely) +# - Have unsolicited-popups and all-popups catch the +# wheather.com popup reported in in AF #1640173. +# +# Revision 1.38 2007/02/19 11:22:48 hal9 +# Adding back the orginal filter content to offset problems found by Fabian. +# +# Revision 1.37 2007/02/17 13:29:44 hal9 +# Updates to the crude parental filter per Feature Requests item #1648657. +# +# Revision 1.36 2007/02/05 16:47:31 fabiankeil +# - Let banners-by-link look for "advert". +# - Fix XML systax problems with banners-by-link +# and banners-by-size (AF#1651570). +# +# Revision 1.35 2006/12/21 12:28:12 fabiankeil +# Escaping special characters in filter descriptions is no +# longer necessary, it's done by Privoxy now. +# +# Revision 1.34 2006/12/12 17:32:23 fabiankeil +# Added id mbEnd to google filter, it's now and then +# used for the sponsored links. +# +# Have js-annoyances try to prevent status bar +# modifications where the status bar text is +# inside another variable. Fixes 1605710. +# +# Revision 1.33 2006/11/16 17:10:43 fabiankeil +# Removed webbugs debugging comment again. +# The apostrophe could break JavaScript and +# the comment itself could mess up existing +# comments. +# +# Revision 1.32 2006/11/10 18:04:04 fabiankeil +# Have no-ping print the ping warning in red. +# +# Modified yahoo to keep in sync with recent +# CSS changes and to suppress a useless horizontal +# scrollbar. +# +# msn now makes sure that the continue-link boxes +# act as links (the original CSS just changes the cursor). +# +# Changed fun filter regex to leave microsoft links alone. +# Fixes BR 1019996. +# +# Revision 1.31 2006/10/21 13:12:28 fabiankeil +# Added no-ping and hide-tor-exit-notation. +# +# Adjusted jumping-windows to break less. +# Fixes BR 1146134. +# +# Revision 1.30 2006/10/18 12:36:50 fabiankeil +# google filter now cleans Google groups as well. +# +# Revision 1.29 2006/10/11 14:03:17 fabiankeil +# Changed img-reorder regex to only move width +# attributes if they are following at least one +# whitespace. Fixes BR 1328455. +# +# Revision 1.28 2006/10/11 13:31:13 fabiankeil +# Added Anduin Withers' js-annoyances fix +# for not messing up escaped quotes. Fixes BR 999765. +# +# Improved blogspot filter to make it less likely that +# the blogspot banner at the top of the page is missed. +# +# Revision 1.27 2006/10/08 17:00:51 fabiankeil +# Modified webbugs filter to create a comment around the offending +# image instead of removing it entirely. +# +# Adjusted regex to only match if there's at least one whitespace +# before the width and height attributes. Makes it more likely that +# they are indeed attributes, and not part of the value of another attribute. +# Solves BR 1035587. +# +# Thanks to Martin Thomas for diagnosing the cause of the problem. +# +# Revision 1.26 2006/10/06 18:06:16 fabiankeil +# Added header filter x-httpd-php-to-html +# and reverted another img-reorder whitespace +# problem. +# +# Revision 1.25 2006/10/06 15:26:09 fabiankeil +# Bumped copyright year. +# +# Reverted parts of the last img-reorder change +# which were intended to remove superfluous whitespace +# but had the side effect to mess up some tags. +# +# Modified banners-by-size and banners-by-link to +# use border value "0" instead of "\0". Fixes BR 1100065. +# +# Revision 1.24 2006/10/06 11:25:31 fabiankeil +# Taught img-reorder not to break img tags +# with empty src attributes. Fixes BR 1089474. +# Thanks to Raphael Moll for reporting. +# +# Revision 1.23 2006/10/05 14:46:28 fabiankeil +# Replaced "<" in img-reorder's description with "<". +# +# Modified msn filter to tag ads with classes instead +# of ids. There may be more than one ad per page, +# but ids are required to be unique. +# +# Revision 1.22 2006/10/04 19:17:14 fabiankeil +# Incorportated Frédéric Crozat's ie-exploits +# modification to make it less trigger-happy. +# +# Modified blogspot filter to make .post-body +# scrollable if necessary. +# +# Revision 1.21 2006/10/02 16:21:14 fabiankeil +# Adjusted yahoo filter to hide .yschspns as well. +# Added header filters: html-to-xml and xml-to-html. +# +# Revision 1.20 2006/10/01 21:00:22 fabiankeil +# New site-specific filters: google, yahoo, msn and blogspot. +# +# Revision 1.19 2006/07/18 14:48:45 david__schmidt +# Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +# with what was really the latest development (the v_3_0_branch branch) +# +# Revision 1.11.2.23 2004/02/17 13:34:01 oes +# - Beefed up the protection of the unsolicited-popups +# filter against matching in JavaScript string constants. +# - Extended the fun filter with a German joke +# - Extended the site-specifics filter with a convenience +# reeplacement for managing mailing lists at SourceForge +# +# Revision 1.11.2.22 2004/01/30 15:29:29 oes +# Updated the copyright note +# +# Revision 1.11.2.21 2004/01/20 15:15:01 oes +# Detail enhancement in all-popups +# +# Revision 1.11.2.20 2004/01/06 16:46:14 oes +# Fixed a JS syntax problem in jumping-windows +# +# Revision 1.11.2.19 2003/12/17 17:09:25 oes +# Added remedy against IE address bar spoofing +# +# Revision 1.11.2.18 2003/12/02 11:25:27 oes +# Fixed a line trashed in previous commit +# +# Revision 1.11.2.17 2003/12/01 21:58:46 oes +# Assorted tuning: +# +# - unsolicited-popups no longer matches at start or end of quoted +# strings, and is now activated earlier and deactivated later in +# the page. +# - replacement images in banners-by-* now without border +# - more effective shockwave flash flattening +# - Custom annoyance filtering for Yahoo Groups, Monster.com, NY Times. +# +# Revision 1.11.2.16 2003/05/08 09:44:56 oes +# Allow extra parameters in blink,marquee tags. Fixes bug #734012 +# +# Revision 1.11.2.15 2003/03/30 13:57:08 oes +# Making unsolicited-popups safe for use on <html> tags enclosed in JS strings +# +# Revision 1.11.2.14 2003/03/19 13:17:50 oes +# - Added filter "site-specifics" to address site specific problems +# - Fixed a small problem in the img-reorder filter +# +# Revision 1.11.2.13 2003/03/18 19:28:59 oes +# Fixed a minor problem in the img-reorder filter +# +# Revision 1.11.2.12 2003/03/15 14:06:58 oes +# - Assorted refinements, optimizations and fixes in the js-annoyances, +# img-reorder, banners-by-size, banners-by-link, webbugs, refresh-tags, +# html-annoyances, content-cookies and fun filters +# - Replaced filter "popups" by choice between two modes: +# - "unsolicited-popups" tries to catch only the unsolicited ones +# - "all-popups" tries to kill them all (as before) +# - New filter "tiny-textforms" Help those tiny or hard-wrap textareas. +# - New filter "jumping-windows" that prevents windows from resizing +# and moving themselves +# - Replaced "nimda" with more general "ie-exploits" filter in which +# all filters for exploits shall be collected +# +# Revision 1.11.2.11 2002/11/12 16:14:43 oes +# Exchanged js-annoyance filter against status bar rewrites with improved version by Don Libes +# +# Revision 1.11.2.10 2002/11/11 13:39:47 oes +# Make refresh-tags filter work even on incorrect refresh tags like found on usatoday.com +# +# Revision 1.11.2.9 2002/11/08 16:39:17 oes +# Made img-reorder more cautious. Fixes bug #632715 +# +# Revision 1.11.2.8 2002/10/13 21:56:52 hal9 +# Adding demoronizer filter. This should include all the common abuses. I have +# left a few of the rare cases commented out (never found these in the wild). +# +# Revision 1.11.2.7 2002/09/25 15:09:39 oes +# Preserve original quoting style in <img> tags wherever possible. Fixes Bug #605956 +# +# Revision 1.11.2.6 2002/08/23 14:12:26 oes +# Proofed frameset-borders against "fremaborder=0 border=0" +# +# Revision 1.11.2.5 2002/08/22 15:05:20 oes +# Added Filter to make Quicktime movies saveable (thanks to aaron@linville.org for the idea) +# +# Revision 1.11.2.4 2002/08/10 11:32:29 oes +# Attribute values in replacement tags of banners-by-size filter now undelimited. (Fixes bug #592493) +# +# Revision 1.11.2.3 2002/08/05 11:43:56 oes +# Fixed a bug in the popups filter that was introduced with the last fix :-( +# +# Revision 1.11.2.2 2002/08/01 11:20:13 oes +# Fixed bugs 587802, 577802 and an unreported one +# +# Revision 1.11.2.1 2002/07/26 15:18:26 oes +# - All filters reviewed and many shorcomings fixed +# - New filters: img-reorder, banners-by-link and js-events +# - Jobs reorderd because they are now executed in order of +# appearance +# +# Revision 1.11 2002/05/24 00:57:18 oes +# Made WeBugs job ungreedy; Fixes bug 559190 +# +# Revision 1.10 2002/04/18 10:14:19 oes +# renamed some filters +# +# Revision 1.9 2002/04/11 07:36:35 oes +# Generalized js-popup filter +# +# Revision 1.8 2002/04/10 17:07:21 oes +# Fixed potentially desctructive jobs, added noflash filter +# +# Revision 1.7 2002/04/09 18:34:51 oes +# Fixed HTML syntax in replacements +# +# Revision 1.6 2002/04/03 19:49:52 swa +# name change +# +# Revision 1.5 2002/03/27 15:30:26 swa +# have a consistent appearance +# +# Revision 1.4 2002/03/26 22:29:54 swa +# we have a new homepage! +# +# Revision 1.3 2002/03/24 16:08:03 jongfoster +# Fixing banners-by-size for new config URLs +# +# Revision 1.2 2002/03/24 13:02:18 swa +# name change related issues. +# +# Revision 1.1 2002/03/24 11:37:39 jongfoster +# Name change +# +# Revision 1.24 2002/03/16 20:39:54 oes +# - Added descriptions to the filters so users will know what they select in the cgi editor +# - Added content-cookies filter +# - Bugfixed many jobs (Thanks to Al for some hints) +# +# Revision 1.22 2002/03/12 13:42:50 oes +# Fixing & Optimizing REs +# +# Revision 1.21 2002/03/12 11:59:20 oes +# Beefed up Buzzword Bingo +# +# Revision 1.20 2002/03/12 01:42:50 oes +# Introduced modular filters +# +# Revision 1.19 2002/03/10 19:49:24 oes +# Added expression to kill referer tracking in JavaScripts +# +# Revision 1.18 2002/03/08 17:14:12 oes +# PNG -> image in comments +# +# Revision 1.17 2002/03/07 03:50:54 oes +# Adapted comments to new built-in images +# +# Revision 1.16 2002/02/21 00:12:19 jongfoster +# Modifying the banner regexps to use long URLS and to autodetect +# whether to show a logo or a transparent GIF, based on actionsfile +# setting. +# +# Revision 1.15 2001/12/28 23:54:20 steudten +# Fix for feature Req #495374: http-equiv problem +# +# Revision 1.14 2001/12/09 18:55:11 david__schmidt +# Updated CODE_STATUS to beta, commented out microsuck line in re_filterfile +# for 2.9.10 beta +# +# Revision 1.13 2001/10/13 13:11:20 joergs +# Fixed WebBug filter. +# +# Revision 1.12 2001/10/07 15:46:42 oes +# Followed Guy's proposal to change the document.cookie job +# +# Revision 1.11 2001/09/21 12:34:00 joergs +# Added filter to replace "Nimda" code by a warning. +# +# Revision 1.10 2001/07/20 11:04:26 oes +# Added Rodneys javascript cookie filter +# +# Revision 1.9 2001/07/13 14:03:48 oes +# Elimiated yet another bug in the banner-by-size jobs. Shame on me! +# +# Revision 1.8 2001/06/29 13:34:00 oes +# - Added explanation for U and T options +# - Added hint on image replacement by CGI call +# - Fixed bug in banner-by-size jobs +# +# Revision 1.7 2001/06/19 14:21:56 oes +# Fixed microsuck line +# +# Revision 1.6 2001/06/09 14:01:57 swa +# header. cosmetics. default: no messing ala microsuck. +# diff --git a/external/privoxy/doc/pcrs.3 b/external/privoxy/doc/pcrs.3 index 6b96b37..59e0f22 100644 --- a/external/privoxy/doc/pcrs.3 +++ b/external/privoxy/doc/pcrs.3 @@ -28,7 +28,7 @@ pcrs - Perl-compatible regular substitution. .B "#include <pcrs.h>" .PP .br -.BI "pcrs_job *pcrs_compile(const char *" pattern "," +.BI "pcrs_job *pcrs_compile(const char *" pattern "," .ti +5n .BI "const char *" substitute ", const char *" options , .ti +5n @@ -68,7 +68,7 @@ pcrs - Perl-compatible regular substitution.
The .SM PCRS -library is a supplement to the +library is a supplement to the .SB PCRE(3) library that implements .RB "regular expression based substitution, like provided by " Perl(1) "'s 's'" @@ -77,10 +77,10 @@ differences (see below).
In a first step, the information on a substitution, i.e. the pattern, the substitute and the options are compiled from Perl syntax to an internal form -.RB "called " pcrs_job " by using either the " pcrs_compile() " or " +.RB "called " pcrs_job " by using either the " pcrs_compile() " or " .BR pcrs_compile_command() " functions."
-Once the job is compiled, it can be used on subjects, which are arbitrary +Once the job is compiled, it can be used on subjects, which are arbitrary memory areas containing string or binary data, by calling .BR pcrs_execute() ". Jobs can be chained to joblists and whole" .RB "joblists can be applied to a subject using " pcrs_execute_list() . @@ -104,7 +104,7 @@ There are also convenience functions for freeing the jobs and for errno-to-strin .RB "follows the '" "s" "' will be used as the delimiter. Patterns or substitutes" that contain the delimiter need to quote it: \fBs/th\/is/th\/at/\fR -.RB "will replace " "th/is" " by " "th/at" " and can be written more simply as" +.RB "will replace " "th/is" " by " "th/at" " and can be written more simply as" .BR "s|th/is|th/at|" "."
.IR "pattern" ", " "substitute" ", " "options" " and " "command" " must be" @@ -123,7 +123,7 @@ On success, both functions return a pointer to the compiled job. .SS Substitutes .RI "The " "substitute" " uses" .RB "Perl syntax as documented in the " "perlre(1)" " manual page, with" -some exceptions: +some exceptions:
Most notably and evidently, since .SM PCRS @@ -147,9 +147,9 @@ refers to what the last capturing subpattern matched. if a global substitution previously matched.
.PP -Perl4-style references to subpattern matches of the form +Perl4-style references to subpattern matches of the form \fB\1, \2, ...\fR -.RB "which only exist in Perl5 for backwards compatibility, are " "not" +.RB "which only exist in Perl5 for backwards compatibility, are " "not" supported.
Also, since the substitute is a double-quoted string in Perl, you @@ -269,7 +269,7 @@ is set.
.SS String subjects -If your +If your
.SS Return value and diagnostics
@@ -298,7 +298,7 @@ contains pointers to other dynamically allocated structures. Chaining the jobs is up to you, but once you have built a linked list of jobs, .RI "you can execute a whole " joblist " on a given subject by" .RB "a single call to " pcrs_execute_list() ", which will sequentially traverse" -.RB "the linked list until it reaches a " NULL " pointer, and call " pcrs_execute() +.RB "the linked list until it reaches a " NULL " pointer, and call " pcrs_execute() .RI "for each job it encounters, feeding the " result " and " result_length " of each" .RI "call into the next as the " subject " and " subject_length ". As in the single" .RI "job case, the original " subject " remains untouched, but all interim " result "s" @@ -335,22 +335,22 @@ Under normal circumstances, it can take the following values: While compiling the pattern, .SM PCRE ran out of memory. -.TP +.TP .B PCRS_ERR_NOMEM While compiling the job, .SM PCRS ran out of memory. -.TP +.TP .B PCRS_ERR_CMDSYNTAX .BR pcrs_compile_command() " didn't find four tokens while parsing the" .IR command . -.TP +.TP .B PCRS_ERR_STUDY A .SM PCRE .RB "error occured while studying the compiled pattern. Since " pcre_study() only provides textual diagnostic information, the details are lost. -.TP +.TP .B PCRS_WARN_BADREF .RI "The " substitute " contains a reference to a capturing subpattern that" .RI "has a higher index than the number of capturing subpatterns in the " pattern @@ -368,12 +368,12 @@ While matching the pattern, ran out of memory. This can only happen if there are more than 33 backrefrences .RI "in the " pattern "(!)" .BR and " memory is too tight to extend storage for more." -.TP +.TP .B PCRS_ERR_NOMEM While executing the job, .SM PCRS ran out of memory. -.TP +.TP .B PCRS_ERR_BADJOB .RB "The " pcrs_job "* passed to " pcrs_execute " was NULL, or the" .RB "job is bogus (it contains " NULL " pointers to the compiled diff --git a/external/privoxy/doc/source/authors.sgml b/external/privoxy/doc/source/authors.sgml index 120e1b2..a810736 100644 --- a/external/privoxy/doc/source/authors.sgml +++ b/external/privoxy/doc/source/authors.sgml @@ -2,31 +2,31 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/authors.sgml,v $
Purpose : AUTHORS file for Privoxy + + $Id: authors.sgml,v 2.11 2009/02/12 16:08:26 fabiankeil Exp $
- $Id: authors.sgml,v 2.21 2011/12/26 17:05:40 fabiankeil Exp $ - - + Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE.
======================================================================== - NOTE: Please read developer-manual/documentation.html before touching + NOTE: Please read developer-manual/documentation.html before touching anything in this, or other Privoxy documentation. You have been warned! - Failure to abide by this rule will result in the revocation of your license + Failure to abide by this rule will result in the revocation of your license to live a peaceful existence! ========================================================================
=================================================================== - READ: Document Note: This file generates the AUTHORS file in the + READ: Document Note: This file generates the AUTHORS file in the top level source directory. See p-authors.sgml for list of developers and contributors, etc. They were split from here for use in man page. ===================================================================
--> <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ -<!entity % dummy "IGNORE"> +<!entity % dummy "IGNORE"> <!entity authors SYSTEM "p-authors.sgml"> -<!entity p-version "3.0.19"> +<!entity p-version "3.0.11"> <!entity p-status "stable"> <!entity % p-not-stable "IGNORE"> <!entity % p-stable "INCLUDE"> diff --git a/external/privoxy/doc/source/buildsource.sgml b/external/privoxy/doc/source/buildsource.sgml index bf109e4..f8f5955 100644 --- a/external/privoxy/doc/source/buildsource.sgml +++ b/external/privoxy/doc/source/buildsource.sgml @@ -2,8 +2,8 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/buildsource.sgml,v $
Purpose : Entity included in other project documents. - - $Id: buildsource.sgml,v 2.19 2011/09/04 11:10:12 fabiankeil Exp $ + + $Id: buildsource.sgml,v 2.18 2009/02/23 09:03:12 fabiankeil Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE. @@ -12,7 +12,7 @@ This file used for inclusion with other documents only. ======================================================================
- If you make changes to this file, please verify the finished + If you make changes to this file, please verify the finished docs all display as intended.
This file is included into: @@ -22,7 +22,7 @@
--> <para> - To build <application>Privoxy</application> from source, + To build <application>Privoxy</application> from source, <ulink url="http://www.gnu.org/software/autoconf/autoconf.html">autoconf</ulink>, <ulink url="http://www.gnu.org/software/make/make.html">GNU make @@ -32,12 +32,12 @@
<para> When building from a source tarball, -<!-- +<!-- no longer available ... <ulink url="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.gz">nightly CVS - tarball</ulink>), ---> first unpack the source: + tarball</ulink>), +--> first unpack the source: </para>
<para> @@ -63,7 +63,7 @@ </para>
<para> - This will create a directory named <filename>current/</filename>, which will + This will create a directory named <filename>current/</filename>, which will contain the source tree. </para>
@@ -81,7 +81,7 @@ and group just for this purpose. See your local documentation for the correct command line to do add new users and groups (something like <command>adduser</command>, but the command syntax may vary from platform - to platform). + to platform). </para>
<para> @@ -113,7 +113,7 @@ autoheader autoconf ./configure # (--help to see options) - make # (the make from GNU, sometimes called gmake) + make # (the make from GNU, sometimes called gmake) su # Possibly required make -n install # (to see where all the files will go) make -s install # (to really install, -s to silence output)</screen> @@ -135,14 +135,14 @@ </para>
<para> - To build an executable with security enhanced features so that + To build an executable with security enhanced features so that users cannot easily bypass the proxy (e.g. <quote>Go There Anyway</quote>), or alter their own configurations, <command>configure</command> like this: </para> <para> <screen> ./configure --disable-toggle --disable-editor --disable-force</screen> -</para> +</para> <para> Then build as above. In Privoxy 3.0.7 and later, all of these options can also be disabled through the configuration file. @@ -177,9 +177,9 @@ can also be disabled through the configuration file. </para>
<para> - The default installation path for <command>make install</command> is - <filename>/usr/local</filename>. This may of course be customized with - the various <command>./configure</command> path options. If you are doing + The default installation path for <command>make install</command> is + <filename>/usr/local</filename>. This may of course be customized with + the various <command>./configure</command> path options. If you are doing an install to anywhere besides <filename>/usr/local</filename>, be sure to set the appropriate paths with the correct configure options (<command>./configure --help</command>). Non-privileged users must of course @@ -209,15 +209,15 @@ can also be disabled through the configuration file. <literal>localstatedir</literal> (ie: <filename>var/</filename>) will default to <filename>/var</filename> instead of <literal>$prefix/var</literal> so the logs will go to <filename>/var/log/privoxy/</filename>, and the pid file - will be created in <filename>/var/run/privoxy.pid</filename>. + will be created in <filename>/var/run/privoxy.pid</filename>. </para>
<para> - <command>make install</command> will attempt to set the correct values - in <filename>config</filename> (main configuration file). You should + <command>make install</command> will attempt to set the correct values + in <filename>config</filename> (main configuration file). You should check this to make sure all values are correct. If appropriate, - an init script will be installed, but it is up to the user to determine - how and where to start <application>Privoxy</application>. The init + an init script will be installed, but it is up to the user to determine + how and where to start <application>Privoxy</application>. The init script should be checked for correct paths and values, if anything other than a default install is done. </para> @@ -248,9 +248,9 @@ can also be disabled through the configuration file. <!-- Actually this is now in INSTALL --> <![%p-readme;[ <para> - The simplest command line to start <application>Privoxy</application> is - <command>$path/privoxy --user=privoxy $path/etc/privoxy/config</command>. - See <command>privoxy --usage</command>, or the man page, for other options, + The simplest command line to start <application>Privoxy</application> is + <command>$path/privoxy --user=privoxy $path/etc/privoxy/config</command>. + See <command>privoxy --usage</command>, or the man page, for other options, and configuration. </para> ]]> diff --git a/external/privoxy/doc/source/config.sgml b/external/privoxy/doc/source/config.sgml index eb55a99..472884c 100644 --- a/external/privoxy/doc/source/config.sgml +++ b/external/privoxy/doc/source/config.sgml @@ -1,7 +1,7 @@ <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[ -<!entity % dummy "IGNORE"> +<!entity % dummy "IGNORE"> <!entity config SYSTEM "p-config.sgml"> -<!entity p-version "3.0.19"> +<!entity p-version "3.0.11"> <!entity p-status "stable"> <!entity % p-not-stable "IGNORE"> <!entity % user-man "IGNORE"> @@ -12,19 +12,19 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/config.sgml,v $
Purpose : config file generation - - $Id: config.sgml,v 2.22 2011/12/26 17:05:40 fabiankeil Exp $ + + $Id: config.sgml,v 2.12 2009/02/12 16:08:26 fabiankeil Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE.
======================================================================== - NOTE: Please read developer-manual/documentation.html before touching - anything in this, or other Privoxy documentation. + NOTE: Please read developer-manual/documentation.html before touching + anything in this, or other Privoxy documentation. ========================================================================
- This file is used to generate the main Privoxy config file. It is mostly - content included from p-config.sgml (where all the data is). See that + This file is used to generate the main Privoxy config file. It is mostly + content included from p-config.sgml (where all the data is). See that file for more comments.
--> diff --git a/external/privoxy/doc/source/contacting.sgml b/external/privoxy/doc/source/contacting.sgml index 93e1bc5..96293f7 100644 --- a/external/privoxy/doc/source/contacting.sgml +++ b/external/privoxy/doc/source/contacting.sgml @@ -2,10 +2,10 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/contacting.sgml,v $
Purpose : Entity included in other project documents. + + $Id: contacting.sgml,v 2.14 2008/04/26 11:38:51 fabiankeil Exp $
- $Id: contacting.sgml,v 2.30 2011/11/19 14:44:01 fabiankeil Exp $ - - Copyright (C) 2001-2011 Privoxy Developers http://www.privoxy.org/ + Copyright (C) 2001-2008 Privoxy Developers http://www.privoxy.org/ See LICENSE.
====================================================================== @@ -29,13 +29,13 @@ <para> We value your feedback. In fact, we rely on it to improve <application>Privoxy</application> and its configuration. - However, please note the following hints, so we can + However, please note the following hints, so we can provide you with the best support: </para>
<sect2 id="contact-support"><title>Get Support</title> <para> - For casual users, our + For casual users, our <ulink url="http://sourceforge.net/tracker/?group_id=11118&atid=211118">support forum at SourceForge</ulink> is probably best suited: <ulink url="http://sourceforge.net/tracker/?group_id=11118&atid=211118">http://sourceforge.net/tracker/?group_id=11118&atid=211118</ulink> @@ -53,15 +53,6 @@ </para>
<para> - If you have to contact a Privoxy developer directly for other reasons, - please send a real mail and do not bother with SourceForge's messaging - system. Answers to SourceForge messages are usually bounced by SourceForge's - mail server in which case the developer wasted time writing a response you - don't get. From your point of view it will look like your message has - been completely ignored, so this is frustrating for all parties involved. -</para> - -<para> Note that the Privoxy mailing lists are moderated. Posts from unsubscribed addresses have to be accepted manually by a moderator. This may cause a delay of several days and if you use a subject that doesn't clearly @@ -86,30 +77,30 @@
<listitem> <para> - Configuration issues, such as ads that slip through, or sites that - don't function properly due to one <application>Privoxy</application> + Configuration issues, such as ads that slip through, or sites that + don't function properly due to one <application>Privoxy</application> <quote>action</quote> or another being turned <quote>on</quote>. </para> - </listitem> + </listitem>
<listitem> <para> - <quote>Bugs</quote> in the programming code that makes up + <quote>Bugs</quote> in the programming code that makes up <application>Privoxy</application>, such as that might cause a crash. </para> - </listitem> + </listitem> </itemizedlist>
<sect3 id="contact-ads"><title>Reporting Ads or Other Configuration Problems</title> <para> Please send feedback on ads that slipped through, innocent images that were - blocked, sites that don't work properly, and other configuration related problem of - <filename>default.action</filename> file, to + blocked, sites that don't work properly, and other configuration related problem of + <filename>default.action</filename> file, to <ulink url="http://sourceforge.net/tracker/?group_id=11118&atid=460288"> http://sourceforge.net/tracker/?group_id=11118&atid=460288</ulink>, the Actions File Tracker. -</para> +</para>
<para> New, improved <filename>default.action</filename> files may occasionally be made @@ -124,15 +115,15 @@
<sect3 id="contact-bugs"><title>Reporting Bugs</title> <para> - Please report all bugs through our bug tracker: - <ulink url="http://sourceforge.net/tracker/?group_id=11118&atid=111118">http://sourceforge.net/tracker/?group_id=11118&atid=111118</ulink>. + Please report all bugs through our bug tracker: + <ulink url="http://sourceforge.net/tracker/?group_id=11118&atid=111118">http://sourceforge.net/tracker/?group_id=11118&atid=111118</ulink>. </para>
<para> Before doing so, please make sure that the bug has <emphasis>not already been submitted</emphasis> and observe the additional hints at the top of the <ulink url="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118">submit - form</ulink>. If already submitted, please feel free to add any info to the + form</ulink>. If already submitted, please feel free to add any info to the original report that might help to solve the issue. </para>
@@ -159,7 +150,7 @@ that your bug still exists. </para> <para> - Please be sure to provide the following information: +Please be sure to provide the following information: </para> <para> <itemizedlist> @@ -170,7 +161,7 @@ (if you got the source from CVS, please also provide the source code revisions as shown in <ulink url="http://config.privoxy.org/show-version">http://config.privoxy.org/show-version</ulink>). </para> - </listitem> + </listitem>
<listitem> <para> @@ -180,11 +171,11 @@ sending the output of <quote>uname -a</quote> should do, in case of GNU/Linux, please also name the distribution. </para> - </listitem> + </listitem>
<listitem> <para> - The name, platform, and version of the <application>browser</application> + The name, platform, and version of the <application>browser</application> you were using (e.g. <application>Internet Explorer v5.5</application> for Mac). </para> </listitem> @@ -192,9 +183,9 @@ <listitem> <para> The URL where the problem occurred, or some way for us to duplicate the - problem (e.g. <literal>http://somesite.example.com/?somethingelse=123</literal>). + problem (e.g. <literal>http://somesite.example.com/?somethingelse=123</literal>). </para> - </listitem> + </listitem>
<listitem> <para> @@ -202,85 +193,52 @@ by the <application>Privoxy</application> developers via SourceForge, or if you got your copy somewhere else. </para> - </listitem> + </listitem>
<listitem> <para> - Whether you are using <application>Privoxy</application> in tandem with + Whether you are using <application>Privoxy</application> in tandem with another proxy such as <application>Tor</application>. If so, please temporary disable the other proxy to see if the symptoms change. </para> - </listitem> + </listitem>
<listitem> <para> - Whether you are using a personal firewall product. If so, does + Whether you are using a personal firewall product. If so, does <application>Privoxy</application> work without it? </para> - </listitem> + </listitem>
<listitem> <para> Any other pertinent information to help identify the problem such as config or log file excerpts (yes, you should have log file entries for each - action taken). To get a meaningful logfile, please make sure that the - <ulink url="../user-manual/config.html#LOGFILE">logfile directive</ulink> - is being used and the following <ulink - url="../user-manual/config.html#DEBUG">debug options</ulink> are enabled: - <literallayout>debug 1 # Log the destination for each request Privoxy let through. See also debug 1024. -debug 2 # show each connection status -debug 4 # show I/O status -debug 8 # show header parsing -debug 128 # debug redirects -debug 256 # debug GIF de-animation -debug 512 # Common Log Format -debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why. -debug 4096 # Startup banner and warnings. -debug 8192 # Non-fatal errors</literallayout> - If you are having trouble with a filter, please additionally enable - <literallayout>debug 64 # debug regular expression filters</literallayout> - If you are using Privoxy 3.0.17 or later and suspect that it interprets the - request or the response incorrectly, please enable - <literallayout>debug 32768 # log all data read from the network</literallayout> - Note that Privoxy log files may contain sensitive information so please don't - submit any logfiles you didn't read first. You can mask sensitive information - as long as it's clear that you removed something. + action taken). </para> - </listitem> + </listitem>
</itemizedlist> </para>
<para> You don't have to tell us your actual name when filing a problem - report, but if you don't, please use a nickname so we can differentiate - between your messages and the ones entered by other "anonymous" users that + report, but please use a nickname so we can differentiate between + your messages and the ones entered by other "anonymous" users that may respond to your request if they have the same problem or already - found a solution. Note that due to spam the trackers may not always - allow to post without being logged into SourceForge. If that's the - case, you are still free to create a login that isn't directly linked - to your name, though. + found a solution. </para>
<para> Please also check the status of your request a few days after submitting it, as we may request additional information. If you use a SF id, you should automatically get a mail when someone responds to your request. - Please don't bother to add an email address when using the tracker. - If you prefer to communicate through email, just use one of the mailing - lists directly. -</para> - -<para> - If you are new to reporting problems, you might be interested in - <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" - >How to Report Bugs Effectively</ulink>. </para>
<para> The <ulink url="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT">appendix - of the Privoxy User Manual</ulink> also has helpful information - on understanding <literal>actions</literal>, and <literal>action</literal> debugging. + of the Privoxy User Manual</ulink> also has helpful information + on understanding <literal>actions</literal>, and <literal>action</literal> debugging. </para> </sect3> </sect2> @@ -293,13 +251,10 @@ debug 8192 # Non-fatal errors</literallayout> </para> </sect2>
-<sect2 id="mailing-lists"><title>Mailing Lists</title> +<sect2 id="contact-other"><title>Other</title> <para> -If you prefer to communicate through email, instead of using a web interface, -feel free to use one of the mailing lists. -To discuss issues that haven't been completely diagnosed yet, please use the Privoxy -users list. Technically interested users and people who wish to contribute to -the project are always welcome on the developers list. +For any other issues, feel free to use the mailing lists. Technically interested users +and people who wish to contribute to the project are also welcome on the developers list! You can find an overview of all <application>Privoxy</application>-related mailing lists, including list archives, at: <ulink url="http://sourceforge.net/mail/?group_id=11118">http://sourceforge.net/mail/?group_id=11118</ulink>. diff --git a/external/privoxy/doc/source/copyright.sgml b/external/privoxy/doc/source/copyright.sgml index 74e6848..01c978d 100644 --- a/external/privoxy/doc/source/copyright.sgml +++ b/external/privoxy/doc/source/copyright.sgml @@ -2,17 +2,17 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/copyright.sgml,v $
Purpose : Entity included in other project documents. + + $Id: copyright.sgml,v 2.10 2009/02/10 16:13:30 fabiankeil Exp $
- $Id: copyright.sgml,v 2.14 2011/09/04 11:10:12 fabiankeil Exp $ - - Copyright (C) 2001-2011 Privoxy Developers http://www.privoxy.org/ + Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE.
====================================================================== This file used for inclusion with other documents only. ======================================================================
- If you make changes to this file, please verify the finished + If you make changes to this file, please verify the finished docs all display as intended.
This file is included into: @@ -23,8 +23,8 @@ faq
************************************************************** - NOTE: the &my-copy entity must be defined in any file that will - include this file. (This is a workaround for docbook2man not + NOTE: the &my-copy entity must be defined in any file that will + include this file. (This is a workaround for docbook2man not handling the standard © entity in the man page processing.) **************************************************************
@@ -36,7 +36,7 @@ -->
<para> - Copyright &my-copy; 2001-2011 by Privoxy Developers <email>ijbswa-developers@lists.sourceforge.net</email> + Copyright &my-copy; 2001-2009 by Privoxy Developers <email>ijbswa-developers@lists.sourceforge.net</email> </para>
<para> diff --git a/external/privoxy/doc/source/developer-manual.sgml b/external/privoxy/doc/source/developer-manual.sgml index e916e04..0e1dc1f 100644 --- a/external/privoxy/doc/source/developer-manual.sgml +++ b/external/privoxy/doc/source/developer-manual.sgml @@ -1,5 +1,5 @@ <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[ -<!entity % dummy "IGNORE"> +<!entity % dummy "IGNORE"> <!entity supported SYSTEM "supported.sgml"> <!entity newfeatures SYSTEM "newfeatures.sgml"> <!entity p-intro SYSTEM "privoxy.sgml"> @@ -8,7 +8,7 @@ <!entity contacting SYSTEM "contacting.sgml"> <!entity copyright SYSTEM "copyright.sgml"> <!entity license SYSTEM "license.sgml"> -<!entity p-version "3.0.19"> +<!entity p-version "3.0.11"> <!entity p-status "stable"> <!entity % p-not-stable "IGNORE"> <!entity % p-stable "INCLUDE"> @@ -23,16 +23,16 @@ Purpose : developer manual This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - - $Id: developer-manual.sgml,v 2.38 2011/12/26 17:05:40 fabiankeil Exp $ + + $Id: developer-manual.sgml,v 2.27 2009/02/19 02:20:22 hal9 Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE.
======================================================================== - NOTE: Please read developer-manual/documentation.html before touching + NOTE: Please read developer-manual/documentation.html before touching anything in this, or other Privoxy documentation. You have been warned! - Failure to abide by this rule will result in the revocation of your license + Failure to abide by this rule will result in the revocation of your license to live a peaceful existence! ========================================================================
@@ -45,24 +45,24 @@ <subscript> <!-- Completely the wrong markup, but very little is allowed --> <!-- in this part of an article. FIXME --> - <link linkend="copyright">Copyright</link> &my-copy; 2001-2009 by + <link linkend="copyright">Copyright</link> &my-copy; 2001-2009 by <ulink url="http://www.privoxy.org/">Privoxy Developers</ulink> </subscript> </pubdate>
- <pubdate>$Id: developer-manual.sgml,v 2.38 2011/12/26 17:05:40 fabiankeil Exp $</pubdate> + <pubdate>$Id: developer-manual.sgml,v 2.27 2009/02/19 02:20:22 hal9 Exp $</pubdate>
<!--
-Note: this should generate a separate page, and a live link to it. +Note: this should generate a separate page, and a live link to it. But it doesn't for some mysterious reason. Please leave commented -unless it can be fixed proper. For the time being, the copyright +unless it can be fixed proper. For the time being, the copyright statement will be in copyright.smgl.
Hal.
-<legalnotice id="legalnotice"> +<legalnotice id="legalnotice"> <para> text goes here ........ </para> @@ -101,7 +101,7 @@ Hal. the state at the release of version &p-version;. You can find the latest version of the this manual at <ulink url="http://www.privoxy.org/developer-manual/">http://www.privoxy.org/developer-manual/</ulink>. - Please see <link linkend="contact">the Contact section</link> + Please see <link linkend="contact">the Contact section</link> on how to contact the developers. </para> <!-- <para> --> @@ -118,16 +118,16 @@ Hal.
I don't like seeing blank space :) So added *something* here.
- --> + --> <para> <application>Privoxy</application>, as an heir to - <application>Junkbuster</application>, is a Free Software project + <application>Junkbuster</application>, is a Free Software project and the code is licensed under the GNU General Public License version 2. As such, <application>Privoxy</application> development is potentially open to anyone who has the time, knowledge, and desire to contribute in any capacity. Our goals are simply to continue the mission, to improve <application>Privoxy</application>, and - to make it available to as wide an audience as possible. + to make it available to as wide an audience as possible. </para> <para> One does not have to be a programmer to contribute. Packaging, testing, @@ -139,19 +139,19 @@ Hal. <para> The first step is to join the <ulink url="mailto:ijbswa-developers@lists.sourceforge.net">developer's mailing list</ulink>. - You can submit your ideas, or even better patches. Patches are best - submitted to the Sourceforge tracker set up for this purpose, but + You can submit your ideas, or even better patches. Patches are best + submitted to the Sourceforge tracker set up for this purpose, but can be sent to the list for review too. </para> <para> - You will also need to have a cvs package installed, which will + You will also need to have a cvs package installed, which will entail having ssh installed as well (which seems to be a requirement of SourceForge), in order to access the cvs repository. Having the GNU build tools is also going to be important (particularly, autoconf and gmake). </para> <para> - For the time being (read, this section is under construction), you can - also refer to the extensive comments in the source code. In fact, + For the time being (read, this section is under construction), you can + also refer to the extensive comments in the source code. In fact, reading the code is recommended in any case. </para> </sect2> @@ -161,7 +161,7 @@ Hal. <sect1 id="cvs"><title>The CVS Repository</title> <para> If you become part of the active development team, you will eventually - need write access to our holy grail, the CVS repository. One of the + need write access to our holy grail, the CVS repository. One of the team members will need to set this up for you. Please read this chapter completely before accessing via CVS. </para> @@ -206,21 +206,21 @@ Hal. </para> <para> At one time there were two distinct branches: stable and unstable. The - more drastic changes were to be in the unstable branch. These branches - have now been merged to minimize time and effort of maintaining two + more drastic changes were to be in the unstable branch. These branches + have now been merged to minimize time and effort of maintaining two branches. </para> - <!-- + <!-- <para> This will result in at least two active branches, which means there may - be occasions that require the same (or similar) item to be - checked into to two different places (assuming its a bugfix and needs + be occasions that require the same (or similar) item to be + checked into to two different places (assuming its a bugfix and needs fixing in both the stable and unstable trees). This also means that in - order to have access to both trees, both will have to be checked out - separately. Use the <literal>cvs -r</literal> flag to check out a + order to have access to both trees, both will have to be checked out + separately. Use the <literal>cvs -r</literal> flag to check out a branch, e.g: <literal>cvs co -r v_3_0_branch current</literal>. </para> - --> + --> </sect2>
<sect2 id="cvscommit"><title>CVS Commit Guidelines</title> @@ -231,16 +231,16 @@ Hal. main development trunk, and we ask anyone with CVS access to strictly adhere to the following guidelines: </para> - + <para> Basic Guidelines, for all branches: </para> <para> <itemizedlist> <listitem><para> - Please don't commit even + Please don't commit even a small change without testing it thoroughly first. When we're - close to a public release, ask a fellow developer to review your + close to a public release, ask a fellow developer to review your changes. </para></listitem> <listitem><para> @@ -269,18 +269,18 @@ Hal. url="http://sourceforge.net/tracker/?atid=311118&group_id=11118&func=browse">patch tracker</ulink> instead. </para> - </listitem> + </listitem> </itemizedlist> </para> - + <!-- <para> - Stable branches are handled with more care, especially after the - initial *.*.0 release, and we are just in bugfix mode. In addition to - the above, the below applies only to the stable branch (currently the + Stable branches are handled with more care, especially after the + initial *.*.0 release, and we are just in bugfix mode. In addition to + the above, the below applies only to the stable branch (currently the <literal>v_3_0_branch</literal> branch): </para> - + <para> <itemizedlist> <listitem> @@ -290,41 +290,41 @@ Hal. project, or have prior approval of the project leaders or consensus of the devel list. </para> - </listitem> + </listitem> <listitem> <para> - Where possible, bugfixes and changes should be tested in the main - development trunk first. There may be occasions where this is not + Where possible, bugfixes and changes should be tested in the main + development trunk first. There may be occasions where this is not feasible, though. </para> - </listitem> + </listitem> <listitem> <para> - Alternately, proposed changes can be submitted as patches to the patch tracker on + Alternately, proposed changes can be submitted as patches to the patch tracker on Sourceforge first: <ulink url="http://sourceforge.net/tracker/?group_id=11118&atid=311118">http://sourceforge.net/tracker/?group_id=11118&atid=311118</ulink>. - Then ask for peer review. + Then ask for peer review. </para> - </listitem> + </listitem> <listitem> <para> Do not even think about anything except bugfixes. No new features! </para> - </listitem> - + </listitem> + </itemizedlist> - </para> + </para> --> </sect2>
</sect1> - + <!-- ~~~~~ New section ~~~~~ --> <sect1 id="documentation"><title>Documentation Guidelines</title> <para> All formal documents are maintained in Docbook SGML and located in the <computeroutput>doc/source/*</computeroutput> directory. You will need - <ulink url="http://www.docbook.org">Docbook</ulink>, the Docbook + <ulink url="http://www.docbook.org">Docbook</ulink>, the Docbook DTD's and the Docbook modular stylesheets (or comparable alternatives), and either <application>jade</application> or <application>openjade</application> (recommended) installed in order to @@ -337,20 +337,20 @@ Hal. <citetitle>privoxy.1</citetitle> (man page), and <citetitle>config</citetitle> files are also now maintained as Docbook SGML. These files, when built, in the top-level source directory are - generated files! Also, the <application>Privoxy</application> <filename>index.html</filename> (and a - variation on this file, <filename>privoxy-index.html</filename>, + generated files! Also, the <application>Privoxy</application> <filename>index.html</filename> (and a + variation on this file, <filename>privoxy-index.html</filename>, meant for inclusion with doc packages), are maintained as SGML as well. <emphasis>DO NOT edit these directly</emphasis>. Edit the SGML source, or contact someone involved in the documentation. - </para> + </para> <para> <filename>config</filename> requires some special handling. The reason it is maintained this way is so that the extensive comments in the file - mirror those in <citetitle>user-manual</citetitle>. But the conversion - process requires going from SGML to HTML to text to special formatting + mirror those in <citetitle>user-manual</citetitle>. But the conversion + process requires going from SGML to HTML to text to special formatting required for the embedded comments. Some of this does not survive so well. Especially some of the examples that are longer than 80 characters. - The build process for this file outputs to <filename>config.new</filename>, + The build process for this file outputs to <filename>config.new</filename>, which should be reviewed for errors and mis-formatting. Once satisfied that it is correct, then it should be hand copied to <filename>config</filename>. @@ -362,8 +362,8 @@ Hal. <para> Packagers are encouraged to include this documentation. For those without the ability to build the docs locally, text versions of each are kept in - CVS. HTML versions are also being kept in CVS under - <filename>doc/webserver/*</filename>. And PDF version are kept in + CVS. HTML versions are also being kept in CVS under + <filename>doc/webserver/*</filename>. And PDF version are kept in <filename>doc/pdf/*</filename>. </para> <para> @@ -381,7 +381,7 @@ Hal. </para> <para> How do you update the webserver (i.e. the pages on privoxy.org)? - + <orderedlist numeration="arabic"> <listitem><para> First, build the docs by running <computeroutput>make @@ -399,7 +399,7 @@ Hal.
<para> Finished docs should be occasionally submitted to CVS - (<filename>doc/webserver/*/*.html</filename>) so that those without + (<filename>doc/webserver/*/*.html</filename>) so that those without the ability to build them locally, have access to them if needed. This is especially important just prior to a new release! Please do this <emphasis>after</emphasis> the <literal>$VERSION</literal> and @@ -411,14 +411,14 @@ Hal. <sect2 id="sgml"> <title>Quickstart to Docbook and SGML</title> <para> - If you are not familiar with SGML, it is a markup language similar to HTML. - Actually, not a mark up language per se, but a language used to define + If you are not familiar with SGML, it is a markup language similar to HTML. + Actually, not a mark up language per se, but a language used to define markup languages. In fact, HTML is an SGML application. Both will use <quote>tags</quote> to format text and other content. SGML tags can be much more varied, and flexible, but do much of the same kinds of things. The tags, or <quote>elements</quote>, are definable in SGML. There is no set <quote>standards</quote>. Since we are using - <application>Docbook</application>, our tags are those that are defined by + <application>Docbook</application>, our tags are those that are defined by <application>Docbook</application>. Much of how the finish document is rendered is determined by the <quote>stylesheets</quote>. The stylesheets determine how each tag gets translated to HTML, or other @@ -435,26 +435,26 @@ Hal.
<para> Our documents use <quote>sections</quote> for the most part. Sections - will be processed into HTML headers (e.g. <literal>h1</literal> for + will be processed into HTML headers (e.g. <literal>h1</literal> for <literal>sect1</literal>). The <application>Docbook</application> stylesheets - will use these to also generate the Table of Contents for each doc. Our - TOC's are set to a depth of three. Meaning <literal>sect1</literal>, - <literal>sect2</literal>, and <literal>sect3</literal> will have TOC - entries, but <literal>sect4</literal> will not. Each section requires - a <literal><title></literal> element, and at least one - <literal><para></literal>. There is a limit of five section - levels in Docbook, but generally three should be sufficient for our + will use these to also generate the Table of Contents for each doc. Our + TOC's are set to a depth of three. Meaning <literal>sect1</literal>, + <literal>sect2</literal>, and <literal>sect3</literal> will have TOC + entries, but <literal>sect4</literal> will not. Each section requires + a <literal><title></literal> element, and at least one + <literal><para></literal>. There is a limit of five section + levels in Docbook, but generally three should be sufficient for our purposes. </para>
<para> - Some common elements that you likely will use: + Some common elements that you likely will use: </para>
<para> <simplelist> <member> - <emphasis><para></para></emphasis>, paragraph delimiter. Most + <emphasis><para></para></emphasis>, paragraph delimiter. Most text needs to be within paragraph elements (there are some exceptions). </member> <member> @@ -468,7 +468,7 @@ Hal. <emphasis><command></command></emphasis>, command examples. </member> <member> - <emphasis><literallayout></literallayout></emphasis>, like + <emphasis><literallayout></literallayout></emphasis>, like <literal><pre></literal>, more or less. </member> <member> @@ -478,15 +478,15 @@ Hal. <emphasis><listitem></listitem></emphasis>, member of the above. </member> <member> - <emphasis><screen></screen></emphasis>, screen output, implies + <emphasis><screen></screen></emphasis>, screen output, implies <literal><literallayout></literal>. </member> <member> - <emphasis><ulink url="example.com"></ulink></emphasis>, like + <emphasis><ulink url="example.com"></ulink></emphasis>, like HTML <literal><a></literal> tag. </member> <member> - <emphasis><quote></quote></emphasis>, for, doh, quoting text. + <emphasis><quote></quote></emphasis>, for, doh, quoting text. </member> </simplelist> </para> @@ -506,8 +506,8 @@ Hal. <sect2 id="docstyle"> <title><application>Privoxy</application> Documentation Style</title> <para> - It will be easier if everyone follows a similar writing style. This - just makes it easier to read what someone else has written if it + It will be easier if everyone follows a similar writing style. This + just makes it easier to read what someone else has written if it is all done in a similar fashion. </para> <para> @@ -519,7 +519,7 @@ Hal. <para> All tags should be lower case. </para> - </listitem> + </listitem> <listitem> <para> Tags delimiting a <emphasis>block</emphasis> of text (even small @@ -534,11 +534,11 @@ Hal. Just to <emphasis>emphasize</emphasis>, some text goes here. </literallayout> </para> - </listitem> + </listitem> <listitem> <para> Tags should be nested and step indented for block text like: (except - in-line tags) + in-line tags) <literallayout> <para> <itemizedlist> @@ -552,48 +552,48 @@ Hal. </literallayout> This makes it easier to find the text amongst the tags ;-) </para> - </listitem> + </listitem> <listitem> <para> - Use white space to separate logical divisions within a document, - like between sections. Running everything together consistently + Use white space to separate logical divisions within a document, + like between sections. Running everything together consistently makes it harder to read and work on. </para> - </listitem> + </listitem> <listitem> <para> - Do not hesitate to make comments. Comments can either use the - <comment> element, or the <!-- --> style comment - familiar from HTML. (Note in Docbook v4.x <comment> is + Do not hesitate to make comments. Comments can either use the + <comment> element, or the <!-- --> style comment + familiar from HTML. (Note in Docbook v4.x <comment> is replaced by <remark>.) </para> - </listitem> + </listitem> <listitem> <para> - We have an international audience. Refrain from slang, or English - idiosyncrasies (too many to list :). Humor also does not translate + We have an international audience. Refrain from slang, or English + idiosyncrasies (too many to list :). Humor also does not translate well sometimes. </para> - </listitem> + </listitem> <listitem> <para> Try to keep overall line lengths in source files to 80 characters or less for obvious reasons. This is not always possible, with lengthy URLs for instance. </para> - </listitem> + </listitem> <listitem> <para> - Our documents are available in differing formats. Right now, they - are just plain text, HTML, and PDF, but others are always a - future possibility. Be careful with URLs (<ulink>), and avoid + Our documents are available in differing formats. Right now, they + are just plain text, HTML, and PDF, but others are always a + future possibility. Be careful with URLs (<ulink>), and avoid this mistake: </para> <para> My favorite site is <ulink url="http://example.com">here</ulink>. </para> <para> - This will render as <quote>My favorite site is here</quote>, which is + This will render as <quote>My favorite site is here</quote>, which is not real helpful in a text doc. Better like this: </para> <para> @@ -607,37 +607,37 @@ Hal. <literal>-H</literal> option. (<application>ispell</application> I think too.) </para> - </listitem> + </listitem>
</itemizedlist> - </para> - + </para> + </sect2>
- + <!-- ~~~~~ New section ~~~~~ -->
<sect2><title>Privoxy Custom Entities</title> <para> - <application>Privoxy</application> documentation is using - a number of customized <quote>entities</quote> to facilitate - documentation maintenance. + <application>Privoxy</application> documentation is using + a number of customized <quote>entities</quote> to facilitate + documentation maintenance. </para> <para> We are using a set of <quote>boilerplate</quote> files with generic text, that is used by multiple docs. This way we can write something once, and use it repeatedly without having to re-write the same content over and over again. If editing such a file, keep in mind that it should be - <emphasis>generic</emphasis>. That is the purpose; so it can be used in varying + <emphasis>generic</emphasis>. That is the purpose; so it can be used in varying contexts without additional modifications. </para> <para> - We are also using what <application>Docbook</application> calls - <quote>internal entities</quote>. These are like variables in + We are also using what <application>Docbook</application> calls + <quote>internal entities</quote>. These are like variables in programming. Well, sort of. For instance, we have the - <literal>p-version</literal> entity that contains the current - <application>Privoxy</application> version string. You are strongly - encouraged to use these where possible. Some of these obviously + <literal>p-version</literal> entity that contains the current + <application>Privoxy</application> version string. You are strongly + encouraged to use these where possible. Some of these obviously require re-setting with each release (done by the Makefile). A sampling of custom entities are listed below. See any of the main docs for examples. </para> @@ -653,28 +653,28 @@ Hal. </para> <para> In this example, the contents of the file, - <filename>supported.sgml</filename> is available for inclusion anywhere - in the doc. To make this happen, just reference the now defined - entity: <literal>&supported;</literal> (starts with an ampersand - and ends with a semi-colon), and the contents will be dumped into + <filename>supported.sgml</filename> is available for inclusion anywhere + in the doc. To make this happen, just reference the now defined + entity: <literal>&supported;</literal> (starts with an ampersand + and ends with a semi-colon), and the contents will be dumped into the finished doc at that point. </para> - </listitem> + </listitem> <listitem> <para> Commonly used <quote>internal entities</quote>: </para> <simplelist> <member> - <emphasis>p-version</emphasis>: the <application>Privoxy</application> + <emphasis>p-version</emphasis>: the <application>Privoxy</application> version string, e.g. <quote>&p-version;</quote>. </member> <member> - <emphasis>p-status</emphasis>: the project status, either + <emphasis>p-status</emphasis>: the project status, either <quote>alpha</quote>, <quote>beta</quote>, or <quote>stable</quote>. </member> <member> - <emphasis>p-not-stable</emphasis>: use to conditionally include + <emphasis>p-not-stable</emphasis>: use to conditionally include text in <quote>not stable</quote> releases (e.g. <quote>beta</quote>). </member> <member> @@ -684,16 +684,16 @@ Hal. <emphasis>p-text</emphasis>: this doc is only generated as text. </member> </simplelist> - </listitem> + </listitem> </itemizedlist> - </para> + </para> <para> - There are others in various places that are defined for a specific + There are others in various places that are defined for a specific purpose. Read the source! </para> - + </sect2> - + </sect1>
<!-- <listitem><para>be consistent with the redirect script (i.e. the <application>Privoxy</application> program --> @@ -718,7 +718,7 @@ Hal. </sect2>
<sect2 id="s2"><title>Using Comments</title> - +
<sect3 id="s3"><title>Comment, Comment, Comment</title>
@@ -757,7 +757,7 @@ is actually being done. </programlisting> </sect3>
- +
<sect3 id="s4"><title>Use blocks for comments</title>
@@ -798,9 +798,9 @@ if ( this_variable == that_variable ) /* this may not either */ wish to "disrupt" the flow of the code, feel free to use a 1 line comment which is NOT on the same line as the code.</para>
- + </sect3> - +
<sect3 id="s5"><title>Keep Comments on their own line</title>
@@ -853,7 +853,7 @@ short do_something_very_important( } /* -END- do_something_very_important */ </programlisting> </sect3> - +
<sect3 id="s6"><title>Comment each logical step</title>
@@ -871,9 +871,9 @@ short do_something_very_important( comment. After all, these are usually major logic containers.</para>
- + </sect3> - +
<sect3 id="s7"><title>Comment All Functions Thoroughly</title>
@@ -892,9 +892,9 @@ short do_something_very_important( functions should contain the information presented in the addendum section of this document.</para>
- + </sect3> - +
<sect3 id="s8"><title>Comment at the end of braces if the content is more than one screen length</title> @@ -930,12 +930,12 @@ if ( 1 == X ) } /* -END- if ( 1 == X ) */ </programlisting> </sect3> - + </sect2>
<sect2 id="s9"><title>Naming Conventions</title>
- +
<sect3 id="s10"><title>Variable Names</title>
@@ -960,9 +960,9 @@ int msiis5hack = 0; int msIis5Hack = 0; </programlisting> </para>
+
- - </sect3> + </sect3>
<sect3 id="s11"><title>Function Names</title>
@@ -988,9 +988,9 @@ int loadSomeFile( struct client_state *csp ) </programlisting> </para>
- + </sect3> - +
<sect3 id="s12"><title>Header file prototypes</title>
@@ -1007,15 +1007,15 @@ int loadSomeFile( struct client_state *csp )
<para><emphasis>Instead of:</emphasis> <programlisting> -(.h) extern int load_aclfile( struct client_state * ); or -(.h) extern int load_aclfile(); +(.h) extern int load_aclfile( struct client_state * ); or +(.h) extern int load_aclfile(); (.c) int load_aclfile( struct client_state *csp ) </programlisting> </para>
- + </sect3> - +
<sect3 id="s13"><title>Enumerations, and #defines</title>
@@ -1043,7 +1043,7 @@ int loadSomeFile( struct client_state *csp ) #endif /* def FEATURE_FORCE */ </programlisting> </sect3> - +
<sect3 id="s14"><title>Constants</title>
@@ -1065,23 +1065,23 @@ int loadSomeFile( struct client_state *csp )
<para> <programlisting> -#define USE_IMG_LST 1 or +#define USE_IMG_LST 1 or #define _USE_IMAGE_LIST 1 or -#define USE_IMAGE_LIST_ 1 or +#define USE_IMAGE_LIST_ 1 or #define use_image_list 1 or #define UseImageList 1 </programlisting> </para>
- + </sect3>
</sect2> - +
<sect2 id="s15"><title>Using Space</title>
- +
<sect3 id="s16"><title>Put braces on a line by themselves.</title>
@@ -1127,7 +1127,7 @@ while ( more lines are read ) } </programlisting> </sect3> - +
<sect3 id="s17"><title>ALL control statements should have a block</title> @@ -1160,9 +1160,9 @@ if ( this == that ) "feature". The "explanation" and "exception" from the point above also applies.</para>
- + </sect3> - +
<sect3 id="s18"><title>Do not belabor/blow-up boolean expressions</title> @@ -1181,9 +1181,9 @@ structure->flag = ( condition );</programlisting> to the project has at least a "good" knowledge of C/C++. (Hope I do not offend by that last comment ... 8-)</para>
- + </sect3> - +
<sect3 id="s19"><title>Use white space freely because it is free</title> @@ -1205,7 +1205,7 @@ if ( this_variable == this_variable ) first_value = old_value + ( ( some_value - another_value ) - whatever ) </programlisting> </sect3> - +
<sect3 id="s20"><title>Don't use white space around structure operators</title> @@ -1229,9 +1229,9 @@ function_name();</programlisting> <para><emphasis>Instead of:</emphasis> a_struct -> a_member; a_struct . a_member; function_name ();</para>
- + </sect3> - +
<sect3 id="s21"><title>Make the last brace of a function stand out</title> @@ -1267,9 +1267,9 @@ int function2( ... ) <para><emphasis>Status:</emphasis> developer-discretion on the number of blank lines. Enforced is the end of function comments.</para>
- + </sect3> - +
<sect3 id="s22"><title>Use 3 character indentions</title>
@@ -1306,11 +1306,11 @@ int function1( ... ) </sect3>
</sect2> - +
<sect2 id="s23"><title>Initializing</title>
- +
<sect3 id="s24"><title>Initialize all variables</title>
@@ -1337,11 +1337,11 @@ struct *ptr = NULL;</programlisting>
</sect3> </sect2> - +
<sect2 id="s25"><title>Functions</title>
- +
<sect3 id="s26"><title>Name functions that return a boolean as a question.</title> @@ -1358,7 +1358,7 @@ contains_an_image(); is_web_page_blank(); </programlisting> </sect3> - +
<sect3 id="s27"><title>Always specify a return type for a function.</title> @@ -1370,9 +1370,9 @@ is_web_page_blank(); purpose, and create a void return type if the function does not need to return anything.</para>
- + </sect3> - +
<sect3 id="s28"><title>Minimize function calls when iterating by using variables</title> @@ -1416,9 +1416,9 @@ for ( size_t cnt = 0; cnt < len; cnt++ ) *may* change or could *potentially* change, then you must code the function call in the for/while loop.</para>
- + </sect3> - +
<sect3 id="s29"><title>Pass and Return by Const Reference</title>
@@ -1437,9 +1437,9 @@ for ( size_t cnt = 0; cnt < len; cnt++ ) <para>Both these pointers are *const*! If the c runtime library maintainers do it, we should too.</para>
- + </sect3> - +
<sect3 id="s30"><title>Pass and Return by Value</title>
@@ -1453,9 +1453,9 @@ for ( size_t cnt = 0; cnt < len; cnt++ ) prototypes with "pass by value": int load_aclfile( struct client_state *csp )</para>
- + </sect3> - +
<sect3 id="s31"><title>Names of include files</title>
@@ -1478,7 +1478,7 @@ for ( size_t cnt = 0; cnt < len; cnt++ )
<para> <programlisting> -/* This is not a local include, but requires a path element. */ +/* This is not a local include, but requires a path element. */ #include <sys/fileName.h> </programlisting> </para> @@ -1487,9 +1487,9 @@ for ( size_t cnt = 0; cnt < len; cnt++ ) without a _very_ good reason. This duplicates the #include "file.h" behavior.</para>
- + </sect3> - +
<sect3 id="s32"><title>Provide multiple inclusion protection</title> @@ -1512,7 +1512,7 @@ for ( size_t cnt = 0; cnt < len; cnt++ ) #endif /* ndef PROJECT_H_INCLUDED */ </programlisting> </sect3> - +
<sect3 id="s33"><title>Use `extern "C"` when appropriate</title>
@@ -1536,7 +1536,7 @@ extern "C" #endif /* def __cplusplus */ </programlisting> </sect3> - +
<sect3 id="s34"><title>Where Possible, Use Forward Struct Declaration Instead of Includes</title> @@ -1562,13 +1562,13 @@ extern file_list *xyz;</programlisting>
<para><emphasis>Status:</emphasis> Use with discretion.</para>
- + </sect3> </sect2>
<sect2 id="s35"><title>General Coding Practices</title>
- +
<sect3 id="s36"><title>Turn on warnings</title>
@@ -1578,9 +1578,9 @@ extern file_list *xyz;</programlisting> should turn on as many as possible. With GCC, the switch is "-Wall". Try and fix as many warnings as possible.</para>
- + </sect3> - +
<sect3 id="s37"><title>Provide a default case for all switch statements</title> @@ -1623,9 +1623,9 @@ switch( hash_string( cmd ) )
<para><emphasis>Status:</emphasis> Programmer discretion is advised.</para>
- + </sect3> - +
<sect3 id="s38"><title>Try to avoid falling through cases in a switch statement.</title> @@ -1648,9 +1648,9 @@ switch( hash_string( cmd ) ) the fact of the fall through and reason why you felt it was necessary.</para>
- + </sect3> - +
<sect3 id="s39"><title>Use 'long' or 'short' Instead of 'int'</title> @@ -1666,9 +1666,9 @@ switch( hash_string( cmd ) ) now). Should we add these to IJB now that we have a "configure" script?</para>
- + </sect3> - +
<sect3 id="s40"><title>Don't mix size_t and other types</title>
@@ -1680,9 +1680,9 @@ switch( hash_string( cmd ) ) variable of a different type (or even against a constant) without casting one of the values.</para>
- + </sect3> - +
<sect3 id="s41"><title>Declare each variable and struct on its own line.</title> @@ -1715,9 +1715,9 @@ long c = 0;</programlisting>
<para><emphasis>Status:</emphasis> developer-discretion.</para>
- + </sect3> - +
<sect3 id="s42"><title>Use malloc/zalloc sparingly</title>
@@ -1735,7 +1735,7 @@ If a function creates a struct and stores a pointer to it in a list, then it should definitely be allocated via `malloc'. </programlisting> </sect3> - +
<sect3 id="s43"><title>The Programmer Who Uses 'malloc' is Responsible for Ensuring 'free'</title> @@ -1765,9 +1765,9 @@ static void unload_re_filterfile( void *f ) { ... }</programlisting> standard is for allocating and freeing data structures (complex or nested).</para>
- + </sect3> - +
<sect3 id="s44"><title>Add loaders to the `file_list' structure and in order</title> @@ -1783,9 +1783,9 @@ static void unload_re_filterfile( void *f ) { ... }</programlisting> POPUPs can also be referred to as KILLPOPUPs, it is clear that it should come first.</para>
- + </sect3> - +
<sect3 id="s45"><title>"Uncertain" new code and/or changes to existing code, use FIXME or XXX</title> @@ -1815,7 +1815,7 @@ static void unload_re_filterfile( void *f ) { ... }</programlisting> include in the project (or conversely exclude from the project).</para>
- + </sect3>
</sect2> @@ -1850,10 +1850,13 @@ const char FILENAME_rcs[] = "$I<!-- Break CVS Substitution -->d$"; * The GNU General Public License should be included with * this file. If not, you can view it at * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html - * or write to the Free Software Foundation, Inc., + * or write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 , * USA * + * Revisions : + * $L<!-- Break CVS Substitution -->og$ + * *********************************************************************/
@@ -1904,10 +1907,13 @@ const char FILENAME_h_rcs[] = FILENAME_H_VERSION; * The GNU General Public License should be included with * this file. If not, you can view it at * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html - * or write to the Free Software Foundation, Inc., + * or write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 , * USA * + * Revisions : + * $L<!-- Break CVS Substitution -->og$ + * *********************************************************************/
@@ -2011,7 +2017,7 @@ Install the rpm. Any error messages? Please submit test reports only with the <ulink url="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=395005">test form</ulink> at sourceforge. Three simple steps: <itemizedlist> - + <listitem><para>Select category: the distribution you test on.</para></listitem> <listitem><para>Select group: the version of <application>Privoxy</application> that we are about to release.</para></listitem> <listitem><para>Fill the Summary and Detailed Description with something @@ -2021,7 +2027,7 @@ at sourceforge. Three simple steps: Do not mail to the mailing list (we cannot keep track on issues there). </para> </sect2> - + </sect1>
<!-- ~~~~~ New section ~~~~~ --> @@ -2049,7 +2055,7 @@ at sourceforge. Three simple steps: <title>Version numbers</title>
<para> - First you need to determine which version number the release will have. + First you need to determine which version number the release will have. <application>Privoxy</application> version numbers consist of three numbers, separated by dots, like in X.Y.Z (e.g. 3.0.0), where: <itemizedlist> @@ -2057,7 +2063,7 @@ at sourceforge. Three simple steps: <para> X, the version major, is rarely ever changed. It is increased by one if turning a development branch into stable substantially changes the functionality, - user interface or configuration syntax. Majors 1 and 2 were + user interface or configuration syntax. Majors 1 and 2 were <application>Junkbuster</application>, and 3 will be the first stable <application>Privoxy</application> release. </para> @@ -2081,7 +2087,7 @@ at sourceforge. Three simple steps: <listitem> <para> Z, the point or sub version, represents a release of the software within a branch. - It is therefore incremented immediately before each code freeze. + It is therefore incremented immediately before each code freeze. In development branches, only the even point versions correspond to actual releases, while the odd ones denote the evolving state of the sources on CVS in between. It follows that Z is odd on CVS in development branches most of the time. There, it gets @@ -2094,11 +2100,11 @@ at sourceforge. Three simple steps: Stable branches work a little differently, since there should be little to no development happening in such branches. Remember, only bugfixes, which presumably should have had some testing - before being committed. Stable branches will then have their - version reported as <literal>0.0.0</literal>, during that period - between releases when changes are being added. This is to denote - that this code is <emphasis>not for release</emphasis>. Then - as the release nears, the version is bumped according: e.g. + before being committed. Stable branches will then have their + version reported as <literal>0.0.0</literal>, during that period + between releases when changes are being added. This is to denote + that this code is <emphasis>not for release</emphasis>. Then + as the release nears, the version is bumped according: e.g. <literal>3.0.1 -> 0.0.0 -> 3.0.2</literal>. </para> </listitem> @@ -2120,16 +2126,16 @@ at sourceforge. Three simple steps: <emphasis>before</emphasis> committing to a stable branch! </para> <para> - Developers should remember too that if they commit a bugfix to the stable - branch, this will more than likely require a separate submission to the - main trunk, since these are separate development trees within CVS. If you + Developers should remember too that if they commit a bugfix to the stable + branch, this will more than likely require a separate submission to the + main trunk, since these are separate development trees within CVS. If you are working on both, then this would require at least two separate check outs (i.e main trunk, <emphasis>and</emphasis> the stable release branch, which is <literal>v_3_0_branch</literal> at the moment). </para>
</sect2> - + <sect2 id="beforerelease"> <title>Before the Release: Freeze</title> <para> @@ -2145,26 +2151,26 @@ at sourceforge. Three simple steps: they have pending changes/fixes in their pipelines. Announce the freeze so that nobody will interfere with last minute changes. </para> - </listitem> + </listitem> <listitem> <para> Increment the version number (point from odd to even in development - branches!) in <filename>configure.in</filename>. (RPM spec files + branches!) in <filename>configure.in</filename>. (RPM spec files will need to be incremented as well.) </para> - </listitem> + </listitem> <listitem> <para> If <filename>default.action</filename> has changed since last release (i.e. software release or standalone actions file release), bump up its version info to A.B in this line: </para> - <para> + <para> <programlisting> {+add-header{X-Actions-File-Version: A.B} -filter -no-popups} </programlisting> </para> - <para> + <para> Then change the version info in doc/webserver/actions/index.php, line: '$required_actions_file_version = "A.B";' </para> @@ -2172,36 +2178,36 @@ at sourceforge. Three simple steps: <listitem> <para> All documentation should be rebuild after the version bump. - Finished docs should be then be committed to CVS (for those - without the ability to build these). Some docs may require + Finished docs should be then be committed to CVS (for those + without the ability to build these). Some docs may require rather obscure processing tools. <filename>config</filename>, the man page (and the html version of the man page), and the PDF docs fall in this category. REAMDE, the man page, AUTHORS, and config - should all also be committed to CVS for other packagers. The + should all also be committed to CVS for other packagers. The formal docs should be uploaded to the webserver. See the Section "Updating the webserver" in this manual for details. </para> - </listitem> + </listitem> <listitem> <para> - The <citetitle>User Manual</citetitle> is also used for context + The <citetitle>User Manual</citetitle> is also used for context sensitive help for the CGI editor. This is version sensitive, so that - the user will get appropriate help for his/her release. So with + the user will get appropriate help for his/her release. So with each release a fresh version should be uploaded to the webserver (this is in addition to the main <citetitle>User Manual</citetitle> - link from the main page since we need to keep manuals for various - versions available). The CGI pages will link to something like + link from the main page since we need to keep manuals for various + versions available). The CGI pages will link to something like <literal>http://privoxy.org/$(VERSION)/user-manual/</literal>. This will need to be updated for each new release. There is no Makefile target for this at this time!!! It needs to be done manually. </para> - </listitem> + </listitem> <listitem> <para> All developers should look at the <filename>ChangeLog</filename> and make sure noteworthy changes are referenced. </para> - </listitem> + </listitem> <listitem> <para> <emphasis>Commit all files that were changed in the above steps!</emphasis> @@ -2213,14 +2219,14 @@ at sourceforge. Three simple steps: <quote><command>cvs tag v_X_Y_Z</command></quote>. Don't use vX_Y_Z, ver_X_Y_Z, v_X.Y.Z (won't work) etc. </para> - </listitem> + </listitem> <listitem> <para> If the release was in a development branch, increase the point version from even to odd (X.Y.(Z+1)) again in <filename>configure.in</filename> and commit your change. </para> - </listitem> + </listitem> <listitem> <para> On the webserver, copy the user manual to a new top-level directory @@ -2228,27 +2234,27 @@ at sourceforge. Three simple steps: pages, which have the version as a prefix, will go into the right version of the manual. If this is a development branch release, also symlink <filename>X.Y.(Z-1)</filename> to <filename>X.Y.Z</filename> and <filename>X.Y.(Z+1)</filename> to - <filename>.</filename> (i.e. dot). + <filename>.</filename> (i.e. dot). </para> - </listitem> + </listitem> </itemizedlist> - </para> + </para> </sect2> - + <sect2 id="therelease"> <title>Building and Releasing the Packages</title> <para> Now the individual packages can be built and released. Note that for GPL reasons the first package to be released is always the source tarball. </para> - + <para> For <emphasis>all</emphasis> types of packages, including the source tarball, <emphasis>you must make sure that you build from clean sources by exporting the right version from CVS into an empty directory</emphasis> (just press return when asked for a password): </para> - + <para> <programlisting> mkdir dist # delete or choose different name if it already exists @@ -2257,20 +2263,20 @@ at sourceforge. Three simple steps: cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa export -r v_X_Y_Z current </programlisting> </para> - + <para> <emphasis>Do NOT change</emphasis> a single bit, including, but not limited to version information after export from CVS. This is to make sure that all release packages, and with them, all future bug reports, are based on exactly the same code. </para> - + <warning> <para> - Every significant release of Privoxy has included at least one - package that either had incorrect versions of files, missing files, - or incidental leftovers from a previous build process that gave - unknown numbers of users headaches to try to figure out what was + Every significant release of Privoxy has included at least one + package that either had incorrect versions of files, missing files, + or incidental leftovers from a previous build process that gave + unknown numbers of users headaches to try to figure out what was wrong. PLEASE, make sure you are using pristene sources, and are following the prescribed process! </para> @@ -2278,14 +2284,14 @@ at sourceforge. Three simple steps:
<para> Please find additional instructions for the source tarball and the - individual platform dependent binary packages below. And details + individual platform dependent binary packages below. And details on the Sourceforge release process below that. </para>
<sect3 id="pack-guidelines"> <title>Note on Privoxy Packaging</title> <para> - Please keep these general guidelines in mind when putting together + Please keep these general guidelines in mind when putting together your package. These apply to <emphasis>all</emphasis> platforms! </para> <para> @@ -2293,11 +2299,11 @@ at sourceforge. Three simple steps: <listitem> <para> <application>Privoxy</application> <emphasis>requires</emphasis> - write access to: all <filename>*.action</filename> files, all - logfiles, and the <filename>trust</filename> file. You will + write access to: all <filename>*.action</filename> files, all + logfiles, and the <filename>trust</filename> file. You will need to determine the best way to do this for your platform. </para> - </listitem> + </listitem> <listitem> <para> Please include up to date documentation. At a bare minimum: @@ -2343,11 +2349,11 @@ at sourceforge. Three simple steps: </para> <para> The documentation has been designed such that the manuals are linked - to each other from parallel directories, and should be packaged + to each other from parallel directories, and should be packaged that way. <filename>privoxy-index.html</filename> can also be included and can serve as a focal point for docs and other links of interest (and possibly renamed to <filename>index.html</filename>). - This should be one level up from the manuals. There is a link also + This should be one level up from the manuals. There is a link also on this page to an HTMLized version of the man page. To avoid 404 for this, it is in CVS as <filename>doc/webserver/man-page/privoxy-man-page.html</filename>, @@ -2357,16 +2363,16 @@ at sourceforge. Three simple steps: with <filename>privoxy-index.html</filename>, (i.e. one level up from the manual directories). </para> - </listitem> + </listitem> <listitem> <para> <filename>user.action</filename> and <filename>user.filter</filename> are designed for local preferences. Make sure these do not get overwritten! - <filename>config</filename> should not be overwritten either. This + <filename>config</filename> should not be overwritten either. This has especially important configuration data in it. <filename>trust</filename> should be left in tact as well. </para> - </listitem> + </listitem> <listitem> <para> Other configuration files (<filename>default.action</filename> and @@ -2376,29 +2382,29 @@ at sourceforge. Three simple steps: likely to change between releases and contain important new features and bug fixes. </para> - </listitem> + </listitem> <listitem> <para> - Please check platform specific notes in this doc, if you haven't - done <quote>Privoxy</quote> packaging before for other platform - specific issues. Conversely, please add any notes that you know - are important for your platform (or contact one of the doc + Please check platform specific notes in this doc, if you haven't + done <quote>Privoxy</quote> packaging before for other platform + specific issues. Conversely, please add any notes that you know + are important for your platform (or contact one of the doc maintainers to do this if you can't). </para> - </listitem> + </listitem> <listitem> <para> - Packagers should do a <quote>clean</quote> install of their - package after building it. So any previous installs should be - removed first to ensure the integrity of the newly built package. - Then run the package for a while to make sure there are no + Packagers should do a <quote>clean</quote> install of their + package after building it. So any previous installs should be + removed first to ensure the integrity of the newly built package. + Then run the package for a while to make sure there are no obvious problems, before uploading. </para> - </listitem> + </listitem>
</itemizedlist> - </para> - + </para> + </sect3>
<sect3 id="newrelease-tarball"><title>Source Tarball</title> @@ -2444,7 +2450,7 @@ at sourceforge. Three simple steps: <para> First, <emphasis>make sure that you have freshly exported the right version into an empty directory</emphasis>. (See "Building and releasing - packages" above). + packages" above). </para> <para> As the only exception to not changing anything after export from CVS, @@ -2515,7 +2521,7 @@ at sourceforge. Three simple steps: <para> Change directory to the <filename>os2setup</filename> directory. Edit the os2build.cmd file to set the final executable filename. - For example, + For example, </para> <para> <programlisting> @@ -2635,7 +2641,7 @@ at sourceforge. Three simple steps: </programlisting> </para> <para> - Then, run: + Then, run: </para> <para> <programlisting> @@ -2693,7 +2699,7 @@ at sourceforge. Three simple steps: </programlisting> </para> <para> - You can then upload <filename>privoxyosx_setup_x.y.z.zip</filename> anonymously to + You can then upload <filename>privoxyosx_setup_x.y.z.zip</filename> anonymously to <filename>uploads.sourceforge.net/incoming</filename>, create a release for it, and you're done. Use the release notes and Change Log from the source tarball package. @@ -2814,7 +2820,7 @@ at sourceforge. Three simple steps: <sect2 id="releasing"> <title>Uploading and Releasing Your Package</title> <para> - After the package is ready, it is time to upload it + After the package is ready, it is time to upload it to SourceForge, and go through the release steps. The upload is done via FTP: </para> @@ -2824,47 +2830,47 @@ at sourceforge. Three simple steps: <para> Upload to: <ulink url="ftp://upload.sourceforge.net/incoming">ftp://upload.sourceforge.net/incoming</ulink> </para> - </listitem> + </listitem> <listitem> <para> user: <literal>anonymous</literal> </para> - </listitem> + </listitem> <listitem> <para> password: <literal>ijbswa-developers@lists.sourceforge.net</literal> </para> - </listitem> + </listitem> </itemizedlist> - </para> + </para> <para> Or use the <command>make</command> targets as described above. </para> <para> Once this done go to <ulink url="https://sourceforge.net/project/admin/editpackages.php?group_id=11118" - >https://sourceforge.net/project/admin/editpackages.php?group_id=11118</ulink>, - making sure you are logged in. Find your target platform in the - second column, and click <literal>Add Release</literal>. You will - then need to create a new release for your package, using the format + >https://sourceforge.net/project/admin/editpackages.php?group_id=11118</ulink>, + making sure you are logged in. Find your target platform in the + second column, and click <literal>Add Release</literal>. You will + then need to create a new release for your package, using the format of <literal>$VERSION ($CODE_STATUS)</literal>, e.g. <emphasis>&p-version; (beta)</emphasis>. </para> <para> Now just follow the prompts. Be sure to add any appropriate Release - notes. You should see your freshly uploaded packages in - <quote>Step 2. Add Files To This Release</quote>. Check the - appropriate box(es). Remember at each step to hit the - <quote>Refresh/Submit</quote> buttons! You should now see your - file(s) listed in Step 3. Fill out the forms with the appropriate + notes. You should see your freshly uploaded packages in + <quote>Step 2. Add Files To This Release</quote>. Check the + appropriate box(es). Remember at each step to hit the + <quote>Refresh/Submit</quote> buttons! You should now see your + file(s) listed in Step 3. Fill out the forms with the appropriate information for your platform, being sure to hit <quote>Update</quote> - for each file. If anyone is monitoring your platform, check the - <quote>email</quote> box at the very bottom to notify them of + for each file. If anyone is monitoring your platform, check the + <quote>email</quote> box at the very bottom to notify them of the new package. This should do it! </para> <para> - If you have made errors, or need to make changes, you can go through - essentially the same steps, but select <literal>Edit Release</literal>, + If you have made errors, or need to make changes, you can go through + essentially the same steps, but select <literal>Edit Release</literal>, instead of <literal>Add Release</literal>. </para> </sect2> @@ -2878,20 +2884,20 @@ at sourceforge. Three simple steps: include the <ulink url="http://sourceforge.net/project/showfiles.php?group_id=11118">download location</ulink>, the release notes and the Changelog. Also, post an - updated News item on the project page Sourceforge, and update the Home + updated News item on the project page Sourceforge, and update the Home page and docs linked from the Home page (see below). Other news sites and release oriented sites, such as Freshmeat, should also be notified. </para> </sect2>
</sect1> - + <!-- ~~~~~ New section ~~~~~ --> <sect1 id="webserver-update"><title>Update the Webserver</title> <para> The webserver should be updated at least with each stable release. When updating, please follow these steps to make sure that no broken links, - inconsistent contents or permission problems will occur (as it has many + inconsistent contents or permission problems will occur (as it has many times in the past!): </para> <para> @@ -2906,7 +2912,7 @@ at sourceforge. Three simple steps: <para> That will generate <filename>doc/webserver/user-manual</filename>, <filename>doc/webserver/developer-manual</filename>, - <filename>doc/webserver/faq</filename>, + <filename>doc/webserver/faq</filename>, <filename>doc/pdf/*.pdf</filename> and <filename>doc/webserver/index.html</filename> automatically. </para> @@ -2923,7 +2929,7 @@ at sourceforge. Three simple steps: create new directories under <filename>doc/webserver</filename>). </para> <para> - Next, commit any changes from the above steps to CVS. All set? + Next, commit any changes from the above steps to CVS. All set? If these are docs in the stable branch, then do: </para> <para> @@ -2950,7 +2956,7 @@ at sourceforge. Three simple steps: &contacting; <!-- end contacting --> </sect1> - +
<!-- ~~~~~~~~ New section Header ~~~~~~~~~ --> <sect1 id="copyright"><title>Privoxy Copyright, License and History</title> @@ -2975,7 +2981,7 @@ at sourceforge. Three simple steps: </sect2>
</sect1> - + <!-- ~~~~~ New section ~~~~~ --> <sect1 id="seealso"><title>See also</title> <!-- Include seealso.sgml --> @@ -2986,7 +2992,7 @@ at sourceforge. Three simple steps:
<!--
- This program is free software; you can redistribute it + This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at @@ -3005,41 +3011,6 @@ at sourceforge. Three simple steps: Temple Place - Suite 330, Boston, MA 02111-1307, USA.
$Log: developer-manual.sgml,v $ - Revision 2.38 2011/12/26 17:05:40 fabiankeil - Bump entities for 3.0.19 - - Revision 2.37 2011/11/13 17:03:54 fabiankeil - Bump entities for 3.0.18 stable - - Revision 2.36 2011/09/04 11:10:12 fabiankeil - Ditch trailing whitespace - - Revision 2.35 2011/08/17 10:40:07 fabiankeil - Update the entities. - - This commit is chronological out of order. - - Revision 2.34 2010/11/06 12:55:48 fabiankeil - Set p-version to 3.0.17 - - Revision 2.33 2010/02/13 17:38:27 fabiankeil - Update entities for 3.0.16 stable. - - Revision 2.32 2009/11/15 14:24:12 fabiankeil - Prepare to generate docs for 3.0.16 UNRELEASED. - - Revision 2.31 2009/10/10 05:48:55 fabiankeil - Prepare for 3.0.15 beta. - - Revision 2.30 2009/07/18 16:24:39 fabiankeil - Bump entities for 3.0.14 beta. - - Revision 2.29 2009/06/12 14:30:58 fabiankeil - Update entities for 3.0.13 beta. - - Revision 2.28 2009/05/16 13:27:21 fabiankeil - Remove CVS revision logs. TODO item #33. - Revision 2.27 2009/02/19 02:20:22 hal9 Make some links in seealso conditional. Man page is now privoxy only links.
diff --git a/external/privoxy/doc/source/faq.sgml b/external/privoxy/doc/source/faq.sgml index 0eff63f..7684e8e 100644 --- a/external/privoxy/doc/source/faq.sgml +++ b/external/privoxy/doc/source/faq.sgml @@ -1,5 +1,5 @@ <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[ -<!entity % dummy "IGNORE"> +<!entity % dummy "IGNORE"> <!entity supported SYSTEM "supported.sgml"> <!entity newfeatures SYSTEM "newfeatures.sgml"> <!entity p-intro SYSTEM "privoxy.sgml"> @@ -8,7 +8,7 @@ <!entity history SYSTEM "history.sgml"> <!entity copyright SYSTEM "copyright.sgml"> <!entity license SYSTEM "license.sgml"> -<!entity p-version "3.0.19"> +<!entity p-version "3.0.11"> <!entity p-status "stable"> <!entity % p-not-stable "IGNORE"> <!entity % p-stable "INCLUDE"> @@ -26,8 +26,8 @@ Purpose : FAQ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - - $Id: faq.sgml,v 2.85 2011/12/26 17:05:40 fabiankeil Exp $ + + $Id: faq.sgml,v 2.58 2009/03/21 12:27:44 fabiankeil Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE. @@ -39,12 +39,12 @@ <Qandaset defaultlabel='qanda'> <QandAEntry> <question> - <para> + <para> How are you? </para> </question> <answer> - <para> + <para> Fine. </para> </answer> @@ -52,12 +52,12 @@ </QandASet>
======================================================================== - NOTE: Please read developer-manual/documentation.html before touching + NOTE: Please read developer-manual/documentation.html before touching this file!
- Please we keep the info in this file as version independent as possible - so we only have to maintain one FAQ. Where significant changes are - made to Privoxy configuration, please note the change in such a way that + Please we keep the info in this file as version independent as possible + so we only have to maintain one FAQ. Where significant changes are + made to Privoxy configuration, please note the change in such a way that it makes sense to both users of older and newer versions. ========================================================================
@@ -73,23 +73,23 @@ <subscript> <!-- Completely the wrong markup, but very little is allowed --> <!-- in this part of an article. FIXME --> - <link linkend="copyright">Copyright</link> &my-copy; 2001-2011 by + <link linkend="copyright">Copyright</link> &my-copy; 2001-2009 by <ulink url="http://www.privoxy.org/">Privoxy Developers</ulink> </subscript> </pubdate>
-<pubdate>$Id: faq.sgml,v 2.85 2011/12/26 17:05:40 fabiankeil Exp $</pubdate> +<pubdate>$Id: faq.sgml,v 2.58 2009/03/21 12:27:44 fabiankeil Exp $</pubdate>
<!--
-Note: this should generate a separate page, and a live link to it. +Note: this should generate a separate page, and a live link to it. But it doesn't for some mysterious reason. Please leave commented -unless it can be fixed proper. For the time being, the copyright +unless it can be fixed proper. For the time being, the copyright statement will be in copyright.smgl.
Hal.
-<legalnotice id="legalnotice"> +<legalnotice id="legalnotice"> <para> text goes here ........ </para> @@ -119,12 +119,12 @@ Hal. <para> This FAQ gives quick answers to frequently asked questions about <ulink url="http://www.privoxy.org/">Privoxy</ulink>. - It is not a substitute for the + It is not a substitute for the <ulink url="../user-manual/index.html"><citetitle>Privoxy User Manual</citetitle></ulink>. -<!-- +<!-- This works, at least in some situtations: Test: <ulink url="privoxy-user-manual.pdf"><citetitle>User Manual</citetitle></ulink>. ---> +--> </para>
<!-- Include privoxy.sgml boilerplate: --> @@ -137,7 +137,7 @@ Hal. You can find the latest version of the document at <ulink url="http://www.privoxy.org/faq/">http://www.privoxy.org/faq/</ulink>. Please see the <link linkend="contact">Contact section</link> if you want to - contact the developers. + contact the developers. </para>
<!-- <para> --> @@ -152,7 +152,7 @@ Hal. <sect1 id="general"><title>General Information</title> <sect2 renderas="sect3" id="who-uses"><title>Who should give &my-app; a try?</title> <para> - Anyone who is interested in security, privacy, or in + Anyone who is interested in security, privacy, or in finer-grained control over their web and Internet experience. </para> </sect2> @@ -160,7 +160,7 @@ Hal. <sect2 renderas="sect3" id="bestchoice"><title>Is Privoxy the best choice for me?</title> <para> - &my-app; is certainly a good choice, especially for those who want more + &my-app; is certainly a good choice, especially for those who want more control and security. Those with the willingness to read the documentation and the ability to fine-tune their installation will benefit the most. </para> @@ -170,19 +170,19 @@ me?</title> completely personalize your installation. Being familiar with, or at least having an interest in learning about <ulink url="http://en.wikipedia.org/wiki/Http">HTTP</ulink> and other networking - protocols, <ulink url="http://en.wikipedia.org/wiki/Html">HTML</ulink>, and + protocols, <ulink url="http://en.wikipedia.org/wiki/Html">HTML</ulink>, and <ulink url="http://en.wikipedia.org/wiki/Regular_expressions"><quote>Regular Expressions</quote></ulink> - will be a big plus and will help you get the most out of &my-app;. - A new installation just includes a very basic configuration. The user - should take this as a starting point only, and enhance it as he or she - sees fit. In fact, the user is encouraged, and expected to, fine-tune the + will be a big plus and will help you get the most out of &my-app;. + A new installation just includes a very basic configuration. The user + should take this as a starting point only, and enhance it as he or she + sees fit. In fact, the user is encouraged, and expected to, fine-tune the configuration. </para> <para> - Much of <application>Privoxy's</application> configuration can be done + Much of <application>Privoxy's</application> configuration can be done with a <ulink url="http://en.wikipedia.org/wiki/Web_browser">Web browser</ulink>. - But there are areas where configuration is done using a + But there are areas where configuration is done using a <ulink url="http://en.wikipedia.org/wiki/Text_editors">text editor</ulink> to edit configuration files. Also note that the web-based action editor doesn't use authentication and should only be enabled in environments @@ -220,13 +220,13 @@ Privoxy work? </title>
<sect2 renderas="sect3" id="otherstuff"> <title>Does Privoxy do anything more than ad blocking?</title> - <para> - Yes, ad blocking is but one possible use. There are many, many ways &my-app; - can be used to sanitize and customize web browsing. + <para> + Yes, ad blocking is but one possible use. There are many, many ways &my-app; + can be used to sanitize and customize web browsing. </para> </sect2>
-<sect2 renderas="sect3" id="newjb"><title>What is this new version of +<sect2 renderas="sect3" id="newjb"><title>What is this new version of <quote><citetitle>Junkbuster</citetitle></quote>?</title>
<!-- Include history.sgml --> @@ -247,20 +247,20 @@ Junkbuster at all?</title> led to confusion. </para> <para> - There are also potential legal complications from our use of the - <application>Junkbuster</application> name, which is a registered trademark of + There are also potential legal complications from our use of the + <application>Junkbuster</application> name, which is a registered trademark of <ulink url="http://junkbusters.com/">Junkbusters Corporation</ulink>. - There are, however, no objections from Junkbusters Corporation to the + There are, however, no objections from Junkbusters Corporation to the <application>Privoxy</application> project itself, and they, in fact, still share our ideals and goals. </para> <para> - The developers also believed that there are so many improvements over the original - code, that it was time to make a clean break from the past and make + The developers also believed that there are so many improvements over the original + code, that it was time to make a clean break from the past and make a name in their own right. </para> <para> - <application>Privoxy</application> is the + <application>Privoxy</application> is the <quote><emphasis>Privacy Enhancing Proxy</emphasis></quote>. Also, its content modification and junk suppression gives <emphasis>you</emphasis>, the user, more control, more freedom, and allows you to browse your personal and @@ -269,7 +269,7 @@ Junkbuster at all?</title> </sect2>
<sect2 renderas="sect3" id="differs"><title>How does Privoxy differ -from the old Junkbuster?</title> +from the old Junkbuster?</title> <para> <application>Privoxy</application> picks up where <application>Junkbuster</application> left off. @@ -283,7 +283,7 @@ from the old Junkbuster?</title> <application>Privoxy</application>'s new features include: </para>
-<!-- Include newfeatures.sgml: --> +<!-- Include newfeatures.sgml: --> &newfeatures; <!-- end include -->
@@ -302,7 +302,7 @@ an ad, and what is not?</title> and the host (blocking the big banner hosting services like doublecklick.net already helps a lot). <application>Privoxy</application> takes advantage of this fact by using <ulink url="../user-manual/actions-file.html#AF-PATTERNS">URL - patterns</ulink> to sort out and block the requests for things that sound + patterns</ulink> to sort out and block the requests for things that sound like they would be ads or banners. </para> <para> @@ -320,7 +320,7 @@ an ad, and what is not?</title> </sect2>
<sect2 renderas="sect3"> -<title id="mistakes">Can Privoxy make mistakes? +<title id="mistakes">Can Privoxy make mistakes? This does not sound very scientific.</title> <para> Actually, it's a black art ;-) And yes, it is always possible to have a broad @@ -347,12 +347,12 @@ This does not sound very scientific.</title> The default installation should give you a good starting point, and block <emphasis>most</emphasis> ads and unwanted content, but many of the more advanced features are off by default, and require - you to activate them. + you to activate them. </para> <para> You do have to set up your browser to use <application>Privoxy</application> (see the <link - linkend="firststep">Installation section below</link>). + linkend="firststep">Installation section below</link>). </para> <para> And you will certainly run into situations where there are false positives, @@ -367,7 +367,7 @@ This does not sound very scientific.</title>
<sect2 renderas="sect3" id="lan"> <title>Can Privoxy run as a server on a network?</title> - <para> + <para> Yes, &my-app; runs as a server already, and can easily be configured to <quote>serve</quote> more than one client. See <link linkend="lanconfig"> How can I set up Privoxy to act as a proxy for my LAN</link> below. @@ -384,8 +384,8 @@ Privoxy. Why should I use Privoxy at all?</title> your browser just can't. </para> <para> - In addition, a proxy is good choice if you use multiple browsers, or - have a LAN with multiple computers since &my-app; can run as a server + In addition, a proxy is good choice if you use multiple browsers, or + have a LAN with multiple computers since &my-app; can run as a server application. This way all the configuration is in one place, and you don't have to maintain a similar configuration for possibly many browsers or users. @@ -404,8 +404,8 @@ Privoxy. Why should I use Privoxy at all?</title> The most important reason is because you have access to <emphasis>everything</emphasis>, and you can control everything. You can check every line of every configuration file yourself. You can check every - last bit of source code should you desire. And even if you can't read code, - there should be some comfort in knowing that <!-- thousands of -->other people can, + last bit of source code should you desire. And even if you can't read code, + there should be some comfort in knowing that <!-- thousands of -->other people can, and do read it. You can build the software from scratch, if you want, so that you know the executable is clean, and that it is <emphasis>yours</emphasis>. In fact, we encourage this level of scrutiny. It @@ -413,14 +413,14 @@ Privoxy. Why should I use Privoxy at all?</title> </para> </sect2>
-<sect2 renderas="sect3" id="license"><title>Is there is a license or fee? What about a +<sect2 renderas="sect3" id="license"><title>Is there is a license or fee? What about a warranty? Registration?</title> <para> <application>Privoxy</application> is free software and licensed under the <ulink url="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html">GNU General Public License (GPL) version 2</ulink>. It is free to use, copy, modify or distribute as you wish under the terms of this license. Please see the <link linkend="copyright">Copyright</link> section for more - information on the license and copyright. Or the <filename>LICENSE</filename> file + information on the license and copyright. Or the <filename>LICENSE</filename> file that should be included. </para> <para> @@ -464,9 +464,9 @@ warranty? Registration?</title> </para> </sect2>
-<sect2 renderas="sect3" id="help-the-developers"><title id="jointeam">I would like to help you, what can I do?</title> +<sect2 renderas="sect3" id="jointeam"><title>I would like to help you, what can I do?</title>
-<sect3 renderas="sect4" id="participate"><title id="jointeam-work">Would you like to participate?</title> +<sect3 renderas="sect4" id="jointeam-work"><title>Would you like to participate?</title> <para> Well, we <emphasis>always</emphasis> need help. There is something for everybody who wants to help us. We welcome new developers, packagers, @@ -475,92 +475,59 @@ warranty? Registration?</title> <quote>programmer</quote>. There are many other tasks available. In fact, the programmers often can't spend as much time programming because of some of the other, more mundane things that need to be done, like checking the - Tracker feedback sections or responding to user questions on the mailing - lists. + Tracker feedback sections. </para> <para> - So first thing, subscribe to the <ulink - url="https://lists.sourceforge.net/lists/listinfo/ijbswa-users">Privoxy Users</ulink> - or the <ulink url="https://lists.sourceforge.net/lists/listinfo/ijbswa-developers">Privoxy - Developers</ulink> mailing list, join the discussion, help out other users, provide general - feedback or report problems you noticed. - </para> - <para> - If you intend to help out with the trackers, you also might want to <ulink + So first thing, <ulink url="https://sourceforge.net/account/register.php">get an account on SourceForge.net</ulink> - so we don't confuse you with the other name-less users. - </para> - <para> - We also have a <ulink - url="../developer-manual/index.html">Developer's Manual</ulink>. - While it is partly out of date, it's still worth reading. -</para> -<para> - Our <ulink url="http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/current/TODO?view=markup">TODO list</ulink> - may be of interest to you as well. - Please let us know if you want to work on one of the items listed. + and mail your id to the <ulink url="mailto:ijbswa-developers@lists.sourceforge.net">developers + mailing list</ulink>. Then, please read the <ulink + url="../developer-manual/index.html">Developer's Manual</ulink>, at least + the pertinent sections. </para> + <para> + You can also start helping out without SourceForge.net account, + simply by showing up on the mailing list, helping out other users, + providing general feedback or reporting problems you noticed. + </para> </sect3>
<sect3 renderas="sect4" id="donate"><title>Would you like to donate?</title> <para> <application>Privoxy</application> is developed by unpaid volunteers and thus our current running costs are pretty low. Nevertheless, we - have plans that will cost money in the future. They include, - but aren't limited to spending money on: - -</para> - -<para> -<itemizedlist> - <listitem> - <para> - Hardware to help make sure <application>Privoxy</application> - keeps running on platforms the developers currently can't test - on and can be ported to others. - </para> - </listitem> - <listitem> - <para> - Technical books to educate our developers about said platforms - or to improve their knowledge in general. - </para> - </listitem> - <listitem> - <para> - More reliable hosting, - </para> - </listitem> -</itemizedlist> + have plans that will cost money in the future. We would like to get + this money through donations made by our users. </para>
<para> - We would like to get this money through donations made by our users. + <application>Privoxy</application> has therefore become an associated + project of <ulink url="http://www.spi-inc.org/about-spi/about-spi">Software + in the Public Interest (SPI)</ulink>, which allows us to receive tax-deductible + donations in most western countries. </para>
<para> - <application>Privoxy</application> has therefore become an associated - project of <ulink url="http://www.spi-inc.org/about-spi/about-spi">Software - in the Public Interest (SPI)</ulink>, which allows us to receive donations. - In the United States they are tax-deductible, in a few other western countries - they might be tax-deductible in the future. + We intend to use the donations to pay for our domain after transfering + it to SPI. Our goal is to make sure there's no single point of failure + and the bill gets paid and the site keeps running even if a some of + the currently active developers were to suddenly disappear for a while. </para>
<para> - If you read this section before you may notice that paying for the - project domain privoxy.org is no longer on the list. It has been - transferred to SPI is sponsored by Mythic Beasts Ltd. + We would also like to spend some money on more reliable hosting, + on hardware to help make sure <application>Privoxy</application> + keeps running on platforms the developers currently can't test on, + and on technical books to educate our developers about said platforms + or to improve their knowledge in general. </para>
<para> If you enjoy our software and feel like helping out with a donation, please have a look at <ulink url="http://www.spi-inc.org/donations">SPI's donation page</ulink> - to see what the options are. If you have any questions regarding donations - please mail to either the public user mailing list or, if it's a private - matter, to <ulink url="mailto:fk@fabiankeil.de">Fabian Keil</ulink> - (Privoxy's SPI liason) directly. -</para> + to see what the options are. +<para> </sect3>
</sect2> @@ -575,10 +542,10 @@ warranty? Registration?</title> <sect2 renderas="sect3" id="whichbrowsers"> <title>Which browsers are supported by Privoxy?</title> <para> - Any browser that can be configured to use a proxy, which + Any browser that can be configured to use a proxy, which should be virtually all browsers, including <application>Firefox</application>, <application>Internet - Explorer</application>, <application>Opera</application>, and + Explorer</application>, <application>Opera</application>, and <application>Safari</application> among others. Direct browser support is not an absolute requirement since <application>Privoxy</application> runs as a separate application and talks @@ -604,7 +571,7 @@ Include supported.sgml here: dealing with some of the common abuses of HTML in email. See <link linkend="outlook">How can I configure <application>Privoxy</application> with <application>Outlook</application>?</link> below for more on - this. + this. </para> <para> Be aware that HTML email presents a number of unique security and privacy @@ -615,11 +582,11 @@ Include supported.sgml here: </sect2>
<!-- Nobody is going to still be doing this! -<sect2 renderas="sect3" id="newinstall"><title>Can I install +<sect2 renderas="sect3" id="newinstall"><title>Can I install Privoxy over Junkbuster?</title> <para> We recommend you un-install <application>Junkbuster</application> - first to minimize conflicts and confusion. You may want to + first to minimize conflicts and confusion. You may want to save your old configuration files for future reference. The configuration files and syntax have substantially changed, so you will need to manually port your old patterns. See the <ulink url="../user-manual/upgradersnote.html">note @@ -636,19 +603,19 @@ Include supported.sgml here: -->
<sect2 renderas="sect3" id="firststep"> -<title>I just installed Privoxy. Is there anything +<title>I just installed Privoxy. Is there anything special I have to do now?</title>
<para> - All browsers should be told to use <application>Privoxy</application> - as a proxy by specifying the correct proxy address and port number + All browsers should be told to use <application>Privoxy</application> + as a proxy by specifying the correct proxy address and port number in the appropriate configuration area for the browser. It's possible to combine &my-app; with a packet filter to intercept HTTP requests even if the client isn't explicitly configured to use &my-app;, - but where possible, configuring the client is recommended. See + but where possible, configuring the client is recommended. See <ulink url="../user-manual/startup.html">the User Manual for more details</ulink>. You should also flush your browser's memory and disk - cache to get rid of any cached junk items, and remove any stored + cache to get rid of any cached junk items, and remove any stored <ulink url="http://en.wikipedia.org/wiki/Browser_cookie">cookies</ulink>.
</para> @@ -659,7 +626,7 @@ special I have to do now?</title> <para> If you set up the <application>Privoxy</application> to run on the computer you browse from (rather than your ISP's server or some - networked computer on a LAN), the proxy will be on <literal>127.0.0.1</literal> + networked computer on a LAN), the proxy will be on <literal>127.0.0.1</literal> (sometimes referred to as <quote>localhost</quote>, which is the special name used by every computer on the Internet to refer to itself) and the port will be 8118 (unless you used the <ulink @@ -671,14 +638,14 @@ special I have to do now?</title> When configuring your browser's proxy settings you typically enter the word <quote>localhost</quote> or the IP address <quote>127.0.0.1</quote> in the boxes next to <quote>HTTP</quote> and <quote>Secure</quote> (HTTPS) and - then the number <quote>8118</quote> for <quote>port</quote>. + then the number <quote>8118</quote> for <quote>port</quote>. This tells your browser to send all web requests to <application>Privoxy</application> instead of directly to the Internet. </para> <para> - <application>Privoxy</application> can also be used to proxy for - a Local Area Network. In this case, your would enter either the IP - address of the LAN host where <application>Privoxy</application> + <application>Privoxy</application> can also be used to proxy for + a Local Area Network. In this case, your would enter either the IP + address of the LAN host where <application>Privoxy</application> is running, or the equivalent hostname, e.g. <literal>192.168.1.1</literal>. Port assignment would be same as above. Note that <application>Privoxy</application> doesn't listen on any LAN interfaces by @@ -695,17 +662,17 @@ special I have to do now?</title> All the ads are there. What's wrong?</title>
<para> - Did you configure your browser to use <application>Privoxy</application> + Did you configure your browser to use <application>Privoxy</application> as a proxy? It does not sound like it. See above. You might also try flushing - the browser's caches to force a full re-reading of pages. You can verify - that <application>Privoxy</application> is running, and your browser - is correctly configured by entering the special URL: - <ulink url="http://p.p/">http://p.p/</ulink>. + the browser's caches to force a full re-reading of pages. You can verify + that <application>Privoxy</application> is running, and your browser + is correctly configured by entering the special URL: + <ulink url="http://p.p/">http://p.p/</ulink>. <!-- Use http://p.p/ instead of http://config.privoxy.org/ here because of potential redirect caching problem (see next Q). --> This should take you to a page titled <quote>This is Privoxy..</quote> with access to <application>Privoxy's</application> internal configuration. - If you see this, then you are good to go. If you receive a page saying + If you see this, then you are good to go. If you receive a page saying <quote>Privoxy is not running</quote>, then the browser is not set up to use your <application>Privoxy</application> installation. If you receive anything else (probably nothing at all), it could either @@ -744,7 +711,7 @@ Privoxy is running and being used.</title>
<para> The procedure for clearing the cache varies from browser to browser. For - example, <application>Mozilla/Netscape</application> users would click + example, <application>Mozilla/Netscape</application> users would click <guibutton>Edit</guibutton> --> <guibutton>Preferences</guibutton> --> <guibutton>Advanced</guibutton> --> <guibutton>Cache</guibutton> and then click both <quote><guibutton>Clear Memory Cache</guibutton></quote> @@ -768,7 +735,7 @@ Privoxy is running and being used.</title>
<para> &my-app; utilizes the concept of <quote> - <ulink url="../user-manual/actions-file.html#ACTIONS">actions</ulink></quote> + <ulink url="../user-manual/actions-file.html#ACTIONS">actions</ulink></quote> that are used to manipulate and control web page data. <ulink url="../user-manual/actions-file.html">Actions files</ulink> are where these <ulink url="../user-manual/actions-file.html#ACTIONS">actions</ulink> @@ -778,7 +745,7 @@ Privoxy is running and being used.</title> There is a wide array of actions available that give the user a high degree of control and flexibility on how to process each and every web page. </para> - + <para> Actions can be defined on a <ulink url="../user-manual/actions-file.html#AF-PATTERNS">URL pattern</ulink> basis, i.e. @@ -794,7 +761,7 @@ Privoxy is running and being used.</title> </sect2>
<sect2 renderas="sect3" id="actionss"> -<title>The <quote>actions</quote> concept confuses me. Please list +<title>The <quote>actions</quote> concept confuses me. Please list some of these <quote>actions</quote>.</title> <para> For a comprehensive discussion of the actions concept, please refer @@ -810,7 +777,7 @@ some of these <quote>actions</quote>.</title>
<sect2 renderas="sect3"> <title id="actconfig">How are actions files configured? What is the easiest -way to do this?</title> +way to do this?</title>
<para> Actions files are just text files in a special syntax and can be edited @@ -819,8 +786,8 @@ way to do this?</title> at <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> (Shortcut: <ulink url="http://p.p/">http://p.p/</ulink>) and then select <quote><ulink url="http://config.privoxy.org/show-status">View & - change the current configuration</ulink></quote> from the menu. Note - that this feature must be explicitly enabled in the main config file + change the current configuration</ulink></quote> from the menu. Note + that this feature must be explicitly enabled in the main config file (see <ulink url="../user-manual/config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</ulink>). </para> @@ -831,15 +798,30 @@ way to do this?</title> <title>There are several different <quote>actions</quote> files. What are the differences?</title> <para> - Please have a look at the <ulink url="../user-manual/actions-file.html">the actions chapter</ulink> - in the <ulink url="../user-manual/index.html">User Manual</ulink> for a detailed explanation. + Three actions files + are being included by the developers, to be used for + different purposes: These are + <filename>default.action</filename>, the <quote>main</quote> actions file + which is actively maintained by the <application>Privoxy</application> + developers and typically sets the default policies, <filename>user.action</filename>, + where users are encouraged to make their private customizations. + Please see <ulink url="../user-manual/actions-file.html">the actions chapter</ulink> + in the <ulink url="../user-manual/index.html">User Manual</ulink> for a more + detailed explanation. +</para> + +<para> + Earlier versions included three different versions of the + <filename>default.action</filename> file. The new scheme allows for + greater flexibility of local configuration, and for browser based + selection of pre-defined <quote>aggressiveness</quote> levels. </para>
</sect2>
<sect2 renderas="sect3" id="getupdates"><title>Where can I get updated Actions Files?</title> <para> - Based on your feedback and the continuing development, updates of + Based on your feedback and the continuing development, updates of <filename>default.action</filename> will be made available from time to time on the <ulink url="http://sourceforge.net/project/showfiles.php?group_id=11118">files section</ulink> of @@ -868,21 +850,21 @@ the differences?</title> <sect2 renderas="sect3" id="difficult"> <title>Why is the configuration so complicated?</title> <para> - <quote>Complicated</quote> is in the eye of the beholder. Those that are + <quote>Complicated</quote> is in the eye of the beholder. Those that are familiar with some of the underlying concepts, such as regular expression syntax, take to it like a fish takes to water. Also, software that tries hard to be <quote>user friendly</quote>, often lacks sophistication and flexibility. There is always that trade-off there between power vs. easy-of-use. Furthermore, anyone is welcome to contribute ideas and - implementations to enhance &my-app;. + implementations to enhance &my-app;. </para> </sect2>
<sect2 renderas="sect3" id="yahoo"><title>How can I make my Yahoo/Hotmail/Gmail account work?</title> <para> The default configuration shouldn't impact the usability of any of these services. - It may, however, make all <ulink - url="http://en.wikipedia.org/wiki/Browser_cookie">cookies</ulink> + It may, however, make all <ulink + url="http://en.wikipedia.org/wiki/Browser_cookie">cookies</ulink> temporary, so that your browser will forget your login credentials in between browser sessions. If you would like not to have to log in manually each time you access those websites, simply turn off all cookie handling @@ -896,9 +878,9 @@ the differences?</title> .login.yahoo.com</screen> </para> <para> - These kinds of sites are often quite complex and heavy with - <ulink url="http://en.wikipedia.org/wiki/Javascript">Javascript</ulink> and - thus <quote>fragile</quote>. So if <emphasis>still</emphasis> a problem, + These kinds of sites are often quite complex and heavy with + <ulink url="http://en.wikipedia.org/wiki/Javascript">Javascript</ulink> and + thus <quote>fragile</quote>. So if <emphasis>still</emphasis> a problem, we have an <ulink url="../user-manual/actions-file.html#ALIASES">alias</ulink> just for such sticky situations: @@ -916,8 +898,8 @@ the differences?</title> </para> <para> Make sure the domain, host and path are appropriate as well. Your browser can - tell you where you are specifically and you should use that information for - your configuration settings. Note that above it is not referenced as + tell you where you are specifically and you should use that information for + your configuration settings. Note that above it is not referenced as <literal>gmail.com</literal>, which is a valid domain name. </para>
@@ -931,7 +913,7 @@ the differences?</title> <quote>profiles</quote> in the web based actions file editor at <ulink url="http://config.privoxy.org/show-status">http://config.privoxy.org/show-status</ulink>. See the <ulink url="../user-manual/actions-file.html"><citetitle>User - Manual</citetitle></ulink> for a list of actions, and how the default + Manual</citetitle></ulink> for a list of actions, and how the default profiles are set. </para>
@@ -939,23 +921,23 @@ the differences?</title> Where the defaults are likely to break some sites, exceptions for known popular <quote>problem</quote> sites are included, but in general, the more aggressive your default settings are, the more exceptions - you will have to make later. New users are best to start off in - <quote>Cautious</quote> setting. This is safest and will have the fewest + you will have to make later. New users are best to start off in + <quote>Cautious</quote> setting. This is safest and will have the fewest problems. See the <ulink url="../user-manual/index.html"><citetitle>User Manual</citetitle></ulink> for a more detailed discussion. </para>
<para> - It should be noted that the <quote>Advanced</quote> profile (formerly known + It should be noted that the <quote>Advanced</quote> profile (formerly known as the <quote>Adventuresome</quote> profile) is more - aggressive, and will make use of some of + aggressive, and will make use of some of <application>Privoxy's</application> advanced features. Use at your own risk! </para>
</sect2>
-<sect2 renderas="sect3" id="browseconfig"> <title>Why can I change the configuration +<sect2 renderas="sect3" id="browseconfig"> <title>Why can I change the configuration with a browser? Does that not raise security issues?</title> <para> It may seem strange that regular users can edit the config files with their @@ -971,7 +953,7 @@ with a browser? Does that not raise security issues?</title> <para> If you run <application>Privoxy</application> for multiple untrusted users (e.g. in a LAN) or aren't entirely in control of your own browser, you will probably want - to make sure that the web-based editor and remote toggle features are + to make sure that the the web-based editor and remote toggle features are <quote>off</quote> by setting <quote><literal><ulink url="../user-manual/config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</ulink> 0</literal></quote> and <quote><literal><ulink @@ -1001,7 +983,7 @@ with a browser? Does that not raise security issues?</title> <ulink url="../user-manual/actions-file.html#FILTER"><literal>filter</literal> action</ulink> in one of the actions files. Content filtering is automatically - disabled for inappropriate MIME types, but if you know better than Privoxy + disabled for inappropriate MIME types, but if you now better than Privoxy what should or should not be filtered you can filter any content you like. </para> <para> @@ -1013,21 +995,21 @@ with a browser? Does that not raise security issues?</title> </para>
<para> - If you are familiar with regular expressions, and HTML, you can look at + If you are familiar with regular expressions, and HTML, you can look at the provided <filename>default.filter</filename> with a text editor and define your own filters. This is potentially a very powerful feature, but - requires some expertise in both regular expressions and HTML/HTTP. - <![%p-newstuff;[ You should - place any modifications to the default filters, or any new ones you create - in a separate file, such as <filename>user.filter</filename>, so they won't - be overwritten during upgrades. - The ability to define multiple filter files + requires some expertise in both regular expressions and HTML/HTTP. + <![%p-newstuff;[ You should + place any modifications to the default filters, or any new ones you create + in a separate file, such as <filename>user.filter</filename>, so they won't + be overwritten during upgrades. + The ability to define multiple filter files in <filename>config</filename> is a new feature as of v. 3.0.5.]]> </para>
<para> - There is no GUI editor option for this part of the configuration, - but you can disable/enable the various pre-defined filters of the included + There is no GUI editor option for this part of the configuration, + but you can disable/enable the various pre-defined filters of the included <filename>default.filter</filename> file with the <ulink url="http://config.privoxy.org/show-status">web-based actions file editor</ulink>. Note that the custom actions editor must be explicitly enabled in @@ -1044,10 +1026,10 @@ with a browser? Does that not raise security issues?</title> </sect2>
<sect2 renderas="sect3" id="lanconfig"> -<title>How can I set up Privoxy to act as a proxy for my +<title>How can I set up Privoxy to act as a proxy for my LAN?</title> <para> - By default, <application>Privoxy</application> only responds to requests + By default, <application>Privoxy</application> only responds to requests from <literal>127.0.0.1</literal> (localhost). To have it act as a server for a network, this needs to be changed in the <ulink url="../user-manual/config.html">main configuration file</ulink>. Look for @@ -1066,12 +1048,12 @@ with a browser? Does that not raise security issues?</title> </para>
<para> - Save the file, and restart <application>Privoxy</application>. Configure + Save the file, and restart <application>Privoxy</application>. Configure all browsers on the network then to use this address and port number. </para>
<para> - Alternately, you can have <application>Privoxy</application> listen on + Alternately, you can have <application>Privoxy</application> listen on all available interfaces: </para>
@@ -1081,10 +1063,10 @@ with a browser? Does that not raise security issues?</title> </para>
<para> - And then use <application>Privoxy's</application> + And then use <application>Privoxy's</application> <ulink - url="../user-manual/config.html#PERMIT-ACCESS">permit-access</ulink> - feature to limit connections. A firewall in this situation is recommended + url="../user-manual/config.html#PERMIT-ACCESS">permit-access</ulink> + feature to limit connections. A firewall in this situation is recommended as well. </para>
@@ -1119,7 +1101,7 @@ with a browser? Does that not raise security issues?</title> <para> If you want to see nothing, then change the <ulink url="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"><literal>set-image-blocker</literal> - action</ulink> to <quote>blank</quote>. This can be done by editing the + action</ulink> to <quote>blank</quote>. This can be done by editing the <filename>user.action</filename> file, or through the <ulink url="http://config.privoxy.org/show-status">web-based actions file editor</ulink>. </para> @@ -1134,7 +1116,7 @@ with a browser? Does that not raise security issues?</title> is rather smart, it will make occasional mistakes. The checkerboard image is visually decent, and it shows you where images have been blocked, which can be very helpful in case some navigation aid or otherwise innocent image was - erroneously blocked. It is recommended for new users so they can + erroneously blocked. It is recommended for new users so they can <quote>see</quote> what is happening. Some people might also enjoy seeing how many banners they <emphasis>don't</emphasis> have to see. </para> @@ -1150,7 +1132,7 @@ instead of the checkerboard image. Why and how do I get rid of this?</title> or (i)layers, and these external HTML documents are blocked. Being non-images they get replaced by a substitute HTML page rather than a substitute image, which wouldn't work out technically, since the browser expects and accepts - only HTML when it has requested an HTML document. + only HTML when it has requested an HTML document. </para> <para> The substitute page adapts to the available space and shows itself as a @@ -1169,15 +1151,15 @@ instead of the checkerboard image. Why and how do I get rid of this?</title>
<sect2 renderas="sect3" id="srvany"> -<title>Can Privoxy run as a service +<title>Can Privoxy run as a service on Win2K/NT/XP?</title> <para> <![%p-newstuff;[ Yes. Version 3.0.5 introduces full <application>Windows</application> service functionality. See <ulink url="../user-manual/installation.html#installation-pack-win"> - the <citetitle>User Manual</citetitle></ulink> for details on how to install and configure + the <citetitle>User Manual</citetitle></ulink> for details on how to install and configure <application>Privoxy</application> as a service. -</para> +</para> <para> Earlier ]]>3.x versions could run as a system service using <command>srvany.exe</command>. See the discussion at <ulink @@ -1188,17 +1170,17 @@ on Win2K/NT/XP?</title>
<sect2 renderas="sect3" id="otherproxy"> -<title>How can I make Privoxy work with other proxies?</title> +<title>How can I make Privoxy work with other +proxies like Squid or Tor?</title> <para> This can be done and is often useful to combine the benefits of - <application>Privoxy</application> with those of a another proxy, - for example to cache content. + <application>Privoxy</application> with those of a another proxy. See the <ulink url="../user-manual/config.html#FORWARDING">forwarding chapter</ulink> in the <ulink url="../user-manual/index.html">User Manual</ulink> which - describes how to do this. If you intend to use Privoxy with Tor, - please also have a look at - <link linkend="TOR">How do I use Privoxy together with Tor</link>. + describes how to do this, and the <link linkend="TOR"> + How do I use Privoxy together with + Tor</link> section below. </para> </sect2>
@@ -1207,9 +1189,8 @@ on Win2K/NT/XP?</title> and thus avoid individual browser configuration?</title>
<para> - No, its more complicated than that. This only works with special kinds - of proxies known as <quote>intercepting</quote> proxies - (<link linkend="INTERCEPTING">see below</link>). + No, its more complicated than that. This only works with special kinds + of proxies known as <quote>intercepting</quote> proxies (see below). </para>
</sect2> @@ -1226,7 +1207,7 @@ and thus avoid individual browser configuration?</title> <para> However, some people say <quote>transparent proxy</quote> when they mean <quote>intercepting proxy</quote>. If you are one of them, - please read the <link linkend="INTERCEPTING">next entry</link>. + please read the <ulink url="#intercepting">next entry</ulink>. </para>
</sect2> @@ -1238,7 +1219,7 @@ and thus avoid individual browser configuration?</title> but it can handle requests that where intercepted and redirected with a packet filter (like <application>PF</application> or <application>iptables</application>), as long as the <literal>Host</literal> - header is present. + header is present. </para> <para> As the <literal>Host</literal> header is required by HTTP/1.1 and as most @@ -1279,14 +1260,14 @@ and thus avoid individual browser configuration?</title> of knowing which particular application makes a request, so there is no way to distinguish between web pages and HTML mail. <application>Privoxy</application> just blindly proxies all requests. In the - case of <application>Outlook Express</application> (see above), OE uses - IE anyway, and there is no way for <application>Privoxy</application> to ever + case of <application>Outlook Express</application> (see above), OE uses + IE anyway, and there is no way for <application>Privoxy</application> to ever be able to distinguish between them (nor could any other proxy type application for that matter). </para> <para> - For a good discussion of some of the issues involved (including privacy and - security issues), see + For a good discussion of some of the issues involved (including privacy and + security issues), see <ulink url="http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118">http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&group_id=11118</ulink>. </para> </sect2> @@ -1295,12 +1276,12 @@ and thus avoid individual browser configuration?</title> <title>I sometimes notice cookies sneaking through. How?</title> <para> <ulink - url="http://en.wikipedia.org/wiki/Browser_cookie">Cookies</ulink> can be - set in several ways. The classic method is via the + url="http://en.wikipedia.org/wiki/Browser_cookie">Cookies</ulink> can be + set in several ways. The classic method is via the <literal>Set-Cookie</literal> HTTP header. This is straightforward, and an - easy one to manipulate, such as the &my-app; concept of + easy one to manipulate, such as the &my-app; concept of <ulink url="../user-manual/actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</ulink>. - There is also the possibility of using + There is also the possibility of using <ulink url="http://en.wikipedia.org/wiki/Javascript">Javascript</ulink> to set cookies (&my-app; calls these <literal>content-cookies</literal>). This is trickier because the syntax can vary widely, and thus requires a certain @@ -1319,20 +1300,20 @@ and thus avoid individual browser configuration?</title> <sect2 renderas="sect3" id="evil-cookies"> <title>Are all cookies bad? Why?</title> <para> - No, in fact there are many beneficial uses of + No, in fact there are many beneficial uses of <ulink url="http://en.wikipedia.org/wiki/Browser_cookie">cookies</ulink>. Cookies are just a method that browsers can use to store data between pages, or between browser sessions. Sometimes there is a good reason for this, and the user's life is a bit easier as a result. But there is a long history of some websites taking - advantage of this layer of trust, and using the data they glean from you and + advantage of this layer of trust, and using the data they glean from you and your browsing habits for their own purposes, and maybe to your potential detriment. Such sites are using you and storing their data on your system. That is why the privacy conscious watch from whom those cookies come, and why they really <emphasis>need</emphasis> to be there. </para> <para> - See the + See the <ulink url="http://en.wikipedia.org/wiki/Browser_cookie">Wikipedia cookie definition</ulink> for more. </para> @@ -1342,14 +1323,14 @@ and thus avoid individual browser configuration?</title> <title>How can I allow permanent cookies for my trusted sites?</title>
<para> - There are several actions that relate to cookies. The default behavior is to + There are several actions that relate to cookies. The default behavior is to allow only <quote>session cookies</quote>, which means the cookies only last - for the current browser session. This eliminates most kinds of abuse related + for the current browser session. This eliminates most kinds of abuse related to cookies. But there may be cases where you want cookies to last. </para> <para> To disable all cookie actions, so that cookies are allowed unrestricted, - both in and out, for <literal>example.com</literal>: + both in and out, for <literal>example.com</literal>: </para> <para> <screen> @@ -1370,14 +1351,14 @@ and thus avoid individual browser configuration?</title> <para> Each instance of <application>Privoxy</application> has its own configuration, including such attributes as the TCP port that it listens on. - What you can do is run multiple instances of <application>Privoxy</application>, each with - a unique + What you can do is run multiple instances of <application>Privoxy</application>, each with + a unique <ulink url="../user-manual/config.html#LISTEN-ADDRESS">listen-address</ulink> configuration setting, and configuration path, and then each of these can have their own configurations. Think of it as per-port configuration. </para> -<para> +<para> Simple enough for a few users, but for large installations, consider having groups of users that might share like configurations. </para> @@ -1396,7 +1377,7 @@ and thus avoid individual browser configuration?</title> ############################################################ { <ulink url="../user-manual/actions-file.html#BLOCK">+block</ulink> } / # Block *all* URLs - + ############################################################ # Whitelist ############################################################ @@ -1405,12 +1386,12 @@ and thus avoid individual browser configuration?</title> toys.example.com games.example.com</screen> <para> - This allows access to only those three sites by first blocking all URLs, and + This allows access to only those three sites by first blocking all URLs, and then subsequently allowing three specific exceptions. </para> <para> - Another approach is <application>Privoxy's</application> - <literal>trustfile</literal> concept, which incorporates the notion of + Another approach is <application>Privoxy's</application> + <literal>trustfile</literal> concept, which incorporates the notion of <quote>trusted referrers</quote>. See the <ulink url="../user-manual/config.html#TRUSTFILE">Trust documentation</ulink> for details. @@ -1427,14 +1408,14 @@ and thus avoid individual browser configuration?</title> <sect2 renderas="sect3" id="no-adblock"> <title>How can I turn off ad-blocking?</title> <para> - Ad blocking is achieved through a complex application of various &my-app; - <ulink url="../user-manual/actions-file.html">actions</ulink>. These - actions are deployed against simple images, banners, flash animations, + Ad blocking is achieved through a complex application of various &my-app; + <ulink url="../user-manual/actions-file.html">actions</ulink>. These + actions are deployed against simple images, banners, flash animations, text pages, JavaScript, pop-ups and pop-unders, etc., so its not as simple as just turning one or two actions off. The various actions that make up &my-app; ad blocking are hard-coded into the default configuration files. It has been assumed that everyone using &my-app; is interested in this - particular feature. + particular feature. </para> <para> If you want to do without this, there are several approaches you can take: @@ -1444,7 +1425,7 @@ and thus avoid individual browser configuration?</title> blocking rules, and corresponding exceptions. Or lastly, if you are not concerned about the additional blocks that are done for privacy reasons, you can very easily over-ride <emphasis>all</emphasis> blocking with the - following very simple rule in your <filename>user.action</filename>: + following very simple rule in your <filename>user.action</filename>: </para> <para> <screen> @@ -1452,7 +1433,7 @@ and thus avoid individual browser configuration?</title> { <ulink url="../user-manual/actions-file.html#BLOCK">-block</ulink> } / # UN-Block *all* URLs</screen> </para> -<para> +<para> Or even a more comprehensive reversing of various ad related actions: </para> <para> @@ -1474,7 +1455,7 @@ and thus avoid individual browser configuration?</title> </sect2>
<sect2 renderas="sect3" id="templates"> -<title>How can I have custom template pages, like the +<title>How can I have custom template pages, like the <emphasis>BLOCKED</emphasis> page?</title> <para> &my-app; <quote>templates</quote> are specialized text files utilized by @@ -1488,12 +1469,12 @@ and thus avoid individual browser configuration?</title> during upgrades. You can, however, create completely new templates, place them in another directory and specify the alternate path in the main <filename>config</filename>. For details, have a look at the <ulink - url="../user-manual/config.html#templdir">templdir</ulink> option. + url="../user-manual/config.html#templdir">templdir</ulink> option. </para> </sect2>
<sect2 renderas="sect3" id="blockall"> -<title>How can I remove the <quote>Go There Anyway</quote> link from +<title>How can I remove the <quote>Go There Anyway</quote> link from the <emphasis>BLOCKED</emphasis> page?</title> <para> There is more than one way to do it (although Perl is not involved). @@ -1502,7 +1483,7 @@ the <emphasis>BLOCKED</emphasis> page?</title> Editing the BLOCKED template page (see above) may dissuade some users, but this method is easily circumvented. Where you need this level of control, you might want to build &my-app; from source, and disable various features that are - available as compile-time options. You should + available as compile-time options. You should <command>configure</command> the sources as follows: </para> <para> @@ -1532,15 +1513,15 @@ the <emphasis>BLOCKED</emphasis> page?</title> <sect1 id="misc"><title>Miscellaneous</title>
<sect2 renderas="sect3"> -<title id="slowsme">How much does Privoxy slow my browsing down? This +<title id="slowsme">How much does Privoxy slow my browsing down? This has to add extra time to browsing.</title> <para> How much of an impact depends on many things, including the CPU of the host - system, how aggressive the configuration is, which specific actions are being triggered, + system, how aggressive the configuration is, which specific actions are being triggered, the size of the page, the bandwidth of the connection, etc. </para> <para> - Overall, it should not slow you down any in real terms, and may actually help + Overall, it should not slow you down any in real terms, and may actually help speed things up since ads, banners and other junk are not typically being retrieved and displayed. The actual processing time required by <application>Privoxy</application> itself for each page, is relatively small @@ -1578,7 +1559,7 @@ delays in page requests. What's wrong?</title> url="../user-manual/actions-file.html#FILTER">filter</ulink></literal> action, such as filtering banners by size, web-bugs etc, or the <literal><ulink url="../user-manual/actions-file.html#DEANIMATE-GIFS">deanimate-gifs</ulink></literal> - action, the entire document must be loaded into memory in order for the filtering + action, the entire document must be loaded into memory in order for the filtering mechanism to work, and nothing is sent to the browser during this time. </para> <para> @@ -1592,7 +1573,7 @@ delays in page requests. What's wrong?</title> anti-virus software). </para> <para> - Filtering is automatically disabled for inappropriate MIME types. But note + Filtering is automatically disabled for inappropriate MIME types. But note that if the web server mis-reports the MIME type, then content that should not be filtered, could be. <application>Privoxy</application> only knows how to differentiate filterable content because of the MIME type as reported by @@ -1605,11 +1586,11 @@ delays in page requests. What's wrong?</title> "http://p.p/"?</title> <para> <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> is the - address of <application>Privoxy</application>'s built-in user interface, and + address of <application>Privoxy</application>'s built-in user interface, and <ulink url="http://p.p/">http://p.p/</ulink> is a shortcut for it. </para> <para> - Since <application>Privoxy</application> sits between your web browser and the Internet, + Since <application>Privoxy</application> sits between your web browser and the Internet, it can simply intercept requests for these addresses and answer them with its built-in <quote>web server</quote>. </para> @@ -1630,7 +1611,7 @@ delays in page requests. What's wrong?</title> <sect2 renderas="sect3" id="blocklist"><title>Do you still maintain the blocklists?</title> <para> No. The patterns for blocking now reside (among other things) in the <ulink - url="../user-manual/actions-file.html">actions files</ulink>, which are + url="../user-manual/actions-file.html">actions files</ulink>, which are actively maintained instead. See next question ... </para> </sect2> @@ -1644,25 +1625,25 @@ various ways to interact with the developers.
</sect2>
-<sect2 renderas="sect3" id="newads2"><title>If I do submit missed ads, will +<sect2 renderas="sect3" id="newads2"><title>If I do submit missed ads, will they be included in future updates?</title> <para> Whether such submissions are eventually included in the - <filename>default.action</filename> configuration file depends on how - significant the issue is. We of course want to address any potential - problem with major, high-profile sites such as <citetitle>Google</citetitle>, - <citetitle>Yahoo</citetitle>, etc. Any site with global or regional reach, + <filename>default.action</filename> configuration file depends on how + significant the issue is. We of course want to address any potential + problem with major, high-profile sites such as <citetitle>Google</citetitle>, + <citetitle>Yahoo</citetitle>, etc. Any site with global or regional reach, has a good chance of being a candidate. But at the other end of the spectrum are any number of smaller, low-profile sites such as for local clubs or schools. Since their reach and impact are much less, they are best handled by inclusion in the user's <filename>user.action</filename>, and thus would be - unlikely to be included. + unlikely to be included. </para>
</sect2>
-<sect2 renderas="sect3" id="noonecares"><title>Why doesn't anyone answer my support +<sect2 renderas="sect3" id="noonecares"><title>Why doesn't anyone answer my support request?</title> <para> Rest assured that it has been read and considered. Why it is not answered, @@ -1680,7 +1661,7 @@ us help you. Your efforts are not wasted, and we do appreciate them. If you run both the browser and &my-app; locally, you cannot hide your IP address with <application>Privoxy</application> or ultimately any other software alone. The server needs to know your IP address so that it knows - where to send the responses back. + where to send the responses back. </para> <para> There are many publicly usable "anonymous" proxies out there, which @@ -1716,8 +1697,8 @@ us help you. Your efforts are not wasted, and we do appreciate them. </para> <para> <application>Privoxy</application> can remove various information about you, - and allows <emphasis>you</emphasis> more freedom to decide which sites - you can trust, and what details you want to reveal. But it neither + and allows <emphasis>you</emphasis> more freedom to decide which sites + you can trust, and what details you want to reveal. But it neither hides your IP address, nor can it guarantee that the rest of the system behaves correctly. There are several possibilities how a web sites can find out who you are, even if you are using a strict <application>Privoxy</application> @@ -1767,7 +1748,7 @@ us help you. Your efforts are not wasted, and we do appreciate them. <ulink url="../user-manual/startup.html">5. Startup</ulink> to make sure <application>Privoxy</application> itself is setup correctly. </para> -<para> +<para> If it is, refer to <ulink url="https://www.torproject.org/documentation.html">Tor's extensive documentation</ulink> to learn how to install <application>Tor</application>, and make sure <application>Tor</application>'s logfile says that @@ -1786,11 +1767,9 @@ us help you. Your efforts are not wasted, and we do appreciate them. If you verified that <application>Privoxy</application> and <application>Tor</application> are working, it is time to connect them. As far as <application>Privoxy</application> is concerned, <application>Tor</application> is just another proxy that can be reached - by socks4, socks4a and socks5. Most likely you are interested in <application>Tor</application> - to increase your anonymity level, therefore you should use socks5, to make sure DNS - requests are done through <application>Tor</application> and thus invisible to your - local network. Using socks4a would work too, but with socks5 you get more precise error - messages. + by socks4 or socks4a. Most likely you are interested in <application>Tor</application> + to increase your anonymity level, therefore you should use socks4a, to make sure DNS requests are + done through <application>Tor</application> and thus invisible to your local network. </para>
<![%p-newstuff;[ @@ -1805,7 +1784,7 @@ us help you. Your efforts are not wasted, and we do appreciate them. </para> <para> <screen> -# forward-socks5 / 127.0.0.1:9050 . +# forward-socks4a / 127.0.0.1:9050 . </screen> </para> <para> @@ -1861,7 +1840,7 @@ us help you. Your efforts are not wasted, and we do appreciate them. content is being altered?</title>
<para> - Definitely. It is common for sites to use browser type, browser version, + Definitely. It is common for sites to use browser type, browser version, HTTP header content, and various other techniques in order to dynamically decide what to display and how to display it. What you see, and what I see, might be very different. There are many, many ways that this can be handled, @@ -1887,8 +1866,8 @@ content is being altered?</title> many other ways things can go wrong when trying to fool a web server. The results of which could inadvertently cause pages to load incorrectly, partially, or even not at all. And there may be no obvious clues as to just - what went wrong, or why. Nowhere will there be a message that says - <quote><emphasis>Turn off <literal>fast-redirects</literal> or else!</emphasis> + what went wrong, or why. Nowhere will there be a message that says + <quote><emphasis>Turn off <literal>fast-redirects</literal> or else!</emphasis> </quote> </para>
@@ -1898,8 +1877,8 @@ content is being altered?</title> </para>
<para> - If you have problems with a site, you will have to adjust your configuration - accordingly. Cookies are probably the most likely adjustment that may + If you have problems with a site, you will have to adjust your configuration + accordingly. Cookies are probably the most likely adjustment that may be required, but by no means the only one. </para>
@@ -1907,13 +1886,13 @@ content is being altered?</title>
<sect2 renderas="sect3"> -<title id="caching">Can Privoxy act as a <quote>caching</quote> proxy to +<title id="caching">Can Privoxy act as a <quote>caching</quote> proxy to speed up web browsing?</title> <para> - No, it does not have this ability at all. You want something like + No, it does not have this ability at all. You want something like <ulink url="http://www.squid-cache.org/">Squid</ulink> or <ulink url="http://www.pps.jussieu.fr/~jch/software/polipo/">Polipo</ulink> for this. - And, yes, before you ask, <application>Privoxy</application> can co-exist + And, yes, before you ask, <application>Privoxy</application> can co-exist with other kinds of proxies like <application>Squid</application>. See the <ulink url="../user-manual/config.html#FORWARDING">forwarding chapter</ulink> in the <ulink url="../user-manual/index.html">user @@ -1924,7 +1903,7 @@ speed up web browsing?</title> <sect2 renderas="sect3"> <title id="firewall">What about as a firewall? Can Privoxy protect me?</title> <para> - Not in the way you mean, or in the way some firewall vendors claim they can. + Not in the way you mean, or in the way some firewall vendors claim they can. <application>Privoxy</application> can help protect your privacy, but can't protect your system from intrusion attempts. It is, of course, perfectly possible to use <emphasis>both</emphasis>. @@ -1936,10 +1915,10 @@ speed up web browsing?</title> ads used to be. Why?</title> <para> It is technically possible to eliminate banners and ads in a way that frees - their allocated page space. This could easily be done by blocking with + their allocated page space. This could easily be done by blocking with <application>Privoxy's</application> filters, and eliminating the <emphasis>entire</emphasis> image references from the - HTML page source. + HTML page source. </para> <para> But, this would consume considerably more CPU resources (IOW, slow things @@ -1978,35 +1957,35 @@ ads used to be. Why?</title> As far as ad blocking is concerned, this is less of a restriction than it may seem, since ad sources are often identifiable by the host name, and often the banners to be placed in an encrypted page come unencrypted nonetheless - for efficiency reasons, which exposes them to the full power of + for efficiency reasons, which exposes them to the full power of <application>Privoxy</application>'s ad blocking. </para> <para> <quote>Content cookies</quote> (those that are embedded in the actual HTML or JS page content, see <literal><ulink - url="../user-manual/actions-file.html#FILTER-CONTENT-COOKIES">filter{content-cookies}</ulink></literal>), - in an SSL transaction will be impossible to block under these conditions. - Fortunately, this does not seem to be a very common scenario since most + url="../user-manual/actions-file.html#FILTER-CONTENT-COOKIES">filter{content-cookies}</ulink></literal>), + in an SSL transaction will be impossible to block under these conditions. + Fortunately, this does not seem to be a very common scenario since most cookies come by traditional means. </para>
</sect2>
<sect2 renderas="sect3"> -<title id="secure">Privoxy runs as a <quote>server</quote>. How +<title id="secure">Privoxy runs as a <quote>server</quote>. How secure is it? Do I need to take any special precautions?</title> <para> - On Unix-like systems, <application>Privoxy</application> can run as a non-privileged + On Unix-like systems, <application>Privoxy</application> can run as a non-privileged user, which is how we recommend it be run. Also, by default <application>Privoxy</application> listens to requests from <quote>localhost</quote> only. </para> <para> - The server aspect of <application>Privoxy</application> is not itself directly + The server aspect of <application>Privoxy</application> is not itself directly exposed to the Internet in this configuration. If you want to have <application>Privoxy</application> serve as a LAN proxy, this will have to be opened up to allow for LAN requests. In this case, we'd recommend - you specify only the LAN gateway address, e.g. 192.168.1.1, in the main + you specify only the LAN gateway address, e.g. 192.168.1.1, in the main <application>Privoxy</application> configuration file and check all <ulink url="../user-manual/config.html#ACCESS-CONTROL">access control and security options</ulink>. All LAN hosts can then use this as their proxy address @@ -2029,23 +2008,23 @@ secure is it? Do I need to take any special precautions?</title> url="http://config.privoxy.org/toggle">http://config.privoxy.org/toggle</ulink>. </para> <para> - See the <ulink url="../user-manual/appendix.html#BOOKMARKLETS">Bookmarklets section</ulink> - of the <citetitle>User Manual</citetitle> for an easy way to access this - feature. Note that this is a feature that may need to be enabled in the main + See the <ulink url="../user-manual/appendix.html#BOOKMARKLETS">Bookmarklets section</ulink> + of the <citetitle>User Manual</citetitle> for an easy way to access this + feature. Note that this is a feature that may need to be enabled in the main <filename>config</filename> file. </para> </sect2>
<sect2 renderas="sect3" id="reallyoff"> -<title>When <quote>disabled</quote> is Privoxy totally +<title>When <quote>disabled</quote> is Privoxy totally out of the picture?</title> <para> No, this just means all optional filtering and actions are disabled. - <application>Privoxy</application> is still acting as a proxy, but just + <application>Privoxy</application> is still acting as a proxy, but just doing less of the things that <application>Privoxy</application> would - normally be expected to do. It is still a <quote>middle-man</quote> in - the interaction between your browser and web sites. See below to bypass + normally be expected to do. It is still a <quote>middle-man</quote> in + the interaction between your browser and web sites. See below to bypass the proxy. </para> </sect2> @@ -2061,10 +2040,10 @@ out of the picture?</title>
<sect2 renderas="sect3" id="crunch"> -<title>My logs show Privoxy <quote>crunches</quote> +<title>My logs show Privoxy <quote>crunches</quote> ads, but also its own internal CGI pages. What is a <quote>crunch</quote>?</title> <para> - A <quote>crunch</quote> simply means <application>Privoxy</application> intercepted + A <quote>crunch</quote> simply means <application>Privoxy</application> intercepted <emphasis>something</emphasis>, nothing more. Often this is indeed ads or banners, but <application>Privoxy</application> uses the same mechanism for trapping requests for its own internal pages. For instance, a request for @@ -2088,7 +2067,7 @@ from a webserver? FTP server?</title> viewing a document (i.e. a page), and downloading a file. The same is true of <application>Privoxy</application>. If there is a match for a <literal><ulink url="../user-manual/actions-file.html#BLOCK">block</ulink></literal> pattern, - it will still be blocked, and of course this is obvious. + it will still be blocked, and of course this is obvious. </para> <para> Filtering is potentially more of a concern since the results are not always @@ -2115,7 +2094,7 @@ from a webserver? FTP server?</title> altered by filtering, will be saved too, for these (probably rare) cases. </para> <para> - Note that versions later than 3.0.2 do NOT filter document types reported as + Note that versions later than 3.0.2 do NOT filter document types reported as <quote>text/plain</quote>. Prior to this, <application>Privoxy</application> did filter this document type. </para> @@ -2137,7 +2116,7 @@ from a webserver? FTP server?</title> all to the content is to be avoided. </para> <para> - <application>Privoxy</application> does not do FTP at all, only HTTP + <application>Privoxy</application> does not do FTP at all, only HTTP and HTTPS (SSL) protocols. </para> </sect2> @@ -2154,18 +2133,18 @@ altered it! Yikes, what is wrong!</title> <title>Should I continue to use a <quote>HOSTS</quote> file for ad-blocking?</title> <para> One time-tested technique to defeat common ads is to trick the local DNS - system by giving a phony IP address for the ad generator in the local - <filename>HOSTS</filename> file, typically using <literal>127.0.0.1</literal>, aka + system by giving a phony IP address for the ad generator in the local + <filename>HOSTS</filename> file, typically using <literal>127.0.0.1</literal>, aka <literal>localhost</literal>. This effectively blocks the ad. </para> <para> - There is no reason to use this technique in conjunction with + There is no reason to use this technique in conjunction with <application>Privoxy</application>. <application>Privoxy</application> - does essentially the same thing, much more elegantly and with much more + does essentially the same thing, much more elegantly and with much more flexibility. A large <filename>HOSTS</filename> file, in fact, not only duplicates effort, but may get in the way and seriously slow down your system. - It is recommended to remove such entries from your <filename>HOSTS</filename> file. If you think - your hosts list is neglected by <application>Privoxy's </application> + It is recommended to remove such entries from your <filename>HOSTS</filename> file. If you think + your hosts list is neglected by <application>Privoxy's </application> configuration, consider adding your list to your <filename>user.action</filename> file: </para> <para> @@ -2187,15 +2166,15 @@ and related issues?</title>
<!-- <para> - Please see the - <ulink url="../user-manual/seealso.html">user-manual</ulink> for + Please see the + <ulink url="../user-manual/seealso.html">user-manual</ulink> for others references. </para> --> </sect2>
<sect2 renderas="sect3" id="microsuck"> -<title>I've noticed that Privoxy changes <quote>Microsoft</quote> to +<title>I've noticed that Privoxy changes <quote>Microsoft</quote> to <quote>MicroSuck</quote>! Why are you manipulating my browsing?</title>
<para> @@ -2216,43 +2195,7 @@ and related issues?</title> Privoxy generates HTML in both its own <quote>templates</quote>, and possibly whenever there are text substitutions via a &my-app; filter. While this should always conform to the HTML 4.01 specifications, it has not been - validated against this or any other standard. -</para> -</sect2> - -<sect2 renderas="sect3" id="surprise-privoxy"> -<title>How did you manage to get Privoxy on my computer without my consent?</title> - -<para> - We didn't. We make Privoxy available for download, but we don't go - around installing it on other people's systems behind their back. - If you discover Privoxy running on your system and are sure you didn't - install it yourself, somebody else did. You may not even be running - the real Privoxy, but maybe something else that only pretends to be - Privoxy, or maybe something that is based on the real Privoxy, - but has been modified. -</para> -<para> - Lately there have been reports of problems with some kind of - Privoxy versions that come preinstalled on some Netbooks. - Some of the problems described are inconsistent with the behaviour - of official Privoxy versions, which suggests that the preinstalled - software may contain vendor modifications that we don't know about - and thus can't debug. -</para> -<para> - Privoxy's <link linkend="copyright">license</link> allows vendor - modifications, but the vendor has to comply with the license, - which involves informing the user about the changes and to make - the changes available under the same license as Privoxy itself. -</para> -<para> - If you are having trouble with a modified Privoxy version, - please try to talk to whoever made the modifications before - reporting the problem to us. Please also try to convince - whoever made the modifications to talk to us. If you think - somebody gave you a modified Privoxy version without complying - to the license, please let us know. + validated against this or any other standard. </para> </sect2>
@@ -2274,7 +2217,7 @@ and related issues?</title> <para> <itemizedlist> <listitem><para> -<application>Privoxy</application> is not running. Solution: verify +<application>Privoxy</application> is not running. Solution: verify that &my-app; is installed correctly, has not crashed, and is indeed running. Turn on <application>Privoxy's</application> logging, and look at the logs to see what they say. </para></listitem> @@ -2287,7 +2230,7 @@ and related issues?</title> configuration and take the forwarders out of the equation. </para></listitem> <listitem><para> - Or you have a firewall that is interfering and blocking you. Solution: + Or you have a firewall that is interfering and blocking you. Solution: try disabling or removing the firewall as a simple test. </para></listitem> </itemizedlist> @@ -2308,7 +2251,7 @@ and related issues?</title> </sect2>
<sect2 renderas="sect3"> -<title id="flushit">I just added a new rule, but the steenkin ad is +<title id="flushit">I just added a new rule, but the steenkin ad is still getting through. How?</title> <para> If the ad had been displayed before you added its URL, it will probably be @@ -2322,16 +2265,16 @@ still getting through. How?</title> applied. Try pasting the full URL of the offending ad into <ulink url="http://config.privoxy.org/show-url-info">http://config.privoxy.org/show-url-info</ulink> and see if it really matches your new rule. Blocking ads is like blocking - spam: a lot of tinkering is required to stay ahead of the game. And - remember you need to block the URL of the ad in question, which may be + spam: a lot of tinkering is required to stay ahead of the game. And + remember you need to block the URL of the ad in question, which may be entirely different from the site URL itself. Most ads are hosted on different servers than the main site itself. If you right-click on the ad, you should - be able to get all the relevant information you need. Alternately, you can + be able to get all the relevant information you need. Alternately, you can find the correct URL by looking at <application>Privoxy's</application> logs (you may need to enable logging in the main config file if its disabled). </para> <para> - Below is a slightly modified real-life log snippet that originates with one + Below is a slightly modified real-life log snippet that originates with one requested URL: <literal>www.example.com</literal> (name of site was changed for this example, the number of requests is real). You can see in this the complexity of what goes into making up this one <quote>page</quote>. There @@ -2341,8 +2284,8 @@ still getting through. How?</title> content is obviously <quote>good</quote> or <quote>bad</quote>, but not all. Many of the more questionable looking requests, are going to outside domains that seem to be identifying themselves with suspicious looking names, making - our job a little easier. &my-app; has <quote>crunched</quote> (meaning caught - and BLOCKED) quite a few items in this example, but perhaps missed a few as well. + our job a little easier. &my-app; has <quote>crunched</quote> (meaning caught + and BLOCKED) quite a few items in this example, but perhaps missed a few as well. </para> <para> <screen> @@ -2395,7 +2338,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua What can I do?</title>
<para> - First verify that it is indeed a <application>Privoxy</application> problem, + First verify that it is indeed a <application>Privoxy</application> problem, by toggling off <application>Privoxy</application> through <ulink url="http://config.privoxy.org/toggle">http://config.privoxy.org/toggle</ulink> (the toggle feature may need to be enabled in the main @@ -2431,13 +2374,13 @@ What can I do?</title> on again. Remember to flush your browser's caches in between any such changes! </para> <para> - Alternately, if you are comfortable with a text editor, you can accomplish - the same thing by editing the appropriate actions file. Probably the easiest + Alternately, if you are comfortable with a text editor, you can accomplish + the same thing by editing the appropriate actions file. Probably the easiest way to deal with such problems when editing by hand is to add your site to a <literal>{ fragile }</literal> section in <filename>user.action</filename>, which is an alias that turns off most <quote>dangerous</quote> actions, but is also likely to turn off more actions then needed, and thus lower - your privacy and protection more than necessary, + your privacy and protection more than necessary, </para> <para> Troubleshooting actions is discussed in more detail in the <ulink @@ -2448,7 +2391,7 @@ What can I do?</title> with general configuration information and examples. </para> <para> - As a last resort, you can always see if your browser has a setting that will + As a last resort, you can always see if your browser has a setting that will bypass the proxy setting for selective sites. Modern browsers can do this. </para>
@@ -2495,7 +2438,7 @@ every time I start IE. What gives?</title> set-up DUN connection and each LAN connection in IE store the settings for each user individually. As such this enforces individual configurations rather than common ones. Hence the first time you use a DUN connection after - re-booting your system it may not perform as you expect, and prompt you for + re-booting your system it may not perform as you expect, and prompt you for the password. Just set and save the password again and all should be OK. </para>
@@ -2510,16 +2453,16 @@ every time I start IE. What gives?</title> <title>I cannot connect to any FTP sites. Privoxy is blocking me.</title> <para> - <application>Privoxy</application> cannot act as a proxy for FTP traffic, + <application>Privoxy</application> cannot act as a proxy for FTP traffic, so do not configure your browser to use <application>Privoxy</application> as an FTP proxy. The same is true for <emphasis>any protocol other than HTTP - or HTTPS (SSL)</emphasis>. + or HTTPS (SSL)</emphasis>. </para> <para> Most browsers understand FTP as well as HTTP. If you connect to a site, with a URL like <literal>ftp://ftp.example.com</literal>, your browser is making - an FTP connection, and not a HTTP connection. So while your browser may - speak FTP, <application>Privoxy</application> does not, and cannot proxy + an FTP connection, and not a HTTP connection. So while your browser may + speak FTP, <application>Privoxy</application> does not, and cannot proxy such traffic. </para> <para> @@ -2529,7 +2472,7 @@ every time I start IE. What gives?</title> accidentally enable FTP proxying in these cases. And of course, if this happens, <application>Privoxy</application> will indeed cause problems since it does not know FTP. <![%p-newstuff;[Newer version will give a sane error - message if a FTP connection is attempted.]]> Just disable the FTP setting + message if a FTP connection is attempted.]]> Just disable the FTP setting and all will be well again. </para> <para> @@ -2541,14 +2484,14 @@ every time I start IE. What gives?</title>
<!-- ~~~~~ New section ~~~~~ --> <sect2 id="macosxie" renderas="sect3"> -<title>In Mac OS X, I can't configure Microsoft Internet Explorer to use +<title>In Mac OS X, I can't configure Microsoft Internet Explorer to use Privoxy as the HTTP proxy.</title> <para> Microsoft Internet Explorer (in versions like 5.1) respects system-wide network settings. In order to change the HTTP proxy, open System Preferences, and click on the Network icon. In the settings pane that - comes up, click on the Proxies tab. Ensure the "Web Proxy (HTTP)" checkbox - is checked and enter <literal>127.0.0.1</literal> in the entry field. + comes up, click on the Proxies tab. Ensure the "Web Proxy (HTTP)" checkbox + is checked and enter <literal>127.0.0.1</literal> in the entry field. Enter <literal>8118</literal> in the Port field. The next time you start IE, it should reflect these values. </para> @@ -2556,12 +2499,12 @@ every time I start IE. What gives?</title>
<!-- ~~~~~ New section ~~~~~ --> <sect2 renderas="sect3" id="macosxuninstall"> -<title>In Mac OS X, I dragged the Privoxy folder to the trash in order to +<title>In Mac OS X, I dragged the Privoxy folder to the trash in order to uninstall it. Now the finder tells me I don't have sufficient privileges to empty the trash.</title> <para> Note: This ONLY applies to privoxy 3.0.6 and earlier. - </para> + </para> <para> Just dragging the <application>Privoxy</application> folder to the trash is not enough to delete it. <application>Privoxy</application> supplies an @@ -2569,9 +2512,9 @@ every time I start IE. What gives?</title> these details. Open the trash, drag the <application>uninstall.command</application> file out of the trash and double-click on it. You will be prompted for confirmation and the administration password. - </para> + </para> <para> - The trash may still appear full after this command; emptying the trash + The trash may still appear full after this command; emptying the trash from the desktop should make it appear empty again. </para> </sect2> @@ -2584,7 +2527,7 @@ every time I start IE. What gives?</title> <literal>localhost</literal> as my browser's proxy setting.</title> <para> We believe this is due to an IPv6-related bug in Mac OS X, but don't fully - understand the issue yet. In any case, changing the proxy setting to + understand the issue yet. In any case, changing the proxy setting to <literal>127.0.0.1</literal> instead of <literal>localhost</literal> works around the problem. </para> @@ -2609,9 +2552,9 @@ every time I start IE. What gives?</title> <filename>user.action</filename>: </para> <screen> - # Make exceptions for ill-behaved sites: - # - {-prevent-compression} + # Make exceptions for ill-behaved sites: + # + {-prevent-compression} .example.com</screen> <para> If that works, you may also want to report the problem to the @@ -2629,7 +2572,7 @@ Why?</title> its running on from the IP address of the system interface it is bound to (from the <filename>config</filename> file <emphasis>listen-address</emphasis> setting). If the system cannot supply - this information, <application>Privoxy</application> logs this condition. + this information, <application>Privoxy</application> logs this condition. </para> <para> Typically, this would be considered a minor system configuration error. It is @@ -2650,11 +2593,11 @@ Why?</title> </sect2>
<sect2 renderas="sect3" id="inuse"> -<title>When I try to launch Privoxy, I get an +<title>When I try to launch Privoxy, I get an error message <quote>port 8118 is already in use</quote> (or similar wording). Why?</title> <para> - Port 8118 is <application>Privoxy's</application> default TCP + Port 8118 is <application>Privoxy's</application> default TCP <quote>listening</quote> port. Typically this message would mean that there is already one instance of <application>Privoxy</application> running, and your system is actually trying to start a second @@ -2684,8 +2627,8 @@ Why?</title> is used? </title> <para> - This may also be caused by the <quote>demoronizer</quote> filter, - in conjunction with a web server that is misreporting the content type. Binary + This may also be caused by the <quote>demoronizer</quote> filter, + in conjunction with a web server that is misreporting the content type. Binary files are exempted from <application>Privoxy's</application> filtering (unless the web server by mistake says the file is something else). Either upgrade <application>Privoxy</application>, or go to the most recent @@ -2699,26 +2642,26 @@ Why?</title> What is the <quote>demoronizer</quote> and why is it there? </title> <para> - The original demoronizer was a Perl script that cleaned up HTML pages which - were created with certain Microsoft products. MS has used proprietary extensions + The original demoronizer was a Perl script that cleaned up HTML pages which + were created with certain Microsoft products. MS has used proprietary extensions to standardized font encodings (ISO 8859-1), which has caused problems for pages that are viewed with non-Microsoft products (and are expecting to see a standard set of fonts). The demoronizer corrected these errors so the pages displayed correctly. <application>Privoxy</application> borrowed from this script, introducing a filter based on the original demoronizer, which in turn could - correct these errors on the fly. + correct these errors on the fly. </para> <para> - But this is only needed in some situations, and will cause serious problems in some + But this is only needed in some situations, and will cause serious problems in some other situations. </para> <para> - If you are using Microsoft products, you do not need it. If you need to view - pages with UTF-8 characters (such as Cyrillic or Chinese), then it will + If you are using Microsoft products, you do not need it. If you need to view + pages with UTF-8 characters (such as Cyrillic or Chinese), then it will cause corruption of the fonts, and thus <emphasis>should not be on</emphasis>. </para> <para> - On the other hand, if you use non-Microsoft products, and you occasionally + On the other hand, if you use non-Microsoft products, and you occasionally notice weird characters on pages, you might want to try it. </para> </sect2> @@ -2728,16 +2671,16 @@ Why?</title> Why do I keep seeing <quote>PrivoxyWindowOpen()</quote> in raw source code? </title> <para> - <application>Privoxy</application> is attempting to disable malicious - <ulink url="http://en.wikipedia.org/wiki/Javascript">Javascript</ulink> + <application>Privoxy</application> is attempting to disable malicious + <ulink url="http://en.wikipedia.org/wiki/Javascript">Javascript</ulink> in this case, with the <literal>unsolicited-popups</literal> - filter. <application>Privoxy</application> cannot tell very well + filter. <application>Privoxy</application> cannot tell very well <quote>good</quote> code snippets from <quote>bad</quote> code snippets. </para> <para> - If you see this in HTML source, and the page displays without problems, then - this is good, and likely some pop-up window was disabled. If you see this - where it is causing a problem, such as a downloaded program source code file, + If you see this in HTML source, and the page displays without problems, then + this is good, and likely some pop-up window was disabled. If you see this + where it is causing a problem, such as a downloaded program source code file, then you should set an exception for this site or page such that the integrity of the page stays in tact by disabling all filtering. </para> @@ -2775,13 +2718,13 @@ Why?</title>
<sect2 renderas="sect3" id="allcpu"> <title> - At one site Privoxy just hangs, and starts taking + At one site Privoxy just hangs, and starts taking all CPU. Why is this? </title> <para> This is probably a manifestation of the <quote>100% cpu</quote> problem that - occurs on pages containing many (thousands upon thousands) of blank lines. The blank lines - are in the raw HTML source of the page, and the browser just ignores them. But the + occurs on pages containing many (thousands upon thousands) of blank lines. The blank lines + are in the raw HTML source of the page, and the browser just ignores them. But the pattern matching in <application>Privoxy's</application> page filtering mechanism is trying to match against absurdly long strings and this becomes very CPU-intensive, taking a long, long time to complete. @@ -2909,7 +2852,7 @@ browsing has slowed to a crawl. What gives? </title> If you compiled &my-app; with threading support (on POSIX-based systems), the <quote>Conditional #defines</quote> section on <ulink url="http://config.privoxy.org/show-status">http://config.privoxy.org/show-status</ulink> - will list <quote>FEATURE_PTHREAD</quote> as <quote>enabled</quote>. + will list <quote>FEATURE_PTHREAD</quote> as <quote>enabled</quote>. </para> </sect2>
@@ -2922,18 +2865,18 @@ browsing has slowed to a crawl. What gives? </title> &contacting; <!-- end contacting --> </sect1> - + <!-- ~~~~~ New section ~~~~~ --> <sect1 id="copyright"><title>Privoxy Copyright, License and History</title>
<!-- Include copyright.sgml --> ©right; <!-- end --> - +
<para> Portions of this document are <quote>borrowed</quote> from the original - <application>Junkbuster</application> (tm) FAQ, and modified as + <application>Junkbuster</application> (tm) FAQ, and modified as appropriate for <application>Privoxy</application>. </para>
@@ -2954,8 +2897,8 @@ browsing has slowed to a crawl. What gives? </title>
</sect1> <!-- ~ End section ~ --> - - + + <!-- ~~~~~ New section ~~~~~ --> <!-- <sect1 id="seealso"><title>See also</title> @@ -2972,8 +2915,8 @@ browsing has slowed to a crawl. What gives? </title> <!-- hhmts end --> <!-- Tue 09/11/01 06:38:14 PM EST: Test SGML doc by Hal Burgiss. - - This program is free software; you can redistribute it + + This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at @@ -2988,112 +2931,10 @@ browsing has slowed to a crawl. What gives? </title> The GNU General Public License should be included with this file. If not, you can view it at http://www.gnu.org/copyleft/gpl.html - or write to the Free Software Foundation, Inc., + or write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
$Log: faq.sgml,v $ -Revision 2.85 2011/12/26 17:05:40 fabiankeil -Bump entities for 3.0.19 - -Revision 2.84 2011/11/13 17:03:54 fabiankeil -Bump entities for 3.0.18 stable - -Revision 2.83 2011/11/13 16:53:24 fabiankeil -Rephrase the donations section some more - -Mention that the domain is now sponsored by Mythic Beasts Ltd -and make it clear that asking questions about donations is -possible, too. - -Revision 2.82 2011/11/13 16:50:34 fabiankeil -Note that donations for Privoxy are currently only tax-deductible in the US - -As it turns out tax-deductible donations in a few other western -countries are theoretically possible through partner organizations -but aren't available out of the box. - -Revision 2.81 2011/09/04 11:10:12 fabiankeil -Ditch trailing whitespace - -Revision 2.80 2011/08/18 11:42:50 fabiankeil -Bump some more documentation copyright ranges. - -Revision 2.79 2011/08/17 10:40:07 fabiankeil -Update the entities. - -This commit is chronological out of order. - -Revision 2.78 2011/04/19 13:14:10 fabiankeil -Fix spelling errors in the documentation. Found with codespell. - -Revision 2.77 2011/03/03 14:22:12 fabiankeil -Remove duplicated 'the' - -Revision 2.76 2010/11/22 10:35:02 fabiankeil -Mention socks5 in another part of the Tor section. - -Revision 2.75 2010/11/13 10:08:00 fabiankeil -Fix a link to the 'intercepting' entry and add another one - -Revision 2.74 2010/11/13 10:07:46 fabiankeil -Remove the product names in the 'otherproxy' entry's title. - -I'm tired of getting the 'otherproxy' entry as first hit -when searching the index for the Tor FAQ. - -Revision 2.73 2010/11/06 12:55:48 fabiankeil -Set p-version to 3.0.17 - -Revision 2.72 2010/02/27 12:13:17 fabiankeil -Fix spelling. - -Revision 2.71 2010/02/27 12:12:13 fabiankeil -Consistently recommending socks5 in the Tor entry and mention its advantage compared to socks4a. -Reported by David in #2960129. - -Revision 2.70 2010/02/20 18:08:31 ler762 -fix typo - -Revision 2.69 2010/02/13 17:38:27 fabiankeil -Update entities for 3.0.16 stable. - -Revision 2.68 2010/01/30 19:51:28 fabiankeil -New FAQ entry: How did you manage to get Privoxy on my computer without my consent? - -Also bump copyright. - -Revision 2.67 2009/11/15 14:24:12 fabiankeil -Prepare to generate docs for 3.0.16 UNRELEASED. - -Revision 2.66 2009/10/10 05:48:55 fabiankeil -Prepare for 3.0.15 beta. - -Revision 2.65 2009/07/18 16:24:39 fabiankeil -Bump entities for 3.0.14 beta. - -Revision 2.64 2009/07/18 12:18:52 fabiankeil -Don't describe the action files in the FAQ when we can simply link to the description in the User Manual. - -Revision 2.63 2009/06/15 15:08:03 fabiankeil -Patch #2806626 from Frédéric Crozat to fix a closing tag. - -Revision 2.62 2009/06/12 14:30:58 fabiankeil -Update entities for 3.0.13 beta. - -Revision 2.61 2009/06/12 11:52:33 fabiankeil -Mention the TODO list in the participate entry. - -Revision 2.60 2009/04/07 12:25:05 fabiankeil -In the "I would like to help ..." entry: -- Change the ids to more general ones as helping out doesn't require - joining the team (and joining the team requires significantly helping - out first, anyway). -- Add links to the subscription pages for the main mailing lists. - -Revision 2.59 2009/03/28 15:33:41 fabiankeil -Recommend the use of forward-socks5 when forwarding to Tor. -The error messages are more detailed than with forward-socks4a. - Revision 2.58 2009/03/21 12:27:44 fabiankeil Turn the donation entry title into a question, also rephrase the content a bit. diff --git a/external/privoxy/doc/source/history.sgml b/external/privoxy/doc/source/history.sgml index b9156dd..9e8b2fa 100644 --- a/external/privoxy/doc/source/history.sgml +++ b/external/privoxy/doc/source/history.sgml @@ -2,8 +2,8 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/history.sgml,v $
Purpose : Entity included in other project documents. - - $Id: history.sgml,v 2.8 2011/09/04 11:10:12 fabiankeil Exp $ + + $Id: history.sgml,v 2.7 2009/02/22 11:05:21 fabiankeil Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE. @@ -12,7 +12,7 @@ This file used for inclusion with other documents only. ======================================================================
- If you make changes to this file, please verify the finished + If you make changes to this file, please verify the finished docs all display as intended.
This file is included into: @@ -26,7 +26,7 @@
<para> A long time ago, there was the - <ulink url="http://www.junkbusters.com/ijb.html"><application>Internet Junkbuster</application></ulink>, + <ulink url="http://www.junkbusters.com/ijb.html"><application>Internet Junkbuster</application></ulink>, by Anonymous Coders and <ulink url="http://www.junkbusters.com/">Junkbusters Corporation</ulink>. This saved many users a lot of pain in the early days of web advertising and user tracking. @@ -36,7 +36,7 @@ But the web, its protocols and standards, and with it, the techniques for forcing ads on users, give up autonomy over their browsing, and for tracking them, keeps evolving. Unfortunately, the <application>Internet - Junkbuster</application> did not. Version 2.0.2, published in 1998, was + Junkbuster</application> did not. Version 2.0.2, published in 1998, was (and is) the last official <ulink url="http://www.junkbusters.com/ijbdist.html#release">release</ulink> available from <ulink url="http://www.junkbusters.com">Junkbusters Corporation</ulink>. @@ -66,6 +66,6 @@
<para> The result of this is <application>Privoxy</application>, whose first - stable version, 3.0, was released August, 2002. + stable version, 3.0, was released August, 2002. <!-- Cautious!!!!!!!!! ;) --> </para> diff --git a/external/privoxy/doc/source/install.sgml b/external/privoxy/doc/source/install.sgml index 5ce5096..bba9ccc 100644 --- a/external/privoxy/doc/source/install.sgml +++ b/external/privoxy/doc/source/install.sgml @@ -1,7 +1,7 @@ <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ -<!entity % dummy "IGNORE"> +<!entity % dummy "IGNORE"> <!entity buildsource SYSTEM "buildsource.sgml"> -<!entity p-version "3.0.19"> +<!entity p-version "3.0.11"> <!entity p-status "stable"> <!entity % p-stable "INCLUDE"> <!entity % p-not-stable "IGNORE"> @@ -15,16 +15,16 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/install.sgml,v $
Purpose : INSTALL file for Privoxy - - $Id: install.sgml,v 2.21 2011/12/26 17:05:40 fabiankeil Exp $ + + $Id: install.sgml,v 2.11 2009/02/12 16:08:26 fabiankeil Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE.
======================================================================== - NOTE: Please read developer-manual/documentation.html before touching + NOTE: Please read developer-manual/documentation.html before touching anything in this, or other Privoxy documentation. You have been warned! - Failure to abide by this rule will result in the revocation of your license + Failure to abide by this rule will result in the revocation of your license to live a peaceful existence! ========================================================================
@@ -62,10 +62,10 @@ * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -80,8 +80,8 @@ * The GNU General Public License should be included with * this file. If not, you can view it at * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html - * or write to the Free Software Foundation, Inc., - * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, + * or write to the Free Software Foundation, Inc., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, * USA * *********************************************************************/ diff --git a/external/privoxy/doc/source/ldp.dsl.in b/external/privoxy/doc/source/ldp.dsl.in index ccbea7d..a86de0d 100644 --- a/external/privoxy/doc/source/ldp.dsl.in +++ b/external/privoxy/doc/source/ldp.dsl.in @@ -83,7 +83,7 @@ ;; REFENTRY body-attr ;; PURP What attributes should be hung off of BODY? ;; DESC - ;; A list of the BODY attributes that should be generated. + ;; A list of the the BODY attributes that should be generated. ;; The format is a list of lists, each interior list contains the ;; name and value of a BODY attribute. ;; /DESC diff --git a/external/privoxy/doc/source/license.sgml b/external/privoxy/doc/source/license.sgml index 9a50425..b674770 100644 --- a/external/privoxy/doc/source/license.sgml +++ b/external/privoxy/doc/source/license.sgml @@ -2,17 +2,17 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/license.sgml,v $
Purpose : Entity included in other project documents. - - $Id: license.sgml,v 2.7 2011/09/04 11:10:12 fabiankeil Exp $ + + $Id: license.sgml,v 2.6 2008/05/23 15:09:48 fabiankeil Exp $
Copyright (C) 2001-2008 Privoxy Developers http://www.privoxy.org/ See LICENSE. - + ====================================================================== This file used for inclusion with other documents only. ======================================================================
- If you make changes to this file, please verify the finished + If you make changes to this file, please verify the finished docs all display as intended.
This file is included into: @@ -27,7 +27,7 @@
<para> <application>Privoxy</application> is free software; you can - redistribute it and/or modify it under the terms of the + redistribute it and/or modify it under the terms of the <citetitle>GNU General Public License</citetitle>, version 2, as published by the Free Software Foundation. </para> diff --git a/external/privoxy/doc/source/newfeatures.sgml b/external/privoxy/doc/source/newfeatures.sgml index 4ddd0c1..b1db531 100644 --- a/external/privoxy/doc/source/newfeatures.sgml +++ b/external/privoxy/doc/source/newfeatures.sgml @@ -2,8 +2,8 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/newfeatures.sgml,v $
Purpose : Entity included in other project documents. - - $Id: newfeatures.sgml,v 2.14 2009/10/10 05:51:13 fabiankeil Exp $ + + $Id: newfeatures.sgml,v 2.10 2009/02/14 17:37:13 fabiankeil Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE. @@ -12,7 +12,7 @@ This file used for inclusion with other documents only. ======================================================================
- If you make changes to this file, please verify the finished + If you make changes to this file, please verify the finished docs all display as intended.
This file is included into: @@ -30,64 +30,57 @@ FIXME: complete the list of features. change the order: most important features to the top of the list. prefix new features with "NEW". </para> - </listitem> + </listitem> --> <listitem> <para> - Supports "Connection: keep-alive". Outgoing connections can - be kept alive independently from the client. - </para> - </listitem> - - <listitem> - <para> - Supports IPv6, provided the operating system does so too, - and the configure script detects it. + Can keep outgoing connections alive and reuse them later on. </para> - </listitem> + </listitem>
<listitem> <para> Supports tagging which allows to change the behaviour based on client and server headers. </para> - </listitem> + </listitem>
<listitem> <para> Can be run as an "intercepting" proxy, which obviates the need to configure browsers individually. </para> - </listitem> + </listitem>
<listitem> <para> Sophisticated actions and filters for manipulating both server and client - headers. + headers. </para> - </listitem> + </listitem>
<listitem> <para> Can be chained with other proxies. </para> - </listitem> + </listitem>
<listitem> <para> - Integrated browser-based configuration and control utility at <ulink + Integrated browser based configuration and control utility at <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> (shortcut: <ulink url="http://p.p/">http://p.p/</ulink>). Browser-based tracing of rule and filter effects. Remote toggling. </para> - </listitem> + </listitem>
<listitem> <para> Web page filtering (text replacements, removes banners based on size, - invisible <quote>web-bugs</quote> and HTML annoyances, etc.) + invisible <quote>web-bugs</quote>, JavaScript and HTML annoyances, + pop-up windows, etc.) </para> - </listitem> + </listitem>
<listitem> <para> @@ -95,50 +88,69 @@ user settings to reside in separate files, so that installing updated actions files won't overwrite individual user settings. </para> - </listitem> + </listitem>
<listitem> <para> - Support for Perl Compatible Regular Expressions in the configuration files, and + Support for Perl Compatible Regular Expressions in the configuration files, and a more sophisticated and flexible configuration syntax. </para> - </listitem> + </listitem>
<listitem> <para> - GIF de-animation. + Improved cookie management features (e.g. session based cookies). </para> - </listitem> +</listitem>
<listitem> <para> + GIF de-animation. + </para> + </listitem> + + <listitem> + <para> Bypass many click-tracking scripts (avoids script redirection). </para> - </listitem> + </listitem> + + <listitem> + <para> + Multi-threaded (POSIX and native threads). + </para> + </listitem>
<listitem> <para> User-customizable HTML templates for most proxy-generated pages (e.g. "blocked" page). </para> - </listitem> + </listitem>
<listitem> <para> Auto-detection and re-reading of config file changes. </para> - </listitem> + </listitem> + + <listitem> + <para> + Improved signal handling, and a true daemon mode (Unix). + </para> +</listitem>
<listitem> <para> - Most features are controllable on a per-site or per-location basis. + Every feature now controllable on a per-site or per-location basis, configuration + more powerful and versatile over-all. </para> -</listitem> +</listitem>
<listitem> <para> Many smaller new features added, limitations and bugs removed. </para> -</listitem> +</listitem>
</itemizedlist> </para> diff --git a/external/privoxy/doc/source/p-authors.sgml b/external/privoxy/doc/source/p-authors.sgml index 6ef6077..b8eb1ca 100644 --- a/external/privoxy/doc/source/p-authors.sgml +++ b/external/privoxy/doc/source/p-authors.sgml @@ -2,8 +2,8 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/p-authors.sgml,v $
Purpose : Entity included in other project documents. - - $Id: p-authors.sgml,v 2.44 2011/12/26 18:41:54 fabiankeil Exp $ + + $Id: p-authors.sgml,v 2.34 2009/02/08 18:13:26 fabiankeil Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE. @@ -12,7 +12,7 @@ This file used for inclusion with other documents only. ======================================================================
- If you make changes to this file, please verify the finished + If you make changes to this file, please verify the finished docs all display as intended.
This file is included into: @@ -35,8 +35,11 @@ Current Privoxy Team: ]]>
Hal Burgiss + Mark Miller + Gerry Murphy Lee Rian Roland Rosenfeld + Jörg Strohmayer <![%p-authors-formal;[ </literallayout>
@@ -58,13 +61,10 @@ Current Privoxy Team: Adam Lock Guy Laroche Justin McMurtry - Mark Miller - Gerry Murphy Andreas Oesterhelt Haroon Rafique Georg Sauthoff Thomas Steudten - Jörg Strohmayer Rodney Stromlund Sviatoslav Sviridov Sarantis Paskalis @@ -80,14 +80,10 @@ Current Privoxy Team: <literallayout> Ken Arromdee Devin Bayer - Havard Berland Gergely Bor - Francois Botha Reiner Buehl Andrew J. Caines Clifford Caoile - Wan-Teh Chang - Billy Crook Frédéric Crozat Michael T. Davis Mattes Dolak @@ -99,7 +95,6 @@ Current Privoxy Team: Stephen Gildea Daniel Griscom Felix Gröbert - Jeff H. Aaron Hamid Darel Henman Magnus Holmgren @@ -113,17 +108,13 @@ Current Privoxy Team: Bert van Leeuwen Don Libes Paul Lieverse - Han Liu Toby Lyward Wil Mahan Jindrich Makovicka - Raphael Marichez - Francois Marier David Mediavilla Raphael Moll Amuro Namie Adam Piggott - Petr Písar Dan Price Roberto Ragusa Félix Rauch @@ -131,7 +122,6 @@ Current Privoxy Team: Chung-chieh Shan Spinor S. Bart Schelstraete - Dan Stahlke Oliver Stoeneberg Peter Thoenen Martin Thomas diff --git a/external/privoxy/doc/source/p-config.sgml b/external/privoxy/doc/source/p-config.sgml index eb2c951..3b59fbf 100644 --- a/external/privoxy/doc/source/p-config.sgml +++ b/external/privoxy/doc/source/p-config.sgml @@ -3,39 +3,39 @@
Purpose : Used with other docs and files only.
- $Id: p-config.sgml,v 2.79 2011/09/04 11:10:12 fabiankeil Exp $ + $Id: p-config.sgml,v 2.41 2009/02/19 16:59:41 fabiankeil Exp $
- Copyright (C) 2001-2011 Privoxy Developers http://www.privoxy.org/ + Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE.
======================================================================== - NOTE: Please read developer-manual/documentation.html before touching + NOTE: Please read developer-manual/documentation.html before touching anything in this, or other Privoxy documentation. ========================================================================
- - This file contains all the config file comments and options. It used to + + This file contains all the config file comments and options. It used to build both the user-manual config sections, and all of config (yes, the main config file) itself.
- Rationale: This is broken up into two files since a file with a prolog + Rationale: This is broken up into two files since a file with a prolog (DTD, etc) cannot be sourced as a secondary file. config.sgml is basically a wrapper for this file.
IMPORTANT:
- OPTIONS: The actual options are included in this file and prefixed with - '@@', and processed by the Makefile to strip the '@@'. Default options - that should appear commented out should be listed as: '@@#OPTION'. + OPTIONS: The actual options are included in this file and prefixed with + '@@', and processed by the Makefile to strip the '@@'. Default options + that should appear commented out should be listed as: '@@#OPTION'. Otherwise, as '@@OPTION'. Example:
@@listen-address 127.0.0.1:8118
- The Makefile does significant other processing too. The final results - should be checked to make sure that the perl processing does not + The Makefile does significant other processing too. The final results + should be checked to make sure that the perl processing does not fubar something!!! Makefile processing requires w3m, fmt (shell line formatter), and perl. - +
This file is included into:
@@ -50,8 +50,8 @@ <title>The Main Configuration File</title>
<para> - By default, the main configuration file is named <filename>config</filename>, - with the exception of Windows, where it is named <filename>config.txt</filename>. + Again, the main configuration file is named <filename>config</filename> on + Linux/Unix/BSD and OS/2, and <filename>config.txt</filename> on Windows. Configuration lines consist of an initial keyword followed by a list of values, all separated by whitespace (any number of spaces or tabs). For example: @@ -59,11 +59,11 @@
<para> <literal> - <msgtext> + <msgtext> <literallayout> <emphasis>confdir /etc/privoxy</emphasis></literallayout> </msgtext> - </literal> + </literal> </para>
<para> @@ -81,9 +81,7 @@ <para> The main config file controls all aspects of <application>Privoxy</application>'s operation that are not location dependent (i.e. they apply universally, no matter - where you may be surfing). Like the filter and action files, the config file is - a plain text file and can be modified with a text editor like emacs, vim or - notepad.exe. + where you may be surfing). </para>
]]> @@ -97,10 +95,10 @@ Sample Configuration File for Privoxy v&p-version; </title> <para> - $Id: p-config.sgml,v 2.79 2011/09/04 11:10:12 fabiankeil Exp $ + $Id: p-config.sgml,v 2.41 2009/02/19 16:59:41 fabiankeil Exp $ </para> <para> -Copyright (C) 2001-2011 Privoxy Developers http://www.privoxy.org/ +Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ </para>
<para> @@ -167,7 +165,7 @@ II. FORMAT OF THE CONFIGURATION FILE </para> <para> 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. + you can make it a comment and it will be treated as if it weren't there. This is called "commenting out" an option and can be useful. Removing the # again is called "uncommenting". </para> @@ -237,11 +235,11 @@ II. FORMAT OF THE CONFIGURATION FILE <term>Notes:</term> <listitem> <para> - The User Manual URI is the single best source of information on + The User Manual URI is the single best source of information on <application>Privoxy</application>, and is used for help links from some of the internal CGI pages. The manual itself is normally packaged with the binary distributions, so you probably want to set this to a locally - installed copy. + installed copy. </para> <para> Examples: @@ -265,7 +263,7 @@ II. FORMAT OF THE CONFIGURATION FILE <para> <screen> user-manual file://///some-server/some-path/privoxy-&p-version;/user-manual/</screen> </para> - --> + --> <para> The best all purpose solution is simply to put the full local <literal>PATH</literal> to where the <citetitle>User Manual</citetitle> is @@ -281,7 +279,7 @@ II. FORMAT OF THE CONFIGURATION FILE (or the shortcut: <literal>http://p.p/user-manual/</literal>). </para> <para> - If the documentation is not on the local system, it can be accessed + If the documentation is not on the local system, it can be accessed from a remote server, as: </para> <para> @@ -295,7 +293,7 @@ II. FORMAT OF THE CONFIGURATION FILE file</emphasis>, because it is used while the config file is being read on start-up. </para> - </warning> + </warning> ]]>
<![%config-file;[ @@ -304,7 +302,7 @@ II. FORMAT OF THE CONFIGURATION FILE WARNING!!! </para> <blockquote> - <para> + <para> If set, this option should be the first option in the config file, because it is used while the config file is being read. </para> @@ -327,7 +325,7 @@ II. FORMAT OF THE CONFIGURATION FILE <term>Specifies:</term> <listitem> <para> - A URL to be displayed in the error page that users will see if access to an untrusted page is denied. + A URL to be displayed in the error page that users will see if access to an untrusted page is denied. </para> </listitem> </varlistentry> @@ -415,7 +413,7 @@ II. FORMAT OF THE CONFIGURATION FILE If both <literal>admin-address</literal> and <literal>proxy-info-url</literal> are unset, the whole "Local Privoxy Support" box on all generated pages will not be shown. - </para> + </para> </listitem> </varlistentry> </variablelist> @@ -464,10 +462,10 @@ II. FORMAT OF THE CONFIGURATION FILE If both <literal>admin-address</literal> and <literal>proxy-info-url</literal> are unset, the whole "Local Privoxy Support" box on all generated pages will not be shown. - </para> + </para> <para> This URL shouldn't be blocked ;-) - </para> + </para> </listitem> </varlistentry> </variablelist> @@ -489,7 +487,7 @@ II. FORMAT OF THE CONFIGURATION FILE <application>Privoxy</application> can (and normally does) use a number of other files for additional configuration, help and logging. This section of the configuration file tells <application>Privoxy</application> - where to find those other files. + where to find those other files. </para>
<para> @@ -533,16 +531,16 @@ II. FORMAT OF THE CONFIGURATION FILE <para> No trailing <quote><literal>/</literal></quote>, please. </para> - <!-- + <!-- This is really outdated and not likely to happen. HB 09/20/06 <para> When development goes modular and multi-user, the blocker, filter, and per-user config will be stored in subdirectories of <quote>confdir</quote>. - For now, the configuration directory structure is flat, except for - <filename>confdir/templates</filename>, where the HTML templates for CGI - output reside (e.g. <application>Privoxy's</application> 404 error page). + For now, the configuration directory structure is flat, except for + <filename>confdir/templates</filename>, where the HTML templates for CGI + output reside (e.g. <application>Privoxy's</application> 404 error page). </para> - --> + --> </listitem> </varlistentry> </variablelist> @@ -685,7 +683,7 @@ actionsfile <term>Effect if unset:</term> <listitem> <para> - No actions are taken at all. More or less neutral proxying. + No actions are taken at all. More or less neutral proxying. </para> </listitem> </varlistentry> @@ -695,15 +693,15 @@ actionsfile <para> Multiple <literal>actionsfile</literal> lines are permitted, and are in fact recommended! </para> - <para> + <para> The default values are <filename>default.action</filename>, which is the <quote>main</quote> actions file maintained by the developers, and <filename>user.action</filename>, where you can make your personal additions. </para> - <para> - Actions files contain all the per site and per URL configuration for + <para> + Actions files contain all the per site and per URL configuration for ad blocking, cookie management, privacy considerations, etc. - There is no point in using <application>Privoxy</application> without at + There is no point in using <application>Privoxy</application> without at least one actions file. </para> <para> @@ -772,7 +770,7 @@ actionsfile rules that use <link linkend="regex">regular expressions</link>. These rules permit powerful changes on the content of Web pages, and optionally the headers as well, e.g., you could try to disable your favorite JavaScript annoyances, - re-write the actual displayed text, or just have some fun + re-write the actual displayed text, or just have some fun playing buzzword bingo with web pages. </para> <para> @@ -796,7 +794,7 @@ actionsfile </variablelist>
<![%config-file;[<literallayout>@@filterfile default.filter</literallayout>]]> -<![%config-file;[<literallayout>@@filterfile user.filter # User customizations</literallayout>]]> +<![%config-file;[<literallayout>@@#filterfile user.filter # User customizations</literallayout>]]> </sect3>
@@ -858,7 +856,7 @@ actionsfile periodically remove it. On Unix systems, you can do this with a cron job (see <quote>man cron</quote>). For Red Hat based Linux distributions, a <command>logrotate</command> script has been included. - </para> + </para> <para> Any log files must be writable by whatever user <application>Privoxy</application> is being run as (on Unix, default user id is <quote>privoxy</quote>). @@ -911,14 +909,14 @@ actionsfile </para> <para> If you specify a trust file, <application>Privoxy</application> will only allow - access to sites that are specified in the trustfile. Sites can be listed + access to sites that are specified in the trustfile. Sites can be listed in one of two ways: </para> <para> - Prepending a <literal>~</literal> character limits access to this site - only (and any sub-paths within this site), e.g. + Prepending a <literal>~</literal> character limits access to this site + only (and any sub-paths within this site), e.g. <literal>~www.example.com</literal> allows access to - <literal>~www.example.com/features/news.html</literal>, etc. + <literal>~www.example.com/features/news.html</literal>, etc. </para> <para> Or, you can designate sites as <emphasis>trusted referrers</emphasis>, by @@ -932,7 +930,7 @@ actionsfile made. </para> <para> - If you use the <literal>+</literal> operator in the trust file, it may grow + If you use the <literal>+</literal> operator in the trust file, it may grow considerably over time. </para> <para> @@ -944,7 +942,7 @@ actionsfile <para> Possible applications include limiting Internet access for children. </para> - + </listitem> </varlistentry> </variablelist> @@ -1009,7 +1007,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 + debug 16 # log all data written to the network into the logfile debug 32 # debug force feature debug 64 # debug regular expression filters debug 128 # debug redirects @@ -1019,7 +1017,6 @@ 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 </programlisting> </para> <para> @@ -1028,7 +1025,7 @@ actionsfile </para> <para> A debug level of 1 is informative because it will show you each request - as it happens. <emphasis>1, 1024, 4096 and 8192 are recommended</emphasis> + as it happens. <emphasis>1, 4096 and 8192 are recommended</emphasis> so that you will notice when things go wrong. The other levels are probably only of interest if you are hunting down a specific problem. They can produce a hell of an output (especially 16). @@ -1194,7 +1191,7 @@ actionsfile <term>Specifies:</term> <listitem> <para> - The address and TCP port on which <application>Privoxy</application> will + The IP address and TCP port on which <application>Privoxy</application> will listen for client requests. </para> </listitem> @@ -1203,7 +1200,6 @@ actionsfile <term>Type of value:</term> <listitem> <para>[<replaceable class="parameter">IP-Address</replaceable>]:<replaceable class="parameter">Port</replaceable></para> - <para>[<replaceable class="parameter">Hostname</replaceable>]:<replaceable class="parameter">Port</replaceable></para> </listitem> </varlistentry>
@@ -1217,9 +1213,9 @@ actionsfile <term>Effect if unset:</term> <listitem> <para> - Bind to 127.0.0.1 (IPv4 localhost), port 8118. This is suitable and - recommended for home users who run <application>Privoxy</application> on - the same machine as their browser. + Bind to 127.0.0.1 (localhost), port 8118. This is suitable and recommended for + home users who run <application>Privoxy</application> on the same machine as + their browser. </para> </listitem> </varlistentry> @@ -1235,55 +1231,11 @@ actionsfile will need to override the default. </para> <para> - You can use this statement multiple times to make - <application>Privoxy</application> listen on more ports or more - <abbrev>IP</abbrev> addresses. Suitable if your operating system does not - support sharing <abbrev>IPv6</abbrev> and <abbrev>IPv4</abbrev> protocols - on the same socket. - </para> - <para> - If a hostname is used instead of an IP address, <application>Privoxy</application> - will try to resolve it to an IP address and if there are multiple, use the first - one returned. - </para> - <para> - If the address for the hostname isn't already known on the system - (for example because it's in /etc/hostname), this may result in DNS - traffic. - </para> - <para> - If the specified address isn't available on the system, or if the - hostname can't be resolved, <application>Privoxy</application> - will fail to start. - </para> - <para> - IPv6 addresses containing colons have to be quoted by brackets. - They can only be used if <application>Privoxy</application> has - been compiled with IPv6 support. If you aren't sure if your version - supports it, have a look at - <literal>http://config.privoxy.org/show-status</literal>. - </para> - <para> - Some operating systems will prefer IPv6 to IPv4 addresses even if the - system has no IPv6 connectivity which is usually not expected by the user. - Some even rely on DNS to resolve localhost which mean the "localhost" address - used may not actually be local. - </para> - <para> - It is therefore recommended to explicitly configure the intended IP address - instead of relying on the operating system, unless there's a strong reason not to. - </para> - <para> - If you leave out the address, <application>Privoxy</application> will bind to all - IPv4 interfaces (addresses) on your machine and may become reachable from the - Internet and/or the local network. Be aware that some GNU/Linux distributions - modify that behaviour without updating the documentation. Check for non-standard - patches if your <application>Privoxy</application>version behaves differently. - </para> - <para> - If you configure <application>Privoxy</application>to be reachable from the - network, consider using <link linkend="acls">access control lists</link> - (ACL's, see below), and/or a firewall. + If you leave out the IP address, <application>Privoxy</application> will + bind to all interfaces (addresses) on your machine and may become reachable + from the Internet. In that case, consider using <link + linkend="acls">access control lists</link> (ACL's, see below), and/or + a firewall. </para> <para> If you open <application>Privoxy</application> to untrusted users, you will @@ -1291,12 +1243,6 @@ actionsfile linkend="enable-edit-actions">enable-edit-actions</link></literal> and <literal><link linkend="enable-remote-toggle">enable-remote-toggle</link></literal> </para> - <para> - With the exception noted above, listening on multiple addresses is currently - not supported by <application>Privoxy</application> directly. - It can be done on most operating systems by letting a packet filter - redirect request for certain addresses to Privoxy, though. - </para> </listitem> </varlistentry> <varlistentry> @@ -1313,16 +1259,6 @@ actionsfile listen-address 192.168.0.1:8118 </programlisting> </para> - <para> - Suppose you are running <application>Privoxy</application> on an - IPv6-capable machine and you want it to listen on the IPv6 address - of the loopback device: - </para> - <para> - <programlisting> - listen-address [::1]:8118 -</programlisting> - </para> </listitem> </varlistentry> </variablelist> @@ -1449,7 +1385,7 @@ actionsfile </para> <para> Note that you must have compiled <application>Privoxy</application> with - support for this feature, otherwise this option has no effect. + support for this feature, otherwise this option has no effect. </para> </listitem> </varlistentry> @@ -1572,7 +1508,7 @@ actionsfile </para> <para> Note that you must have compiled <application>Privoxy</application> with - support for this feature, otherwise this option has no effect. + support for this feature, otherwise this option has no effect. </para> </listitem> </varlistentry> @@ -1675,41 +1611,23 @@ ACLs: permit-access and deny-access</title> <term>Type of value:</term> <listitem> <para> - <replaceable class="parameter">src_addr</replaceable>[:<replaceable class="parameter">port</replaceable>][/<replaceable class="parameter">src_masklen</replaceable>] - [<replaceable class="parameter">dst_addr</replaceable>[:<replaceable class="parameter">port</replaceable>][/<replaceable class="parameter">dst_masklen</replaceable>]] + <replaceable class="parameter">src_addr</replaceable>[/<replaceable class="parameter">src_masklen</replaceable>] + [<replaceable class="parameter">dst_addr</replaceable>[/<replaceable class="parameter">dst_masklen</replaceable>]] </para> <para> - Where <replaceable class="parameter">src_addr</replaceable> and - <replaceable class="parameter">dst_addr</replaceable> are IPv4 addresses in dotted decimal notation or valid - DNS names, <replaceable class="parameter">port</replaceable> is a port - number, and <replaceable class="parameter">src_masklen</replaceable> and + Where <replaceable class="parameter">src_addr</replaceable> and + <replaceable class="parameter">dst_addr</replaceable> are IP addresses in dotted decimal notation or valid + DNS names, and <replaceable class="parameter">src_masklen</replaceable> and <replaceable class="parameter">dst_masklen</replaceable> are subnet masks in CIDR notation, i.e. integer values from 2 to 30 representing the length (in bits) of the network address. The masks and the whole destination part are optional. </para> - <para> - If your system implements - <ulink url="http://tools.ietf.org/html/rfc3493">RFC 3493</ulink>, then - <replaceable class="parameter">src_addr</replaceable> and <replaceable - class="parameter">dst_addr</replaceable> can be IPv6 addresses delimeted by - brackets, <replaceable class="parameter">port</replaceable> can be a number - or a service name, and - <replaceable class="parameter">src_masklen</replaceable> and - <replaceable class="parameter">dst_masklen</replaceable> can be a number - from 0 to 128. - </para> </listitem> </varlistentry> <varlistentry> <term>Default value:</term> <listitem> <para><emphasis>Unset</emphasis></para> - <para> - If no <replaceable class="parameter">port</replaceable> is specified, - any port will match. If no <replaceable class="parameter">src_masklen</replaceable> or - <replaceable class="parameter">src_masklen</replaceable> is given, the complete IP - address has to match (i.e. 32 bits for IPv4 and 128 bits for IPv6). - </para> </listitem> </varlistentry> <varlistentry> @@ -1726,11 +1644,11 @@ ACLs: permit-access and deny-access</title> <para> Access controls are included at the request of ISPs and systems administrators, and <emphasis>are not usually needed by individual users</emphasis>. - For a typical home user, it will normally suffice to ensure that + For a typical home user, it will normally suffice to ensure that <application>Privoxy</application> only listens on the localhost (127.0.0.1) or internal (home) network address by means of the <link linkend="listen-address"><emphasis>listen-address</emphasis></link> - option. + option. </para> <para> Please see the warnings in the FAQ that <application>Privoxy</application> @@ -1759,13 +1677,6 @@ ACLs: permit-access and deny-access</title> IP addresses, only the first one is used. </para> <para> - 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). <application>Privoxy</application> can handle it - and maps such ACL addresses automatically. - </para> - <para> Denying access to particular sites by ACL may have undesired side effects if the site in question is hosted on a machine which also hosts other sites (most sites are). @@ -1806,24 +1717,6 @@ ACLs: permit-access and deny-access</title> deny-access 192.168.45.73 www.dirty-stuff.example.com </screen> </para> - <para> - Allow access from the IPv4 network 192.0.2.0/24 even if listening on - an IPv6 wild card address (not supported on all platforms): - </para> - <para> - <programlisting> - permit-access 192.0.2.0/24 -</programlisting> - </para> - <para> - This is equivalent to the following line even if listening on an - IPv4 address (not supported on all platforms): - </para> - <para> - <programlisting> - permit-access [::ffff:192.0.2.0]/120 -</programlisting> - </para> </listitem> </varlistentry> </variablelist> @@ -1867,7 +1760,7 @@ ACLs: permit-access and deny-access</title> <listitem> <para> For content filtering, i.e. the <literal>+filter</literal> and - <literal>+deanimate-gif</literal> actions, it is necessary that + <literal>+deanimate-gif</literal> actions, it is necessary that <application>Privoxy</application> buffers the entire document body. This can be potentially dangerous, since a server could just keep sending data indefinitely and wait for your RAM to exhaust -- with nasty consequences. @@ -1940,12 +1833,12 @@ ACLs: permit-access and deny-access</title> <replaceable class="parameter">http_parent</replaceable>[:<replaceable class="parameter">port</replaceable>] </para> <para> - where <replaceable class="parameter">target_pattern</replaceable> is a <link linkend="af-patterns">URL pattern</link> + where <replaceable class="parameter">target_pattern</replaceable> is a <link linkend="af-patterns">URL pattern</link> that specifies to which requests (i.e. URLs) this forward rule shall apply. Use <literal>/</literal> to denote <quote>all URLs</quote>. <replaceable class="parameter">http_parent</replaceable>[:<replaceable class="parameter">port</replaceable>] is the DNS name or IP address of the parent HTTP proxy through which the requests should be forwarded, - optionally followed by its listening port (default: 8000). + optionally followed by its listening port (default: 8080). Use a single dot (<literal>.</literal>) to denote <quote>no forwarding</quote>. </para> </listitem> @@ -1972,16 +1865,6 @@ ACLs: permit-access and deny-access</title> forwarded to another HTTP proxy but are made directly to the web servers. </para> <para> - <replaceable class="parameter">http_parent</replaceable> can be a - numerical IPv6 address (if - <ulink url="http://tools.ietf.org/html/rfc3493">RFC 3493</ulink> is - implemented). To prevent clashes with the port delimiter, the whole IP - address has to be put into brackets. On the other hand a <replaceable - class="parameter">target_pattern</replaceable> containing an IPv6 address - has to be put into angle brackets (normal brackets are reserved for - regular expressions already). - </para> - <para> Multiple lines are OK, they are checked in sequence, and the last match wins. </para> </listitem> @@ -2008,24 +1891,6 @@ ACLs: permit-access and deny-access</title> forward .isp.example.net . </screen> </para> - <para> - Parent proxy specified by an IPv6 address: - </para> - <para> - <programlisting> - forward / [2001:DB8::1]:8000 -</programlisting> - </para> - <para> - Suppose your parent proxy doesn't support IPv6: - </para> - <para> - <programlisting> - forward / parent-proxy.example.org:8000 - forward ipv6-server.example.org . - forward <[2-3][0-9a-f][0-9a-f][0-9a-f]:*> . -</programlisting> - </para> </listitem> </varlistentry> </variablelist> @@ -2063,7 +1928,7 @@ forward-socks4, forward-socks4a and forward-socks5</title> and <replaceable class="parameter">socks_proxy</replaceable> are IP addresses in dotted decimal notation or valid DNS names (<replaceable class="parameter">http_parent</replaceable> - may be <quote>.</quote> to denote <quote>no HTTP forwarding</quote>), and the optional + may be <quote>.</quote> to denote <quote>no HTTP forwarding</quote>), and the optional <replaceable class="parameter">port</replaceable> parameters are TCP ports, i.e. integer values from 1 to 65535 </para> @@ -2098,17 +1963,6 @@ forward-socks4, forward-socks4a and forward-socks5</title> With <literal>forward-socks5</literal> the DNS resolution will happen on the remote server as well. </para> <para> - <replaceable class="parameter">socks_proxy</replaceable> and - <replaceable class="parameter">http_parent</replaceable> can be a - numerical IPv6 address (if - <ulink url="http://tools.ietf.org/html/rfc3493">RFC 3493</ulink> is - implemented). To prevent clashes with the port delimiter, the whole IP - address has to be put into brackets. On the other hand a <replaceable - class="parameter">target_pattern</replaceable> containing an IPv6 address - has to be put into angle brackets (normal brackets are reserved for - regular expressions already). - </para> - <para> If <replaceable class="parameter">http_parent</replaceable> is <quote>.</quote>, then requests are not forwarded to another HTTP proxy but are made (HTTP-wise) directly to the web servers, albeit through a SOCKS proxy. @@ -2138,14 +1992,14 @@ forward-socks4, forward-socks4a and forward-socks5</title> forward-socks4 / socks-gw.example.com:1080 . </screen> </para> - + <para> - To chain Privoxy and Tor, both running on the same system, you would use + To chain Privoxy and Tor, both running on the same system, you would use something like: </para> <para> <screen> - forward-socks5 / 127.0.0.1:9050 . + forward-socks4a / 127.0.0.1:9050 . </screen> </para>
@@ -2189,7 +2043,7 @@ forward-socks4, forward-socks4a and forward-socks5</title> <sect3 renderas="sect4" id="advanced-forwarding-examples"><title>Advanced Forwarding Examples</title>
<para> - If you have links to multiple ISPs that provide various special content + If you have links to multiple ISPs that provide various special content only to their subscribers, you can configure multiple <application>Privoxies</application> which have connections to the respective ISPs to act as forwarders to each other, so that <emphasis>your</emphasis> users can see the internal content of all ISPs. @@ -2230,9 +2084,9 @@ forward-socks4, forward-socks4a and forward-socks5</title> </para>
<para> - If you intend to chain <application>Privoxy</application> and - <application>squid</application> locally, then chaining as - <literal>browser -> squid -> privoxy</literal> is the recommended way. + If you intend to chain <application>Privoxy</application> and + <application>squid</application> locally, then chaining as + <literal>browser -> squid -> privoxy</literal> is the recommended way. </para>
<para> @@ -2242,14 +2096,14 @@ forward-socks4, forward-socks4a and forward-socks5</title>
<para> <screen> - # Define Privoxy as parent proxy (without ICP) - cache_peer 127.0.0.1 parent 8118 7 no-query + # Define Privoxy as parent proxy (without ICP) + cache_peer 127.0.0.1 parent 8118 7 no-query
- # Define ACL for protocol FTP - acl ftp proto FTP + # Define ACL for protocol FTP + acl ftp proto FTP
# Do not forward FTP requests to Privoxy - always_direct allow ftp + always_direct allow ftp
# Forward all the rest to Privoxy never_direct allow all</screen> @@ -2269,7 +2123,7 @@ forward-socks4, forward-socks4a and forward-socks5</title> <para> <screen> forward / . - forward /.*.(exe|com|dll|zip)$ antivir.example.com:8010</screen> + forward /.*.(exe|com|dll|zip)$ antivir.example.com:8010</screen> </para>
</sect3> @@ -2281,7 +2135,7 @@ forward-socks4, forward-socks4a and forward-socks5</title> <term>Specifies:</term> <listitem> <para> - How often Privoxy retries if a forwarded connection request fails. + How often Privoxy retries if a forwarded connection request fails. </para> </listitem> </varlistentry> @@ -2340,11 +2194,6 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%config-file;[<literallayout>@@forwarded-connect-retries 0</literallayout>]]> </sect3>
-</sect2> - -<sect2 id="misc"> -<title>Miscellaneous</title> - <sect3 renderas="sect4" id="accept-intercepted-requests"><title>accept-intercepted-requests</title> <variablelist> <varlistentry> @@ -2384,7 +2233,7 @@ forward-socks4, forward-socks4a and forward-socks5</title> If you don't trust your clients and want to force them to use <application>Privoxy</application>, enable this option and configure your packet filter to redirect outgoing - HTTP connections into <application>Privoxy</application>. + HTTP connections into <application>Privoxy</application>. </para> <para> Make sure that <application>Privoxy's</application> own requests @@ -2561,92 +2410,7 @@ forward-socks4, forward-socks4a and forward-socks5</title> <term>Effect if unset:</term> <listitem> <para> - Connections are not kept alive. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Notes:</term> - <listitem> - <para> - This option allows clients to keep the connection to &my-app; - alive. If the server supports it, &my-app; will keep - the connection to the server alive as well. Under certain - circumstances this may result in speed-ups. - </para> - <para> - By default, &my-app; will close the connection to the server if - the client connection gets closed, or if the specified timeout - has been reached without a new request coming in. This behaviour - can be changed with the <ulink - url="#CONNECTION-SHARING">connection-sharing</ulink> option. - </para> - <para> - This option has no effect if <application>Privoxy</application> - has been compiled without keep-alive support. - </para> - <para> - 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 <quote>grabbing</quote> all the - connections the browser allows, which means connections to - other websites can't be opened until the connections currently - in use time out. - </para> - <para> - 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. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Examples:</term> - <listitem> - <para> - keep-alive-timeout 300 - </para> - </listitem> - </varlistentry> -</variablelist> -<![%config-file;[<literallayout>@@keep-alive-timeout 5</literallayout>]]> -</sect3> - - -<sect3 renderas="sect4" id="default-server-timeout"><title>default-server-timeout</title> -<variablelist> - <varlistentry> - <term>Specifies:</term> - <listitem> - <para> - Assumed server-side keep-alive timeout if not specified by the server. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Type of value:</term> - <listitem> - <para> - <replaceable>Time in seconds.</replaceable> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Default value:</term> - <listitem> - <para>None</para> - </listitem> - </varlistentry> - <varlistentry> - <term>Effect if unset:</term> - <listitem> - <para> - Connections for which the server didn't specify the keep-alive - timeout are not reused. + Connections are not reused. </para> </listitem> </varlistentry> @@ -2654,93 +2418,12 @@ forward-socks4, forward-socks4a and forward-socks5</title> <term>Notes:</term> <listitem> <para> - Enabling this option significantly increases the number of connections - that are reused, provided the <ulink - url="#KEEP-ALIVE-TIMEOUT">keep-alive-timeout</ulink> option - is also enabled. - </para> - <para> - While it also increases the number of connections problems - when &my-app; tries to reuse a connection that already has - been closed on the server side, or is closed while &my-app; - is trying to reuse it, this should only be a problem if it - happens for the first request sent by the client. If it happens - for requests on reused client connections, &my-app; will simply - close the connection and the client is supposed to retry the - request without bothering the user. - </para> - <para> - Enabling this option is therefore only recommended if the - <ulink - url="#CONNECTION-SHARING">connection-sharing</ulink> option - is disabled. - </para> - <para> - It is an error to specify a value larger than the <ulink - url="#KEEP-ALIVE-TIMEOUT">keep-alive-timeout</ulink> value. - </para> - <para> This option has no effect if <application>Privoxy</application> has been compiled without keep-alive support. </para> </listitem> </varlistentry> <varlistentry> - <term>Examples:</term> - <listitem> - <para> - default-server-timeout 60 - </para> - </listitem> - </varlistentry> -</variablelist> -<![%config-file;[<literallayout>@@#default-server-timeout 60</literallayout>]]> -</sect3> - - -<sect3 renderas="sect4" id="connection-sharing"><title>connection-sharing</title> -<variablelist> - <varlistentry> - <term>Specifies:</term> - <listitem> - <para> - Whether or not outgoing connections that have been kept alive - should be shared between different incoming connections. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Type of value:</term> - <listitem> - <para> - <replaceable>0 or 1</replaceable> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Default value:</term> - <listitem> - <para>None</para> - </listitem> - </varlistentry> - <varlistentry> - <term>Effect if unset:</term> - <listitem> - <para> - Connections are not shared. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Notes:</term> - <listitem> - <para> - This option has no effect if <application>Privoxy</application> - has been compiled without keep-alive support, or if it's disabled. - </para> - </listitem> - </varlistentry> - <varlistentry> <term>Notes:</term> <listitem> <para> @@ -2748,39 +2431,13 @@ forward-socks4, forward-socks4a and forward-socks5</title> There are also a few privacy implications you should be aware of. </para> <para> - If this option is effective, outgoing connections are shared between - clients (if there are more than one) and closing the browser that initiated - the outgoing connection does no longer affect the connection between &my-app; - and the server unless the client's request hasn't been completed yet. - </para> - <para> - If the outgoing connection is idle, it will not be closed until either - <application>Privoxy's</application> or the server's timeout is reached. - While it's open, the server knows that the system running &my-app; is still - there. - </para> - <para> - If there are more than one client (maybe even belonging to multiple users), - they will be able to reuse each others connections. This is potentially - dangerous in case of authentication schemes like NTLM where only the - connection is authenticated, instead of requiring authentication for - each request. - </para> - <para> - If there is only a single client, and if said client can keep connections - alive on its own, enabling this option has next to no effect. If the client - doesn't support connection keep-alive, enabling this option may make sense - as it allows &my-app; to keep outgoing connections alive even if the client - itself doesn't support it. - </para> - <para> - You should also be aware that enabling this option increases the likelihood - of getting the "No server or forwarder data" error message, especially if you - are using a slow connection to the Internet. - </para> - <para> - This option should only be used by experienced users who - understand the risks and can weight them against the benefits. + Outgoing connections are shared between clients (if there are more + than one) and closing the client that initiated the outgoing connection + does not affect the connection between &my-app; and the server unless + the client's request hasn't been completed yet. If the outgoing connection + is idle, it will not be closed until either <application>Privoxy's</application> + or the server's timeout is reached. While it's open, the server knows + that the system running &my-app; is still there. </para> </listitem> </varlistentry> @@ -2788,12 +2445,12 @@ forward-socks4, forward-socks4a and forward-socks5</title> <term>Examples:</term> <listitem> <para> - connection-sharing 1 + keep-alive-timeout 300 </para> </listitem> </varlistentry> </variablelist> -<![%config-file;[<literallayout>@@#connection-sharing 1</literallayout>]]> +<![%config-file;[<literallayout>@@keep-alive-timeout 300</literallayout>]]> </sect3>
@@ -2834,9 +2491,9 @@ forward-socks4, forward-socks4a and forward-socks5</title> <term>Notes:</term> <listitem> <para> - 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. + For SOCKS requests the timeout currently doesn't start until + the SOCKS server accepted the request. This will be fixed in + the next release. </para> </listitem> </varlistentry> @@ -2853,279 +2510,6 @@ forward-socks4, forward-socks4a and forward-socks5</title> </sect3>
-<sect3 renderas="sect4" id="max-client-connections"><title>max-client-connections</title> -<variablelist> - <varlistentry> - <term>Specifies:</term> - <listitem> - <para> - Maximum number of client connections that will be served. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Type of value:</term> - <listitem> - <para> - <replaceable>Positive number.</replaceable> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Default value:</term> - <listitem> - <para>None</para> - </listitem> - </varlistentry> - <varlistentry> - <term>Effect if unset:</term> - <listitem> - <para> - Connections are served until a resource limit is reached. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Notes:</term> - <listitem> - <para> - &my-app; creates one thread (or process) for every incoming client - connection that isn't rejected based on the access control settings. - </para> - <para> - If the system is powerful enough, &my-app; can theoretically deal with - several hundred (or thousand) connections at the same time, but some - operating systems enforce resource limits by shutting down offending - processes and their default limits may be below the ones &my-app; would - require under heavy load. - </para> - <para> - Configuring &my-app; to enforce a connection limit below the thread - or process limit used by the operating system makes sure this doesn't - happen. Simply increasing the operating system's limit would work too, - but if &my-app; isn't the only application running on the system, - you may actually want to limit the resources used by &my-app;. - </para> - <para> - If &my-app; is only used by a single trusted user, limiting the - number of client connections is probably unnecessary. If there - are multiple possibly untrusted users you probably still want to - additionally use a packet filter to limit the maximal number of - incoming connections per client. Otherwise a malicious user could - intentionally create a high number of connections to prevent other - users from using &my-app;. - </para> - <para> - Obviously using this option only makes sense if you choose a limit - below the one enforced by the operating system. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Examples:</term> - <listitem> - <para> - max-client-connections 256 - </para> - </listitem> - </varlistentry> -</variablelist> -<![%config-file;[<literallayout>@@#max-client-connections 256</literallayout>]]> -</sect3> - - -<sect3 renderas="sect4" id="handle-as-empty-doc-returns-ok"><title>handle-as-empty-doc-returns-ok</title> -<variablelist> - <varlistentry> - <term>Specifies:</term> - <listitem> - <para> - The status code Privoxy returns for pages blocked with - <!-- URL will only end up in the user manual so the relative link should work. --> - <literal><ulink url="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">+handle-as-empty-document</ulink></literal>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Type of value:</term> - <listitem> - <para> - <replaceable>0 or 1</replaceable> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Default value:</term> - <listitem> - <para>0</para> - </listitem> - </varlistentry> - <varlistentry> - <term>Effect if unset:</term> - <listitem> - <para> - Privoxy returns a status 403(forbidden) for all blocked pages. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Effect if set:</term> - <listitem> - <para> - Privoxy returns a status 200(OK) for pages blocked with +handle-as-empty-document - and a status 403(Forbidden) for all other blocked pages. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Notes:</term> - <listitem> - <para> - This is a work-around for Firefox bug 492459: - <quote> - Websites are no longer rendered if SSL requests for JavaScripts are blocked by a proxy. - </quote> - (<ulink url="https://bugzilla.mozilla.org/show_bug.cgi?id=492459" - >https://bugzilla.mozilla.org/show_bug.cgi?id=492459</ulink>) - 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. - </para> - </listitem> - </varlistentry> -</variablelist> -<![%config-file;[<literallayout>@@#handle-as-empty-doc-returns-ok 1</literallayout>]]> -</sect3> - - -<sect3 renderas="sect4" id="enable-compression"><title>enable-compression</title> -<variablelist> - <varlistentry> - <term>Specifies:</term> - <listitem> - <para> - Whether or not buffered content is compressed before delivery. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Type of value:</term> - <listitem> - <para> - <replaceable>0 or 1</replaceable> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Default value:</term> - <listitem> - <para>0</para> - </listitem> - </varlistentry> - <varlistentry> - <term>Effect if unset:</term> - <listitem> - <para> - Privoxy does not compress buffered content. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Effect if set:</term> - <listitem> - <para> - Privoxy compresses buffered content before delivering it to the client, - provided the client supports it. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Notes:</term> - <listitem> - <para> - This directive is only supported if Privoxy has been compiled with - FEATURE_COMPRESSION, which should not to be confused with FEATURE_ZLIB. - </para> - <para> - Compressing buffered content is mainly useful if Privoxy and the - client are running on different systems. If they are running on the - same system, enabling compression is likely to slow things down. - If you didn't measure otherwise, you should assume that it does - and keep this option disabled. - </para> - <para> - Privoxy will not compress buffered content below a certain length. - </para> - </listitem> - </varlistentry> -</variablelist> -<![%config-file;[<literallayout>@@#enable-compression 1</literallayout>]]> -</sect3> - - -<sect3 renderas="sect4" id="compression-level"><title>compression-level</title> -<variablelist> - <varlistentry> - <term>Specifies:</term> - <listitem> - <para> - The compression level that is passed to the zlib library when compressing buffered content. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Type of value:</term> - <listitem> - <para> - <replaceable>Positive number ranging from 0 to 9.</replaceable> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Default value:</term> - <listitem> - <para>1</para> - </listitem> - </varlistentry> - <varlistentry> - <term>Notes:</term> - <listitem> - <para> - Compressing the data more takes usually longer than compressing - it less or not compressing it at all. Which level is best depends - on the connection between Privoxy and the client. If you can't - be bothered to benchmark it for yourself, you should stick with - the default and keep compression disabled. - </para> - <para> - If compression is disabled, the compression level is irrelevant. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Examples:</term> - <listitem> - <para> - <screen> - # Best speed (compared to the other levels) - compression-level 1 - # Best compression - compression-level 9 - # No compression. Only useful for testing as the added header - # slightly increases the amount of data that has to be sent. - # If your benchmark shows that using this compression level - # is superior to using no compression at all, the benchmark - # is likely to be flawed. - compression-level 0 - </screen> - </para> - </listitem> - </varlistentry> -</variablelist> -<![%config-file;[<literallayout>@@#compression-level 1</literallayout>]]> -</sect3> - - </sect2>
<!-- ~ End section ~ --> @@ -3152,11 +2536,11 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%user-man;[ <para> <literal> - <msgtext> + <msgtext> <literallayout> <emphasis>activity-animation 1</emphasis> </literallayout> - </msgtext> + </msgtext> </literal> </para> ]]> @@ -3173,18 +2557,18 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%user-man;[ <para> <literal> - <msgtext> + <msgtext> <literallayout> <emphasis>log-messages 1</emphasis> </literallayout> - </msgtext> + </msgtext> </literal> </para> ]]>
<anchor id="log-buffer-size"> <![%config-file;[<para>@@</para>]]> <!-- for spacing --> -<para> +<para> If <quote>log-buffer-size</quote> is set to 1, the size of the log buffer, i.e. the amount of memory used for the log messages displayed in the console window, will be limited to <quote>log-max-lines</quote> (see below). @@ -3199,11 +2583,11 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%user-man;[ <para> <literal> - <msgtext> + <msgtext> <literallayout> <emphasis>log-buffer-size 1</emphasis> </literallayout> - </msgtext> + </msgtext> </literal> </para> ]]> @@ -3219,11 +2603,11 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%user-man;[ <para> <literal> - <msgtext> + <msgtext> <literallayout> <emphasis>log-max-lines 200</emphasis> </literallayout> - </msgtext> + </msgtext> </literal> </para> ]]> @@ -3240,11 +2624,11 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%user-man;[ <para> <literal> - <msgtext> + <msgtext> <literallayout> <emphasis>log-highlight-messages 1</emphasis> </literallayout> - </msgtext> + </msgtext> </literal> </para> ]]> @@ -3259,11 +2643,11 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%user-man;[ <para> <literal> - <msgtext> + <msgtext> <literallayout> <emphasis>log-font-name Comic Sans MS</emphasis> </literallayout> - </msgtext> + </msgtext> </literal> </para> ]]> @@ -3278,18 +2662,18 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%user-man;[ <para> <literal> - <msgtext> + <msgtext> <literallayout> <emphasis>log-font-size 8</emphasis> </literallayout> - </msgtext> + </msgtext> </literal> </para> ]]>
<anchor id="show-on-task-bar"> <![%config-file;[<para>@@</para>]]> <!-- for spacing --> -<para> +<para> <quote>show-on-task-bar</quote> controls whether or not <application>Privoxy</application> will appear as a button on the Task bar when minimized: @@ -3299,11 +2683,11 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%user-man;[ <para> <literal> - <msgtext> + <msgtext> <literallayout> <emphasis>show-on-task-bar 0</emphasis> </literallayout> - </msgtext> + </msgtext> </literal> </para> ]]> @@ -3320,11 +2704,11 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%user-man;[ <para> <literal> - <msgtext> + <msgtext> <literallayout> <emphasis>close-button-minimizes 1</emphasis> </literallayout> - </msgtext> + </msgtext> </literal> </para> ]]> @@ -3342,11 +2726,11 @@ forward-socks4, forward-socks4a and forward-socks5</title> <![%user-man;[ <para> <literal> - <msgtext> + <msgtext> <literallayout> #<emphasis>hide-console</emphasis> </literallayout> - </msgtext> + </msgtext> </literal> </para> ]]> diff --git a/external/privoxy/doc/source/privoxy-man-page.sgml b/external/privoxy/doc/source/privoxy-man-page.sgml index 035ee53..ea336e3 100644 --- a/external/privoxy/doc/source/privoxy-man-page.sgml +++ b/external/privoxy/doc/source/privoxy-man-page.sgml @@ -4,22 +4,22 @@ Purpose : Manual Page This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - - $Id: privoxy-man-page.sgml,v 2.40 2011/12/26 17:05:40 fabiankeil Exp $ + + $Id: privoxy-man-page.sgml,v 2.29 2009/02/19 02:20:22 hal9 Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE.
======================================================================== - NOTE: Please read developer-manual/documentation.html before touching - anything in this, or other Privoxy documentation. + NOTE: Please read developer-manual/documentation.html before touching + anything in this, or other Privoxy documentation. ========================================================================
Doc NOTES: This is some tricky markup! There are some quirks to how this markup is handled. It is not always so co-operative. - Please don't change the markup unless you can verify the changes - will improve finished output! - + Please don't change the markup unless you can verify the changes + will improve finished output! + literallayout tags are particularly sensitive to where they are placed. The 'replaceable' and 'command' tags are used here somewhat unconventionally, since it seems to generate the proper formatting (at least for me :). @@ -28,21 +28,21 @@
Requires docbook2man (short perl script), see CVS http://sources.redhat.com/docbook-tools/. Also requires openjade and SGMLSpm - perl module. - + perl module. + For man page references, see: http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/using.html http://docbook.org/tdg/en/html/ch02.html#making-refentry
--> <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"[ -<!entity % dummy "IGNORE"> +<!entity % dummy "IGNORE"> <!entity p-intro SYSTEM "privoxy.sgml"> <!entity seealso SYSTEM "seealso.sgml"> <!entity copyright SYSTEM "copyright.sgml"> <!entity license SYSTEM "license.sgml"> <!entity authors SYSTEM "p-authors.sgml"> -<!entity p-version "3.0.19"> +<!entity p-version "3.0.11"> <!entity p-status "stable"> <!entity % p-not-stable "IGNORE"> <!entity % p-stable "INCLUDE"> @@ -57,7 +57,7 @@ <date>2009-02-15</date> </refentryinfo> <refmeta> - <refentrytitle>privoxy</refentrytitle> + <refentrytitle>privoxy</refentrytitle> <manvolnum>1</manvolnum> <refmiscinfo> Privoxy &p-version;<![%p-not-stable;[ &p-status;]]> @@ -70,16 +70,16 @@ </refnamediv>
<refsynopsisdiv> - <cmdsynopsis> + <cmdsynopsis> <command>privoxy</command> <arg><option>--help</option></arg> <arg><option>--version</option></arg> <arg><option>--no-daemon</option></arg> - <arg><option>--pidfile </option><replaceable class="parameter">pidfile</replaceable></arg> - <arg><option>--user </option><replaceable class="parameter">user[.group]</replaceable></arg> + <arg><option>--pidfile </option><replaceable class="parameter">pidfile</replaceable></arg> + <arg><option>--user </option><replaceable class="parameter">user[.group]</replaceable></arg> <arg><option>--chroot</option></arg> - <arg><option>--pre-chroot-nslookup </option><replaceable class="parameter">hostname</replaceable></arg> - <arg><replaceable class="parameter">configfile</replaceable></arg> + <arg><option>--pre-chroot-nslookup </option><replaceable class="parameter">hostname</replaceable></arg> + <arg><replaceable class="parameter">configfile</replaceable></arg> </cmdsynopsis>
</refsynopsisdiv> @@ -92,7 +92,7 @@ options: </para>
- <variablelist> + <variablelist> <varlistentry> <term>--help</term> <listitem> @@ -157,7 +157,7 @@ <command>Privoxy</command> process that the directory tree starts there. If set up carefully, this can limit the impact of possible vulnerabilities in <command>Privoxy</command> to the files contained in - that hierarchy. + that hierarchy. </para> </listitem> </varlistentry> @@ -177,7 +177,7 @@ If the <filename>configfile</filename> is not specified on the command line, <command>Privoxy</command> will look for a file named <filename>config</filename> in the current directory. If no - <filename>configfile</filename> is found, <command>Privoxy</command> will + <filename>configfile</filename> is found, <command>Privoxy</command> will fail to start. </para>
@@ -201,21 +201,21 @@ filter to build an intercepting proxy (see <filename>config</filename>). The default setting is for localhost, on port 8118 (configurable in the main config file). To set the - HTTP proxy in Firefox, go through: <command>Tools</command>; + HTTP proxy in Firefox, go through: <command>Tools</command>; <command>Options</command>; <command>General</command>; <command>Connection Settings</command>; - <command>Manual Proxy Configuration</command>. + <command>Manual Proxy Configuration</command>. </para> <para> - For Internet Explorer, go through: <command>Tools</command>; + For Internet Explorer, go through: <command>Tools</command>; <command>Internet Properties</command>; <command>Connections</command>; - <command>LAN Settings</command>. + <command>LAN Settings</command>. </para> <para> The Secure (SSL) Proxy should also be set to the same values, otherwise https: URLs will not be proxied. Note: <command>Privoxy</command> can only proxy HTTP and HTTPS traffic. Do not try it with FTP or other protocols. - HTTPS presents some limitations, and not all features will work with HTTPS + HTTPS presents some limitations, and not all features will work with HTTPS connections. </para>
@@ -231,25 +231,25 @@ <command>Privoxy</command> can be configured with the various configuration files. The default configuration files are: <filename>config</filename>, <filename>default.filter</filename>, <filename>default.action</filename> and - <filename>default.action</filename>. <filename>user.action</filename> should + <filename>default.action</filename>. <filename>user.action</filename> should be used for locally defined exceptions to the default rules in <filename>match-all.action</filename> and <filename>default.action</filename>, and <filename>user.filter</filename> for locally defined filters. These are well commented. On Unix and Unix-like systems, these are located in - <filename>/etc/privoxy/</filename> by default. + <filename>/etc/privoxy/</filename> by default. </para> -<para> - <command>Privoxy</command> uses the concept of <command>actions</command> +<para> + <command>Privoxy</command> uses the concept of <command>actions</command> in order to manipulate the data stream between the browser and remote sites. - There are various actions available with specific functions for such things + There are various actions available with specific functions for such things as blocking web sites, managing cookies, etc. These actions can be invoked - individually or combined, and used against individual URLs, or groups of URLs + individually or combined, and used against individual URLs, or groups of URLs that can be defined using wildcards and regular expressions. The result is that the user has greatly enhanced control and freedom. </para> <para> The actions list (ad blocks, etc) can also be configured with your - web browser at <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> + web browser at <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> (assuming the configuration allows it). <command>Privoxy's</command> configuration parameters can also be viewed at the same page. In addition, <command>Privoxy</command> can be toggled on/off. @@ -268,7 +268,7 @@ <!-- ~~~~~ New section ~~~~~ --> <refsect1><title>Files</title> <!-- this is a cheesy way to do this, but WTF. --> -<literallayout> +<literallayout> <filename>/usr/sbin/privoxy</filename> <filename>/etc/privoxy/config</filename> <filename>/etc/privoxy/match-all.action</filename> @@ -296,11 +296,11 @@ <!-- command tag is used here to get proper looking format --> <command>Privoxy</command> terminates on the <command>SIGINT</command>, <command>SIGTERM</command> and <command>SIGABRT</command> signals. Log - rotation scripts may cause a re-opening of the logfile by sending a + rotation scripts may cause a re-opening of the logfile by sending a <command>SIGHUP</command> to <command>Privoxy</command>. Note that unlike other daemons, <command>Privoxy</command> does not need to be made aware of config file changes by <command>SIGHUP</command> -- it will detect them - automatically. + automatically. </para>
</refsect1> @@ -309,7 +309,7 @@ <refsect1><title>Notes</title> <![%p-not-stable;[ <para> - This is a &p-status; version of <command>Privoxy</command>. Not + This is a &p-status; version of <command>Privoxy</command>. Not all features are well tested. </para>]]> <para> diff --git a/external/privoxy/doc/source/privoxy.sgml b/external/privoxy/doc/source/privoxy.sgml index fa70054..1e4791f 100644 --- a/external/privoxy/doc/source/privoxy.sgml +++ b/external/privoxy/doc/source/privoxy.sgml @@ -2,17 +2,17 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/privoxy.sgml,v $
Purpose : Entity included in other project documents. + + $Id: privoxy.sgml,v 2.9 2009/03/21 12:42:49 fabiankeil Exp $
- $Id: privoxy.sgml,v 2.12 2011/09/04 11:10:12 fabiankeil Exp $ - - Copyright (C) 2001-2011 Privoxy Developers http://www.privoxy.org/ + Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE.
====================================================================== This file used for inclusion with other documents only. ======================================================================
- If you make changes to this file, please verify the finished + If you make changes to this file, please verify the finished docs all display as intended.
This file is included into: @@ -35,27 +35,10 @@ </para>
<para> - Privoxy is Free Software and licensed under the GNU GPLv2. + Privoxy is Free Software and licensed under the GPL2. </para>
<para> Privoxy is an associated project of Software in the Public Interest (SPI). -</para> - -<para> - Helping hands and donations are welcome: - <itemizedlist> - <listitem> - <para> - <ulink url="http://www.privoxy.org/faq/general.html#PARTICIPATE" - >http://www.privoxy.org/faq/general.html#PARTICIPATE</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://www.privoxy.org/faq/general.html#DONATE" - >http://www.privoxy.org/faq/general.html#DONATE</ulink> - </para> - </listitem> - </itemizedlist> + <ulink url="http://www.privoxy.org/faq/general.html#DONATE">Donations are welcome</ulink>. </para> diff --git a/external/privoxy/doc/source/readme.sgml b/external/privoxy/doc/source/readme.sgml index 02002e2..3bbacf7 100644 --- a/external/privoxy/doc/source/readme.sgml +++ b/external/privoxy/doc/source/readme.sgml @@ -1,10 +1,10 @@ <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ -<!entity % dummy "IGNORE"> +<!entity % dummy "IGNORE"> <!entity supported SYSTEM "supported.sgml"> <!entity p-intro SYSTEM "privoxy.sgml"> <!entity contacting SYSTEM "contacting.sgml"> <!entity buildsource SYSTEM "buildsource.sgml"> -<!entity p-version "3.0.19"> +<!entity p-version "3.0.12"> <!entity p-status "stable"> <!entity % p-not-stable "IGNORE"> <!entity % p-stable "INCLUDE"> @@ -16,23 +16,23 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/readme.sgml,v $
Purpose : README for Privoxy + + $Id: readme.sgml,v 2.26 2009/03/21 11:32:38 hal9 Exp $
- $Id: readme.sgml,v 2.49 2011/12/26 17:05:40 fabiankeil Exp $ - - Copyright (C) 2001-2011 Privoxy Developers http://www.privoxy.org/ + Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE.
======================================================================== - NOTE: Please read developer-manual/documentation.html before touching + NOTE: Please read developer-manual/documentation.html before touching anything in this, or other Privoxy documentation. You have been warned! - Failure to abide by this rule will result in the revocation of your license + Failure to abide by this rule will result in the revocation of your license to live a peaceful existence! ========================================================================
=================================================================== - READ: Document Note: This file generates the README in the top level - source directory. It is generated as only a plain text file. The - current markup is not suitable for other formats. Build from + READ: Document Note: This file generates the README in the top level + source directory. It is generated as only a plain text file. The + current markup is not suitable for other formats. Build from Makefile with 'make dok-readme'. ===================================================================
@@ -40,21 +40,21 @@
====================================================================== NOTE: The left margin spacing is *important* when using 'literallayout' - WYSISWYG!!! Don't mess this up!!! Careful with linebreaks too, ie + WYSISWYG!!! Don't mess this up!!! Careful with linebreaks too, ie the para tag forces a linebreak. Tags need to be carefully placed as a result - to avoid extra blank lines, etc. + to avoid extra blank lines, etc. ======================================================================
- For stable releases, change - - entity % p-not-stable "INCLUDE" - - to - - entity % p-not-stable "IGNORE" - + For stable releases, change + + entity % p-not-stable "INCLUDE" + + to + + entity % p-not-stable "IGNORE" + in the DTD at the top. This will toggle various text 'off'. BOTH - MUST be toggled in this case or you will get both text referencing + MUST be toggled in this case or you will get both text referencing stable and unstable versions. You only want one or the other!
--> @@ -80,14 +80,14 @@ * * Purpose : README file to give a short intro. * - * Copyright : Written by and Copyright (C) 2001-2011 the + * Copyright : Written by and Copyright (C) 2001-2009 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -102,8 +102,8 @@ * The GNU General Public License should be included with * this file. If not, you can view it at * http://www.gnu.org/copyleft/gpl.html - * or write to the Free Software Foundation, Inc., - * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, + * or write to the Free Software Foundation, Inc., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, * USA * *********************************************************************/ @@ -126,21 +126,45 @@ <!-- end boilerplate -->
<!-- ~~~~~ New section ~~~~~ --> -<sect1 id="changes" ><title>CHANGES</title> +<sect1 id="importantchanges" ><title>IMPORTANT CHANGES</title> <para> - For a list of changes in this release, please have a - look at the "ChangeLog", the "What's New" section or - the "Upgrader's Notes" in <citetitle>the User Manual</citetitle>. + March 2009, Privoxy 3.0.12 is released. +</para> +<para> + This is primarily a bug fix release. See the "ChangeLog", and the "What's + New" section and the "Upgrader's Notes" in <citetitle>the User + Manual</citetitle> for details. </para>
+<para> + February 2009, Privoxy 3.0.11 is released. +</para> +<para> + As usual there are changes that effect the configuration. See the "ChangeLog", + and the "What's New" section and the "Upgrader's Notes" in + <citetitle>the User Manual</citetitle> for details and specifics. +</para> +<para> + This is a stable release, and marks a departure for Privoxy development. +</para> +<para> + Previously, odd numbered releases were considered beta versions and + were only released at the end of the development cycle when the code + was already believed to be stable. Usually it was, so the stable release + contained pretty much the same code, but got a higher version number. + In the future we intend to release several snapshots between stable releases. + There will probably still be about two stable releases per year, + but hopefully about six snapshots instead of the two betas we have now. + The intentions is to make testing without CVS access easier. +</para> </sect1>
<!-- ~~~~~ New section ~~~~~ --> <sect1 id="install" ><title>INSTALL</title> -<para> +<para> See the <filename>INSTALL</filename> file in this directory, for installing from raw source, and the <citetitle>User Manual</citetitle>, for all other - installation types. + installation types. </para> </sect1>
@@ -152,7 +176,7 @@ HOSTNAME ][config_file] </para> <para> - See the man page or <citetitle>User Manual</citetitle> for an explanation of each option, and + See the man page or <citetitle>User Manual</citetitle> for an explanation of each option, and other configuration and usage issues. </para> <para> @@ -160,6 +184,12 @@ file named 'config' in the current directory (except Win32 which will look for 'config.txt'). If no config_file is found, Privoxy will fail to start. </para> +<para> + Or for Red Hat and Fedora based distributions: /etc/rc.d/init.d/privoxy start +</para> +<para> + Or Debian and Ubuntu: /etc/init.d/privoxy start +</para> </sect1>
<!-- ~~~~~ New section ~~~~~ --> @@ -178,7 +208,7 @@ <para> Be sure to set your browser(s) for HTTP/HTTPS Proxy at <IP>:<Port>, or whatever you specify in the config file under 'listen-address'. DEFAULT is - 127.0.0.1:8118. Note that Privoxy ONLY proxies HTTP (and HTTPS) traffic. Do not try it + localhost:8118. Note that Privoxy ONLY proxies HTTP (and HTTPS) traffic. Do not try it with FTP or other protocols for the simple reason it does not work. </para> <para> @@ -197,10 +227,10 @@ <sect1 id="documentation"><title>DOCUMENTATION</title> <para> There should be documentation in the 'doc' subdirectory<![%p-not-stable;[, but it - may not be completed at this point]]>. In particular, see the + may not be completed at this point]]>. In particular, see the <citetitle>User Manual</citetitle> there, the <citetitle>FAQ</citetitle>, and those interested in Privoxy development, should look at - <citetitle>developer-manual</citetitle>. + <citetitle>developer-manual</citetitle>. </para> <para> <![%p-not-stable;[ @@ -208,12 +238,12 @@ may still be either comments in the source code, or the included configuration files. ]]>The source and configuration files are all well commented. The main configuration files are: 'config', 'default.action', and - 'default.filter'<![%p-not-stable;[ in the top-level source directory]]>. + 'default.filter'<![%p-not-stable;[ in the top-level source directory]]>. </para>
<para> - Included documentation may vary according to platform and packager. All - documentation is posted on http://www.privoxy.org, in case you don't have it, + Included documentation may vary according to platform and packager. All + documentation is posted on http://www.privoxy.org, in case you don't have it, or can't find it. </para> </sect1> @@ -232,7 +262,7 @@ <!-- </LiteralLayout> --> <!-- </para> --> <!-- <para> --> -<!-- $Id: readme.sgml,v 2.49 2011/12/26 17:05:40 fabiankeil Exp $ --> +<!-- $Id: readme.sgml,v 2.26 2009/03/21 11:32:38 hal9 Exp $ --> <!-- </para> -->
</article> diff --git a/external/privoxy/doc/source/seealso.sgml b/external/privoxy/doc/source/seealso.sgml index fb10686..087ebc5 100644 --- a/external/privoxy/doc/source/seealso.sgml +++ b/external/privoxy/doc/source/seealso.sgml @@ -2,8 +2,8 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/seealso.sgml,v $
Purpose : Entity included in other project documents. - - $Id: seealso.sgml,v 2.13 2011/09/04 11:10:12 fabiankeil Exp $ + + $Id: seealso.sgml,v 2.12 2009/02/23 10:42:58 fabiankeil Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE. @@ -12,7 +12,7 @@ This file used for inclusion with other documents only. ======================================================================
- If you make changes to this file, please verify the finished + If you make changes to this file, please verify the finished docs all display as intended.
This file is included into: @@ -22,7 +22,7 @@ faq developer-manual
- NOTE: 04/05/02, HB Removed tags. They were causing docbook2man + NOTE: 04/05/02, HB Removed tags. They were causing docbook2man to barf.
--> @@ -36,28 +36,28 @@ <simplelist> <member> <ulink - url="http://www.privoxy.org/">http://www.privoxy.org/</ulink>, - the <application>Privoxy</application> Home page. + url="http://www.privoxy.org/">http://www.privoxy.org/</ulink>, + the <application>Privoxy</application> Home page. </member> </simplelist> <simplelist> <member> <ulink - url="http://www.privoxy.org/faq/">http://www.privoxy.org/faq/</ulink>, - the <application>Privoxy</application> FAQ. + url="http://www.privoxy.org/faq/">http://www.privoxy.org/faq/</ulink>, + the <application>Privoxy</application> FAQ. </member> </simplelist> <simplelist> <member> <ulink - url="http://www.privoxy.org/developer-manual/">http://www.privoxy.org/developer-manual/</ulink>, - the <application>Privoxy</application> developer manual. + url="http://www.privoxy.org/developer-manual/">http://www.privoxy.org/developer-manual/</ulink>, + the <application>Privoxy</application> developer manual. </member> </simplelist> <simplelist> <member> - <ulink url="https://sourceforge.net/projects/ijbswa/">https://sourceforge.net/projects/ijbswa/</ulink>, - the Project Page for <application>Privoxy</application> on + <ulink url="https://sourceforge.net/projects/ijbswa/">https://sourceforge.net/projects/ijbswa/</ulink>, + the Project Page for <application>Privoxy</application> on <ulink url="http://sourceforge.net">SourceForge</ulink>. </member> </simplelist> @@ -71,7 +71,7 @@ <simplelist> <member> <ulink url="https://sourceforge.net/tracker/?group_id=11118&atid=460288">https://sourceforge.net/tracker/?group_id=11118&atid=460288</ulink>, to submit <quote>misses</quote> and other - configuration related suggestions to the developers. + configuration related suggestions to the developers. </member> </simplelist> <![%seealso-extra;[ @@ -104,8 +104,8 @@ </simplelist> <simplelist> <member> - <ulink url="https://www.torproject.org/">https://www.torproject.org/</ulink>, - <application>Tor</application> can help anonymize web browsing, + <ulink url="https://www.torproject.org/">https://www.torproject.org/</ulink>, + <application>Tor</application> can help anonymize web browsing, web publishing, instant messaging, IRC, SSH, and other applications. </member> </simplelist> diff --git a/external/privoxy/doc/source/supported.sgml b/external/privoxy/doc/source/supported.sgml index d1b5b32..62bfde1 100644 --- a/external/privoxy/doc/source/supported.sgml +++ b/external/privoxy/doc/source/supported.sgml @@ -2,8 +2,8 @@ File : $Source: /cvsroot/ijbswa/current/doc/source/supported.sgml,v $
Purpose : Entity included in other project documents. - - $Id: supported.sgml,v 2.10 2011/09/04 11:10:12 fabiankeil Exp $ + + $Id: supported.sgml,v 2.9 2008/01/17 01:49:51 hal9 Exp $
Copyright (C) 2001-2008 Privoxy Developers http://www.privoxy.org/ See LICENSE. @@ -12,7 +12,7 @@ This file used for inclusion with other documents only. ======================================================================
- If you make changes to this file, please verify the finished + If you make changes to this file, please verify the finished docs all display as intended.
This file is included into: @@ -34,13 +34,13 @@ <para> But any operating system that runs TCP/IP, can conceivably take advantage of <application>Privoxy</application> in a networked situation where - <application>Privoxy</application> would run as a server on a LAN gateway. + <application>Privoxy</application> would run as a server on a LAN gateway. Then only the <quote>gateway</quote> needs to be running one of the above operating systems. </para>
<para> - Source code is freely available, so porting to other operating systems + Source code is freely available, so porting to other operating systems is always a possibility. </para> ]]> diff --git a/external/privoxy/doc/source/user-manual.sgml b/external/privoxy/doc/source/user-manual.sgml index ddbc2d5..2999e3e 100644 --- a/external/privoxy/doc/source/user-manual.sgml +++ b/external/privoxy/doc/source/user-manual.sgml @@ -1,5 +1,5 @@ <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ -<!entity % dummy "IGNORE"> +<!entity % dummy "IGNORE"> <!entity supported SYSTEM "supported.sgml"> <!entity newfeatures SYSTEM "newfeatures.sgml"> <!entity p-intro SYSTEM "privoxy.sgml"> @@ -11,7 +11,7 @@ <!entity license SYSTEM "license.sgml"> <!entity p-authors SYSTEM "p-authors.sgml"> <!entity config SYSTEM "p-config.sgml"> -<!entity p-version "3.0.19"> +<!entity p-version "3.0.11"> <!entity p-status "stable"> <!entity % p-authors-formal "INCLUDE"> <!-- include additional text, etc --> <!entity % p-not-stable "IGNORE"> @@ -34,13 +34,13 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
- $Id: user-manual.sgml,v 2.146 2011/12/26 17:05:40 fabiankeil Exp $ + $Id: user-manual.sgml,v 2.103 2009/03/21 10:49:05 fabiankeil Exp $
- Copyright (C) 2001-2011 Privoxy Developers http://www.privoxy.org/ + Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE.
======================================================================== - NOTE: Please read developer-manual/documentation.html before touching + NOTE: Please read developer-manual/documentation.html before touching anything in this, or other Privoxy documentation. ========================================================================
@@ -55,12 +55,12 @@ <subscript> <!-- Completely the wrong markup, but very little is allowed --> <!-- in this part of an article. FIXME --> - <link linkend="copyright">Copyright</link> &my-copy; 2001-2011 by + <link linkend="copyright">Copyright</link> &my-copy; 2001-2009 by <ulink url="http://www.privoxy.org/">Privoxy Developers</ulink> </subscript> </pubdate>
-<pubdate>$Id: user-manual.sgml,v 2.146 2011/12/26 17:05:40 fabiankeil Exp $</pubdate> +<pubdate>$Id: user-manual.sgml,v 2.103 2009/03/21 10:49:05 fabiankeil Exp $</pubdate>
<!--
@@ -115,32 +115,32 @@ Hal. <sect1 label="1" id="introduction"><title>Introduction</title> <para> This documentation is included with the current &p-status; version of - <application>Privoxy</application>, v.&p-version;<![%p-not-stable;[, + <application>Privoxy</application>, v.&p-version;<![%p-not-stable;[, and is mostly complete at this point. The most up to date reference for the time being is still the comments in the source files and in the individual configuration files. Development of a new version is currently nearing completion, and includes significant changes and enhancements over - earlier versions]]>. + earlier versions. ]]>. </para>
<!-- include only in non-stable versions --> <![%p-not-stable;[ <para> Since this is a &p-status; version, not all new features are well tested. This - documentation may be slightly out of sync as a result (especially with + documentation may be slightly out of sync as a result (especially with CVS sources). And there <emphasis>may be</emphasis> bugs, though hopefully - not many! + not many! </para> ]]>
<!-- ~~~~~ New section ~~~~~ --> <sect2 id="features"><title>Features</title> <para> - In addition to the core - features of ad blocking and + In addition to the core + features of ad blocking and <ulink url="http://en.wikipedia.org/wiki/Browser_cookie">cookie</ulink> management, <application>Privoxy</application> provides many supplemental - features<![%p-not-stable;[, some of them currently under development]]>, + features<![%p-not-stable;[, some of them currently under development]]>, that give the end-user more control, more privacy and more freedom: </para> <!-- Include newfeatures.sgml boilerplate here: --> @@ -165,14 +165,14 @@ Hal. </para>
<para> - Note: - On some platforms, the installer may remove previously installed versions, if + Note: + On some platforms, the installer may remove previously installed versions, if found. (See below for your platform). In any case <emphasis>be sure to backup your old configuration if it is valuable to you.</emphasis> See the <link linkend="upgradersnote">note to upgraders</link> section below. </para>
-<!-- ~~~~~ New section ~~~~~ --> +<!-- ~~~~~ New section ~~~~~ --> <sect2 id="installation-packages"><title>Binary Packages</title> <para> How to install the binary packages depends on your operating system: @@ -185,7 +185,7 @@ How to install the binary packages depends on your operating system:
<para> RPMs can be installed with <literal>rpm -Uvh privoxy-&p-version;-1.rpm</literal>, - and will use <filename>/etc/privoxy</filename> for the location + and will use <filename>/etc/privoxy</filename> for the location of configuration files. </para>
@@ -193,13 +193,13 @@ How to install the binary packages depends on your operating system: Note that on Red Hat, <application>Privoxy</application> will <emphasis>not</emphasis> be automatically started on system boot. You will need to enable that using <command>chkconfig</command>, - <command>ntsysv</command>, or similar methods. + <command>ntsysv</command>, or similar methods. </para>
<para> - If you have problems with failed dependencies, try rebuilding the SRC RPM: - <literal>rpm --rebuild privoxy-&p-version;-1.src.rpm</literal>. This - will use your locally installed libraries and RPM version. + If you have problems with failed dependencies, try rebuilding the SRC RPM: + <literal>rpm --rebuild privoxy-&p-version;-1.src.rpm</literal>. This + will use your locally installed libraries and RPM version. </para>
<para> @@ -214,7 +214,7 @@ How to install the binary packages depends on your operating system: <sect3 id="installation-deb"><title>Debian and Ubuntu</title> <para> DEBs can be installed with <literal>apt-get install privoxy</literal>, - and will use <filename>/etc/privoxy</filename> for the location of + and will use <filename>/etc/privoxy</filename> for the location of configuration files. </para> </sect3> @@ -225,7 +225,7 @@ How to install the binary packages depends on your operating system: <para> Just double-click the installer, which will guide you through the installation process. You will find the configuration files - in the same directory as you installed <application>Privoxy</application> in. + in the same directory as you installed <application>Privoxy</application> in. </para> <para> Version 3.0.5 beta introduced full <application>Windows</application> service @@ -256,7 +256,7 @@ How to install the binary packages depends on your operating system: command: <command>services.msc</command>. If you do not take the manual step of modifying <application>Privoxy's</application> service settings, it will not start. Note too that you will need to give Privoxy a user account that - actually exists, or it will not be permitted to + actually exists, or it will not be permitted to write to its log and configuration files. </para>
@@ -277,7 +277,7 @@ How to install the binary packages depends on your operating system:
<para> First, make sure that no previous installations of - <application>Junkbuster</application> and / or + <application>Junkbuster</application> and / or <application>Privoxy</application> are left on your system. Check that no <application>Junkbuster</application> or <application>Privoxy</application> objects are in @@ -311,7 +311,7 @@ How to install the binary packages depends on your operating system: installation (in addition to every time your computer starts up). To prevent the privoxy service from automatically starting when your computer starts up, remove or rename the folder named - <literal>/Library/StartupItems/Privoxy</literal>. + <literal>/Library/StartupItems/Privoxy</literal>. </para> <para> To manually start or stop the privoxy service, use the Privoxy Utility @@ -323,9 +323,9 @@ How to install the binary packages depends on your operating system: <!-- ~~~~~ New section ~~~~~ --> <sect3 id="installation-amiga"><title>AmigaOS</title> <para> - Copy and then unpack the <filename>lha</filename> archive to a suitable location. + Copy and then unpack the <filename>lha</filename> archive to a suitable location. All necessary files will be installed into <application>Privoxy</application> - directory, including all configuration and log files. To uninstall, just + directory, including all configuration and log files. To uninstall, just remove this directory. </para> </sect3> @@ -352,19 +352,19 @@ How to install the binary packages depends on your operating system: <!-- ~~~~~ New section ~~~~~ --> <sect3 id="installattion-gentoo"><title>Gentoo</title> <para> - Gentoo source packages (Ebuilds) for <application>Privoxy</application> are - contained in the Gentoo Portage Tree (they are not on the download page, - but there is a Gentoo section, where you can see when a new + Gentoo source packages (Ebuilds) for <application>Privoxy</application> are + contained in the Gentoo Portage Tree (they are not on the download page, + but there is a Gentoo section, where you can see when a new <application>Privoxy</application> Version is added to the Portage Tree). </para> <para> - Before installing <application>Privoxy</application> under Gentoo just do - first <literal>emerge --sync</literal> to get the latest changes from the - Portage tree. With <literal>emerge privoxy</literal> you install the latest + Before installing <application>Privoxy</application> under Gentoo just do + first <literal>emerge --sync</literal> to get the latest changes from the + Portage tree. With <literal>emerge privoxy</literal> you install the latest version. </para> <para> - Configuration files are in <filename>/etc/privoxy</filename>, the + Configuration files are in <filename>/etc/privoxy</filename>, the documentation is in <filename>/usr/share/doc/privoxy-&p-version;</filename> and the Log directory is in <filename>/var/log/privoxy</filename>. </para> @@ -377,7 +377,7 @@ How to install the binary packages depends on your operating system:
<para> The most convenient way to obtain the <application>Privoxy</application> sources - is to download the source tarball from our + is to download the source tarball from our <ulink url="http://sourceforge.net/project/showfiles.php?group_id=11118&package_id=10571">project download page</ulink>. </para> @@ -386,8 +386,8 @@ How to install the binary packages depends on your operating system: If you like to live on the bleeding edge and are not afraid of using possibly unstable development versions, you can check out the up-to-the-minute version directly from <ulink url="http://sourceforge.net/cvs/?group_id=11118">the - CVS repository</ulink>. -<!-- + CVS repository</ulink>. +<!-- deprecated...out of business. or simply download <ulink url="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.bz2">the nightly CVS @@ -400,7 +400,7 @@ How to install the binary packages depends on your operating system: <!-- end boilerplate -->
</sect2> -<!-- ~~~~~ New section ~~~~~ --> +<!-- ~~~~~ New section ~~~~~ --> <sect2 id="installation-keepupdated"><title>Keeping your Installation Up-to-Date</title> <para> As user feedback comes in and development continues, we will make updated versions @@ -420,7 +420,7 @@ How to install the binary packages depends on your operating system: <para> In order not to lose your personal changes and adjustments when updating to the latest <literal>default.action</literal> file we <emphasis>strongly - recommend</emphasis> that you use <literal>user.action</literal> and + recommend</emphasis> that you use <literal>user.action</literal> and <literal>user.filter</literal> for your local customizations of <application>Privoxy</application>. See the <link linkend="actions-file">Chapter on actions files</link> for details. @@ -437,1032 +437,88 @@ How to install the binary packages depends on your operating system: <sect1 id="whatsnew"> <title>What's New in this Release</title> <para> - <application>Privoxy 3.0.19</application> is a stable release. - The changes since 3.0.18 stable are: + <application>Privoxy 3.0.12</application> is mainly a bugfix release: </para>
<para> <itemizedlist> - <listitem> + <listitem> <para> - Bug fixes: - <itemizedlist> - <listitem> - <para> - Prevent a segmentation fault when de-chunking buffered content. - It could be triggered by malicious web servers if Privoxy was - configured to filter the content and running on a platform - where SIZE_T_MAX isn't larger than UINT_MAX, which probably - includes most 32-bit systems. On those platforms, all Privoxy - versions before 3.0.19 appear to be affected. - To be on the safe side, this bug should be presumed to allow - code execution as proving that it doesn't seems unrealistic. - </para> - </listitem> - <listitem> - <para> - Do not expect a response from the SOCKS4/4A server until it - got something to respond to. This regression was introduced - in 3.0.18 and prevented the SOCKS4/4A negotiation from working. - Reported by qqqqqw in #3459781. - </para> - </listitem> - </itemizedlist> + The socket-timeout option now also works on platforms whose + select() implementation modifies the timeout structure. + Previously the timeout was triggered even if the connection + didn't stall. Reported by cyberpatrol. </para> </listitem> <listitem> <para> - General improvements: - <itemizedlist> - <listitem> - <para> - Fix an off-by-one in an error message about connect failures. - </para> - </listitem> - <listitem> - <para> - Use a GNUMakefile variable for the webserver root directory and - update the path. Sourceforge changed it which broke various - web-related targets. - </para> - </listitem> - <listitem> - <para> - Update the CODE_STATUS description. - </para> - </listitem> - </itemizedlist> + The Connection: keep-alive code properly deals with files + larger than 2GB. Previously the connection was closed too + early. </para> </listitem> - </itemizedlist> -</para> - -<para> - The following changes were made between 3.0.17 and 3.0.18: -</para> - -<para> - <itemizedlist> <listitem> <para> - Bug fixes: - <itemizedlist> - <listitem> - <para> - If a generated redirect URL contains characters RFC 3986 doesn't - permit, they are (re)encoded. Not doing this makes Privoxy versions - from 3.0.5 to 3.0.17 susceptible to HTTP response splitting (CWE-113) - attacks if the +fast-redirects{check-decoded-url} action is used. - </para> - </listitem> - <listitem> - <para> - Fix a logic bug that could cause Privoxy to reuse a server - socket after it got tainted by a server-header-tagger-induced - block that was triggered before the whole server response had - been read. If keep-alive was enabled and the request following - the blocked one was to the same host and using the same forwarding - settings, Privoxy would send it on the tainted server socket. - While the server would simply treat it as a pipelined request, - Privoxy would later on fail to properly parse the server's - response as it would try to parse the unread data from the - first response as server headers for the second one. - Regression introduced in 3.0.17. - </para> - </listitem> - <listitem> - <para> - When implying keep-alive in client_connection(), remember that - the client didn't. Fixes a regression introduced in 3.0.13 that - would cause Privoxy to wait for additional client requests after - receiving a HTTP/1.1 request with "Connection: close" set - and connection sharing enabled. - With clients which terminates the client connection after detecting - that the whole body has been received it doesn't really matter, - but with clients that don't the connection would be kept open until - it timed out. - </para> - </listitem> - <listitem> - <para> - Fix a subtle race condition between prepare_csp_for_next_request() - and sweep(). A thread preparing itself for the next client request - could briefly appear to be inactive. - If all other threads were already using more recent files, - the thread could get its files swept away under its feet. - So far this has only been reproduced while stress testing in - valgrind while touching action files in a loop. It's unlikely - to have caused any actual problems in the real world. - </para> - </listitem> - <listitem> - <para> - Disable filters if SDCH compression is used unless filtering is forced. - If SDCH was combined with a supported compression algorithm, Privoxy - previously could try to decompress it and ditch the Content-Encoding - header even though the SDCH compression wasn't dealt with. - Reported by zebul666 in #3225863. - </para> - </listitem> - <listitem> - <para> - Make a copy of the --user value and only mess with that when splitting - user and group. On some operating systems modifying the value directly - is reflected in the output of ps and friends and can be misleading. - Reported by zepard in #3292710. - </para> - </listitem> - <listitem> - <para> - If forwarded-connect-retries is set, only retry if Privoxy is actually - forwarding the request. Previously direct connections would be retried - as well. - </para> - </listitem> - <listitem> - <para> - Fixed a small memory leak when retrying connections with IPv6 - support enabled. - </para> - </listitem> - <listitem> - <para> - Remove an incorrect assertion in compile_dynamic_pcrs_job_list() - It could be triggered by a pcrs job with an invalid pcre - pattern (for example one that contains a lone quantifier). - </para> - </listitem> - <listitem> - <para> - If the --user argument user[.group] contains a dot, always bail out - if no group has been specified. Previously the intended, but undocumented - (and apparently untested), behaviour was to try interpreting the whole - argument as user name, but the detection was flawed and checked for '0' - instead of '\0', thus merely preventing group names beginning with a zero. - </para> - </listitem> - <listitem> - <para> - In html_code_map[], use a numeric character reference instead of ' - which wasn't standardized before XHTML 1.0. - </para> - </listitem> - <listitem> - <para> - Fix an invalid free when compiled with FEATURE_GRACEFUL_TERMINATION - and shut down through http://config.privoxy.org/die - </para> - </listitem> - <listitem> - <para> - In get_actions(), fix the "temporary" backwards compatibility hack - to accept block actions without reason. - It also covered other actions that should be rejected as invalid. - Reported by Billy Crook. - </para> - </listitem> - </itemizedlist> + The content length for files above 2GB is logged correctly. </para> </listitem> <listitem> <para> - General improvements: - <itemizedlist> - <listitem> - <para> - Privoxy can (re)compress buffered content before delivering - it to the client. Disabled by default as most users wouldn't - benefit from it. - </para> - </listitem> - <listitem> - <para> - The +fast-redirects{check-decoded-url} action checks URL - segments separately. If there are other parameters behind - the redirect URL, this makes it unnecessary to cut them off - by additionally using a +redirect{} pcrs command. - Initial patch submitted by Jamie Zawinski in #3429848. - </para> - </listitem> - <listitem> - <para> - When loading action sections, verify that the referenced filters - exist. Currently missing filters only result in an error message, - but eventually the severity will be upgraded to fatal. - </para> - </listitem> - <listitem> - <para> - Allow to bind to multiple separate addresses. - Patch set submitted by Petr Pisar in #3354485. - </para> - </listitem> - <listitem> - <para> - Set socket_error to errno if connecting fails in rfc2553_connect_to(). - Previously rejected direct connections could be incorrectly reported - as DNS issues if Privoxy was compiled with IPv6 support. - </para> - </listitem> - <listitem> - <para> - Adjust url_code_map[] so spaces are replaced with %20 instead of '+' - While '+' can be used by client's submitting form data, this is not - actually what Privoxy is using the lookups for. This is more of a - cosmetic issue and doesn't fix any known problems. - </para> - </listitem> - <listitem> - <para> - When compiled without FEATURE_FAST_REDIRECTS, do not silently - ignore +fast-redirect{} directives - </para> - </listitem> - <listitem> - <para> - Added a workaround for GNU libc's strptime() reporting negative - year values when the parsed year is only specified with two digits. - On affected systems cookies with such a date would not be turned - into session cookies by the +session-cookies-only action. - Reported by Vaeinoe in #3403560 - </para> - </listitem> - <listitem> - <para> - Fixed bind failures with certain GNU libc versions if no non-loopback - IP address has been configured on the system. This is mainly an issue - if the system is using DHCP and Privoxy is started before the network - is completely configured. - Reported by Raphael Marichez in #3349356. - Additional insight from Petr Pisar. - </para> - </listitem> - <listitem> - <para> - Privoxy log messages now use the ISO 8601 date format %Y-%m-%d. - It's only slightly longer than the old format, but contains - the full date including the year and allows sorting by date - (when grepping in multiple log files) without hassle. - </para> - </listitem> - <listitem> - <para> - In get_last_url(), do not bother trying to decode URLs that do - not contain at least one '%' sign. It reduces the log noise and - a number of unnecessary memory allocations. - </para> - </listitem> - <listitem> - <para> - In case of SOCKS5 failures, dump the socks response in the log message. - </para> - </listitem> - <listitem> - <para> - Simplify the signal setup in main(). - </para> - </listitem> - <listitem> - <para> - Streamline socks5_connect() slightly. - </para> - </listitem> - <listitem> - <para> - In socks5_connect(), require a complete socks response from the server. - Previously Privoxy didn't care how much data the server response - contained as long as the first two bytes contained the expected - values. While at it, shrink the buffer size so Privoxy can't read - more than a whole socks response. - </para> - </listitem> - <listitem> - <para> - In chat(), do not bother to generate a client request in case of - direct CONNECT requests. It will not be used anyway. - </para> - </listitem> - <listitem> - <para> - Reduce server_last_modified()'s stack size. - </para> - </listitem> - <listitem> - <para> - Shorten get_http_time() by using strftime(). - </para> - </listitem> - <listitem> - <para> - Constify the known_http_methods pointers in unknown_method(). - </para> - </listitem> - <listitem> - <para> - Constify the time_formats pointers in parse_header_time(). - </para> - </listitem> - <listitem> - <para> - Constify the formerly_valid_actions pointers in action_used_to_be_valid(). - </para> - </listitem> - <listitem> - <para> - Introduce a GNUMakefile MAN_PAGE variable that defaults to privoxy.1. - The Debian package uses section 8 for the man page and this - should simplify the patch. - </para> - </listitem> - <listitem> - <para> - Deduplicate the INADDR_NONE definition for Solaris by moving it to jbsockets.h - </para> - </listitem> - <listitem> - <para> - In block_url(), ditch the obsolete workaround for ancient Netscape versions - that supposedly couldn't properly deal with status code 403. - </para> - </listitem> - <listitem> - <para> - Remove a useless NULL pointer check in load_trustfile(). - </para> - </listitem> - <listitem> - <para> - Remove two useless NULL pointer checks in load_one_re_filterfile(). - </para> - </listitem> - <listitem> - <para> - Change url_code_map[] from an array of pointers to an array of arrays - It removes an unnecessary layer of indirection and on 64bit system reduces - the size of the binary a bit. - </para> - </listitem> - <listitem> - <para> - Fix various typos. Fixes taken from Debian's 29_typos.dpatch by Roland Rosenfeld. - </para> - </listitem> - <listitem> - <para> - Add a dok-tidy GNUMakefile target to clean up the messy HTML - generated by the other dok targets. - </para> - </listitem> - <listitem> - <para> - GNUisms in the GNUMakefile have been removed. - </para> - </listitem> - <listitem> - <para> - Change the HTTP version in static responses to 1.1 - </para> - </listitem> - <listitem> - <para> - Synced config.sub and config.guess with upstream - 2011-11-11/386c7218162c145f5f9e1ff7f558a3fbb66c37c5. - </para> - </listitem> - <listitem> - <para> - Add a dedicated function to parse the values of toggles. Reduces duplicated - code in load_config() and provides better error handling. Invalid or missing - toggle values are now a fatal error instead of being silently ignored. - </para> - </listitem> - <listitem> - <para> - Terminate HTML lines in static error messages with \n instead of \r\n. - </para> - </listitem> - <listitem> - <para> - Simplify cgi_error_unknown() a bit. - </para> - </listitem> - <listitem> - <para> - In LogPutString(), don't bother looking at pszText when not - actually logging anything. - </para> - </listitem> - <listitem> - <para> - Change ssplit()'s fourth parameter from int to size_t. - Fixes a clang complaint. - </para> - </listitem> - <listitem> - <para> - Add a warning that the statistics currently can't be trusted. - Mention Privoxy-Log-Parser's --statistics option as - an alternative for the time being. - </para> - </listitem> - <listitem> - <para> - In rfc2553_connect_to(), start setting cgi->error_message on error. - </para> - </listitem> - <listitem> - <para> - Change the expected status code returned for http://p.p/die depending - on whether or not FEATURE_GRACEFUL_TERMINATION is available. - </para> - </listitem> - <listitem> - <para> - In cgi_die(), mark the client connection for closing. - If the client will fetch the style sheet through another connection - it gets the main thread out of the accept() state and should thus - trigger the actual shutdown. - </para> - </listitem> - <listitem> - <para> - Add a proper CGI message for cgi_die(). - </para> - </listitem> - <listitem> - <para> - Don't enforce a logical line length limit in read_config_line(). - </para> - </listitem> - <listitem> - <para> - Slightly refactor server_last_modified() to remove useless gmtime*() calls. - </para> - </listitem> - <listitem> - <para> - In get_content_type(), also recognize '.jpeg' as JPEG extension. - </para> - </listitem> - <listitem> - <para> - Add '.png' to the list of recognized file extensions in get_content_type(). - </para> - </listitem> - <listitem> - <para> - In block_url(), consistently use the block reason "Request blocked by Privoxy" - In two places the reason was "Request for blocked URL" which hides the - fact that the request got blocked by Privoxy and isn't necessarily - correct as the block may be due to tags. - </para> - </listitem> - <listitem> - <para> - In listen_loop(), reload the configuration files after accepting - a new connection instead of before. - Previously the first connection that arrived after a configuration - change would still be handled with the old configuration. - </para> - </listitem> - <listitem> - <para> - In chat()'s receive-data loop, skip a client socket check if - the socket will be written to right away anyway. This can - increase the transfer speed for unfiltered content on fast - network connections. - </para> - </listitem> - <listitem> - <para> - The socket timeout is used for SOCKS negotiations as well which - previously couldn't timeout. - </para> - </listitem> - <listitem> - <para> - Don't keep the client connection alive if any configuration file - changed since the time the connection came in. This is closer to - Privoxy's behaviour before keep-alive support for client connection - has been added and also less confusing in general. - </para> - </listitem> - <listitem> - <para> - Treat all Content-Type header values containing the pattern - 'script' as a sign of text. Reported by pribog in #3134970. - </para> - </listitem> - </itemizedlist> + The user-manual directive on the show-status page links to + the documentation location specified with the directive, + not to the Privoxy website. </para> </listitem> <listitem> <para> - Action file improvements: - <itemizedlist> - <listitem> - <para> - Moved the site-specific block pattern section below the one for the - generic patterns so for requests that are matched in both, the block - reason for the domain is shown which is usually more useful than showing - the one for the generic pattern. - </para> - </listitem> - <listitem> - <para> - Remove -prevent-compression from the fragile alias. It's no longer - used anywhere by default and isn't known to break stuff anyway. - </para> - </listitem> - <listitem> - <para> - Add a (disabled) section to block various Facebook tracking URLs. - Reported by Dan Stahlke in #3421764. - </para> - </listitem> - <listitem> - <para> - Add a (disabled) section to rewrite and redirect click-tracking - URLs used on news.google.com. - Reported by Dan Stahlke in #3421755. - </para> - </listitem> - <listitem> - <para> - Unblock linuxcounter.net/. - Reported by Dan Stahlke in #3422612. - </para> - </listitem> - <listitem> - <para> - Block 'www91.intel.com/' which is used by Omniture. - Reported by Adam Piggott in #3167370. - </para> - </listitem> - <listitem> - <para> - Disable the handle-as-empty-doc-returns-ok option and mark it as deprecated. - Reminded by tceverling in #2790091. - </para> - </listitem> - <listitem> - <para> - Add ".ivwbox.de/" to the "Cross-site user tracking" section. - Reported by Nettozahler in #3172525. - </para> - </listitem> - <listitem> - <para> - Unblock and fast-redirect ".awin1.com/.*=http://". - Reported by Adam Piggott in #3170921. - </para> - </listitem> - <listitem> - <para> - Block "b.collective-media.net/". - </para> - </listitem> - <listitem> - <para> - Widen the Debian popcon exception to "qa.debian.org/popcon". - Seen in Debian's 05_default_action.dpatch by Roland Rosenfeld. - </para> - </listitem> - <listitem> - <para> - Block ".gemius.pl/" which only seems to be used for user tracking. - Reported by johnd16 in #3002731. Additional input from Lee and movax. - </para> - </listitem> - <listitem> - <para> - Disable banners-by-size filters for '.thinkgeek.com/'. - The filter only seems to catch pictures of the inventory. - </para> - </listitem> - <listitem> - <para> - Block requests for 'go.idmnet.bbelements.com/please/showit/'. - Reported by kacperdominik in #3372959. - </para> - </listitem> - <listitem> - <para> - Unblock adainitiative.org/. - </para> - </listitem> - <listitem> - <para> - Add a fast-redirects exception for '.googleusercontent.com/.*=cache'. - </para> - </listitem> - <listitem> - <para> - Add a fast-redirects exception for webcache.googleusercontent.com/. - </para> - </listitem> - <listitem> - <para> - Unblock http://adassier.wordpress.com/ and http://adassier.files.wordpress.com/. - </para> - </listitem> - </itemizedlist> + When running in daemon mode, Privoxy doesn't log anything + to the console unless there are errors before the logfile + has been opened. </para> </listitem> <listitem> <para> - Filter file improvements: - <itemizedlist> - <listitem> - <para> - Let the yahoo filter hide '.ads'. - </para> - </listitem> - <listitem> - <para> - Let the msn filter hide overlay ads for Facebook 'likes' in search - results and elements with the id 's_notf_div'. They only seem to be - used to advertise site 'enhancements'. - </para> - </listitem> - <listitem> - <para> - Let the js-events filter additionally disarm setInterval(). - Suggested by dg1727 in #3423775. - </para> - </listitem> - </itemizedlist> + The show-status page prints warnings about invalid directives + on the same line as the directives themselves. </para> </listitem> <listitem> <para> - Documentation improvements: - <itemizedlist> - <listitem> - <para> - Clarify the effect of compiling Privoxy with zlib support. - Suggested by dg1727 in #3423782. - </para> - </listitem> - <listitem> - <para> - Point out that the SourceForge messaging system works like a black - hole and should thus not be used to contact individual developers. - </para> - </listitem> - <listitem> - <para> - Mention some of the problems one can experience when not explicitly - configuring an IP addresses as listen address. - </para> - </listitem> - <listitem> - <para> - Explicitly mention that hostnames can be used instead of IP addresses - for the listen-address, that only the first address returned will be - used and what happens if the address is invalid. - Requested by Calestyo in #3302213. - </para> - </listitem> - </itemizedlist> + Fixed several justified (but harmless) compiler warnings, + mostly on 64 bit platforms. </para> </listitem> <listitem> <para> - Log message improvements: - <itemizedlist> - <listitem> - <para> - If only the server connection is kept alive, do not pretend to - wait for a new client request. - </para> - </listitem> - <listitem> - <para> - Remove a superfluous log message in forget_connection(). - </para> - </listitem> - <listitem> - <para> - In chat(), properly report missing server responses as such - instead of calling them empty. - </para> - </listitem> - <listitem> - <para> - In forwarded_connect(), fix a log message nobody should ever see. - </para> - </listitem> - <listitem> - <para> - Fix a log message in socks5_connect(), a failed write operation - was logged as failed read operation. - </para> - </listitem> - <listitem> - <para> - Let load_one_actions_file() properly complain about a missing - '{' at the beginning of the file. - Simply stating that a line is invalid isn't particularly helpful. - </para> - </listitem> - <listitem> - <para> - Do not claim to listen on a socket until Privoxy actually does. - Patch submitted by Petr Pisar #3354485 - </para> - </listitem> - <listitem> - <para> - Prevent a duplicated LOG_LEVEL_CLF message when sending out - the "no-server-data" response. - </para> - </listitem> - <listitem> - <para> - Also log the client socket when dropping a connection. - </para> - </listitem> - <listitem> - <para> - Include the destination host in the 'Request ... marked for - blocking. limit-connect{...} doesn't allow CONNECT ...' message - Patch submitted by Saperski in #3296250. - </para> - </listitem> - <listitem> - <para> - Prevent a duplicated log message if none of the resolved IP - addresses were reachable. - </para> - </listitem> - <listitem> - <para> - In connect_to(), do not pretend to retry if forwarded-connect-retries - is zero or unset. - </para> - </listitem> - <listitem> - <para> - When a specified user or group can't be found, put the name in - single-quotes when logging it. - </para> - </listitem> - <listitem> - <para> - In rfc2553_connect_to(), explain getnameinfo() errors better. - </para> - </listitem> - <listitem> - <para> - Remove a useless log message in chat(). - </para> - </listitem> - <listitem> - <para> - When retrying to connect, also log the maximum number of connection - attempts. - </para> - </listitem> - <listitem> - <para> - Rephrase a log message in compile_dynamic_pcrs_job_list(). - Divide the error code and its meaning with a colon. Call the pcrs - job dynamic and not the filter. Filters may contain dynamic and - non-dynamic pcrs jobs at the same time. Only mention the name of - the filter or tagger, but don't claim it's a filter when it could - be a tagger. - </para> - </listitem> - <listitem> - <para> - In a fatal error message in load_one_actions_file(), cover both - URL and TAG patterns. - </para> - </listitem> - <listitem> - <para> - In pcrs_strerror(), properly report unknown positive error code - values as such. Previously they were handled like 0 (no error). - </para> - </listitem> - <listitem> - <para> - In compile_dynamic_pcrs_job_list(), also log the actual error code as - pcrs_strerror() doesn't handle all errors reported by pcre. - </para> - </listitem> - <listitem> - <para> - Don't bother trying to continue chatting if the client didn't ask for it. - Reduces log noise a bit. - </para> - </listitem> - <listitem> - <para> - Make two fatal error message in load_one_actions_file() more descriptive. - </para> - </listitem> - <listitem> - <para> - In cgi_send_user_manual(), log when rejecting a file name due to '/' or '..'. - </para> - </listitem> - <listitem> - <para> - In load_file(), log a message if opening a file failed. - The CGI error message alone isn't too helpful. - </para> - </listitem> - <listitem> - <para> - In connection_destination_matches(), improve two log messages - to help understand why the destinations don't match. - </para> - </listitem> - <listitem> - <para> - Rephrase a log message in serve(). Client request arrival - should be differentiated from closed client connections now. - </para> - </listitem> - <listitem> - <para> - In serve(), log if a client connection isn't reused due to a - configuration file change. - </para> - </listitem> - <listitem> - <para> - Let mark_server_socket_tainted() always mark the server socket tainted, - just don't talk about it in cases where it has no effect. It doesn't change - Privoxy's behaviour, but makes understanding the log file easier. - </para> - </listitem> - </itemizedlist> - </para> - </listitem> - <listitem> - <para> - configure: - <itemizedlist> - <listitem> - <para> - Added a --disable-ipv6-support switch for platforms where support - is detected but doesn't actually work. - </para> - </listitem> - <listitem> - <para> - Do not check for the existence of strerror() and memmove() twice - </para> - </listitem> - <listitem> - <para> - Remove a useless test for setpgrp(2). Privoxy doesn't need it and - it can cause problems when cross-compiling. - </para> - </listitem> - <listitem> - <para> - Rename the --disable-acl-files switch to --disable-acl-support. - Since about 2001, ACL directives are specified in the standard - config file. - </para> - </listitem> - <listitem> - <para> - Update the URL of the 'Removing outdated PCRE version after the - next stable release' posting. The old URL stopped working after - one of SF's recent site "optimizations". Reported by Han Liu. - </para> - </listitem> - </itemizedlist> + The mingw32 version explicitly requests the default charset + to prevent display problems with some fonts available on more + recent Windows versions. Patch by Burberry. </para> </listitem> <listitem> <para> - Privoxy-Regression-Test: - <itemizedlist> - <listitem> - <para> - Added --shuffle-tests option to increase the chances of detection race conditions. - </para> - </listitem> - <listitem> - <para> - Added a --local-test-file option that allows to use Privoxy-Regression-Test without Privoxy. - </para> - </listitem> - <listitem> - <para> - Added tests for missing socks4 and socks4a forwarders. - </para> - </listitem> - <listitem> - <para> - The --privoxy-address option now works with IPv6 addresses containing brackets, too. - </para> - </listitem> - <listitem> - <para> - Perform limited sanity checks for parameters that are supposed to have numerical values. - </para> - </listitem> - <listitem> - <para> - Added a --sleep-time option to specify a number of seconds to - sleep between tests, defaults to 0. - </para> - </listitem> - <listitem> - <para> - Disable the range-requests tagger for tests that break if it's enabled. - </para> - </listitem> - <listitem> - <para> - Log messages use the ISO 8601 date format %Y-%m-%d. - </para> - </listitem> - <listitem> - <para> - Fix spelling in two error messages. - </para> - </listitem> - <listitem> - <para> - In the --help output, include a list of supported tests and their default levels. - </para> - </listitem> - <listitem> - <para> - Adjust the tests to properly deal with FEATURE_TOGGLE being disabled. - </para> - </listitem> - </itemizedlist> + The mingw32 version uses the Privoxy icon in the alt-tab + windows. Patch by Burberry. </para> - </listitem> - <listitem> - <para> - Privoxy-Log-Parser: - <itemizedlist> - <listitem> - <para> - Perform limited sanity checks for command line parameters that - are supposed to have numerical values. - </para> - </listitem> - <listitem> - <para> - Implement a --unbreak-lines-only option to try to revert MUA breakage. - </para> - </listitem> - <listitem> - <para> - Accept and highlight: Added header: Content-Encoding: deflate - </para> - </listitem> - <listitem> - <para> - Accept and highlight: Compressed content from 29258 to 8630 bytes. - </para> - </listitem> - <listitem> - <para> - Accept and highlight: Client request arrived in time on socket 21. - </para> - </listitem> - <listitem> - <para> - Highlight: Didn't receive data in time: a.fsdn.com:443 - </para> - </listitem> - <listitem> - <para> - Accept log messages with ISO 8601 time stamps, too. - </para> - </listitem> - </itemizedlist> + </listitem> + <listitem> + <para> + The timestamp and the thread id is omitted in the "Fatal error" + message box on mingw32. </para> </listitem> <listitem> <para> - uagen: - <itemizedlist> - <listitem> - <para> - Bump generated Firefox version to 8.0. - </para> - </listitem> - <listitem> - <para> - Only randomize the release date if the new --randomize-release-date - option is enabled. Firefox versions after 4 use a fixed date string - without meaning. - </para> - </listitem> - </itemizedlist> + Fixed two related mingw32-only buffer overflows. Triggering + them required control over the configuration file, therefore + this isn't seen as a security issue. + </para> + </listitem> + <listitem> + <para> + In verbose mode, or if the new option --show-skipped-tests + is used, Privoxy-Regression-Test logs skipped tests and the + skip reason. </para> </listitem> </itemizedlist> @@ -1475,7 +531,7 @@ How to install the binary packages depends on your operating system: <title>Note to Upgraders</title>
<para> - A quick list of things to be aware of before upgrading from earlier + A quick list of things to be aware of before upgrading from earlier versions of <application>Privoxy</application>: </para>
@@ -1484,7 +540,7 @@ How to install the binary packages depends on your operating system:
<listitem> <para> - The recommended way to upgrade &my-app; is to backup your old + The recommended way to upgrade &my-app; is to backup your old configuration files, install the new ones, verify that &my-app; is working correctly and finally merge back your changes using <application>diff</application> and maybe <application>patch</application>. @@ -1498,20 +554,20 @@ How to install the binary packages depends on your operating system: </para> </listitem> <listitem> - <para> + <para> Note that some installers remove earlier versions completely, including configuration files, therefore you should really save any important configuration files! </para> </listitem> <listitem> - <para> - On the other hand, other installers don't overwrite existing configuration + <para> + On the other hand, other installers don't overwrite existing configuration files, thinking you will want to do that yourself. </para> </listitem> <listitem> - <para> + <para> <filename>standard.action</filename> has been merged into the <filename>default.action</filename> file. </para> @@ -1528,21 +584,21 @@ How to install the binary packages depends on your operating system:
<listitem> <para> - Three other config file settings are now off by default: + Three other config file settings are now off by default: <link linkend="enable-remote-toggle">enable-remote-toggle</link>, <link linkend="enable-remote-http-toggle">enable-remote-http-toggle</link>, - and <link linkend="enable-edit-actions">enable-edit-actions</link>. + and <link linkend="enable-edit-actions">enable-edit-actions</link>. If you use or want these, you will need to explicitly enable them, and - be aware of the security issues involved. + be aware of the security issues involved. </para> </listitem>
<!-- <listitem> - <para> - What constitutes a <quote>default</quote> configuration has changed, - and you may want to review which actions are <quote>on</quote> by - default. This is primarily a matter of emphasis, but some features + <para> + What constitutes a <quote>default</quote> configuration has changed, + and you may want to review which actions are <quote>on</quote> by + default. This is primarily a matter of emphasis, but some features you may have been used to, may now be <quote>off</quote> by default. There are also a number of new actions and filters you may want to consider, most of which are not fully incorporated into the default @@ -1579,15 +635,15 @@ How to install the binary packages depends on your operating system: Or if you use a number of filters, or filter many sites, you may just want to turn off compression for all sites in <filename>default.action</filename> (or - <filename>user.action</filename>). + <filename>user.action</filename>). </para>
</listitem>
<listitem> <para> - Also, <link linkend="SESSION-COOKIES-ONLY">session-cookies-only</link> is - off by default now. If you've liked this feature in the past, you may want + Also, <link linkend="SESSION-COOKIES-ONLY">session-cookies-only</link> is + off by default now. If you've liked this feature in the past, you may want to turn it back on in <filename>user.action</filename> now. </para> </listitem> @@ -1598,7 +654,7 @@ How to install the binary packages depends on your operating system: Some installers may not automatically start <application>Privoxy</application> after installation. </para> - </listitem> + </listitem> -->
</itemizedlist> @@ -1616,19 +672,19 @@ How to install the binary packages depends on your operating system: <para> Install <application>Privoxy</application>. See the <link linkend="installation">Installation Section</link> below for platform specific - information. + information. </para> - </listitem> + </listitem>
<listitem> <para> Advanced users and those who want to offer <application>Privoxy</application> service to more than just their local machine should check the <link linkend="config">main config file</link>, especially the <link - linkend="access-control">security-relevant</link> options. These are + linkend="access-control">security-relevant</link> options. These are off by default. </para> - </listitem> + </listitem>
<listitem> <para> @@ -1644,26 +700,26 @@ How to install the binary packages depends on your operating system: HTTPS (SSL) <ulink url="http://en.wikipedia.org/wiki/Proxy_server">proxy</ulink> by setting the proxy configuration for address of <literal>127.0.0.1</literal> and port <literal>8118</literal>. - <emphasis>DO NOT</emphasis> activate proxying for <literal>FTP</literal> or + <emphasis>DO NOT</emphasis> activate proxying for <literal>FTP</literal> or any protocols besides HTTP and HTTPS (SSL) unless you intend to prevent your browser from using these protocols. </para> - </listitem> + </listitem>
<listitem> <para> Flush your browser's disk and memory caches, to remove any cached ad images. - If using <application>Privoxy</application> to manage + If using <application>Privoxy</application> to manage <ulink url="http://en.wikipedia.org/wiki/Browser_cookie">cookies</ulink>, you should remove any currently stored cookies too. </para> - </listitem> + </listitem>
<listitem> <para> - A default installation should provide a reasonable starting point for + A default installation should provide a reasonable starting point for most. There will undoubtedly be occasions where you will want to adjust the - configuration, but that can be dealt with as the need arises. Little + configuration, but that can be dealt with as the need arises. Little to no initial configuration is required in most cases, you may want to enable the <ulink url="config.html#ENABLE-EDIT-ACTIONS">web-based action editor</ulink> though. @@ -1677,7 +733,7 @@ How to install the binary packages depends on your operating system: introduction to how <application>Privoxy</application> blocks ads and banners. </para> - </listitem> + </listitem>
<listitem> <para> @@ -1692,7 +748,7 @@ How to install the binary packages depends on your operating system: Action</link></quote> has hints on how to understand and debug actions that <quote>misbehave</quote>. </para> - </listitem> + </listitem>
<!-- Did anyone test these lately? @@ -1703,22 +759,22 @@ How to install the binary packages depends on your operating system: <link linkend="bookmarklets">Bookmarklets</link> into your browser's personal toolbar. </para> - </listitem> + </listitem> -->
<listitem> <para> Please see the section <link linkend="contact">Contacting the Developers</link> on how to report bugs, problems with websites or to get - help. + help. </para> - </listitem> + </listitem>
<listitem> <para> Now enjoy surfing with enhanced control, comfort and privacy! </para> - </listitem> + </listitem>
</itemizedlist> </para> @@ -1729,35 +785,35 @@ How to install the binary packages depends on your operating system: <sect2 id="quickstart-ad-blocking"> <title>Quickstart to Ad Blocking</title> <!-- - NOTE: This section is deliberately redundant for those that don't + NOTE: This section is deliberately redundant for those that don't want to read the whole thing (which is getting lengthy). --> <para> Ad blocking is but one of <application>Privoxy's</application> - array of features. Many of these features are for the technically minded advanced + array of features. Many of these features are for the technically minded advanced user. But, ad and banner blocking is surely common ground for everybody. </para> -<para> - This section will provide a quick summary of ad blocking so +<para> + This section will provide a quick summary of ad blocking so you can get up to speed quickly without having to read the more extensive information provided below, though this is highly recommended. </para> <para> First a bit of a warning ... blocking ads is much like blocking SPAM: the - more aggressive you are about it, the more likely you are to block - things that were not intended. And the more likely that some things + more aggressive you are about it, the more likely you are to block + things that were not intended. And the more likely that some things may not work as intended. So there is a trade off here. If you want extreme ad free browsing, be prepared to deal with more <quote>problem</quote> sites, and to spend more time adjusting the - configuration to solve these unintended consequences. In short, there is - not an easy way to eliminate <emphasis>all</emphasis> ads. Either take + configuration to solve these unintended consequences. In short, there is + not an easy way to eliminate <emphasis>all</emphasis> ads. Either take the easy way and settle for <emphasis>most</emphasis> ads blocked with the default configuration, or jump in and tweak it for your personal surfing habits and preferences. </para> <para> Secondly, a brief explanation of <application>Privoxy's </application> - <quote>actions</quote>. <quote>Actions</quote> in this context, are + <quote>actions</quote>. <quote>Actions</quote> in this context, are the directives we use to tell <application>Privoxy</application> to perform some task relating to HTTP transactions (i.e. web browsing). We tell <application>Privoxy</application> to take some <quote>action</quote>. Each @@ -1769,7 +825,7 @@ How to install the binary packages depends on your operating system: </para> <para> Actions are specified in <application>Privoxy's</application> configuration, - followed by one or more URLs to which the action should apply. URLs + followed by one or more URLs to which the action should apply. URLs can actually be URL type <link linkend="af-patterns">patterns</link> that use wildcards so they can apply potentially to a range of similar URLs. The actions, together with the URL patterns are called a section. @@ -1792,7 +848,7 @@ How to install the binary packages depends on your operating system: <para> The most important actions for basic ad blocking are: <literal><link linkend="block">block</link></literal>, <literal><link - linkend="handle-as-image">handle-as-image</link></literal>, + linkend="handle-as-image">handle-as-image</link></literal>, <literal><link linkend="handle-as-empty-document">handle-as-empty-document</link></literal>,and <literal><link linkend="set-image-blocker">set-image-blocker</link></literal>: @@ -1800,10 +856,10 @@ How to install the binary packages depends on your operating system:
<para> <itemizedlist> - + <listitem> <para> - <literal><link linkend="block">block</link></literal> - this is perhaps + <literal><link linkend="block">block</link></literal> - this is perhaps the single most used action, and is particularly important for ad blocking. This action stops any contact between your browser and any URL patterns that match this action's configuration. It can be used for blocking ads, @@ -1812,32 +868,32 @@ How to install the binary packages depends on your operating system: <application>Privoxy</application>'s own built-in BLOCKED page instead to let you now what has happened (with some exceptions, see below). </para> - </listitem> + </listitem>
<listitem> <para> - <literal><link linkend="handle-as-image">handle-as-image</link></literal> - + <literal><link linkend="handle-as-image">handle-as-image</link></literal> - tells <application>Privoxy</application> to treat this URL as an image. <application>Privoxy</application>'s default configuration already does this for all common image types (e.g. GIF), but there are many situations where this is not so easy to determine. So we'll force it in these cases. This is particularly important for ad blocking, since only if we know that it's an image of - some kind, can we replace it with an image of our choosing, instead of the + some kind, can we replace it with an image of our choosing, instead of the <application>Privoxy</application> BLOCKED page (which would only result in a <quote>broken image</quote> icon). There are some limitations to this though. For instance, you can't just brute-force an image substitution for an entire HTML page in most situations. </para> - </listitem> + </listitem>
<listitem> <para> - <literal><link linkend="handle-as-empty-document">handle-as-empty-document</link></literal> - - sends an empty document instead of <application>Privoxy's</application> - normal BLOCKED HTML page. This is useful for file types that are neither + <literal><link linkend="handle-as-empty-document">handle-as-empty-document</link></literal> - + sends an empty document instead of <application>Privoxy's</application> + normal BLOCKED HTML page. This is useful for file types that are neither HTML nor images, such as blocking JavaScript files. </para> - </listitem> + </listitem>
<listitem> <para> @@ -1854,7 +910,7 @@ How to install the binary packages depends on your operating system: </para> <simplelist> <member> - <emphasis>pattern</emphasis> - a checkerboard pattern, so that an ad + <emphasis>pattern</emphasis> - a checkerboard pattern, so that an ad replacement is obvious. This is the default. </member> </simplelist> @@ -1870,14 +926,14 @@ How to install the binary packages depends on your operating system: of the user's choosing (advanced usage). </member> </simplelist> - </listitem> + </listitem>
</itemizedlist> </para>
<para> Advanced users will eventually want to explore &my-app; - <literal><link linkend="filter">filters</link></literal> as well. Filters + <literal><link linkend="filter">filters</link></literal> as well. Filters are very different from <literal><link linkend="block">blocks</link></literal>. A <quote>block</quote> blocks a site, page, or unwanted contented. Filters @@ -1892,7 +948,7 @@ How to install the binary packages depends on your operating system: The quickest way to adjust any of these settings is with your browser through the special <application>Privoxy</application> editor at <ulink url="http://config.privoxy.org/show-status">http://config.privoxy.org/show-status</ulink> - (shortcut: <ulink url="http://p.p/">http://p.p/show-status</ulink>). This + (shortcut: <ulink url="http://p.p/">http://p.p/show-status</ulink>). This is an internal page, and does not require Internet access. </para>
@@ -1924,21 +980,21 @@ How to install the binary packages depends on your operating system:
<listitem> <para> - Right click on the ad image to be blocked, then select + Right click on the ad image to be blocked, then select <quote><guimenuitem>Copy Link Location</guimenuitem></quote> from the - pop-up menu. + pop-up menu. </para> - </listitem> + </listitem> <listitem> <para> - Set your browser to + Set your browser to <ulink url="http://config.privoxy.org/show-status">http://config.privoxy.org/show-status</ulink> </para> - </listitem> + </listitem> <listitem> <para> - Find <filename>user.action</filename> in the top section, and click + Find <filename>user.action</filename> in the top section, and click on <quote><guibutton>Edit</guibutton></quote>: </para>
@@ -1948,29 +1004,29 @@ How to install the binary packages depends on your operating system: <mediaobject> <imageobject> <imagedata fileref="files-in-use.jpg" format="jpg"> - </imageobject> + </imageobject> <textobject> <phrase>[ Screenshot of Actions Files in Use ]</phrase> </textobject> </mediaobject> </figure> </para> - </listitem> - + </listitem> + <listitem> <para> You should have a section with only - <literal><link linkend="block">block</link></literal> listed under + <literal><link linkend="block">block</link></literal> listed under <quote>Actions:</quote>. If not, click a <quote><guibutton>Insert new section below</guibutton></quote> - button, and in the new section that just appeared, click the + button, and in the new section that just appeared, click the <guibutton>Edit</guibutton> button right under the word <quote>Actions:</quote>. This will bring up a list of all actions. Find <literal><link linkend="block">block</link></literal> near the top, and click in the <quote>Enabled</quote> column, then <quote><guibutton>Submit</guibutton></quote> just below the list. </para> - </listitem> + </listitem> <listitem> <para> Now, in the <literal><link linkend="block">block</link></literal> actions section, @@ -1980,21 +1036,21 @@ How to install the binary packages depends on your operating system: <quote><guibutton>Submit</guibutton></quote> (or <quote><guibutton>OK</guibutton></quote> if in a pop-up window). </para> - </listitem> + </listitem> <listitem> <para> Now go back to the original page, and press <keycap>SHIFT-Reload</keycap> (or flush all browser caches). The image should be gone now. </para> - </listitem> - + </listitem> + </itemizedlist> </para>
<para> - This is a very crude and simple example. There might be good reasons to use a + This is a very crude and simple example. There might be good reasons to use a wildcard pattern match to include potentially similar images from the same - site. For a more extensive explanation of <quote>patterns</quote>, and + site. For a more extensive explanation of <quote>patterns</quote>, and the entire actions concept, see <link linkend="actions-file">the Actions section</link>. </para> @@ -2005,11 +1061,11 @@ How to install the binary packages depends on your operating system: The ideas explained therein also apply to the web-based editor. </para> <para> - There are also various - <link linkend="filter">filters</link> that can be used for ad blocking - (filters are a special subset of actions). These + There are also various + <link linkend="filter">filters</link> that can be used for ad blocking + (filters are a special subset of actions). These fall into the <quote>advanced</quote> usage category, and are explained in - depth in later sections. + depth in later sections. </para>
</sect2> @@ -2025,14 +1081,14 @@ How to install the binary packages depends on your operating system: <para> Before launching <application>Privoxy</application> for the first time, you will want to configure your browser(s) to use - <application>Privoxy</application> as a HTTP and HTTPS (SSL) + <application>Privoxy</application> as a HTTP and HTTPS (SSL) <ulink url="http://en.wikipedia.org/wiki/Proxy_server">proxy</ulink>. The default is 127.0.0.1 (or localhost) for the proxy address, and port 8118 (earlier versions used port 8000). This is the one configuration step <emphasis>that must be done </emphasis>! </para> <para> - Please note that <application>Privoxy</application> can only proxy HTTP and + Please note that <application>Privoxy</application> can only proxy HTTP and HTTPS traffic. It will not work with FTP or other protocols. </para>
@@ -2043,35 +1099,35 @@ How to install the binary packages depends on your operating system: <mediaobject> <imageobject> <imagedata fileref="proxy_setup.jpg" format="jpg"> - </imageobject> + </imageobject> <textobject> <phrase>[ Screenshot of Mozilla Proxy Configuration ]</phrase> </textobject> </mediaobject> </figure> </para> +
- -<para> +<para> With <application>Firefox</application>, this is typically set under: </para> - + <literallayout> <guibutton>Tools</guibutton> -> <guibutton>Options</guibutton> -> <guibutton>Advanced</guibutton> -> <guibutton>Network</guibutton> -><guibutton>Connection</guibutton> -> <guibutton>Settings</guibutton>
</literallayout>
-<para> +<para> Or optionally on some platforms: </para> - + <literallayout> <guibutton>Edit</guibutton> -> <guibutton>Preferences</guibutton> -> <guibutton>General</guibutton> -> <guibutton>Connection Settings</guibutton> -> <guibutton>Manual Proxy Configuration</guibutton>
</literallayout>
-<para> +<para> With <application>Netscape</application> (and <application>Mozilla</application>), this can be set under: </para> @@ -2085,7 +1141,7 @@ How to install the binary packages depends on your operating system: </literallayout>
<para> - For <application>Internet Explorer v.5-7</application>: + For <application>Internet Explorer v.5-7</application>: </para>
<literallayout> @@ -2107,7 +1163,7 @@ How to install the binary packages depends on your operating system: <mediaobject> <imageobject> <imagedata fileref="proxy2.jpg" format="jpg"> - </imageobject> + </imageobject> <textobject> <phrase>[ Screenshot of IE Proxy Configuration ]</phrase> </textobject> @@ -2118,7 +1174,7 @@ How to install the binary packages depends on your operating system:
<para> After doing this, flush your browser's disk and memory caches to force a - re-reading of all pages and to get rid of any ads that may be cached. Remove + re-reading of all pages and to get rid of any ads that may be cached. Remove any <ulink url="http://en.wikipedia.org/wiki/Browser_cookie">cookies</ulink>, if you want <application>Privoxy</application> to manage that. You are now ready to start enjoying the benefits of using @@ -2182,7 +1238,7 @@ Click on the &my-app; Icon to start <application>Privoxy</application>. If no co <para> <application>Privoxy</application> can run with full Windows service functionality. On Windows only, the &my-app; program has two new command line arguments - to install and uninstall &my-app; as a service. See the + to install and uninstall &my-app; as a service. See the <link linkend="installation-pack-win">Windows Installation instructions</link> for details. </para> @@ -2249,7 +1305,7 @@ Example Unix startup command: Start <application>Privoxy</application> (with RUN <>NIL:) in your <filename>startnet</filename> script (AmiTCP), in <filename>s:user-startup</filename> (RoadShow), as startup program in your - startup script (Genesis), or as startup action (Miami and MiamiDx). + startup script (Genesis), or as startup action (Miami and MiamiDx). <application>Privoxy</application> will automatically quit when you quit your TCP/IP stack (just ignore the harmless warning your TCP/IP stack may display that <application>Privoxy</application> is still running). @@ -2259,7 +1315,7 @@ Example Unix startup command: <sect2 id="start-gentoo"> <title>Gentoo</title> <para> - A script is again used. It will use the file <filename>/etc/privoxy/config + A script is again used. It will use the file <filename>/etc/privoxy/config </filename> as its main configuration file. </para> <para> @@ -2268,11 +1324,11 @@ Example Unix startup command: </screen> </para> <para> - Note that <application>Privoxy</application> is not automatically started at - boot time by default. You can change this with the <literal>rc-update</literal> + Note that <application>Privoxy</application> is not automatically started at + boot time by default. You can change this with the <literal>rc-update</literal> command. </para> -<para> +<para> <screen> rc-update add privoxy default </screen> @@ -2294,7 +1350,7 @@ must find a better place for this paragraph <ulink url="actions-file.html"><quote>actions</quote></ulink> files. These are where various cookie actions are defined, ad and banner blocking, and other aspects of <application>Privoxy</application> configuration. There are several - such files included, with varying levels of aggressiveness. + such files included, with varying levels of aggressiveness. </para>
<para> @@ -2314,7 +1370,7 @@ must find a better place for this paragraph sites is the popup-killing (through <ulink url="actions-file.html#FILTER-POPUPS"><quote>+filter{popups}</quote></ulink>), because your favorite shopping, banking, or leisure site may need - popups (explained below). + popups (explained below). </para>
<para> @@ -2330,24 +1386,24 @@ must find a better place for this paragraph </para>
<para> - After running <application>Privoxy</application> for a while, you can - start to fine tune the configuration to suit your personal, or site, - preferences and requirements. There are many, many aspects that can - be customized. <quote>Actions</quote> - can be adjusted by pointing your browser to + After running <application>Privoxy</application> for a while, you can + start to fine tune the configuration to suit your personal, or site, + preferences and requirements. There are many, many aspects that can + be customized. <quote>Actions</quote> + can be adjusted by pointing your browser to <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> - (shortcut: <ulink url="http://p.p/">http://p.p/</ulink>), - and then follow the link to <quote>View & Change the Current Configuration</quote>. + (shortcut: <ulink url="http://p.p/">http://p.p/</ulink>), + and then follow the link to <quote>View & Change the Current Configuration</quote>. (This is an internal page and does not require Internet access.) </para>
<para> In fact, various aspects of <application>Privoxy</application> - configuration can be viewed from this page, including - current configuration parameters, source code version numbers, - the browser's request headers, and <quote>actions</quote> that apply - to a given URL. In addition to the actions file - editor mentioned above, <application>Privoxy</application> can also + configuration can be viewed from this page, including + current configuration parameters, source code version numbers, + the browser's request headers, and <quote>actions</quote> that apply + to a given URL. In addition to the actions file + editor mentioned above, <application>Privoxy</application> can also be turned <quote>on</quote> and <quote>off</quote> (toggled) from this page. </para>
@@ -2370,9 +1426,9 @@ must find a better place for this paragraph
<para> If you can't get rid of the problem at all, think you've found a bug in - Privoxy, want to propose a new feature or smarter rules, please see the + Privoxy, want to propose a new feature or smarter rules, please see the section <link linkend="contact"><quote>Contacting the - Developers</quote></link> below. + Developers</quote></link> below. </para>
--> @@ -2395,7 +1451,7 @@ must find a better place for this paragraph <para> Print version info and exit. Unix only. </para> - </listitem> + </listitem> <listitem> <para> <emphasis>--help</emphasis> @@ -2403,7 +1459,7 @@ must find a better place for this paragraph <para> Print short usage info and exit. Unix only. </para> - </listitem> + </listitem> <listitem> <para> <emphasis>--no-daemon</emphasis> @@ -2412,7 +1468,7 @@ must find a better place for this paragraph Don't become a daemon, i.e. don't fork and become process group leader, and don't detach from controlling tty. Unix only. </para> - </listitem> + </listitem> <listitem> <para> <emphasis>--pidfile FILE</emphasis> @@ -2423,7 +1479,7 @@ must find a better place for this paragraph <emphasis>FILE</emphasis> is non-fatal. If no <emphasis>FILE</emphasis> option is given, no PID file will be used. Unix only. </para> - </listitem> + </listitem> <listitem> <para> <emphasis>--user USER[.GROUP]</emphasis> @@ -2439,9 +1495,9 @@ must find a better place for this paragraph <emphasis>--chroot</emphasis> </para> <para> - Before changing to the user ID given in the <emphasis>--user</emphasis> option, + Before changing to the user ID given in the <emphasis>--user</emphasis> option, chroot to that user's home directory, i.e. make the kernel pretend to the &my-app; - process that the directory tree starts there. If set up carefully, this can limit + process that the directory tree starts there. If set up carefully, this can limit the impact of possible vulnerabilities in &my-app; to the files contained in that hierarchy. Unix only. </para> @@ -2469,23 +1525,23 @@ must find a better place for this paragraph <emphasis>configfile</emphasis> </para> <para> - If no <emphasis>configfile</emphasis> is included on the command line, - <application>Privoxy</application> will look for a file named - <quote>config</quote> in the current directory (except on Win32 - where it will look for <quote>config.txt</quote> instead). Specify - full path to avoid confusion. If no config file is found, + If no <emphasis>configfile</emphasis> is included on the command line, + <application>Privoxy</application> will look for a file named + <quote>config</quote> in the current directory (except on Win32 + where it will look for <quote>config.txt</quote> instead). Specify + full path to avoid confusion. If no config file is found, <application>Privoxy</application> will fail to start. </para> - </listitem> + </listitem>
</itemizedlist> </para>
<para> - On <application>MS Windows</application> only there are two additional - command-line options to allow <application>Privoxy</application> to install and - run as a <emphasis>service</emphasis>. See the -<link linkend="installation-pack-win">Window Installation section</link> + On <application>MS Windows</application> only there are two additional + command-line options to allow <application>Privoxy</application> to install and + run as a <emphasis>service</emphasis>. See the +<link linkend="installation-pack-win">Window Installation section</link> for details. </para>
@@ -2499,9 +1555,9 @@ for details. <!-- ~~~~~ New section ~~~~~ --> <sect1 id="configuration"><title>Privoxy Configuration</title> <para> - All <application>Privoxy</application> configuration is stored + All <application>Privoxy</application> configuration is stored in text files. These files can be edited with a text editor. - Many important aspects of <application>Privoxy</application> can + Many important aspects of <application>Privoxy</application> can also be controlled easily with a web browser. </para>
@@ -2511,9 +1567,9 @@ for details. <sect2> <title>Controlling Privoxy with Your Web Browser</title> <para> - <application>Privoxy</application>'s user interface can be reached through the special + <application>Privoxy</application>'s user interface can be reached through the special URL <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> - (shortcut: <ulink url="http://p.p/">http://p.p/</ulink>), + (shortcut: <ulink url="http://p.p/">http://p.p/</ulink>), which is a built-in page and works without Internet access. You will see the following section:
@@ -2555,14 +1611,14 @@ for details. cookie, and URL blocking magic is configured as well as other advanced features of <application>Privoxy</application>. This is an easy way to adjust various aspects of <application>Privoxy</application> configuration. The actions - file, and other configuration files, are explained in detail below. + file, and other configuration files, are explained in detail below. </para>
<para> - <quote>Toggle Privoxy On or Off</quote> is handy for sites that might + <quote>Toggle Privoxy On or Off</quote> is handy for sites that might have problems with your current actions and filters. You can in fact use - it as a test to see whether it is <application>Privoxy</application> - causing the problem or not. <application>Privoxy</application> continues + it as a test to see whether it is <application>Privoxy</application> + causing the problem or not. <application>Privoxy</application> continues to run as a proxy in this case, but all manipulation is disabled, i.e. <application>Privoxy</application> acts like a normal forwarding proxy. There is even a toggle <link linkend="bookmarklets">Bookmarklet</link> offered, so @@ -2592,14 +1648,14 @@ for details. <para> For Unix, *BSD and Linux, all configuration files are located in <filename>/etc/privoxy/</filename> by default. For MS Windows, OS/2, and - AmigaOS these are all in the same directory as the + AmigaOS these are all in the same directory as the <application>Privoxy</application> executable. <![%p-not-stable;[ The name and number of configuration files has changed from previous versions, and is subject to change as development progresses.]]> </para>
<para> - The installed defaults provide a reasonable starting point, though + The installed defaults provide a reasonable starting point, though some settings may be aggressive by some standards. For the time being, the principle configuration files are: </para> @@ -2613,7 +1669,7 @@ for details. on Linux, Unix, BSD, OS/2, and AmigaOS and <filename>config.txt</filename> on Windows. This is a required file. </para> - </listitem> + </listitem>
<listitem> <para> @@ -2627,23 +1683,23 @@ for details. It should be the second actions file loaded and shouldn't be edited by the user. </para> <para> - Multiple actions files may be defined in <filename>config</filename>. These - are processed in the order they are defined. Local customizations and locally + Multiple actions files may be defined in <filename>config</filename>. These + are processed in the order they are defined. Local customizations and locally preferred exceptions to the default policies as defined in <filename>match-all.action</filename> (which you will most probably want to define sooner or later) are best applied in <filename>user.action</filename>, where you can preserve them across upgrades. The file isn't installed by all installers, but you can easily create it yourself with a text editor. </para> - <para> + <para> There is also a web based editor that can be accessed from <ulink url="http://config.privoxy.org/show-status">http://config.privoxy.org/show-status</ulink> (Shortcut: <ulink url="http://p.p/show-status">http://p.p/show-status</ulink>) for the - various actions files. + various actions files. </para> - </listitem> + </listitem>
<listitem> <para> @@ -2651,15 +1707,15 @@ for details. file</link>) can be used to re-write the raw page content, including viewable text as well as embedded HTML and JavaScript, and whatever else lurks on any given web page. The filtering jobs are only pre-defined here; - whether to apply them or not is up to the actions files. - <filename>default.filter</filename> includes various filters made - available for use by the developers. Some are much more intrusive than - others, and all should be used with caution. You may define additional - filter files in <filename>config</filename> as you can with - actions files. We suggest <filename>user.filter</filename> for any + whether to apply them or not is up to the actions files. + <filename>default.filter</filename> includes various filters made + available for use by the developers. Some are much more intrusive than + others, and all should be used with caution. You may define additional + filter files in <filename>config</filename> as you can with + actions files. We suggest <filename>user.filter</filename> for any locally defined filters or customizations. </para> - </listitem> + </listitem>
</itemizedlist> </para> @@ -2681,15 +1737,15 @@ for details. </para>
<para> - The actions files and filter files + The actions files and filter files can use Perl style <link linkend="regex">regular expressions</link> for - maximum flexibility. + maximum flexibility. </para>
<para> After making any changes, there is no need to restart <application>Privoxy</application> in order for the changes to take - effect. <application>Privoxy</application> detects such changes + effect. <application>Privoxy</application> detects such changes automatically. Note, however, that it may take one or two additional requests for the change to take effect. When changing the listening address of <application>Privoxy</application>, these <quote>wake up</quote> requests @@ -2698,9 +1754,9 @@ for details.
<![%p-not-stable;[ <para> - While under development, the configuration content is subject to change. - The below documentation may not be accurate by the time you read this. - Also, what constitutes a <quote>default</quote> setting, may change, so + While under development, the configuration content is subject to change. + The below documentation may not be accurate by the time you read this. + Also, what constitutes a <quote>default</quote> setting, may change, so please check all your configuration files on important issues. </para> ]]> @@ -2736,15 +1792,15 @@ for details. The actions files are used to define what <emphasis>actions</emphasis> <application>Privoxy</application> takes for which URLs, and thus determines how ad images, cookies and various other aspects of HTTP content and - transactions are handled, and on which sites (or even parts thereof). + transactions are handled, and on which sites (or even parts thereof). There are a number of such actions, with a wide range of functionality. Each action does something a little different. - These actions give us a veritable arsenal of tools with which to exert - our control, preferences and independence. Actions can be combined so that + These actions give us a veritable arsenal of tools with which to exert + our control, preferences and independence. Actions can be combined so that their effects are aggregated when applied against a given set of URLs. -</para> +</para> <para> - There + There are three action files included with <application>Privoxy</application> with differing purposes: </para> @@ -2757,7 +1813,7 @@ for details. content modification, cookie handling etc should be applied by default. It should be the first actions file loaded </para> - </listitem> + </listitem> <listitem> <para> <filename>default.action</filename> - defines many exceptions (both @@ -2766,15 +1822,15 @@ for details. work reasonably well as-is for most users. This file is only supposed to be edited by the developers. It should be the second actions file loaded. </para> - </listitem> + </listitem> <listitem> <para> - <filename>user.action</filename> - is intended to be for local site + <filename>user.action</filename> - is intended to be for local site preferences and exceptions. As an example, if your ISP or your bank - has specific requirements, and need special handling, this kind of + has specific requirements, and need special handling, this kind of thing should go here. This file will not be upgraded. </para> - </listitem> + </listitem> <listitem> <para> <guibutton>Edit</guibutton> <guibutton>Set to Cautious</guibutton> <guibutton>Set to Medium</guibutton> <guibutton>Set to Advanced</guibutton> @@ -2782,16 +1838,16 @@ for details. <para> These have increasing levels of aggressiveness <emphasis>and have no influence on your browsing unless you select them explicitly in the - editor</emphasis>. A default installation should be pre-set to + editor</emphasis>. A default installation should be pre-set to <literal>Cautious</literal>. New users should try this for a while before - adjusting the settings to more aggressive levels. The more aggressive - the settings, then the more likelihood there is of problems such as sites + adjusting the settings to more aggressive levels. The more aggressive + the settings, then the more likelihood there is of problems such as sites not working as they should. </para> <para> - The <guibutton>Edit</guibutton> button allows you to turn each + The <guibutton>Edit</guibutton> button allows you to turn each action on/off individually for fine-tuning. The <guibutton>Cautious</guibutton> - button changes the actions list to low/safe settings which will activate + button changes the actions list to low/safe settings which will activate ad blocking and a minimal set of &my-app;'s features, and subsequently there will be less of a chance for accidental problems. The <guibutton>Medium</guibutton> button sets the list to a medium level of @@ -2862,7 +1918,7 @@ for details. <entry>blocks only</entry> <entry>blocks only</entry> </row> - + <row> <entry>Privacy Features</entry> <entry>low</entry> @@ -2931,12 +1987,12 @@ for details. </table> </para>
- </listitem> + </listitem> </itemizedlist> -</para> +</para>
<para> - The list of actions files to be used are defined in the main configuration + The list of actions files to be used are defined in the main configuration file, and are processed in the order they are defined (e.g. <filename>default.action</filename> is typically processed before <filename>user.action</filename>). The content of these can all be viewed and @@ -2947,7 +2003,7 @@ for details. (defined in <filename>default.action</filename>), followed by any exceptions (typically also in <filename>default.action</filename>), which are then followed lastly by any - local preferences (typically in <emphasis>user</emphasis><filename>.action</filename>). + local preferences (typically in <emphasis>user</emphasis><filename>.action</filename>). Generally, <filename>user.action</filename> has the last word. </para>
@@ -2957,7 +2013,7 @@ for details. <link linkend="aliases">alias section</link> at the top of that file. Then comes the default set of rules which will apply universally to all sites and pages (be <emphasis>very careful</emphasis> with using such a - universal set in <filename>user.action</filename> or any other actions file after + universal set in <filename>user.action</filename> or any other actions file after <filename>default.action</filename>, because it will override the result from consulting any previous file). And then below that, exceptions to the defined universal policies. You can regard @@ -2966,7 +2022,7 @@ for details. personal settings across <application>Privoxy</application> upgrades easier. </para>
-<para> +<para> Actions can be used to block anything you want, including ads, banners, or just some obnoxious URL whose content you would rather not see. Cookies can be accepted or rejected, or accepted only during the current browser session (i.e. not @@ -2982,7 +2038,7 @@ for details. Note that some <link linkend="actions">actions</link>, like cookie suppression or script disabling, may render some sites unusable that rely on these techniques to work properly. Finding the right mix of actions is not always easy and - certainly a matter of personal taste. And, things can always change, requiring + certainly a matter of personal taste. And, things can always change, requiring refinements in the configuration. In general, it can be said that the more <quote>aggressive</quote> your default settings (in the top section of the actions file) are, the more exceptions for <quote>trusted</quote> sites you @@ -3014,13 +2070,13 @@ for details. like <quote>Cautious</quote>, <quote>Medium</quote> or <quote>Advanced</quote>. Warning: the <quote>Advanced</quote> setting is more aggressive, and will be more likely to cause problems for some sites. - Experienced users only! + Experienced users only! </para>
<para> If you prefer plain text editing to GUIs, you can of course also directly edit the the actions files with your favorite text editor. Look at - <filename>default.action</filename> which is richly commented with many + <filename>default.action</filename> which is richly commented with many good examples. </para> </sect2> @@ -3048,12 +2104,12 @@ for details. <para> If multiple applying sections set the same action differently, the last match wins. If not, the effects are aggregated. - E.g. a URL might match a regular section with a heading line of <literal>{ + E.g. a URL might match a regular section with a heading line of <literal>{ +<link linkend="handle-as-image">handle-as-image</link> }</literal>, then later another one with just <literal>{ +<link linkend="block">block</link> }</literal>, resulting - in <emphasis>both</emphasis> actions to apply. And there may well be - cases where you will want to combine actions together. Such a section then + in <emphasis>both</emphasis> actions to apply. And there may well be + cases where you will want to combine actions together. Such a section then might look like: </para>
@@ -3080,7 +2136,7 @@ for details. <!-- ~~~~~ New section ~~~~~ --> <sect2 id="af-patterns"> <title>Patterns</title> -<para> +<para> As mentioned, <application>Privoxy</application> uses <quote>patterns</quote> to determine what <emphasis>actions</emphasis> might apply to which sites and pages your browser attempts to access. These <quote>patterns</quote> use wild @@ -3088,29 +2144,23 @@ for details. flexibility. This allows one expression to be expanded and potentially match against many similar patterns. </para> - + <para> Generally, an URL pattern has the form - <literal><domain><port>/<path></literal>, where the - <literal><domain></literal>, the <literal><port></literal> - and the <literal><path></literal> are optional. (This is why the special - <literal>/</literal> pattern matches all URLs). Note that the protocol - portion of the URL pattern (e.g. <literal>http://</literal>) should - <emphasis>not</emphasis> be included in the pattern. This is assumed already! + <literal><domain>/<path></literal>, where both the + <literal><domain></literal> and <literal><path></literal> are + optional. (This is why the special <literal>/</literal> pattern matches all + URLs). Note that the protocol portion of the URL pattern (e.g. + <literal>http://</literal>) should <emphasis>not</emphasis> be included in + the pattern. This is assumed already! </para> <para> The pattern matching syntax is different for the domain and path parts of - the URL. The domain part uses a simple globbing type matching technique, - while the path part uses more flexible + the URL. The domain part uses a simple globbing type matching technique, + while the path part uses more flexible <ulink url="http://en.wikipedia.org/wiki/Regular_expressions"><quote>Regular Expressions</quote></ulink> (POSIX 1003.2). </para> -<para> - The port part of a pattern is a decimal port number preceded by a colon - (<literal>:</literal>). If the domain part contains a numerical IPv6 address, - it has to be put into angle brackets - (<literal><</literal>, <literal>></literal>). -</para>
<variablelist> <varlistentry> @@ -3119,7 +2169,7 @@ for details. <para> is a domain-only pattern and will match any request to <literal>www.example.com</literal>, regardless of which document on that server is requested. So ALL pages in - this domain would be covered by the scope of this action. Note that a + this domain would be covered by the scope of this action. Note that a simple <literal>example.com</literal> is different and would NOT match. </para> </listitem> @@ -3161,37 +2211,11 @@ for details. </listitem> </varlistentry> <varlistentry> - <term><literal>/</literal></term> - <listitem> - <para> - Matches any URL because there's no requirement for either the - domain or the path to match anything. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>:8000/</literal></term> - <listitem> - <para> - Matches any URL pointing to TCP port 8000. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal><2001:db8::1>/</literal></term> - <listitem> - <para> - Matches any URL with the host address <literal>2001:db8::1</literal>. - (Note that the real URL uses plain brackets, not angle brackets.) - </para> - </listitem> - </varlistentry> - <varlistentry> <term><literal>index.html</literal></term> <listitem> <para> matches nothing, since it would be interpreted as a domain name and - there is no top-level domain called <literal>.html</literal>. So its + there is no top-level domain called <literal>.html</literal>. So its a mistake. </para> </listitem> @@ -3204,7 +2228,7 @@ for details.
<para> The matching of the domain part offers some flexible options: if the - domain starts or ends with a dot, it becomes unanchored at that end. + domain starts or ends with a dot, it becomes unanchored at that end. For example: </para>
@@ -3242,7 +2266,7 @@ for details. a domain.) This might be <literal>www.example.com</literal>, <literal>news.example.de</literal>, or <literal>www.example.net/cgi/testing.pl</literal> for instance. All these - cases are matched. + cases are matched. </para> </listitem> </varlistentry> @@ -3252,12 +2276,12 @@ for details. Additionally, there are wild-cards that you can use in the domain names themselves. These work similarly to shell globbing type wild-cards: <quote>*</quote> represents zero or more arbitrary characters (this is - equivalent to the + equivalent to the <ulink url="http://en.wikipedia.org/wiki/Regular_expressions"><quote>Regular Expression</quote></ulink> based syntax of <quote>.*</quote>), <quote>?</quote> represents any single character (this is equivalent to the regular expression syntax of a simple <quote>.</quote>), and you can define - <quote>character classes</quote> in square brackets which is similar to + <quote>character classes</quote> in square brackets which is similar to the same regular expression technique. All of this can be freely mixed: </para>
@@ -3266,7 +2290,7 @@ for details. <term><literal>ad*.example.com</literal></term> <listitem> <para> - matches <quote>adserver.example.com</quote>, + matches <quote>adserver.example.com</quote>, <quote>ads.example.com</quote>, etc but not <quote>sfads.example.com</quote> </para> </listitem> @@ -3284,7 +2308,7 @@ for details. <listitem> <para> matches <literal>www.ipix.com</literal>, - <literal>pictures.epix.com</literal>, <literal>a.b.c.d.e.upix.com</literal> etc. + <literal>pictures.epix.com</literal>, <literal>a.b.c.d.e.upix.com</literal> etc. </para> </listitem> </varlistentry> @@ -3292,9 +2316,9 @@ for details. <term><literal>www[1-9a-ez].example.c*</literal></term> <listitem> <para> - matches <literal>www1.example.com</literal>, - <literal>www4.example.cc</literal>, <literal>wwwd.example.cy</literal>, - <literal>wwwz.example.com</literal> etc., but <emphasis>not</emphasis> + matches <literal>www1.example.com</literal>, + <literal>www4.example.cc</literal>, <literal>wwwd.example.cy</literal>, + <literal>wwwz.example.com</literal> etc., but <emphasis>not</emphasis> <literal>wwww.example.com</literal>. </para> </listitem> @@ -3328,13 +2352,13 @@ for details.
<para> Note that the path pattern is automatically left-anchored at the <quote>/</quote>, - i.e. it matches as if it would start with a <quote>^</quote> (regular expression speak + i.e. it matches as if it would start with a <quote>^</quote> (regular expression speak for the beginning of a line). </para>
<para> Please also note that matching in the path is <emphasis>CASE INSENSITIVE</emphasis> - by default, but you can switch to case sensitive at any point in the pattern by using the + by default, but you can switch to case sensitive at any point in the pattern by using the <quote>(?-i)</quote> switch: <literal>www.example.com/(?-i)PaTtErN.*</literal> will match only documents whose path starts with <literal>PaTtErN</literal> in <emphasis>exactly</emphasis> this capitalization. @@ -3345,7 +2369,7 @@ for details. <term><literal>.example.com/.*</literal></term> <listitem> <para> - Is equivalent to just <quote>.example.com</quote>, since any documents + Is equivalent to just <quote>.example.com</quote>, since any documents within that domain are matched with or without the <quote>.*</quote> regular expression. This is redundant </para> @@ -3359,9 +2383,9 @@ for details. named <quote>index.html</quote>, and that is part of some path. For example, it matches <quote>www.example.com/testing/index.html</quote> but NOT <quote>www.example.com/index.html</quote> because the regular - expression called for at least two <quote>/'s</quote>, thus the path - requirement. It also would match - <quote>www.example.com/testing/index_html</quote>, because of the + expression called for at least two <quote>/'s</quote>, thus the path + requirement. It also would match + <quote>www.example.com/testing/index_html</quote>, because of the special meta-character <quote>.</quote>. </para> </listitem> @@ -3370,9 +2394,9 @@ for details. <term><literal>.example.com/(.*/)?index.html$</literal></term> <listitem> <para> - This regular expression is conditional so it will match any page - named <quote>index.html</quote> regardless of path which in this case can - have one or more <quote>/'s</quote>. And this one must contain exactly + This regular expression is conditional so it will match any page + named <quote>index.html</quote> regardless of path which in this case can + have one or more <quote>/'s</quote>. And this one must contain exactly <quote>.html</quote> (but does not have to end with that!). </para> </listitem> @@ -3382,7 +2406,7 @@ for details. <listitem> <para> This regular expression will match any path of <quote>example.com</quote> - that contains any of the words <quote>ads</quote>, <quote>banner</quote>, + that contains any of the words <quote>ads</quote>, <quote>banner</quote>, <quote>banners</quote> (because of the <quote>?</quote>) or <quote>junk</quote>. The path does not have to end in these words, just contain them. </para> @@ -3392,8 +2416,8 @@ for details. <term><literal>.example.com/(.*/)(ads|banners?|junk)/.*.(jpe?g|gif|png)$</literal></term> <listitem> <para> - This is very much the same as above, except now it must end in either - <quote>.jpg</quote>, <quote>.jpeg</quote>, <quote>.gif</quote> or <quote>.png</quote>. So this + This is very much the same as above, except now it must end in either + <quote>.jpg</quote>, <quote>.jpeg</quote>, <quote>.gif</quote> or <quote>.png</quote>. So this one is limited to common image formats. </para> </listitem> @@ -3401,7 +2425,7 @@ for details.
</variablelist> <para> - There are many, many good examples to be found in <filename>default.action</filename>, + There are many, many good examples to be found in <filename>default.action</filename>, and more tutorials below in <link linkend="regex">Appendix on regular expressions</link>. </para>
@@ -3491,23 +2515,23 @@ for details.
</para>
-<para> +<para> Again, actions are invoked by placing them on a line, enclosed in curly braces and - separated by whitespace, like in + separated by whitespace, like in <literal>{+some-action -some-other-action{some-parameter}}</literal>, followed by a list of URL patterns, one per line, to which they apply. Together, the actions line and the following pattern lines make up a section - of the actions file. + of the actions file. </para>
-<para> +<para> Actions fall into three categories: </para>
<para> <itemizedlist> <listitem> - <para> + <para> Boolean, i.e the action can only be <quote>enabled</quote> or <quote>disabled</quote>. Syntax: </para> @@ -3516,14 +2540,14 @@ for details. +<replaceable class="function">name</replaceable> # enable action <replaceable class="parameter">name</replaceable> -<replaceable class="function">name</replaceable> # disable action <replaceable class="parameter">name</replaceable></screen> </para> - <para> + <para> Example: <literal>+handle-as-image</literal> </para> </listitem>
<listitem> - <para> + <para> Parameterized, where some value is required in order to enable this type of action. Syntax: </para> @@ -3537,13 +2561,13 @@ for details. Note that if the URL matches multiple positive forms of a parameterized action, the last match wins, i.e. the params from earlier matches are simply ignored. </para> - <para> + <para> Example: <literal>+hide-user-agent{Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.8.1.4) Gecko/20070602 Firefox/2.0.0.4}</literal> </para> </listitem> - + <listitem> - <para> + <para> Multi-value. These look exactly like parameterized actions, but they behave differently: If the action applies multiple times to the same URL, but with different parameters, <emphasis>all</emphasis> the parameters @@ -3558,7 +2582,7 @@ for details. # If it was the last one left, disable the action. <replaceable class="parameter">-name</replaceable> # disable this action completely and remove all parameters from the list</screen> </para> - <para> + <para> Examples: <literal>+add-header{X-Fun-Header: Some text}</literal> and <literal>+filter{html-annoyances}</literal> </para> @@ -3577,8 +2601,8 @@ for details.
<para> Later defined action sections always over-ride earlier ones of the same type. - So exceptions to any rules you make, should come in the latter part of the file (or - in a file that is processed later when using multiple actions files such + So exceptions to any rules you make, should come in the latter part of the file (or + in a file that is processed later when using multiple actions files such as <filename>user.action</filename>). For multi-valued actions, the actions are applied in the order they are specified. Actions files are processed in the order they are defined in <filename>config</filename> (the default @@ -3630,7 +2654,7 @@ for details. <para>Multi-value.</para> </listitem> </varlistentry> - + <varlistentry> <term>Parameter:</term> <listitem> @@ -3641,19 +2665,16 @@ for details. </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> <para> - This action may be specified multiple times, in order to define multiple - headers. This is rarely needed for the typical user. If you don't know what - <quote>HTTP headers</quote> are, you definitely don't need to worry about this + This action may be specified multiple times, in order to define multiple + headers. This is rarely needed for the typical user. If you don't know what + <quote>HTTP headers</quote> are, you definitely don't need to worry about this one. </para> - <para> - Headers added by this action are not modified by other actions. - </para> </listitem> </varlistentry>
@@ -3691,10 +2712,10 @@ for details. the <literal><link linkend="handle-as-image">handle-as-image</link></literal>, <literal><link - linkend="set-image-blocker">set-image-blocker</link></literal>, and + linkend="set-image-blocker">set-image-blocker</link></literal>, and <literal><link linkend="handle-as-empty-document">handle-as-empty-document</link></literal> actions. - + </para> </listitem> </varlistentry> @@ -3713,7 +2734,7 @@ for details. <para>A block reason that should be given to the user.</para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -3724,18 +2745,18 @@ for details. to the blocked content (the latter only if the force feature is available and enabled). </para> - <para> - A very important exception occurs if <emphasis>both</emphasis> + <para> + A very important exception occurs if <emphasis>both</emphasis> <literal>block</literal> and <literal><link linkend="handle-as-image">handle-as-image</link></literal>, - apply to the same request: it will then be replaced by an image. If + apply to the same request: it will then be replaced by an image. If <literal><link linkend="set-image-blocker">set-image-blocker</link></literal> (see below) also applies, the type of image will be determined by its parameter, if not, the standard checkerboard pattern is sent. </para> <para> - It is important to understand this process, in order - to understand how <application>Privoxy</application> deals with - ads and other unwanted content. Blocking is a core feature, and one + It is important to understand this process, in order + to understand how <application>Privoxy</application> deals with + ads and other unwanted content. Blocking is a core feature, and one upon which various other features depend. </para> <para> @@ -3756,12 +2777,12 @@ for details. # Block and replace with "blocked" page .nasty-stuff.example.com
-{+block{Doubleclick banners.} +handle-as-image} +{+block{Doubleclick banners.} +handle-as-image} # Block and replace with image .ad.doubleclick.net .ads.r.us/banners/
-{+block{Layered ads.} +handle-as-empty-document} +{+block{Layered ads.} +handle-as-empty-document} # Block and then ignore adserver.example.net/.*.js$</screen> </para> @@ -3819,7 +2840,7 @@ for details. </itemizedlist> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -3884,7 +2905,7 @@ for details. </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -3949,7 +2970,7 @@ for details. <para> Client headers to which this action applies are filtered on-the-fly through the specified regular expression based substitutions, the result is used as - tag. + tag. </para> </listitem> </varlistentry> @@ -3971,7 +2992,7 @@ for details. </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -4056,11 +3077,11 @@ TAG:^User-Agent: MPlayer/ <term>Parameter:</term> <listitem> <para> - Any string. - </para> + Any string. + </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -4069,7 +3090,7 @@ TAG:^User-Agent: MPlayer/ browser to decide what to do with the document. The value of this header can cause the browser to open a download menu instead of displaying the document by itself, even if the document's format is - supported by the browser. + supported by the browser. </para> <para> The declared content type can also affect which rendering mode @@ -4083,13 +3104,13 @@ TAG:^User-Agent: MPlayer/ <quote>Content-Type: text/html</quote>, you can use &my-app; to overwrite it with <quote>application/xml</quote> and validate the web master's claim inside your XHTML-supporting browser. - If the syntax is incorrect, the browser will complain loudly. + If the syntax is incorrect, the browser will complain loudly. </para> <para> You can also go the opposite direction: if your browser prints error messages instead of rendering a document falsely declared as XHTML, you can overwrite the content type with - <quote>text/html</quote> and have it rendered as broken HTML document. + <quote>text/html</quote> and have it rendered as broken HTML document. </para> <para> By default <literal>content-type-overwrite</literal> only replaces @@ -4107,7 +3128,7 @@ TAG:^User-Agent: MPlayer/ <para> Of course you can apply <literal>content-type-overwrite</literal> to a whole site and then make URL based exceptions, but it's a lot - more work to get the same precision. + more work to get the same precision. </para> </listitem> </varlistentry> @@ -4169,10 +3190,10 @@ new action <listitem> <para> Any string. - </para> + </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -4205,7 +3226,7 @@ new action <term>Example usage (section):</term> <listitem> <para> - <screen># Block the non-existent "Privacy-Violation:" client header + <screen># Block the non-existent "Privacy-Violation:" client header { +crunch-client-header{Privacy-Violation:} } / </screen> @@ -4252,10 +3273,10 @@ new action <listitem> <para> N/A - </para> + </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -4339,7 +3360,7 @@ new action </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -4352,7 +3373,7 @@ new action <para> It makes <emphasis>no sense at all</emphasis> to use this action in conjunction with the <literal><link linkend="session-cookies-only">session-cookies-only</link></literal> action, - since it would prevent the session cookies from being set. See also + since it would prevent the session cookies from being set. See also <literal><link linkend="filter-content-cookies">filter-content-cookies</link></literal>. </para> </listitem> @@ -4406,10 +3427,10 @@ new action <listitem> <para> Any string. - </para> + </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -4490,7 +3511,7 @@ new action </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -4558,7 +3579,7 @@ new action </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -4626,26 +3647,16 @@ new action </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> <para> This is a left-over from the time when <application>Privoxy</application> didn't support important HTTP/1.1 features well. It is left here for the - unlikely case that you experience HTTP/1.1-related problems with some server - out there. - </para> - <para> - Note that enabling this action is only a workaround. It should not - be enabled for sites that work without it. While it shouldn't break - any pages, it has an (usually negative) performance impact. - </para> - <para> - If you come across a site where enabling this action helps, please report it, - so the cause of the problem can be analyzed. If the problem turns out to be - caused by a bug in <application>Privoxy</application> it should be - fixed so the following release works without the work around. + unlikely case that you experience HTTP/1.1 related problems with some server + out there. Not all HTTP/1.1 features and requirements are supported yet, + so there is a chance you might need this action. </para> </listitem> </varlistentry> @@ -4716,7 +3727,7 @@ problem-host.example.com</screen> <varlistentry> <term>Notes:</term> <listitem> - <para> + <para> Many sites, like yahoo.com, don't just link to other sites. Instead, they will link to some script on their own servers, giving the destination as a parameter, which will then redirect you to the final target. URLs @@ -4734,7 +3745,7 @@ problem-host.example.com</screen> <para> This feature is currently not very smart and is scheduled for improvement. If it is enabled by default, you will have to create some exceptions to - this action. It can lead to failures in several ways: + this action. It can lead to failures in several ways: </para> <para> Not every URLs with other URLs as parameters is evil. @@ -4775,7 +3786,7 @@ problem-host.example.com</screen> <para> <screen> { +fast-redirects{simple-check} } - one.example.com + one.example.com
{ +fast-redirects{check-decoded-url} } another.example.com/testing</screen> @@ -4795,7 +3806,7 @@ problem-host.example.com</screen> <varlistentry> <term>Typical use:</term> <listitem> - <para>Get rid of HTML and JavaScript annoyances, banner advertisements (by size), + <para>Get rid of HTML and JavaScript annoyances, banner advertisements (by size), do fun text replacements, add personalized effects, etc.</para> </listitem> </varlistentry> @@ -4820,17 +3831,17 @@ problem-host.example.com</screen> <para>Parameterized.</para> </listitem> </varlistentry> - + <varlistentry> <term>Parameter:</term> <listitem> <para> The name of a content filter, as defined in the <link linkend="filter-file">filter file</link>. - Filters can be defined in one or more files as defined by the + Filters can be defined in one or more files as defined by the <literal><link linkend="filterfile">filterfile</link></literal> - option in the <link linkend="config">config file</link>. - <filename>default.filter</filename> is the collection of filters - supplied by the developers. Locally defined filters should go + option in the <link linkend="config">config file</link>. + <filename>default.filter</filename> is the collection of filters + supplied by the developers. Locally defined filters should go in their own file, such as <filename>user.filter</filename>. </para> <para> @@ -4839,39 +3850,38 @@ problem-host.example.com</screen> </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> <para> - For your convenience, there are a number of pre-defined filters available + For your convenience, there are a number of pre-defined filters available in the distribution filter file that you can use. See the examples below for a list. </para> <para> Filtering requires buffering the page content, which may appear to slow down page rendering since nothing is displayed until all content has - passed the filters. (The total time until the page is completely rendered - doesn't change much, but it may be perceived as slower since the page is - not incrementally displayed.) - This effect will be more noticeable on slower connections. + passed the filters. (It does not really take longer, but seems that way + since the page is not incrementally displayed.) This effect will be more + noticeable on slower connections. </para> <para> <quote>Rolling your own</quote> - filters requires a knowledge of + filters requires a knowledge of <ulink url="http://en.wikipedia.org/wiki/Regular_expressions"><quote>Regular - Expressions</quote></ulink> and + Expressions</quote></ulink> and <ulink url="http://en.wikipedia.org/wiki/Html"><quote>HTML</quote></ulink>. - This is very powerful feature, and potentially very intrusive. + This is very powerful feature, and potentially very intrusive. Filters should be used with caution, and where an equivalent <quote>action</quote> is not available. </para> <para> - The amount of data that can be filtered is limited to the + The amount of data that can be filtered is limited to the <literal><link linkend="buffer-limit">buffer-limit</link></literal> - option in the main <link linkend="config">config file</link>. The + option in the main <link linkend="config">config file</link>. The default is 4096 KB (4 Megs). Once this limit is exceeded, the buffered - data, and all pending data, is passed through unfiltered. + data, and all pending data, is passed through unfiltered. </para> <para> Inappropriate MIME types, such as zipped files, are not filtered at all. @@ -4882,10 +3892,10 @@ problem-host.example.com</screen> by defining appropriate <literal>-filter</literal> exceptions. </para> <para> - Compressed content can't be filtered either, but if &my-app; - is compiled with zlib support and a supported compression algorithm - is used (gzip or deflate), &my-app; can first decompress the content - and then filter it. + Compressed content can't be filtered either, unless &my-app; + is compiled with zlib support (requires at least &my-app; 3.0.7), + in which case &my-app; will decompress the content before filtering + it. </para> <para> If you use a &my-app; version without zlib support, but want filtering to work on @@ -4894,11 +3904,11 @@ problem-host.example.com</screen> action in conjunction with <literal>filter</literal>. </para> <para> - Content filtering can achieve some of the same effects as the + Content filtering can achieve some of the same effects as the <literal><link linkend="block">block</link></literal> - action, i.e. it can be used to block ads and banners. But the mechanism - works quite differently. One effective use, is to block ad banners - based on their size (see below), since many of these seem to be somewhat + action, i.e. it can be used to block ads and banners. But the mechanism + works quite differently. One effective use, is to block ad banners + based on their size (see below), since many of these seem to be somewhat standardized. </para> <para> @@ -4916,7 +3926,7 @@ problem-host.example.com</screen>
<varlistentry> <term>Example usage (with filters from the distribution <filename>default.filter</filename> file). - See <link linkend="PREDEFINED-FILTERS">the Predefined Filters section</link> for + See <link linkend="PREDEFINED-FILTERS">the Predefined Filters section</link> for more explanation on each:</term> <listitem> <para> @@ -5048,7 +4058,7 @@ new action <listitem> <para> Declares a document as text, even if the <quote>Content-Type:</quote> isn't detected as such. - </para> + </para> </listitem> </varlistentry>
@@ -5080,7 +4090,7 @@ new action <literal>force-text-mode</literal> declares a document as text, without looking at the <quote>Content-Type:</quote> first. </para> - <warning> + <warning> <para> Think twice before activating this action. Filtering binary data with regular expressions can cause file damage. @@ -5088,7 +4098,7 @@ new action </warning> </listitem> </varlistentry> - + <varlistentry> <term>Example usage:</term> <listitem> @@ -5122,7 +4132,7 @@ new action <listitem> <para> Overrules the forward directives in the configuration file. - </para> + </para> </listitem> </varlistentry>
@@ -5176,7 +4186,7 @@ new action file, but without the URL pattern. It can be used as replacement, but normally it's only used in cases where matching based on the request URL isn't sufficient. </para> - <warning> + <warning> <para> Please read the description for the <link linkend="forwarding">forward</link> directives before using this action. Forwarding to the wrong people will reduce your privacy and increase the @@ -5194,7 +4204,7 @@ new action </warning> </listitem> </varlistentry> - + <varlistentry> <term>Example usage:</term> <listitem> @@ -5288,7 +4298,7 @@ new action <listitem> <para> <screen># Block all documents on example.org that end with ".js", -# but send an empty document instead of the usual HTML message. +# but send an empty document instead of the usual HTML message. {+block{Blocked JavaScript} +handle-as-empty-document} example.org/.*.js$ </screen> @@ -5341,14 +4351,14 @@ example.org/.*.js$ </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> <para> The below generic example section is actually part of <filename>default.action</filename>. It marks all URLs with well-known image file name extensions as images and should - be left intact. + be left intact. </para> <para> Users will probably only want to use the handle-as-image action in conjunction with @@ -5422,10 +4432,10 @@ new action <listitem> <para> Keyword: <quote>block</quote>, or any user defined value. - </para> + </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -5451,7 +4461,7 @@ new action to a rare language, you should consider that it helps to make your requests unique and thus easier to trace. If you don't plan to change this header frequently, - you should stick to a common language. + you should stick to a common language. </para> </listitem> </varlistentry> @@ -5508,10 +4518,10 @@ new action <listitem> <para> Keyword: <quote>block</quote>, or any user defined value. - </para> + </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -5580,7 +4590,7 @@ new action <term>Effect:</term> <listitem> <para> - Deletes the <quote>If-Modified-Since:</quote> HTTP client header or modifies its value. + Deletes the <quote>If-Modified-Since:</quote> HTTP client header or modifies its value. </para> </listitem> </varlistentry> @@ -5598,10 +4608,10 @@ new action <listitem> <para> Keyword: <quote>block</quote>, or a user defined value that specifies a range of hours. - </para> + </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -5689,12 +4699,12 @@ new action </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> <para> - The keyword <quote>block</quote> will completely remove the header + The keyword <quote>block</quote> will completely remove the header (not to be confused with the <literal><link linkend="block">block</link></literal> action). </para> @@ -5775,7 +4785,7 @@ new action </itemizedlist> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -5804,12 +4814,12 @@ new action will work with referrer checks, as long as content and valid referring page are on the same host. Most of the time that's the case. </para> - <para> + <para> <literal>hide-referer</literal> is an alternate spelling of <literal>hide-referrer</literal> and the two can be can be freely substituted with each other. (<quote>referrer</quote> is the correct English spelling, however the HTTP specification has a bug - it - requires it to be spelled as <quote>referer</quote>.) + requires it to be spelled as <quote>referer</quote>.) </para> </listitem> </varlistentry> @@ -5865,16 +4875,16 @@ new action </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> - <warning> + <warning> <para> This can lead to problems on web sites that depend on looking at this header in order to customize their content for different browsers (which, by the way, is <emphasis>NOT</emphasis> the right thing to do: good web sites - work browser-independently). + work browser-independently). </para> </warning> <para> @@ -5883,14 +4893,17 @@ new action <emphasis>not recommended</emphasis>. In single-user, single-browser setups, you might use it to delete your OS version information from the headers, because it is an invitation to exploit known bugs for your - OS. It is also occasionally useful to forge this in order to access - sites that won't let you in otherwise (though there may be a good - reason in some cases). + OS. It is also occasionally useful to forge this in order to access + sites that won't let you in otherwise (though there may be a good + reason in some cases). Example of this: some MSN sites will not + let <application>Mozilla</application> enter, yet forging to a + <application>Netscape 6.1</application> user-agent works just fine. + (Must be just a silly MS goof, I'm sure :-). </para> <para> - More information on known user-agent strings can be found at + More information on known user-agent strings can be found at <ulink url="http://www.user-agents.org/">http://www.user-agents.org/</ulink> - and + and <ulink url="http://en.wikipedia.org/wiki/User_agent">http://en.wikipedia.org/wiki/User_agent</ulink>. </para> </listitem> @@ -5946,7 +4959,7 @@ new action </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -6029,7 +5042,7 @@ new action </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -6049,7 +5062,7 @@ new action <para> Most text-based instances compress very well, the size is seldom decreased by less than 50%, for markup-heavy instances like news feeds saving more than 90% of the original size isn't - unusual. + unusual. </para> <para> Not using compression will therefore slow down the transfer, and you should only @@ -6114,7 +5127,7 @@ new action <term>Effect:</term> <listitem> <para> - Deletes the <quote>Last-Modified:</quote> HTTP server header or modifies its value. + Deletes the <quote>Last-Modified:</quote> HTTP server header or modifies its value. </para> </listitem> </varlistentry> @@ -6133,10 +5146,10 @@ new action <para> One of the keywords: <quote>block</quote>, <quote>reset-to-request-time</quote> and <quote>randomize</quote> - </para> + </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -6152,7 +5165,7 @@ new action between the original value and the current time. In theory the server could send each document with a different <quote>Last-Modified:</quote> header to track visits without using cookies. <quote>Randomize</quote> - makes it impossible and the browser can still revalidate cached documents. + makes it impossible and the browser can still revalidate cached documents. </para> <para> <quote>reset-to-request-time</quote> overwrites the value of the @@ -6168,7 +5181,7 @@ new action of the request, the random range becomes zero and the value stays the same. Therefore you should later randomize it a second time with <literal><link linkend="hide-if-modified-since">hided-if-modified-since</link></literal>, - just to be sure. + just to be sure. </para> <para> It is also recommended to use this action together with @@ -6235,7 +5248,7 @@ new action </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -6344,7 +5357,7 @@ www.privoxy.org/user-manual/</screen> </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -6427,7 +5440,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> @@ -6478,7 +5491,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not <listitem> <para> Allow only temporary <quote>session</quote> cookies (for the current - browser session <emphasis>only</emphasis>). + browser session <emphasis>only</emphasis>). </para> </listitem> </varlistentry> @@ -6510,12 +5523,12 @@ example.org/instance-that-is-delivered-as-xml-but-is-not </para> </listitem> </varlistentry> - + <varlistentry> <term>Notes:</term> <listitem> <para> - This is less strict than <literal><link linkend="crunch-incoming-cookies">crunch-incoming-cookies</link></literal> / + This is less strict than <literal><link linkend="crunch-incoming-cookies">crunch-incoming-cookies</link></literal> / <literal><link linkend="crunch-outgoing-cookies">crunch-outgoing-cookies</link></literal> and allows you to browse websites that insist or rely on setting cookies, without compromising your privacy too badly. </para> @@ -6523,7 +5536,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not Most browsers will not permanently store cookies that have been processed by <literal>session-cookies-only</literal> and will forget about them between sessions. This makes profiling cookies useless, but won't break sites which require cookies so - that you can log in for transactions. This is generally turned on for all + that you can log in for transactions. This is generally turned on for all sites, and is the recommended setting. </para> <para> @@ -6542,9 +5555,9 @@ example.org/instance-that-is-delivered-as-xml-but-is-not These would have to be removed manually. </para> <para> - <application>Privoxy</application> also uses - the <link linkend="filter-content-cookies">content-cookies filter</link> - to block some types of cookies. Content cookies are not effected by + <application>Privoxy</application> also uses + the <link linkend="filter-content-cookies">content-cookies filter</link> + to block some types of cookies. Content cookies are not effected by <literal>session-cookies-only</literal>. </para> </listitem> @@ -6618,7 +5631,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not <para> <quote><replaceable class="parameter">target-url</replaceable></quote> to send a redirect to <replaceable class="parameter">target-url</replaceable>. You can redirect - to any image anywhere, even in your local filesystem via <quote>file:///</quote> URL. + to any image anywhere, even in your local filesystem via <quote>file:///</quote> URL. (But note that not all browsers support redirecting to a local file system). </para> <para> @@ -6681,8 +5694,8 @@ example.org/instance-that-is-delivered-as-xml-but-is-not <title>Summary</title> <para> Note that many of these actions have the potential to cause a page to - misbehave, possibly even not to display at all. There are many ways - a site designer may choose to design his site, and what HTTP header + misbehave, possibly even not to display at all. There are many ways + a site designer may choose to design his site, and what HTTP header content, and other criteria, he may depend on. There is no way to have hard and fast rules for all sites. See the <link linkend="ACTIONSANAT">Appendix</link> for a brief example on troubleshooting @@ -6700,7 +5713,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not These can in turn be invoked just like the built-in actions. Currently, an alias name can contain any character except space, tab, <quote>=</quote>, - <quote>{</quote> and <quote>}</quote>, but we <emphasis>strongly + <quote>{</quote> and <quote>}</quote>, but we <emphasis>strongly recommend</emphasis> that you only use <quote>a</quote> to <quote>z</quote>, <quote>0</quote> to <quote>9</quote>, <quote>+</quote>, and <quote>-</quote>. Alias names are not case sensitive, and are not required to start with a @@ -6767,7 +5780,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not </para>
<para> - ...and put them to use. These sections would appear in the lower part of an + ...and put them to use. These sections would appear in the lower part of an actions file and define exceptions to the default actions (as specified further up for the <quote>/</quote> pattern): </para> @@ -6785,7 +5798,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not
# Shopping sites: # Allow cookies (for setting and retrieving your customer data) - # + # {shop} .quietpc.com .worldpay.com # for quietpc.com @@ -6799,8 +5812,8 @@ example.org/instance-that-is-delivered-as-xml-but-is-not </para>
<para> - Aliases like <quote>shop</quote> and <quote>fragile</quote> are typically used for - <quote>problem</quote> sites that require more than one action to be disabled + Aliases like <quote>shop</quote> and <quote>fragile</quote> are typically used for + <quote>problem</quote> sites that require more than one action to be disabled in order to function properly. </para> </sect2> @@ -6845,7 +5858,7 @@ hal stop here preceding the action name enables the action, a <quote>-</quote> disables!). Also note how this long line has been made more readable by splitting it into multiple lines with line continuation. -</para> +</para>
<para> <screen> @@ -6948,13 +5961,13 @@ mail.google.com</screen> require cookies to log in, and pop-up windows for shopping carts or item details. Again, we'll use a pre-defined alias: </para> - + <para> <screen> # Shopping sites: # { shop } -.quietpc.com +.quietpc.com .worldpay.com # for quietpc.com .jungle.com .scan.co.uk</screen> @@ -7023,7 +6036,7 @@ edit.*.yahoo.com # Known ad generators: # { +block-as-image } -ar.atwola.com +ar.atwola.com .ad.doubleclick.net .ad.*.doubleclick.net .a.yimg.com/(?:(?!/i/).)*$ @@ -7058,7 +6071,7 @@ bs*.gsanet.com { <link linkend="BLOCK">+block{Banner ads.}</link> }
# Generic patterns: -# +# ad*. .*ads. banner?. @@ -7079,7 +6092,7 @@ count*. </para> <para> But being very generic, they necessarily also catch URLs that we don't want - to block. The pattern <literal>.*ads.</literal> e.g. catches + to block. The pattern <literal>.*ads.</literal> e.g. catches <quote>nasty-<emphasis>ads</emphasis>.nasty-corp.com</quote> as intended, but also <quote>downlo<emphasis>ads</emphasis>.sourcefroge.net</quote> or <quote><emphasis>ads</emphasis>l.some-provider.net.</quote> So here come some @@ -7106,7 +6119,7 @@ count*. ##########################################################################
# By domain: -# +# { -<link linkend="BLOCK">block</link> } adv[io]*. # (for advogato.org and advice.*) adsl. # (has nothing to do with ads) @@ -7156,13 +6169,13 @@ wiki.
<para> So far we are painting with a broad brush by setting general policies, - which would be a reasonable starting point for many people. Now, + which would be a reasonable starting point for many people. Now, you might want to be more specific and have customized rules that are more suitable to your personal habits and preferences. These would be for narrowly defined situations like your ISP or your bank, and should - be placed in <filename>user.action</filename>, which is parsed after all other + be placed in <filename>user.action</filename>, which is parsed after all other actions files and hence has the last word, over-riding any previously - defined actions. <filename>user.action</filename> is also a + defined actions. <filename>user.action</filename> is also a <emphasis>safe</emphasis> place for your personal settings, since <filename>default.action</filename> is actively maintained by the <application>Privoxy</application> developers and you'll probably want @@ -7171,7 +6184,7 @@ wiki.
<para> So let's look at a few examples of things that one might typically do in - <filename>user.action</filename>: + <filename>user.action</filename>: </para>
@@ -7194,8 +6207,8 @@ wiki. # (Re-)define aliases for this file: # {{alias}} -# -# These aliases just save typing later, and the alias names should +# +# These aliases just save typing later, and the alias names should # be self explanatory. # +crunch-all-cookies = +crunch-incoming-cookies +crunch-outgoing-cookies @@ -7226,7 +6239,7 @@ handle-as-text = -<link linkend="FILTER">filter</link> +-<link linkend="content- you don't want to have to log in manually each time. So you'd like to allow persistent cookies for these sites. The <literal>allow-all-cookies</literal> alias defined above does exactly - that, i.e. it disables crunching of cookies in any direction, and the + that, i.e. it disables crunching of cookies in any direction, and the processing of cookies to make them only temporary. </para>
@@ -7271,7 +6284,7 @@ stupid-server.example.com/</screen> Example of a simple <link linkend="BLOCK">block</link> action. Say you've seen an ad on your favourite page on example.com that you want to get rid of. You have right-clicked the image, selected <quote>copy image location</quote> - and pasted the URL below while removing the leading http://, into a + and pasted the URL below while removing the leading http://, into a <literal>{ +block{} }</literal> section. Note that <literal>{ +handle-as-image }</literal> need not be specified, since all URLs ending in <literal>.gif</literal> will be tagged as images by the general rules as set @@ -7289,7 +6302,7 @@ stupid-server.example.com/</screen> The URLs of dynamically generated banners, especially from large banner farms, often don't use the well-known image file name extensions, which makes it impossible for <application>Privoxy</application> to guess - the file type just by looking at the URL. + the file type just by looking at the URL. You can use the <literal>+block-as-image</literal> alias defined above for these cases. Note that objects which match this rule but then turn out NOT to be an @@ -7314,7 +6327,7 @@ stupid-server.example.com/</screen> -- <emphasis>whoa!</emphasis> -- it worked. The <literal>fragile</literal> aliases disables those actions that are most likely to break a site. Also, good for testing purposes to see if it is <application>Privoxy</application> - that is causing the problem or not. We later find other regular sites + that is causing the problem or not. We later find other regular sites that misbehave, and add those to our personalized list of troublemakers: </para>
@@ -7359,19 +6372,19 @@ stupid-server.example.com/</screen> { allow-ads } .sourceforge.net .slashdot.org - .osdn.net</screen> + .osdn.net</screen> </para>
<para> - Note that <literal>allow-ads</literal> has been aliased to - <literal>-<link linkend="block">block</link></literal>, - <literal>-<link linkend="filter-banners-by-size">filter{banners-by-size}</link></literal>, and + Note that <literal>allow-ads</literal> has been aliased to + <literal>-<link linkend="block">block</link></literal>, + <literal>-<link linkend="filter-banners-by-size">filter{banners-by-size}</link></literal>, and <literal>-<link linkend="filter-banners-by-link">filter{banners-by-link}</link></literal> above. </para>
<para> Invoke another alias here to force an over-ride of the MIME type <literal> - application/x-sh</literal> which typically would open a download type + application/x-sh</literal> which typically would open a download type dialog. In my case, I want to look at the shell script, and then I can save it should I choose to. </para> @@ -7379,7 +6392,7 @@ stupid-server.example.com/</screen> <para> <screen> { handle-as-text } - /.*.sh$</screen> + /.*.sh$</screen> </para>
<para> @@ -7414,7 +6427,7 @@ stupid-server.example.com/</screen>
<para> On-the-fly text substitutions need - to be defined in a <quote>filter file</quote>. Once defined, they + to be defined in a <quote>filter file</quote>. Once defined, they can then be invoked as an <quote>action</quote>. </para>
@@ -7468,7 +6481,7 @@ stupid-server.example.com/</screen>
<para> Substitutions are made at the source level, so if you want to <quote>roll - your own</quote> filters, you should first be familiar with HTML syntax, + your own</quote> filters, you should first be familiar with HTML syntax, and, of course, regular expressions. </para>
@@ -7478,7 +6491,7 @@ stupid-server.example.com/</screen> here. Each filter consists of a heading line, that starts with one of the <emphasis>keywords</emphasis> <literal>FILTER:</literal>, <literal>CLIENT-HEADER-FILTER:</literal> or <literal>SERVER-HEADER-FILTER:</literal> - followed by the filter's <emphasis>name</emphasis>, and a short (one line) + followed by the filter's <emphasis>name</emphasis>, and a short (one line) <emphasis>description</emphasis> of what it does. Below that line come the <emphasis>jobs</emphasis>, i.e. lines that define the actual text substitutions. By convention, the name of a filter @@ -7493,7 +6506,7 @@ stupid-server.example.com/</screen> +<literal><link linkend="filter">filter</link>{<replaceable>name</replaceable>}</literal> in any <link linkend="actions-file">actions file</link>. </para> - + <para> Filter definitions start with a header line that contains the filter type, the filter name and the filter description. @@ -7517,13 +6530,13 @@ stupid-server.example.com/</screen> </para>
<para> - If you are new to + If you are new to <ulink url="http://en.wikipedia.org/wiki/Regular_expressions"><quote>Regular Expressions</quote></ulink>, you might want to take a look at the <link linkend="regex">Appendix on regular expressions</link>, and see the <ulink url="http://perldoc.perl.org/perlre.html">Perl manual</ulink> for - <ulink url="http://perldoc.perl.org/perlop.html">the + <ulink url="http://perldoc.perl.org/perlop.html">the <literal>s///</literal> operator's syntax</ulink> and <ulink url="http://perldoc.perl.org/perlre.html">Perl-style regular expressions</ulink> in general. @@ -7638,7 +6651,7 @@ s|(<script.*)document.referrer(.*</script>)|$1"Not Your Business!"$2|U <para> Now the pattern is deciphered, but wasn't this about substituting things? So lets look at the substitute: <literal>$1"Not Your Business!"$2</literal> is - easy to read: The text remembered as <literal>$1</literal>, followed by + easy to read: The text remembered as <literal>$1</literal>, followed by <literal>"Not Your Business!"</literal> (<emphasis>including</emphasis> the quotation marks!), followed by the text remembered as <literal>$2</literal>. This produces an exact copy of the original string, with the middle part @@ -7705,7 +6718,7 @@ s/(<body [^>]*)onunload(.*>)/$1never$2/iU</screen> Note that the <literal>i</literal> option makes the pattern matching case-insensitive. Also note that ungreedy matching alone doesn't always guarantee a minimal match: In the first parenthesis, we had to use <literal>[^>]*</literal> - instead of <literal>.*</literal> to prevent the match from exceeding the + instead of <literal>.*</literal> to prevent the match from exceeding the <body> tag if it doesn't contain <quote>OnUnload</quote>, but the page's content does. </para> @@ -7725,7 +6738,7 @@ s/microsoft(?!.com)/MicroSuck/ig</screen>
<para> Note the <literal>(?!.com)</literal> part (a so-called negative lookahead) - in the job's pattern, which means: Don't match, if the string + in the job's pattern, which means: Don't match, if the string <quote>.com</quote> appears directly following <quote>microsoft</quote> in the page. This prevents links to microsoft.com from being trashed, while still replacing the word everywhere else. @@ -7751,7 +6764,7 @@ s* industry[ -]leading \
<para> The <literal>x</literal> option in this job turns on extended syntax, and allows for - e.g. the liberal use of (non-interpreted!) whitespace for nicer formatting. + e.g. the liberal use of (non-interpreted!) whitespace for nicer formatting. </para>
<para> @@ -7763,11 +6776,11 @@ s* industry[ -]leading \
<sect2 id="predefined-filters"><title>The Pre-defined Filters</title>
-<!-- +<!--
Note each filter is also listed in the +filter action section above. Please keep these listings in sync. - + -->
<para> @@ -7807,12 +6820,12 @@ pre-defined filters for your convenience: </itemizedlist> </para> <para> - Use with caution. This is an aggressive filter, and can break sites that + Use with caution. This is an aggressive filter, and can break sites that rely heavily on JavaScript. </para> </listitem> </varlistentry> - + <varlistentry> <term><emphasis>js-events</emphasis></term> <listitem> @@ -7836,7 +6849,7 @@ pre-defined filters for your convenience: This filter will undo many common instances of HTML based abuse. </para> <para> - The <literal>BLINK</literal> and <literal>MARQUEE</literal> tags + The <literal>BLINK</literal> and <literal>MARQUEE</literal> tags are neutralized (yeah baby!), and browser windows will be created as resizeable (as of course they should be!), and will have location, scroll and menu bars -- even if specified otherwise. @@ -7857,9 +6870,9 @@ pre-defined filters for your convenience: </para> <para> This filter disables most HTML and JavaScript code that reads or sets - cookies. It cannot detect all clever uses of these types of code, so it + cookies. It cannot detect all clever uses of these types of code, so it should not be relied on as an absolute fix. Use it wherever you would also - use the cookie crunch actions. + use the cookie crunch actions. </para> </listitem> </varlistentry> @@ -7868,8 +6881,8 @@ pre-defined filters for your convenience: <term><emphasis>refresh tags</emphasis></term> <listitem> <para> - Disable any refresh tags if the interval is greater than nine seconds (so - that redirections done via refresh tags are not destroyed). This is useful + Disable any refresh tags if the interval is greater than nine seconds (so + that redirections done via refresh tags are not destroyed). This is useful for dial-on-demand setups, or for those who find this HTML feature annoying. </para> @@ -7880,9 +6893,9 @@ pre-defined filters for your convenience: <term><emphasis>unsolicited-popups</emphasis></term> <listitem> <para> - This filter attempts to prevent only <quote>unsolicited</quote> pop-up - windows from opening, yet still allow pop-up windows that the user - has explicitly chosen to open. It was added in version 3.0.1, + This filter attempts to prevent only <quote>unsolicited</quote> pop-up + windows from opening, yet still allow pop-up windows that the user + has explicitly chosen to open. It was added in version 3.0.1, as an improvement over earlier such filters. </para> <para> @@ -7893,7 +6906,7 @@ pre-defined filters for your convenience: </para> <para> This is recommended only for browsers that cannot perform this function - reliably themselves. And be aware that some sites require such windows + reliably themselves. And be aware that some sites require such windows in order to function normally. Use with caution. </para> </listitem> @@ -7926,7 +6939,7 @@ pre-defined filters for your convenience: <term><emphasis>banners-by-size</emphasis></term> <listitem> <para> - This filter removes image tags purely based on what size they are. Fortunately + This filter removes image tags purely based on what size they are. Fortunately for us, many ads and banner images tend to conform to certain standardized sizes, which makes this filter quite effective for ad stripping purposes. </para> @@ -7935,7 +6948,7 @@ pre-defined filters for your convenience: but just happen to be of one of the standard banner sizes. </para> <para> - Recommended only for those who require extreme ad blocking. The default + Recommended only for those who require extreme ad blocking. The default block rules should catch 95+% of all ads <emphasis>without</emphasis> this filter enabled. </para> </listitem> @@ -7945,7 +6958,7 @@ pre-defined filters for your convenience: <term><emphasis>banners-by-link</emphasis></term> <listitem> <para> - This is an experimental filter that attempts to kill any banners if + This is an experimental filter that attempts to kill any banners if their URLs seem to point to known or suspected click trackers. It is currently not of much value and is not recommended for use by default. </para> @@ -7956,7 +6969,7 @@ pre-defined filters for your convenience: <term><emphasis>webbugs</emphasis></term> <listitem> <para> - Webbugs are small, invisible images (technically 1X1 GIF images), that + Webbugs are small, invisible images (technically 1X1 GIF images), that are used to track users across websites, and collect information on them. As an HTML page is loaded by the browser, an embedded image tag causes the browser to contact a third-party site, disclosing the tracking information @@ -7975,7 +6988,7 @@ pre-defined filters for your convenience: <listitem> <para> A rather special-purpose filter that can be used to enlarge textareas (those - multi-line text boxes in web forms) and turn off hard word wrap in them. + multi-line text boxes in web forms) and turn off hard word wrap in them. It was written for the sourceforge.net tracker system where such boxes are a nuisance, but it can be handy on other sites, too. </para> @@ -8019,20 +7032,20 @@ pre-defined filters for your convenience: <para> Many Microsoft products that generate HTML use non-standard extensions (read: violations) of the ISO 8859-1 aka Latin-1 character set. This can cause those - HTML documents to display with errors on standard-compliant platforms. + HTML documents to display with errors on standard-compliant platforms. </para> <para> - This filter translates the MS-only characters into Latin-1 equivalents. - It is not necessary when using MS products, and will cause corruption of + This filter translates the MS-only characters into Latin-1 equivalents. + It is not necessary when using MS products, and will cause corruption of all documents that use 8-bit character sets other than Latin-1. It's mostly worthwhile for Europeans on non-MS platforms, if weird garbage characters - sometimes appear on some pages, or user agents that don't correct for this on + sometimes appear on some pages, or user agents that don't correct for this on the fly. <!-- My version of Mozilla (ancient) shows litte square boxes for quote characters, and apostrophes on moronized pages. So many pages have this, I can read them fine now. HB 08/27/06 ---> +--> </para> </listitem> </varlistentry> @@ -8042,7 +7055,7 @@ pre-defined filters for your convenience: <listitem> <para> A filter for shockwave haters. As the name suggests, this filter strips code - out of web pages that is used to embed shockwave flash objects. + out of web pages that is used to embed shockwave flash objects. </para> <para> </para> @@ -8118,12 +7131,12 @@ pre-defined filters for your convenience: </para> </listitem> </varlistentry> - + <varlistentry> <term><emphasis>yahoo</emphasis></term> <listitem> <para> - Another CSS based block, this time for Yahoo text ads. And removes + Another CSS based block, this time for Yahoo text ads. And removes a width limitation as well. </para> </listitem> @@ -8133,7 +7146,7 @@ pre-defined filters for your convenience: <term><emphasis>msn</emphasis></term> <listitem> <para> - Another CSS based block, this time for MSN text ads. And removes + Another CSS based block, this time for MSN text ads. And removes tracking URLs, as well as a width limitation. </para> </listitem> @@ -8162,7 +7175,7 @@ pre-defined filters for your convenience: </para> </listitem> </varlistentry> - + <varlistentry> <term><emphasis>html-to-xml</emphasis></term> <listitem> @@ -8241,13 +7254,13 @@ pre-defined filters for your convenience: <sect1 id="templates"> <title>Privoxy's Template Files</title> <para> - All <application>Privoxy</application> built-in pages, i.e. error pages such as the + All <application>Privoxy</application> built-in pages, i.e. error pages such as the <ulink url="http://show-the-404-error.page"><quote>404 - No Such Domain</quote> error page</ulink>, the <ulink url="http://ads.bannerserver.example.com/nasty-ads/sponsor.html"><quote>BLOCKED</quote> page</ulink> and all pages of its <ulink url="http://config.privoxy.org/">web-based - user interface</ulink>, are generated from <emphasis>templates</emphasis>. + user interface</ulink>, are generated from <emphasis>templates</emphasis>. (<application>Privoxy</application> must be running for the above links to work as intended.) </para> @@ -8264,10 +7277,10 @@ pre-defined filters for your convenience: or exports), which <application>Privoxy</application> fills at run time. It is possible to edit the templates with a normal text editor, should you want to customize them. (<emphasis>Not recommended for the casual - user</emphasis>). Should you create your own custom templates, you should use + user</emphasis>). Should you create your own custom templates, you should use the <filename>config</filename> setting <link linkend="templdir">templdir</link> to specify an alternate location, so your templates do not get overwritten - during upgrades. + during upgrades. </para> <para> Note that just like in configuration files, lines starting @@ -8399,7 +7412,7 @@ Requests</title> expressions</quote> in its <link linkend="actions-file">actions files</link> and <link linkend="filter-file">filter file</link>, through the <ulink url="http://www.pcre.org/">PCRE</ulink> and -<!-- +<!-- dead 08/27/06 <ulink url="http://www.oesterhelt.org/pcrs/">PCRS</ulink> libraries. --> @@ -8426,7 +7439,7 @@ Requests</title>
<para> To make a simple analogy, we do something similar when we use wild-card - characters when listing files with the <command>dir</command> command in DOS. + characters when listing files with the <command>dir</command> command in DOS. <literal>*.*</literal> matches all filenames. The <quote>special</quote> character here is the asterisk which matches any and all characters. We can be more specific and use <literal>?</literal> to match just individual @@ -8437,7 +7450,7 @@ Requests</title>
<para> Regular expressions do essentially the same thing, but are much, much more - powerful. There are many more <quote>special characters</quote> and ways of + powerful. There are many more <quote>special characters</quote> and ways of building complex patterns however. Let's look at a few of the common ones, and then some examples: </para> @@ -8473,10 +7486,10 @@ Requests</title> <para><simplelist> <member> <emphasis></emphasis> - The <quote>escape</quote> character denotes that - the following character should be taken literally. This is used where one of the + the following character should be taken literally. This is used where one of the special characters (e.g. <quote>.</quote>) needs to be taken literally and - not as a special meta-character. Example: <quote>example.com</quote>, makes - sure the period is recognized only as a period (and not expanded to its + not as a special meta-character. Example: <quote>example.com</quote>, makes + sure the period is recognized only as a period (and not expanded to its meta-character meaning of any single character). </member> </simplelist></para> @@ -8485,7 +7498,7 @@ Requests</title> <member> <emphasis>[ ]</emphasis> - Characters enclosed in brackets will be matched if any of the enclosed characters are encountered. For instance, <quote>[0-9]</quote> - matches any numeric digit (zero through nine). As an example, we can combine + matches any numeric digit (zero through nine). As an example, we can combine this with <quote>+</quote> to match any digit one of more times: <quote>[0-9]+</quote>. </member> </simplelist></para> @@ -8502,14 +7515,14 @@ Requests</title> <emphasis>|</emphasis> - The <quote>bar</quote> character works like an <quote>or</quote> conditional statement. A match is successful if the sub-expression on either side of <quote>|</quote> matches. As an example: - <quote>/(this|that) example/</quote> uses grouping and the bar character + <quote>/(this|that) example/</quote> uses grouping and the bar character and would match either <quote>this example</quote> or <quote>that example</quote>, and nothing else. </member> </simplelist></para>
<para> - These are just some of the ones you are likely to use when matching URLs with + These are just some of the ones you are likely to use when matching URLs with <application>Privoxy</application>, and is a long way from a definitive list. This is enough to get us started with a few simple examples which may be more illuminating: @@ -8517,12 +7530,12 @@ Requests</title>
<para> <emphasis><literal>/.*/banners/.*</literal></emphasis> - A simple example - that uses the common combination of <quote>.</quote> and <quote>*</quote> to + that uses the common combination of <quote>.</quote> and <quote>*</quote> to denote any character, zero or more times. In other words, any string at all. - So we start with a literal forward slash, then our regular expression pattern + So we start with a literal forward slash, then our regular expression pattern (<quote>.*</quote>) another literal forward slash, the string <quote>banners</quote>, another forward slash, and lastly another - <quote>.*</quote>. We are building + <quote>.*</quote>. We are building a directory path here. This will match any file with the path that has a directory named <quote>banners</quote> in it. The <quote>.*</quote> matches any characters, and this could conceivably be more forward slashes, so it @@ -8538,14 +7551,14 @@ Requests</title> </para>
<para> - <emphasis><literal>/.*/adv((er)?ts?|ertis(ing|ements?))?/</literal></emphasis> - + <emphasis><literal>/.*/adv((er)?ts?|ertis(ing|ements?))?/</literal></emphasis> - We have several literal forward slashes again (<quote>/</quote>), so we are - building another expression that is a file path statement. We have another + building another expression that is a file path statement. We have another <quote>.*</quote>, so we are matching against any conceivable sub-path, just so it matches our expression. The only true literal that <emphasis>must match</emphasis> our pattern is <application>adv</application>, together with the forward slashes. What comes after the <quote>adv</quote> string is the - interesting part. + interesting part. </para>
<para> @@ -8555,29 +7568,29 @@ Requests</title> <quote>((er)?ts?|ertis(ing|ements?))</quote> is optional, as are the individual sub-expressions: <quote>(er)</quote>, <quote>(ing|ements?)</quote>, and the <quote>s</quote>. The <quote>|</quote> - means <quote>or</quote>. We have two of those. For instance, - <quote>(ing|ements?)</quote>, can expand to match either <quote>ing</quote> + means <quote>or</quote>. We have two of those. For instance, + <quote>(ing|ements?)</quote>, can expand to match either <quote>ing</quote> <emphasis>OR</emphasis> <quote>ements?</quote>. What is being done here, is an - attempt at matching as many variations of <quote>advertisement</quote>, and + attempt at matching as many variations of <quote>advertisement</quote>, and similar, as possible. So this would expand to match just <quote>adv</quote>, or <quote>advert</quote>, or <quote>adverts</quote>, or <quote>advertising</quote>, or <quote>advertisement</quote>, or - <quote>advertisements</quote>. You get the idea. But it would not match + <quote>advertisements</quote>. You get the idea. But it would not match <quote>advertizements</quote> (with a <quote>z</quote>). We could fix that by - changing our regular expression to: + changing our regular expression to: <quote>/.*/adv((er)?ts?|erti(s|z)(ing|ements?))?/</quote>, which would then match either spelling. </para>
<para> - <emphasis><literal>/.*/advert[0-9]+.(gif|jpe?g)</literal></emphasis> - Again - another path statement with forward slashes. Anything in the square brackets + <emphasis><literal>/.*/advert[0-9]+.(gif|jpe?g)</literal></emphasis> - Again + another path statement with forward slashes. Anything in the square brackets <quote>[ ]</quote> can be matched. This is using <quote>0-9</quote> as a shorthand expression to mean any digit one through nine. It is the same as saying <quote>0123456789</quote>. So any digit matches. The <quote>+</quote> - means one or more of the preceding expression must be included. The preceding - expression here is what is in the square brackets -- in this case, any digit - one through nine. Then, at the end, we have a grouping: <quote>(gif|jpe?g)</quote>. + means one or more of the preceding expression must be included. The preceding + expression here is what is in the square brackets -- in this case, any digit + one through nine. Then, at the end, we have a grouping: <quote>(gif|jpe?g)</quote>. This includes a <quote>|</quote>, so this needs to match the expression on either side of that bar character also. A simple <quote>gif</quote> on one side, and the other side will in turn match either <quote>jpeg</quote> or <quote>jpg</quote>, @@ -8607,7 +7620,7 @@ Requests</title> </para>
<para> - More reading on Perl Compatible Regular expressions: + More reading on Perl Compatible Regular expressions: <ulink url="http://perldoc.perl.org/perlre.html">http://perldoc.perl.org/perlre.html</ulink> </para>
@@ -8626,22 +7639,22 @@ Requests</title> <title>Privoxy's Internal Pages</title>
<para> - Since <application>Privoxy</application> proxies each requested - web page, it is easy for <application>Privoxy</application> to + Since <application>Privoxy</application> proxies each requested + web page, it is easy for <application>Privoxy</application> to trap certain special URLs. In this way, we can talk directly to - <application>Privoxy</application>, and see how it is - configured, see how our rules are being applied, change these + <application>Privoxy</application>, and see how it is + configured, see how our rules are being applied, change these rules and other configuration options, and even turn - <application>Privoxy's</application> filtering off, all with + <application>Privoxy's</application> filtering off, all with a web browser.
</para>
<para> - The URLs listed below are the special ones that allow direct access + The URLs listed below are the special ones that allow direct access to <application>Privoxy</application>. Of course, - <application>Privoxy</application> must be running to access these. If - not, you will get a friendly error message. Internet access is not + <application>Privoxy</application> must be running to access these. If + not, you will get a friendly error message. Internet access is not necessary either. </para>
@@ -8649,11 +7662,11 @@ Requests</title> <itemizedlist>
<listitem> - <para> - Privoxy main page: + <para> + Privoxy main page: </para> <blockquote> - <para> + <para> <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> </para> </blockquote> @@ -8665,77 +7678,77 @@ Requests</title> </listitem>
<listitem> - <para> - Show information about the current configuration, including viewing and + <para> + Show information about the current configuration, including viewing and editing of actions files: </para> <blockquote> - <para> + <para> <ulink url="http://config.privoxy.org/show-status">http://config.privoxy.org/show-status</ulink> </para> </blockquote> </listitem> - + <listitem> - <para> + <para> Show the source code version numbers: </para> <blockquote> - <para> + <para> <ulink url="http://config.privoxy.org/show-version">http://config.privoxy.org/show-version</ulink> </para> </blockquote> </listitem> - + <listitem> - <para> + <para> Show the browser's request headers: </para> <blockquote> - <para> + <para> <ulink url="http://config.privoxy.org/show-request">http://config.privoxy.org/show-request</ulink> </para> </blockquote> </listitem> - + <listitem> - <para> + <para> Show which actions apply to a URL and why: </para> <blockquote> - <para> + <para> <ulink url="http://config.privoxy.org/show-url-info">http://config.privoxy.org/show-url-info</ulink> </para> </blockquote> </listitem> - + <listitem> - <para> - Toggle Privoxy on or off. This feature can be turned off/on in the main + <para> + Toggle Privoxy on or off. This feature can be turned off/on in the main <filename>config</filename> file. When toggled <quote>off</quote>, <quote>Privoxy</quote> continues to run, but only as a pass-through proxy, with no actions taking place: </para> <blockquote> - <para> + <para> <ulink url="http://config.privoxy.org/toggle">http://config.privoxy.org/toggle</ulink> </para> </blockquote> <para> - Short cuts. Turn off, then on: + Short cuts. Turn off, then on: </para> <blockquote> - <para> + <para> <ulink url="http://config.privoxy.org/toggle?set=disable">http://config.privoxy.org/toggle?set=disable</ulink> </para> </blockquote> <blockquote> - <para> + <para> <ulink url="http://config.privoxy.org/toggle?set=enable">http://config.privoxy.org/toggle?set=enable</ulink> </para> </blockquote> </listitem> - + </itemizedlist> </para>
@@ -8760,7 +7773,7 @@ Requests</title> the bookmark <quote>may not be safe</quote> - just click OK. Then you can run the Bookmarklet directly from your favorites/bookmarks. For even faster access, you can put them on the <quote>Links</quote> bar (IE) or the <quote>Personal - Toolbar</quote> (Netscape), and run them with a single click. + Toolbar</quote> (Netscape), and run them with a single click. </para>
<para> @@ -8771,47 +7784,47 @@ Requests</title> <ulink url="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=enabled','ijbstatus','width=250,height=100,resizable=yes,scrollbars=no,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());">Privoxy - Enable</ulink> </para> - </listitem> + </listitem>
<listitem> <para> <ulink url="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=disabled','ijbstatus','width=250,height=100,resizable=yes,scrollbars=no,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());">Privoxy - Disable</ulink> </para> - </listitem> + </listitem>
<listitem> <para> <ulink url="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=toggle','ijbstatus','width=250,height=100,resizable=yes,scrollbars=no,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());">Privoxy - Toggle Privoxy</ulink> (Toggles between enabled and disabled) </para> - </listitem> + </listitem>
<listitem> <para> <ulink url="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y','ijbstatus','width=250,height=2,resizable=yes,scrollbars=no,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());">Privoxy- View Status</ulink> </para> - </listitem> + </listitem> <!-- <listitem> <para> <ulink url="javascript:w=Math.floor(screen.width/2);h=Math.floor(screen.height*0.9);void(window.open('http://www.privoxy.org/actions/index.php?url='+escape(location.href),'Feedback','screenx='+w+',width='+w+',height='+h+',scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());">Privoxy - Submit Actions File Feedback</ulink> </para> - </listitem> - --> + </listitem> + --> <listitem> <para> <ulink url="javascript:void(window.open('http://config.privoxy.org/show-url-info?url='+escape(location.href),'Why').focus());">Privoxy - Why?</ulink> </para> - </listitem> + </listitem> </itemizedlist> </para>
<para> Credit: The site which gave us the general idea for these bookmarklets is <ulink url="http://www.bookmarklets.com/">www.bookmarklets.com</ulink>. They - have more information about bookmarklets. + have more information about bookmarklets. </para>
@@ -8824,7 +7837,7 @@ Requests</title> <sect2 id="chain"> <title>Chain of Events</title> <para> - Let's take a quick look at how some of <application>Privoxy's</application> + Let's take a quick look at how some of <application>Privoxy's</application> core features are triggered, and the ensuing sequence of events when a web page is requested by your browser: </para> @@ -8833,48 +7846,48 @@ Requests</title> <itemizedlist> <listitem> <para> - First, your web browser requests a web page. The browser knows to send - the request to <application>Privoxy</application>, which will in turn, - relay the request to the remote web server after passing the following - tests: + First, your web browser requests a web page. The browser knows to send + the request to <application>Privoxy</application>, which will in turn, + relay the request to the remote web server after passing the following + tests: </para> - </listitem> + </listitem> <listitem> <para> - <application>Privoxy</application> traps any request for its own internal CGI + <application>Privoxy</application> traps any request for its own internal CGI pages (e.g <ulink url="http://p.p/">http://p.p/</ulink>) and sends the CGI page back to the browser. </para> - </listitem> + </listitem> <listitem> <para> - Next, <application>Privoxy</application> checks to see if the URL + Next, <application>Privoxy</application> checks to see if the URL matches any <link linkend="BLOCK"><quote>+block</quote></link> patterns. If so, the URL is then blocked, and the remote web server will not be contacted. - <link linkend="HANDLE-AS-IMAGE"><quote>+handle-as-image</quote></link> - and + <link linkend="HANDLE-AS-IMAGE"><quote>+handle-as-image</quote></link> + and <link linkend="HANDLE-AS-EMPTY-DOCUMENT"><quote>+handle-as-empty-document</quote></link> - are then checked, and if there is no match, an + are then checked, and if there is no match, an HTML <quote>BLOCKED</quote> page is sent back to the browser. Otherwise, if it does match, an image is returned for the former, and an empty text document for the latter. The type of image would depend on the setting of <link linkend="SET-IMAGE-BLOCKER"><quote>+set-image-blocker</quote></link> (blank, checkerboard pattern, or an HTTP redirect to an image elsewhere). </para> - </listitem> + </listitem> <listitem> <para> Untrusted URLs are blocked. If URLs are being added to the <filename>trust</filename> file, then that is done. </para> - </listitem> + </listitem> <listitem> <para> If the URL pattern matches the <link linkend="FAST-REDIRECTS"><quote>+fast-redirects</quote></link> action, it is then processed. Unwanted parts of the requested URL are stripped. </para> - </listitem> + </listitem> <listitem> <para> Now the rest of the client browser's request headers are processed. If any @@ -8883,24 +7896,24 @@ Requests</title> etc.), headers are suppressed or forged as determined by these actions and their parameters. </para> - </listitem> + </listitem> <listitem> <para> Now the web server starts sending its response back (i.e. typically a web page). </para> - </listitem> + </listitem> <listitem> <para> First, the server headers are read and processed to determine, among other things, the MIME type (document type) and encoding. The headers are then - filtered as determined by the + filtered as determined by the <link linkend="CRUNCH-INCOMING-COOKIES"><quote>+crunch-incoming-cookies</quote></link>, <link linkend="SESSION-COOKIES-ONLY"><quote>+session-cookies-only</quote></link>, and <link linkend="DOWNGRADE-HTTP-VERSION"><quote>+downgrade-http-version</quote></link> actions. </para> - </listitem> + </listitem> <listitem> <para> If any <link linkend="FILTER"><quote>+filter</quote></link> action @@ -8913,35 +7926,35 @@ Requests</title> they are specified in one of the filter files. Animated GIFs, if present, are reduced to either the first or last frame, depending on the action setting.The entire page, which is now filtered, is then sent by - <application>Privoxy</application> back to your browser. + <application>Privoxy</application> back to your browser. </para> <para> If neither a <link linkend="FILTER"><quote>+filter</quote></link> action or <link linkend="DEANIMATE-GIFS"><quote>+deanimate-gifs</quote></link> - matches, then <application>Privoxy</application> passes the raw data through + matches, then <application>Privoxy</application> passes the raw data through to the client browser as it becomes available. </para> - </listitem> + </listitem> <listitem> <para> - As the browser receives the now (possibly filtered) page content, it + As the browser receives the now (possibly filtered) page content, it reads and then requests any URLs that may be embedded within the page source, e.g. ad images, stylesheets, JavaScript, other HTML documents (e.g. frames), sounds, etc. For each of these objects, the browser issues a separate request (this is easily viewable in <application>Privoxy's</application> logs). And each such request is in turn processed just as above. Note that a - complex web page will have many, many such embedded URLs. If these - secondary requests are to a different server, then quite possibly a very + complex web page will have many, many such embedded URLs. If these + secondary requests are to a different server, then quite possibly a very differing set of actions is triggered. </para> - </listitem> - + </listitem> + </itemizedlist> </para> <para> NOTE: This is somewhat of a simplistic overview of what happens with each URL - request. For the sake of brevity and simplicity, we have focused on + request. For the sake of brevity and simplicity, we have focused on <application>Privoxy's</application> core features only. </para>
@@ -8953,7 +7966,7 @@ Requests</title> <title>Troubleshooting: Anatomy of an Action</title>
<para> - The way <application>Privoxy</application> applies + The way <application>Privoxy</application> applies <link linkend="ACTIONS">actions</link> and <link linkend="FILTER">filters</link> to any given URL can be complex, and not always so easy to understand what is happening. And sometimes we need to be able to @@ -8962,16 +7975,16 @@ Requests</title> is causing us a problem inadvertently. It can be a little daunting to look at the actions and filters files themselves, since they tend to be filled with <link linkend="regex">regular expressions</link> whose consequences are not - always so obvious. + always so obvious. </para>
<para> - One quick test to see if <application>Privoxy</application> is causing a problem - or not, is to disable it temporarily. This should be the first troubleshooting - step. See <link linkend="bookmarklets">the Bookmarklets</link> section on a quick - and easy way to do this (be sure to flush caches afterward!). Looking at the - logs is a good idea too. (Note that both the toggle feature and logging are - enabled via <filename>config</filename> file settings, and may need to be + One quick test to see if <application>Privoxy</application> is causing a problem + or not, is to disable it temporarily. This should be the first troubleshooting + step. See <link linkend="bookmarklets">the Bookmarklets</link> section on a quick + and easy way to do this (be sure to flush caches afterward!). Looking at the + logs is a good idea too. (Note that both the toggle feature and logging are + enabled via <filename>config</filename> file settings, and may need to be turned <quote>on</quote>.) </para> <para> @@ -8983,7 +7996,7 @@ Requests</title> </para>
<para> - <application>Privoxy</application> also provides the + <application>Privoxy</application> also provides the <ulink url="http://config.privoxy.org/show-url-info">http://config.privoxy.org/show-url-info</ulink> page that can show us very specifically how <application>actions</application> are being applied to any given URL. This is a big help for troubleshooting. @@ -8991,7 +8004,7 @@ Requests</title>
<para> First, enter one URL (or partial URL) at the prompt, and then - <application>Privoxy</application> will tell us + <application>Privoxy</application> will tell us how the current configuration will handle it. This will not help with filtering effects (i.e. the <link linkend="FILTER"><quote>+filter</quote></link> action) from @@ -9007,8 +8020,8 @@ Requests</title> </para>
<para> - Let's try an example, <ulink url="http://google.com">google.com</ulink>, - and look at it one section at a time in a sample configuration (your real + Let's try an example, <ulink url="http://google.com">google.com</ulink>, + and look at it one section at a time in a sample configuration (your real configuration may vary): </para>
@@ -9032,7 +8045,7 @@ Requests</title> +session-cookies-only +set-image-blocker {pattern} / - + { -session-cookies-only } .google.com
@@ -9040,17 +8053,17 @@ Requests</title> .google.com
In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibutton> -(no matches in this file) +(no matches in this file) </screen> </para>
<para> - This is telling us how we have defined our + This is telling us how we have defined our <link linkend="ACTIONS"><quote>actions</quote></link>, and - which ones match for our test case, <quote>google.com</quote>. + which ones match for our test case, <quote>google.com</quote>. Displayed is all the actions that are available to us. Remember, the <literal>+</literal> sign denotes <quote>on</quote>. <literal>-</literal> - denotes <quote>off</quote>. So some are <quote>on</quote> here, but many + denotes <quote>off</quote>. So some are <quote>on</quote> here, but many are <quote>off</quote>. Each example we try may provide a slightly different end result, depending on our configuration directives. </para> @@ -9078,7 +8091,7 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut action, allowing this to take place unmolested. Note that there is a leading dot here -- <quote>.google.com</quote>. This will match any hosts and sub-domains, in the google.com domain also, such as - <quote>www.google.com</quote> or <quote>mail.google.com</quote>. But it would not + <quote>www.google.com</quote> or <quote>mail.google.com</quote>. But it would not match <quote>www.google.de</quote>! So, apparently, we have these two actions defined as exceptions to the general rules at the top somewhere in the lower part of our <filename>default.action</filename> file, and @@ -9088,7 +8101,7 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut <para> Then, for our <filename>user.action</filename> file, we again have no hits. So there is nothing google-specific that we might have added to our own, local - configuration. If there was, those actions would over-rule any actions from + configuration. If there was, those actions would over-rule any actions from previously processed files, such as <filename>default.action</filename>. <filename>user.action</filename> typically has the last word. This is the best place to put hard and fast exceptions, @@ -9096,7 +8109,7 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut
<para> And finally we pull it all together in the bottom section and summarize how - <application>Privoxy</application> is applying all its <quote>actions</quote> + <application>Privoxy</application> is applying all its <quote>actions</quote> to <quote>google.com</quote>:
</para> @@ -9105,10 +8118,10 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut <screen>
Final results: - + -add-header -block - +change-x-forwarded-for{block} + +change-x-forwarded-for{block} -client-header-filter{hide-tor-exit-notation} -content-type-overwrite -crunch-client-header @@ -9159,15 +8172,15 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut -prevent-compression -redirect -server-header-filter{xml-to-html} - -server-header-filter{html-to-xml} + -server-header-filter{html-to-xml} -session-cookies-only +set-image-blocker {pattern} </screen> </para>
<para> - Notice the only difference here to the previous listing, is to + Notice the only difference here to the previous listing, is to <quote>fast-redirects</quote> and <quote>session-cookies-only</quote>, - which are activated specifically for this site in our configuration, + which are activated specifically for this site in our configuration, and thus show in the <quote>Final Results</quote>. </para>
@@ -9190,25 +8203,25 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut </para>
<para> - We'll just show the interesting part here - the explicit matches. It is - matched three different times. Two <quote>+block{}</quote> sections, + We'll just show the interesting part here - the explicit matches. It is + matched three different times. Two <quote>+block{}</quote> sections, and a <quote>+block{} +handle-as-image</quote>, - which is the expanded form of one of our aliases that had been defined as: + which is the expanded form of one of our aliases that had been defined as: <quote>+block-as-image</quote>. (<link linkend="ALIASES"><quote>Aliases</quote></link> are defined in - the first section of the actions file and typically used to combine more + the first section of the actions file and typically used to combine more than one action.) </para>
<para> - Any one of these would have done the trick and blocked this as an unwanted - image. This is unnecessarily redundant since the last case effectively - would also cover the first. No point in taking chances with these guys - though ;-) Note that if you want an ad or obnoxious + Any one of these would have done the trick and blocked this as an unwanted + image. This is unnecessarily redundant since the last case effectively + would also cover the first. No point in taking chances with these guys + though ;-) Note that if you want an ad or obnoxious URL to be invisible, it should be defined as <quote>ad.doubleclick.net</quote> is done here -- as both a <link linkend="BLOCK"><quote>+block{}</quote></link> - <emphasis>and</emphasis> an + <emphasis>and</emphasis> an <link linkend="HANDLE-AS-IMAGE"><quote>+handle-as-image</quote></link>. The custom alias <quote><literal>+block-as-image</literal></quote> just simplifies the process and make it more readable. @@ -9226,9 +8239,9 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut
In file: default.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibutton>
- {-add-header + {-add-header -block - +change-x-forwarded-for{block} + +change-x-forwarded-for{block} -client-header-filter{hide-tor-exit-notation} -content-type-overwrite -crunch-client-header @@ -9236,8 +8249,8 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut -crunch-incoming-cookies -crunch-outgoing-cookies -crunch-server-header - +deanimate-gifs - -downgrade-http-version + +deanimate-gifs + -downgrade-http-version +fast-redirects {check-decoded-url} -filter {js-events} -filter {content-cookies} @@ -9267,18 +8280,18 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut -filter {no-ping} -force-text-mode -handle-as-empty-document - -handle-as-image + -handle-as-image -hide-accept-language - -hide-content-disposition - +hide-from-header{block} - +hide-referer{forge} - -hide-user-agent + -hide-content-disposition + +hide-from-header{block} + +hide-referer{forge} + -hide-user-agent -overwrite-last-modified - +prevent-compression + +prevent-compression -redirect -server-header-filter{xml-to-html} - -server-header-filter{html-to-xml} - +session-cookies-only + -server-header-filter{html-to-xml} + +session-cookies-only +set-image-blocker{blank} } /
@@ -9288,10 +8301,10 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut </para>
<para> - Ooops, the <quote>/adsl/</quote> is matching <quote>/ads</quote> in our + Ooops, the <quote>/adsl/</quote> is matching <quote>/ads</quote> in our configuration! But we did not want this at all! Now we see why we get the - blank page. It is actually triggering two different actions here, and - the effects are aggregated so that the URL is blocked, and &my-app; is told + blank page. It is actually triggering two different actions here, and + the effects are aggregated so that the URL is blocked, and &my-app; is told to treat the block as if it were an image. But this is, of course, all wrong. We could now add a new action below this (or better in our own <filename>user.action</filename> file) that explicitly @@ -9310,14 +8323,14 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut </para>
<para> - Now the page displays ;-) + Now the page displays ;-) Remember to flush your browser's caches when making these kinds of changes to your configuration to insure that you get a freshly delivered page! Or, try using <literal>Shift+Reload</literal>. </para>
<para> - But now what about a situation where we get no explicit matches like + But now what about a situation where we get no explicit matches like we did with: </para>
@@ -9331,7 +8344,7 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut
<para> That actually was very helpful and pointed us quickly to where the problem - was. If you don't get this kind of match, then it means one of the default + was. If you don't get this kind of match, then it means one of the default rules in the first section of <filename>default.action</filename> is causing the problem. This would require some guesswork, and maybe a little trial and error to isolate the offending rule. One likely cause would be one of the @@ -9354,7 +8367,7 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut </para>
<para> - <quote><literal>{ shop }</literal></quote> is an <quote>alias</quote> that expands to + <quote><literal>{ shop }</literal></quote> is an <quote>alias</quote> that expands to <quote><literal>{ -filter -session-cookies-only }</literal></quote>. Or you could do your own exception to negate filtering:
@@ -9375,23 +8388,23 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut This would turn off all filtering for these sites. This is best put in <filename>user.action</filename>, for local site exceptions. Note that when a simple domain pattern is used by itself (without - the subsequent path portion), all sub-pages within that domain are included + the subsequent path portion), all sub-pages within that domain are included automatically in the scope of the action. </para>
<para> - Images that are inexplicably being blocked, may well be hitting the + Images that are inexplicably being blocked, may well be hitting the <link linkend="FILTER-BANNERS-BY-SIZE"><quote>+filter{banners-by-size}</quote></link> - rule, which assumes - that images of certain sizes are ad banners (works well + rule, which assumes + that images of certain sizes are ad banners (works well <emphasis>most of the time</emphasis> since these tend to be standardized). </para>
<para> <quote><literal>{ fragile }</literal></quote> is an alias that disables most actions that are the most likely to cause trouble. This can be used as a - last resort for problem sites. -</para> + last resort for problem sites. +</para> <para> <screen>
@@ -9400,16 +8413,16 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut mail.google. mybank.example.com</screen> </para> - +
<para> - <emphasis>Remember to flush caches!</emphasis> Note that the - <literal>mail.google</literal> reference lacks the TLD portion (e.g. - <quote>.com</quote>). This will effectively match any TLD with - <literal>google</literal> in it, such as <literal>mail.google.de.</literal>, + <emphasis>Remember to flush caches!</emphasis> Note that the + <literal>mail.google</literal> reference lacks the TLD portion (e.g. + <quote>.com</quote>). This will effectively match any TLD with + <literal>google</literal> in it, such as <literal>mail.google.de.</literal>, just as an example. </para> -<para> +<para> If this still does not work, you will have to go through the remaining actions one by one to find which one(s) is causing the problem. </para> @@ -9420,7 +8433,7 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut
<!--
- This program is free software; you can redistribute it + This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at @@ -9435,152 +8448,11 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut The GNU General Public License should be included with this file. If not, you can view it at http://www.gnu.org/copyleft/gpl.html - or write to the Free Software Foundation, Inc., - 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, + or write to the Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
$Log: user-manual.sgml,v $ - Revision 2.146 2011/12/26 17:05:40 fabiankeil - Bump entities for 3.0.19 - - Revision 2.145 2011/12/26 17:04:19 fabiankeil - Import ChangeLog entries for 3.0.19, keeping the ones for 3.0.18 for now - - Revision 2.144 2011/12/26 17:01:29 fabiankeil - Try to be less misleading in the downgrade-http-version description - - Revision 2.143 2011/11/20 17:16:36 fabiankeil - Last minute ChangeLog changes that didn't make it into the tarball - - Revision 2.142 2011/11/20 12:43:38 fabiankeil - Update ChangeLog. Once more, with feeling. - - Revision 2.141 2011/11/20 12:41:22 fabiankeil - Document the +fast-redirects{} HTTP response splitting fix - - Revision 2.140 2011/11/19 15:18:02 fabiankeil - Update ChangeLog - - Revision 2.139 2011/11/18 16:49:29 fabiankeil - Update ChangeLog - - Revision 2.138 2011/11/13 17:03:54 fabiankeil - Bump entities for 3.0.18 stable - - Revision 2.137 2011/11/13 17:02:59 fabiankeil - Import the first ChangeLog draft for 3.0.18 stable - - Revision 2.136 2011/10/14 16:53:10 fabiankeil - Clarify the effect of compiling Privoxy with zlib support - - Suggested by dg1727 in #3423782. - - zlib support has been available for years now, - so drop the reference to Privoxy 3.0.7 - - Revision 2.135 2011/09/04 11:10:12 fabiankeil - Ditch trailing whitespace - - Revision 2.134 2011/08/18 11:45:02 fabiankeil - Don't use unspecified MSN sites as examples for User-Agent-based descrimination - - Without knowing the URLs, nobody can easily verify it and it could - be mistaken as FUD. I also assume that it's no longer an issue anyway. - - Revision 2.133 2011/08/18 11:42:50 fabiankeil - Bump some more documentation copyright ranges. - - Revision 2.132 2011/08/17 10:40:07 fabiankeil - Update the entities. - - This commit is chronological out of order. - - Revision 2.131 2011/04/19 13:14:10 fabiankeil - Fix spelling errors in the documentation. Found with codespell. - - Revision 2.130 2010/12/01 19:28:28 fabiankeil - Hopefully unbreak the dok target when using some kind of jade. - - Reported by Lee. - - Revision 2.129 2010/11/13 20:17:11 fabiankeil - Merge ChangeLog updates - - Revision 2.128 2010/11/10 22:00:13 fabiankeil - Update the first paragraph of the 'What's New' section. - - Revision 2.127 2010/11/10 21:48:54 fabiankeil - Update the "What's New" section. - - Revision 2.126 2010/11/06 12:55:48 fabiankeil - Set p-version to 3.0.17 - - Revision 2.125 2010/09/03 17:39:37 fabiankeil - Slightly improve the explanation of why filtering may appear slower than it is. - - Revision 2.124 2010/05/01 18:21:30 fabiankeil - Explicitly mention how to match any URL. - - Revision 2.123 2010/02/19 16:00:38 fabiankeil - Even more fixes. - - Revision 2.122 2010/02/19 15:22:47 fabiankeil - Add missing word. - - Revision 2.121 2010/02/15 15:30:13 fabiankeil - Mention the use of the no-such-domain template for DNS problems with FEATURE_IPV6_SUPPORT enabled. - - Revision 2.120 2010/02/13 17:38:39 fabiankeil - Update entities for 3.0.16 stable. - - Revision 2.119 2010/02/13 16:37:37 fabiankeil - Update 'What's new?' section. - - Revision 2.118 2010/02/11 13:59:48 fabiankeil - Mention that the headers added by the add-header action aren't modified by other actions. - - Revision 2.117 2010/01/11 12:56:04 fabiankeil - Bump copyright range as p-config.sgml's copyright line is only used in the config file. - - Revision 2.116 2009/11/15 14:24:12 fabiankeil - Prepare to generate docs for 3.0.16 UNRELEASED. - - Revision 2.115 2009/10/10 06:19:34 fabiankeil - Ditch a duplicated 'since'. - - Revision 2.114 2009/10/10 05:51:48 fabiankeil - Update "What's new" section. - - Revision 2.113 2009/10/10 05:48:55 fabiankeil - Prepare for 3.0.15 beta. - - Revision 2.112 2009/07/24 12:20:30 fabiankeil - Remove duplicated period. - - Revision 2.111 2009/07/18 18:11:11 fabiankeil - Don't claim that NTLM should work when there are multiple reports that it doesn't. - - Revision 2.110 2009/07/18 16:25:17 fabiankeil - Fix trailing whitespace. - - Revision 2.109 2009/07/18 16:24:39 fabiankeil - Bump entities for 3.0.14 beta. - - Revision 2.108 2009/07/18 15:49:23 fabiankeil - Add most of the changes in 3.0.14 to the "What's New" section. - - Revision 2.107 2009/06/12 14:30:58 fabiankeil - Update entities for 3.0.13 beta. - - Revision 2.106 2009/06/12 11:04:13 fabiankeil - Import ChangeLog for 3.0.13 beta. - - Revision 2.105 2009/04/17 11:32:57 fabiankeil - Grammar and spelling fixes. - - Revision 2.104 2009/04/17 11:27:49 fabiankeil - Petr Pisar's privoxy-3.0.12-ipv6-3.diff. - Revision 2.103 2009/03/21 10:49:05 fabiankeil Merge updated ChangeLog.
@@ -10106,7 +8978,7 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut clarification.
Revision 1.111 2002/05/14 23:01:36 oes - Fixing the fixes + Fixing the fixes
Revision 1.110 2002/05/14 19:10:45 oes Restored alphabetical order of actions diff --git a/external/privoxy/doc/source/webserver/index.sgml b/external/privoxy/doc/source/webserver/index.sgml index 93fb554..ef63867 100644 --- a/external/privoxy/doc/source/webserver/index.sgml +++ b/external/privoxy/doc/source/webserver/index.sgml @@ -5,7 +5,7 @@ <!entity history SYSTEM "history.sgml"> <!entity copyright SYSTEM "copyright.sgml"> <!entity license SYSTEM "license.sgml"> -<!entity p-version "3.0.19"> +<!entity p-version "3.0.11"> <!entity p-status "stable"> <!entity % p-not-stable "IGNORE"> <!entity % p-stable "INCLUDE"> @@ -20,7 +20,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
- $Id: index.sgml,v 2.20 2011/12/26 17:05:40 fabiankeil Exp $ + $Id: index.sgml,v 2.9 2009/02/19 14:12:02 fabiankeil Exp $
Copyright (C) 2001-2009 Privoxy Developers <ijbswa-developers@lists.sourceforge.net> See LICENSE. @@ -90,7 +90,7 @@ <itemizedlist> <listitem> <para> - <ulink url="https://sourceforge.net/projects/ijbswa/files/">Download recent releases</ulink> + <ulink url="https://sourceforge.net/project/showfiles.php?group_id=11118">Download recent releases</ulink> </para> </listitem> <!-- @@ -169,7 +169,7 @@ <para> <!-- please leave this link absolute so this file can be bundled with --> <!-- documentation and still used locally --> - <ulink url="http://www.privoxy.org/team/index.html">Pictures of the Privoxy Team</ulink> + <ulink url="http://privoxy.org/team/index.html">Pictures of the Privoxy Team</ulink> </para> </listitem> </itemizedlist> @@ -222,7 +222,7 @@ <!-- GNUMakefile is inserting this now --> <para> <subscript> - Copyright __copy 2001-2010 by Privoxy Developers + Copyright __copy 2001-2009 by Privoxy Developers </subscript> </para>
@@ -249,42 +249,6 @@ Temple Place - Suite 330, Boston, MA 02111-1307, USA.
$Log: index.sgml,v $ - Revision 2.20 2011/12/26 17:05:40 fabiankeil - Bump entities for 3.0.19 - - Revision 2.19 2011/11/13 17:03:54 fabiankeil - Bump entities for 3.0.18 stable - - Revision 2.18 2011/08/17 10:40:07 fabiankeil - Update the entities. - - This commit is chronological out of order. - - Revision 2.17 2010/11/10 21:49:38 fabiankeil - Set p-version to 3.0.17 - - Revision 2.16 2010/02/13 17:38:39 fabiankeil - Update entities for 3.0.16 stable. - - Revision 2.15 2010/02/13 16:38:18 fabiankeil - Update copyright. - - Revision 2.14 2010/01/11 13:47:25 fabiankeil - Finally bump entities for 3.0.16 UNRELEASED here, too. - - Revision 2.13 2009/10/10 06:07:40 fabiankeil - Prepare for 3.0.15 beta. - - Revision 2.12 2009/08/01 11:48:22 fabiankeil - Update the "Download recent releases" URL and fix the "Pictures of the Privoxy Team" URL. - privoxy.org redirects to www.privoxy.org anyway. - - Revision 2.11 2009/07/18 16:24:39 fabiankeil - Bump entities for 3.0.14 beta. - - Revision 2.10 2009/06/12 14:30:59 fabiankeil - Update entities for 3.0.13 beta. - Revision 2.9 2009/02/19 14:12:02 fabiankeil Change link to the project page to https://.
diff --git a/external/privoxy/doc/webserver/announce.txt b/external/privoxy/doc/webserver/announce.txt index fa042c3..be37205 100644 --- a/external/privoxy/doc/webserver/announce.txt +++ b/external/privoxy/doc/webserver/announce.txt @@ -1,376 +1,47 @@ - Announcing Privoxy v.3.0.19 stable --------------------------------------------------------------------- + Announcing Privoxy v.3.0.12 +----------------------------------------------------------------- + +Privoxy 3.0.12-stable is primarily a bugfix release.
-This is a bug-fix release for the previously released -Privoxy 3.0.18. One of the fixes addresses a security issue. +See http://www.privoxy.org/3.0.12/user-manual/whatsnew.html for details.
-------------------------------------------------------------------- ChangeLog for Privoxy -------------------------------------------------------------------- -*** Version 3.0.19 Stable *** - -- Bug fixes: - - Prevent a segmentation fault when de-chunking buffered content. - It could be triggered by malicious web servers if Privoxy was - configured to filter the content and running on a platform - where SIZE_T_MAX isn't larger than UINT_MAX, which probably - includes most 32-bit systems. On those platforms, all Privoxy - versions before 3.0.19 appear to be affected. - To be on the safe side, this bug should be presumed to allow - code execution as proving that it doesn't seems unrealistic. - - Do not expect a response from the SOCKS4/4A server until it - got something to respond to. This regression was introduced - in 3.0.18 and prevented the SOCKS4/4A negotiation from working. - Reported by qqqqqw in #3459781. - -- General improvements: - - Fix an off-by-one in an error message about connect failures. - - Use a GNUMakefile variable for the webserver root directory and - update the path. Sourceforge changed it which broke various - web-related targets. - - Update the CODE_STATUS description. - -*** Version 3.0.18 stable *** - -- Bug fixes: - - If a generated redirect URL contains characters RFC 3986 doesn't - permit, they are (re)encoded. Not doing this makes Privoxy versions - from 3.0.5 to 3.0.17 susceptible to HTTP response splitting (CWE-113) - attacks if the +fast-redirects{check-decoded-url} action is used. - - Fix a logic bug that could cause Privoxy to reuse a server - socket after it got tainted by a server-header-tagger-induced - block that was triggered before the whole server response had - been read. If keep-alive was enabled and the request following - the blocked one was to the same host and using the same forwarding - settings, Privoxy would send it on the tainted server socket. - While the server would simply treat it as a pipelined request, - Privoxy would later on fail to properly parse the server's - response as it would try to parse the unread data from the - first response as server headers for the second one. - Regression introduced in 3.0.17. - - When implying keep-alive in client_connection(), remember that - the client didn't. Fixes a regression introduced in 3.0.13 that - would cause Privoxy to wait for additional client requests after - receiving a HTTP/1.1 request with "Connection: close" set - and connection sharing enabled. - With clients which terminates the client connection after detecting - that the whole body has been received it doesn't really matter, - but with clients that don't the connection would be kept open until - it timed out. - - Fix a subtle race condition between prepare_csp_for_next_request() - and sweep(). A thread preparing itself for the next client request - could briefly appear to be inactive. - If all other threads were already using more recent files, - the thread could get its files swept away under its feet. - So far this has only been reproduced while stress testing in - valgrind while touching action files in a loop. It's unlikely - to have caused any actual problems in the real world. - - Disable filters if SDCH compression is used unless filtering is forced. - If SDCH was combined with a supported compression algorithm, Privoxy - previously could try to decompress it and ditch the Content-Encoding - header even though the SDCH compression wasn't dealt with. - Reported by zebul666 in #3225863. - - Make a copy of the --user value and only mess with that when splitting - user and group. On some operating systems modifying the value directly - is reflected in the output of ps and friends and can be misleading. - Reported by zepard in #3292710. - - If forwarded-connect-retries is set, only retry if Privoxy is actually - forwarding the request. Previously direct connections would be retried - as well. - - Fixed a small memory leak when retrying connections with IPv6 - support enabled. - - Remove an incorrect assertion in compile_dynamic_pcrs_job_list() - It could be triggered by a pcrs job with an invalid pcre - pattern (for example one that contains a lone quantifier). - - If the --user argument user[.group] contains a dot, always bail out - if no group has been specified. Previously the intended, but undocumented - (and apparently untested), behaviour was to try interpreting the whole - argument as user name, but the detection was flawed and checked for '0' - instead of '\0', thus merely preventing group names beginning with a zero. - - In html_code_map[], use a numeric character reference instead of ' - which wasn't standardized before XHTML 1.0. - - Fix an invalid free when compiled with FEATURE_GRACEFUL_TERMINATION - and shut down through http://config.privoxy.org/die - - In get_actions(), fix the "temporary" backwards compatibility hack - to accept block actions without reason. - It also covered other actions that should be rejected as invalid. - Reported by Billy Crook. - -- General improvements: - - Privoxy can (re)compress buffered content before delivering - it to the client. Disabled by default as most users wouldn't - benefit from it. - - The +fast-redirects{check-decoded-url} action checks URL - segments separately. If there are other parameters behind - the redirect URL, this makes it unnecessary to cut them off - by additionally using a +redirect{} pcrs command. - Initial patch submitted by Jamie Zawinski in #3429848. - - When loading action sections, verify that the referenced filters - exist. Currently missing filters only result in an error message, - but eventually the severity will be upgraded to fatal. - - Allow to bind to multiple separate addresses. - Patch set submitted by Petr Pisar in #3354485. - - Set socket_error to errno if connecting fails in rfc2553_connect_to(). - Previously rejected direct connections could be incorrectly reported - as DNS issues if Privoxy was compiled with IPv6 support. - - Adjust url_code_map[] so spaces are replaced with %20 instead of '+' - While '+' can be used by client's submitting form data, this is not - actually what Privoxy is using the lookups for. This is more of a - cosmetic issue and doesn't fix any known problems. - - When compiled without FEATURE_FAST_REDIRECTS, do not silently - ignore +fast-redirect{} directives - - Added a workaround for GNU libc's strptime() reporting negative - year values when the parsed year is only specified with two digits. - On affected systems cookies with such a date would not be turned - into session cookies by the +session-cookies-only action. - Reported by Vaeinoe in #3403560 - - Fixed bind failures with certain GNU libc versions if no non-loopback - IP address has been configured on the system. This is mainly an issue - if the system is using DHCP and Privoxy is started before the network - is completely configured. - Reported by Raphael Marichez in #3349356. - Additional insight from Petr Pisar. - - Privoxy log messages now use the ISO 8601 date format %Y-%m-%d. - It's only slightly longer than the old format, but contains - the full date including the year and allows sorting by date - (when grepping in multiple log files) without hassle. - - In get_last_url(), do not bother trying to decode URLs that do - not contain at least one '%' sign. It reduces the log noise and - a number of unnecessary memory allocations. - - In case of SOCKS5 failures, dump the socks response in the log message. - - Simplify the signal setup in main(). - - Streamline socks5_connect() slightly. - - In socks5_connect(), require a complete socks response from the server. - Previously Privoxy didn't care how much data the server response - contained as long as the first two bytes contained the expected - values. While at it, shrink the buffer size so Privoxy can't read - more than a whole socks response. - - In chat(), do not bother to generate a client request in case of - direct CONNECT requests. It will not be used anyway. - - Reduce server_last_modified()'s stack size. - - Shorten get_http_time() by using strftime(). - - Constify the known_http_methods pointers in unknown_method(). - - Constify the time_formats pointers in parse_header_time(). - - Constify the formerly_valid_actions pointers in action_used_to_be_valid(). - - Introduce a GNUMakefile MAN_PAGE variable that defaults to privoxy.1. - The Debian package uses section 8 for the man page and this - should simplify the patch. - - Deduplicate the INADDR_NONE definition for Solaris by moving it to jbsockets.h - - In block_url(), ditch the obsolete workaround for ancient Netscape versions - that supposedly couldn't properly deal with status code 403. - - Remove a useless NULL pointer check in load_trustfile(). - - Remove two useless NULL pointer checks in load_one_re_filterfile(). - - Change url_code_map[] from an array of pointers to an array of arrays - It removes an unnecessary layer of indirection and on 64bit system reduces - the size of the binary a bit. - - Fix various typos. Fixes taken from Debian's 29_typos.dpatch by Roland Rosenfeld. - - Add a dok-tidy GNUMakefile target to clean up the messy HTML - generated by the other dok targets. - - GNUisms in the GNUMakefile have been removed. - - Change the HTTP version in static responses to 1.1 - - Synced config.sub and config.guess with upstream - 2011-11-11/386c7218162c145f5f9e1ff7f558a3fbb66c37c5. - - Add a dedicated function to parse the values of toggles. Reduces duplicated - code in load_config() and provides better error handling. Invalid or missing - toggle values are now a fatal error instead of being silently ignored. - - Terminate HTML lines in static error messages with \n instead of \r\n. - - Simplify cgi_error_unknown() a bit. - - In LogPutString(), don't bother looking at pszText when not - actually logging anything. - - Change ssplit()'s fourth parameter from int to size_t. - Fixes a clang complaint. - - Add a warning that the statistics currently can't be trusted. - Mention Privoxy-Log-Parser's --statistics option as - an alternative for the time being. - - In rfc2553_connect_to(), start setting cgi->error_message on error. - - Change the expected status code returned for http://p.p/die depending - on whether or not FEATURE_GRACEFUL_TERMINATION is available. - - In cgi_die(), mark the client connection for closing. - If the client will fetch the style sheet through another connection - it gets the main thread out of the accept() state and should thus - trigger the actual shutdown. - - Add a proper CGI message for cgi_die(). - - Don't enforce a logical line length limit in read_config_line(). - - Slightly refactor server_last_modified() to remove useless gmtime*() calls. - - In get_content_type(), also recognize '.jpeg' as JPEG extension. - - Add '.png' to the list of recognized file extensions in get_content_type(). - - In block_url(), consistently use the block reason "Request blocked by Privoxy" - In two places the reason was "Request for blocked URL" which hides the - fact that the request got blocked by Privoxy and isn't necessarily - correct as the block may be due to tags. - - In listen_loop(), reload the configuration files after accepting - a new connection instead of before. - Previously the first connection that arrived after a configuration - change would still be handled with the old configuration. - - In chat()'s receive-data loop, skip a client socket check if - the socket will be written to right away anyway. This can - increase the transfer speed for unfiltered content on fast - network connections. - - The socket timeout is used for SOCKS negotiations as well which - previously couldn't timeout. - - Don't keep the client connection alive if any configuration file - changed since the time the connection came in. This is closer to - Privoxy's behaviour before keep-alive support for client connection - has been added and also less confusing in general. - - Treat all Content-Type header values containing the pattern - 'script' as a sign of text. Reported by pribog in #3134970. - -- Action file improvements: - - Moved the site-specific block pattern section below the one for the - generic patterns so for requests that are matched in both, the block - reason for the domain is shown which is usually more useful than showing - the one for the generic pattern. - - Remove -prevent-compression from the fragile alias. It's no longer - used anywhere by default and isn't known to break stuff anyway. - - Add a (disabled) section to block various Facebook tracking URLs. - Reported by Dan Stahlke in #3421764. - - Add a (disabled) section to rewrite and redirect click-tracking - URLs used on news.google.com. - Reported by Dan Stahlke in #3421755. - - Unblock linuxcounter.net/. - Reported by Dan Stahlke in #3422612. - - Block 'www91.intel.com/' which is used by Omniture. - Reported by Adam Piggott in #3167370. - - Disable the handle-as-empty-doc-returns-ok option and mark it as deprecated. - Reminded by tceverling in #2790091. - - Add ".ivwbox.de/" to the "Cross-site user tracking" section. - Reported by Nettozahler in #3172525. - - Unblock and fast-redirect ".awin1.com/.*=http://". - Reported by Adam Piggott in #3170921. - - Block "b.collective-media.net/". - - Widen the Debian popcon exception to "qa.debian.org/popcon". - Seen in Debian's 05_default_action.dpatch by Roland Rosenfeld. - - Block ".gemius.pl/" which only seems to be used for user tracking. - Reported by johnd16 in #3002731. Additional input from Lee and movax. - - Disable banners-by-size filters for '.thinkgeek.com/'. - The filter only seems to catch pictures of the inventory. - - Block requests for 'go.idmnet.bbelements.com/please/showit/'. - Reported by kacperdominik in #3372959. - - Unblock adainitiative.org/. - - Add a fast-redirects exception for '.googleusercontent.com/.*=cache'. - - Add a fast-redirects exception for webcache.googleusercontent.com/. - - Unblock http://adassier.wordpress.com/ and http://adassier.files.wordpress.com/. - -- Filter file improvements: - - Let the yahoo filter hide '.ads'. - - Let the msn filter hide overlay ads for Facebook 'likes' in search - results and elements with the id 's_notf_div'. They only seem to be - used to advertise site 'enhancements'. - - Let the js-events filter additionally disarm setInterval(). - Suggested by dg1727 in #3423775. - -- Documentation improvements: - - Clarify the effect of compiling Privoxy with zlib support. - Suggested by dg1727 in #3423782. - - Point out that the SourceForge messaging system works like a black - hole and should thus not be used to contact individual developers. - - Mention some of the problems one can experience when not explicitly - configuring an IP addresses as listen address. - - Explicitly mention that hostnames can be used instead of IP addresses - for the listen-address, that only the first address returned will be - used and what happens if the address is invalid. - Requested by Calestyo in #3302213. +*** Version 3.0.12 *** + +- The socket-timeout option now also works on platforms whose + select() implementation modifies the timeout structure. + Previously the timeout was triggered even if the connection + didn't stall. Reported by cyberpatrol. +- The Connection: keep-alive code properly deals with files + larger than 2GB. Previously the connection was closed too + early. +- The content length for files above 2GB is logged correctly. +- The user-manual directive on the show-status page links to + the documentation location specified with the directive, + not to the Privoxy website. +- When running in daemon mode, Privoxy doesn't log anything + to the console unless there are errors before the logfile + has been opened. +- The show-status page prints warnings about invalid directives + on the same line as the directives themselves. +- Fixed several justified (but harmless) compiler warnings, + mostly on 64 bit platforms. +- The mingw32 version explicitly requests the default charset + to prevent display problems with some fonts available on more + recent Windows versions. Patch by Burberry. +- The mingw32 version uses the Privoxy icon in the alt-tab + windows. Patch by Burberry. +- The timestamp and the thread id is omitted in the "Fatal error" + message box on mingw32. +- Fixed two related mingw32-only buffer overflows. Triggering + them required control over the configuration file, therefore + this isn't seen as a security issue. +- In verbose mode, or if the new option --show-skipped-tests + is used, Privoxy-Regression-Test logs skipped tests and the + skip reason.
-- Log message improvements: - - If only the server connection is kept alive, do not pretend to - wait for a new client request. - - Remove a superfluous log message in forget_connection(). - - In chat(), properly report missing server responses as such - instead of calling them empty. - - In forwarded_connect(), fix a log message nobody should ever see. - - Fix a log message in socks5_connect(), a failed write operation - was logged as failed read operation. - - Let load_one_actions_file() properly complain about a missing - '{' at the beginning of the file. - Simply stating that a line is invalid isn't particularly helpful. - - Do not claim to listen on a socket until Privoxy actually does. - Patch submitted by Petr Pisar #3354485 - - Prevent a duplicated LOG_LEVEL_CLF message when sending out - the "no-server-data" response. - - Also log the client socket when dropping a connection. - - Include the destination host in the 'Request ... marked for - blocking. limit-connect{...} doesn't allow CONNECT ...' message - Patch submitted by Saperski in #3296250. - - Prevent a duplicated log message if none of the resolved IP - addresses were reachable. - - In connect_to(), do not pretend to retry if forwarded-connect-retries - is zero or unset. - - When a specified user or group can't be found, put the name in - single-quotes when logging it. - - In rfc2553_connect_to(), explain getnameinfo() errors better. - - Remove a useless log message in chat(). - - When retrying to connect, also log the maximum number of connection - attempts. - - Rephrase a log message in compile_dynamic_pcrs_job_list(). - Divide the error code and its meaning with a colon. Call the pcrs - job dynamic and not the filter. Filters may contain dynamic and - non-dynamic pcrs jobs at the same time. Only mention the name of - the filter or tagger, but don't claim it's a filter when it could - be a tagger. - - In a fatal error message in load_one_actions_file(), cover both - URL and TAG patterns. - - In pcrs_strerror(), properly report unknown positive error code - values as such. Previously they were handled like 0 (no error). - - In compile_dynamic_pcrs_job_list(), also log the actual error code as - pcrs_strerror() doesn't handle all errors reported by pcre. - - Don't bother trying to continue chatting if the client didn't ask for it. - Reduces log noise a bit. - - Make two fatal error message in load_one_actions_file() more descriptive. - - In cgi_send_user_manual(), log when rejecting a file name due to '/' or '..'. - - In load_file(), log a message if opening a file failed. - The CGI error message alone isn't too helpful. - - In connection_destination_matches(), improve two log messages - to help understand why the destinations don't match. - - Rephrase a log message in serve(). Client request arrival - should be differentiated from closed client connections now. - - In serve(), log if a client connection isn't reused due to a - configuration file change. - - Let mark_server_socket_tainted() always mark the server socket tainted, - just don't talk about it in cases where it has no effect. It doesn't change - Privoxy's behaviour, but makes understanding the log file easier. - -- configure: - - Added a --disable-ipv6-support switch for platforms where support - is detected but doesn't actually work. - - Do not check for the existence of strerror() and memmove() twice - - Remove a useless test for setpgrp(2). Privoxy doesn't need it and - it can cause problems when cross-compiling. - - Rename the --disable-acl-files switch to --disable-acl-support. - Since about 2001, ACL directives are specified in the standard - config file. - - Update the URL of the 'Removing outdated PCRE version after the - next stable release' posting. The old URL stopped working after - one of SF's recent site "optimizations". Reported by Han Liu. - -- Privoxy-Regression-Test: - - Added --shuffle-tests option to increase the chances of detection race conditions. - - Added a --local-test-file option that allows to use Privoxy-Regression-Test without Privoxy. - - Added tests for missing socks4 and socks4a forwarders. - - The --privoxy-address option now works with IPv6 addresses containing brackets, too. - - Perform limited sanity checks for parameters that are supposed to have numerical values. - - Added a --sleep-time option to specify a number of seconds to - sleep between tests, defaults to 0. - - Disable the range-requests tagger for tests that break if it's enabled. - - Log messages use the ISO 8601 date format %Y-%m-%d. - - Fix spelling in two error messages. - - In the --help output, include a list of supported tests and their default levels. - - Adjust the tests to properly deal with FEATURE_TOGGLE being disabled. - -- Privoxy-Log-Parser: - - Perform limited sanity checks for command line parameters that - are supposed to have numerical values. - - Implement a --unbreak-lines-only option to try to revert MUA breakage. - - Accept and highlight: Added header: Content-Encoding: deflate - - Accept and highlight: Compressed content from 29258 to 8630 bytes. - - Accept and highlight: Client request arrived in time on socket 21. - - Highlight: Didn't receive data in time: a.fsdn.com:443 - - Accept log messages with ISO 8601 time stamps, too. - -- uagen: - - Bump generated Firefox version to 8.0. - - Only randomize the release date if the new --randomize-release-date - option is enabled. Firefox versions after 4 use a fixed date string - without meaning.
----------------------------------------------------------------- About Privoxy: @@ -383,18 +54,13 @@ flexible configuration and can be customized to suit individual needs and tastes. It has application for both stand-alone systems and multi-user networks.
-Privoxy is Free Software and licensed under the GNU GPLv2. +Privoxy is Free Software and licensed under the GPL2.
Privoxy is an associated project of Software in the Public Interest (SPI). - -Helping hands and donations are welcome: - - * http://www.privoxy.org/faq/general.html#PARTICIPATE - - * http://www.privoxy.org/faq/general.html#DONATE +Donations are welcome: http://www.privoxy.org/faq/general.html#DONATE
At present, Privoxy is known to run on Windows(95, 98, ME, 2000, -XP, Vista), GNU/Linux (Ubuntu, RedHat, SuSE, Debian, Fedora, Gentoo and +XP, Vista), Linux (Ubuntu, RedHat, SuSE, Debian, Fedora, Gentoo and others), Mac OSX, OS/2, AmigaOS, FreeBSD, NetBSD, OpenBSD, Solaris, and various other flavors of Unix.
@@ -403,12 +69,7 @@ Privoxy provides many supplemental features, that give the end-user more control, more privacy and more freedom:
- * Supports "Connection: keep-alive". Outgoing connections can be kept - alive independently from the client. Currently not available on all - platforms. - - * Supports IPv6, provided the operating system does so too, - and the configure script detects it. + * Can keep outgoing connections alive and reuse them later on.
* Supports tagging which allows to change the behaviour based on client and server headers. @@ -426,7 +87,8 @@ more control, more privacy and more freedom: tracing of rule and filter effects. Remote toggling.
* Web page filtering (text replacements, removes banners based on size, - invisible <quote>web-bugs</quote> and HTML annoyances, etc.) + invisible "web-bugs", JavaScript and HTML annoyances, pop-up windows, + etc.)
* Modularized configuration that allows for standard settings and user settings to reside in separate files, so that installing updated actions @@ -435,16 +97,23 @@ more control, more privacy and more freedom: * Support for Perl Compatible Regular Expressions in the configuration files, and a more sophisticated and flexible configuration syntax.
+ * Improved cookie management features (e.g. session based cookies). + * GIF de-animation.
* Bypass many click-tracking scripts (avoids script redirection).
+ * Multi-threaded (POSIX and native threads). + * User-customizable HTML templates for most proxy-generated pages (e.g. "blocked" page).
* Auto-detection and re-reading of config file changes. + + * Improved signal handling, and a true daemon mode (Unix).
- * Most features are controllable on a per-site or per-location basis. + * Every feature now controllable on a per-site or per-location basis, + configuration more powerful and versatile over-all.
Download location: diff --git a/external/privoxy/doc/webserver/developer-manual/coding.html b/external/privoxy/doc/webserver/developer-manual/coding.html index 345c739..48259ed 100644 --- a/external/privoxy/doc/webserver/developer-manual/coding.html +++ b/external/privoxy/doc/webserver/developer-manual/coding.html @@ -1,142 +1,218 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Coding Guidelines</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Developer Manual" href="index.html"> - <link rel="PREVIOUS" title="Documentation Guidelines" href= - "documentation.html"> - <link rel="NEXT" title="Testing Guidelines" href="testing.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - table.c3 {background-color: #E0E0E0} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Developer Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "documentation.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="testing.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="CODING" id="CODING">4. Coding - Guidelines</a></h1> - - <div class="SECT2"> - <h2 class="SECT2"><a name="S1" id="S1">4.1. Introduction</a></h2> - - <p>This set of standards is designed to make our lives easier. It is - developed with the simple goal of helping us keep the "new and improved - <span class="APPLICATION">Privoxy</span>" consistent and reliable. Thus - making maintenance easier and increasing chances of success of the - project.</p> - - <p>And that of course comes back to us as individuals. If we can - increase our development and product efficiencies then we can solve - more of the request for changes/improvements and in general feel good - about ourselves. ;-></p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="S2" id="S2">4.2. Using Comments</a></h2> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S3" id="S3">4.2.1. Comment, Comment, - Comment</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Comment as much as possible without commenting the obvious. For - example do not comment "variable_a is equal to variable_b". Instead - explain why variable_a should be equal to the variable_b. Just - because a person can read code does not mean they will understand why - or what is being done. A reader may spend a lot more time figuring - out what is going on when a simple comment or explanation would have - prevented the extra research. Please help your brother IJB'ers - out!</p> - - <p>The comments will also help justify the intent of the code. If the - comment describes something different than what the code is doing - then maybe a programming error is occurring.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -/* if page size greater than 1k ... */ -if ( page_length() > 1024 ) +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Coding Guidelines</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Documentation Guidelines" +HREF="documentation.html"><LINK +REL="NEXT" +TITLE="Testing Guidelines" +HREF="testing.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Developer Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="documentation.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="testing.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="CODING" +>4. Coding Guidelines</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="S1" +>4.1. Introduction</A +></H2 +><P +>This set of standards is designed to make our lives easier. It is + developed with the simple goal of helping us keep the "new and improved + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>" consistent and reliable. Thus making + maintenance easier and increasing chances of success of the + project.</P +><P +>And that of course comes back to us as individuals. If we can + increase our development and product efficiencies then we can solve more + of the request for changes/improvements and in general feel good about + ourselves. ;-></P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="S2" +>4.2. Using Comments</A +></H2 +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S3" +>4.2.1. Comment, Comment, Comment</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Comment as much as possible without commenting the obvious. + For example do not comment "variable_a is equal to variable_b". + Instead explain why variable_a should be equal to the variable_b. + Just because a person can read code does not mean they will + understand why or what is being done. A reader may spend a lot + more time figuring out what is going on when a simple comment + or explanation would have prevented the extra research. Please + help your brother IJB'ers out!</P +><P +>The comments will also help justify the intent of the code. + If the comment describes something different than what the code + is doing then maybe a programming error is occurring.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>/* if page size greater than 1k ... */ +if ( page_length() > 1024 ) { ... "block" the page up ... }
/* if page size is small, send it in blocks */ -if ( page_length() > 1024 ) +if ( page_length() > 1024 ) { ... "block" the page up ... }
This demonstrates 2 cases of "what not to do". The first is a "syntax comment". The second is a comment that does not fit what -is actually being done. -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S4" id="S4">4.2.2. Use blocks for - comments</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Comments can help or they can clutter. They help when they are - differentiated from the code they describe. One line comments do not - offer effective separation between the comment and the code. Block - identifiers do, by surrounding the code with a clear, definable - pattern.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -/********************************************************************* +is actually being done.</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S4" +>4.2.2. Use blocks for comments</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Comments can help or they can clutter. They help when they + are differentiated from the code they describe. One line + comments do not offer effective separation between the comment + and the code. Block identifiers do, by surrounding the code + with a clear, definable pattern.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>/********************************************************************* * This will stand out clearly in your code! *********************************************************************/ if ( this_variable == that_variable ) @@ -155,40 +231,65 @@ if ( this_variable == that_variable ) if ( this_variable == that_variable ) /* this may not either */ { do_something_very_important(); -} -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Exception:</span></p> - - <p>If you are trying to add a small logic comment and do not wish to - "disrupt" the flow of the code, feel free to use a 1 line comment - which is NOT on the same line as the code.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S5" id="S5">4.2.3. Keep Comments on their - own line</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>It goes back to the question of readability. If the comment is on - the same line as the code it will be harder to read than the comment - that is on its own line.</p> - - <p>There are three exceptions to this rule, which should be violated - freely and often: during the definition of variables, at the end of - closing braces, when used to comment parameters.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -/********************************************************************* +}</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Exception:</I +></SPAN +></P +><P +>If you are trying to add a small logic comment and do not + wish to "disrupt" the flow of the code, feel free to use a 1 + line comment which is NOT on the same line as the code.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S5" +>4.2.3. Keep Comments on their own line</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>It goes back to the question of readability. If the comment + is on the same line as the code it will be harder to read than + the comment that is on its own line.</P +><P +>There are three exceptions to this rule, which should be + violated freely and often: during the definition of variables, + at the end of closing braces, when used to comment + parameters.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>/********************************************************************* * This will stand out clearly in your code, * But the second example won't. *********************************************************************/ @@ -221,74 +322,116 @@ short do_something_very_important( { ...code here...
-} /* -END- do_something_very_important */ -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S6" id="S6">4.2.4. Comment each logical - step</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Logical steps should be commented to help others follow the intent - of the written code and comments will make the code more - readable.</p> - - <p>If you have 25 lines of code without a comment, you should - probably go back into it to see where you forgot to put one.</p> - - <p>Most "for", "while", "do", etc... loops _probably_ need a comment. - After all, these are usually major logic containers.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S7" id="S7">4.2.5. Comment All Functions - Thoroughly</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>A reader of the code should be able to look at the comments just - prior to the beginning of a function and discern the reason for its - existence and the consequences of using it. The reader should not - have to read through the code to determine if a given function is - safe for a desired use. The proper information thoroughly presented - at the introduction of a function not only saves time for subsequent - maintenance or debugging, it more importantly aids in code reuse by - allowing a user to determine the safety and applicability of any - function for the problem at hand. As a result of such benefits, all - functions should contain the information presented in the addendum - section of this document.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S8" id="S8">4.2.6. Comment at the end of - braces if the content is more than one screen length</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Each closing brace should be followed on the same line by a - comment that describes the origination of the brace if the original - brace is off of the screen, or otherwise far away from the closing - brace. This will simplify the debugging, maintenance, and readability - of the code.</p> - - <p>As a suggestion , use the following flags to make the comment and - its brace more readable:</p> - - <p>use following a closing brace: } /* -END- if() or while () or - etc... */</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -if ( 1 == X ) +} /* -END- do_something_very_important */</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S6" +>4.2.4. Comment each logical step</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Logical steps should be commented to help others follow the + intent of the written code and comments will make the code more + readable.</P +><P +>If you have 25 lines of code without a comment, you should + probably go back into it to see where you forgot to put + one.</P +><P +>Most "for", "while", "do", etc... loops _probably_ need a + comment. After all, these are usually major logic + containers.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S7" +>4.2.5. Comment All Functions Thoroughly</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>A reader of the code should be able to look at the comments + just prior to the beginning of a function and discern the + reason for its existence and the consequences of using it. The + reader should not have to read through the code to determine if + a given function is safe for a desired use. The proper + information thoroughly presented at the introduction of a + function not only saves time for subsequent maintenance or + debugging, it more importantly aids in code reuse by allowing a + user to determine the safety and applicability of any function + for the problem at hand. As a result of such benefits, all + functions should contain the information presented in the + addendum section of this document.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S8" +>4.2.6. Comment at the end of braces if the + content is more than one screen length</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Each closing brace should be followed on the same line by a + comment that describes the origination of the brace if the + original brace is off of the screen, or otherwise far away from + the closing brace. This will simplify the debugging, + maintenance, and readability of the code.</P +><P +>As a suggestion , use the following flags to make the + comment and its brace more readable:</P +><P +>use following a closing brace: } /* -END- if() or while () + or etc... */</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>if ( 1 == X ) { do_something_very_important(); ...some long list of commands... @@ -300,423 +443,735 @@ if ( 1 == X ) { do_something_very_important(); ...some long list of commands... -} /* -END- if ( 1 == X ) */ -</pre> - </td> - </tr> - </table> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="S9" id="S9">4.3. Naming Conventions</a></h2> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S10" id="S10">4.3.1. Variable - Names</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Use all lowercase, and separate words via an underscore ('_'). Do - not start an identifier with an underscore. (ANSI C reserves these - for use by the compiler and system headers.) Do not use identifiers - which are reserved in ANSI C++. (E.g. template, class, true, false, - ...). This is in case we ever decide to port Privoxy to C++.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -int ms_iis5_hack = 0; -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Instead of:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -int msiis5hack = 0; int msIis5Hack = 0; -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S11" id="S11">4.3.2. Function - Names</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Use all lowercase, and separate words via an underscore ('_'). Do - not start an identifier with an underscore. (ANSI C reserves these - for use by the compiler and system headers.) Do not use identifiers - which are reserved in ANSI C++. (E.g. template, class, true, false, - ...). This is in case we ever decide to port Privoxy to C++.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -int load_some_file( struct client_state *csp ) -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Instead of:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -int loadsomefile( struct client_state *csp ) -int loadSomeFile( struct client_state *csp ) -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S12" id="S12">4.3.3. Header file - prototypes</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Use a descriptive parameter name in the function prototype in - header files. Use the same parameter name in the header file that you - use in the c file.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -(.h) extern int load_aclfile( struct client_state *csp ); -(.c) int load_aclfile( struct client_state *csp ) -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Instead of:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -(.h) extern int load_aclfile( struct client_state * ); or -(.h) extern int load_aclfile(); -(.c) int load_aclfile( struct client_state *csp ) -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S13" id="S13">4.3.4. Enumerations, and - #defines</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Use all capital letters, with underscores between words. Do not - start an identifier with an underscore. (ANSI C reserves these for - use by the compiler and system headers.)</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -(enumeration) : enum Boolean { FALSE, TRUE }; -(#define) : #define DEFAULT_SIZE 100; -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Note:</span> We have a standard - naming scheme for #defines that toggle a feature in the preprocessor: - FEATURE_>, where > is a short (preferably 1 or 2 word) - description.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -#define FEATURE_FORCE 1 +} /* -END- if ( 1 == X ) */</PRE +></TD +></TR +></TABLE +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="S9" +>4.3. Naming Conventions</A +></H2 +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S10" +>4.3.1. Variable Names</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Use all lowercase, and separate words via an underscore + ('_'). Do not start an identifier with an underscore. (ANSI C + reserves these for use by the compiler and system headers.) Do + not use identifiers which are reserved in ANSI C++. (E.g. + template, class, true, false, ...). This is in case we ever + decide to port Privoxy to C++.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>int ms_iis5_hack = 0;</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Instead of:</I +></SPAN +></P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>int msiis5hack = 0; int msIis5Hack = 0;</PRE +></TD +></TR +></TABLE +></P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S11" +>4.3.2. Function Names</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Use all lowercase, and separate words via an underscore + ('_'). Do not start an identifier with an underscore. (ANSI C + reserves these for use by the compiler and system headers.) Do + not use identifiers which are reserved in ANSI C++. (E.g. + template, class, true, false, ...). This is in case we ever + decide to port Privoxy to C++.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>int load_some_file( struct client_state *csp )</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Instead of:</I +></SPAN +></P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>int loadsomefile( struct client_state *csp ) +int loadSomeFile( struct client_state *csp )</PRE +></TD +></TR +></TABLE +></P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S12" +>4.3.3. Header file prototypes</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Use a descriptive parameter name in the function prototype + in header files. Use the same parameter name in the header file + that you use in the c file.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>(.h) extern int load_aclfile( struct client_state *csp ); +(.c) int load_aclfile( struct client_state *csp )</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Instead of:</I +></SPAN +> +<TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>(.h) extern int load_aclfile( struct client_state * ); or +(.h) extern int load_aclfile(); +(.c) int load_aclfile( struct client_state *csp )</PRE +></TD +></TR +></TABLE +></P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S13" +>4.3.4. Enumerations, and #defines</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Use all capital letters, with underscores between words. Do + not start an identifier with an underscore. (ANSI C reserves + these for use by the compiler and system headers.)</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>(enumeration) : enum Boolean { FALSE, TRUE }; +(#define) : #define DEFAULT_SIZE 100;</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> We have a standard naming scheme for #defines + that toggle a feature in the preprocessor: FEATURE_>, where + > is a short (preferably 1 or 2 word) description.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>#define FEATURE_FORCE 1
#ifdef FEATURE_FORCE #define FORCE_PREFIX blah -#endif /* def FEATURE_FORCE */ -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S14" id="S14">4.3.5. Constants</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Spell common words out entirely (do not remove vowels).</p> - - <p>Use only widely-known domain acronyms and abbreviations. - Capitalize all letters of an acronym.</p> - - <p>Use underscore (_) to separate adjacent acronyms and - abbreviations. Never terminate a name with an underscore.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -#define USE_IMAGE_LIST 1 -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Instead of:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -#define USE_IMG_LST 1 or +#endif /* def FEATURE_FORCE */</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S14" +>4.3.5. Constants</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Spell common words out entirely (do not remove vowels).</P +><P +>Use only widely-known domain acronyms and abbreviations. + Capitalize all letters of an acronym.</P +><P +>Use underscore (_) to separate adjacent acronyms and + abbreviations. Never terminate a name with an underscore.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>#define USE_IMAGE_LIST 1</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Instead of:</I +></SPAN +></P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>#define USE_IMG_LST 1 or #define _USE_IMAGE_LIST 1 or -#define USE_IMAGE_LIST_ 1 or +#define USE_IMAGE_LIST_ 1 or #define use_image_list 1 or -#define UseImageList 1 -</pre> - </td> - </tr> - </table> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="S15" id="S15">4.4. Using Space</a></h2> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S16" id="S16">4.4.1. Put braces on a line - by themselves.</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>The brace needs to be on a line all by itself, not at the end of - the statement. Curly braces should line up with the construct that - they're associated with. This practice makes it easier to identify - the opening and closing braces for a block.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -if ( this == that ) +#define UseImageList 1</PRE +></TD +></TR +></TABLE +></P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="S15" +>4.4. Using Space</A +></H2 +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S16" +>4.4.1. Put braces on a line by themselves.</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>The brace needs to be on a line all by itself, not at the + end of the statement. Curly braces should line up with the + construct that they're associated with. This practice makes it + easier to identify the opening and closing braces for a + block.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>if ( this == that ) { ... -} -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Instead of:</span></p> - - <p>if ( this == that ) { ... }</p> - - <p>or</p> - - <p>if ( this == that ) { ... }</p> - - <p><span class="emphasis EMPHASIS c2">Note:</span> In the special - case that the if-statement is inside a loop, and it is trivial, i.e. - it tests for a condition that is obvious from the purpose of the - block, one-liners as above may optically preserve the loop structure - and make it easier to read.</p> - - <p><span class="emphasis EMPHASIS c2">Status:</span> - developer-discretion.</p> - - <p><span class="emphasis EMPHASIS c2">Example exception:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -while ( more lines are read ) +}</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Instead of:</I +></SPAN +></P +><P +>if ( this == that ) { ... }</P +><P +>or</P +><P +>if ( this == that ) { ... }</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> In the special case that the if-statement is + inside a loop, and it is trivial, i.e. it tests for a + condition that is obvious from the purpose of the block, + one-liners as above may optically preserve the loop structure + and make it easier to read.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Status:</I +></SPAN +> developer-discretion.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example exception:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>while ( more lines are read ) { /* Please document what is/is not a comment line here */ if ( it's a comment ) continue;
do_something( line ); -} -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S17" id="S17">4.4.2. ALL control - statements should have a block</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Using braces to make a block will make your code more readable and - less prone to error. All control statements should have a block - defined.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -if ( this == that ) +}</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S17" +>4.4.2. ALL control statements should have a + block</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Using braces to make a block will make your code more + readable and less prone to error. All control statements should + have a block defined.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>if ( this == that ) { do_something(); do_something_else(); -} -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Instead of:</span></p> - - <p>if ( this == that ) do_something(); do_something_else();</p> - - <p>or</p> - - <p>if ( this == that ) do_something();</p> - - <p><span class="emphasis EMPHASIS c2">Note:</span> The first example - in "Instead of" will execute in a manner other than that which the - developer desired (per indentation). Using code braces would have - prevented this "feature". The "explanation" and "exception" from the - point above also applies.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S18" id="S18">4.4.3. Do not - belabor/blow-up boolean expressions</a></h3> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -structure->flag = ( condition ); -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Instead of:</span></p> - - <p>if ( condition ) { structure->flag = 1; } else { - structure->flag = 0; }</p> - - <p><span class="emphasis EMPHASIS c2">Note:</span> The former is - readable and concise. The later is wordy and inefficient. Please - assume that any developer new to the project has at least a "good" - knowledge of C/C++. (Hope I do not offend by that last comment ... - 8-)</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S19" id="S19">4.4.4. Use white space - freely because it is free</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Make it readable. The notable exception to using white space - freely is listed in the next guideline.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -int first_value = 0; +}</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Instead of:</I +></SPAN +></P +><P +>if ( this == that ) do_something(); do_something_else();</P +><P +>or</P +><P +>if ( this == that ) do_something();</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> The first example in "Instead of" will execute + in a manner other than that which the developer desired (per + indentation). Using code braces would have prevented this + "feature". The "explanation" and "exception" from the point + above also applies.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S18" +>4.4.3. Do not belabor/blow-up boolean + expressions</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>structure->flag = ( condition );</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Instead of:</I +></SPAN +></P +><P +>if ( condition ) { structure->flag = 1; } else { + structure->flag = 0; }</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> The former is readable and concise. The later + is wordy and inefficient. Please assume that any developer new + to the project has at least a "good" knowledge of C/C++. (Hope + I do not offend by that last comment ... 8-)</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S19" +>4.4.4. Use white space freely because it is + free</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Make it readable. The notable exception to using white space + freely is listed in the next guideline.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>int first_value = 0; int some_value = 0; int another_value = 0; int this_variable = 0;
if ( this_variable == this_variable )
-first_value = old_value + ( ( some_value - another_value ) - whatever ) -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S20" id="S20">4.4.5. Don't use white space - around structure operators</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>- structure pointer operator ( "->" ) - member operator ( "." ) - - functions and parentheses</p> - - <p>It is a general coding practice to put pointers, references, and - function parentheses next to names. With spaces, the connection - between the object and variable/function name is not as clear.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -a_struct->a_member; +first_value = old_value + ( ( some_value - another_value ) - whatever )</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S20" +>4.4.5. Don't use white space around structure + operators</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>- structure pointer operator ( "->" ) - member operator ( + "." ) - functions and parentheses</P +><P +>It is a general coding practice to put pointers, references, + and function parentheses next to names. With spaces, the + connection between the object and variable/function name is not + as clear.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>a_struct->a_member; a_struct.a_member; -function_name(); -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Instead of:</span> a_struct - -> a_member; a_struct . a_member; function_name ();</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S21" id="S21">4.4.6. Make the last brace - of a function stand out</a></h3> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -int function1( ... ) +function_name();</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Instead of:</I +></SPAN +> a_struct -> a_member; a_struct . a_member; + function_name ();</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S21" +>4.4.6. Make the last brace of a function stand + out</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>int function1( ... ) { ...code... return( ret_code ); @@ -726,48 +1181,83 @@ int function1( ... )
int function2( ... ) { -} /* -END- function2 */ -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Instead of:</span></p> - - <p>int function1( ... ) { ...code... return( ret_code ); } int - function2( ... ) { }</p> - - <p><span class="emphasis EMPHASIS c2">Note:</span> Use 1 blank line - before the closing brace and 2 lines afterward. This makes the end of - function standout to the most casual viewer. Although function - comments help separate functions, this is still a good coding - practice. In fact, I follow these rules when using blocks in "for", - "while", "do" loops, and long if {} statements too. After all - whitespace is free!</p> - - <p><span class="emphasis EMPHASIS c2">Status:</span> - developer-discretion on the number of blank lines. Enforced is the - end of function comments.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S22" id="S22">4.4.7. Use 3 character - indentions</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>If some use 8 character TABs and some use 3 character TABs, the - code can look *very* ragged. So use 3 character indentions only. If - you like to use TABs, pass your code through a filter such as "expand - -t3" before checking in your code.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -static const char * const url_code_map[256] = +} /* -END- function2 */</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Instead of:</I +></SPAN +></P +><P +>int function1( ... ) { ...code... return( ret_code ); } int + function2( ... ) { }</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> Use 1 blank line before the closing brace and 2 + lines afterward. This makes the end of function standout to + the most casual viewer. Although function comments help + separate functions, this is still a good coding practice. In + fact, I follow these rules when using blocks in "for", "while", + "do" loops, and long if {} statements too. After all whitespace + is free!</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Status:</I +></SPAN +> developer-discretion on the number of blank + lines. Enforced is the end of function comments.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S22" +>4.4.7. Use 3 character indentions</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>If some use 8 character TABs and some use 3 character TABs, + the code can look *very* ragged. So use 3 character indentions + only. If you like to use TABs, pass your code through a filter + such as "expand -t3" before checking in your code.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>static const char * const url_code_map[256] = { NULL, ... }; @@ -786,273 +1276,477 @@ int function1( ... )
return( NEVER_GETS_HERE );
-} -</pre> - </td> - </tr> - </table> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="S23" id="S23">4.5. Initializing</a></h2> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S24" id="S24">4.5.1. Initialize all - variables</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Do not assume that the variables declared will not be used until - after they have been assigned a value somewhere else in the code. - Remove the chance of accidentally using an unassigned variable.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -short a_short = 0; +}</PRE +></TD +></TR +></TABLE +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="S23" +>4.5. Initializing</A +></H2 +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S24" +>4.5.1. Initialize all variables</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Do not assume that the variables declared will not be used + until after they have been assigned a value somewhere else in + the code. Remove the chance of accidentally using an unassigned + variable.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>short a_short = 0; float a_float = 0; -struct *ptr = NULL; -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Note:</span> It is much easier - to debug a SIGSEGV if the message says you are trying to access - memory address 00000000 and not 129FA012; or array_ptr[20] causes a - SIGSEV vs. array_ptr[0].</p> - - <p><span class="emphasis EMPHASIS c2">Status:</span> - developer-discretion if and only if the variable is assigned a value - "shortly after" declaration.</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="S25" id="S25">4.6. Functions</a></h2> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S26" id="S26">4.6.1. Name functions that - return a boolean as a question.</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Value should be phrased as a question that would logically be - answered as a true or false statement</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -should_we_block_this(); +struct *ptr = NULL;</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> It is much easier to debug a SIGSEGV if the + message says you are trying to access memory address 00000000 + and not 129FA012; or array_ptr[20] causes a SIGSEV vs. + array_ptr[0].</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Status:</I +></SPAN +> developer-discretion if and only if the + variable is assigned a value "shortly after" declaration.</P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="S25" +>4.6. Functions</A +></H2 +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S26" +>4.6.1. Name functions that return a boolean as a + question.</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Value should be phrased as a question that would logically + be answered as a true or false statement</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>should_we_block_this(); contains_an_image(); -is_web_page_blank(); -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S27" id="S27">4.6.2. Always specify a - return type for a function.</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>The default return for a function is an int. To avoid ambiguity, - create a return for a function when the return has a purpose, and - create a void return type if the function does not need to return - anything.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S28" id="S28">4.6.3. Minimize function - calls when iterating by using variables</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>It is easy to write the following code, and a clear argument can - be made that the code is easy to understand:</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -for ( size_t cnt = 0; cnt < block_list_length(); cnt++ ) +is_web_page_blank();</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S27" +>4.6.2. Always specify a return type for a + function.</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>The default return for a function is an int. To avoid + ambiguity, create a return for a function when the return has a + purpose, and create a void return type if the function does not + need to return anything.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S28" +>4.6.3. Minimize function calls when iterating by + using variables</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>It is easy to write the following code, and a clear argument + can be made that the code is easy to understand:</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>for ( size_t cnt = 0; cnt < block_list_length(); cnt++ ) { .... -} -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Note:</span> Unfortunately, - this makes a function call for each and every iteration. This - increases the overhead in the program, because the compiler has to - look up the function each time, call it, and return a value. - Depending on what occurs in the block_list_length() call, it might - even be creating and destroying structures with each iteration, even - though in each case it is comparing "cnt" to the same value, over and - over. Remember too - even a call to block_list_length() is a function - call, with the same overhead.</p> - - <p>Instead of using a function call during the iterations, assign the - value to a variable, and evaluate using the variable.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -size_t len = block_list_length(); - -for ( size_t cnt = 0; cnt < len; cnt++ ) +}</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> Unfortunately, this makes a function call for + each and every iteration. This increases the overhead in the + program, because the compiler has to look up the function each + time, call it, and return a value. Depending on what occurs in + the block_list_length() call, it might even be creating and + destroying structures with each iteration, even though in each + case it is comparing "cnt" to the same value, over and over. + Remember too - even a call to block_list_length() is a function + call, with the same overhead.</P +><P +>Instead of using a function call during the iterations, + assign the value to a variable, and evaluate using the + variable.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>size_t len = block_list_length(); + +for ( size_t cnt = 0; cnt < len; cnt++ ) { .... -} -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Exceptions:</span> if the value - of block_list_length() *may* change or could *potentially* change, - then you must code the function call in the for/while loop.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S29" id="S29">4.6.4. Pass and Return by - Const Reference</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>This allows a developer to define a const pointer and call your - function. If your function does not have the const keyword, we may - not be able to use your function. Consider strcmp, if it were defined - as: extern int strcmp( char *s1, char *s2 );</p> - - <p>I could then not use it to compare argv's in main: int main( int - argc, const char *argv[] ) { strcmp( argv[0], "privoxy" ); }</p> - - <p>Both these pointers are *const*! If the c runtime library - maintainers do it, we should too.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S30" id="S30">4.6.5. Pass and Return by - Value</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Most structures cannot fit onto a normal stack entry (i.e. they - are not 4 bytes or less). Aka, a function declaration like: int - load_aclfile( struct client_state csp )</p> - - <p>would not work. So, to be consistent, we should declare all - prototypes with "pass by value": int load_aclfile( struct - client_state *csp )</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S31" id="S31">4.6.6. Names of include - files</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Your include statements should contain the file name without a - path. The path should be listed in the Makefile, using -I as - processor directive to search the indicated paths. An exception to - this would be for some proprietary software that utilizes a partial - path to distinguish their header files from system or other header - files.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -#include <iostream.h> /* This is not a local include */ -#include "config.h" /* This IS a local include */ -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Exception:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -/* This is not a local include, but requires a path element. */ -#include <sys/fileName.h> -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Note:</span> Please! do not add - "-I." to the Makefile without a _very_ good reason. This duplicates - the #include "file.h" behavior.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S32" id="S32">4.6.7. Provide multiple - inclusion protection</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Prevents compiler and linker errors resulting from redefinition of - items.</p> - - <p>Wrap each header file with the following syntax to prevent - multiple inclusions of the file. Of course, replace PROJECT_H with - your file name, with "." Changed to "_", and make it uppercase.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -#ifndef PROJECT_H_INCLUDED +}</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Exceptions:</I +></SPAN +> if the value of block_list_length() + *may* change or could *potentially* change, then you must code the + function call in the for/while loop.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S29" +>4.6.4. Pass and Return by Const Reference</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>This allows a developer to define a const pointer and call + your function. If your function does not have the const + keyword, we may not be able to use your function. Consider + strcmp, if it were defined as: extern int strcmp( char *s1, + char *s2 );</P +><P +>I could then not use it to compare argv's in main: int main( + int argc, const char *argv[] ) { strcmp( argv[0], "privoxy" + ); }</P +><P +>Both these pointers are *const*! If the c runtime library + maintainers do it, we should too.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S30" +>4.6.5. Pass and Return by Value</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Most structures cannot fit onto a normal stack entry (i.e. + they are not 4 bytes or less). Aka, a function declaration + like: int load_aclfile( struct client_state csp )</P +><P +>would not work. So, to be consistent, we should declare all + prototypes with "pass by value": int load_aclfile( struct + client_state *csp )</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S31" +>4.6.6. Names of include files</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Your include statements should contain the file name without + a path. The path should be listed in the Makefile, using -I as + processor directive to search the indicated paths. An exception + to this would be for some proprietary software that utilizes a + partial path to distinguish their header files from system or + other header files.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>#include <iostream.h> /* This is not a local include */ +#include "config.h" /* This IS a local include */</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Exception:</I +></SPAN +></P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>/* This is not a local include, but requires a path element. */ +#include <sys/fileName.h></PRE +></TD +></TR +></TABLE +></P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> Please! do not add "-I." to the Makefile + without a _very_ good reason. This duplicates the #include + "file.h" behavior.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S32" +>4.6.7. Provide multiple inclusion + protection</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Prevents compiler and linker errors resulting from + redefinition of items.</P +><P +>Wrap each header file with the following syntax to prevent + multiple inclusions of the file. Of course, replace PROJECT_H + with your file name, with "." Changed to "_", and make it + uppercase.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>#ifndef PROJECT_H_INCLUDED #define PROJECT_H_INCLUDED ... -#endif /* ndef PROJECT_H_INCLUDED */ -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S33" id="S33">4.6.8. Use `extern "C"` when - appropriate</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>If our headers are included from C++, they must declare our - functions as `extern "C"`. This has no cost in C, but increases the - potential re-usability of our code.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -#ifdef __cplusplus +#endif /* ndef PROJECT_H_INCLUDED */</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S33" +>4.6.8. Use `extern "C"` when appropriate</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>If our headers are included from C++, they must declare our + functions as `extern "C"`. This has no cost in C, but increases + the potential re-usability of our code.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>#ifdef __cplusplus extern "C" { #endif /* def __cplusplus */ @@ -1061,81 +1755,145 @@ extern "C"
#ifdef __cplusplus } -#endif /* def __cplusplus */ -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S34" id="S34">4.6.9. Where Possible, Use - Forward Struct Declaration Instead of Includes</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Useful in headers that include pointers to other struct's. - Modifications to excess header files may cause needless compiles.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -/********************************************************************* +#endif /* def __cplusplus */</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S34" +>4.6.9. Where Possible, Use Forward Struct + Declaration Instead of Includes</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Useful in headers that include pointers to other struct's. + Modifications to excess header files may cause needless + compiles.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>/********************************************************************* * We're avoiding an include statement here! *********************************************************************/ struct file_list; -extern file_list *xyz; -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Note:</span> If you declare - "file_list xyz;" (without the pointer), then including the proper - header file is necessary. If you only want to prototype a pointer, - however, the header file is unnecessary.</p> - - <p><span class="emphasis EMPHASIS c2">Status:</span> Use with - discretion.</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="S35" id="S35">4.7. General Coding - Practices</a></h2> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S36" id="S36">4.7.1. Turn on - warnings</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation</span></p> - - <p>Compiler warnings are meant to help you find bugs. You should turn - on as many as possible. With GCC, the switch is "-Wall". Try and fix - as many warnings as possible.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S37" id="S37">4.7.2. Provide a default - case for all switch statements</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>What you think is guaranteed is never really guaranteed. The value - that you don't think you need to check is the one that someday will - be passed. So, to protect yourself from the unknown, always have a - default step in a switch statement.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -switch( hash_string( cmd ) ) +extern file_list *xyz;</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> If you declare "file_list xyz;" (without the + pointer), then including the proper header file is necessary. + If you only want to prototype a pointer, however, the header + file is unnecessary.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Status:</I +></SPAN +> Use with discretion.</P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="S35" +>4.7. General Coding Practices</A +></H2 +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S36" +>4.7.1. Turn on warnings</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation</I +></SPAN +></P +><P +>Compiler warnings are meant to help you find bugs. You + should turn on as many as possible. With GCC, the switch is + "-Wall". Try and fix as many warnings as possible.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S37" +>4.7.2. Provide a default case for all switch + statements</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>What you think is guaranteed is never really guaranteed. The + value that you don't think you need to check is the one that + someday will be passed. So, to protect yourself from the + unknown, always have a default step in a switch statement.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>switch( hash_string( cmd ) ) { case hash_actions_file : ... code ... @@ -1150,243 +1908,435 @@ switch( hash_string( cmd ) ) ... anomaly code goes here ... continue; / break; / exit( 1 ); / etc ...
-} /* end switch( hash_string( cmd ) ) */ -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Note:</span> If you already - have a default condition, you are obviously exempt from this point. - Of note, most of the WIN32 code calls `DefWindowProc' after the - switch statement. This API call *should* be included in a default - statement.</p> - - <p><span class="emphasis EMPHASIS c2">Another Note:</span> This is - not so much a readability issue as a robust programming issue. The - "anomaly code goes here" may be no more than a print to the STDERR - stream (as in load_config). Or it may really be an abort - condition.</p> - - <p><span class="emphasis EMPHASIS c2">Status:</span> Programmer - discretion is advised.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S38" id="S38">4.7.3. Try to avoid falling - through cases in a switch statement.</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>In general, you will want to have a 'break' statement within each - 'case' of a switch statement. This allows for the code to be more - readable and understandable, and furthermore can prevent unwanted - surprises if someone else later gets creative and moves the code - around.</p> - - <p>The language allows you to plan the fall through from one case - statement to another simply by omitting the break statement within - the case statement. This feature does have benefits, but should only - be used in rare cases. In general, use a break statement for each - case statement.</p> - - <p>If you choose to allow fall through, you should comment both the - fact of the fall through and reason why you felt it was - necessary.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S39" id="S39">4.7.4. Use 'long' or 'short' - Instead of 'int'</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>On 32-bit platforms, int usually has the range of long. On 16-bit - platforms, int has the range of short.</p> - - <p><span class="emphasis EMPHASIS c2">Status:</span> open-to-debate. - In the case of most FSF projects (including X/GNU-Emacs), there are - typedefs to int4, int8, int16, (or equivalence ... I forget the exact - typedefs now). Should we add these to IJB now that we have a - "configure" script?</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S40" id="S40">4.7.5. Don't mix size_t and - other types</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>The type of size_t varies across platforms. Do not make - assumptions about whether it is signed or unsigned, or about how long - it is. Do not compare a size_t against another variable of a - different type (or even against a constant) without casting one of - the values.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S41" id="S41">4.7.6. Declare each variable - and struct on its own line.</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>It can be tempting to declare a series of variables all on one - line. Don't.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -long a = 0; +} /* end switch( hash_string( cmd ) ) */</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> If you already have a default condition, you + are obviously exempt from this point. Of note, most of the + WIN32 code calls `DefWindowProc' after the switch statement. + This API call *should* be included in a default statement.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Another Note:</I +></SPAN +> This is not so much a readability issue + as a robust programming issue. The "anomaly code goes here" may + be no more than a print to the STDERR stream (as in + load_config). Or it may really be an abort condition.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Status:</I +></SPAN +> Programmer discretion is advised.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S38" +>4.7.3. Try to avoid falling through cases in a + switch statement.</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>In general, you will want to have a 'break' statement within + each 'case' of a switch statement. This allows for the code to + be more readable and understandable, and furthermore can + prevent unwanted surprises if someone else later gets creative + and moves the code around.</P +><P +>The language allows you to plan the fall through from one + case statement to another simply by omitting the break + statement within the case statement. This feature does have + benefits, but should only be used in rare cases. In general, + use a break statement for each case statement.</P +><P +>If you choose to allow fall through, you should comment both + the fact of the fall through and reason why you felt it was + necessary.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S39" +>4.7.4. Use 'long' or 'short' Instead of + 'int'</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>On 32-bit platforms, int usually has the range of long. On + 16-bit platforms, int has the range of short.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Status:</I +></SPAN +> open-to-debate. In the case of most FSF + projects (including X/GNU-Emacs), there are typedefs to int4, + int8, int16, (or equivalence ... I forget the exact typedefs + now). Should we add these to IJB now that we have a "configure" + script?</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S40" +>4.7.5. Don't mix size_t and other types</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>The type of size_t varies across platforms. Do not make + assumptions about whether it is signed or unsigned, or about + how long it is. Do not compare a size_t against another + variable of a different type (or even against a constant) + without casting one of the values.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S41" +>4.7.6. Declare each variable and struct on its + own line.</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>It can be tempting to declare a series of variables all on + one line. Don't.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>long a = 0; long b = 0; -long c = 0; -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Instead of:</span></p> - - <p>long a, b, c;</p> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span> - there is - more room for comments on the individual variables - easier to add - new variables without messing up the original ones - when searching - on a variable to find its type, there is less clutter to "visually" - eliminate</p> - - <p><span class="emphasis EMPHASIS c2">Exceptions:</span> when you - want to declare a bunch of loop variables or other trivial variables; - feel free to declare them on one line. You should, although, provide - a good comment on their functions.</p> - - <p><span class="emphasis EMPHASIS c2">Status:</span> - developer-discretion.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S42" id="S42">4.7.7. Use malloc/zalloc - sparingly</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>Create a local struct (on the stack) if the variable will live and - die within the context of one function call.</p> - - <p>Only "malloc" a struct (on the heap) if the variable's life will - extend beyond the context of one function call.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -If a function creates a struct and stores a pointer to it in a -list, then it should definitely be allocated via `malloc'. -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S43" id="S43">4.7.8. The Programmer Who - Uses 'malloc' is Responsible for Ensuring 'free'</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>If you have to "malloc" an instance, you are responsible for - insuring that the instance is `free'd, even if the deallocation event - falls within some other programmer's code. You are also responsible - for ensuring that deletion is timely (i.e. not too soon, not too - late). This is known as "low-coupling" and is a "good thing (tm)". - You may need to offer a free/unload/destructor type function to - accommodate this.</p> - - <p><span class="emphasis EMPHASIS c2">Example:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -int load_re_filterfile( struct client_state *csp ) { ... } -static void unload_re_filterfile( void *f ) { ... } -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Exceptions:</span></p> - - <p>The developer cannot be expected to provide `free'ing functions - for C run-time library functions ... such as `strdup'.</p> - - <p><span class="emphasis EMPHASIS c2">Status:</span> - developer-discretion. The "main" use of this standard is for - allocating and freeing data structures (complex or nested).</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S44" id="S44">4.7.9. Add loaders to the - `file_list' structure and in order</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>I have ordered all of the "blocker" file code to be in alpha - order. It is easier to add/read new blockers when you expect a - certain order.</p> - - <p><span class="emphasis EMPHASIS c2">Note:</span> It may appear that - the alpha order is broken in places by POPUP tests coming before PCRS - tests. But since POPUPs can also be referred to as KILLPOPUPs, it is - clear that it should come first.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="S45" id="S45">4.7.10. "Uncertain" new code - and/or changes to existing code, use FIXME or XXX</a></h3> - - <p><span class="emphasis EMPHASIS c2">Explanation:</span></p> - - <p>If you have enough confidence in new code or confidence in your - changes, but are not *quite* sure of the repercussions, add this:</p> - - <p>/* FIXME: this code has a logic error on platform XYZ, * - attempting to fix */ #ifdef PLATFORM ...changed code here... - #endif</p> - - <p>or:</p> - - <p>/* FIXME: I think the original author really meant this... */ - ...changed code here...</p> - - <p>or:</p> - - <p>/* FIXME: new code that *may* break something else... */ ...new - code here...</p> - - <p><span class="emphasis EMPHASIS c2">Note:</span> If you make it - clear that this may or may not be a "good thing (tm)", it will be - easier to identify and include in the project (or conversely exclude - from the project).</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="S46" id="S46">4.8. Addendum: Template for - files and function comment blocks:</a></h2> - - <p><span class="emphasis EMPHASIS c2">Example for file - comments:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -const char FILENAME_rcs[] = "$Id: coding.html,v 1.58 2011/12/26 17:06:24 fabiankeil Exp $"; +long c = 0;</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Instead of:</I +></SPAN +></P +><P +>long a, b, c;</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +> - there is more room for comments on the + individual variables - easier to add new variables without + messing up the original ones - when searching on a variable to + find its type, there is less clutter to "visually" + eliminate</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Exceptions:</I +></SPAN +> when you want to declare a bunch of loop + variables or other trivial variables; feel free to declare them + on one line. You should, although, provide a good comment on + their functions.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Status:</I +></SPAN +> developer-discretion.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S42" +>4.7.7. Use malloc/zalloc sparingly</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>Create a local struct (on the stack) if the variable will + live and die within the context of one function call.</P +><P +>Only "malloc" a struct (on the heap) if the variable's life + will extend beyond the context of one function call.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>If a function creates a struct and stores a pointer to it in a +list, then it should definitely be allocated via `malloc'.</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S43" +>4.7.8. The Programmer Who Uses 'malloc' is + Responsible for Ensuring 'free'</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>If you have to "malloc" an instance, you are responsible for + insuring that the instance is `free'd, even if the deallocation + event falls within some other programmer's code. You are also + responsible for ensuring that deletion is timely (i.e. not too + soon, not too late). This is known as "low-coupling" and is a + "good thing (tm)". You may need to offer a + free/unload/destructor type function to accommodate this.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>int load_re_filterfile( struct client_state *csp ) { ... } +static void unload_re_filterfile( void *f ) { ... }</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Exceptions:</I +></SPAN +></P +><P +>The developer cannot be expected to provide `free'ing + functions for C run-time library functions ... such as + `strdup'.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Status:</I +></SPAN +> developer-discretion. The "main" use of this + standard is for allocating and freeing data structures (complex + or nested).</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S44" +>4.7.9. Add loaders to the `file_list' structure + and in order</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>I have ordered all of the "blocker" file code to be in alpha + order. It is easier to add/read new blockers when you expect a + certain order.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> It may appear that the alpha order is broken in + places by POPUP tests coming before PCRS tests. But since + POPUPs can also be referred to as KILLPOPUPs, it is clear that + it should come first.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="S45" +>4.7.10. "Uncertain" new code and/or changes to + existing code, use FIXME or XXX</A +></H3 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Explanation:</I +></SPAN +></P +><P +>If you have enough confidence in new code or confidence in + your changes, but are not *quite* sure of the repercussions, + add this:</P +><P +>/* FIXME: this code has a logic error on platform XYZ, * + attempting to fix */ #ifdef PLATFORM ...changed code here... + #endif</P +><P +>or:</P +><P +>/* FIXME: I think the original author really meant this... + */ ...changed code here...</P +><P +>or:</P +><P +>/* FIXME: new code that *may* break something else... */ + ...new code here...</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> If you make it clear that this may or may not + be a "good thing (tm)", it will be easier to identify and + include in the project (or conversely exclude from the + project).</P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="S46" +>4.8. Addendum: Template for files and function + comment blocks:</A +></H2 +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example for file comments:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>const char FILENAME_rcs[] = "$Id: coding.html,v 1.42 2009/03/21 12:59:32 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/doc/webserver/developer-manual/coding.html,v $ @@ -1411,10 +2361,16 @@ const char FILENAME_rcs[] = "$Id: coding.html,v 1.58 2011/12/26 17:06:24 fabiank * The GNU General Public License should be included with * this file. If not, you can view it at * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html - * or write to the Free Software Foundation, Inc., + * or write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 , * USA * + * Revisions : + * $Log: coding.html,v $ + * Revision 1.42 2009/03/21 12:59:32 fabiankeil + * Rebuild with recent changes. + * + * *********************************************************************/
@@ -1422,33 +2378,52 @@ const char FILENAME_rcs[] = "$Id: coding.html,v 1.58 2011/12/26 17:06:24 fabiank
...necessary include files for us to do our work...
-const char FILENAME_h_rcs[] = FILENAME_H_VERSION; -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Note:</span> This declares the - rcs variables that should be added to the "show-proxy-args" page. If - this is a brand new creation by you, you are free to change the - "Copyright" section to represent the rights you wish to maintain.</p> - - <p><span class="emphasis EMPHASIS c2">Note:</span> The formfeed - character that is present right after the comment flower box is handy - for (X|GNU)Emacs users to skip the verbiage and get to the heart of the - code (via `forward-page' and `backward-page'). Please include it if you - can.</p> - - <p><span class="emphasis EMPHASIS c2">Example for file header - comments:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -#ifndef _FILENAME_H +const char FILENAME_h_rcs[] = FILENAME_H_VERSION;</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> This declares the rcs variables that should be + added to the "show-proxy-args" page. If this is a brand new + creation by you, you are free to change the "Copyright" section + to represent the rights you wish to maintain.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> The formfeed character that is present right + after the comment flower box is handy for (X|GNU)Emacs users to + skip the verbiage and get to the heart of the code (via + `forward-page' and `backward-page'). Please include it if you + can.</P +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example for file header comments:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>#ifndef _FILENAME_H #define _FILENAME_H -#define FILENAME_H_VERSION "$Id: coding.html,v 1.58 2011/12/26 17:06:24 fabiankeil Exp $" +#define FILENAME_H_VERSION "$Id: coding.html,v 1.42 2009/03/21 12:59:32 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/doc/webserver/developer-manual/coding.html,v $ @@ -1473,10 +2448,16 @@ const char FILENAME_h_rcs[] = FILENAME_H_VERSION; * The GNU General Public License should be included with * this file. If not, you can view it at * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html - * or write to the Free Software Foundation, Inc., + * or write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 , * USA * + * Revisions : + * $Log: coding.html,v $ + * Revision 1.42 2009/03/21 12:59:32 fabiankeil + * Rebuild with recent changes. + * + * *********************************************************************/
@@ -1504,20 +2485,27 @@ extern const char FILENAME_h_rcs[]; Local Variables: tab-width: 3 end: -*/ -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Example for function - comments:</span></p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> -/********************************************************************* +*/</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Example for function comments:</I +></SPAN +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>/********************************************************************* * * Function : FUNCTION_NAME * @@ -1527,7 +2515,7 @@ extern const char FILENAME_h_rcs[]; * 1 : param1 = pointer to an important thing * 2 : x = pointer to something else * - * Returns : 0 => Ok, everything else is an error. + * Returns : 0 => Ok, everything else is an error. * *********************************************************************/ int FUNCTION_NAME( void *param1, const char *x ) @@ -1535,43 +2523,80 @@ int FUNCTION_NAME( void *param1, const char *x ) ... return( 0 );
-} -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Note:</span> If we all follow - this practice, we should be able to parse our code to create a - "self-documenting" web page.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href= - "documentation.html" accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="testing.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Documentation - Guidelines</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Testing Guidelines</td> - </tr> - </table> - </div> -</body> -</html> +}</PRE +></TD +></TR +></TABLE +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Note:</I +></SPAN +> If we all follow this practice, we should be + able to parse our code to create a "self-documenting" web + page.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="documentation.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="testing.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Documentation Guidelines</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Testing Guidelines</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/developer-manual/contact.html b/external/privoxy/doc/webserver/developer-manual/contact.html index 7594f9a..3d8ddc0 100644 --- a/external/privoxy/doc/webserver/developer-manual/contact.html +++ b/external/privoxy/doc/webserver/developer-manual/contact.html @@ -1,362 +1,510 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Contacting the developers, Bug Reporting and Feature - Requests</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Developer Manual" href="index.html"> - <link rel="PREVIOUS" title="Update the Webserver" href= - "webserver-update.html"> - <link rel="NEXT" title="Privoxy Copyright, License and History" href= - "copyright.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Developer Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "webserver-update.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "copyright.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="CONTACT" id="CONTACT">8. Contacting the - developers, Bug Reporting and Feature Requests</a></h1> - - <p>We value your feedback. In fact, we rely on it to improve <span class= - "APPLICATION">Privoxy</span> and its configuration. However, please note - the following hints, so we can provide you with the best support:</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">8.1. - Get Support</a></h2> - - <p>For casual users, our <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=211118" - target="_top">support forum at SourceForge</a> is probably best suited: - <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=211118" - target="_top">http://sourceforge.net/tracker/?group_id=11118&atid=211118</a></p> - - <p>All users are of course welcome to discuss their issues on the - <a href="http://lists.sourceforge.net/lists/listinfo/ijbswa-users" - target="_top">users mailing list</a>, where the developers also hang - around.</p> - - <p>Please don't sent private support requests to individual Privoxy - developers, either use the mailing lists or the support trackers.</p> - - <p>If you have to contact a Privoxy developer directly for other - reasons, please send a real mail and do not bother with SourceForge's - messaging system. Answers to SourceForge messages are usually bounced - by SourceForge's mail server in which case the developer wasted time - writing a response you don't get. From your point of view it will look - like your message has been completely ignored, so this is frustrating - for all parties involved.</p> - - <p>Note that the Privoxy mailing lists are moderated. Posts from - unsubscribed addresses have to be accepted manually by a moderator. - This may cause a delay of several days and if you use a subject that - doesn't clearly mention Privoxy or one of its features, your message - may be accidentally discarded as spam.</p> - - <p>If you aren't subscribed, you should therefore spend a few seconds - to come up with a proper subject. Additionally you should make it clear - that you want to get CC'd. Otherwise some responses will be directed to - the mailing list only, and you won't see them.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="REPORTING" id="REPORTING">8.2. Reporting - Problems</a></h2> - - <p><span class="QUOTE">"Problems"</span> for our purposes, come in two - forms:</p> - - <ul> - <li> - <p>Configuration issues, such as ads that slip through, or sites - that don't function properly due to one <span class= - "APPLICATION">Privoxy</span> <span class="QUOTE">"action"</span> or - another being turned <span class="QUOTE">"on"</span>.</p> - </li> - - <li> - <p><span class="QUOTE">"Bugs"</span> in the programming code that - makes up <span class="APPLICATION">Privoxy</span>, such as that - might cause a crash.</p> - </li> - </ul> - - <div class="SECT3"> - <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">8.2.1. - Reporting Ads or Other Configuration Problems</a></h3> - - <p>Please send feedback on ads that slipped through, innocent images - that were blocked, sites that don't work properly, and other - configuration related problem of <tt class= - "FILENAME">default.action</tt> file, to <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=460288" - target= - "_top">http://sourceforge.net/tracker/?group_id=11118&atid=460288</a>, - the Actions File Tracker.</p> - - <p>New, improved <tt class="FILENAME">default.action</tt> files may - occasionally be made available based on your feedback. These will be - announced on the <a href= - "http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" target= - "_top">ijbswa-announce</a> list and available from our the <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118" target= - "_top">files section</a> of our <a href= - "http://sf.net/projects/ijbswa/" target="_top">project page</a>.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">8.2.2. - Reporting Bugs</a></h3> - - <p>Please report all bugs through our bug tracker: <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=111118" - target= - "_top">http://sourceforge.net/tracker/?group_id=11118&atid=111118</a>.</p> - - <p>Before doing so, please make sure that the bug has <span class= - "emphasis EMPHASIS c2">not already been submitted</span> and observe - the additional hints at the top of the <a href= - "http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118" - target="_top">submit form</a>. If already submitted, please feel free - to add any info to the original report that might help to solve the - issue.</p> - - <p>Please try to verify that it is a <span class= - "APPLICATION">Privoxy</span> bug, and not a browser or site bug or - documented behaviour that just happens to be different than what you - expected. If unsure, try <a href= - "http://config.privoxy.org/toggle?set=disable" target="_top">toggling - off</a> <span class="APPLICATION">Privoxy</span>, and see if the - problem persists.</p> - - <p>If you are using your own custom configuration, please try the - stock configs to see if the problem is configuration related. If - you're having problems with a feature that is disabled by default, - please ask around on the mailing list if others can reproduce the - problem.</p> - - <p>If you aren't using the latest Privoxy version, the bug may have - been found and fixed in the meantime. We would appreciate if you - could take the time to <a href= - "http://www.privoxy.org/user-manual/installation.html" target= - "_top">upgrade to the latest version</a> (or even the latest CVS - snapshot) and verify that your bug still exists.</p> - - <p>Please be sure to provide the following information:</p> - - <ul> - <li> - <p>The exact <span class="APPLICATION">Privoxy</span> version you - are using (if you got the source from CVS, please also provide - the source code revisions as shown in <a href= - "http://config.privoxy.org/show-version" target= - "_top">http://config.privoxy.org/show-version</a>).</p> - </li> - - <li> - <p>The operating system and versions you run <span class= - "APPLICATION">Privoxy</span> on, (e.g. <span class= - "APPLICATION">Windows XP SP2</span>), if you are using a Unix - flavor, sending the output of <span class="QUOTE">"uname - -a"</span> should do, in case of GNU/Linux, please also name the - distribution.</p> - </li> - - <li> - <p>The name, platform, and version of the <span class= - "APPLICATION">browser</span> you were using (e.g. <span class= - "APPLICATION">Internet Explorer v5.5</span> for Mac).</p> - </li> - - <li> - <p>The URL where the problem occurred, or some way for us to - duplicate the problem (e.g. <tt class= - "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p> - </li> - - <li> - <p>Whether your version of <span class= - "APPLICATION">Privoxy</span> is one supplied by the <span class= - "APPLICATION">Privoxy</span> developers via SourceForge, or if - you got your copy somewhere else.</p> - </li> - - <li> - <p>Whether you are using <span class="APPLICATION">Privoxy</span> - in tandem with another proxy such as <span class= - "APPLICATION">Tor</span>. If so, please temporary disable the - other proxy to see if the symptoms change.</p> - </li> - - <li> - <p>Whether you are using a personal firewall product. If so, does - <span class="APPLICATION">Privoxy</span> work without it?</p> - </li> - - <li> - <p>Any other pertinent information to help identify the problem - such as config or log file excerpts (yes, you should have log - file entries for each action taken). To get a meaningful logfile, - please make sure that the <a href= - "../user-manual/config.html#LOGFILE" target="_top">logfile - directive</a> is being used and the following <a href= - "../user-manual/config.html#DEBUG" target="_top">debug - options</a> are enabled:</p> - - <p class="LITERALLAYOUT"> - debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br> - - debug 2 # show each connection status<br> - - debug 4 # show I/O status<br> - - debug 8 # show header parsing<br> - - debug 128 # debug redirects<br> - debug 256 # debug GIF de-animation<br> - - debug 512 # Common Log Format<br> - - debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br> - - debug 4096 # Startup banner and warnings.<br> - - debug 8192 # Non-fatal errors</p>If you - are having trouble with a filter, please additionally enable - - <p class="LITERALLAYOUT"> - debug 64 # debug regular expression filters</p>If - you are using Privoxy 3.0.17 or later and suspect that it - interprets the request or the response incorrectly, please enable - - <p class="LITERALLAYOUT"> - debug 32768 # log all data read from the network</p>Note - that Privoxy log files may contain sensitive information so - please don't submit any logfiles you didn't read first. You can - mask sensitive information as long as it's clear that you removed - something. - </li> - </ul> - - <p>You don't have to tell us your actual name when filing a problem - report, but if you don't, please use a nickname so we can - differentiate between your messages and the ones entered by other - "anonymous" users that may respond to your request if they have the - same problem or already found a solution. Note that due to spam the - trackers may not always allow to post without being logged into - SourceForge. If that's the case, you are still free to create a login - that isn't directly linked to your name, though.</p> - - <p>Please also check the status of your request a few days after - submitting it, as we may request additional information. If you use a - SF id, you should automatically get a mail when someone responds to - your request. Please don't bother to add an email address when using - the tracker. If you prefer to communicate through email, just use one - of the mailing lists directly.</p> - - <p>If you are new to reporting problems, you might be interested in - <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" - target="_top">How to Report Bugs Effectively</a>.</p> - - <p>The <a href= - "http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" - target="_top">appendix of the Privoxy User Manual</a> also has - helpful information on understanding <tt class= - "LITERAL">actions</tt>, and <tt class="LITERAL">action</tt> - debugging.</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CONTACT-FEATURE" id="CONTACT-FEATURE">8.3. - Request New Features</a></h2> - - <p>You are welcome to submit ideas on new features or other proposals - for improvement through our feature request tracker at <a href= - "http://sourceforge.net/tracker/?atid=361118&group_id=11118" - target="_top">http://sourceforge.net/tracker/?atid=361118&group_id=11118</a>.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">8.4. - Mailing Lists</a></h2> - - <p>If you prefer to communicate through email, instead of using a web - interface, feel free to use one of the mailing lists. To discuss issues - that haven't been completely diagnosed yet, please use the Privoxy - users list. Technically interested users and people who wish to - contribute to the project are always welcome on the developers list. - You can find an overview of all <span class= - "APPLICATION">Privoxy</span>-related mailing lists, including list - archives, at: <a href="http://sourceforge.net/mail/?group_id=11118" - target="_top">http://sourceforge.net/mail/?group_id=11118</a>.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href= - "webserver-update.html" accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="copyright.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Update the Webserver</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Privoxy Copyright, License - and History</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Contacting the developers, Bug Reporting and Feature Requests</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Update the Webserver" +HREF="webserver-update.html"><LINK +REL="NEXT" +TITLE="Privoxy Copyright, License and History" +HREF="copyright.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Developer Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="webserver-update.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="copyright.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="CONTACT" +>8. Contacting the developers, Bug Reporting and Feature Requests</A +></H1 +><P +> We value your feedback. In fact, we rely on it to improve + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and its configuration. + However, please note the following hints, so we can + provide you with the best support:</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-SUPPORT" +>8.1. Get Support</A +></H2 +><P +> For casual users, our + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118" +TARGET="_top" +>support forum at SourceForge</A +> + is probably best suited: + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118" +TARGET="_top" +>http://sourceforge.net/tracker/?group_id=11118&atid=211118</A +></P +><P +> All users are of course welcome to discuss their issues on the <A +HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-users" +TARGET="_top" +>users + mailing list</A +>, where the developers also hang around.</P +><P +> Please don't sent private support requests to individual Privoxy + developers, either use the mailing lists or the support trackers.</P +><P +> Note that the Privoxy mailing lists are moderated. Posts from unsubscribed + addresses have to be accepted manually by a moderator. This may cause a + delay of several days and if you use a subject that doesn't clearly + mention Privoxy or one of its features, your message may be accidentally + discarded as spam.</P +><P +> If you aren't subscribed, you should therefore spend a few seconds + to come up with a proper subject. Additionally you should make it clear + that you want to get CC'd. Otherwise some responses will be directed to + the mailing list only, and you won't see them.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="REPORTING" +>8.2. Reporting Problems</A +></H2 +><P +><SPAN +CLASS="QUOTE" +>"Problems"</SPAN +> for our purposes, come in two forms:</P +><P +></P +><UL +><LI +><P +> Configuration issues, such as ads that slip through, or sites that + don't function properly due to one <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + <SPAN +CLASS="QUOTE" +>"action"</SPAN +> or another being turned <SPAN +CLASS="QUOTE" +>"on"</SPAN +>. + </P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"Bugs"</SPAN +> in the programming code that makes up + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, such as that might cause a crash. + </P +></LI +></UL +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="CONTACT-ADS" +>8.2.1. Reporting Ads or Other Configuration Problems</A +></H3 +><P +> Please send feedback on ads that slipped through, innocent images that were + blocked, sites that don't work properly, and other configuration related problem of + <TT +CLASS="FILENAME" +>default.action</TT +> file, to + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288" +TARGET="_top" +> http://sourceforge.net/tracker/?group_id=11118&atid=460288</A +>, + the Actions File Tracker.</P +><P +> New, improved <TT +CLASS="FILENAME" +>default.action</TT +> files may occasionally be made + available based on your feedback. These will be announced on the <A +HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" +TARGET="_top" +>ijbswa-announce</A +> + list and available from our the <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>files section</A +> of + our <A +HREF="http://sf.net/projects/ijbswa/" +TARGET="_top" +>project page</A +>.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="CONTACT-BUGS" +>8.2.2. Reporting Bugs</A +></H3 +><P +> Please report all bugs through our bug tracker: + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118" +TARGET="_top" +>http://sourceforge.net/tracker/?group_id=11118&atid=111118</A +>. </P +><P +> Before doing so, please make sure that the bug has <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not already been submitted</I +></SPAN +> + and observe the additional hints at the top of the <A +HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118" +TARGET="_top" +>submit + form</A +>. If already submitted, please feel free to add any info to the + original report that might help to solve the issue.</P +><P +> Please try to verify that it is a <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> bug, + and not a browser or site bug or documented behaviour that just happens + to be different than what you expected. If unsure, + try <A +HREF="http://config.privoxy.org/toggle?set=disable" +TARGET="_top" +>toggling + off</A +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, and see if the problem persists.</P +><P +> If you are using your own custom configuration, please try + the stock configs to see if the problem is configuration related. + If you're having problems with a feature that is disabled by default, + please ask around on the mailing list if others can reproduce the problem.</P +><P +> If you aren't using the latest Privoxy version, the bug may have been found + and fixed in the meantime. We would appreciate if you could take the time + to <A +HREF="http://www.privoxy.org/user-manual/installation.html" +TARGET="_top" +>upgrade + to the latest version</A +> (or even the latest CVS snapshot) and verify + that your bug still exists.</P +><P +>Please be sure to provide the following information:</P +><P +> <P +></P +><UL +><LI +><P +> The exact <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version you are using + (if you got the source from CVS, please also provide the source code revisions + as shown in <A +HREF="http://config.privoxy.org/show-version" +TARGET="_top" +>http://config.privoxy.org/show-version</A +>). + </P +></LI +><LI +><P +> The operating system and versions you run + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on, (e.g. <SPAN +CLASS="APPLICATION" +>Windows + XP SP2</SPAN +>), if you are using a Unix flavor, + sending the output of <SPAN +CLASS="QUOTE" +>"uname -a"</SPAN +> should do, + in case of GNU/Linux, please also name the distribution. + </P +></LI +><LI +><P +> The name, platform, and version of the <SPAN +CLASS="APPLICATION" +>browser</SPAN +> + you were using (e.g. <SPAN +CLASS="APPLICATION" +>Internet Explorer v5.5</SPAN +> for Mac). + </P +></LI +><LI +><P +> The URL where the problem occurred, or some way for us to duplicate the + problem (e.g. <TT +CLASS="LITERAL" +>http://somesite.example.com/?somethingelse=123</TT +>). + </P +></LI +><LI +><P +> Whether your version of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is one supplied + by the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developers via SourceForge, + or if you got your copy somewhere else. + </P +></LI +><LI +><P +> Whether you are using <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> in tandem with + another proxy such as <SPAN +CLASS="APPLICATION" +>Tor</SPAN +>. If so, please + temporary disable the other proxy to see if the symptoms change. + </P +></LI +><LI +><P +> Whether you are using a personal firewall product. If so, does + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> work without it? + </P +></LI +><LI +><P +> Any other pertinent information to help identify the problem such as config + or log file excerpts (yes, you should have log file entries for each + action taken). + </P +></LI +></UL +></P +><P +> You don't have to tell us your actual name when filing a problem + report, but please use a nickname so we can differentiate between + your messages and the ones entered by other "anonymous" users that + may respond to your request if they have the same problem or already + found a solution.</P +><P +> Please also check the status of your request a few days after submitting + it, as we may request additional information. If you use a SF id, + you should automatically get a mail when someone responds to your request.</P +><P +> The <A +HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" +TARGET="_top" +>appendix + of the Privoxy User Manual</A +> also has helpful information + on understanding <TT +CLASS="LITERAL" +>actions</TT +>, and <TT +CLASS="LITERAL" +>action</TT +> debugging. </P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-FEATURE" +>8.3. Request New Features</A +></H2 +><P +> You are welcome to submit ideas on new features or other proposals + for improvement through our feature request tracker at + <A +HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118" +TARGET="_top" +>http://sourceforge.net/tracker/?atid=361118&group_id=11118</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-OTHER" +>8.4. Other</A +></H2 +><P +>For any other issues, feel free to use the mailing lists. Technically interested users +and people who wish to contribute to the project are also welcome on the developers list! +You can find an overview of all <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>-related mailing lists, +including list archives, at: +<A +HREF="http://sourceforge.net/mail/?group_id=11118" +TARGET="_top" +>http://sourceforge.net/mail/?group_id=11118</A +>.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="webserver-update.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="copyright.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Update the Webserver</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Privoxy Copyright, License and History</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/developer-manual/copyright.html b/external/privoxy/doc/webserver/developer-manual/copyright.html index f6d39e6..5fbe9a4 100644 --- a/external/privoxy/doc/webserver/developer-manual/copyright.html +++ b/external/privoxy/doc/webserver/developer-manual/copyright.html @@ -1,161 +1,298 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy Copyright, License and History</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Developer Manual" href="index.html"> - <link rel="PREVIOUS" title= - "Contacting the developers, Bug Reporting and Feature Requests" href= - "contact.html"> - <link rel="NEXT" title="See also" href="seealso.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - a.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Developer Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="contact.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="seealso.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="COPYRIGHT" id="COPYRIGHT">9. Privoxy - Copyright, License and History</a></h1> - - <p>Copyright © 2001-2011 by Privoxy Developers <code class= - "EMAIL"><<a href= - "mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</a>></code></p> - - <p>Some source code is based on code Copyright © 1997 by Anonymous - Coders and Junkbusters, Inc. and licensed under the <i class= - "CITETITLE">GNU General Public License</i>.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN1231" id="AEN1231">9.1. License</a></h2> - - <p><span class="APPLICATION">Privoxy</span> is free software; you can - redistribute it and/or modify it under the terms of the <i class= - "CITETITLE">GNU General Public License</i>, version 2, as published by - the Free Software Foundation.</p> - - <p>This program is distributed in the hope that it will be useful, but - WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the <a class= - "CITETITLE c2" href= - "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target= - "_top">GNU General Public License</a> for details.</p> - - <p>You should have received a copy of the <i class="CITETITLE">GNU - GPL</i> along with this program; if not, write to the</p> - - <p class="ADDRESS"> Free Software<br> - Foundation, Inc. <span class="STREET">51 Franklin - Street, Fifth Floor</span><br> - <span class="CITY">Boston</span>, <span class= - "STATE">MA</span> <span class="POSTCODE">02110-1301</span><br> - <span class="COUNTRY">USA</span> </p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN1247" id="AEN1247">9.2. History</a></h2> - - <p>A long time ago, there was the <a href= - "http://www.junkbusters.com/ijb.html" target="_top"><span class= - "APPLICATION">Internet Junkbuster</span></a>, by Anonymous Coders and - <a href="http://www.junkbusters.com/" target="_top">Junkbusters - Corporation</a>. This saved many users a lot of pain in the early days - of web advertising and user tracking.</p> - - <p>But the web, its protocols and standards, and with it, the - techniques for forcing ads on users, give up autonomy over their - browsing, and for tracking them, keeps evolving. Unfortunately, the - <span class="APPLICATION">Internet Junkbuster</span> did not. Version - 2.0.2, published in 1998, was (and is) the last official <a href= - "http://www.junkbusters.com/ijbdist.html#release" target= - "_top">release</a> available from <a href="http://www.junkbusters.com" - target="_top">Junkbusters Corporation</a>. Fortunately, it had been - released under the GNU <a href= - "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target= - "_top">GPL</a>, which allowed further development by others.</p> - - <p>So Stefan Waldherr started maintaining an improved version of the - software, to which eventually a number of people contributed patches. - It could already replace banners with a transparent image, and had a - first version of pop-up killing, but it was still very closely based on - the original, with all its limitations, such as the lack of HTTP/1.1 - support, flexible per-site configuration, or content modification. The - last release from this effort was version 2.0.2-10, published in - 2000.</p> - - <p>Then, some <a href= - "http://www.privoxy.org/user-manual/copyright.html#AUTHORS" target= - "_top">developers</a> picked up the thread, and started turning the - software inside out, upside down, and then reassembled it, adding many - <a href="http://www.privoxy.org/user-manual/introduction.html#FEATURES" - target="_top">new features</a> along the way.</p> - - <p>The result of this is <span class="APPLICATION">Privoxy</span>, - whose first stable version, 3.0, was released August, 2002.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="contact.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="seealso.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Contacting the developers, - Bug Reporting and Feature Requests</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">See also</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Privoxy Copyright, License and History</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Contacting the developers, Bug Reporting and Feature Requests" +HREF="contact.html"><LINK +REL="NEXT" +TITLE="See also" +HREF="seealso.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Developer Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="contact.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="seealso.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="COPYRIGHT" +>9. Privoxy Copyright, License and History</A +></H1 +><P +> Copyright © 2001-2009 by Privoxy Developers <CODE +CLASS="EMAIL" +><<A +HREF="mailto:ijbswa-developers@lists.sourceforge.net" +>ijbswa-developers@lists.sourceforge.net</A +>></CODE +></P +><P +> Some source code is based on code Copyright © 1997 by Anonymous Coders + and Junkbusters, Inc. and licensed under the <I +CLASS="CITETITLE" +>GNU General Public + License</I +>.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN1223" +>9.1. License</A +></H2 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is free software; you can + redistribute it and/or modify it under the terms of the + <I +CLASS="CITETITLE" +>GNU General Public License</I +>, version 2, + as published by the Free Software Foundation.</P +><P +> This program is distributed in the hope that it will be useful, but WITHOUT + ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + FITNESS FOR A PARTICULAR PURPOSE. See the <A +HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" +TARGET="_top" +> <I +CLASS="CITETITLE" +>GNU General Public License</I +></A +> for details.</P +><P +> You should have received a copy of the <I +CLASS="CITETITLE" +>GNU GPL</I +> + along with this program; if not, write to the <P +CLASS="ADDRESS" +> Free Software<br> + Foundation, Inc. <SPAN +CLASS="STREET" +>51 Franklin Street, Fifth Floor</SPAN +><br> + <SPAN +CLASS="CITY" +>Boston</SPAN +>, <SPAN +CLASS="STATE" +>MA</SPAN +> <SPAN +CLASS="POSTCODE" +>02110-1301</SPAN +><br> + <SPAN +CLASS="COUNTRY" +>USA</SPAN +> </P +></P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN1239" +>9.2. History</A +></H2 +><P +> A long time ago, there was the + <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +><SPAN +CLASS="APPLICATION" +>Internet Junkbuster</SPAN +></A +>, + by Anonymous Coders and <A +HREF="http://www.junkbusters.com/" +TARGET="_top" +>Junkbusters + Corporation</A +>. This saved many users a lot of pain in the early days of + web advertising and user tracking.</P +><P +> But the web, its protocols and standards, and with it, the techniques for + forcing ads on users, give up autonomy over their browsing, and + for tracking them, keeps evolving. Unfortunately, the <SPAN +CLASS="APPLICATION" +>Internet + Junkbuster</SPAN +> did not. Version 2.0.2, published in 1998, was + (and is) the last official + <A +HREF="http://www.junkbusters.com/ijbdist.html#release" +TARGET="_top" +>release</A +> + available from <A +HREF="http://www.junkbusters.com" +TARGET="_top" +>Junkbusters Corporation</A +>. + Fortunately, it had been released under the GNU + <A +HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" +TARGET="_top" +>GPL</A +>, + which allowed further development by others.</P +><P +> So Stefan Waldherr started maintaining an improved version of the + software, to which eventually a number of people contributed patches. + It could already replace banners with a transparent image, and had a first + version of pop-up killing, but it was still very closely based on the + original, with all its limitations, such as the lack of HTTP/1.1 support, + flexible per-site configuration, or content modification. The last release + from this effort was version 2.0.2-10, published in 2000.</P +><P +> Then, some + <A +HREF="http://www.privoxy.org/user-manual/copyright.html#AUTHORS" +TARGET="_top" +>developers</A +> + picked up the thread, and started turning the software inside out, upside down, + and then reassembled it, adding many + <A +HREF="http://www.privoxy.org/user-manual/introduction.html#FEATURES" +TARGET="_top" +>new + features</A +> along the way.</P +><P +> The result of this is <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, whose first + stable version, 3.0, was released August, 2002. + </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="contact.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="seealso.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Contacting the developers, Bug Reporting and Feature Requests</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>See also</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/developer-manual/cvs.html b/external/privoxy/doc/webserver/developer-manual/cvs.html index 5a0f571..db1fb9e 100644 --- a/external/privoxy/doc/webserver/developer-manual/cvs.html +++ b/external/privoxy/doc/webserver/developer-manual/cvs.html @@ -1,189 +1,330 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>The CVS Repository</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Developer Manual" href="index.html"> - <link rel="PREVIOUS" title="Introduction" href="introduction.html"> - <link rel="NEXT" title="Documentation Guidelines" href= - "documentation.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Developer Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "introduction.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "documentation.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="CVS" id="CVS">2. The CVS Repository</a></h1> - - <p>If you become part of the active development team, you will eventually - need write access to our holy grail, the CVS repository. One of the team - members will need to set this up for you. Please read this chapter - completely before accessing via CVS.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CVSACCESS" id="CVSACCESS">2.1. Access to - CVS</a></h2> - - <p>The project's CVS repository is hosted on <a href= - "http://sourceforge.net/" target="_top">SourceForge.</a> Please refer - to the chapters 6 and 7 in <a href= - "http://sourceforge.net/docman/?group_id=1" target="_top">SF's site - documentation</a> for the technical access details for your operating - system. For historical reasons, the CVS server is called <tt class= - "LITERAL">ijbswa.cvs.sourceforge.net</tt>, the repository is called - <tt class="LITERAL">ijbswa</tt>, and the source tree module is called - <tt class="LITERAL">current</tt>.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CVSBRANCHES" id="CVSBRANCHES">2.2. - Branches</a></h2> - - <p>Within the CVS repository, there are modules and branches. As - mentioned, the sources are in the <tt class="LITERAL">current</tt> - <span class="QUOTE">"module"</span>. Other modules are present for - platform specific issues. There is a webview of the CVS hierarchy at - <a href="http://ijbswa.cvs.sourceforge.net/ijbswa/" target= - "_top">http://ijbswa.cvs.sourceforge.net/ijbswa/</a>, which might help - with visualizing how these pieces fit together.</p> - - <p>Branches are used to fork a sub-development path from the main - trunk. Within the <tt class="LITERAL">current</tt> module where the - sources are, there is always at least one <span class= - "QUOTE">"branch"</span> from the main trunk devoted to a stable release - series. The main trunk is where active development takes place for the - next stable series (e.g. 3.2.x). So just prior to each stable series - (e.g. 3.0.x), a branch is created just for stable series releases (e.g. - 3.0.0 -> 3.0.1 -> 3.0.2, etc). Once the initial stable release of - any stable branch has taken place, this branch is <span class= - "emphasis EMPHASIS c2">only used for bugfixes</span>, which have had - prior testing before being committed to CVS. (See <a href= - "newrelease.html#VERSIONNUMBERS">Version Numbers</a> below for details - on versioning.)</p> - - <p>At one time there were two distinct branches: stable and unstable. - The more drastic changes were to be in the unstable branch. These - branches have now been merged to minimize time and effort of - maintaining two branches.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CVSCOMMIT" id="CVSCOMMIT">2.3. CVS Commit - Guidelines</a></h2> - - <p>The source tree is the heart of every software project. Every effort - must be made to ensure that it is readable, compilable and consistent - at all times. There are differing guidelines for the stable branch and - the main development trunk, and we ask anyone with CVS access to - strictly adhere to the following guidelines:</p> - - <p>Basic Guidelines, for all branches:</p> - - <ul> - <li> - <p>Please don't commit even a small change without testing it - thoroughly first. When we're close to a public release, ask a - fellow developer to review your changes.</p> - </li> - - <li> - <p>Your commit message should give a concise overview of - <span class="emphasis EMPHASIS c2">what you changed</span> (no big - details) and <span class="emphasis EMPHASIS c2">why you changed - it</span> Just check previous messages for good examples.</p> - </li> - - <li> - <p>Don't use the same message on multiple files, unless it equally - applies to all those files.</p> - </li> - - <li> - <p>If your changes span multiple files, and the code won't - recompile unless all changes are committed (e.g. when changing the - signature of a function), then commit all files one after another, - without long delays in between. If necessary, prepare the commit - messages in advance.</p> - </li> - - <li> - <p>Before changing things on CVS, make sure that your changes are - in line with the team's general consensus on what should be - done.</p> - </li> - - <li> - <p>Note that near a major public release, we get more cautious. - There is always the possibility to submit a patch to the <a href= - "http://sourceforge.net/tracker/?atid=311118&group_id=11118&func=brow..." - target="_top">patch tracker</a> instead.</p> - </li> - </ul> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="introduction.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href= - "documentation.html" accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Introduction</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Documentation - Guidelines</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>The CVS Repository</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Introduction" +HREF="introduction.html"><LINK +REL="NEXT" +TITLE="Documentation Guidelines" +HREF="documentation.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Developer Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="introduction.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="documentation.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="CVS" +>2. The CVS Repository</A +></H1 +><P +> If you become part of the active development team, you will eventually + need write access to our holy grail, the CVS repository. One of the + team members will need to set this up for you. Please read + this chapter completely before accessing via CVS. + </P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CVSACCESS" +>2.1. Access to CVS</A +></H2 +><P +> The project's CVS repository is hosted on + <A +HREF="http://sourceforge.net/" +TARGET="_top" +>SourceForge.</A +> + Please refer to the chapters 6 and 7 in + <A +HREF="http://sourceforge.net/docman/?group_id=1" +TARGET="_top" +>SF's site + documentation</A +> for the technical access details for your + operating system. For historical reasons, the CVS server is + called <TT +CLASS="LITERAL" +>ijbswa.cvs.sourceforge.net</TT +>, the repository is + called <TT +CLASS="LITERAL" +>ijbswa</TT +>, and the source tree module is called + <TT +CLASS="LITERAL" +>current</TT +>. + </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CVSBRANCHES" +>2.2. Branches</A +></H2 +><P +> Within the CVS repository, there are modules and branches. As + mentioned, the sources are in the <TT +CLASS="LITERAL" +>current</TT +> + <SPAN +CLASS="QUOTE" +>"module"</SPAN +>. Other modules are present for platform specific + issues. There is a webview of the CVS hierarchy at <A +HREF="http://ijbswa.cvs.sourceforge.net/ijbswa/" +TARGET="_top" +>http://ijbswa.cvs.sourceforge.net/ijbswa/</A +>, + which might help with visualizing how these pieces fit together. + </P +><P +> Branches are used to fork a sub-development path from the main trunk. + Within the <TT +CLASS="LITERAL" +>current</TT +> module where the sources are, there + is always at least one <SPAN +CLASS="QUOTE" +>"branch"</SPAN +> from the main trunk + devoted to a stable release series. The main trunk is where active + development takes place for the next stable series (e.g. 3.2.x). + So just prior to each stable series (e.g. 3.0.x), a branch is created + just for stable series releases (e.g. 3.0.0 -> 3.0.1 -> 3.0.2, etc). + Once the initial stable release of any stable branch has taken place, + this branch is <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>only used for bugfixes</I +></SPAN +>, which have + had prior testing before being committed to CVS. (See <A +HREF="newrelease.html#VERSIONNUMBERS" +>Version Numbers</A +> below for details on + versioning.) + </P +><P +> At one time there were two distinct branches: stable and unstable. The + more drastic changes were to be in the unstable branch. These branches + have now been merged to minimize time and effort of maintaining two + branches. + </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CVSCOMMIT" +>2.3. CVS Commit Guidelines</A +></H2 +><P +> The source tree is the heart of every software project. Every effort must + be made to ensure that it is readable, compilable and consistent at all + times. There are differing guidelines for the stable branch and the + main development trunk, and we ask anyone with CVS access to strictly + adhere to the following guidelines: + </P +><P +> Basic Guidelines, for all branches: + </P +><P +> <P +></P +><UL +><LI +><P +> Please don't commit even + a small change without testing it thoroughly first. When we're + close to a public release, ask a fellow developer to review your + changes. + </P +></LI +><LI +><P +> Your commit message should give a concise overview of <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>what you + changed</I +></SPAN +> (no big details) and <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>why you changed it</I +></SPAN +> + Just check previous messages for good examples. + </P +></LI +><LI +><P +> Don't use the same message on multiple files, unless it equally applies to + all those files. + </P +></LI +><LI +><P +> If your changes span multiple files, and the code won't recompile unless + all changes are committed (e.g. when changing the signature of a function), + then commit all files one after another, without long delays in between. + If necessary, prepare the commit messages in advance. + </P +></LI +><LI +><P +> Before changing things on CVS, make sure that your changes are in line + with the team's general consensus on what should be done. + </P +></LI +><LI +><P +> Note that near a major public release, we get more cautious. + There is always the possibility to submit a patch to the <A +HREF="http://sourceforge.net/tracker/?atid=311118&group_id=11118&func=brow..." +TARGET="_top" +>patch + tracker</A +> instead. + </P +></LI +></UL +> + </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="introduction.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="documentation.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Introduction</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Documentation Guidelines</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/developer-manual/documentation.html b/external/privoxy/doc/webserver/developer-manual/documentation.html index bcd57d1..d547c23 100644 --- a/external/privoxy/doc/webserver/developer-manual/documentation.html +++ b/external/privoxy/doc/webserver/developer-manual/documentation.html @@ -1,464 +1,944 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Documentation Guidelines</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Developer Manual" href="index.html"> - <link rel="PREVIOUS" title="The CVS Repository" href="cvs.html"> - <link rel="NEXT" title="Coding Guidelines" href="coding.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - span.c3 {font-style: italic} - a.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Developer Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="cvs.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="coding.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="DOCUMENTATION" id="DOCUMENTATION">3. - Documentation Guidelines</a></h1> - - <p>All formal documents are maintained in Docbook SGML and located in the - <samp class="COMPUTEROUTPUT">doc/source/*</samp> directory. You will need - <a href="http://www.docbook.org" target="_top">Docbook</a>, the Docbook +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Documentation Guidelines</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="The CVS Repository" +HREF="cvs.html"><LINK +REL="NEXT" +TITLE="Coding Guidelines" +HREF="coding.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Developer Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="cvs.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="coding.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="DOCUMENTATION" +>3. Documentation Guidelines</A +></H1 +><P +> All formal documents are maintained in Docbook SGML and located in the + <SAMP +CLASS="COMPUTEROUTPUT" +>doc/source/*</SAMP +> directory. You will need + <A +HREF="http://www.docbook.org" +TARGET="_top" +>Docbook</A +>, the Docbook DTD's and the Docbook modular stylesheets (or comparable alternatives), - and either <span class="APPLICATION">jade</span> or <span class= - "APPLICATION">openjade</span> (recommended) installed in order to build - docs from source. Currently there is <a class="CITETITLE c2" href= - "../user-manual/index.html" target="_top">user-manual</a>, <a class= - "CITETITLE c2" href="../faq/index.html" target="_top">FAQ</a>, and, of - course this, the <i class="CITETITLE">developer-manual</i> in this - format. The <i class="CITETITLE">README</i>, <i class= - "CITETITLE">AUTHORS</i>, <i class="CITETITLE">INSTALL</i>, <i class= - "CITETITLE">privoxy.1</i> (man page), and <i class="CITETITLE">config</i> - files are also now maintained as Docbook SGML. These files, when built, - in the top-level source directory are generated files! Also, the - <span class="APPLICATION">Privoxy</span> <tt class= - "FILENAME">index.html</tt> (and a variation on this file, <tt class= - "FILENAME">privoxy-index.html</tt>, meant for inclusion with doc - packages), are maintained as SGML as well. <span class= - "emphasis EMPHASIS c3">DO NOT edit these directly</span>. Edit the SGML - source, or contact someone involved in the documentation.</p> - - <p><tt class="FILENAME">config</tt> requires some special handling. The - reason it is maintained this way is so that the extensive comments in the - file mirror those in <i class="CITETITLE">user-manual</i>. But the - conversion process requires going from SGML to HTML to text to special - formatting required for the embedded comments. Some of this does not - survive so well. Especially some of the examples that are longer than 80 - characters. The build process for this file outputs to <tt class= - "FILENAME">config.new</tt>, which should be reviewed for errors and - mis-formatting. Once satisfied that it is correct, then it should be hand - copied to <tt class="FILENAME">config</tt>.</p> - - <p>Other, less formal documents (e.g. <tt class="FILENAME">LICENSE</tt>) - are maintained as plain text files in the top-level source directory.</p> - - <p>Packagers are encouraged to include this documentation. For those - without the ability to build the docs locally, text versions of each are - kept in CVS. HTML versions are also being kept in CVS under <tt class= - "FILENAME">doc/webserver/*</tt>. And PDF version are kept in <tt class= - "FILENAME">doc/pdf/*</tt>.</p> - - <p>Formal documents are built with the Makefile targets of <samp class= - "COMPUTEROUTPUT">make dok</samp>, or alternately <samp class= - "COMPUTEROUTPUT">make redhat-dok</samp>. If you have problems, try both. - The build process uses the document SGML sources in <samp class= - "COMPUTEROUTPUT">doc/source/*/*</samp> to update all text files in - <samp class="COMPUTEROUTPUT">doc/text/</samp> and to update all HTML - documents in <samp class="COMPUTEROUTPUT">doc/webserver/</samp>.</p> - - <p>Documentation writers should please make sure documents build - successfully before committing to CVS, if possible.</p> - - <p>How do you update the webserver (i.e. the pages on privoxy.org)?</p> - - <ol type="1"> - <li> - <p>First, build the docs by running <samp class="COMPUTEROUTPUT">make - dok</samp> (or alternately <samp class="COMPUTEROUTPUT">make - redhat-dok</samp>). For PDF docs, do <samp class= - "COMPUTEROUTPUT">make dok-pdf</samp>.</p> - </li> - - <li> - <p>Run <samp class="COMPUTEROUTPUT">make webserver</samp> which - copies all files from <samp class= - "COMPUTEROUTPUT">doc/webserver</samp> to the sourceforge webserver - via scp.</p> - </li> - </ol> - - <p>Finished docs should be occasionally submitted to CVS (<tt class= - "FILENAME">doc/webserver/*/*.html</tt>) so that those without the ability - to build them locally, have access to them if needed. This is especially - important just prior to a new release! Please do this <span class= - "emphasis EMPHASIS c3">after</span> the <tt class="LITERAL">$VERSION</tt> - and other release specific data in <tt class="FILENAME">configure.in</tt> - has been updated (this is done just prior to a new release).</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="SGML" id="SGML">3.1. Quickstart to Docbook - and SGML</a></h2> - - <p>If you are not familiar with SGML, it is a markup language similar - to HTML. Actually, not a mark up language per se, but a language used - to define markup languages. In fact, HTML is an SGML application. Both - will use <span class="QUOTE">"tags"</span> to format text and other - content. SGML tags can be much more varied, and flexible, but do much - of the same kinds of things. The tags, or <span class= - "QUOTE">"elements"</span>, are definable in SGML. There is no set - <span class="QUOTE">"standards"</span>. Since we are using <span class= - "APPLICATION">Docbook</span>, our tags are those that are defined by - <span class="APPLICATION">Docbook</span>. Much of how the finish - document is rendered is determined by the <span class= - "QUOTE">"stylesheets"</span>. The stylesheets determine how each tag - gets translated to HTML, or other formats.</p> - - <p>Tags in Docbook SGML need to be always <span class= - "QUOTE">"closed"</span>. If not, you will likely generate errors. - Example: <tt class="LITERAL"><title>My Title</title></tt>. - They are also case-insensitive, but we strongly suggest using all lower - case. This keeps compatibility with [Docbook] <span class= - "APPLICATION">XML</span>.</p> - - <p>Our documents use <span class="QUOTE">"sections"</span> for the most - part. Sections will be processed into HTML headers (e.g. <tt class= - "LITERAL">h1</tt> for <tt class="LITERAL">sect1</tt>). The <span class= - "APPLICATION">Docbook</span> stylesheets will use these to also - generate the Table of Contents for each doc. Our TOC's are set to a - depth of three. Meaning <tt class="LITERAL">sect1</tt>, <tt class= - "LITERAL">sect2</tt>, and <tt class="LITERAL">sect3</tt> will have TOC - entries, but <tt class="LITERAL">sect4</tt> will not. Each section - requires a <tt class="LITERAL"><title></tt> element, and at least - one <tt class="LITERAL"><para></tt>. There is a limit of five - section levels in Docbook, but generally three should be sufficient for - our purposes.</p> - - <p>Some common elements that you likely will use:</p> - - <table border="0"> - <tbody> - <tr> - <td><span class= - "emphasis EMPHASIS c3"><para></para></span>, - paragraph delimiter. Most text needs to be within paragraph - elements (there are some exceptions).</td> - </tr> - - <tr> - <td><span class= - "emphasis EMPHASIS c3"><emphasis></emphasis></span>, - the stylesheets make this italics.</td> - </tr> - - <tr> - <td><span class= - "emphasis EMPHASIS c3"><filename></filename></span>, - files and directories.</td> - </tr> - - <tr> - <td><span class= - "emphasis EMPHASIS c3"><command></command></span>, - command examples.</td> - </tr> - - <tr> - <td><span class= - "emphasis EMPHASIS c3"><literallayout></literallayout></span>, - like <tt class="LITERAL"><pre></tt>, more or less.</td> - </tr> - - <tr> - <td><span class= - "emphasis EMPHASIS c3"><itemizedlist></itemizedlist></span>, - list with bullets.</td> - </tr> - - <tr> - <td><span class= - "emphasis EMPHASIS c3"><listitem></listitem></span>, - member of the above.</td> - </tr> - - <tr> - <td><span class= - "emphasis EMPHASIS c3"><screen></screen></span>, - screen output, implies <tt class= - "LITERAL"><literallayout></tt>.</td> - </tr> - - <tr> - <td><span class="emphasis EMPHASIS c3"><ulink - url="example.com"></ulink></span>, like HTML <tt class= - "LITERAL"><a></tt> tag.</td> - </tr> - - <tr> - <td><span class= - "emphasis EMPHASIS c3"><quote></quote></span>, for, - doh, quoting text.</td> - </tr> - </tbody> - </table> - - <p>Look at any of the existing docs for examples of all these and - more.</p> - - <p>You might also find <span class="QUOTE">"<a href= - "http://opensource.bureau-cornavin.com/crash-course/index.html" target= - "_top">Writing Documentation Using DocBook - A Crash Course</a>"</span> - useful.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="DOCSTYLE" id="DOCSTYLE">3.2. <span class= - "APPLICATION">Privoxy</span> Documentation Style</a></h2> - - <p>It will be easier if everyone follows a similar writing style. This - just makes it easier to read what someone else has written if it is all - done in a similar fashion.</p> - - <p>Here it is:</p> - - <ul> - <li> - <p>All tags should be lower case.</p> - </li> - - <li> - <p>Tags delimiting a <span class= - "emphasis EMPHASIS c3">block</span> of text (even small blocks) - should be on their own line. Like:</p> - - <p class="LITERALLAYOUT"> <para><br> - Some text goes here.<br> - </para><br> - </p>Tags marking - individual words, or few words, should be in-line: - - <p class="LITERALLAYOUT"> - Just to <emphasis>emphasize</emphasis>, some text goes here.<br> - - </p> - </li> - - <li> - <p>Tags should be nested and step indented for block text like: - (except in-line tags)</p> - - <p class="LITERALLAYOUT"> <para><br> - <itemizedlist><br> - <para><br> - <listitem><br> - Some text goes here in our list example.<br> - - </listitem><br> - </para><br> - </itemizedlist><br> - </para><br> - </p>This makes it easier - to find the text amongst the tags ;-) - </li> - - <li> - <p>Use white space to separate logical divisions within a document, - like between sections. Running everything together consistently - makes it harder to read and work on.</p> - </li> - - <li> - <p>Do not hesitate to make comments. Comments can either use the - <comment> element, or the <!-- --> style comment - familiar from HTML. (Note in Docbook v4.x <comment> is - replaced by <remark>.)</p> - </li> - - <li> - <p>We have an international audience. Refrain from slang, or - English idiosyncrasies (too many to list :). Humor also does not - translate well sometimes.</p> - </li> - - <li> - <p>Try to keep overall line lengths in source files to 80 - characters or less for obvious reasons. This is not always - possible, with lengthy URLs for instance.</p> - </li> - - <li> - <p>Our documents are available in differing formats. Right now, - they are just plain text, HTML, and PDF, but others are always a - future possibility. Be careful with URLs (<ulink>), and avoid - this mistake:</p> - - <p>My favorite site is <ulink - url="http://example.com%22%3Ehere%3C/ulink%3E;.</p> - - <p>This will render as <span class="QUOTE">"My favorite site is - here"</span>, which is not real helpful in a text doc. Better like - this:</p> - - <p>My favorite site is <ulink - url="http://example.com%22%3Eexample.com%3C/ulink%3E;.</p> - </li> - - <li> - <p>All documents should be spell checked occasionally. <span class= - "APPLICATION">aspell</span> can check SGML with the <tt class= - "LITERAL">-H</tt> option. (<span class="APPLICATION">ispell</span> - I think too.)</p> - </li> - </ul> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN217" id="AEN217">3.3. Privoxy Custom - Entities</a></h2> - - <p><span class="APPLICATION">Privoxy</span> documentation is using a - number of customized <span class="QUOTE">"entities"</span> to - facilitate documentation maintenance.</p> - - <p>We are using a set of <span class="QUOTE">"boilerplate"</span> files - with generic text, that is used by multiple docs. This way we can write - something once, and use it repeatedly without having to re-write the - same content over and over again. If editing such a file, keep in mind - that it should be <span class="emphasis EMPHASIS c3">generic</span>. - That is the purpose; so it can be used in varying contexts without - additional modifications.</p> - - <p>We are also using what <span class="APPLICATION">Docbook</span> - calls <span class="QUOTE">"internal entities"</span>. These are like - variables in programming. Well, sort of. For instance, we have the - <tt class="LITERAL">p-version</tt> entity that contains the current - <span class="APPLICATION">Privoxy</span> version string. You are - strongly encouraged to use these where possible. Some of these - obviously require re-setting with each release (done by the Makefile). - A sampling of custom entities are listed below. See any of the main - docs for examples.</p> - - <ul> - <li> - <p>Re- <span class="QUOTE">"boilerplate"</span> text entities are - defined like:</p> - - <p><tt class="LITERAL"><!entity supported SYSTEM - "supported.sgml"></tt></p> - - <p>In this example, the contents of the file, <tt class= - "FILENAME">supported.sgml</tt> is available for inclusion anywhere - in the doc. To make this happen, just reference the now defined - entity: <tt class="LITERAL">&supported;</tt> (starts with an - ampersand and ends with a semi-colon), and the contents will be - dumped into the finished doc at that point.</p> - </li> - - <li> - <p>Commonly used <span class="QUOTE">"internal - entities"</span>:</p> - - <table border="0"> - <tbody> - <tr> - <td><span class="emphasis EMPHASIS c3">p-version</span>: the - <span class="APPLICATION">Privoxy</span> version string, e.g. - <span class="QUOTE">"3.0.19"</span>.</td> - </tr> - - <tr> - <td><span class="emphasis EMPHASIS c3">p-status</span>: the - project status, either <span class="QUOTE">"alpha"</span>, - <span class="QUOTE">"beta"</span>, or <span class= - "QUOTE">"stable"</span>.</td> - </tr> - - <tr> - <td><span class="emphasis EMPHASIS c3">p-not-stable</span>: - use to conditionally include text in <span class="QUOTE">"not - stable"</span> releases (e.g. <span class= - "QUOTE">"beta"</span>).</td> - </tr> - - <tr> - <td><span class="emphasis EMPHASIS c3">p-stable</span>: just - the opposite.</td> - </tr> - - <tr> - <td><span class="emphasis EMPHASIS c3">p-text</span>: this - doc is only generated as text.</td> - </tr> - </tbody> - </table> - </li> - </ul> - - <p>There are others in various places that are defined for a specific - purpose. Read the source!</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="cvs.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="coding.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">The CVS Repository</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Coding Guidelines</td> - </tr> - </table> - </div> -</body> -</html> + and either <SPAN +CLASS="APPLICATION" +>jade</SPAN +> or + <SPAN +CLASS="APPLICATION" +>openjade</SPAN +> (recommended) installed in order to + build docs from source. Currently there is <A +HREF="../user-manual/index.html" +TARGET="_top" +><I +CLASS="CITETITLE" +>user-manual</I +></A +>, + <A +HREF="../faq/index.html" +TARGET="_top" +><I +CLASS="CITETITLE" +>FAQ</I +></A +>, and, of + course this, the <I +CLASS="CITETITLE" +>developer-manual</I +> in this format. + The <I +CLASS="CITETITLE" +>README</I +>, <I +CLASS="CITETITLE" +>AUTHORS</I +>, + <I +CLASS="CITETITLE" +>INSTALL</I +>, + <I +CLASS="CITETITLE" +>privoxy.1</I +> (man page), and + <I +CLASS="CITETITLE" +>config</I +> files are also now maintained as Docbook + SGML. These files, when built, in the top-level source directory are + generated files! Also, the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> <TT +CLASS="FILENAME" +>index.html</TT +> (and a + variation on this file, <TT +CLASS="FILENAME" +>privoxy-index.html</TT +>, + meant for inclusion with doc packages), are maintained as SGML as well. + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>DO NOT edit these directly</I +></SPAN +>. Edit the SGML source, or + contact someone involved in the documentation. + </P +><P +> <TT +CLASS="FILENAME" +>config</TT +> requires some special handling. The reason it + is maintained this way is so that the extensive comments in the file + mirror those in <I +CLASS="CITETITLE" +>user-manual</I +>. But the conversion + process requires going from SGML to HTML to text to special formatting + required for the embedded comments. Some of this does not survive so + well. Especially some of the examples that are longer than 80 characters. + The build process for this file outputs to <TT +CLASS="FILENAME" +>config.new</TT +>, + which should be reviewed for errors and mis-formatting. Once satisfied + that it is correct, then it should be hand copied to + <TT +CLASS="FILENAME" +>config</TT +>. + </P +><P +> Other, less formal documents (e.g. <TT +CLASS="FILENAME" +>LICENSE</TT +>) are + maintained as plain text files in the top-level source directory. + </P +><P +> Packagers are encouraged to include this documentation. For those without + the ability to build the docs locally, text versions of each are kept in + CVS. HTML versions are also being kept in CVS under + <TT +CLASS="FILENAME" +>doc/webserver/*</TT +>. And PDF version are kept in + <TT +CLASS="FILENAME" +>doc/pdf/*</TT +>. + </P +><P +> Formal documents are built with the Makefile targets of + <SAMP +CLASS="COMPUTEROUTPUT" +>make dok</SAMP +>, or alternately + <SAMP +CLASS="COMPUTEROUTPUT" +>make redhat-dok</SAMP +>. If you have problems, + try both. The build process uses the document SGML sources in + <SAMP +CLASS="COMPUTEROUTPUT" +>doc/source/*/*</SAMP +> to update all text files in + <SAMP +CLASS="COMPUTEROUTPUT" +>doc/text/</SAMP +> and to update all HTML + documents in <SAMP +CLASS="COMPUTEROUTPUT" +>doc/webserver/</SAMP +>. + </P +><P +> Documentation writers should please make sure documents build + successfully before committing to CVS, if possible. + </P +><P +> How do you update the webserver (i.e. the pages on privoxy.org)? + + <P +></P +><OL +TYPE="1" +><LI +><P +> First, build the docs by running <SAMP +CLASS="COMPUTEROUTPUT" +>make + dok</SAMP +> (or alternately <SAMP +CLASS="COMPUTEROUTPUT" +>make + redhat-dok</SAMP +>). For PDF docs, do <SAMP +CLASS="COMPUTEROUTPUT" +>make + dok-pdf</SAMP +>. + </P +></LI +><LI +><P +> Run <SAMP +CLASS="COMPUTEROUTPUT" +>make webserver</SAMP +> which copies all + files from <SAMP +CLASS="COMPUTEROUTPUT" +>doc/webserver</SAMP +> to the + sourceforge webserver via scp. + </P +></LI +></OL +> + </P +><P +> Finished docs should be occasionally submitted to CVS + (<TT +CLASS="FILENAME" +>doc/webserver/*/*.html</TT +>) so that those without + the ability to build them locally, have access to them if needed. + This is especially important just prior to a new release! Please + do this <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>after</I +></SPAN +> the <TT +CLASS="LITERAL" +>$VERSION</TT +> and + other release specific data in <TT +CLASS="FILENAME" +>configure.in</TT +> has been + updated (this is done just prior to a new release). + </P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="SGML" +>3.1. Quickstart to Docbook and SGML</A +></H2 +><P +> If you are not familiar with SGML, it is a markup language similar to HTML. + Actually, not a mark up language per se, but a language used to define + markup languages. In fact, HTML is an SGML application. Both will use + <SPAN +CLASS="QUOTE" +>"tags"</SPAN +> to format text and other content. SGML tags can be much + more varied, and flexible, but do much of the same kinds of things. The tags, + or <SPAN +CLASS="QUOTE" +>"elements"</SPAN +>, are definable in SGML. There is no set + <SPAN +CLASS="QUOTE" +>"standards"</SPAN +>. Since we are using + <SPAN +CLASS="APPLICATION" +>Docbook</SPAN +>, our tags are those that are defined by + <SPAN +CLASS="APPLICATION" +>Docbook</SPAN +>. Much of how the finish document is + rendered is determined by the <SPAN +CLASS="QUOTE" +>"stylesheets"</SPAN +>. + The stylesheets determine how each tag gets translated to HTML, or other + formats.</P +><P +> Tags in Docbook SGML need to be always <SPAN +CLASS="QUOTE" +>"closed"</SPAN +>. If not, you + will likely generate errors. Example: <TT +CLASS="LITERAL" +><title>My + Title</title></TT +>. They are also case-insensitive, but we + strongly suggest using all lower case. This keeps compatibility with + [Docbook] <SPAN +CLASS="APPLICATION" +>XML</SPAN +>.</P +><P +> Our documents use <SPAN +CLASS="QUOTE" +>"sections"</SPAN +> for the most part. Sections + will be processed into HTML headers (e.g. <TT +CLASS="LITERAL" +>h1</TT +> for + <TT +CLASS="LITERAL" +>sect1</TT +>). The <SPAN +CLASS="APPLICATION" +>Docbook</SPAN +> stylesheets + will use these to also generate the Table of Contents for each doc. Our + TOC's are set to a depth of three. Meaning <TT +CLASS="LITERAL" +>sect1</TT +>, + <TT +CLASS="LITERAL" +>sect2</TT +>, and <TT +CLASS="LITERAL" +>sect3</TT +> will have TOC + entries, but <TT +CLASS="LITERAL" +>sect4</TT +> will not. Each section requires + a <TT +CLASS="LITERAL" +><title></TT +> element, and at least one + <TT +CLASS="LITERAL" +><para></TT +>. There is a limit of five section + levels in Docbook, but generally three should be sufficient for our + purposes.</P +><P +> Some common elements that you likely will use: </P +><P +> <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><para></para></I +></SPAN +>, paragraph delimiter. Most + text needs to be within paragraph elements (there are some exceptions). + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><emphasis></emphasis></I +></SPAN +>, the stylesheets + make this italics. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><filename></filename></I +></SPAN +>, files and directories. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><command></command></I +></SPAN +>, command examples. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><literallayout></literallayout></I +></SPAN +>, like + <TT +CLASS="LITERAL" +><pre></TT +>, more or less. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><itemizedlist></itemizedlist></I +></SPAN +>, list with bullets. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><listitem></listitem></I +></SPAN +>, member of the above. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><screen></screen></I +></SPAN +>, screen output, implies + <TT +CLASS="LITERAL" +><literallayout></TT +>. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><ulink url="example.com"></ulink></I +></SPAN +>, like + HTML <TT +CLASS="LITERAL" +><a></TT +> tag. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><quote></quote></I +></SPAN +>, for, doh, quoting text. + </TD +></TR +></TBODY +></TABLE +><P +></P +></P +><P +> Look at any of the existing docs for examples of all these and more.</P +><P +> You might also find <SPAN +CLASS="QUOTE" +>"<A +HREF="http://opensource.bureau-cornavin.com/crash-course/index.html" +TARGET="_top" +>Writing Documentation + Using DocBook - A Crash Course</A +>"</SPAN +> useful.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="DOCSTYLE" +>3.2. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> Documentation Style</A +></H2 +><P +> It will be easier if everyone follows a similar writing style. This + just makes it easier to read what someone else has written if it + is all done in a similar fashion. + </P +><P +> Here it is: + </P +><P +> <P +></P +><UL +><LI +><P +> All tags should be lower case. + </P +></LI +><LI +><P +> Tags delimiting a <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>block</I +></SPAN +> of text (even small + blocks) should be on their own line. Like: + <P +CLASS="LITERALLAYOUT" +> <para><br> + Some text goes here.<br> + </para><br> + </P +> + Tags marking individual words, or few words, should be in-line: + <P +CLASS="LITERALLAYOUT" +> Just to <emphasis>emphasize</emphasis>, some text goes here.<br> + </P +> + </P +></LI +><LI +><P +> Tags should be nested and step indented for block text like: (except + in-line tags) + <P +CLASS="LITERALLAYOUT" +> <para><br> + <itemizedlist><br> + <para><br> + <listitem><br> + Some text goes here in our list example.<br> + </listitem><br> + </para><br> + </itemizedlist><br> + </para><br> + </P +> + This makes it easier to find the text amongst the tags ;-) + </P +></LI +><LI +><P +> Use white space to separate logical divisions within a document, + like between sections. Running everything together consistently + makes it harder to read and work on. + </P +></LI +><LI +><P +> Do not hesitate to make comments. Comments can either use the + <comment> element, or the <!-- --> style comment + familiar from HTML. (Note in Docbook v4.x <comment> is + replaced by <remark>.) + </P +></LI +><LI +><P +> We have an international audience. Refrain from slang, or English + idiosyncrasies (too many to list :). Humor also does not translate + well sometimes. + </P +></LI +><LI +><P +> Try to keep overall line lengths in source files to 80 characters or less + for obvious reasons. This is not always possible, with lengthy URLs for + instance. + </P +></LI +><LI +><P +> Our documents are available in differing formats. Right now, they + are just plain text, HTML, and PDF, but others are always a + future possibility. Be careful with URLs (<ulink>), and avoid + this mistake: + </P +><P +> My favorite site is <ulink url="http://example.com%22%3Ehere%3C/ulink%3E;. + </P +><P +> This will render as <SPAN +CLASS="QUOTE" +>"My favorite site is here"</SPAN +>, which is + not real helpful in a text doc. Better like this: + </P +><P +> My favorite site is <ulink url="http://example.com%22%3Eexample.com%3C/ulink%3E;. + </P +></LI +><LI +><P +> All documents should be spell checked occasionally. + <SPAN +CLASS="APPLICATION" +>aspell</SPAN +> can check SGML with the + <TT +CLASS="LITERAL" +>-H</TT +> option. (<SPAN +CLASS="APPLICATION" +>ispell</SPAN +> I think + too.) + </P +></LI +></UL +> + </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN217" +>3.3. Privoxy Custom Entities</A +></H2 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> documentation is using + a number of customized <SPAN +CLASS="QUOTE" +>"entities"</SPAN +> to facilitate + documentation maintenance. + </P +><P +> We are using a set of <SPAN +CLASS="QUOTE" +>"boilerplate"</SPAN +> files with generic text, + that is used by multiple docs. This way we can write something once, and use + it repeatedly without having to re-write the same content over and over again. + If editing such a file, keep in mind that it should be + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>generic</I +></SPAN +>. That is the purpose; so it can be used in varying + contexts without additional modifications. + </P +><P +> We are also using what <SPAN +CLASS="APPLICATION" +>Docbook</SPAN +> calls + <SPAN +CLASS="QUOTE" +>"internal entities"</SPAN +>. These are like variables in + programming. Well, sort of. For instance, we have the + <TT +CLASS="LITERAL" +>p-version</TT +> entity that contains the current + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version string. You are strongly + encouraged to use these where possible. Some of these obviously + require re-setting with each release (done by the Makefile). A sampling of + custom entities are listed below. See any of the main docs for examples. + </P +><P +> <P +></P +><UL +><LI +><P +> Re- <SPAN +CLASS="QUOTE" +>"boilerplate"</SPAN +> text entities are defined like: + </P +><P +> <TT +CLASS="LITERAL" +><!entity supported SYSTEM "supported.sgml"></TT +> + </P +><P +> In this example, the contents of the file, + <TT +CLASS="FILENAME" +>supported.sgml</TT +> is available for inclusion anywhere + in the doc. To make this happen, just reference the now defined + entity: <TT +CLASS="LITERAL" +>&supported;</TT +> (starts with an ampersand + and ends with a semi-colon), and the contents will be dumped into + the finished doc at that point. + </P +></LI +><LI +><P +> Commonly used <SPAN +CLASS="QUOTE" +>"internal entities"</SPAN +>: + </P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>p-version</I +></SPAN +>: the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + version string, e.g. <SPAN +CLASS="QUOTE" +>"3.0.12"</SPAN +>. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>p-status</I +></SPAN +>: the project status, either + <SPAN +CLASS="QUOTE" +>"alpha"</SPAN +>, <SPAN +CLASS="QUOTE" +>"beta"</SPAN +>, or <SPAN +CLASS="QUOTE" +>"stable"</SPAN +>. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>p-not-stable</I +></SPAN +>: use to conditionally include + text in <SPAN +CLASS="QUOTE" +>"not stable"</SPAN +> releases (e.g. <SPAN +CLASS="QUOTE" +>"beta"</SPAN +>). + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>p-stable</I +></SPAN +>: just the opposite. + </TD +></TR +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>p-text</I +></SPAN +>: this doc is only generated as text. + </TD +></TR +></TBODY +></TABLE +><P +></P +></LI +></UL +> + </P +><P +> There are others in various places that are defined for a specific + purpose. Read the source! + </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="cvs.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="coding.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>The CVS Repository</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Coding Guidelines</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/developer-manual/index.html b/external/privoxy/doc/webserver/developer-manual/index.html index 07858e3..4360e6b 100644 --- a/external/privoxy/doc/webserver/developer-manual/index.html +++ b/external/privoxy/doc/webserver/developer-manual/index.html @@ -1,406 +1,688 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy Developer Manual</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="NEXT" title="Introduction" href="introduction.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - hr.c2 {text-align: left} - dt.c1 {font-weight: bold} - </style> -</head> - -<body class="ARTICLE"> - <div class="ARTICLE"> - <div class="TITLEPAGE"> - <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy Developer - Manual</a></h1> - - <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> © - 2001-2009 by <a href="http://www.privoxy.org/" target="_top">Privoxy - Developers</a></sub><br></p> - - <p class="PUBDATE">$Id: developer-manual.sgml,v 2.37 2011/11/13 - 17:03:54 fabiankeil Exp $<br></p> - - <div class="ABSTRACT"> - <a name="AEN9" id="AEN9"></a> - - <p>The developer manual provides guidance on coding, testing, - packaging, documentation and other issues of importance to those - involved with <span class="APPLICATION">Privoxy</span> development. - It is mandatory (and helpful!) reading for anyone who wants to join - the team. Note that it's currently out of date and may not be - entirely correct. As always, patches are welcome.</p> - - <p>Please note that this document is constantly evolving. This copy - represents the state at the release of version 3.0.19. You can find - the latest version of the this manual at <a href= - "http://www.privoxy.org/developer-manual/" target= - "_top">http://www.privoxy.org/developer-manual/</a>. Please see - <a href="contact.html">the Contact section</a> on how to contact the - developers.</p> - </div> - <hr> - </div> - - <div class="TOC"> - <dl> - <dt class="c1">Table of Contents</dt> - - <dt>1. <a href="introduction.html">Introduction</a></dt> - - <dd> - <dl> - <dt>1.1. <a href="introduction.html#QUICKSTART">Quickstart to - Privoxy Development</a></dt> - </dl> - </dd> - - <dt>2. <a href="cvs.html">The CVS Repository</a></dt> - - <dd> - <dl> - <dt>2.1. <a href="cvs.html#CVSACCESS">Access to CVS</a></dt> - - <dt>2.2. <a href="cvs.html#CVSBRANCHES">Branches</a></dt> - - <dt>2.3. <a href="cvs.html#CVSCOMMIT">CVS Commit - Guidelines</a></dt> - </dl> - </dd> - - <dt>3. <a href="documentation.html">Documentation Guidelines</a></dt> - - <dd> - <dl> - <dt>3.1. <a href="documentation.html#SGML">Quickstart to Docbook - and SGML</a></dt> - - <dt>3.2. <a href="documentation.html#DOCSTYLE"><span class= - "APPLICATION">Privoxy</span> Documentation Style</a></dt> - - <dt>3.3. <a href="documentation.html#AEN217">Privoxy Custom - Entities</a></dt> - </dl> - </dd> - - <dt>4. <a href="coding.html">Coding Guidelines</a></dt> - - <dd> - <dl> - <dt>4.1. <a href="coding.html#S1">Introduction</a></dt> - - <dt>4.2. <a href="coding.html#S2">Using Comments</a></dt> - - <dd> - <dl> - <dt>4.2.1. <a href="coding.html#S3">Comment, Comment, - Comment</a></dt> - - <dt>4.2.2. <a href="coding.html#S4">Use blocks for - comments</a></dt> - - <dt>4.2.3. <a href="coding.html#S5">Keep Comments on their - own line</a></dt> - - <dt>4.2.4. <a href="coding.html#S6">Comment each logical - step</a></dt> - - <dt>4.2.5. <a href="coding.html#S7">Comment All Functions - Thoroughly</a></dt> - - <dt>4.2.6. <a href="coding.html#S8">Comment at the end of - braces if the content is more than one screen length</a></dt> - </dl> - </dd> - - <dt>4.3. <a href="coding.html#S9">Naming Conventions</a></dt> - - <dd> - <dl> - <dt>4.3.1. <a href="coding.html#S10">Variable Names</a></dt> - - <dt>4.3.2. <a href="coding.html#S11">Function Names</a></dt> - - <dt>4.3.3. <a href="coding.html#S12">Header file - prototypes</a></dt> - - <dt>4.3.4. <a href="coding.html#S13">Enumerations, and - #defines</a></dt> - - <dt>4.3.5. <a href="coding.html#S14">Constants</a></dt> - </dl> - </dd> - - <dt>4.4. <a href="coding.html#S15">Using Space</a></dt> - - <dd> - <dl> - <dt>4.4.1. <a href="coding.html#S16">Put braces on a line by - themselves.</a></dt> - - <dt>4.4.2. <a href="coding.html#S17">ALL control statements - should have a block</a></dt> - - <dt>4.4.3. <a href="coding.html#S18">Do not belabor/blow-up - boolean expressions</a></dt> - - <dt>4.4.4. <a href="coding.html#S19">Use white space freely - because it is free</a></dt> - - <dt>4.4.5. <a href="coding.html#S20">Don't use white space - around structure operators</a></dt> - - <dt>4.4.6. <a href="coding.html#S21">Make the last brace of a - function stand out</a></dt> - - <dt>4.4.7. <a href="coding.html#S22">Use 3 character - indentions</a></dt> - </dl> - </dd> - - <dt>4.5. <a href="coding.html#S23">Initializing</a></dt> - - <dd> - <dl> - <dt>4.5.1. <a href="coding.html#S24">Initialize all - variables</a></dt> - </dl> - </dd> - - <dt>4.6. <a href="coding.html#S25">Functions</a></dt> - - <dd> - <dl> - <dt>4.6.1. <a href="coding.html#S26">Name functions that - return a boolean as a question.</a></dt> - - <dt>4.6.2. <a href="coding.html#S27">Always specify a return - type for a function.</a></dt> - - <dt>4.6.3. <a href="coding.html#S28">Minimize function calls - when iterating by using variables</a></dt> - - <dt>4.6.4. <a href="coding.html#S29">Pass and Return by Const - Reference</a></dt> - - <dt>4.6.5. <a href="coding.html#S30">Pass and Return by - Value</a></dt> - - <dt>4.6.6. <a href="coding.html#S31">Names of include - files</a></dt> - - <dt>4.6.7. <a href="coding.html#S32">Provide multiple - inclusion protection</a></dt> - - <dt>4.6.8. <a href="coding.html#S33">Use `extern "C"` when - appropriate</a></dt> - - <dt>4.6.9. <a href="coding.html#S34">Where Possible, Use - Forward Struct Declaration Instead of Includes</a></dt> - </dl> - </dd> - - <dt>4.7. <a href="coding.html#S35">General Coding - Practices</a></dt> - - <dd> - <dl> - <dt>4.7.1. <a href="coding.html#S36">Turn on - warnings</a></dt> - - <dt>4.7.2. <a href="coding.html#S37">Provide a default case - for all switch statements</a></dt> - - <dt>4.7.3. <a href="coding.html#S38">Try to avoid falling - through cases in a switch statement.</a></dt> - - <dt>4.7.4. <a href="coding.html#S39">Use 'long' or 'short' - Instead of 'int'</a></dt> - - <dt>4.7.5. <a href="coding.html#S40">Don't mix size_t and - other types</a></dt> - - <dt>4.7.6. <a href="coding.html#S41">Declare each variable - and struct on its own line.</a></dt> - - <dt>4.7.7. <a href="coding.html#S42">Use malloc/zalloc - sparingly</a></dt> - - <dt>4.7.8. <a href="coding.html#S43">The Programmer Who Uses - 'malloc' is Responsible for Ensuring 'free'</a></dt> - - <dt>4.7.9. <a href="coding.html#S44">Add loaders to the - `file_list' structure and in order</a></dt> - - <dt>4.7.10. <a href="coding.html#S45">"Uncertain" new code - and/or changes to existing code, use FIXME or XXX</a></dt> - </dl> - </dd> - - <dt>4.8. <a href="coding.html#S46">Addendum: Template for files - and function comment blocks:</a></dt> - </dl> - </dd> - - <dt>5. <a href="testing.html">Testing Guidelines</a></dt> - - <dd> - <dl> - <dt>5.1. <a href="testing.html#TESTING-PLAN">Testplan for - releases</a></dt> - - <dt>5.2. <a href="testing.html#TESTING-REPORT">Test - reports</a></dt> - </dl> - </dd> - - <dt>6. <a href="newrelease.html">Releasing a New Version</a></dt> - - <dd> - <dl> - <dt>6.1. <a href="newrelease.html#VERSIONNUMBERS">Version - numbers</a></dt> - - <dt>6.2. <a href="newrelease.html#BEFORERELEASE">Before the - Release: Freeze</a></dt> - - <dt>6.3. <a href="newrelease.html#THERELEASE">Building and - Releasing the Packages</a></dt> - - <dd> - <dl> - <dt>6.3.1. <a href="newrelease.html#PACK-GUIDELINES">Note on - Privoxy Packaging</a></dt> - - <dt>6.3.2. <a href= - "newrelease.html#NEWRELEASE-TARBALL">Source Tarball</a></dt> - - <dt>6.3.3. <a href="newrelease.html#NEWRELEASE-RPM">SuSE, - Conectiva or Red Hat RPM</a></dt> - - <dt>6.3.4. <a href= - "newrelease.html#NEWRELEASE-OS2">OS/2</a></dt> - - <dt>6.3.5. <a href= - "newrelease.html#NEWRELEASE-SOLARIS">Solaris</a></dt> - - <dt>6.3.6. <a href= - "newrelease.html#NEWRELEASE-WINDOWS">Windows</a></dt> - - <dt>6.3.7. <a href= - "newrelease.html#NEWRELEASE-DEBIAN">Debian</a></dt> - - <dt>6.3.8. <a href="newrelease.html#NEWRELEASE-MACOSX">Mac OS - X</a></dt> - - <dt>6.3.9. <a href= - "newrelease.html#NEWRELEASE-FREEBSD">FreeBSD</a></dt> - - <dt>6.3.10. <a href="newrelease.html#NEWRELEASE-HPUX">HP-UX - 11</a></dt> - - <dt>6.3.11. <a href="newrelease.html#NEWRELEASE-AMIGA">Amiga - OS</a></dt> - - <dt>6.3.12. <a href= - "newrelease.html#NEWRELEASE-AIX">AIX</a></dt> - </dl> - </dd> - - <dt>6.4. <a href="newrelease.html#RELEASING">Uploading and - Releasing Your Package</a></dt> - - <dt>6.5. <a href="newrelease.html#AFTERRELEASE">After the - Release</a></dt> - </dl> - </dd> - - <dt>7. <a href="webserver-update.html">Update the Webserver</a></dt> - - <dt>8. <a href="contact.html">Contacting the developers, Bug - Reporting and Feature Requests</a></dt> - - <dd> - <dl> - <dt>8.1. <a href="contact.html#CONTACT-SUPPORT">Get - Support</a></dt> - - <dt>8.2. <a href="contact.html#REPORTING">Reporting - Problems</a></dt> - - <dd> - <dl> - <dt>8.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads - or Other Configuration Problems</a></dt> - - <dt>8.2.2. <a href="contact.html#CONTACT-BUGS">Reporting - Bugs</a></dt> - </dl> - </dd> - - <dt>8.3. <a href="contact.html#CONTACT-FEATURE">Request New - Features</a></dt> - - <dt>8.4. <a href="contact.html#MAILING-LISTS">Mailing - Lists</a></dt> - </dl> - </dd> - - <dt>9. <a href="copyright.html">Privoxy Copyright, License and - History</a></dt> - - <dd> - <dl> - <dt>9.1. <a href="copyright.html#AEN1231">License</a></dt> - - <dt>9.2. <a href="copyright.html#AEN1247">History</a></dt> - </dl> - </dd> - - <dt>10. <a href="seealso.html">See also</a></dt> - </dl> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c2" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"> </td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top"><a href= - "introduction.html" accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top"> </td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Introduction</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Privoxy Developer Manual</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="NEXT" +TITLE="Introduction" +HREF="introduction.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="ARTICLE" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="ARTICLE" +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +><A +NAME="AEN2" +>Privoxy Developer Manual</A +></H1 +><P +CLASS="PUBDATE" +> <SUB +> + + <A +HREF="copyright.html" +>Copyright</A +> © 2001-2009 by + <A +HREF="http://www.privoxy.org/" +TARGET="_top" +>Privoxy Developers</A +> + </SUB +> + <BR></P +><P +CLASS="PUBDATE" +>$Id: index.html,v 1.42 2009/03/21 12:59:32 fabiankeil Exp $<BR></P +><DIV +><DIV +CLASS="ABSTRACT" +><P +></P +><A +NAME="AEN9" +></A +><P +> The developer manual provides guidance on coding, testing, packaging, documentation + and other issues of importance to those involved with + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> development. It is mandatory (and helpful!) reading + for anyone who wants to join the team. Note that it's currently out of date + and may not be entirely correct. As always, patches are welcome.</P +><P +> Please note that this document is constantly evolving. This copy represents + the state at the release of version 3.0.12. + You can find the latest version of the this manual at <A +HREF="http://www.privoxy.org/developer-manual/" +TARGET="_top" +>http://www.privoxy.org/developer-manual/</A +>. + Please see <A +HREF="contact.html" +>the Contact section</A +> + on how to contact the developers.</P +><P +></P +></DIV +></DIV +><HR></DIV +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +>1. <A +HREF="introduction.html" +>Introduction</A +></DT +><DD +><DL +><DT +>1.1. <A +HREF="introduction.html#QUICKSTART" +>Quickstart to Privoxy Development</A +></DT +></DL +></DD +><DT +>2. <A +HREF="cvs.html" +>The CVS Repository</A +></DT +><DD +><DL +><DT +>2.1. <A +HREF="cvs.html#CVSACCESS" +>Access to CVS</A +></DT +><DT +>2.2. <A +HREF="cvs.html#CVSBRANCHES" +>Branches</A +></DT +><DT +>2.3. <A +HREF="cvs.html#CVSCOMMIT" +>CVS Commit Guidelines</A +></DT +></DL +></DD +><DT +>3. <A +HREF="documentation.html" +>Documentation Guidelines</A +></DT +><DD +><DL +><DT +>3.1. <A +HREF="documentation.html#SGML" +>Quickstart to Docbook and SGML</A +></DT +><DT +>3.2. <A +HREF="documentation.html#DOCSTYLE" +><SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> Documentation Style</A +></DT +><DT +>3.3. <A +HREF="documentation.html#AEN217" +>Privoxy Custom Entities</A +></DT +></DL +></DD +><DT +>4. <A +HREF="coding.html" +>Coding Guidelines</A +></DT +><DD +><DL +><DT +>4.1. <A +HREF="coding.html#S1" +>Introduction</A +></DT +><DT +>4.2. <A +HREF="coding.html#S2" +>Using Comments</A +></DT +><DD +><DL +><DT +>4.2.1. <A +HREF="coding.html#S3" +>Comment, Comment, Comment</A +></DT +><DT +>4.2.2. <A +HREF="coding.html#S4" +>Use blocks for comments</A +></DT +><DT +>4.2.3. <A +HREF="coding.html#S5" +>Keep Comments on their own line</A +></DT +><DT +>4.2.4. <A +HREF="coding.html#S6" +>Comment each logical step</A +></DT +><DT +>4.2.5. <A +HREF="coding.html#S7" +>Comment All Functions Thoroughly</A +></DT +><DT +>4.2.6. <A +HREF="coding.html#S8" +>Comment at the end of braces if the + content is more than one screen length</A +></DT +></DL +></DD +><DT +>4.3. <A +HREF="coding.html#S9" +>Naming Conventions</A +></DT +><DD +><DL +><DT +>4.3.1. <A +HREF="coding.html#S10" +>Variable Names</A +></DT +><DT +>4.3.2. <A +HREF="coding.html#S11" +>Function Names</A +></DT +><DT +>4.3.3. <A +HREF="coding.html#S12" +>Header file prototypes</A +></DT +><DT +>4.3.4. <A +HREF="coding.html#S13" +>Enumerations, and #defines</A +></DT +><DT +>4.3.5. <A +HREF="coding.html#S14" +>Constants</A +></DT +></DL +></DD +><DT +>4.4. <A +HREF="coding.html#S15" +>Using Space</A +></DT +><DD +><DL +><DT +>4.4.1. <A +HREF="coding.html#S16" +>Put braces on a line by themselves.</A +></DT +><DT +>4.4.2. <A +HREF="coding.html#S17" +>ALL control statements should have a + block</A +></DT +><DT +>4.4.3. <A +HREF="coding.html#S18" +>Do not belabor/blow-up boolean + expressions</A +></DT +><DT +>4.4.4. <A +HREF="coding.html#S19" +>Use white space freely because it is + free</A +></DT +><DT +>4.4.5. <A +HREF="coding.html#S20" +>Don't use white space around structure + operators</A +></DT +><DT +>4.4.6. <A +HREF="coding.html#S21" +>Make the last brace of a function stand + out</A +></DT +><DT +>4.4.7. <A +HREF="coding.html#S22" +>Use 3 character indentions</A +></DT +></DL +></DD +><DT +>4.5. <A +HREF="coding.html#S23" +>Initializing</A +></DT +><DD +><DL +><DT +>4.5.1. <A +HREF="coding.html#S24" +>Initialize all variables</A +></DT +></DL +></DD +><DT +>4.6. <A +HREF="coding.html#S25" +>Functions</A +></DT +><DD +><DL +><DT +>4.6.1. <A +HREF="coding.html#S26" +>Name functions that return a boolean as a + question.</A +></DT +><DT +>4.6.2. <A +HREF="coding.html#S27" +>Always specify a return type for a + function.</A +></DT +><DT +>4.6.3. <A +HREF="coding.html#S28" +>Minimize function calls when iterating by + using variables</A +></DT +><DT +>4.6.4. <A +HREF="coding.html#S29" +>Pass and Return by Const Reference</A +></DT +><DT +>4.6.5. <A +HREF="coding.html#S30" +>Pass and Return by Value</A +></DT +><DT +>4.6.6. <A +HREF="coding.html#S31" +>Names of include files</A +></DT +><DT +>4.6.7. <A +HREF="coding.html#S32" +>Provide multiple inclusion + protection</A +></DT +><DT +>4.6.8. <A +HREF="coding.html#S33" +>Use `extern "C"` when appropriate</A +></DT +><DT +>4.6.9. <A +HREF="coding.html#S34" +>Where Possible, Use Forward Struct + Declaration Instead of Includes</A +></DT +></DL +></DD +><DT +>4.7. <A +HREF="coding.html#S35" +>General Coding Practices</A +></DT +><DD +><DL +><DT +>4.7.1. <A +HREF="coding.html#S36" +>Turn on warnings</A +></DT +><DT +>4.7.2. <A +HREF="coding.html#S37" +>Provide a default case for all switch + statements</A +></DT +><DT +>4.7.3. <A +HREF="coding.html#S38" +>Try to avoid falling through cases in a + switch statement.</A +></DT +><DT +>4.7.4. <A +HREF="coding.html#S39" +>Use 'long' or 'short' Instead of + 'int'</A +></DT +><DT +>4.7.5. <A +HREF="coding.html#S40" +>Don't mix size_t and other types</A +></DT +><DT +>4.7.6. <A +HREF="coding.html#S41" +>Declare each variable and struct on its + own line.</A +></DT +><DT +>4.7.7. <A +HREF="coding.html#S42" +>Use malloc/zalloc sparingly</A +></DT +><DT +>4.7.8. <A +HREF="coding.html#S43" +>The Programmer Who Uses 'malloc' is + Responsible for Ensuring 'free'</A +></DT +><DT +>4.7.9. <A +HREF="coding.html#S44" +>Add loaders to the `file_list' structure + and in order</A +></DT +><DT +>4.7.10. <A +HREF="coding.html#S45" +>"Uncertain" new code and/or changes to + existing code, use FIXME or XXX</A +></DT +></DL +></DD +><DT +>4.8. <A +HREF="coding.html#S46" +>Addendum: Template for files and function + comment blocks:</A +></DT +></DL +></DD +><DT +>5. <A +HREF="testing.html" +>Testing Guidelines</A +></DT +><DD +><DL +><DT +>5.1. <A +HREF="testing.html#TESTING-PLAN" +>Testplan for releases</A +></DT +><DT +>5.2. <A +HREF="testing.html#TESTING-REPORT" +>Test reports</A +></DT +></DL +></DD +><DT +>6. <A +HREF="newrelease.html" +>Releasing a New Version</A +></DT +><DD +><DL +><DT +>6.1. <A +HREF="newrelease.html#VERSIONNUMBERS" +>Version numbers</A +></DT +><DT +>6.2. <A +HREF="newrelease.html#BEFORERELEASE" +>Before the Release: Freeze</A +></DT +><DT +>6.3. <A +HREF="newrelease.html#THERELEASE" +>Building and Releasing the Packages</A +></DT +><DD +><DL +><DT +>6.3.1. <A +HREF="newrelease.html#PACK-GUIDELINES" +>Note on Privoxy Packaging</A +></DT +><DT +>6.3.2. <A +HREF="newrelease.html#NEWRELEASE-TARBALL" +>Source Tarball</A +></DT +><DT +>6.3.3. <A +HREF="newrelease.html#NEWRELEASE-RPM" +>SuSE, Conectiva or Red Hat RPM</A +></DT +><DT +>6.3.4. <A +HREF="newrelease.html#NEWRELEASE-OS2" +>OS/2</A +></DT +><DT +>6.3.5. <A +HREF="newrelease.html#NEWRELEASE-SOLARIS" +>Solaris</A +></DT +><DT +>6.3.6. <A +HREF="newrelease.html#NEWRELEASE-WINDOWS" +>Windows</A +></DT +><DT +>6.3.7. <A +HREF="newrelease.html#NEWRELEASE-DEBIAN" +>Debian</A +></DT +><DT +>6.3.8. <A +HREF="newrelease.html#NEWRELEASE-MACOSX" +>Mac OS X</A +></DT +><DT +>6.3.9. <A +HREF="newrelease.html#NEWRELEASE-FREEBSD" +>FreeBSD</A +></DT +><DT +>6.3.10. <A +HREF="newrelease.html#NEWRELEASE-HPUX" +>HP-UX 11</A +></DT +><DT +>6.3.11. <A +HREF="newrelease.html#NEWRELEASE-AMIGA" +>Amiga OS</A +></DT +><DT +>6.3.12. <A +HREF="newrelease.html#NEWRELEASE-AIX" +>AIX</A +></DT +></DL +></DD +><DT +>6.4. <A +HREF="newrelease.html#RELEASING" +>Uploading and Releasing Your Package</A +></DT +><DT +>6.5. <A +HREF="newrelease.html#AFTERRELEASE" +>After the Release</A +></DT +></DL +></DD +><DT +>7. <A +HREF="webserver-update.html" +>Update the Webserver</A +></DT +><DT +>8. <A +HREF="contact.html" +>Contacting the developers, Bug Reporting and Feature Requests</A +></DT +><DD +><DL +><DT +>8.1. <A +HREF="contact.html#CONTACT-SUPPORT" +>Get Support</A +></DT +><DT +>8.2. <A +HREF="contact.html#REPORTING" +>Reporting Problems</A +></DT +><DD +><DL +><DT +>8.2.1. <A +HREF="contact.html#CONTACT-ADS" +>Reporting Ads or Other Configuration Problems</A +></DT +><DT +>8.2.2. <A +HREF="contact.html#CONTACT-BUGS" +>Reporting Bugs</A +></DT +></DL +></DD +><DT +>8.3. <A +HREF="contact.html#CONTACT-FEATURE" +>Request New Features</A +></DT +><DT +>8.4. <A +HREF="contact.html#CONTACT-OTHER" +>Other</A +></DT +></DL +></DD +><DT +>9. <A +HREF="copyright.html" +>Privoxy Copyright, License and History</A +></DT +><DD +><DL +><DT +>9.1. <A +HREF="copyright.html#AEN1223" +>License</A +></DT +><DT +>9.2. <A +HREF="copyright.html#AEN1239" +>History</A +></DT +></DL +></DD +><DT +>10. <A +HREF="seealso.html" +>See also</A +></DT +></DL +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +> </TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="introduction.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +> </TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Introduction</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/developer-manual/introduction.html b/external/privoxy/doc/webserver/developer-manual/introduction.html index 468f2fa..5ac1e59 100644 --- a/external/privoxy/doc/webserver/developer-manual/introduction.html +++ b/external/privoxy/doc/webserver/developer-manual/introduction.html @@ -1,116 +1,199 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Introduction</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Developer Manual" href="index.html"> - <link rel="PREVIOUS" title="Privoxy Developer Manual" href="index.html"> - <link rel="NEXT" title="The CVS Repository" href="cvs.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Developer Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="index.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="cvs.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="INTRODUCTION" id="INTRODUCTION">1. - Introduction</a></h1> - - <p><span class="APPLICATION">Privoxy</span>, as an heir to <span class= - "APPLICATION">Junkbuster</span>, is a Free Software project and the code - is licensed under the GNU General Public License version 2. As such, - <span class="APPLICATION">Privoxy</span> development is potentially open - to anyone who has the time, knowledge, and desire to contribute in any - capacity. Our goals are simply to continue the mission, to improve - <span class="APPLICATION">Privoxy</span>, and to make it available to as - wide an audience as possible.</p> - - <p>One does not have to be a programmer to contribute. Packaging, - testing, documenting and porting, are all important jobs as well.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="QUICKSTART" id="QUICKSTART">1.1. Quickstart - to Privoxy Development</a></h2> - - <p>The first step is to join the <a href= - "mailto:ijbswa-developers@lists.sourceforge.net" target= - "_top">developer's mailing list</a>. You can submit your ideas, or even - better patches. Patches are best submitted to the Sourceforge tracker - set up for this purpose, but can be sent to the list for review - too.</p> - - <p>You will also need to have a cvs package installed, which will - entail having ssh installed as well (which seems to be a requirement of - SourceForge), in order to access the cvs repository. Having the GNU - build tools is also going to be important (particularly, autoconf and - gmake).</p> - - <p>For the time being (read, this section is under construction), you - can also refer to the extensive comments in the source code. In fact, - reading the code is recommended in any case.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="index.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="cvs.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Privoxy Developer - Manual</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">The CVS Repository</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Introduction</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="NEXT" +TITLE="The CVS Repository" +HREF="cvs.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Developer Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="index.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="cvs.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INTRODUCTION" +>1. Introduction</A +></H1 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, as an heir to + <SPAN +CLASS="APPLICATION" +>Junkbuster</SPAN +>, is a Free Software project + and the code is licensed under the GNU General Public License version 2. + As such, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> development is potentially open + to anyone who has the time, knowledge, and desire to contribute + in any capacity. Our goals are simply to continue the mission, + to improve <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, and + to make it available to as wide an audience as possible. + </P +><P +> One does not have to be a programmer to contribute. Packaging, testing, + documenting and porting, are all important jobs as well. + </P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="QUICKSTART" +>1.1. Quickstart to Privoxy Development</A +></H2 +><P +> The first step is to join the <A +HREF="mailto:ijbswa-developers@lists.sourceforge.net" +TARGET="_top" +>developer's mailing list</A +>. + You can submit your ideas, or even better patches. Patches are best + submitted to the Sourceforge tracker set up for this purpose, but + can be sent to the list for review too. + </P +><P +> You will also need to have a cvs package installed, which will + entail having ssh installed as well (which seems to be a requirement of + SourceForge), in order to access the cvs repository. Having the GNU build + tools is also going to be important (particularly, autoconf and gmake). + </P +><P +> For the time being (read, this section is under construction), you can + also refer to the extensive comments in the source code. In fact, + reading the code is recommended in any case. + </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="cvs.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Privoxy Developer Manual</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>The CVS Repository</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/developer-manual/newrelease.html b/external/privoxy/doc/webserver/developer-manual/newrelease.html index e4655fe..0cdb485 100644 --- a/external/privoxy/doc/webserver/developer-manual/newrelease.html +++ b/external/privoxy/doc/webserver/developer-manual/newrelease.html @@ -1,1089 +1,1956 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Releasing a New Version</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Developer Manual" href="index.html"> - <link rel="PREVIOUS" title="Testing Guidelines" href="testing.html"> - <link rel="NEXT" title="Update the Webserver" href="webserver-update.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - tt.c5 {font-style: italic} - td.c4 {font-weight: bold} - table.c3 {background-color: #E0E0E0} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Developer Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="testing.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "webserver-update.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="NEWRELEASE" id="NEWRELEASE">6. Releasing a New - Version</a></h1> - - <p>When we release versions of <span class="APPLICATION">Privoxy</span>, - our work leaves our cozy secret lab and has to work in the cold - RealWorld[tm]. Once it is released, there is no way to call it back, so - it is very important that great care is taken to ensure that everything - runs fine, and not to introduce problems in the very last minute.</p> - - <p>So when releasing a new version, please adhere exactly to the - procedure outlined in this chapter.</p> - - <p>The following programs are required to follow this process: <tt class= - "FILENAME">ncftpput</tt> (ncftp), <tt class="FILENAME">scp, ssh</tt> - (ssh), <tt class="FILENAME">gmake</tt> (GNU's version of make), autoconf, - cvs.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="VERSIONNUMBERS" id="VERSIONNUMBERS">6.1. - Version numbers</a></h2> - - <p>First you need to determine which version number the release will - have. <span class="APPLICATION">Privoxy</span> version numbers consist - of three numbers, separated by dots, like in X.Y.Z (e.g. 3.0.0), - where:</p> - - <ul> - <li> - <p>X, the version major, is rarely ever changed. It is increased by - one if turning a development branch into stable substantially - changes the functionality, user interface or configuration syntax. - Majors 1 and 2 were <span class="APPLICATION">Junkbuster</span>, - and 3 will be the first stable <span class= - "APPLICATION">Privoxy</span> release.</p> - </li> - - <li> - <p>Y, the version minor, represents the branch within the major - version. At any point in time, there are two branches being - maintained: The stable branch, with an even minor, say, 2N, in - which no functionality is being added and only bug-fixes are made, - and 2N+1, the development branch, in which the further development - of <span class="APPLICATION">Privoxy</span> takes place. This - enables us to turn the code upside down and inside out, while at - the same time providing and maintaining a stable version. The minor - is reset to zero (and one) when the major is incremented. When a - development branch has matured to the point where it can be turned - into stable, the old stable branch 2N is given up (i.e. no longer - maintained), the former development branch 2N+1 becomes the new - stable branch 2N+2, and a new development branch 2N+3 is - opened.</p> - </li> - - <li> - <p>Z, the point or sub version, represents a release of the - software within a branch. It is therefore incremented immediately - before each code freeze. In development branches, only the even - point versions correspond to actual releases, while the odd ones - denote the evolving state of the sources on CVS in between. It - follows that Z is odd on CVS in development branches most of the - time. There, it gets increased to an even number immediately before - a code freeze, and is increased to an odd number again immediately - thereafter. This ensures that builds from CVS snapshots are easily - distinguished from released versions. The point version is reset to - zero when the minor changes.</p> - - <p>Stable branches work a little differently, since there should be - little to no development happening in such branches. Remember, only - bugfixes, which presumably should have had some testing before - being committed. Stable branches will then have their version - reported as <tt class="LITERAL">0.0.0</tt>, during that period - between releases when changes are being added. This is to denote - that this code is <span class="emphasis EMPHASIS c2">not for - release</span>. Then as the release nears, the version is bumped - according: e.g. <tt class="LITERAL">3.0.1 -> 0.0.0 -> - 3.0.2</tt>.</p> - </li> - </ul> - - <p>In summary, the main CVS trunk is the development branch where new - features are being worked on for the next stable series. This should - almost always be where the most activity takes place. There is always - at least one stable branch from the trunk, e.g now it is <tt class= - "LITERAL">3.0</tt>, which is only used to release stable versions. Once - the initial *.0 release of the stable branch has been done, then as a - rule, only bugfixes that have had prior testing should be committed to - the stable branch. Once there are enough bugfixes to justify a new - release, the version of this branch is again incremented Example: 3.0.0 - -> 3.0.1 -> 3.0.2, etc are all stable releases from within the - stable branch. 3.1.x is currently the main trunk, and where work on - 3.2.x is taking place. If any questions, please post to the devel list - <span class="emphasis EMPHASIS c2">before</span> committing to a stable - branch!</p> - - <p>Developers should remember too that if they commit a bugfix to the - stable branch, this will more than likely require a separate submission - to the main trunk, since these are separate development trees within - CVS. If you are working on both, then this would require at least two - separate check outs (i.e main trunk, <span class= - "emphasis EMPHASIS c2">and</span> the stable release branch, which is - <tt class="LITERAL">v_3_0_branch</tt> at the moment).</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="BEFORERELEASE" id="BEFORERELEASE">6.2. - Before the Release: Freeze</a></h2> - - <p>The following <span class="emphasis EMPHASIS c2">must be done by one - of the developers</span> prior to each new release.</p> - - <ul> - <li> - <p>Make sure that everybody who has worked on the code in the last - couple of days has had a chance to yell <span class= - "QUOTE">"no!"</span> in case they have pending changes/fixes in - their pipelines. Announce the freeze so that nobody will interfere - with last minute changes.</p> - </li> - - <li> - <p>Increment the version number (point from odd to even in - development branches!) in <tt class="FILENAME">configure.in</tt>. - (RPM spec files will need to be incremented as well.)</p> - </li> - - <li> - <p>If <tt class="FILENAME">default.action</tt> has changed since - last release (i.e. software release or standalone actions file - release), bump up its version info to A.B in this line:</p> - - <table class="c3" border="0" width="90%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - {+add-header{X-Actions-File-Version: A.B} -filter -no-popups} -</pre> - </td> - </tr> - </table> - - <p>Then change the version info in doc/webserver/actions/index.php, - line: '$required_actions_file_version = "A.B";'</p> - </li> - - <li> - <p>All documentation should be rebuild after the version bump. - Finished docs should be then be committed to CVS (for those without - the ability to build these). Some docs may require rather obscure - processing tools. <tt class="FILENAME">config</tt>, the man page - (and the html version of the man page), and the PDF docs fall in - this category. REAMDE, the man page, AUTHORS, and config should all - also be committed to CVS for other packagers. The formal docs - should be uploaded to the webserver. See the Section "Updating the - webserver" in this manual for details.</p> - </li> - - <li> - <p>The <i class="CITETITLE">User Manual</i> is also used for - context sensitive help for the CGI editor. This is version - sensitive, so that the user will get appropriate help for his/her - release. So with each release a fresh version should be uploaded to - the webserver (this is in addition to the main <i class= - "CITETITLE">User Manual</i> link from the main page since we need - to keep manuals for various versions available). The CGI pages will - link to something like <tt class= - "LITERAL">http://privoxy.org/$(VERSION)/user-manual/</tt>. This - will need to be updated for each new release. There is no Makefile - target for this at this time!!! It needs to be done manually.</p> - </li> - - <li> - <p>All developers should look at the <tt class= - "FILENAME">ChangeLog</tt> and make sure noteworthy changes are - referenced.</p> - </li> - - <li> - <p><span class="emphasis EMPHASIS c2">Commit all files that were - changed in the above steps!</span></p> - </li> - - <li> - <p>Tag all files in CVS with the version number with <span class= - "QUOTE">"<b class="COMMAND">cvs tag v_X_Y_Z</b>"</span>. Don't use - vX_Y_Z, ver_X_Y_Z, v_X.Y.Z (won't work) etc.</p> - </li> - - <li> - <p>If the release was in a development branch, increase the point - version from even to odd (X.Y.(Z+1)) again in <tt class= - "FILENAME">configure.in</tt> and commit your change.</p> - </li> - - <li> - <p>On the webserver, copy the user manual to a new top-level - directory called <tt class="FILENAME">X.Y.Z</tt>. This ensures that - help links from the CGI pages, which have the version as a prefix, - will go into the right version of the manual. If this is a - development branch release, also symlink <tt class= - "FILENAME">X.Y.(Z-1)</tt> to <tt class="FILENAME">X.Y.Z</tt> and - <tt class="FILENAME">X.Y.(Z+1)</tt> to <tt class="FILENAME">.</tt> - (i.e. dot).</p> - </li> - </ul> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="THERELEASE" id="THERELEASE">6.3. Building - and Releasing the Packages</a></h2> - - <p>Now the individual packages can be built and released. Note that for - GPL reasons the first package to be released is always the source - tarball.</p> - - <p>For <span class="emphasis EMPHASIS c2">all</span> types of packages, - including the source tarball, <span class="emphasis EMPHASIS c2">you - must make sure that you build from clean sources by exporting the right - version from CVS into an empty directory</span> (just press return when - asked for a password):</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - mkdir dist # delete or choose different name if it already exists +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Releasing a New Version</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Testing Guidelines" +HREF="testing.html"><LINK +REL="NEXT" +TITLE="Update the Webserver" +HREF="webserver-update.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Developer Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="testing.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="webserver-update.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="NEWRELEASE" +>6. Releasing a New Version</A +></H1 +><P +> When we release versions of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, + our work leaves our cozy secret lab and has to work in the cold + RealWorld[tm]. Once it is released, there is no way to call it + back, so it is very important that great care is taken to ensure + that everything runs fine, and not to introduce problems in the + very last minute. + </P +><P +> So when releasing a new version, please adhere exactly to the + procedure outlined in this chapter. + </P +><P +> The following programs are required to follow this process: + <TT +CLASS="FILENAME" +>ncftpput</TT +> (ncftp), <TT +CLASS="FILENAME" +>scp, ssh</TT +> (ssh), + <TT +CLASS="FILENAME" +>gmake</TT +> (GNU's version of make), autoconf, cvs. + </P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="VERSIONNUMBERS" +>6.1. Version numbers</A +></H2 +><P +> First you need to determine which version number the release will have. + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version numbers consist of three numbers, + separated by dots, like in X.Y.Z (e.g. 3.0.0), where: + <P +></P +><UL +><LI +><P +> X, the version major, is rarely ever changed. It is increased by one if + turning a development branch into stable substantially changes the functionality, + user interface or configuration syntax. Majors 1 and 2 were + <SPAN +CLASS="APPLICATION" +>Junkbuster</SPAN +>, and 3 will be the first stable + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> release. + </P +></LI +><LI +><P +> Y, the version minor, represents the branch within the major version. + At any point in time, there are two branches being maintained: + The stable branch, with an even minor, say, 2N, in which no functionality is + being added and only bug-fixes are made, and 2N+1, the development branch, in + which the further development of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> takes + place. + This enables us to turn the code upside down and inside out, while at the same time + providing and maintaining a stable version. + The minor is reset to zero (and one) when the major is incremented. When a development + branch has matured to the point where it can be turned into stable, the old stable branch + 2N is given up (i.e. no longer maintained), the former development branch 2N+1 becomes the + new stable branch 2N+2, and a new development branch 2N+3 is opened. + </P +></LI +><LI +><P +> Z, the point or sub version, represents a release of the software within a branch. + It is therefore incremented immediately before each code freeze. + In development branches, only the even point versions correspond to actual releases, + while the odd ones denote the evolving state of the sources on CVS in between. + It follows that Z is odd on CVS in development branches most of the time. There, it gets + increased to an even number immediately before a code freeze, and is increased to an odd + number again immediately thereafter. + This ensures that builds from CVS snapshots are easily distinguished from released versions. + The point version is reset to zero when the minor changes. + </P +><P +> Stable branches work a little differently, since there should be + little to no development happening in such branches. Remember, + only bugfixes, which presumably should have had some testing + before being committed. Stable branches will then have their + version reported as <TT +CLASS="LITERAL" +>0.0.0</TT +>, during that period + between releases when changes are being added. This is to denote + that this code is <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not for release</I +></SPAN +>. Then + as the release nears, the version is bumped according: e.g. + <TT +CLASS="LITERAL" +>3.0.1 -> 0.0.0 -> 3.0.2</TT +>. + </P +></LI +></UL +> + </P +><P +> In summary, the main CVS trunk is the development branch where new + features are being worked on for the next stable series. This should + almost always be where the most activity takes place. There is always at + least one stable branch from the trunk, e.g now it is + <TT +CLASS="LITERAL" +>3.0</TT +>, which is only used to release stable versions. + Once the initial *.0 release of the stable branch has been done, then as a + rule, only bugfixes that have had prior testing should be committed to + the stable branch. Once there are enough bugfixes to justify a new + release, the version of this branch is again incremented Example: 3.0.0 + -> 3.0.1 -> 3.0.2, etc are all stable releases from within the stable + branch. 3.1.x is currently the main trunk, and where work on 3.2.x is + taking place. If any questions, please post to the devel list + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>before</I +></SPAN +> committing to a stable branch! + </P +><P +> Developers should remember too that if they commit a bugfix to the stable + branch, this will more than likely require a separate submission to the + main trunk, since these are separate development trees within CVS. If you + are working on both, then this would require at least two separate check + outs (i.e main trunk, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>and</I +></SPAN +> the stable release branch, + which is <TT +CLASS="LITERAL" +>v_3_0_branch</TT +> at the moment). + </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="BEFORERELEASE" +>6.2. Before the Release: Freeze</A +></H2 +><P +> The following <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>must be done by one of the + developers</I +></SPAN +> prior to each new release. + </P +><P +> <P +></P +><UL +><LI +><P +> Make sure that everybody who has worked on the code in the last + couple of days has had a chance to yell <SPAN +CLASS="QUOTE" +>"no!"</SPAN +> in case + they have pending changes/fixes in their pipelines. Announce the + freeze so that nobody will interfere with last minute changes. + </P +></LI +><LI +><P +> Increment the version number (point from odd to even in development + branches!) in <TT +CLASS="FILENAME" +>configure.in</TT +>. (RPM spec files + will need to be incremented as well.) + </P +></LI +><LI +><P +> If <TT +CLASS="FILENAME" +>default.action</TT +> has changed since last + release (i.e. software release or standalone actions file release), + bump up its version info to A.B in this line: + </P +><P +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> {+add-header{X-Actions-File-Version: A.B} -filter -no-popups}</PRE +></TD +></TR +></TABLE +> + </P +><P +> + Then change the version info in doc/webserver/actions/index.php, + line: '$required_actions_file_version = "A.B";' + </P +></LI +><LI +><P +> All documentation should be rebuild after the version bump. + Finished docs should be then be committed to CVS (for those + without the ability to build these). Some docs may require + rather obscure processing tools. <TT +CLASS="FILENAME" +>config</TT +>, + the man page (and the html version of the man page), and the PDF docs + fall in this category. REAMDE, the man page, AUTHORS, and config + should all also be committed to CVS for other packagers. The + formal docs should be uploaded to the webserver. See the + Section "Updating the webserver" in this manual for details. + </P +></LI +><LI +><P +> The <I +CLASS="CITETITLE" +>User Manual</I +> is also used for context + sensitive help for the CGI editor. This is version sensitive, so that + the user will get appropriate help for his/her release. So with + each release a fresh version should be uploaded to the webserver + (this is in addition to the main <I +CLASS="CITETITLE" +>User Manual</I +> + link from the main page since we need to keep manuals for various + versions available). The CGI pages will link to something like + <TT +CLASS="LITERAL" +>http://privoxy.org/$(VERSION)/user-manual/</TT +>. This + will need to be updated for each new release. There is no Makefile + target for this at this time!!! It needs to be done manually. + </P +></LI +><LI +><P +> All developers should look at the <TT +CLASS="FILENAME" +>ChangeLog</TT +> and + make sure noteworthy changes are referenced. + </P +></LI +><LI +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Commit all files that were changed in the above steps!</I +></SPAN +> + </P +></LI +><LI +><P +> Tag all files in CVS with the version number with + <SPAN +CLASS="QUOTE" +>"<B +CLASS="COMMAND" +>cvs tag v_X_Y_Z</B +>"</SPAN +>. + Don't use vX_Y_Z, ver_X_Y_Z, v_X.Y.Z (won't work) etc. + </P +></LI +><LI +><P +> If the release was in a development branch, increase the point version + from even to odd (X.Y.(Z+1)) again in <TT +CLASS="FILENAME" +>configure.in</TT +> and + commit your change. + </P +></LI +><LI +><P +> On the webserver, copy the user manual to a new top-level directory + called <TT +CLASS="FILENAME" +>X.Y.Z</TT +>. This ensures that help links from the CGI + pages, which have the version as a prefix, will go into the right version of the manual. + If this is a development branch release, also symlink <TT +CLASS="FILENAME" +>X.Y.(Z-1)</TT +> + to <TT +CLASS="FILENAME" +>X.Y.Z</TT +> and <TT +CLASS="FILENAME" +>X.Y.(Z+1)</TT +> to + <TT +CLASS="FILENAME" +>.</TT +> (i.e. dot). + </P +></LI +></UL +> + </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="THERELEASE" +>6.3. Building and Releasing the Packages</A +></H2 +><P +> Now the individual packages can be built and released. Note that for + GPL reasons the first package to be released is always the source tarball. + </P +><P +> For <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> types of packages, including the source tarball, + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>you must make sure that you build from clean sources by exporting + the right version from CVS into an empty directory</I +></SPAN +> (just press return when + asked for a password): + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> mkdir dist # delete or choose different name if it already exists cd dist cvs -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa login - cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa export -r v_X_Y_Z current -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Do NOT change</span> a single - bit, including, but not limited to version information after export - from CVS. This is to make sure that all release packages, and with - them, all future bug reports, are based on exactly the same code.</p> - - <div class="WARNING"> - <table class="WARNING" border="1" width="100%"> - <tr> - <td class="c4" align="center">Warning</td> - </tr> - - <tr> - <td align="left"> - <p>Every significant release of Privoxy has included at least - one package that either had incorrect versions of files, - missing files, or incidental leftovers from a previous build - process that gave unknown numbers of users headaches to try to - figure out what was wrong. PLEASE, make sure you are using - pristene sources, and are following the prescribed process!</p> - </td> - </tr> - </table> - </div> - - <p>Please find additional instructions for the source tarball and the - individual platform dependent binary packages below. And details on the - Sourceforge release process below that.</p> - - <div class="SECT3"> - <h3 class="SECT3"><a name="PACK-GUIDELINES" id= - "PACK-GUIDELINES">6.3.1. Note on Privoxy Packaging</a></h3> - - <p>Please keep these general guidelines in mind when putting together - your package. These apply to <span class= - "emphasis EMPHASIS c2">all</span> platforms!</p> - - <ul> - <li> - <p><span class="APPLICATION">Privoxy</span> <span class= - "emphasis EMPHASIS c2">requires</span> write access to: all - <tt class="FILENAME">*.action</tt> files, all logfiles, and the - <tt class="FILENAME">trust</tt> file. You will need to determine - the best way to do this for your platform.</p> - </li> - - <li> - <p>Please include up to date documentation. At a bare - minimum:</p> - - <table border="0"> - <tbody> - <tr> - <td><tt class="FILENAME">LICENSE</tt> (top-level - directory)</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><tt class="FILENAME">README</tt> (top-level - directory)</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><tt class="FILENAME">AUTHORS</tt> (top-level - directory)</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><tt class="FILENAME">man page</tt> (top-level - directory, Unix-like platforms only)</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><tt class="FILENAME">The User Manual</tt> - (doc/webserver/user-manual/)</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><tt class="FILENAME">FAQ</tt> (doc/webserver/faq/)</td> - </tr> - </tbody> - </table> - - <p>Also suggested: <tt class="FILENAME">Developer Manual</tt> - (doc/webserver/developer-manual) and <tt class= - "FILENAME">ChangeLog</tt> (top-level directory). <tt class= - "FILENAME">FAQ</tt> and the manuals are HTML docs. There are also - text versions in <tt class="FILENAME">doc/text/</tt> which could - conceivably also be included.</p> - - <p>The documentation has been designed such that the manuals are - linked to each other from parallel directories, and should be - packaged that way. <tt class="FILENAME">privoxy-index.html</tt> - can also be included and can serve as a focal point for docs and - other links of interest (and possibly renamed to <tt class= - "FILENAME">index.html</tt>). This should be one level up from the - manuals. There is a link also on this page to an HTMLized version - of the man page. To avoid 404 for this, it is in CVS as - <tt class="FILENAME">doc/webserver/man-page/privoxy-man-page.html</tt>, - and should be included along with the manuals. There is also a - css stylesheets that can be included for better presentation: - <tt class="FILENAME">p_doc.css</tt>. This should be in the same - directory with <tt class="FILENAME">privoxy-index.html</tt>, - (i.e. one level up from the manual directories).</p> - </li> - - <li> - <p><tt class="FILENAME">user.action</tt> and <tt class= - "FILENAME">user.filter</tt> are designed for local preferences. - Make sure these do not get overwritten! <tt class= - "FILENAME">config</tt> should not be overwritten either. This has - especially important configuration data in it. <tt class= - "FILENAME">trust</tt> should be left in tact as well.</p> - </li> - - <li> - <p>Other configuration files (<tt class= - "FILENAME">default.action</tt> and <tt class= - "FILENAME">default.filter</tt>) should be installed as the new - defaults, but all previously installed configuration files should - be preserved as backups. This is just good manners :-) These - files are likely to change between releases and contain important - new features and bug fixes.</p> - </li> - - <li> - <p>Please check platform specific notes in this doc, if you - haven't done <span class="QUOTE">"Privoxy"</span> packaging - before for other platform specific issues. Conversely, please add - any notes that you know are important for your platform (or - contact one of the doc maintainers to do this if you can't).</p> - </li> - - <li> - <p>Packagers should do a <span class="QUOTE">"clean"</span> - install of their package after building it. So any previous - installs should be removed first to ensure the integrity of the - newly built package. Then run the package for a while to make - sure there are no obvious problems, before uploading.</p> - </li> - </ul> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-TARBALL" id= - "NEWRELEASE-TARBALL">6.3.2. Source Tarball</a></h3> - - <p>First, <span class="emphasis EMPHASIS c2">make sure that you have - freshly exported the right version into an empty directory</span>. - (See "Building and releasing packages" above). Then run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cd current - autoheader && autoconf && ./configure -</pre> - </td> - </tr> - </table> - - <p>Then do:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - make tarball-dist -</pre> - </td> - </tr> - </table> - - <p>To upload the package to Sourceforge, simply issue</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - make tarball-upload -</pre> - </td> - </tr> - </table> - - <p>Go to the displayed URL and release the file publicly on - Sourceforge. For the change log field, use the relevant section of - the <tt class="FILENAME">ChangeLog</tt> file.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-RPM" id="NEWRELEASE-RPM">6.3.3. - SuSE, Conectiva or Red Hat RPM</a></h3> - - <p>In following text, replace <tt class="REPLACEABLE c5">dist</tt> - with either <span class="QUOTE">"rh"</span> for Red Hat or - <span class="QUOTE">"suse"</span> for SuSE.</p> - - <p>First, <span class="emphasis EMPHASIS c2">make sure that you have - freshly exported the right version into an empty directory</span>. - (See "Building and releasing packages" above).</p> - - <p>As the only exception to not changing anything after export from - CVS, now examine the file <tt class= - "FILENAME">privoxy-</tt><tt class="REPLACEABLE c5">dist</tt><tt class="FILENAME">.spec</tt> - and make sure that the version information and the RPM release number - are correct. The RPM release numbers for each version start at one. - Hence it must be reset to one if this is the first RPM for <tt class= - "REPLACEABLE c5">dist</tt> which is built from version X.Y.Z. Check - the <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118" target= - "_top">file list</a> if unsure. Else, it must be set to the highest - already available RPM release number for that version plus one.</p> - - <p>Then run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cd current - autoheader && autoconf && ./configure -</pre> - </td> - </tr> - </table> - - <p>Then do</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - make <tt class="REPLACEABLE c5">dist</tt>-dist -</pre> - </td> - </tr> - </table> - - <p>To upload the package to Sourceforge, simply issue</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - make <tt class="REPLACEABLE c5">dist</tt>-upload <tt class= -"REPLACEABLE c5">rpm_packagerev</tt> -</pre> - </td> - </tr> - </table> - - <p>where <tt class="REPLACEABLE c5">rpm_packagerev</tt> is the RPM - release number as determined above. Go to the displayed URL and - release the file publicly on Sourceforge. Use the release notes and - change log from the source tarball package.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-OS2" id="NEWRELEASE-OS2">6.3.4. - OS/2</a></h3> - - <p>First, <span class="emphasis EMPHASIS c2">make sure that you have - freshly exported the right version into an empty directory</span>. - (See "Building and releasing packages" above). Then get the OS/2 - Setup module:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co os2setup -</pre> - </td> - </tr> - </table> - - <p>You will need a mix of development tools. The main compilation - takes place with IBM Visual Age C++. Some ancillary work takes place - with GNU tools, available from various sources like hobbes.nmsu.edu. - Specificially, you will need <tt class="FILENAME">autoheader</tt>, - <tt class="FILENAME">autoconf</tt> and <tt class="FILENAME">sh</tt> - tools. The packaging takes place with WarpIN, available from various - sources, including its home page: <a href= - "http://www.xworkplace.org/" target="_top">xworkplace</a>.</p> - - <p>Change directory to the <tt class="FILENAME">os2setup</tt> - directory. Edit the os2build.cmd file to set the final executable - filename. For example,</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - installExeName='privoxyos2_setup_X.Y.Z.exe' -</pre> - </td> - </tr> - </table> - - <p>Next, edit the <tt class="FILENAME">IJB.wis</tt> file so the - release number matches in the <tt class="FILENAME">PACKAGEID</tt> - section:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - PACKAGEID="Privoxy Team\Privoxy\Privoxy Package\X\Y\Z" -</pre> - </td> - </tr> - </table> - - <p>You're now ready to build. Run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - os2build -</pre> - </td> - </tr> - </table> - - <p>You will find the WarpIN-installable executable in the <tt class= - "FILENAME">./files</tt> directory. Upload this anonymously to - <tt class="FILENAME">uploads.sourceforge.net/incoming</tt>, create a - release for it, and you're done. Use the release notes and Change Log - from the source tarball package.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-SOLARIS" id= - "NEWRELEASE-SOLARIS">6.3.5. Solaris</a></h3> - - <p>Login to Sourceforge's compilefarm via ssh:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - ssh cf.sourceforge.net -</pre> - </td> - </tr> - </table> - - <p>Choose the right operating system (not the Debian one). When - logged in, <span class="emphasis EMPHASIS c2">make sure that you have - freshly exported the right version into an empty directory</span>. - (See "Building and releasing packages" above). Then run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cd current - autoheader && autoconf && ./configure -</pre> - </td> - </tr> - </table> - - <p>Then run</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - gmake solaris-dist -</pre> - </td> - </tr> - </table> - - <p>which creates a gzip'ed tar archive. Sadly, you cannot use - <b class="COMMAND">make solaris-upload</b> on the Sourceforge machine - (no ncftpput). You now have to manually upload the archive to - Sourceforge's ftp server and release the file publicly. Use the - release notes and Change Log from the source tarball package.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-WINDOWS" id= - "NEWRELEASE-WINDOWS">6.3.6. Windows</a></h3> - - <p>You should ensure you have the latest version of Cygwin (from - <a href="http://www.cygwin.com/" target= - "_top">http://www.cygwin.com/</a>). Run the following commands from - within a Cygwin bash shell.</p> - - <p>First, <span class="emphasis EMPHASIS c2">make sure that you have - freshly exported the right version into an empty directory</span>. - (See "Building and releasing packages" above). Then get the Windows - setup module:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co winsetup -</pre> - </td> - </tr> - </table> - - <p>Then you can build the package. This is fully automated, and is - controlled by <tt class="FILENAME">winsetup/GNUmakefile</tt>. All you - need to do is:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cd winsetup - make -</pre> - </td> - </tr> - </table> - - <p>Now you can manually rename <tt class= - "FILENAME">privoxy_setup.exe</tt> to <tt class= - "FILENAME">privoxy_setup_X_Y_Z.exe</tt>, and upload it to - SourceForge. When releasing the package on SourceForge, use the - release notes and Change Log from the source tarball package.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-DEBIAN" id= - "NEWRELEASE-DEBIAN">6.3.7. Debian</a></h3> - - <p>First, <span class="emphasis EMPHASIS c2">make sure that you have - freshly exported the right version into an empty directory</span>. - (See "Building and releasing packages" above). Then add a log entry - to <tt class="FILENAME">debian/changelog</tt>, if it is not already - there, for example by running:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - debchange -v 3.0.19-stable-1 "New upstream version" -</pre> - </td> - </tr> - </table> - - <p>Then, run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - dpkg-buildpackage -rfakeroot -us -uc -b -</pre> - </td> - </tr> - </table> - - <p>This will create <tt class= - "FILENAME">../privoxy_3.0.19-stable-1_i386.deb</tt> which can be - uploaded. To upload the package to Sourceforge, simply issue</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - make debian-upload -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-MACOSX" id= - "NEWRELEASE-MACOSX">6.3.8. Mac OS X</a></h3> - - <p>First, <span class="emphasis EMPHASIS c2">make sure that you have - freshly exported the right version into an empty directory</span>. - (See "Building and releasing packages" above). Then get the Mac OS X - setup module:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co osxsetup -</pre> - </td> - </tr> - </table> - - <p>Then run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cd osxsetup - build -</pre> - </td> - </tr> - </table> - - <p>This will run <tt class="FILENAME">autoheader</tt>, <tt class= - "FILENAME">autoconf</tt> and <tt class="FILENAME">configure</tt> as - well as <tt class="FILENAME">make</tt>. Finally, it will copy over - the necessary files to the ./osxsetup/files directory for further - processing by <tt class="FILENAME">PackageMaker</tt>.</p> - - <p>Bring up PackageMaker with the PrivoxyPackage.pmsp definition - file, modify the package name to match the release, and hit the - "Create package" button. If you specify ./Privoxy.pkg as the output - package name, you can then create the distributable zip file with the - command:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - zip -r privoxyosx_setup_x.y.z.zip Privoxy.pkg -</pre> - </td> - </tr> - </table> - - <p>You can then upload <tt class= - "FILENAME">privoxyosx_setup_x.y.z.zip</tt> anonymously to <tt class= - "FILENAME">uploads.sourceforge.net/incoming</tt>, create a release - for it, and you're done. Use the release notes and Change Log from - the source tarball package.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-FREEBSD" id= - "NEWRELEASE-FREEBSD">6.3.9. FreeBSD</a></h3> - - <p>Login to Sourceforge's compile-farm via ssh:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - ssh cf.sourceforge.net -</pre> - </td> - </tr> - </table> - - <p>Choose the right operating system. When logged in, <span class= - "emphasis EMPHASIS c2">make sure that you have freshly exported the - right version into an empty directory</span>. (See "Building and - releasing packages" above). Then run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cd current - autoheader && autoconf && ./configure -</pre> - </td> - </tr> - </table> - - <p>Then run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - gmake freebsd-dist -</pre> - </td> - </tr> - </table> - - <p>which creates a gzip'ed tar archive. Sadly, you cannot use - <b class="COMMAND">make freebsd-upload</b> on the Sourceforge machine - (no ncftpput). You now have to manually upload the archive to - Sourceforge's ftp server and release the file publicly. Use the - release notes and Change Log from the source tarball package.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-HPUX" id= - "NEWRELEASE-HPUX">6.3.10. HP-UX 11</a></h3> - - <p>First, <span class="emphasis EMPHASIS c2">make sure that you have - freshly exported the right version into an empty directory</span>. - (See "Building and releasing packages" above). Then run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cd current - autoheader && autoconf && ./configure -</pre> - </td> - </tr> - </table> - - <p>Then do FIXME.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-AMIGA" id= - "NEWRELEASE-AMIGA">6.3.11. Amiga OS</a></h3> - - <p>First, <span class="emphasis EMPHASIS c2">make sure that you have - freshly exported the right version into an empty directory</span>. - (See "Building and releasing packages" above). Then run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cd current - autoheader && autoconf && ./configure -</pre> - </td> - </tr> - </table> - - <p>Then do FIXME.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="NEWRELEASE-AIX" id= - "NEWRELEASE-AIX">6.3.12. AIX</a></h3> - - <p>Login to Sourceforge's compilefarm via ssh:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - ssh cf.sourceforge.net -</pre> - </td> - </tr> - </table> - - <p>Choose the right operating system. When logged in, <span class= - "emphasis EMPHASIS c2">make sure that you have freshly exported the - right version into an empty directory</span>. (See "Building and - releasing packages" above). Then run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - cd current - autoheader && autoconf && ./configure -</pre> - </td> - </tr> - </table> - - <p>Then run:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - make aix-dist -</pre> - </td> - </tr> - </table> - - <p>which creates a gzip'ed tar archive. Sadly, you cannot use - <b class="COMMAND">make aix-upload</b> on the Sourceforge machine (no - ncftpput). You now have to manually upload the archive to - Sourceforge's ftp server and release the file publicly. Use the - release notes and Change Log from the source tarball package.</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="RELEASING" id="RELEASING">6.4. Uploading and - Releasing Your Package</a></h2> - - <p>After the package is ready, it is time to upload it to SourceForge, - and go through the release steps. The upload is done via FTP:</p> - - <ul> - <li> - <p>Upload to: <a href="ftp://upload.sourceforge.net/incoming" - target="_top">ftp://upload.sourceforge.net/incoming</a></p> - </li> - - <li> - <p>user: <tt class="LITERAL">anonymous</tt></p> - </li> - - <li> - <p>password: <tt class= - "LITERAL">ijbswa-developers@lists.sourceforge.net</tt></p> - </li> - </ul> - - <p>Or use the <b class="COMMAND">make</b> targets as described - above.</p> - - <p>Once this done go to <a href= - "https://sourceforge.net/project/admin/editpackages.php?group_id=11118" - target= - "_top">https://sourceforge.net/project/admin/editpackages.php?group_id=11118</a>, - making sure you are logged in. Find your target platform in the second - column, and click <tt class="LITERAL">Add Release</tt>. You will then - need to create a new release for your package, using the format of - <tt class="LITERAL">$VERSION ($CODE_STATUS)</tt>, e.g. <span class= - "emphasis EMPHASIS c2">3.0.19 (beta)</span>.</p> - - <p>Now just follow the prompts. Be sure to add any appropriate Release - notes. You should see your freshly uploaded packages in <span class= - "QUOTE">"Step 2. Add Files To This Release"</span>. Check the - appropriate box(es). Remember at each step to hit the <span class= - "QUOTE">"Refresh/Submit"</span> buttons! You should now see your - file(s) listed in Step 3. Fill out the forms with the appropriate - information for your platform, being sure to hit <span class= - "QUOTE">"Update"</span> for each file. If anyone is monitoring your - platform, check the <span class="QUOTE">"email"</span> box at the very - bottom to notify them of the new package. This should do it!</p> - - <p>If you have made errors, or need to make changes, you can go through - essentially the same steps, but select <tt class="LITERAL">Edit - Release</tt>, instead of <tt class="LITERAL">Add Release</tt>.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AFTERRELEASE" id="AFTERRELEASE">6.5. After - the Release</a></h2> - - <p>When all (or: most of the) packages have been uploaded and made - available, send an email to the <a href= - "mailto:ijbswa-announce@lists.sourceforge.net" target="_top">announce - mailing list</a>, Subject: "Version X.Y.Z available for download". Be - sure to include the <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118" target= - "_top">download location</a>, the release notes and the Changelog. - Also, post an updated News item on the project page Sourceforge, and - update the Home page and docs linked from the Home page (see below). - Other news sites and release oriented sites, such as Freshmeat, should - also be notified.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="testing.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href= - "webserver-update.html" accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Testing Guidelines</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Update the Webserver</td> - </tr> - </table> - </div> -</body> -</html> + cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa export -r v_X_Y_Z current</PRE +></TD +></TR +></TABLE +> + </P +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Do NOT change</I +></SPAN +> a single bit, including, but not limited to + version information after export from CVS. This is to make sure that + all release packages, and with them, all future bug reports, are based + on exactly the same code. + </P +><DIV +CLASS="WARNING" +><P +></P +><TABLE +CLASS="WARNING" +BORDER="1" +WIDTH="100%" +><TR +><TD +ALIGN="CENTER" +><B +>Warning</B +></TD +></TR +><TR +><TD +ALIGN="LEFT" +><P +> Every significant release of Privoxy has included at least one + package that either had incorrect versions of files, missing files, + or incidental leftovers from a previous build process that gave + unknown numbers of users headaches to try to figure out what was + wrong. PLEASE, make sure you are using pristene sources, and are + following the prescribed process! + </P +></TD +></TR +></TABLE +></DIV +><P +> Please find additional instructions for the source tarball and the + individual platform dependent binary packages below. And details + on the Sourceforge release process below that. + </P +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="PACK-GUIDELINES" +>6.3.1. Note on Privoxy Packaging</A +></H3 +><P +> Please keep these general guidelines in mind when putting together + your package. These apply to <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> platforms! + </P +><P +> <P +></P +><UL +><LI +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>requires</I +></SPAN +> + write access to: all <TT +CLASS="FILENAME" +>*.action</TT +> files, all + logfiles, and the <TT +CLASS="FILENAME" +>trust</TT +> file. You will + need to determine the best way to do this for your platform. + </P +></LI +><LI +><P +> Please include up to date documentation. At a bare minimum: + </P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>LICENSE</TT +> (top-level directory) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>README</TT +> (top-level directory) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>AUTHORS</TT +> (top-level directory) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>man page</TT +> (top-level directory, Unix-like + platforms only) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>The User Manual</TT +> (doc/webserver/user-manual/) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <TT +CLASS="FILENAME" +>FAQ</TT +> (doc/webserver/faq/) + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +> Also suggested: <TT +CLASS="FILENAME" +>Developer Manual</TT +> + (doc/webserver/developer-manual) and <TT +CLASS="FILENAME" +>ChangeLog</TT +> + (top-level directory). <TT +CLASS="FILENAME" +>FAQ</TT +> and the manuals are + HTML docs. There are also text versions in + <TT +CLASS="FILENAME" +>doc/text/</TT +> which could conceivably also be + included. + </P +><P +> The documentation has been designed such that the manuals are linked + to each other from parallel directories, and should be packaged + that way. <TT +CLASS="FILENAME" +>privoxy-index.html</TT +> can also be + included and can serve as a focal point for docs and other links of + interest (and possibly renamed to <TT +CLASS="FILENAME" +>index.html</TT +>). + This should be one level up from the manuals. There is a link also + on this page to an HTMLized version of the man page. To avoid 404 for + this, it is in CVS as + <TT +CLASS="FILENAME" +>doc/webserver/man-page/privoxy-man-page.html</TT +>, + and should be included along with the manuals. There is also a + css stylesheets that can be included for better presentation: + <TT +CLASS="FILENAME" +>p_doc.css</TT +>. This should be in the same directory + with <TT +CLASS="FILENAME" +>privoxy-index.html</TT +>, (i.e. one level up from + the manual directories). + </P +></LI +><LI +><P +> <TT +CLASS="FILENAME" +>user.action</TT +> and <TT +CLASS="FILENAME" +>user.filter</TT +> + are designed for local preferences. Make sure these do not get overwritten! + <TT +CLASS="FILENAME" +>config</TT +> should not be overwritten either. This + has especially important configuration data in it. + <TT +CLASS="FILENAME" +>trust</TT +> should be left in tact as well. + </P +></LI +><LI +><P +> Other configuration files (<TT +CLASS="FILENAME" +>default.action</TT +> and + <TT +CLASS="FILENAME" +>default.filter</TT +>) should be installed as the new + defaults, but all previously installed configuration files should be + preserved as backups. This is just good manners :-) These files are + likely to change between releases and contain important new features + and bug fixes. + </P +></LI +><LI +><P +> Please check platform specific notes in this doc, if you haven't + done <SPAN +CLASS="QUOTE" +>"Privoxy"</SPAN +> packaging before for other platform + specific issues. Conversely, please add any notes that you know + are important for your platform (or contact one of the doc + maintainers to do this if you can't). + </P +></LI +><LI +><P +> Packagers should do a <SPAN +CLASS="QUOTE" +>"clean"</SPAN +> install of their + package after building it. So any previous installs should be + removed first to ensure the integrity of the newly built package. + Then run the package for a while to make sure there are no + obvious problems, before uploading. + </P +></LI +></UL +> + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-TARBALL" +>6.3.2. Source Tarball</A +></H3 +><P +> First, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the right + version into an empty directory</I +></SPAN +>. (See "Building and releasing + packages" above). Then run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cd current + autoheader && autoconf && ./configure</PRE +></TD +></TR +></TABLE +> + </P +><P +> Then do: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> make tarball-dist</PRE +></TD +></TR +></TABLE +> + </P +><P +> To upload the package to Sourceforge, simply issue + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> make tarball-upload</PRE +></TD +></TR +></TABLE +> + </P +><P +> Go to the displayed URL and release the file publicly on Sourceforge. + For the change log field, use the relevant section of the + <TT +CLASS="FILENAME" +>ChangeLog</TT +> file. + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-RPM" +>6.3.3. SuSE, Conectiva or Red Hat RPM</A +></H3 +><P +> In following text, replace <TT +CLASS="REPLACEABLE" +><I +>dist</I +></TT +> + with either <SPAN +CLASS="QUOTE" +>"rh"</SPAN +> for Red Hat or <SPAN +CLASS="QUOTE" +>"suse"</SPAN +> for SuSE. + </P +><P +> First, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the right + version into an empty directory</I +></SPAN +>. (See "Building and releasing + packages" above). + </P +><P +> As the only exception to not changing anything after export from CVS, + now examine the file <TT +CLASS="FILENAME" +>privoxy-</TT +><TT +CLASS="REPLACEABLE" +><I +>dist</I +></TT +><TT +CLASS="FILENAME" +>.spec</TT +> + and make sure that the version information and the RPM release number are + correct. The RPM release numbers for each version start at one. Hence it must + be reset to one if this is the first RPM for + <TT +CLASS="REPLACEABLE" +><I +>dist</I +></TT +> which is built from version + X.Y.Z. Check the + <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>file + list</A +> if unsure. Else, it must be set to the highest already available RPM + release number for that version plus one. + </P +><P +> Then run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cd current + autoheader && autoconf && ./configure</PRE +></TD +></TR +></TABLE +> + </P +><P +> Then do + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> make <TT +CLASS="REPLACEABLE" +><I +>dist</I +></TT +>-dist</PRE +></TD +></TR +></TABLE +> + </P +><P +> To upload the package to Sourceforge, simply issue + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> make <TT +CLASS="REPLACEABLE" +><I +>dist</I +></TT +>-upload <TT +CLASS="REPLACEABLE" +><I +>rpm_packagerev</I +></TT +></PRE +></TD +></TR +></TABLE +> + </P +><P +> where <TT +CLASS="REPLACEABLE" +><I +>rpm_packagerev</I +></TT +> is the + RPM release number as determined above. + Go to the displayed URL and release the file publicly on Sourceforge. + Use the release notes and change log from the source tarball package. + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-OS2" +>6.3.4. OS/2</A +></H3 +><P +> First, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the right + version into an empty directory</I +></SPAN +>. (See "Building and releasing + packages" above). Then get the OS/2 Setup module: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co os2setup</PRE +></TD +></TR +></TABLE +> + </P +><P +> You will need a mix of development tools. + The main compilation takes place with IBM Visual Age C++. + Some ancillary work takes place with GNU tools, available from + various sources like hobbes.nmsu.edu. + Specificially, you will need <TT +CLASS="FILENAME" +>autoheader</TT +>, + <TT +CLASS="FILENAME" +>autoconf</TT +> and <TT +CLASS="FILENAME" +>sh</TT +> tools. + The packaging takes place with WarpIN, available from various sources, including + its home page: <A +HREF="http://www.xworkplace.org/" +TARGET="_top" +>xworkplace</A +>. + </P +><P +> Change directory to the <TT +CLASS="FILENAME" +>os2setup</TT +> directory. + Edit the os2build.cmd file to set the final executable filename. + For example, + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> installExeName='privoxyos2_setup_X.Y.Z.exe'</PRE +></TD +></TR +></TABLE +> + </P +><P +> Next, edit the <TT +CLASS="FILENAME" +>IJB.wis</TT +> file so the release number matches + in the <TT +CLASS="FILENAME" +>PACKAGEID</TT +> section: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> PACKAGEID="Privoxy Team\Privoxy\Privoxy Package\X\Y\Z"</PRE +></TD +></TR +></TABLE +> + </P +><P +> You're now ready to build. Run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> os2build</PRE +></TD +></TR +></TABLE +> + </P +><P +> You will find the WarpIN-installable executable in the + <TT +CLASS="FILENAME" +>./files</TT +> directory. Upload this anonymously to + <TT +CLASS="FILENAME" +>uploads.sourceforge.net/incoming</TT +>, create a release + for it, and you're done. Use the release notes and Change Log from the + source tarball package. + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-SOLARIS" +>6.3.5. Solaris</A +></H3 +><P +> Login to Sourceforge's compilefarm via ssh: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> ssh cf.sourceforge.net</PRE +></TD +></TR +></TABLE +> + </P +><P +> Choose the right operating system (not the Debian one). + When logged in, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the right + version into an empty directory</I +></SPAN +>. (See "Building and releasing + packages" above). Then run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cd current + autoheader && autoconf && ./configure</PRE +></TD +></TR +></TABLE +> + </P +><P +> Then run + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> gmake solaris-dist</PRE +></TD +></TR +></TABLE +> + </P +><P +> which creates a gzip'ed tar archive. Sadly, you cannot use <B +CLASS="COMMAND" +>make + solaris-upload</B +> on the Sourceforge machine (no ncftpput). You now have + to manually upload the archive to Sourceforge's ftp server and release + the file publicly. Use the release notes and Change Log from the + source tarball package. + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-WINDOWS" +>6.3.6. Windows</A +></H3 +><P +> You should ensure you have the latest version of Cygwin (from + <A +HREF="http://www.cygwin.com/" +TARGET="_top" +>http://www.cygwin.com/</A +>). + Run the following commands from within a Cygwin bash shell. + </P +><P +> First, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the right + version into an empty directory</I +></SPAN +>. (See "Building and releasing + packages" above). Then get the Windows setup module: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co winsetup</PRE +></TD +></TR +></TABLE +> + </P +><P +> Then you can build the package. This is fully automated, and is + controlled by <TT +CLASS="FILENAME" +>winsetup/GNUmakefile</TT +>. + All you need to do is: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cd winsetup + make</PRE +></TD +></TR +></TABLE +> + </P +><P +> Now you can manually rename <TT +CLASS="FILENAME" +>privoxy_setup.exe</TT +> to + <TT +CLASS="FILENAME" +>privoxy_setup_X_Y_Z.exe</TT +>, and upload it to + SourceForge. When releasing the package on SourceForge, use the release notes + and Change Log from the source tarball package. + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-DEBIAN" +>6.3.7. Debian</A +></H3 +><P +> First, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the + right version into an empty directory</I +></SPAN +>. (See + "Building and releasing packages" above). Then add a log + entry to <TT +CLASS="FILENAME" +>debian/changelog</TT +>, if it is not + already there, for example by running: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> debchange -v 3.0.12-stable-1 "New upstream version"</PRE +></TD +></TR +></TABLE +> + </P +><P +> Then, run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> dpkg-buildpackage -rfakeroot -us -uc -b</PRE +></TD +></TR +></TABLE +> + </P +><P +> This will create + <TT +CLASS="FILENAME" +>../privoxy_3.0.12-stable-1_i386.deb</TT +> + which can be uploaded. To upload the package to Sourceforge, simply + issue + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> make debian-upload</PRE +></TD +></TR +></TABLE +> + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-MACOSX" +>6.3.8. Mac OS X</A +></H3 +><P +> First, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the right + version into an empty directory</I +></SPAN +>. (See "Building and releasing + packages" above). Then get the Mac OS X setup module: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co osxsetup</PRE +></TD +></TR +></TABLE +> + </P +><P +> Then run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cd osxsetup + build</PRE +></TD +></TR +></TABLE +> + </P +><P +> This will run <TT +CLASS="FILENAME" +>autoheader</TT +>, <TT +CLASS="FILENAME" +>autoconf</TT +> and + <TT +CLASS="FILENAME" +>configure</TT +> as well as <TT +CLASS="FILENAME" +>make</TT +>. + Finally, it will copy over the necessary files to the ./osxsetup/files directory + for further processing by <TT +CLASS="FILENAME" +>PackageMaker</TT +>. + </P +><P +> Bring up PackageMaker with the PrivoxyPackage.pmsp definition file, modify the package + name to match the release, and hit the "Create package" button. + If you specify ./Privoxy.pkg as the output package name, you can then create + the distributable zip file with the command: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> zip -r privoxyosx_setup_x.y.z.zip Privoxy.pkg</PRE +></TD +></TR +></TABLE +> + </P +><P +> You can then upload <TT +CLASS="FILENAME" +>privoxyosx_setup_x.y.z.zip</TT +> anonymously to + <TT +CLASS="FILENAME" +>uploads.sourceforge.net/incoming</TT +>, + create a release for it, and you're done. Use the release notes + and Change Log from the source tarball package. + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-FREEBSD" +>6.3.9. FreeBSD</A +></H3 +><P +> Login to Sourceforge's compile-farm via ssh: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> ssh cf.sourceforge.net</PRE +></TD +></TR +></TABLE +> + </P +><P +> Choose the right operating system. + When logged in, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the right + version into an empty directory</I +></SPAN +>. (See "Building and releasing + packages" above). Then run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cd current + autoheader && autoconf && ./configure</PRE +></TD +></TR +></TABLE +> + </P +><P +> Then run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> gmake freebsd-dist</PRE +></TD +></TR +></TABLE +> + </P +><P +> which creates a gzip'ed tar archive. Sadly, you cannot use <B +CLASS="COMMAND" +>make + freebsd-upload</B +> on the Sourceforge machine (no ncftpput). You now have + to manually upload the archive to Sourceforge's ftp server and release + the file publicly. Use the release notes and Change Log from the + source tarball package. + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-HPUX" +>6.3.10. HP-UX 11</A +></H3 +><P +> First, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the right + version into an empty directory</I +></SPAN +>. (See "Building and releasing + packages" above). Then run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cd current + autoheader && autoconf && ./configure</PRE +></TD +></TR +></TABLE +> + </P +><P +> Then do FIXME. + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-AMIGA" +>6.3.11. Amiga OS</A +></H3 +><P +> First, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the right + version into an empty directory</I +></SPAN +>. (See "Building and releasing + packages" above). Then run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cd current + autoheader && autoconf && ./configure</PRE +></TD +></TR +></TABLE +> + </P +><P +> Then do FIXME. + </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="NEWRELEASE-AIX" +>6.3.12. AIX</A +></H3 +><P +> Login to Sourceforge's compilefarm via ssh: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> ssh cf.sourceforge.net</PRE +></TD +></TR +></TABLE +> + </P +><P +> Choose the right operating system. + When logged in, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>make sure that you have freshly exported the right + version into an empty directory</I +></SPAN +>. (See "Building and releasing + packages" above). Then run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> cd current + autoheader && autoconf && ./configure</PRE +></TD +></TR +></TABLE +> + </P +><P +> Then run: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> make aix-dist</PRE +></TD +></TR +></TABLE +> + </P +><P +> which creates a gzip'ed tar archive. Sadly, you cannot use <B +CLASS="COMMAND" +>make + aix-upload</B +> on the Sourceforge machine (no ncftpput). You now have + to manually upload the archive to Sourceforge's ftp server and release + the file publicly. Use the release notes and Change Log from the + source tarball package. + </P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="RELEASING" +>6.4. Uploading and Releasing Your Package</A +></H2 +><P +> After the package is ready, it is time to upload it + to SourceForge, and go through the release steps. The upload + is done via FTP: + </P +><P +> <P +></P +><UL +><LI +><P +> Upload to: <A +HREF="ftp://upload.sourceforge.net/incoming" +TARGET="_top" +>ftp://upload.sourceforge.net/incoming</A +> + </P +></LI +><LI +><P +> user: <TT +CLASS="LITERAL" +>anonymous</TT +> + </P +></LI +><LI +><P +> password: <TT +CLASS="LITERAL" +>ijbswa-developers@lists.sourceforge.net</TT +> + </P +></LI +></UL +> + </P +><P +> Or use the <B +CLASS="COMMAND" +>make</B +> targets as described above. + </P +><P +> Once this done go to <A +HREF="https://sourceforge.net/project/admin/editpackages.php?group_id=11118" +TARGET="_top" +>https://sourceforge.net/project/admin/editpackages.php?group_id=11118</A +>, + making sure you are logged in. Find your target platform in the + second column, and click <TT +CLASS="LITERAL" +>Add Release</TT +>. You will + then need to create a new release for your package, using the format + of <TT +CLASS="LITERAL" +>$VERSION ($CODE_STATUS)</TT +>, e.g. <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>3.0.12 + (beta)</I +></SPAN +>. + </P +><P +> Now just follow the prompts. Be sure to add any appropriate Release + notes. You should see your freshly uploaded packages in + <SPAN +CLASS="QUOTE" +>"Step 2. Add Files To This Release"</SPAN +>. Check the + appropriate box(es). Remember at each step to hit the + <SPAN +CLASS="QUOTE" +>"Refresh/Submit"</SPAN +> buttons! You should now see your + file(s) listed in Step 3. Fill out the forms with the appropriate + information for your platform, being sure to hit <SPAN +CLASS="QUOTE" +>"Update"</SPAN +> + for each file. If anyone is monitoring your platform, check the + <SPAN +CLASS="QUOTE" +>"email"</SPAN +> box at the very bottom to notify them of + the new package. This should do it! + </P +><P +> If you have made errors, or need to make changes, you can go through + essentially the same steps, but select <TT +CLASS="LITERAL" +>Edit Release</TT +>, + instead of <TT +CLASS="LITERAL" +>Add Release</TT +>. + </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AFTERRELEASE" +>6.5. After the Release</A +></H2 +><P +> When all (or: most of the) packages have been uploaded and made available, + send an email to the <A +HREF="mailto:ijbswa-announce@lists.sourceforge.net" +TARGET="_top" +>announce + mailing list</A +>, Subject: "Version X.Y.Z available for download". Be sure to + include the + <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>download + location</A +>, the release notes and the Changelog. Also, post an + updated News item on the project page Sourceforge, and update the Home + page and docs linked from the Home page (see below). Other news sites + and release oriented sites, such as Freshmeat, should also be notified. + </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="testing.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="webserver-update.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Testing Guidelines</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Update the Webserver</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/developer-manual/seealso.html b/external/privoxy/doc/webserver/developer-manual/seealso.html index ee706f5..35ee27c 100644 --- a/external/privoxy/doc/webserver/developer-manual/seealso.html +++ b/external/privoxy/doc/webserver/developer-manual/seealso.html @@ -1,204 +1,405 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>See also</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Developer Manual" href="index.html"> - <link rel="PREVIOUS" title="Privoxy Copyright, License and History" href= - "copyright.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Developer Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="copyright.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"> </td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="SEEALSO" id="SEEALSO">10. See also</a></h1> - - <p>Other references and sites of interest to <span class= - "APPLICATION">Privoxy</span> users:</p> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.privoxy.org/" target= - "_top">http://www.privoxy.org/</a>, the <span class= - "APPLICATION">Privoxy</span> Home page.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.privoxy.org/faq/" target= - "_top">http://www.privoxy.org/faq/</a>, the <span class= - "APPLICATION">Privoxy</span> FAQ.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.privoxy.org/developer-manual/" target= - "_top">http://www.privoxy.org/developer-manual/</a>, the - <span class="APPLICATION">Privoxy</span> developer manual.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="https://sourceforge.net/projects/ijbswa/" target= - "_top">https://sourceforge.net/projects/ijbswa/</a>, the Project - Page for <span class="APPLICATION">Privoxy</span> on <a href= - "http://sourceforge.net" target="_top">SourceForge</a>.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://config.privoxy.org/" target= - "_top">http://config.privoxy.org/</a>, the web-based user - interface. <span class="APPLICATION">Privoxy</span> must be running - for this to work. Shortcut: <a href="http://p.p/" target= - "_top">http://p.p/</a></td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href= - "https://sourceforge.net/tracker/?group_id=11118&atid=460288" - target= - "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>, - to submit <span class="QUOTE">"misses"</span> and other - configuration related suggestions to the developers.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.junkbusters.com/ht/en/cookies.html" target= - "_top">http://www.junkbusters.com/ht/en/cookies.html</a>, an - explanation how cookies are used to track web users.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.junkbusters.com/ijb.html" target= - "_top">http://www.junkbusters.com/ijb.html</a>, the original - Internet Junkbuster.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.squid-cache.org/" target= - "_top">http://www.squid-cache.org/</a>, a popular caching proxy, - which is often used together with <span class= - "APPLICATION">Privoxy</span>.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.pps.jussieu.fr/~jch/software/polipo/" - target="_top">http://www.pps.jussieu.fr/~jch/software/polipo/</a>, - <span class="APPLICATION">Polipo</span> is a caching proxy with - advanced features like pipelining, multiplexing and caching of - partial instances. In many setups it can be used as <span class= - "APPLICATION">Squid</span> replacement.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="https://www.torproject.org/" target= - "_top">https://www.torproject.org/</a>, <span class= - "APPLICATION">Tor</span> can help anonymize web browsing, web - publishing, instant messaging, IRC, SSH, and other - applications.</td> - </tr> - </tbody> - </table> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="copyright.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"> </td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Privoxy Copyright, License - and History</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top"> </td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>See also</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Privoxy Copyright, License and History" +HREF="copyright.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Developer Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="copyright.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +> </TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="SEEALSO" +>10. See also</A +></H1 +><P +> Other references and sites of interest to <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + users:</P +><P +> <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/" +TARGET="_top" +>http://www.privoxy.org/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> Home page. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/faq/" +TARGET="_top" +>http://www.privoxy.org/faq/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> FAQ. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/developer-manual/" +TARGET="_top" +>http://www.privoxy.org/developer-manual/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developer manual. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="https://sourceforge.net/projects/ijbswa/" +TARGET="_top" +>https://sourceforge.net/projects/ijbswa/</A +>, + the Project Page for <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on + <A +HREF="http://sourceforge.net" +TARGET="_top" +>SourceForge</A +>. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>http://config.privoxy.org/</A +>, + the web-based user interface. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> must be + running for this to work. Shortcut: <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +> + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="https://sourceforge.net/tracker/?group_id=11118&atid=460288" +TARGET="_top" +>https://sourceforge.net/tracker/?group_id=11118&atid=460288</A +>, to submit <SPAN +CLASS="QUOTE" +>"misses"</SPAN +> and other + configuration related suggestions to the developers. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + + + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.junkbusters.com/ht/en/cookies.html" +TARGET="_top" +>http://www.junkbusters.com/ht/en/cookies.html</A +>, + an explanation how cookies are used to track web users. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +>http://www.junkbusters.com/ijb.html</A +>, + the original Internet Junkbuster. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.squid-cache.org/" +TARGET="_top" +>http://www.squid-cache.org/</A +>, a popular + caching proxy, which is often used together with <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.pps.jussieu.fr/~jch/software/polipo/" +TARGET="_top" +>http://www.pps.jussieu.fr/~jch/software/polipo/</A +>, + <SPAN +CLASS="APPLICATION" +>Polipo</SPAN +> is a caching proxy with advanced features + like pipelining, multiplexing and caching of partial instances. In many setups + it can be used as <SPAN +CLASS="APPLICATION" +>Squid</SPAN +> replacement. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="https://www.torproject.org/" +TARGET="_top" +>https://www.torproject.org/</A +>, + <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> can help anonymize web browsing, + web publishing, instant messaging, IRC, SSH, and other applications. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="copyright.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +> </TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Privoxy Copyright, License and History</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +> </TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/developer-manual/testing.html b/external/privoxy/doc/webserver/developer-manual/testing.html index 9f8abf6..80d3f29 100644 --- a/external/privoxy/doc/webserver/developer-manual/testing.html +++ b/external/privoxy/doc/webserver/developer-manual/testing.html @@ -1,169 +1,259 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Testing Guidelines</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Developer Manual" href="index.html"> - <link rel="PREVIOUS" title="Coding Guidelines" href="coding.html"> - <link rel="NEXT" title="Releasing a New Version" href="newrelease.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Developer Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="coding.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "newrelease.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="TESTING" id="TESTING">5. Testing - Guidelines</a></h1> - - <p>To be filled.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="TESTING-PLAN" id="TESTING-PLAN">5.1. - Testplan for releases</a></h2> - - <p>Explain release numbers. major, minor. developer releases. etc.</p> - - <ol type="1"> - <li> - <p>Remove any existing rpm with rpm -e</p> - </li> - - <li> - <p>Remove any file that was left over. This includes (but is not - limited to)</p> - - <ul> - <li> - <p>/var/log/privoxy</p> - </li> - - <li> - <p>/etc/privoxy</p> - </li> - - <li> - <p>/usr/sbin/privoxy</p> - </li> - - <li> - <p>/etc/init.d/privoxy</p> - </li> - - <li> - <p>/usr/doc/privoxy*</p> - </li> - </ul> - </li> - - <li> - <p>Install the rpm. Any error messages?</p> - </li> - - <li> - <p>start,stop,status <span class="APPLICATION">Privoxy</span> with - the specific script (e.g. /etc/rc.d/init/privoxy stop). Reboot your - machine. Does autostart work?</p> - </li> - - <li> - <p>Start browsing. Does <span class="APPLICATION">Privoxy</span> - work? Logfile written?</p> - </li> - - <li> - <p>Remove the rpm. Any error messages? All files removed?</p> - </li> - </ol> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="TESTING-REPORT" id="TESTING-REPORT">5.2. - Test reports</a></h2> - - <p>Please submit test reports only with the <a href= - "http://sourceforge.net/tracker/?func=add&group_id=11118&atid=395005" - target="_top">test form</a> at sourceforge. Three simple steps:</p> - - <ul> - <li> - <p>Select category: the distribution you test on.</p> - </li> - - <li> - <p>Select group: the version of <span class= - "APPLICATION">Privoxy</span> that we are about to release.</p> - </li> - - <li> - <p>Fill the Summary and Detailed Description with something - intelligent (keep it short and precise).</p> - </li> - </ul>Do not mail to the mailing list (we cannot keep track on issues - there). - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="coding.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="newrelease.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Coding Guidelines</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Releasing a New - Version</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Testing Guidelines</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Coding Guidelines" +HREF="coding.html"><LINK +REL="NEXT" +TITLE="Releasing a New Version" +HREF="newrelease.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Developer Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="coding.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="newrelease.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="TESTING" +>5. Testing Guidelines</A +></H1 +><P +>To be filled.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="TESTING-PLAN" +>5.1. Testplan for releases</A +></H2 +><P +> Explain release numbers. major, minor. developer releases. etc. + +<P +></P +><OL +TYPE="1" +><LI +><P +>Remove any existing rpm with rpm -e</P +></LI +><LI +><P +>Remove any file that was left over. This includes (but is not limited to) + <P +></P +><UL +><LI +><P +>/var/log/privoxy</P +></LI +><LI +><P +>/etc/privoxy</P +></LI +><LI +><P +>/usr/sbin/privoxy</P +></LI +><LI +><P +>/etc/init.d/privoxy</P +></LI +><LI +><P +>/usr/doc/privoxy*</P +></LI +></UL +></P +></LI +><LI +><P +>Install the rpm. Any error messages?</P +></LI +><LI +><P +>start,stop,status <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with the specific script + (e.g. /etc/rc.d/init/privoxy stop). Reboot your machine. Does + autostart work?</P +></LI +><LI +><P +>Start browsing. Does <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> work? Logfile written?</P +></LI +><LI +><P +>Remove the rpm. Any error messages? All files removed?</P +></LI +></OL +></P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="TESTING-REPORT" +>5.2. Test reports</A +></H2 +><P +>Please submit test reports only with the <A +HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=395005" +TARGET="_top" +>test form</A +> +at sourceforge. Three simple steps: + <P +></P +><UL +><LI +><P +>Select category: the distribution you test on.</P +></LI +><LI +><P +>Select group: the version of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> that we are about to release.</P +></LI +><LI +><P +>Fill the Summary and Detailed Description with something + intelligent (keep it short and precise).</P +></LI +></UL +> + Do not mail to the mailing list (we cannot keep track on issues there). + </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="coding.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="newrelease.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Coding Guidelines</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Releasing a New Version</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/developer-manual/webserver-update.html b/external/privoxy/doc/webserver/developer-manual/webserver-update.html index 76b6690..b54d646 100644 --- a/external/privoxy/doc/webserver/developer-manual/webserver-update.html +++ b/external/privoxy/doc/webserver/developer-manual/webserver-update.html @@ -1,147 +1,260 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Update the Webserver</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Developer Manual" href="index.html"> - <link rel="PREVIOUS" title="Releasing a New Version" href= - "newrelease.html"> - <link rel="NEXT" title= - "Contacting the developers, Bug Reporting and Feature Requests" href= - "contact.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - span.c3 {font-style: italic} - table.c2 {background-color: #E0E0E0} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Developer Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "newrelease.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="contact.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="WEBSERVER-UPDATE" id="WEBSERVER-UPDATE">7. - Update the Webserver</a></h1> - - <p>The webserver should be updated at least with each stable release. - When updating, please follow these steps to make sure that no broken - links, inconsistent contents or permission problems will occur (as it has - many times in the past!):</p> - - <p>If you have changed anything in the stable-branch documentation source - SGML files, do:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - make dok dok-pdf # (or 'make redhat-dok dok-pdf' if 'make dok' doesn't work for you) -</pre> - </td> - </tr> - </table> - - <p>That will generate <tt class= - "FILENAME">doc/webserver/user-manual</tt>, <tt class= - "FILENAME">doc/webserver/developer-manual</tt>, <tt class= - "FILENAME">doc/webserver/faq</tt>, <tt class= - "FILENAME">doc/pdf/*.pdf</tt> and <tt class= - "FILENAME">doc/webserver/index.html</tt> automatically.</p> - - <p>If you changed the manual page sources, generate <tt class= - "FILENAME">doc/webserver/man-page/privoxy-man-page.html</tt> by running - <span class="QUOTE">"<b class="COMMAND">make man</b>"</span>. (This is a - separate target due to dependencies on some obscure perl scripts [now in - CVS, but not well tested]. See comments in <tt class= - "FILENAME">GNUmakefile</tt>.)</p> - - <p>If you want to add new files to the webserver, create them locally in - the <tt class="FILENAME">doc/webserver/*</tt> directory (or create new - directories under <tt class="FILENAME">doc/webserver</tt>).</p> - - <p>Next, commit any changes from the above steps to CVS. All set? If - these are docs in the stable branch, then do:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - make webserver -</pre> - </td> - </tr> - </table> - - <p>This will do the upload to <a href="http://www.privoxy.org/" target= - "_top">the webserver</a> (www.privoxy.org) and ensure all files and - directories there are group writable.</p> - - <p>Please do <span class="emphasis EMPHASIS c3">NOT</span> use any other - means of transferring files to the webserver to avoid permission - problems. Also, please do not upload docs from development branches or - versions. The publicly posted docs should be in sync with the last - official release.</p> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="newrelease.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="contact.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Releasing a New - Version</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Contacting the developers, - Bug Reporting and Feature Requests</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Update the Webserver</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Developer Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Releasing a New Version" +HREF="newrelease.html"><LINK +REL="NEXT" +TITLE="Contacting the developers, Bug Reporting and Feature Requests" +HREF="contact.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Developer Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="newrelease.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="contact.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="WEBSERVER-UPDATE" +>7. Update the Webserver</A +></H1 +><P +> The webserver should be updated at least with each stable release. When + updating, please follow these steps to make sure that no broken links, + inconsistent contents or permission problems will occur (as it has many + times in the past!): + </P +><P +> If you have changed anything in the stable-branch documentation source + SGML files, do: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> make dok dok-pdf # (or 'make redhat-dok dok-pdf' if 'make dok' doesn't work for you)</PRE +></TD +></TR +></TABLE +> + </P +><P +> That will generate <TT +CLASS="FILENAME" +>doc/webserver/user-manual</TT +>, + <TT +CLASS="FILENAME" +>doc/webserver/developer-manual</TT +>, + <TT +CLASS="FILENAME" +>doc/webserver/faq</TT +>, + <TT +CLASS="FILENAME" +>doc/pdf/*.pdf</TT +> and + <TT +CLASS="FILENAME" +>doc/webserver/index.html</TT +> automatically. + </P +><P +> If you changed the manual page sources, generate + <TT +CLASS="FILENAME" +>doc/webserver/man-page/privoxy-man-page.html</TT +> + by running <SPAN +CLASS="QUOTE" +>"<B +CLASS="COMMAND" +>make man</B +>"</SPAN +>. (This is + a separate target due to dependencies on some obscure perl scripts + [now in CVS, but not well tested]. See comments in <TT +CLASS="FILENAME" +>GNUmakefile</TT +>.) + </P +><P +> If you want to add new files to the webserver, create them locally in + the <TT +CLASS="FILENAME" +>doc/webserver/*</TT +> directory (or + create new directories under <TT +CLASS="FILENAME" +>doc/webserver</TT +>). + </P +><P +> Next, commit any changes from the above steps to CVS. All set? + If these are docs in the stable branch, then do: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> make webserver</PRE +></TD +></TR +></TABLE +> + </P +><P +> This will do the upload to <A +HREF="http://www.privoxy.org/" +TARGET="_top" +>the + webserver</A +> (www.privoxy.org) and ensure all files and directories + there are group writable. + </P +><P +> Please do <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>NOT</I +></SPAN +> use any other means of transferring + files to the webserver to avoid permission problems. Also, please do not + upload docs from development branches or versions. The publicly posted + docs should be in sync with the last official release. + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="newrelease.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="contact.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Releasing a New Version</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Contacting the developers, Bug Reporting and Feature Requests</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/faq/configuration.html b/external/privoxy/doc/webserver/faq/configuration.html index 892e46b..01c001b 100644 --- a/external/privoxy/doc/webserver/faq/configuration.html +++ b/external/privoxy/doc/webserver/faq/configuration.html @@ -1,900 +1,1797 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Configuration</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Frequently Asked Questions" href= - "index.html"> - <link rel="PREVIOUS" title="Installation" href="installation.html"> - <link rel="NEXT" title="Miscellaneous" href="misc.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - a.c4 {font-style: italic} - span.c3 {font-style: italic} - table.c2 {background-color: #E0E0E0} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Frequently Asked - Questions</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "installation.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="misc.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="CONFIGURATION" id="CONFIGURATION">3. - Configuration</a></h1> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN369" id="AEN369">3.1. What exactly is an - <span class="QUOTE">"actions"</span> file?</a></h3> - - <p><span class="APPLICATION">Privoxy</span> utilizes the concept of - <span class="QUOTE">" <a href= - "../user-manual/actions-file.html#ACTIONS" target= - "_top">actions</a>"</span> that are used to manipulate and control web - page data. <a href="../user-manual/actions-file.html" target= - "_top">Actions files</a> are where these <a href= - "../user-manual/actions-file.html#ACTIONS" target="_top">actions</a> - that <span class="APPLICATION">Privoxy</span> could take while - processing a certain request, are configured. Typically, you would - define a set of default actions that apply globally to all URLs, then - add exceptions to these defaults where needed. There is a wide array of - actions available that give the user a high degree of control and - flexibility on how to process each and every web page.</p> - - <p>Actions can be defined on a <a href= - "../user-manual/actions-file.html#AF-PATTERNS" target="_top">URL - pattern</a> basis, i.e. for single URLs, whole web sites, groups or - parts thereof etc. Actions can also be grouped together and then - applied to requests matching one or more patterns. There are many - possible actions that might apply to any given site. As an example, if - you are blocking <a href="http://en.wikipedia.org/wiki/Browser_cookie" - target="_top">cookies</a> as one of your default actions, but need to - accept cookies from a given site, you would need to define an exception - for this site in one of your actions files, preferably in <tt class= - "FILENAME">user.action</tt>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="ACTIONSS" id="ACTIONSS">3.2. The - <span class="QUOTE">"actions"</span> concept confuses me. Please list - some of these <span class="QUOTE">"actions"</span>.</a></h3> - - <p>For a comprehensive discussion of the actions concept, please refer - to the <a href="../user-manual/actions-file.html" target="_top">actions - file chapter</a> in the <a href="../user-manual/index.html" target= - "_top">User Manual</a>. It includes a <a href= - "../user-manual/actions-file.html#ACTIONS" target="_top">list of all - actions</a> and an <a href= - "../user-manual/actions-file.html#ACT-EXAMPLES" target="_top">actions - file tutorial</a> to get you started.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN392" id="AEN392">3.3. How are actions - files configured? What is the easiest way to do this?</a></h3> - - <p>Actions files are just text files in a special syntax and can be - edited with a text editor. But probably the easiest way is to access - <span class="APPLICATION">Privoxy</span>'s user interface with your web - browser at <a href="http://config.privoxy.org/" target= - "_top">http://config.privoxy.org/</a> (Shortcut: <a href="http://p.p/" - target="_top">http://p.p/</a>) and then select <span class= - "QUOTE">"<a href="http://config.privoxy.org/show-status" target= - "_top">View & change the current configuration</a>"</span> from the - menu. Note that this feature must be explicitly enabled in the main - config file (see <a href= - "../user-manual/config.html#ENABLE-EDIT-ACTIONS" target= - "_top">enable-edit-actions</a>).</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN401" id="AEN401">3.4. There are several - different <span class="QUOTE">"actions"</span> files. What are the - differences?</a></h3> - - <p>Please have a look at the <a href="../user-manual/actions-file.html" - target="_top">the actions chapter</a> in the <a href= - "../user-manual/index.html" target="_top">User Manual</a> for a - detailed explanation.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="GETUPDATES" id="GETUPDATES">3.5. Where can I - get updated Actions Files?</a></h3> - - <p>Based on your feedback and the continuing development, updates of - <tt class="FILENAME">default.action</tt> will be made available from - time to time on the <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118" target= - "_top">files section</a> of our <a href= - "http://sf.net/projects/ijbswa/" target="_top">project page</a>.</p> - - <p>If you wish to receive an email notification whenever we release - updates of <span class="APPLICATION">Privoxy</span> or the actions - file, <a href= - "http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/" target= - "_top">subscribe to our announce mailing list</a>, - ijbswa-announce@lists.sourceforge.net.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="NEWCONFIG" id="NEWCONFIG">3.6. Can I use my - old config files?</a></h3> - - <p>The syntax and purpose of configuration files has remained roughly - the same throughout the 3.x series, but backwards compatibility is not - guaranteed. Also each release contains updated, <span class= - "QUOTE">"improved"</span> versions and it is therefore strongly - recommended to install the newer configuration files and merge back - your modifications.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="DIFFICULT" id="DIFFICULT">3.7. Why is the - configuration so complicated?</a></h3> - - <p><span class="QUOTE">"Complicated"</span> is in the eye of the - beholder. Those that are familiar with some of the underlying concepts, - such as regular expression syntax, take to it like a fish takes to - water. Also, software that tries hard to be <span class="QUOTE">"user - friendly"</span>, often lacks sophistication and flexibility. There is - always that trade-off there between power vs. easy-of-use. Furthermore, - anyone is welcome to contribute ideas and implementations to enhance - <span class="APPLICATION">Privoxy</span>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="YAHOO" id="YAHOO">3.8. How can I make my - Yahoo/Hotmail/Gmail account work?</a></h3> - - <p>The default configuration shouldn't impact the usability of any of - these services. It may, however, make all <a href= - "http://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookies</a> - temporary, so that your browser will forget your login credentials in - between browser sessions. If you would like not to have to log in - manually each time you access those websites, simply turn off all - cookie handling for them in the <tt class="FILENAME">user.action</tt> - file. An example for yahoo might look like:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# Allow all cookies for Yahoo login: +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Configuration</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Frequently Asked Questions" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Installation" +HREF="installation.html"><LINK +REL="NEXT" +TITLE="Miscellaneous" +HREF="misc.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Frequently Asked Questions</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="installation.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="misc.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="CONFIGURATION" +>3. Configuration</A +></H1 +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN354" +>3.1. What exactly is an <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> file?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> utilizes the concept of <SPAN +CLASS="QUOTE" +>" <A +HREF="../user-manual/actions-file.html#ACTIONS" +TARGET="_top" +>actions</A +>"</SPAN +> + that are used to manipulate and control web page data. + <A +HREF="../user-manual/actions-file.html" +TARGET="_top" +>Actions files</A +> + are where these <A +HREF="../user-manual/actions-file.html#ACTIONS" +TARGET="_top" +>actions</A +> + that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> could take while processing a certain + request, are configured. Typically, you would define a set of default actions + that apply globally to all URLs, then add exceptions to these defaults where needed. + There is a wide array of actions available that give the user a high degree + of control and flexibility on how to process each and every web page.</P +><P +> Actions can be defined on a <A +HREF="../user-manual/actions-file.html#AF-PATTERNS" +TARGET="_top" +>URL pattern</A +> basis, i.e. + for single URLs, whole web sites, groups or parts thereof etc. Actions can also be + grouped together and then applied to requests matching one or more patterns. + There are many possible actions that might apply to any given site. As an example, + if you are blocking <A +HREF="http://en.wikipedia.org/wiki/Browser_cookie" +TARGET="_top" +>cookies</A +> + as one of your default actions, but need to accept cookies from a given site, + you would need to define an exception for this site in one of your actions + files, preferably in <TT +CLASS="FILENAME" +>user.action</TT +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="ACTIONSS" +>3.2. The <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> concept confuses me. Please list +some of these <SPAN +CLASS="QUOTE" +>"actions"</SPAN +>.</A +></H3 +><P +> For a comprehensive discussion of the actions concept, please refer + to the <A +HREF="../user-manual/actions-file.html" +TARGET="_top" +>actions file + chapter</A +> in the <A +HREF="../user-manual/index.html" +TARGET="_top" +>User + Manual</A +>. It includes a <A +HREF="../user-manual/actions-file.html#ACTIONS" +TARGET="_top" +>list of all actions</A +> + and an <A +HREF="../user-manual/actions-file.html#ACT-EXAMPLES" +TARGET="_top" +>actions + file tutorial</A +> to get you started.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN377" +>3.3. How are actions files configured? What is the easiest +way to do this?</A +></H3 +><P +> Actions files are just text files in a special syntax and can be edited + with a text editor. But probably the easiest way is to access + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s user interface with your web browser + at <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>http://config.privoxy.org/</A +> + (Shortcut: <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +>) and then select + <SPAN +CLASS="QUOTE" +>"<A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>View & + change the current configuration</A +>"</SPAN +> from the menu. Note + that this feature must be explicitly enabled in the main config file + (see <A +HREF="../user-manual/config.html#ENABLE-EDIT-ACTIONS" +TARGET="_top" +>enable-edit-actions</A +>).</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN386" +>3.4. There are several different <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> files. What are +the differences?</A +></H3 +><P +> Three actions files + are being included by the developers, to be used for + different purposes: These are + <TT +CLASS="FILENAME" +>default.action</TT +>, the <SPAN +CLASS="QUOTE" +>"main"</SPAN +> actions file + which is actively maintained by the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + developers and typically sets the default policies, <TT +CLASS="FILENAME" +>user.action</TT +>, + where users are encouraged to make their private customizations. + Please see <A +HREF="../user-manual/actions-file.html" +TARGET="_top" +>the actions chapter</A +> + in the <A +HREF="../user-manual/index.html" +TARGET="_top" +>User Manual</A +> for a more + detailed explanation.</P +><P +> Earlier versions included three different versions of the + <TT +CLASS="FILENAME" +>default.action</TT +> file. The new scheme allows for + greater flexibility of local configuration, and for browser based + selection of pre-defined <SPAN +CLASS="QUOTE" +>"aggressiveness"</SPAN +> levels.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="GETUPDATES" +>3.5. Where can I get updated Actions Files?</A +></H3 +><P +> Based on your feedback and the continuing development, updates of + <TT +CLASS="FILENAME" +>default.action</TT +> will be + made available from time to time on the <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>files section</A +> of + our <A +HREF="http://sf.net/projects/ijbswa/" +TARGET="_top" +>project page</A +>. + </P +><P +> If you wish to receive an email notification whenever we release updates of + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> or the actions file, <A +HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/" +TARGET="_top" +>subscribe + to our announce mailing list</A +>, ijbswa-announce@lists.sourceforge.net. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="NEWCONFIG" +>3.6. Can I use my old config files?</A +></H3 +><P +> The syntax and purpose of configuration files has remained roughly the + same throughout the 3.x series, but backwards compatibility is not guaranteed. + Also each release contains updated, <SPAN +CLASS="QUOTE" +>"improved"</SPAN +> versions and it is + therefore strongly recommended to install the newer configuration files + and merge back your modifications. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="DIFFICULT" +>3.7. Why is the configuration so complicated?</A +></H3 +><P +> <SPAN +CLASS="QUOTE" +>"Complicated"</SPAN +> is in the eye of the beholder. Those that are + familiar with some of the underlying concepts, such as regular expression + syntax, take to it like a fish takes to water. Also, software that tries + hard to be <SPAN +CLASS="QUOTE" +>"user friendly"</SPAN +>, often lacks sophistication and + flexibility. There is always that trade-off there between power vs. + easy-of-use. Furthermore, anyone is welcome to contribute ideas and + implementations to enhance <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="YAHOO" +>3.8. How can I make my Yahoo/Hotmail/Gmail account work?</A +></H3 +><P +> The default configuration shouldn't impact the usability of any of these services. + It may, however, make all <A +HREF="http://en.wikipedia.org/wiki/Browser_cookie" +TARGET="_top" +>cookies</A +> + temporary, so that your browser will forget your + login credentials in between browser sessions. If you would like not to have to log + in manually each time you access those websites, simply turn off all cookie handling + for them in the <TT +CLASS="FILENAME" +>user.action</TT +> file. An example for yahoo might + look like: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Allow all cookies for Yahoo login: # -{ -<a href="../user-manual/actions-file.html#CRUNCH-INCOMING-COOKIES" target= -"_top">crunch-incoming-cookies</a> -<a href= -"../user-manual/actions-file.html#CRUNCH-OUTGOING-COOKIES" target= -"_top">crunch-outgoing-cookies</a> -<a href= -"../user-manual/actions-file.html#SESSION-COOKIES-ONLY" target= -"_top">session-cookies-only</a> } -.login.yahoo.com -</pre> - </td> - </tr> - </table> - - <p>These kinds of sites are often quite complex and heavy with <a href= - "http://en.wikipedia.org/wiki/Javascript" target="_top">Javascript</a> - and thus <span class="QUOTE">"fragile"</span>. So if <span class= - "emphasis EMPHASIS c3">still</span> a problem, we have an <a href= - "../user-manual/actions-file.html#ALIASES" target="_top">alias</a> just - for such sticky situations:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# Gmail is a _fragile_ site: +{ -<A +HREF="../user-manual/actions-file.html#CRUNCH-INCOMING-COOKIES" +TARGET="_top" +>crunch-incoming-cookies</A +> -<A +HREF="../user-manual/actions-file.html#CRUNCH-OUTGOING-COOKIES" +TARGET="_top" +>crunch-outgoing-cookies</A +> -<A +HREF="../user-manual/actions-file.html#SESSION-COOKIES-ONLY" +TARGET="_top" +>session-cookies-only</A +> } +.login.yahoo.com</PRE +></TD +></TR +></TABLE +> + </P +><P +> These kinds of sites are often quite complex and heavy with + <A +HREF="http://en.wikipedia.org/wiki/Javascript" +TARGET="_top" +>Javascript</A +> and + thus <SPAN +CLASS="QUOTE" +>"fragile"</SPAN +>. So if <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>still</I +></SPAN +> a problem, + we have an <A +HREF="../user-manual/actions-file.html#ALIASES" +TARGET="_top" +>alias</A +> just for such + sticky situations: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Gmail is a _fragile_ site: # -{ <tt class="LITERAL">fragile</tt> } +{ <TT +CLASS="LITERAL" +>fragile</TT +> } # Gmail is ... - mail.google.com -</pre> - </td> - </tr> - </table> - - <p>Be sure to flush your browser's caches whenever making these kinds - of changes, just to make sure the changes <span class= - "QUOTE">"take"</span>.</p> - - <p>Make sure the domain, host and path are appropriate as well. Your - browser can tell you where you are specifically and you should use that - information for your configuration settings. Note that above it is not - referenced as <tt class="LITERAL">gmail.com</tt>, which is a valid - domain name.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="CONFIGFILES" id="CONFIGFILES">3.9. What's - the difference between the <span class="QUOTE">"Cautious"</span>, - <span class="QUOTE">"Medium"</span> and <span class= - "QUOTE">"Advanced"</span> defaults?</a></h3> - - <p>Configuring <span class="APPLICATION">Privoxy</span> is not entirely - trivial. To help you get started, we provide you with three different - default action <span class="QUOTE">"profiles"</span> in the web based - actions file editor at <a href="http://config.privoxy.org/show-status" - target="_top">http://config.privoxy.org/show-status</a>. See the - <a class="CITETITLE c4" href="../user-manual/actions-file.html" target= - "_top">User Manual</a> for a list of actions, and how the default - profiles are set.</p> - - <p>Where the defaults are likely to break some sites, exceptions for - known popular <span class="QUOTE">"problem"</span> sites are included, - but in general, the more aggressive your default settings are, the more - exceptions you will have to make later. New users are best to start off - in <span class="QUOTE">"Cautious"</span> setting. This is safest and - will have the fewest problems. See the <a class="CITETITLE c4" href= - "../user-manual/index.html" target="_top">User Manual</a> for a more - detailed discussion.</p> - - <p>It should be noted that the <span class="QUOTE">"Advanced"</span> - profile (formerly known as the <span class= - "QUOTE">"Adventuresome"</span> profile) is more aggressive, and will - make use of some of <span class="APPLICATION">Privoxy's</span> advanced - features. Use at your own risk!</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="BROWSECONFIG" id="BROWSECONFIG">3.10. Why - can I change the configuration with a browser? Does that not raise - security issues?</a></h3> - - <p>It may seem strange that regular users can edit the config files - with their browsers, although the whole <tt class= - "FILENAME">/etc/privoxy</tt> hierarchy belongs to the user <span class= - "QUOTE">"privoxy"</span>, with only 644 permissions.</p> - - <p>When you use the browser-based editor, <span class= - "APPLICATION">Privoxy</span> itself is writing to the config files. - Because <span class="APPLICATION">Privoxy</span> is running as the user - <span class="QUOTE">"privoxy"</span>, it can update its own config - files.</p> - - <p>If you run <span class="APPLICATION">Privoxy</span> for multiple - untrusted users (e.g. in a LAN) or aren't entirely in control of your - own browser, you will probably want to make sure that the web-based - editor and remote toggle features are <span class="QUOTE">"off"</span> - by setting <span class="QUOTE">"<tt class="LITERAL"><a href= - "../user-manual/config.html#ENABLE-EDIT-ACTIONS" target= - "_top">enable-edit-actions</a> 0</tt>"</span> and <span class= - "QUOTE">"<tt class="LITERAL"><a href= - "../user-manual/config.html#ENABLE-REMOTE-TOGGLE" target= - "_top">enable-remote-toggle</a> 0</tt>"</span> in the <a href= - "../user-manual/config.html" target="_top">main configuration - file</a>.</p> - - <p>As of <span class="APPLICATION">Privoxy</span> 3.0.7 these options - are disabled by default.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN489" id="AEN489">3.11. What is the - <tt class="FILENAME">default.filter</tt> file? What is a <span class= - "QUOTE">"filter"</span>?</a></h3> - - <p>The <a href="../user-manual/filter-file.html" target= - "_top"><tt class="FILENAME">default.filter</tt></a> file is where - <span class="emphasis EMPHASIS c3">filters</span> as supplied by the - developers are defined. Filters are a special subset of actions that - can be used to modify or remove web page content or headers on the fly. - Content filters can be applied to <span class= - "emphasis EMPHASIS c3">anything</span> in the page source, header - filters can be applied to either server or client headers. Regular - expressions are used to accomplish this.</p> - - <p>There are a number of pre-defined filters to deal with common - annoyances. The filters are only defined here, to invoke them, you need - to use the <a href="../user-manual/actions-file.html#FILTER" target= - "_top"><tt class="LITERAL">filter</tt> action</a> in one of the actions - files. Content filtering is automatically disabled for inappropriate - MIME types, but if you know better than Privoxy what should or should - not be filtered you can filter any content you like.</p> - - <p>Filters should <span class="emphasis EMPHASIS c3">not</span> be - confused with <a href="../user-manual/actions-file.html#BLOCK" target= - "_top"><tt class="LITERAL">blocks</tt></a>, which is a completely - different action, and is more typically used to block ads and unwanted - sites.</p> - - <p>If you are familiar with regular expressions, and HTML, you can look - at the provided <tt class="FILENAME">default.filter</tt> with a text - editor and define your own filters. This is potentially a very powerful - feature, but requires some expertise in both regular expressions and - HTML/HTTP. You should place any modifications to the default filters, - or any new ones you create in a separate file, such as <tt class= - "FILENAME">user.filter</tt>, so they won't be overwritten during - upgrades. The ability to define multiple filter files in <tt class= - "FILENAME">config</tt> is a new feature as of v. 3.0.5.</p> - - <p>There is no GUI editor option for this part of the configuration, - but you can disable/enable the various pre-defined filters of the - included <tt class="FILENAME">default.filter</tt> file with the - <a href="http://config.privoxy.org/show-status" target="_top">web-based - actions file editor</a>. Note that the custom actions editor must be - explicitly enabled in the main config file (see <a href= - "../user-manual/config.html#ENABLE-EDIT-ACTIONS" target= - "_top">enable-edit-actions</a>).</p> - - <p>If you intend to develop your own filters, you might want to have a - look at <a href="http://www.fabiankeil.de/sourcecode/pft/" target= - "_top">Privoxy-Filter-Test</a>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="LANCONFIG" id="LANCONFIG">3.12. How can I - set up Privoxy to act as a proxy for my LAN?</a></h3> - - <p>By default, <span class="APPLICATION">Privoxy</span> only responds - to requests from <tt class="LITERAL">127.0.0.1</tt> (localhost). To - have it act as a server for a network, this needs to be changed in the - <a href="../user-manual/config.html" target="_top">main configuration - file</a>. Look for the <tt class="LITERAL"><a href= - "../user-manual/config.html#LISTEN-ADDRESS" target= - "_top">listen-address</a></tt> option, which may be commented out with - a <span class="QUOTE">"#"</span> symbol. Make sure it is uncommented, - and assign it the address of the LAN gateway interface, and port number - to use. Assuming your LAN address is 192.168.1.1 and you wish to run - <span class="APPLICATION">Privoxy</span> on port 8118, this line should - look like:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - listen-address 192.168.1.1:8118 -</pre> - </td> - </tr> - </table> - - <p>Save the file, and restart <span class="APPLICATION">Privoxy</span>. - Configure all browsers on the network then to use this address and port - number.</p> - - <p>Alternately, you can have <span class="APPLICATION">Privoxy</span> - listen on all available interfaces:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - listen-address :8118 -</pre> - </td> - </tr> - </table> - - <p>And then use <span class="APPLICATION">Privoxy's</span> <a href= - "../user-manual/config.html#PERMIT-ACCESS" target= - "_top">permit-access</a> feature to limit connections. A firewall in - this situation is recommended as well.</p> - - <p>The above steps should be the same for any TCP network, regardless - of operating system.</p> - - <p>If you run <span class="APPLICATION">Privoxy</span> on a LAN with - untrusted users, we recommend that you double-check the <a href= - "../user-manual/config.html#ACCESS-CONTROL" target="_top">access - control and security</a> options!</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN540" id="AEN540">3.13. Instead of ads, - now I get a checkerboard pattern. I don't want to see - anything.</a></h3> - - <p>The replacement for blocked images can be controlled with the - <a href="../user-manual/actions-file.html#SET-IMAGE-BLOCKER" target= - "_top"><tt class="LITERAL">set-image-blocker</tt> action</a>. You have - the choice of a checkerboard pattern, a transparent 1x1 GIF image (aka - <span class="QUOTE">"blank"</span>), or a redirect to a custom image of - your choice. Note that this choice only has effect for images which are - blocked as images, i.e. whose URLs match both a <tt class= - "LITERAL"><a href="../user-manual/actions-file.html#HANDLE-AS-IMAGE" - target="_top">handle-as-image</a></tt> <span class= - "emphasis EMPHASIS c3">and</span> <tt class="LITERAL"><a href= - "../user-manual/actions-file.html#BLOCK" target="_top">block</a></tt> - action.</p> - - <p>If you want to see nothing, then change the <a href= - "../user-manual/actions-file.html#SET-IMAGE-BLOCKER" target= - "_top"><tt class="LITERAL">set-image-blocker</tt> action</a> to - <span class="QUOTE">"blank"</span>. This can be done by editing the - <tt class="FILENAME">user.action</tt> file, or through the <a href= - "http://config.privoxy.org/show-status" target="_top">web-based actions - file editor</a>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN557" id="AEN557">3.14. Why would anybody - want to see a checkerboard pattern?</a></h3> - - <p>Remember that <a href="general.html#WHATSANAD">telling which image - is an ad and which isn't</a>, is an educated guess. While we hope that - the standard configuration is rather smart, it will make occasional - mistakes. The checkerboard image is visually decent, and it shows you - where images have been blocked, which can be very helpful in case some - navigation aid or otherwise innocent image was erroneously blocked. It - is recommended for new users so they can <span class= - "QUOTE">"see"</span> what is happening. Some people might also enjoy - seeing how many banners they <span class= - "emphasis EMPHASIS c3">don't</span> have to see.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN563" id="AEN563">3.15. I see some images - being replaced with text instead of the checkerboard image. Why and how - do I get rid of this?</a></h3> - - <p>This happens when the banners are not embedded in the HTML code of - the page itself, but in separate HTML (sub)documents that are loaded - into (i)frames or (i)layers, and these external HTML documents are - blocked. Being non-images they get replaced by a substitute HTML page - rather than a substitute image, which wouldn't work out technically, - since the browser expects and accepts only HTML when it has requested - an HTML document.</p> - - <p>The substitute page adapts to the available space and shows itself - as a miniature two-liner if loaded into small frames, or full-blown - with a large red "BLOCKED" banner if space allows.</p> - - <p>If you prefer the banners to be blocked by images, you must see to - it that the HTML documents in which they are embedded are not blocked. - Clicking the <span class="QUOTE">"See why"</span> link offered in the - substitute page will show you which rule blocked the page. After - changing the rule and un-blocking the HTML documents, the browser will - try to load the actual banner images and the usual image blocking will - (hopefully!) kick in.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="SRVANY" id="SRVANY">3.16. Can Privoxy run as - a service on Win2K/NT/XP?</a></h3> - - <p>Yes. Version 3.0.5 introduces full <span class= - "APPLICATION">Windows</span> service functionality. See <a href= - "../user-manual/installation.html#installation-pack-win" target= - "_top">the <i class="CITETITLE">User Manual</i></a> for details on how - to install and configure <span class="APPLICATION">Privoxy</span> as a - service.</p> - - <p>Earlier 3.x versions could run as a system service using <b class= - "COMMAND">srvany.exe</b>. See the discussion at <a href= - "http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&a..." - target= - "_top">http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&a...</a>, - for details, and a sample configuration.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="OTHERPROXY" id="OTHERPROXY">3.17. How can I - make Privoxy work with other proxies?</a></h3> - - <p>This can be done and is often useful to combine the benefits of - <span class="APPLICATION">Privoxy</span> with those of a another proxy, - for example to cache content. See the <a href= - "../user-manual/config.html#FORWARDING" target="_top">forwarding - chapter</a> in the <a href="../user-manual/index.html" target= - "_top">User Manual</a> which describes how to do this. If you intend to - use Privoxy with Tor, please also have a look at <a href= - "misc.html#TOR">How do I use Privoxy together with Tor</a>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="PORT-80" id="PORT-80">3.18. Can I just set - Privoxy to use port 80 and thus avoid individual browser - configuration?</a></h3> - - <p>No, its more complicated than that. This only works with special - kinds of proxies known as <span class="QUOTE">"intercepting"</span> - proxies (<a href="configuration.html#INTERCEPTING">see below</a>).</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="TRANSPARENT" id="TRANSPARENT">3.19. Can - Privoxy run as a <span class="QUOTE">"transparent"</span> - proxy?</a></h3> - - <p>The whole idea of Privoxy is to modify client requests and server - responses in all sorts of ways and therefore it's not a transparent - proxy as described in <a href="http://tools.ietf.org/html/rfc2616" - target="_top">RFC 2616</a>.</p> - - <p>However, some people say <span class="QUOTE">"transparent - proxy"</span> when they mean <span class="QUOTE">"intercepting - proxy"</span>. If you are one of them, please read the <a href= - "configuration.html#INTERCEPTING">next entry</a>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="INTERCEPTING" id="INTERCEPTING">3.20. Can - Privoxy run as a <span class="QUOTE">"intercepting"</span> - proxy?</a></h3> - - <p><span class="APPLICATION">Privoxy</span> can't intercept traffic - itself, but it can handle requests that where intercepted and - redirected with a packet filter (like <span class= - "APPLICATION">PF</span> or <span class="APPLICATION">iptables</span>), - as long as the <tt class="LITERAL">Host</tt> header is present.</p> - - <p>As the <tt class="LITERAL">Host</tt> header is required by HTTP/1.1 - and as most web sites rely on it anyway, this limitation shouldn't be a - problem.</p> - - <p>Please refer to your packet filter's documentation to learn how to - intercept and redirect traffic into <span class= - "APPLICATION">Privoxy</span>. Afterward you just have to configure - <span class="APPLICATION">Privoxy</span> to <a href= - "../user-manual/config.html#ACCEPT-INTERCEPTED-REQUESTS" target= - "_top">accept intercepted requests</a>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="OUTLOOK" id="OUTLOOK">3.21. How can I - configure Privoxy for use with Outlook?</a></h3> - - <p>Versions of <span class="APPLICATION">Outlook</span> prior to Office - 2007, use <span class="APPLICATION">Internet Explorer</span> components - to both render HTML, and fetch any HTTP requests that may be embedded - in an HTML email. So however you have <span class= - "APPLICATION">Privoxy</span> configured to work with IE, this - configuration should automatically be shared, at least with older - version of Internet Explorer.</p> - - <p>Starting with Office 2007, Microsoft is instead using the MS-Word - rendering engine with Outlook. It is unknown whether this can be - configured to use a proxy.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="OUTLOOK-MORE" id="OUTLOOK-MORE">3.22. How - can I have separate rules just for HTML mail?</a></h3> - - <p>The short answer is, you can't. <span class= - "APPLICATION">Privoxy</span> has no way of knowing which particular - application makes a request, so there is no way to distinguish between - web pages and HTML mail. <span class="APPLICATION">Privoxy</span> just - blindly proxies all requests. In the case of <span class= - "APPLICATION">Outlook Express</span> (see above), OE uses IE anyway, - and there is no way for <span class="APPLICATION">Privoxy</span> to - ever be able to distinguish between them (nor could any other proxy - type application for that matter).</p> - - <p>For a good discussion of some of the issues involved (including - privacy and security issues), see <a href= - "http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&a..." - target= - "_top">http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&a...</a>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="SNEAKY-COOKIES" id="SNEAKY-COOKIES">3.23. I - sometimes notice cookies sneaking through. How?</a></h3> - - <p><a href="http://en.wikipedia.org/wiki/Browser_cookie" target= - "_top">Cookies</a> can be set in several ways. The classic method is - via the <tt class="LITERAL">Set-Cookie</tt> HTTP header. This is - straightforward, and an easy one to manipulate, such as the - <span class="APPLICATION">Privoxy</span> concept of <a href= - "../user-manual/actions-file.html#SESSION-COOKIES-ONLY" target= - "_top">session-cookies-only</a>. There is also the possibility of using - <a href="http://en.wikipedia.org/wiki/Javascript" target= - "_top">Javascript</a> to set cookies (<span class= - "APPLICATION">Privoxy</span> calls these <tt class= - "LITERAL">content-cookies</tt>). This is trickier because the syntax - can vary widely, and thus requires a certain amount of guesswork. It is - not realistic to catch all of these short of disabling Javascript, - which would break many sites. And lastly, if the cookies are embedded - in a HTTPS/SSL secure session via Javascript, they are beyond - <span class="APPLICATION">Privoxy's</span> reach.</p> - - <p>All in all, <span class="APPLICATION">Privoxy</span> can help manage - cookies in general, can help minimize the loss of privacy posed by - cookies, but can't realistically stop all cookies.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="EVIL-COOKIES" id="EVIL-COOKIES">3.24. Are - all cookies bad? Why?</a></h3> - - <p>No, in fact there are many beneficial uses of <a href= - "http://en.wikipedia.org/wiki/Browser_cookie" target= - "_top">cookies</a>. Cookies are just a method that browsers can use to - store data between pages, or between browser sessions. Sometimes there - is a good reason for this, and the user's life is a bit easier as a - result. But there is a long history of some websites taking advantage - of this layer of trust, and using the data they glean from you and your - browsing habits for their own purposes, and maybe to your potential - detriment. Such sites are using you and storing their data on your - system. That is why the privacy conscious watch from whom those cookies - come, and why they really <span class= - "emphasis EMPHASIS c3">need</span> to be there.</p> - - <p>See the <a href="http://en.wikipedia.org/wiki/Browser_cookie" - target="_top">Wikipedia cookie definition</a> for more.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="ALLOW-COOKIES" id="ALLOW-COOKIES">3.25. How - can I allow permanent cookies for my trusted sites?</a></h3> - - <p>There are several actions that relate to cookies. The default - behavior is to allow only <span class="QUOTE">"session cookies"</span>, - which means the cookies only last for the current browser session. This - eliminates most kinds of abuse related to cookies. But there may be - cases where you want cookies to last.</p> - - <p>To disable all cookie actions, so that cookies are allowed - unrestricted, both in and out, for <tt class= - "LITERAL">example.com</tt>:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - { -crunch-incoming-cookies -crunch-outgoing-cookies -session-cookies-only -filter{content-cookies} } - .example.com -</pre> - </td> - </tr> - </table> - - <p>Place the above in <tt class="FILENAME">user.action</tt>. Note that - some of these may be off by default anyway, so this might be redundant, - but there is no harm being explicit in what you want to happen. - <tt class="FILENAME">user.action</tt> includes an alias for this - situation, called <tt class="LITERAL">allow-all-cookies</tt>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="MULTIPLES" id="MULTIPLES">3.26. Can I have - separate configurations for different users?</a></h3> - - <p>Each instance of <span class="APPLICATION">Privoxy</span> has its - own configuration, including such attributes as the TCP port that it - listens on. What you can do is run multiple instances of <span class= - "APPLICATION">Privoxy</span>, each with a unique <a href= - "../user-manual/config.html#LISTEN-ADDRESS" target= - "_top">listen-address</a> configuration setting, and configuration - path, and then each of these can have their own configurations. Think - of it as per-port configuration.</p> - - <p>Simple enough for a few users, but for large installations, consider - having groups of users that might share like configurations.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="WHITELISTS" id="WHITELISTS">3.27. Can I - set-up Privoxy as a whitelist of <span class="QUOTE">"good"</span> - sites?</a></h3> - - <p>Sure. There are a couple of things you can do for simple - white-listing. Here's one real easy one:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - ############################################################ + mail.google.com</PRE +></TD +></TR +></TABLE +> + </P +><P +> Be sure to flush your browser's caches whenever making these kinds of + changes, just to make sure the changes <SPAN +CLASS="QUOTE" +>"take"</SPAN +>. + </P +><P +> Make sure the domain, host and path are appropriate as well. Your browser can + tell you where you are specifically and you should use that information for + your configuration settings. Note that above it is not referenced as + <TT +CLASS="LITERAL" +>gmail.com</TT +>, which is a valid domain name. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="CONFIGFILES" +>3.9. What's the difference between the +<SPAN +CLASS="QUOTE" +>"Cautious"</SPAN +>, <SPAN +CLASS="QUOTE" +>"Medium"</SPAN +> and <SPAN +CLASS="QUOTE" +>"Advanced"</SPAN +> defaults?</A +></H3 +><P +> Configuring <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is not entirely trivial. To + help you get started, we provide you with three different default action + <SPAN +CLASS="QUOTE" +>"profiles"</SPAN +> in the web based actions file editor at <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +>. + See the <A +HREF="../user-manual/actions-file.html" +TARGET="_top" +><I +CLASS="CITETITLE" +>User + Manual</I +></A +> for a list of actions, and how the default + profiles are set. + </P +><P +> Where the defaults are likely to break some sites, exceptions for + known popular <SPAN +CLASS="QUOTE" +>"problem"</SPAN +> sites are included, but in + general, the more aggressive your default settings are, the more exceptions + you will have to make later. New users are best to start off in + <SPAN +CLASS="QUOTE" +>"Cautious"</SPAN +> setting. This is safest and will have the fewest + problems. See the <A +HREF="../user-manual/index.html" +TARGET="_top" +><I +CLASS="CITETITLE" +>User Manual</I +></A +> + for a more detailed discussion.</P +><P +> It should be noted that the <SPAN +CLASS="QUOTE" +>"Advanced"</SPAN +> profile (formerly known + as the <SPAN +CLASS="QUOTE" +>"Adventuresome"</SPAN +> profile) is more + aggressive, and will make use of some of + <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> advanced features. Use at your own risk!</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="BROWSECONFIG" +>3.10. Why can I change the configuration +with a browser? Does that not raise security issues?</A +></H3 +><P +> It may seem strange that regular users can edit the config files with their + browsers, although the whole <TT +CLASS="FILENAME" +>/etc/privoxy</TT +> hierarchy + belongs to the user <SPAN +CLASS="QUOTE" +>"privoxy"</SPAN +>, with only 644 permissions. + </P +><P +> When you use the browser-based editor, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + itself is writing to the config files. Because + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is running as the user <SPAN +CLASS="QUOTE" +>"privoxy"</SPAN +>, + it can update its own config files. + </P +><P +> If you run <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> for multiple untrusted users (e.g. in + a LAN) or aren't entirely in control of your own browser, you will probably want + to make sure that the the web-based editor and remote toggle features are + <SPAN +CLASS="QUOTE" +>"off"</SPAN +> by setting <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +><A +HREF="../user-manual/config.html#ENABLE-EDIT-ACTIONS" +TARGET="_top" +>enable-edit-actions</A +> + 0</TT +>"</SPAN +> and <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +><A +HREF="../user-manual/config.html#ENABLE-REMOTE-TOGGLE" +TARGET="_top" +>enable-remote-toggle</A +> + 0</TT +>"</SPAN +> in the <A +HREF="../user-manual/config.html" +TARGET="_top" +>main configuration file</A +>. + </P +><P +> As of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> 3.0.7 these options are disabled by default. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN481" +>3.11. What is the <TT +CLASS="FILENAME" +>default.filter</TT +> file? What is a <SPAN +CLASS="QUOTE" +>"filter"</SPAN +>?</A +></H3 +><P +> The <A +HREF="../user-manual/filter-file.html" +TARGET="_top" +><TT +CLASS="FILENAME" +>default.filter</TT +></A +> + file is where <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>filters</I +></SPAN +> as supplied by the developers are defined. + Filters are a special subset of actions that can be used to modify or + remove web page content or headers on the fly. Content filters can + be applied to <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>anything</I +></SPAN +> in the page source, + header filters can be applied to either server or client headers. + Regular expressions are used to accomplish this.</P +><P +> There are a number of pre-defined filters to deal with common annoyances. The + filters are only defined here, to invoke them, you need to use the + <A +HREF="../user-manual/actions-file.html#FILTER" +TARGET="_top" +><TT +CLASS="LITERAL" +>filter</TT +> + action</A +> in one of the actions files. Content filtering is automatically + disabled for inappropriate MIME types, but if you now better than Privoxy + what should or should not be filtered you can filter any content you like.</P +><P +> Filters should + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not</I +></SPAN +> be confused with <A +HREF="../user-manual/actions-file.html#BLOCK" +TARGET="_top" +><TT +CLASS="LITERAL" +>blocks</TT +></A +>, which + is a completely different action, and is more typically used to block ads and + unwanted sites.</P +><P +> If you are familiar with regular expressions, and HTML, you can look at + the provided <TT +CLASS="FILENAME" +>default.filter</TT +> with a text editor and define + your own filters. This is potentially a very powerful feature, but + requires some expertise in both regular expressions and HTML/HTTP. + You should + place any modifications to the default filters, or any new ones you create + in a separate file, such as <TT +CLASS="FILENAME" +>user.filter</TT +>, so they won't + be overwritten during upgrades. + The ability to define multiple filter files + in <TT +CLASS="FILENAME" +>config</TT +> is a new feature as of v. 3.0.5.</P +><P +> There is no GUI editor option for this part of the configuration, + but you can disable/enable the various pre-defined filters of the included + <TT +CLASS="FILENAME" +>default.filter</TT +> file with the <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>web-based actions file editor</A +>. + Note that the custom actions editor must be explicitly enabled in + the main config file (see <A +HREF="../user-manual/config.html#ENABLE-EDIT-ACTIONS" +TARGET="_top" +>enable-edit-actions</A +>).</P +><P +> If you intend to develop your own filters, you might want to have a look at + <A +HREF="http://www.fabiankeil.de/sourcecode/pft/" +TARGET="_top" +>Privoxy-Filter-Test</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="LANCONFIG" +>3.12. How can I set up Privoxy to act as a proxy for my + LAN?</A +></H3 +><P +> By default, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> only responds to requests + from <TT +CLASS="LITERAL" +>127.0.0.1</TT +> (localhost). To have it act as a server for + a network, this needs to be changed in the <A +HREF="../user-manual/config.html" +TARGET="_top" +>main configuration file</A +>. Look for + the <TT +CLASS="LITERAL" +><A +HREF="../user-manual/config.html#LISTEN-ADDRESS" +TARGET="_top" +>listen-address</A +></TT +> + option, which may be commented out with a <SPAN +CLASS="QUOTE" +>"#"</SPAN +> symbol. Make sure + it is uncommented, and assign it the address of the LAN gateway interface, + and port number to use. Assuming your LAN address is 192.168.1.1 and you + wish to run <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on port 8118, this line + should look like:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> listen-address 192.168.1.1:8118</PRE +></TD +></TR +></TABLE +></P +><P +> Save the file, and restart <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. Configure + all browsers on the network then to use this address and port number.</P +><P +> Alternately, you can have <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> listen on + all available interfaces:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> listen-address :8118</PRE +></TD +></TR +></TABLE +></P +><P +> And then use <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + <A +HREF="../user-manual/config.html#PERMIT-ACCESS" +TARGET="_top" +>permit-access</A +> + feature to limit connections. A firewall in this situation is recommended + as well.</P +><P +> The above steps should be the same for any TCP network, regardless of + operating system.</P +><P +> If you run <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on a LAN with untrusted users, + we recommend that you double-check the <A +HREF="../user-manual/config.html#ACCESS-CONTROL" +TARGET="_top" +>access control and security</A +> + options!</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN532" +>3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A +></H3 +><P +> The replacement for blocked images can be controlled with the <A +HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER" +TARGET="_top" +><TT +CLASS="LITERAL" +>set-image-blocker</TT +> + action</A +>. You have the choice of a checkerboard pattern, a transparent 1x1 GIF + image (aka <SPAN +CLASS="QUOTE" +>"blank"</SPAN +>), or a redirect to a custom image of your choice. + Note that this choice only has effect for images which are blocked as images, i.e. + whose URLs match both a <TT +CLASS="LITERAL" +><A +HREF="../user-manual/actions-file.html#HANDLE-AS-IMAGE" +TARGET="_top" +>handle-as-image</A +></TT +> + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>and</I +></SPAN +> <TT +CLASS="LITERAL" +><A +HREF="../user-manual/actions-file.html#BLOCK" +TARGET="_top" +>block</A +></TT +> action.</P +><P +> If you want to see nothing, then change the <A +HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER" +TARGET="_top" +><TT +CLASS="LITERAL" +>set-image-blocker</TT +> + action</A +> to <SPAN +CLASS="QUOTE" +>"blank"</SPAN +>. This can be done by editing the + <TT +CLASS="FILENAME" +>user.action</TT +> file, or through the <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>web-based actions file editor</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN549" +>3.14. Why would anybody want to see a checkerboard pattern?</A +></H3 +><P +> Remember that <A +HREF="general.html#WHATSANAD" +>telling which image is an ad and which + isn't</A +>, is an educated guess. While we hope that the standard configuration + is rather smart, it will make occasional mistakes. The checkerboard image is visually + decent, and it shows you where images have been blocked, which can be very + helpful in case some navigation aid or otherwise innocent image was + erroneously blocked. It is recommended for new users so they can + <SPAN +CLASS="QUOTE" +>"see"</SPAN +> what is happening. Some people might also enjoy seeing how + many banners they <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>don't</I +></SPAN +> have to see.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN555" +>3.15. I see some images being replaced with text +instead of the checkerboard image. Why and how do I get rid of this?</A +></H3 +><P +> This happens when the banners are not embedded in the HTML code of the + page itself, but in separate HTML (sub)documents that are loaded into (i)frames + or (i)layers, and these external HTML documents are blocked. Being non-images + they get replaced by a substitute HTML page rather than a substitute image, + which wouldn't work out technically, since the browser expects and accepts + only HTML when it has requested an HTML document. </P +><P +> The substitute page adapts to the available space and shows itself as a + miniature two-liner if loaded into small frames, or full-blown with a + large red "BLOCKED" banner if space allows.</P +><P +> If you prefer the banners to be blocked by images, you must see to it that + the HTML documents in which they are embedded are not blocked. Clicking + the <SPAN +CLASS="QUOTE" +>"See why"</SPAN +> link offered in the substitute page will show + you which rule blocked the page. After changing the rule and un-blocking + the HTML documents, the browser will try to load the actual banner images + and the usual image blocking will (hopefully!) kick in.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="SRVANY" +>3.16. Can Privoxy run as a service +on Win2K/NT/XP?</A +></H3 +><P +> Yes. Version 3.0.5 introduces full <SPAN +CLASS="APPLICATION" +>Windows</SPAN +> service + functionality. See <A +HREF="../user-manual/installation.html#installation-pack-win" +TARGET="_top" +> the <I +CLASS="CITETITLE" +>User Manual</I +></A +> for details on how to install and configure + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> as a service.</P +><P +> Earlier 3.x versions could run as a system service using <B +CLASS="COMMAND" +>srvany.exe</B +>. + See the discussion at <A +HREF="http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&a..." +TARGET="_top" +>http://sourceforge.net/tracker/?func=detail&atid=361118&aid=485617&a...</A +>, + for details, and a sample configuration.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="OTHERPROXY" +>3.17. How can I make Privoxy work with other +proxies like Squid or Tor?</A +></H3 +><P +> This can be done and is often useful to combine the benefits of + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with those of a another proxy. + See the <A +HREF="../user-manual/config.html#FORWARDING" +TARGET="_top" +>forwarding chapter</A +> + in the <A +HREF="../user-manual/index.html" +TARGET="_top" +>User Manual</A +> which + describes how to do this, and the <A +HREF="misc.html#TOR" +> How do I use Privoxy together with + Tor</A +> section below.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="PORT-80" +>3.18. Can I just set Privoxy to use port 80 +and thus avoid individual browser configuration?</A +></H3 +><P +> No, its more complicated than that. This only works with special kinds + of proxies known as <SPAN +CLASS="QUOTE" +>"intercepting"</SPAN +> proxies (see below).</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="TRANSPARENT" +>3.19. Can Privoxy run as a <SPAN +CLASS="QUOTE" +>"transparent"</SPAN +> proxy?</A +></H3 +><P +> The whole idea of Privoxy is to modify client requests + and server responses in all sorts of ways and therefore + it's not a transparent proxy as described in + <A +HREF="http://tools.ietf.org/html/rfc2616" +TARGET="_top" +>RFC 2616</A +>.</P +><P +> However, some people say <SPAN +CLASS="QUOTE" +>"transparent proxy"</SPAN +> when they + mean <SPAN +CLASS="QUOTE" +>"intercepting proxy"</SPAN +>. If you are one of them, + please read the <A +HREF="#intercepting" +TARGET="_top" +>next entry</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="INTERCEPTING" +>3.20. Can Privoxy run as a <SPAN +CLASS="QUOTE" +>"intercepting"</SPAN +> proxy?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can't intercept traffic itself, + but it can handle requests that where intercepted and redirected + with a packet filter (like <SPAN +CLASS="APPLICATION" +>PF</SPAN +> or + <SPAN +CLASS="APPLICATION" +>iptables</SPAN +>), as long as the <TT +CLASS="LITERAL" +>Host</TT +> + header is present. + </P +><P +> As the <TT +CLASS="LITERAL" +>Host</TT +> header is required by HTTP/1.1 and as most + web sites rely on it anyway, this limitation shouldn't be a problem.</P +><P +> Please refer to your packet filter's documentation to learn how to + intercept and redirect traffic into <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + Afterward you just have to configure <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to + <A +HREF="../user-manual/config.html#ACCEPT-INTERCEPTED-REQUESTS" +TARGET="_top" +>accept + intercepted requests</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="OUTLOOK" +>3.21. How can I configure Privoxy for use with Outlook?</A +></H3 +><P +> Versions of <SPAN +CLASS="APPLICATION" +>Outlook</SPAN +> prior to Office 2007, use + <SPAN +CLASS="APPLICATION" +>Internet Explorer</SPAN +> components to both render HTML, + and fetch any HTTP requests that may be embedded in an HTML email. So however + you have <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> configured to work with IE, this + configuration should automatically be shared, at least with older version of + Internet Explorer.</P +><P +> Starting with Office 2007, Microsoft is instead using the MS-Word rendering + engine with Outlook. It is unknown whether this can be configured to use a + proxy. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="OUTLOOK-MORE" +>3.22. How can I have separate rules just for HTML mail?</A +></H3 +><P +> The short answer is, you can't. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> has no way + of knowing which particular application makes a request, so there is no way to + distinguish between web pages and HTML mail. + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> just blindly proxies all requests. In the + case of <SPAN +CLASS="APPLICATION" +>Outlook Express</SPAN +> (see above), OE uses + IE anyway, and there is no way for <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to ever + be able to distinguish between them (nor could any other proxy type application for + that matter).</P +><P +> For a good discussion of some of the issues involved (including privacy and + security issues), see + <A +HREF="http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&a..." +TARGET="_top" +>http://sourceforge.net/tracker/?func=detail&atid=211118&aid=629518&a...</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="SNEAKY-COOKIES" +>3.23. I sometimes notice cookies sneaking through. How?</A +></H3 +><P +> <A +HREF="http://en.wikipedia.org/wiki/Browser_cookie" +TARGET="_top" +>Cookies</A +> can be + set in several ways. The classic method is via the + <TT +CLASS="LITERAL" +>Set-Cookie</TT +> HTTP header. This is straightforward, and an + easy one to manipulate, such as the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> concept of + <A +HREF="../user-manual/actions-file.html#SESSION-COOKIES-ONLY" +TARGET="_top" +>session-cookies-only</A +>. + There is also the possibility of using + <A +HREF="http://en.wikipedia.org/wiki/Javascript" +TARGET="_top" +>Javascript</A +> to + set cookies (<SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> calls these <TT +CLASS="LITERAL" +>content-cookies</TT +>). This + is trickier because the syntax can vary widely, and thus requires a certain + amount of guesswork. It is not realistic to catch all of these short of + disabling Javascript, which would break many sites. And lastly, if the + cookies are embedded in a HTTPS/SSL secure session via Javascript, they are beyond + <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> reach.</P +><P +> All in all, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can help manage cookies in general, can help minimize + the loss of privacy posed by cookies, but can't realistically stop all + cookies.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="EVIL-COOKIES" +>3.24. Are all cookies bad? Why?</A +></H3 +><P +> No, in fact there are many beneficial uses of + <A +HREF="http://en.wikipedia.org/wiki/Browser_cookie" +TARGET="_top" +>cookies</A +>. Cookies are just a + method that browsers can use to store data between pages, or between browser + sessions. Sometimes there is a good reason for this, and the user's life is a + bit easier as a result. But there is a long history of some websites taking + advantage of this layer of trust, and using the data they glean from you and + your browsing habits for their own purposes, and maybe to your potential + detriment. Such sites are using you and storing their data on your system. + That is why the privacy conscious watch from whom those cookies come, and why + they really <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>need</I +></SPAN +> to be there.</P +><P +> See the + <A +HREF="http://en.wikipedia.org/wiki/Browser_cookie" +TARGET="_top" +>Wikipedia cookie + definition</A +> for more.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="ALLOW-COOKIES" +>3.25. How can I allow permanent cookies for my trusted sites?</A +></H3 +><P +> There are several actions that relate to cookies. The default behavior is to + allow only <SPAN +CLASS="QUOTE" +>"session cookies"</SPAN +>, which means the cookies only last + for the current browser session. This eliminates most kinds of abuse related + to cookies. But there may be cases where you want cookies to last.</P +><P +> To disable all cookie actions, so that cookies are allowed unrestricted, + both in and out, for <TT +CLASS="LITERAL" +>example.com</TT +>: </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> { -crunch-incoming-cookies -crunch-outgoing-cookies -session-cookies-only -filter{content-cookies} } + .example.com</PRE +></TD +></TR +></TABLE +></P +><P +> Place the above in <TT +CLASS="FILENAME" +>user.action</TT +>. Note that some of these may + be off by default anyway, so this might be redundant, but there is no harm + being explicit in what you want to happen. <TT +CLASS="FILENAME" +>user.action</TT +> + includes an alias for this situation, called + <TT +CLASS="LITERAL" +>allow-all-cookies</TT +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="MULTIPLES" +>3.26. Can I have separate configurations for different users?</A +></H3 +><P +> Each instance of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> has its own + configuration, including such attributes as the TCP port that it listens on. + What you can do is run multiple instances of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, each with + a unique + <A +HREF="../user-manual/config.html#LISTEN-ADDRESS" +TARGET="_top" +>listen-address</A +> + configuration setting, and configuration path, and then + each of these can have their own configurations. Think of it as per-port + configuration.</P +><P +> + Simple enough for a few users, but for large installations, consider having + groups of users that might share like configurations.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="WHITELISTS" +>3.27. Can I set-up Privoxy as a whitelist of +<SPAN +CLASS="QUOTE" +>"good"</SPAN +> sites?</A +></H3 +><P +> Sure. There are a couple of things you can do for simple white-listing. + Here's one real easy one:</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> ############################################################ # Blacklist ############################################################ - { <a href="../user-manual/actions-file.html#BLOCK" target= -"_top">+block</a> } + { <A +HREF="../user-manual/actions-file.html#BLOCK" +TARGET="_top" +>+block</A +> } / # Block *all* URLs - + ############################################################ # Whitelist ############################################################ - { <a href="../user-manual/actions-file.html#BLOCK" target= -"_top">-block</a> } + { <A +HREF="../user-manual/actions-file.html#BLOCK" +TARGET="_top" +>-block</A +> } kids.example.com toys.example.com - games.example.com -</pre> - </td> - </tr> - </table> - - <p>This allows access to only those three sites by first blocking all - URLs, and then subsequently allowing three specific exceptions.</p> - - <p>Another approach is <span class="APPLICATION">Privoxy's</span> - <tt class="LITERAL">trustfile</tt> concept, which incorporates the - notion of <span class="QUOTE">"trusted referrers"</span>. See the - <a href="../user-manual/config.html#TRUSTFILE" target="_top">Trust - documentation</a> for details.</p> - - <p>These are fairly simple approaches and are not completely foolproof. - There are various other configuration options that should be disabled - (described elsewhere here and in <a href="../user-manual/" target= - "_top">the User Manual</a>) so that users can't modify their own - configuration and easily circumvent the whitelist.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="NO-ADBLOCK" id="NO-ADBLOCK">3.28. How can I - turn off ad-blocking?</a></h3> - - <p>Ad blocking is achieved through a complex application of various - <span class="APPLICATION">Privoxy</span> <a href= - "../user-manual/actions-file.html" target="_top">actions</a>. These - actions are deployed against simple images, banners, flash animations, - text pages, JavaScript, pop-ups and pop-unders, etc., so its not as - simple as just turning one or two actions off. The various actions that - make up <span class="APPLICATION">Privoxy</span> ad blocking are - hard-coded into the default configuration files. It has been assumed - that everyone using <span class="APPLICATION">Privoxy</span> is - interested in this particular feature.</p> - - <p>If you want to do without this, there are several approaches you can - take: You can manually undo the many block rules in <tt class= - "FILENAME">default.action</tt>. Or even easier, just create your own - <tt class="FILENAME">default.action</tt> file from scratch without the - many ad blocking rules, and corresponding exceptions. Or lastly, if you - are not concerned about the additional blocks that are done for privacy - reasons, you can very easily over-ride <span class= - "emphasis EMPHASIS c3">all</span> blocking with the following very - simple rule in your <tt class="FILENAME">user.action</tt>:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - # Unblock everybody, everywhere - { <a href="../user-manual/actions-file.html#BLOCK" target= -"_top">-block</a> } - / # UN-Block *all* URLs -</pre> - </td> - </tr> - </table> - - <p>Or even a more comprehensive reversing of various ad related - actions:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - # Unblock everybody, everywhere, and turn off appropriate filtering, etc - { <a href="../user-manual/actions-file.html#BLOCK" target= -"_top">-block</a> \ - <a href="../user-manual/actions-file.html#FILTER-BANNERS-BY-SIZE" target= -"_top">-filter{banners-by-size}</a> \ - <a href="../user-manual/actions-file.html#FILTER-BANNERS-BY-LINK" target= -"_top">-filter{banners-by-link}</a> \ - <tt class="LITERAL">allow-popups</tt> \ + games.example.com</PRE +></TD +></TR +></TABLE +><P +> This allows access to only those three sites by first blocking all URLs, and + then subsequently allowing three specific exceptions.</P +><P +> Another approach is <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + <TT +CLASS="LITERAL" +>trustfile</TT +> concept, which incorporates the notion of + <SPAN +CLASS="QUOTE" +>"trusted referrers"</SPAN +>. See the <A +HREF="../user-manual/config.html#TRUSTFILE" +TARGET="_top" +>Trust documentation</A +> + for details.</P +><P +> These are fairly simple approaches and are not completely foolproof. There + are various other configuration options that should be disabled (described + elsewhere here and in <A +HREF="../user-manual/" +TARGET="_top" +>the User Manual</A +>) + so that users can't modify their own configuration and easily circumvent the + whitelist.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="NO-ADBLOCK" +>3.28. How can I turn off ad-blocking?</A +></H3 +><P +> Ad blocking is achieved through a complex application of various <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + <A +HREF="../user-manual/actions-file.html" +TARGET="_top" +>actions</A +>. These + actions are deployed against simple images, banners, flash animations, + text pages, JavaScript, pop-ups and pop-unders, etc., so its not as simple as + just turning one or two actions off. The various actions that make up + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> ad blocking are hard-coded into the default configuration files. It + has been assumed that everyone using <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is interested in this + particular feature. + </P +><P +> If you want to do without this, there are several approaches you can take: + You can manually undo the many block rules in + <TT +CLASS="FILENAME" +>default.action</TT +>. Or even easier, just create your own + <TT +CLASS="FILENAME" +>default.action</TT +> file from scratch without the many ad + blocking rules, and corresponding exceptions. Or lastly, if you are not + concerned about the additional blocks that are done for privacy reasons, you + can very easily over-ride <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> blocking with the + following very simple rule in your <TT +CLASS="FILENAME" +>user.action</TT +>: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> # Unblock everybody, everywhere + { <A +HREF="../user-manual/actions-file.html#BLOCK" +TARGET="_top" +>-block</A +> } + / # UN-Block *all* URLs</PRE +></TD +></TR +></TABLE +></P +><P +> + Or even a more comprehensive reversing of various ad related actions:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> # Unblock everybody, everywhere, and turn off appropriate filtering, etc + { <A +HREF="../user-manual/actions-file.html#BLOCK" +TARGET="_top" +>-block</A +> \ + <A +HREF="../user-manual/actions-file.html#FILTER-BANNERS-BY-SIZE" +TARGET="_top" +>-filter{banners-by-size}</A +> \ + <A +HREF="../user-manual/actions-file.html#FILTER-BANNERS-BY-LINK" +TARGET="_top" +>-filter{banners-by-link}</A +> \ + <TT +CLASS="LITERAL" +>allow-popups</TT +> \ } - / # UN-Block *all* URLs and allow ads -</pre> - </td> - </tr> - </table> - - <p>This last <span class="QUOTE">"action"</span> in this compound - statement, <tt class="LITERAL">allow-popups</tt>, is an <a href= - "../user-manual/actions-file.html#ALIASES" target="_top">alias</a> that - disables various pop-up blocking features.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="TEMPLATES" id="TEMPLATES">3.29. How can I - have custom template pages, like the <span class= - "emphasis EMPHASIS c3">BLOCKED</span> page?</a></h3> - - <p><span class="APPLICATION">Privoxy</span> <span class= - "QUOTE">"templates"</span> are specialized text files utilized by - <span class="APPLICATION">Privoxy</span> for various purposes and can - easily be modified using any text editor. All the template pages are - installed in a sub-directory appropriately named: <tt class= - "FILENAME">templates</tt>. Knowing something about HTML syntax will of - course be helpful.</p> - - <p>Be forewarned that the default templates are subject to being - overwritten during upgrades. You can, however, create completely new - templates, place them in another directory and specify the alternate - path in the main <tt class="FILENAME">config</tt>. For details, have a - look at the <a href="../user-manual/config.html#templdir" target= - "_top">templdir</a> option.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="BLOCKALL" id="BLOCKALL">3.30. How can I - remove the <span class="QUOTE">"Go There Anyway"</span> link from the - <span class="emphasis EMPHASIS c3">BLOCKED</span> page?</a></h3> - - <p>There is more than one way to do it (although Perl is not - involved).</p> - - <p>Editing the BLOCKED template page (see above) may dissuade some - users, but this method is easily circumvented. Where you need this - level of control, you might want to build <span class= - "APPLICATION">Privoxy</span> from source, and disable various features - that are available as compile-time options. You should <b class= - "COMMAND">configure</b> the sources as follows:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - ./configure --disable-toggle --disable-editor --disable-force -</pre> - </td> - </tr> - </table> - - <p>This will create an executable with hard-coded security features so - that <span class="APPLICATION">Privoxy</span> does not allow easy - bypassing of blocked sites, or changing the current configuration via - any connected user's web browser.</p> - - <p>Finally, all of these features can also be toggled on/off via - options in <span class="APPLICATION">Privoxy's</span> main <a href= - "../user-manual/config.html#ACCESS-CONTROL" target="_top">config</a> - file which means you don't have to recompile anything.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="installation.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="misc.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Installation</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Miscellaneous</td> - </tr> - </table> - </div> -</body> -</html> + / # UN-Block *all* URLs and allow ads</PRE +></TD +></TR +></TABLE +></P +><P +> This last <SPAN +CLASS="QUOTE" +>"action"</SPAN +> in this compound statement, + <TT +CLASS="LITERAL" +>allow-popups</TT +>, is an <A +HREF="../user-manual/actions-file.html#ALIASES" +TARGET="_top" +>alias</A +> that disables + various pop-up blocking features.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="TEMPLATES" +>3.29. How can I have custom template pages, like the +<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>BLOCKED</I +></SPAN +> page?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> <SPAN +CLASS="QUOTE" +>"templates"</SPAN +> are specialized text files utilized by + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> for various purposes and can easily be modified using any text + editor. All the template pages are installed in a sub-directory appropriately + named: <TT +CLASS="FILENAME" +>templates</TT +>. Knowing something about HTML syntax + will of course be helpful.</P +><P +> Be forewarned that the default templates are subject to being overwritten + during upgrades. You can, however, create completely new templates, + place them in another directory and specify the alternate path in the main + <TT +CLASS="FILENAME" +>config</TT +>. For details, have a look at the <A +HREF="../user-manual/config.html#templdir" +TARGET="_top" +>templdir</A +> option. </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="BLOCKALL" +>3.30. How can I remove the <SPAN +CLASS="QUOTE" +>"Go There Anyway"</SPAN +> link from +the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>BLOCKED</I +></SPAN +> page?</A +></H3 +><P +> There is more than one way to do it (although Perl is not involved).</P +><P +> Editing the BLOCKED template page (see above) may dissuade some users, but + this method is easily circumvented. Where you need this level of control, you + might want to build <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> from source, and disable various features that are + available as compile-time options. You should + <B +CLASS="COMMAND" +>configure</B +> the sources as follows:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> ./configure --disable-toggle --disable-editor --disable-force</PRE +></TD +></TR +></TABLE +></P +><P +> This will create an executable with hard-coded security features so that + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> does not allow easy bypassing of blocked sites, or changing the + current configuration via any connected user's web browser.</P +><P +> Finally, all of these features can also be toggled on/off via options in + <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> main <A +HREF="../user-manual/config.html#ACCESS-CONTROL" +TARGET="_top" +>config</A +> file which + means you don't have to recompile anything.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="misc.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Installation</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Miscellaneous</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/faq/contact.html b/external/privoxy/doc/webserver/faq/contact.html index 8f97f56..c9d18c7 100644 --- a/external/privoxy/doc/webserver/faq/contact.html +++ b/external/privoxy/doc/webserver/faq/contact.html @@ -1,363 +1,510 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Contacting the developers, Bug Reporting and Feature - Requests</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Frequently Asked Questions" href= - "index.html"> - <link rel="PREVIOUS" title="Troubleshooting" href="trouble.html"> - <link rel="NEXT" title="Privoxy Copyright, License and History" href= - "copyright.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Frequently Asked - Questions</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="trouble.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "copyright.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="CONTACT" id="CONTACT">6. Contacting the - developers, Bug Reporting and Feature Requests</a></h1> - - <p>We value your feedback. In fact, we rely on it to improve <span class= - "APPLICATION">Privoxy</span> and its configuration. However, please note - the following hints, so we can provide you with the best support:</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">6.1. - Get Support</a></h2> - - <p>For casual users, our <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=211118" - target="_top">support forum at SourceForge</a> is probably best suited: - <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=211118" - target="_top">http://sourceforge.net/tracker/?group_id=11118&atid=211118</a></p> - - <p>All users are of course welcome to discuss their issues on the - <a href="http://lists.sourceforge.net/lists/listinfo/ijbswa-users" - target="_top">users mailing list</a>, where the developers also hang - around.</p> - - <p>Please don't sent private support requests to individual Privoxy - developers, either use the mailing lists or the support trackers.</p> - - <p>If you have to contact a Privoxy developer directly for other - reasons, please send a real mail and do not bother with SourceForge's - messaging system. Answers to SourceForge messages are usually bounced - by SourceForge's mail server in which case the developer wasted time - writing a response you don't get. From your point of view it will look - like your message has been completely ignored, so this is frustrating - for all parties involved.</p> - - <p>Note that the Privoxy mailing lists are moderated. Posts from - unsubscribed addresses have to be accepted manually by a moderator. - This may cause a delay of several days and if you use a subject that - doesn't clearly mention Privoxy or one of its features, your message - may be accidentally discarded as spam.</p> - - <p>If you aren't subscribed, you should therefore spend a few seconds - to come up with a proper subject. Additionally you should make it clear - that you want to get CC'd. Otherwise some responses will be directed to - the mailing list only, and you won't see them.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="REPORTING" id="REPORTING">6.2. Reporting - Problems</a></h2> - - <p><span class="QUOTE">"Problems"</span> for our purposes, come in two - forms:</p> - - <ul> - <li> - <p>Configuration issues, such as ads that slip through, or sites - that don't function properly due to one <span class= - "APPLICATION">Privoxy</span> <span class="QUOTE">"action"</span> or - another being turned <span class="QUOTE">"on"</span>.</p> - </li> - - <li> - <p><span class="QUOTE">"Bugs"</span> in the programming code that - makes up <span class="APPLICATION">Privoxy</span>, such as that - might cause a crash.</p> - </li> - </ul> - - <div class="SECT3"> - <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">6.2.1. - Reporting Ads or Other Configuration Problems</a></h3> - - <p>Please send feedback on ads that slipped through, innocent images - that were blocked, sites that don't work properly, and other - configuration related problem of <tt class= - "FILENAME">default.action</tt> file, to <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=460288" - target= - "_top">http://sourceforge.net/tracker/?group_id=11118&atid=460288</a>, - the Actions File Tracker.</p> - - <p>New, improved <tt class="FILENAME">default.action</tt> files may - occasionally be made available based on your feedback. These will be - announced on the <a href= - "http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" target= - "_top">ijbswa-announce</a> list and available from our the <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118" target= - "_top">files section</a> of our <a href= - "http://sf.net/projects/ijbswa/" target="_top">project page</a>.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">6.2.2. - Reporting Bugs</a></h3> - - <p>Please report all bugs through our bug tracker: <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=111118" - target= - "_top">http://sourceforge.net/tracker/?group_id=11118&atid=111118</a>.</p> - - <p>Before doing so, please make sure that the bug has <span class= - "emphasis EMPHASIS c2">not already been submitted</span> and observe - the additional hints at the top of the <a href= - "http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118" - target="_top">submit form</a>. If already submitted, please feel free - to add any info to the original report that might help to solve the - issue.</p> - - <p>Please try to verify that it is a <span class= - "APPLICATION">Privoxy</span> bug, and not a browser or site bug or - documented behaviour that just happens to be different than what you - expected. If unsure, try <a href= - "http://config.privoxy.org/toggle?set=disable" target="_top">toggling - off</a> <span class="APPLICATION">Privoxy</span>, and see if the - problem persists.</p> - - <p>If you are using your own custom configuration, please try the - stock configs to see if the problem is configuration related. If - you're having problems with a feature that is disabled by default, - please ask around on the mailing list if others can reproduce the - problem.</p> - - <p>If you aren't using the latest Privoxy version, the bug may have - been found and fixed in the meantime. We would appreciate if you - could take the time to <a href= - "http://www.privoxy.org/user-manual/installation.html" target= - "_top">upgrade to the latest version</a> (or even the latest CVS - snapshot) and verify that your bug still exists.</p> - - <p>Please be sure to provide the following information:</p> - - <ul> - <li> - <p>The exact <span class="APPLICATION">Privoxy</span> version you - are using (if you got the source from CVS, please also provide - the source code revisions as shown in <a href= - "http://config.privoxy.org/show-version" target= - "_top">http://config.privoxy.org/show-version</a>).</p> - </li> - - <li> - <p>The operating system and versions you run <span class= - "APPLICATION">Privoxy</span> on, (e.g. <span class= - "APPLICATION">Windows XP SP2</span>), if you are using a Unix - flavor, sending the output of <span class="QUOTE">"uname - -a"</span> should do, in case of GNU/Linux, please also name the - distribution.</p> - </li> - - <li> - <p>The name, platform, and version of the <span class= - "APPLICATION">browser</span> you were using (e.g. <span class= - "APPLICATION">Internet Explorer v5.5</span> for Mac).</p> - </li> - - <li> - <p>The URL where the problem occurred, or some way for us to - duplicate the problem (e.g. <tt class= - "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p> - </li> - - <li> - <p>Whether your version of <span class= - "APPLICATION">Privoxy</span> is one supplied by the <span class= - "APPLICATION">Privoxy</span> developers via SourceForge, or if - you got your copy somewhere else.</p> - </li> - - <li> - <p>Whether you are using <span class="APPLICATION">Privoxy</span> - in tandem with another proxy such as <span class= - "APPLICATION">Tor</span>. If so, please temporary disable the - other proxy to see if the symptoms change.</p> - </li> - - <li> - <p>Whether you are using a personal firewall product. If so, does - <span class="APPLICATION">Privoxy</span> work without it?</p> - </li> - - <li> - <p>Any other pertinent information to help identify the problem - such as config or log file excerpts (yes, you should have log - file entries for each action taken). To get a meaningful logfile, - please make sure that the <a href= - "../user-manual/config.html#LOGFILE" target="_top">logfile - directive</a> is being used and the following <a href= - "../user-manual/config.html#DEBUG" target="_top">debug - options</a> are enabled:</p> - - <p class="LITERALLAYOUT"> - debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br> - - debug 2 # show each connection status<br> - - debug 4 # show I/O status<br> - - debug 8 # show header parsing<br> - - debug 128 # debug redirects<br> - debug 256 # debug GIF de-animation<br> - - debug 512 # Common Log Format<br> - - debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br> - - debug 4096 # Startup banner and warnings.<br> - - debug 8192 # Non-fatal errors</p>If you - are having trouble with a filter, please additionally enable - - <p class="LITERALLAYOUT"> - debug 64 # debug regular expression filters</p>If - you are using Privoxy 3.0.17 or later and suspect that it - interprets the request or the response incorrectly, please enable - - <p class="LITERALLAYOUT"> - debug 32768 # log all data read from the network</p>Note - that Privoxy log files may contain sensitive information so - please don't submit any logfiles you didn't read first. You can - mask sensitive information as long as it's clear that you removed - something. - </li> - </ul> - - <p>You don't have to tell us your actual name when filing a problem - report, but if you don't, please use a nickname so we can - differentiate between your messages and the ones entered by other - "anonymous" users that may respond to your request if they have the - same problem or already found a solution. Note that due to spam the - trackers may not always allow to post without being logged into - SourceForge. If that's the case, you are still free to create a login - that isn't directly linked to your name, though.</p> - - <p>Please also check the status of your request a few days after - submitting it, as we may request additional information. If you use a - SF id, you should automatically get a mail when someone responds to - your request. Please don't bother to add an email address when using - the tracker. If you prefer to communicate through email, just use one - of the mailing lists directly.</p> - - <p>If you are new to reporting problems, you might be interested in - <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" - target="_top">How to Report Bugs Effectively</a>.</p> - - <p>The <a href= - "http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" - target="_top">appendix of the Privoxy User Manual</a> also has - helpful information on understanding <tt class= - "LITERAL">actions</tt>, and <tt class="LITERAL">action</tt> - debugging.</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CONTACT-FEATURE" id="CONTACT-FEATURE">6.3. - Request New Features</a></h2> - - <p>You are welcome to submit ideas on new features or other proposals - for improvement through our feature request tracker at <a href= - "http://sourceforge.net/tracker/?atid=361118&group_id=11118" - target="_top">http://sourceforge.net/tracker/?atid=361118&group_id=11118</a>.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">6.4. - Mailing Lists</a></h2> - - <p>If you prefer to communicate through email, instead of using a web - interface, feel free to use one of the mailing lists. To discuss issues - that haven't been completely diagnosed yet, please use the Privoxy - users list. Technically interested users and people who wish to - contribute to the project are always welcome on the developers list. - You can find an overview of all <span class= - "APPLICATION">Privoxy</span>-related mailing lists, including list - archives, at: <a href="http://sourceforge.net/mail/?group_id=11118" - target="_top">http://sourceforge.net/mail/?group_id=11118</a>.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="trouble.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="copyright.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Troubleshooting</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Privoxy Copyright, License - and History</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Contacting the developers, Bug Reporting and Feature Requests</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Frequently Asked Questions" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Troubleshooting" +HREF="trouble.html"><LINK +REL="NEXT" +TITLE="Privoxy Copyright, License and History" +HREF="copyright.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Frequently Asked Questions</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="trouble.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="copyright.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="CONTACT" +>6. Contacting the developers, Bug Reporting and Feature Requests</A +></H1 +><P +> We value your feedback. In fact, we rely on it to improve + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and its configuration. + However, please note the following hints, so we can + provide you with the best support:</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-SUPPORT" +>6.1. Get Support</A +></H2 +><P +> For casual users, our + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118" +TARGET="_top" +>support forum at SourceForge</A +> + is probably best suited: + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118" +TARGET="_top" +>http://sourceforge.net/tracker/?group_id=11118&atid=211118</A +></P +><P +> All users are of course welcome to discuss their issues on the <A +HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-users" +TARGET="_top" +>users + mailing list</A +>, where the developers also hang around.</P +><P +> Please don't sent private support requests to individual Privoxy + developers, either use the mailing lists or the support trackers.</P +><P +> Note that the Privoxy mailing lists are moderated. Posts from unsubscribed + addresses have to be accepted manually by a moderator. This may cause a + delay of several days and if you use a subject that doesn't clearly + mention Privoxy or one of its features, your message may be accidentally + discarded as spam.</P +><P +> If you aren't subscribed, you should therefore spend a few seconds + to come up with a proper subject. Additionally you should make it clear + that you want to get CC'd. Otherwise some responses will be directed to + the mailing list only, and you won't see them.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="REPORTING" +>6.2. Reporting Problems</A +></H2 +><P +><SPAN +CLASS="QUOTE" +>"Problems"</SPAN +> for our purposes, come in two forms:</P +><P +></P +><UL +><LI +><P +> Configuration issues, such as ads that slip through, or sites that + don't function properly due to one <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + <SPAN +CLASS="QUOTE" +>"action"</SPAN +> or another being turned <SPAN +CLASS="QUOTE" +>"on"</SPAN +>. + </P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"Bugs"</SPAN +> in the programming code that makes up + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, such as that might cause a crash. + </P +></LI +></UL +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="CONTACT-ADS" +>6.2.1. Reporting Ads or Other Configuration Problems</A +></H3 +><P +> Please send feedback on ads that slipped through, innocent images that were + blocked, sites that don't work properly, and other configuration related problem of + <TT +CLASS="FILENAME" +>default.action</TT +> file, to + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288" +TARGET="_top" +> http://sourceforge.net/tracker/?group_id=11118&atid=460288</A +>, + the Actions File Tracker.</P +><P +> New, improved <TT +CLASS="FILENAME" +>default.action</TT +> files may occasionally be made + available based on your feedback. These will be announced on the <A +HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" +TARGET="_top" +>ijbswa-announce</A +> + list and available from our the <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>files section</A +> of + our <A +HREF="http://sf.net/projects/ijbswa/" +TARGET="_top" +>project page</A +>.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="CONTACT-BUGS" +>6.2.2. Reporting Bugs</A +></H3 +><P +> Please report all bugs through our bug tracker: + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118" +TARGET="_top" +>http://sourceforge.net/tracker/?group_id=11118&atid=111118</A +>. </P +><P +> Before doing so, please make sure that the bug has <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not already been submitted</I +></SPAN +> + and observe the additional hints at the top of the <A +HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118" +TARGET="_top" +>submit + form</A +>. If already submitted, please feel free to add any info to the + original report that might help to solve the issue.</P +><P +> Please try to verify that it is a <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> bug, + and not a browser or site bug or documented behaviour that just happens + to be different than what you expected. If unsure, + try <A +HREF="http://config.privoxy.org/toggle?set=disable" +TARGET="_top" +>toggling + off</A +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, and see if the problem persists.</P +><P +> If you are using your own custom configuration, please try + the stock configs to see if the problem is configuration related. + If you're having problems with a feature that is disabled by default, + please ask around on the mailing list if others can reproduce the problem.</P +><P +> If you aren't using the latest Privoxy version, the bug may have been found + and fixed in the meantime. We would appreciate if you could take the time + to <A +HREF="http://www.privoxy.org/user-manual/installation.html" +TARGET="_top" +>upgrade + to the latest version</A +> (or even the latest CVS snapshot) and verify + that your bug still exists.</P +><P +>Please be sure to provide the following information:</P +><P +> <P +></P +><UL +><LI +><P +> The exact <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version you are using + (if you got the source from CVS, please also provide the source code revisions + as shown in <A +HREF="http://config.privoxy.org/show-version" +TARGET="_top" +>http://config.privoxy.org/show-version</A +>). + </P +></LI +><LI +><P +> The operating system and versions you run + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on, (e.g. <SPAN +CLASS="APPLICATION" +>Windows + XP SP2</SPAN +>), if you are using a Unix flavor, + sending the output of <SPAN +CLASS="QUOTE" +>"uname -a"</SPAN +> should do, + in case of GNU/Linux, please also name the distribution. + </P +></LI +><LI +><P +> The name, platform, and version of the <SPAN +CLASS="APPLICATION" +>browser</SPAN +> + you were using (e.g. <SPAN +CLASS="APPLICATION" +>Internet Explorer v5.5</SPAN +> for Mac). + </P +></LI +><LI +><P +> The URL where the problem occurred, or some way for us to duplicate the + problem (e.g. <TT +CLASS="LITERAL" +>http://somesite.example.com/?somethingelse=123</TT +>). + </P +></LI +><LI +><P +> Whether your version of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is one supplied + by the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developers via SourceForge, + or if you got your copy somewhere else. + </P +></LI +><LI +><P +> Whether you are using <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> in tandem with + another proxy such as <SPAN +CLASS="APPLICATION" +>Tor</SPAN +>. If so, please + temporary disable the other proxy to see if the symptoms change. + </P +></LI +><LI +><P +> Whether you are using a personal firewall product. If so, does + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> work without it? + </P +></LI +><LI +><P +> Any other pertinent information to help identify the problem such as config + or log file excerpts (yes, you should have log file entries for each + action taken). + </P +></LI +></UL +></P +><P +> You don't have to tell us your actual name when filing a problem + report, but please use a nickname so we can differentiate between + your messages and the ones entered by other "anonymous" users that + may respond to your request if they have the same problem or already + found a solution.</P +><P +> Please also check the status of your request a few days after submitting + it, as we may request additional information. If you use a SF id, + you should automatically get a mail when someone responds to your request.</P +><P +> The <A +HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" +TARGET="_top" +>appendix + of the Privoxy User Manual</A +> also has helpful information + on understanding <TT +CLASS="LITERAL" +>actions</TT +>, and <TT +CLASS="LITERAL" +>action</TT +> debugging. </P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-FEATURE" +>6.3. Request New Features</A +></H2 +><P +> You are welcome to submit ideas on new features or other proposals + for improvement through our feature request tracker at + <A +HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118" +TARGET="_top" +>http://sourceforge.net/tracker/?atid=361118&group_id=11118</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-OTHER" +>6.4. Other</A +></H2 +><P +>For any other issues, feel free to use the mailing lists. Technically interested users +and people who wish to contribute to the project are also welcome on the developers list! +You can find an overview of all <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>-related mailing lists, +including list archives, at: +<A +HREF="http://sourceforge.net/mail/?group_id=11118" +TARGET="_top" +>http://sourceforge.net/mail/?group_id=11118</A +>.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="trouble.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="copyright.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Troubleshooting</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Privoxy Copyright, License and History</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/faq/copyright.html b/external/privoxy/doc/webserver/faq/copyright.html index 69a87cc..39b71a6 100644 --- a/external/privoxy/doc/webserver/faq/copyright.html +++ b/external/privoxy/doc/webserver/faq/copyright.html @@ -1,165 +1,301 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy Copyright, License and History</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Frequently Asked Questions" href= - "index.html"> - <link rel="PREVIOUS" title= - "Contacting the developers, Bug Reporting and Feature Requests" href= - "contact.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - a.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Frequently Asked - Questions</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="contact.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"> </td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="COPYRIGHT" id="COPYRIGHT">7. Privoxy - Copyright, License and History</a></h1> - - <p>Copyright © 2001-2011 by Privoxy Developers <code class= - "EMAIL"><<a href= - "mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</a>></code></p> - - <p>Some source code is based on code Copyright © 1997 by Anonymous - Coders and Junkbusters, Inc. and licensed under the <i class= - "CITETITLE">GNU General Public License</i>.</p> - - <p>Portions of this document are <span class="QUOTE">"borrowed"</span> - from the original <span class="APPLICATION">Junkbuster</span> (tm) FAQ, - and modified as appropriate for <span class= - "APPLICATION">Privoxy</span>.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN1475" id="AEN1475">7.1. License</a></h2> - - <p><span class="APPLICATION">Privoxy</span> is free software; you can - redistribute it and/or modify it under the terms of the <i class= - "CITETITLE">GNU General Public License</i>, version 2, as published by - the Free Software Foundation.</p> - - <p>This program is distributed in the hope that it will be useful, but - WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the <a class= - "CITETITLE c2" href= - "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target= - "_top">GNU General Public License</a> for details.</p> - - <p>You should have received a copy of the <i class="CITETITLE">GNU - GPL</i> along with this program; if not, write to the</p> - - <p class="ADDRESS"> Free Software<br> - Foundation, Inc. <span class="STREET">51 Franklin - Street, Fifth Floor</span><br> - <span class="CITY">Boston</span>, <span class= - "STATE">MA</span> <span class="POSTCODE">02110-1301</span><br> - <span class="COUNTRY">USA</span> </p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN1491" id="AEN1491">7.2. History</a></h2> - - <p>A long time ago, there was the <a href= - "http://www.junkbusters.com/ijb.html" target="_top"><span class= - "APPLICATION">Internet Junkbuster</span></a>, by Anonymous Coders and - <a href="http://www.junkbusters.com/" target="_top">Junkbusters - Corporation</a>. This saved many users a lot of pain in the early days - of web advertising and user tracking.</p> - - <p>But the web, its protocols and standards, and with it, the - techniques for forcing ads on users, give up autonomy over their - browsing, and for tracking them, keeps evolving. Unfortunately, the - <span class="APPLICATION">Internet Junkbuster</span> did not. Version - 2.0.2, published in 1998, was (and is) the last official <a href= - "http://www.junkbusters.com/ijbdist.html#release" target= - "_top">release</a> available from <a href="http://www.junkbusters.com" - target="_top">Junkbusters Corporation</a>. Fortunately, it had been - released under the GNU <a href= - "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target= - "_top">GPL</a>, which allowed further development by others.</p> - - <p>So Stefan Waldherr started maintaining an improved version of the - software, to which eventually a number of people contributed patches. - It could already replace banners with a transparent image, and had a - first version of pop-up killing, but it was still very closely based on - the original, with all its limitations, such as the lack of HTTP/1.1 - support, flexible per-site configuration, or content modification. The - last release from this effort was version 2.0.2-10, published in - 2000.</p> - - <p>Then, some <a href= - "http://www.privoxy.org/user-manual/copyright.html#AUTHORS" target= - "_top">developers</a> picked up the thread, and started turning the - software inside out, upside down, and then reassembled it, adding many - <a href="http://www.privoxy.org/user-manual/introduction.html#FEATURES" - target="_top">new features</a> along the way.</p> - - <p>The result of this is <span class="APPLICATION">Privoxy</span>, - whose first stable version, 3.0, was released August, 2002.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="contact.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"> </td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Contacting the developers, - Bug Reporting and Feature Requests</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top"> </td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Privoxy Copyright, License and History</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Frequently Asked Questions" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Contacting the developers, Bug Reporting and Feature Requests" +HREF="contact.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Frequently Asked Questions</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="contact.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +> </TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="COPYRIGHT" +>7. Privoxy Copyright, License and History</A +></H1 +><P +> Copyright © 2001-2009 by Privoxy Developers <CODE +CLASS="EMAIL" +><<A +HREF="mailto:ijbswa-developers@lists.sourceforge.net" +>ijbswa-developers@lists.sourceforge.net</A +>></CODE +></P +><P +> Some source code is based on code Copyright © 1997 by Anonymous Coders + and Junkbusters, Inc. and licensed under the <I +CLASS="CITETITLE" +>GNU General Public + License</I +>.</P +><P +> Portions of this document are <SPAN +CLASS="QUOTE" +>"borrowed"</SPAN +> from the original + <SPAN +CLASS="APPLICATION" +>Junkbuster</SPAN +> (tm) FAQ, and modified as + appropriate for <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + </P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN1451" +>7.1. License</A +></H2 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is free software; you can + redistribute it and/or modify it under the terms of the + <I +CLASS="CITETITLE" +>GNU General Public License</I +>, version 2, + as published by the Free Software Foundation.</P +><P +> This program is distributed in the hope that it will be useful, but WITHOUT + ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + FITNESS FOR A PARTICULAR PURPOSE. See the <A +HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" +TARGET="_top" +> <I +CLASS="CITETITLE" +>GNU General Public License</I +></A +> for details.</P +><P +> You should have received a copy of the <I +CLASS="CITETITLE" +>GNU GPL</I +> + along with this program; if not, write to the <P +CLASS="ADDRESS" +> Free Software<br> + Foundation, Inc. <SPAN +CLASS="STREET" +>51 Franklin Street, Fifth Floor</SPAN +><br> + <SPAN +CLASS="CITY" +>Boston</SPAN +>, <SPAN +CLASS="STATE" +>MA</SPAN +> <SPAN +CLASS="POSTCODE" +>02110-1301</SPAN +><br> + <SPAN +CLASS="COUNTRY" +>USA</SPAN +> </P +></P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN1467" +>7.2. History</A +></H2 +><P +> A long time ago, there was the + <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +><SPAN +CLASS="APPLICATION" +>Internet Junkbuster</SPAN +></A +>, + by Anonymous Coders and <A +HREF="http://www.junkbusters.com/" +TARGET="_top" +>Junkbusters + Corporation</A +>. This saved many users a lot of pain in the early days of + web advertising and user tracking.</P +><P +> But the web, its protocols and standards, and with it, the techniques for + forcing ads on users, give up autonomy over their browsing, and + for tracking them, keeps evolving. Unfortunately, the <SPAN +CLASS="APPLICATION" +>Internet + Junkbuster</SPAN +> did not. Version 2.0.2, published in 1998, was + (and is) the last official + <A +HREF="http://www.junkbusters.com/ijbdist.html#release" +TARGET="_top" +>release</A +> + available from <A +HREF="http://www.junkbusters.com" +TARGET="_top" +>Junkbusters Corporation</A +>. + Fortunately, it had been released under the GNU + <A +HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" +TARGET="_top" +>GPL</A +>, + which allowed further development by others.</P +><P +> So Stefan Waldherr started maintaining an improved version of the + software, to which eventually a number of people contributed patches. + It could already replace banners with a transparent image, and had a first + version of pop-up killing, but it was still very closely based on the + original, with all its limitations, such as the lack of HTTP/1.1 support, + flexible per-site configuration, or content modification. The last release + from this effort was version 2.0.2-10, published in 2000.</P +><P +> Then, some + <A +HREF="http://www.privoxy.org/user-manual/copyright.html#AUTHORS" +TARGET="_top" +>developers</A +> + picked up the thread, and started turning the software inside out, upside down, + and then reassembled it, adding many + <A +HREF="http://www.privoxy.org/user-manual/introduction.html#FEATURES" +TARGET="_top" +>new + features</A +> along the way.</P +><P +> The result of this is <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, whose first + stable version, 3.0, was released August, 2002. + </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="contact.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +> </TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Contacting the developers, Bug Reporting and Feature Requests</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +> </TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/faq/general.html b/external/privoxy/doc/webserver/faq/general.html index 3fb3b53..7043b18 100644 --- a/external/privoxy/doc/webserver/faq/general.html +++ b/external/privoxy/doc/webserver/faq/general.html @@ -1,614 +1,1076 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>General Information</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Frequently Asked Questions" href= - "index.html"> - <link rel="PREVIOUS" title="Privoxy Frequently Asked Questions" href= - "index.html"> - <link rel="NEXT" title="Installation" href="installation.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Frequently Asked - Questions</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="index.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "installation.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="GENERAL" id="GENERAL">1. General - Information</a></h1> - - <div class="SECT2"> - <h3 class="SECT2"><a name="WHO-USES" id="WHO-USES">1.1. Who should give - <span class="APPLICATION">Privoxy</span> a try?</a></h3> - - <p>Anyone who is interested in security, privacy, or in finer-grained - control over their web and Internet experience.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="BESTCHOICE" id="BESTCHOICE">1.2. Is Privoxy - the best choice for me?</a></h3> - - <p><span class="APPLICATION">Privoxy</span> is certainly a good choice, - especially for those who want more control and security. Those with the - willingness to read the documentation and the ability to fine-tune - their installation will benefit the most.</p> - - <p>One of <span class="APPLICATION">Privoxy's</span> strengths is that - it is highly configurable giving you the ability to completely - personalize your installation. Being familiar with, or at least having - an interest in learning about <a href= - "http://en.wikipedia.org/wiki/Http" target="_top">HTTP</a> and other - networking protocols, <a href="http://en.wikipedia.org/wiki/Html" - target="_top">HTML</a>, and <a href= - "http://en.wikipedia.org/wiki/Regular_expressions" target= - "_top"><span class="QUOTE">"Regular Expressions"</span></a> will be a - big plus and will help you get the most out of <span class= - "APPLICATION">Privoxy</span>. A new installation just includes a very - basic configuration. The user should take this as a starting point - only, and enhance it as he or she sees fit. In fact, the user is - encouraged, and expected to, fine-tune the configuration.</p> - - <p>Much of <span class="APPLICATION">Privoxy's</span> configuration can - be done with a <a href="http://en.wikipedia.org/wiki/Web_browser" - target="_top">Web browser</a>. But there are areas where configuration - is done using a <a href="http://en.wikipedia.org/wiki/Text_editors" - target="_top">text editor</a> to edit configuration files. Also note - that the web-based action editor doesn't use authentication and should - only be enabled in environments where all clients with access to - <span class="APPLICATION">Privoxy</span> listening port can be - trusted.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="PROXYMORON" id="PROXYMORON">1.3. What is a - <span class="QUOTE">"proxy"</span>? How does Privoxy work?</a></h3> - - <p>A <a href="http://en.wikipedia.org/wiki/Proxy_server" target= - "_top">web proxy</a> is a service, based on a software such as - <span class="APPLICATION">Privoxy</span>, that clients (i.e. browsers) - can use instead of connecting to web servers directly. The clients then - ask the proxy to request objects (web pages, images, movies etc) on - their behalf and to forward the data to the clients. It is a - <span class="QUOTE">"go-between"</span>. For details, see <a href= - "http://en.wikipedia.org/wiki/Proxy_server" target="_top">Wikipedia's - proxy definition</a>.</p> - - <p>There are many reasons to use web proxies, such as security - (firewalling), efficiency (caching) and others, and there are any - number of proxies to accommodate those needs.</p> - - <p><span class="APPLICATION">Privoxy</span> is a proxy that is - primarily focused on privacy enhancement, ad and junk elimination and - freeing the user from restrictions placed on his activities. Sitting - between your browser(s) and the Internet, it is in a perfect position - to filter outbound personal information that your browser is leaking, - as well as inbound junk. It uses a variety of techniques to do this, - all of which are under your complete control via the various - configuration files and options. Being a proxy also makes it easier to - share configurations among multiple browsers and/or users.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="OTHERSTUFF" id="OTHERSTUFF">1.4. Does - Privoxy do anything more than ad blocking?</a></h3> - - <p>Yes, ad blocking is but one possible use. There are many, many ways - <span class="APPLICATION">Privoxy</span> can be used to sanitize and - customize web browsing.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="NEWJB" id="NEWJB">1.5. What is this new - version of <span class="QUOTE">"Junkbuster"</span>?</a></h3> - - <p>A long time ago, there was the <a href= - "http://www.junkbusters.com/ijb.html" target="_top"><span class= - "APPLICATION">Internet Junkbuster</span></a>, by Anonymous Coders and - <a href="http://www.junkbusters.com/" target="_top">Junkbusters - Corporation</a>. This saved many users a lot of pain in the early days - of web advertising and user tracking.</p> - - <p>But the web, its protocols and standards, and with it, the - techniques for forcing ads on users, give up autonomy over their - browsing, and for tracking them, keeps evolving. Unfortunately, the - <span class="APPLICATION">Internet Junkbuster</span> did not. Version - 2.0.2, published in 1998, was (and is) the last official <a href= - "http://www.junkbusters.com/ijbdist.html#release" target= - "_top">release</a> available from <a href="http://www.junkbusters.com" - target="_top">Junkbusters Corporation</a>. Fortunately, it had been - released under the GNU <a href= - "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target= - "_top">GPL</a>, which allowed further development by others.</p> - - <p>So Stefan Waldherr started maintaining an improved version of the - software, to which eventually a number of people contributed patches. - It could already replace banners with a transparent image, and had a - first version of pop-up killing, but it was still very closely based on - the original, with all its limitations, such as the lack of HTTP/1.1 - support, flexible per-site configuration, or content modification. The - last release from this effort was version 2.0.2-10, published in - 2000.</p> - - <p>Then, some <a href= - "http://www.privoxy.org/user-manual/copyright.html#AUTHORS" target= - "_top">developers</a> picked up the thread, and started turning the - software inside out, upside down, and then reassembled it, adding many - <a href="http://www.privoxy.org/user-manual/introduction.html#FEATURES" - target="_top">new features</a> along the way.</p> - - <p>The result of this is <span class="APPLICATION">Privoxy</span>, - whose first stable version, 3.0, was released August, 2002.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN85" id="AEN85">1.6. Why <span class= - "QUOTE">"Privoxy"</span>? Why change the name from Junkbuster at - all?</a></h3> - - <p>Though outdated, <a href="http://junkbusters.com/" target= - "_top">Junkbusters Corporation</a> continues to offer their original - version of the <span class="APPLICATION">Internet Junkbuster</span>, so - publishing our <span class="APPLICATION">Junkbuster</span>-derived - software under the same name led to confusion.</p> - - <p>There are also potential legal complications from our use of the - <span class="APPLICATION">Junkbuster</span> name, which is a registered - trademark of <a href="http://junkbusters.com/" target= - "_top">Junkbusters Corporation</a>. There are, however, no objections - from Junkbusters Corporation to the <span class= - "APPLICATION">Privoxy</span> project itself, and they, in fact, still - share our ideals and goals.</p> - - <p>The developers also believed that there are so many improvements - over the original code, that it was time to make a clean break from the - past and make a name in their own right.</p> - - <p><span class="APPLICATION">Privoxy</span> is the <span class= - "QUOTE">"<span class="emphasis EMPHASIS c2">Privacy Enhancing - Proxy</span>"</span>. Also, its content modification and junk - suppression gives <span class="emphasis EMPHASIS c2">you</span>, the - user, more control, more freedom, and allows you to browse your - personal and <span class="QUOTE">"<span class= - "emphasis EMPHASIS c2">private</span> edition"</span> of the web.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="DIFFERS" id="DIFFERS">1.7. How does Privoxy - differ from the old Junkbuster?</a></h3> - - <p><span class="APPLICATION">Privoxy</span> picks up where <span class= - "APPLICATION">Junkbuster</span> left off. The new <span class= - "APPLICATION">Privoxy</span> still blocks ads and banners, still - manages <a href="http://en.wikipedia.org/wiki/Browser_cookie" target= - "_top">cookies</a>, and still helps protect your privacy. But, most of - these features have been enhanced, and many new ones have been added, - all in the same vein.</p> - - <p><span class="APPLICATION">Privoxy</span>'s new features include:</p> - - <ul> - <li> - <p>Supports "Connection: keep-alive". Outgoing connections can be - kept alive independently from the client.</p> - </li> - - <li> - <p>Supports IPv6, provided the operating system does so too, and - the configure script detects it.</p> - </li> - - <li> - <p>Supports tagging which allows to change the behaviour based on - client and server headers.</p> - </li> - - <li> - <p>Can be run as an "intercepting" proxy, which obviates the need - to configure browsers individually.</p> - </li> - - <li> - <p>Sophisticated actions and filters for manipulating both server - and client headers.</p> - </li> - - <li> - <p>Can be chained with other proxies.</p> - </li> - - <li> - <p>Integrated browser-based configuration and control utility at - <a href="http://config.privoxy.org/" target= - "_top">http://config.privoxy.org/</a> (shortcut: <a href= - "http://p.p/" target="_top">http://p.p/</a>). Browser-based tracing - of rule and filter effects. Remote toggling.</p> - </li> - - <li> - <p>Web page filtering (text replacements, removes banners based on - size, invisible <span class="QUOTE">"web-bugs"</span> and HTML - annoyances, etc.)</p> - </li> - - <li> - <p>Modularized configuration that allows for standard settings and - user settings to reside in separate files, so that installing - updated actions files won't overwrite individual user settings.</p> - </li> - - <li> - <p>Support for Perl Compatible Regular Expressions in the - configuration files, and a more sophisticated and flexible - configuration syntax.</p> - </li> - - <li> - <p>GIF de-animation.</p> - </li> - - <li> - <p>Bypass many click-tracking scripts (avoids script - redirection).</p> - </li> - - <li> - <p>User-customizable HTML templates for most proxy-generated pages - (e.g. "blocked" page).</p> - </li> - - <li> - <p>Auto-detection and re-reading of config file changes.</p> - </li> - - <li> - <p>Most features are controllable on a per-site or per-location - basis.</p> - </li> - - <li> - <p>Many smaller new features added, limitations and bugs - removed.</p> - </li> - </ul> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="WHATSANAD" id="WHATSANAD">1.8. How does - Privoxy know what is an ad, and what is not?</a></h3> - - <p><span class="APPLICATION">Privoxy</span>'s approach to blocking ads - is twofold:</p> - - <p>First, there are certain patterns in the <span class= - "emphasis EMPHASIS c2">locations</span> (URLs) of banner images. This - applies to both the path (you wouldn't guess how many web sites serve - their banners from a directory called <span class= - "QUOTE">"banners"</span>!) and the host (blocking the big banner - hosting services like doublecklick.net already helps a lot). - <span class="APPLICATION">Privoxy</span> takes advantage of this fact - by using <a href="../user-manual/actions-file.html#AF-PATTERNS" target= - "_top">URL patterns</a> to sort out and block the requests for things - that sound like they would be ads or banners.</p> - - <p>Second, banners tend to come in certain <span class= - "emphasis EMPHASIS c2">sizes</span>. But you can't tell the size of an - image by its URL without downloading it, and if you do, it's too late - to save bandwidth. Therefore, <span class="APPLICATION">Privoxy</span> - also inspects the HTML sources of web pages while they are loaded, and - replaces references to images with standard banner sizes by dummy - references, so that your browser doesn't request them anymore in the - first place.</p> - - <p>Both of this involves a certain amount of guesswork and is, of - course, freely and readily configurable.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN163" id="AEN163">1.9. Can Privoxy make - mistakes? This does not sound very scientific.</a></h3> - - <p>Actually, it's a black art ;-) And yes, it is always possible to - have a broad rule accidentally block or change something by mistake. - You will almost surely run into such situations at some point. It is - tricky writing rules to cover every conceivable possibility, and not - occasionally get false positives.</p> - - <p>But this should not be a big concern since the <span class= - "APPLICATION">Privoxy</span> configuration is very flexible, and - includes tools to help identify these types of situations so they can - be addressed as needed, allowing you to customize your installation. - (<a href="trouble.html#BADSITE">See the Troubleshooting section - below</a>.)</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN169" id="AEN169">1.10. Will I have to - configure Privoxy before I can use it?</a></h3> - - <p>That depends on your expectations. The default installation should - give you a good starting point, and block <span class= - "emphasis EMPHASIS c2">most</span> ads and unwanted content, but many - of the more advanced features are off by default, and require you to - activate them.</p> - - <p>You do have to set up your browser to use <span class= - "APPLICATION">Privoxy</span> (see the <a href= - "installation.html#FIRSTSTEP">Installation section below</a>).</p> - - <p>And you will certainly run into situations where there are false - positives, or ads not being blocked that you may not want to see. In - these cases, you would certainly benefit by customizing <span class= - "APPLICATION">Privoxy's</span> configuration to more closely match your - individual situation. And we encourage you to do this. This is where - the real power of <span class="APPLICATION">Privoxy</span> lies!</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="LAN" id="LAN">1.11. Can Privoxy run as a - server on a network?</a></h3> - - <p>Yes, <span class="APPLICATION">Privoxy</span> runs as a server - already, and can easily be configured to <span class= - "QUOTE">"serve"</span> more than one client. See <a href= - "configuration.html#LANCONFIG">How can I set up Privoxy to act as a - proxy for my LAN</a> below.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="BROWSERS2" id="BROWSERS2">1.12. My browser - does the same things as Privoxy. Why should I use Privoxy at - all?</a></h3> - - <p>Modern browsers do indeed have <span class= - "emphasis EMPHASIS c2">some</span> of the same functionality as - <span class="APPLICATION">Privoxy</span>. Maybe this is adequate for - you. But <span class="APPLICATION">Privoxy</span> is very versatile and - powerful, and can probably do a number of things your browser just - can't.</p> - - <p>In addition, a proxy is good choice if you use multiple browsers, or - have a LAN with multiple computers since <span class= - "APPLICATION">Privoxy</span> can run as a server application. This way - all the configuration is in one place, and you don't have to maintain a - similar configuration for possibly many browsers or users.</p> - - <p>Note, however, that it's recommended to leverage both your browser's - and <span class="APPLICATION">Privoxy's</span> privacy enhancing - features at the same time. While your browser probably lacks some - features <span class="APPLICATION">Privoxy</span> offers, it should - also be able to do some things more reliable, for example restricting - and suppressing JavaScript.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="WHYTRUST" id="WHYTRUST">1.13. Why should I - trust Privoxy?</a></h3> - - <p>The most important reason is because you have access to <span class= - "emphasis EMPHASIS c2">everything</span>, and you can control - everything. You can check every line of every configuration file - yourself. You can check every last bit of source code should you - desire. And even if you can't read code, there should be some comfort - in knowing that other people can, and do read it. You can build the - software from scratch, if you want, so that you know the executable is - clean, and that it is <span class="emphasis EMPHASIS c2">yours</span>. - In fact, we encourage this level of scrutiny. It is one reason we use - <span class="APPLICATION">Privoxy</span> ourselves.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="LICENSE" id="LICENSE">1.14. Is there is a - license or fee? What about a warranty? Registration?</a></h3> - - <p><span class="APPLICATION">Privoxy</span> is free software and - licensed under the <a href= - "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target= - "_top">GNU General Public License (GPL) version 2</a>. It is free to - use, copy, modify or distribute as you wish under the terms of this - license. Please see the <a href="copyright.html">Copyright</a> section - for more information on the license and copyright. Or the <tt class= - "FILENAME">LICENSE</tt> file that should be included.</p> - - <p>There is <span class="emphasis EMPHASIS c2">no warranty</span> of - any kind, expressed, implied or otherwise. That is something that would - cost real money ;-) There is no registration either.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="SPYWARE" id="SPYWARE">1.15. Can Privoxy - remove spyware? Adware? Viruses?</a></h3> - - <p>No, at least not reliably enough to trust it. <span class= - "APPLICATION">Privoxy</span> is not designed to be a malware removal - tool and the default configuration doesn't even try to filter out any - malware.</p> - - <p><span class="APPLICATION">Privoxy</span> could help prevent contact - from (known) sites that use such tactics with appropriate configuration - rules, and thus could conceivably prevent contamination from such - sites. However, keeping such a configuration up to date would require a - lot of time and effort that would be better spend on keeping your - software itself up to date so it doesn't have known - vulnerabilities.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="OTHERADS" id="OTHERADS">1.16. Can I use - Privoxy with other ad-blocking software?</a></h3> - - <p><span class="APPLICATION">Privoxy</span> should work fine with other - proxies and other software in general.</p> - - <p>But it is probably not necessary to use <span class= - "APPLICATION">Privoxy</span> in conjunction with other ad-blocking - products, and this could conceivably cause undesirable results. It - might be better to choose one software or the other and work a little - to tweak its configuration to your liking.</p> - - <p>Note that this is an advice specific to ad blocking.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="HELP-THE-DEVELOPERS" id= - "HELP-THE-DEVELOPERS">1.17. I would like to help you, what can I - do?</a></h3> - - <div class="SECT3"> - <h4 class="SECT3"><a name="PARTICIPATE" id="PARTICIPATE">1.17.1. - Would you like to participate?</a></h4> - - <p>Well, we <span class="emphasis EMPHASIS c2">always</span> need - help. There is something for everybody who wants to help us. We - welcome new developers, packagers, testers, documentation writers or - really anyone with a desire to help in any way. You <span class= - "emphasis EMPHASIS c2">DO NOT</span> need to be a <span class= - "QUOTE">"programmer"</span>. There are many other tasks available. In - fact, the programmers often can't spend as much time programming - because of some of the other, more mundane things that need to be - done, like checking the Tracker feedback sections or responding to - user questions on the mailing lists.</p> - - <p>So first thing, subscribe to the <a href= - "https://lists.sourceforge.net/lists/listinfo/ijbswa-users" target= - "_top">Privoxy Users</a> or the <a href= - "https://lists.sourceforge.net/lists/listinfo/ijbswa-developers" - target="_top">Privoxy Developers</a> mailing list, join the - discussion, help out other users, provide general feedback or report - problems you noticed.</p> - - <p>If you intend to help out with the trackers, you also might want - to <a href="https://sourceforge.net/account/register.php" target= - "_top">get an account on SourceForge.net</a> so we don't confuse you - with the other name-less users.</p> - - <p>We also have a <a href="../developer-manual/index.html" target= - "_top">Developer's Manual</a>. While it is partly out of date, it's - still worth reading.</p> - - <p>Our <a href= - "http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/current/TODO?view=markup" - target="_top">TODO list</a> may be of interest to you as well. Please - let us know if you want to work on one of the items listed.</p> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="DONATE" id="DONATE">1.17.2. Would you like - to donate?</a></h4> - - <p><span class="APPLICATION">Privoxy</span> is developed by unpaid - volunteers and thus our current running costs are pretty low. - Nevertheless, we have plans that will cost money in the future. They - include, but aren't limited to spending money on:</p> - - <ul> - <li> - <p>Hardware to help make sure <span class= - "APPLICATION">Privoxy</span> keeps running on platforms the - developers currently can't test on and can be ported to - others.</p> - </li> - - <li> - <p>Technical books to educate our developers about said platforms - or to improve their knowledge in general.</p> - </li> - - <li> - <p>More reliable hosting,</p> - </li> - </ul> - - <p>We would like to get this money through donations made by our - users.</p> - - <p><span class="APPLICATION">Privoxy</span> has therefore become an - associated project of <a href= - "http://www.spi-inc.org/about-spi/about-spi" target="_top">Software - in the Public Interest (SPI)</a>, which allows us to receive - donations. In the United States they are tax-deductible, in a few - other western countries they might be tax-deductible in the - future.</p> - - <p>If you read this section before you may notice that paying for the - project domain privoxy.org is no longer on the list. It has been - transferred to SPI is sponsored by Mythic Beasts Ltd.</p> - - <p>If you enjoy our software and feel like helping out with a - donation, please have a look at <a href= - "http://www.spi-inc.org/donations" target="_top">SPI's donation - page</a> to see what the options are. If you have any questions - regarding donations please mail to either the public user mailing - list or, if it's a private matter, to <a href= - "mailto:fk@fabiankeil.de" target="_top">Fabian Keil</a> (Privoxy's - SPI liason) directly.</p> - </div> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="index.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href= - "installation.html" accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Privoxy Frequently Asked - Questions</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Installation</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>General Information</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Frequently Asked Questions" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Privoxy Frequently Asked Questions" +HREF="index.html"><LINK +REL="NEXT" +TITLE="Installation" +HREF="installation.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Frequently Asked Questions</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="index.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="installation.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="GENERAL" +>1. General Information</A +></H1 +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="WHO-USES" +>1.1. Who should give <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> a try?</A +></H3 +><P +> Anyone who is interested in security, privacy, or in + finer-grained control over their web and Internet experience. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="BESTCHOICE" +>1.2. Is Privoxy the best choice for +me?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is certainly a good choice, especially for those who want more + control and security. Those with the willingness to read the documentation + and the ability to fine-tune their installation will benefit the most. + </P +><P +> One of <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + strengths is that it is highly configurable giving you the ability to + completely personalize your installation. Being familiar with, or at least + having an interest in learning about <A +HREF="http://en.wikipedia.org/wiki/Http" +TARGET="_top" +>HTTP</A +> and other networking + protocols, <A +HREF="http://en.wikipedia.org/wiki/Html" +TARGET="_top" +>HTML</A +>, and + <A +HREF="http://en.wikipedia.org/wiki/Regular_expressions" +TARGET="_top" +><SPAN +CLASS="QUOTE" +>"Regular + Expressions"</SPAN +></A +> + will be a big plus and will help you get the most out of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + A new installation just includes a very basic configuration. The user + should take this as a starting point only, and enhance it as he or she + sees fit. In fact, the user is encouraged, and expected to, fine-tune the + configuration. + </P +><P +> Much of <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> configuration can be done + with a <A +HREF="http://en.wikipedia.org/wiki/Web_browser" +TARGET="_top" +>Web browser</A +>. + But there are areas where configuration is done using a + <A +HREF="http://en.wikipedia.org/wiki/Text_editors" +TARGET="_top" +>text editor</A +> + to edit configuration files. Also note that the web-based action editor + doesn't use authentication and should only be enabled in environments + where all clients with access to <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> listening port can be trusted. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="PROXYMORON" +>1.3. What is a <SPAN +CLASS="QUOTE" +>"proxy"</SPAN +>? How does +Privoxy work?</A +></H3 +><P +> A <A +HREF="http://en.wikipedia.org/wiki/Proxy_server" +TARGET="_top" +>web proxy</A +> + is a service, based on a software such as <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, that clients + (i.e. browsers) can use instead of connecting to web servers directly. + The clients then ask the proxy to request objects (web pages, images, movies etc) + on their behalf and to forward the data to the clients. + It is a <SPAN +CLASS="QUOTE" +>"go-between"</SPAN +>. For details, see + <A +HREF="http://en.wikipedia.org/wiki/Proxy_server" +TARGET="_top" +>Wikipedia's proxy definition</A +>. + </P +><P +> There are many reasons to use web proxies, such as security (firewalling), + efficiency (caching) and others, and there are any number of proxies + to accommodate those needs. + </P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is a proxy that is primarily focused on + privacy enhancement, ad and junk elimination and freeing the user from + restrictions placed on his activities. Sitting between your browser(s) and the Internet, + it is in a perfect position to filter outbound personal information that your + browser is leaking, as well as inbound junk. It uses a variety of techniques to do + this, all of which are under your complete control via the various configuration + files and options. Being a proxy also makes it easier to share + configurations among multiple browsers and/or users. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="OTHERSTUFF" +>1.4. Does Privoxy do anything more than ad blocking?</A +></H3 +><P +> + Yes, ad blocking is but one possible use. There are many, many ways <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + can be used to sanitize and customize web browsing. </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="NEWJB" +>1.5. What is this new version of +<SPAN +CLASS="QUOTE" +>"Junkbuster"</SPAN +>?</A +></H3 +><P +> A long time ago, there was the + <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +><SPAN +CLASS="APPLICATION" +>Internet Junkbuster</SPAN +></A +>, + by Anonymous Coders and <A +HREF="http://www.junkbusters.com/" +TARGET="_top" +>Junkbusters + Corporation</A +>. This saved many users a lot of pain in the early days of + web advertising and user tracking.</P +><P +> But the web, its protocols and standards, and with it, the techniques for + forcing ads on users, give up autonomy over their browsing, and + for tracking them, keeps evolving. Unfortunately, the <SPAN +CLASS="APPLICATION" +>Internet + Junkbuster</SPAN +> did not. Version 2.0.2, published in 1998, was + (and is) the last official + <A +HREF="http://www.junkbusters.com/ijbdist.html#release" +TARGET="_top" +>release</A +> + available from <A +HREF="http://www.junkbusters.com" +TARGET="_top" +>Junkbusters Corporation</A +>. + Fortunately, it had been released under the GNU + <A +HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" +TARGET="_top" +>GPL</A +>, + which allowed further development by others.</P +><P +> So Stefan Waldherr started maintaining an improved version of the + software, to which eventually a number of people contributed patches. + It could already replace banners with a transparent image, and had a first + version of pop-up killing, but it was still very closely based on the + original, with all its limitations, such as the lack of HTTP/1.1 support, + flexible per-site configuration, or content modification. The last release + from this effort was version 2.0.2-10, published in 2000.</P +><P +> Then, some + <A +HREF="http://www.privoxy.org/user-manual/copyright.html#AUTHORS" +TARGET="_top" +>developers</A +> + picked up the thread, and started turning the software inside out, upside down, + and then reassembled it, adding many + <A +HREF="http://www.privoxy.org/user-manual/introduction.html#FEATURES" +TARGET="_top" +>new + features</A +> along the way.</P +><P +> The result of this is <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, whose first + stable version, 3.0, was released August, 2002. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN78" +>1.6. Why <SPAN +CLASS="QUOTE" +>"Privoxy"</SPAN +>? Why change the name from +Junkbuster at all?</A +></H3 +><P +> Though outdated, <A +HREF="http://junkbusters.com/" +TARGET="_top" +>Junkbusters Corporation</A +> + continues to offer their original version of the <SPAN +CLASS="APPLICATION" +>Internet + Junkbuster</SPAN +>, so publishing our + <SPAN +CLASS="APPLICATION" +> Junkbuster</SPAN +>-derived software under the same name + led to confusion.</P +><P +> There are also potential legal complications from our use of the + <SPAN +CLASS="APPLICATION" +>Junkbuster</SPAN +> name, which is a registered trademark of + <A +HREF="http://junkbusters.com/" +TARGET="_top" +>Junkbusters Corporation</A +>. + There are, however, no objections from Junkbusters Corporation to the + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> project itself, and they, in fact, still + share our ideals and goals.</P +><P +> The developers also believed that there are so many improvements over the original + code, that it was time to make a clean break from the past and make + a name in their own right.</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is the + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Privacy Enhancing Proxy</I +></SPAN +>"</SPAN +>. Also, its content + modification and junk suppression gives <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>you</I +></SPAN +>, the user, more + control, more freedom, and allows you to browse your personal and + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>private</I +></SPAN +> edition"</SPAN +> of the web.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="DIFFERS" +>1.7. How does Privoxy differ +from the old Junkbuster?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> picks up where + <SPAN +CLASS="APPLICATION" +>Junkbuster</SPAN +> left off. + The new <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> still blocks ads and banners, + still manages <A +HREF="http://en.wikipedia.org/wiki/Browser_cookie" +TARGET="_top" +>cookies</A +>, and still + helps protect your privacy. But, most of these features have been enhanced, + and many new ones have been added, all in the same vein. + </P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s new features include:</P +><P +> <P +></P +><UL +><LI +><P +> Can keep outgoing connections alive and reuse them later on. + </P +></LI +><LI +><P +> Supports tagging which allows to change the behaviour + based on client and server headers. + </P +></LI +><LI +><P +> Can be run as an "intercepting" proxy, which obviates the need to + configure browsers individually. + </P +></LI +><LI +><P +> Sophisticated actions and filters for manipulating both server and client + headers. + </P +></LI +><LI +><P +> Can be chained with other proxies. + </P +></LI +><LI +><P +> Integrated browser based configuration and control utility at <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>http://config.privoxy.org/</A +> + (shortcut: <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +>). Browser-based + tracing of rule and filter effects. Remote toggling. + </P +></LI +><LI +><P +> Web page filtering (text replacements, removes banners based on size, + invisible <SPAN +CLASS="QUOTE" +>"web-bugs"</SPAN +>, JavaScript and HTML annoyances, + pop-up windows, etc.) + </P +></LI +><LI +><P +> Modularized configuration that allows for standard settings and + user settings to reside in separate files, so that installing updated + actions files won't overwrite individual user settings. + </P +></LI +><LI +><P +> Support for Perl Compatible Regular Expressions in the configuration files, and + a more sophisticated and flexible configuration syntax. + </P +></LI +><LI +><P +> Improved cookie management features (e.g. session based cookies). + </P +></LI +><LI +><P +> GIF de-animation. + </P +></LI +><LI +><P +> Bypass many click-tracking scripts (avoids script redirection). + </P +></LI +><LI +><P +> Multi-threaded (POSIX and native threads). + </P +></LI +><LI +><P +> User-customizable HTML templates for most proxy-generated pages (e.g. "blocked" page). + </P +></LI +><LI +><P +> Auto-detection and re-reading of config file changes. + </P +></LI +><LI +><P +> Improved signal handling, and a true daemon mode (Unix). + </P +></LI +><LI +><P +> Every feature now controllable on a per-site or per-location basis, configuration + more powerful and versatile over-all. + </P +></LI +><LI +><P +> Many smaller new features added, limitations and bugs removed. + </P +></LI +></UL +></P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="WHATSANAD" +>1.8. How does Privoxy know what is +an ad, and what is not?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s approach to blocking ads is twofold:</P +><P +> First, there are certain patterns in the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>locations</I +></SPAN +> (URLs) + of banner images. This applies to both the path (you wouldn't guess how many + web sites serve their banners from a directory called <SPAN +CLASS="QUOTE" +>"banners"</SPAN +>!) + and the host (blocking the big banner hosting services like doublecklick.net + already helps a lot). <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> takes advantage of this + fact by using <A +HREF="../user-manual/actions-file.html#AF-PATTERNS" +TARGET="_top" +>URL + patterns</A +> to sort out and block the requests for things that sound + like they would be ads or banners.</P +><P +> Second, banners tend to come in certain <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>sizes</I +></SPAN +>. But you + can't tell the size of an image by its URL without downloading it, and if you + do, it's too late to save bandwidth. Therefore, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + also inspects the HTML sources of web pages while they are loaded, and replaces + references to images with standard banner sizes by dummy references, so that + your browser doesn't request them anymore in the first place.</P +><P +> Both of this involves a certain amount of guesswork and is, of course, freely + and readily configurable.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN160" +>1.9. Can Privoxy make mistakes? +This does not sound very scientific.</A +></H3 +><P +> Actually, it's a black art ;-) And yes, it is always possible to have a broad + rule accidentally block or change something by mistake. You will almost surely + run into such situations at some point. It is tricky writing rules to + cover every conceivable possibility, and not occasionally get false positives.</P +><P +> But this should not be a big concern since the + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> configuration is very flexible, and + includes tools to help identify these types of situations so they can be + addressed as needed, allowing you to customize your installation. + (<A +HREF="trouble.html#BADSITE" +>See the Troubleshooting section below</A +>.)</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN166" +>1.10. Will I have to configure Privoxy + before I can use it?</A +></H3 +><P +> That depends on your expectations. + The default installation should give you a good starting + point, and block <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>most</I +></SPAN +> ads and unwanted content, + but many of the more advanced features are off by default, and require + you to activate them. </P +><P +> You do have to set up your browser to use + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> (see the <A +HREF="installation.html#FIRSTSTEP" +>Installation section below</A +>). </P +><P +> And you will certainly run into situations where there are false positives, + or ads not being blocked that you may not want to see. In these cases, you + would certainly benefit by customizing <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + configuration to more closely match your individual situation. And we + encourage you to do this. This is where the real power of + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> lies!</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="LAN" +>1.11. Can Privoxy run as a server on a network?</A +></H3 +><P +> + Yes, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> runs as a server already, and can easily be configured to + <SPAN +CLASS="QUOTE" +>"serve"</SPAN +> more than one client. See <A +HREF="configuration.html#LANCONFIG" +> How can I set up Privoxy to act as a proxy for my LAN</A +> below.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="BROWSERS2" +>1.12. My browser does the same things as +Privoxy. Why should I use Privoxy at all?</A +></H3 +><P +> Modern browsers do indeed have <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>some</I +></SPAN +> of the same + functionality as <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. Maybe this is + adequate for you. But <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is very + versatile and powerful, and can probably do a number of things + your browser just can't. + </P +><P +> In addition, a proxy is good choice if you use multiple browsers, or + have a LAN with multiple computers since <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can run as a server + application. This way all the configuration is in one place, and you don't + have to maintain a similar configuration for possibly many browsers or + users. + </P +><P +> Note, however, that it's recommended to leverage both your browser's + and <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> privacy enhancing features + at the same time. While your browser probably lacks some features + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> offers, it should also be able to do some things more + reliable, for example restricting and suppressing JavaScript. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="WHYTRUST" +>1.13. Why should I trust Privoxy?</A +></H3 +><P +> The most important reason is because you have access to + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>everything</I +></SPAN +>, and you can control everything. You can + check every line of every configuration file yourself. You can check every + last bit of source code should you desire. And even if you can't read code, + there should be some comfort in knowing that other people can, + and do read it. You can build the software from scratch, if you want, + so that you know the executable is clean, and that it is + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>yours</I +></SPAN +>. In fact, we encourage this level of scrutiny. It + is one reason we use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> ourselves. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="LICENSE" +>1.14. Is there is a license or fee? What about a +warranty? Registration?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is free software and licensed under the <A +HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" +TARGET="_top" +>GNU General Public License (GPL) version 2</A +>. + It is free to use, copy, modify or distribute as you wish under the terms of this + license. Please see the <A +HREF="copyright.html" +>Copyright</A +> section for more + information on the license and copyright. Or the <TT +CLASS="FILENAME" +>LICENSE</TT +> file + that should be included. + </P +><P +> There is <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>no warranty</I +></SPAN +> of any kind, expressed, implied or otherwise. + That is something that would cost real money ;-) There is no registration either. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="SPYWARE" +>1.15. Can Privoxy remove spyware? Adware? Viruses?</A +></H3 +><P +> No, at least not reliably enough to trust it. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is not designed to be + a malware removal tool and the default configuration doesn't even try to + filter out any malware.</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> could help prevent contact from (known) sites that use such + tactics with appropriate configuration rules, and thus could conceivably + prevent contamination from such sites. However, keeping such a configuration + up to date would require a lot of time and effort that would be better spend + on keeping your software itself up to date so it doesn't have known + vulnerabilities.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="OTHERADS" +>1.16. Can I use Privoxy with other ad-blocking software?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> should work fine with other proxies and other software in general.</P +><P +> But it is probably not necessary to use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> in conjunction with other + ad-blocking products, and this could conceivably cause undesirable results. + It might be better to choose one software or the other and work a little to + tweak its configuration to your liking.</P +><P +> Note that this is an advice specific to ad blocking.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="JOINTEAM" +>1.17. I would like to help you, what can I do?</A +></H3 +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="JOINTEAM-WORK" +>1.17.1. Would you like to participate?</A +></H4 +><P +> Well, we <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>always</I +></SPAN +> need help. There is something for + everybody who wants to help us. We welcome new developers, packagers, + testers, documentation writers or really anyone with a desire to help in + any way. You <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>DO NOT</I +></SPAN +> need to be a + <SPAN +CLASS="QUOTE" +>"programmer"</SPAN +>. There are many other tasks available. In fact, + the programmers often can't spend as much time programming because of some + of the other, more mundane things that need to be done, like checking the + Tracker feedback sections. + </P +><P +> So first thing, <A +HREF="https://sourceforge.net/account/register.php" +TARGET="_top" +>get an account on SourceForge.net</A +> + and mail your id to the <A +HREF="mailto:ijbswa-developers@lists.sourceforge.net" +TARGET="_top" +>developers + mailing list</A +>. Then, please read the <A +HREF="../developer-manual/index.html" +TARGET="_top" +>Developer's Manual</A +>, at least + the pertinent sections.</P +><P +> You can also start helping out without SourceForge.net account, + simply by showing up on the mailing list, helping out other users, + providing general feedback or reporting problems you noticed. + </P +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="DONATE" +>1.17.2. Would you like to donate?</A +></H4 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is developed by unpaid volunteers + and thus our current running costs are pretty low. Nevertheless, we + have plans that will cost money in the future. We would like to get + this money through donations made by our users.</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> has therefore become an associated + project of <A +HREF="http://www.spi-inc.org/about-spi/about-spi" +TARGET="_top" +>Software + in the Public Interest (SPI)</A +>, which allows us to receive tax-deductible + donations in most western countries.</P +><P +> We intend to use the donations to pay for our domain after transfering + it to SPI. Our goal is to make sure there's no single point of failure + and the bill gets paid and the site keeps running even if a some of + the currently active developers were to suddenly disappear for a while.</P +><P +> We would also like to spend some money on more reliable hosting, + on hardware to help make sure <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + keeps running on platforms the developers currently can't test on, + and on technical books to educate our developers about said platforms + or to improve their knowledge in general.</P +><P +> If you enjoy our software and feel like helping out with a donation, + please have a look at + <A +HREF="http://www.spi-inc.org/donations" +TARGET="_top" +>SPI's donation page</A +> + to see what the options are.</P +><P +></P +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Privoxy Frequently Asked Questions</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Installation</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/faq/index.html b/external/privoxy/doc/webserver/faq/index.html index 3881377..cec0d7c 100644 --- a/external/privoxy/doc/webserver/faq/index.html +++ b/external/privoxy/doc/webserver/faq/index.html @@ -1,558 +1,999 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy Frequently Asked Questions</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="NEXT" title="General Information" href="general.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - hr.c4 {text-align: left} - span.c3 {font-style: italic} - dt.c2 {font-weight: bold} - a.c1 {font-style: italic} - </style> -</head> - -<body class="ARTICLE"> - <div class="ARTICLE"> - <div class="TITLEPAGE"> - <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy Frequently Asked - Questions</a></h1> - - <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> © - 2001-2011 by <a href="http://www.privoxy.org/" target="_top">Privoxy - Developers</a></sub><br></p> - - <p class="PUBDATE">$Id: faq.sgml,v 2.84 2011/11/13 17:03:54 fabiankeil - Exp $<br></p> - - <div class="ABSTRACT"> - <a name="AEN9" id="AEN9"></a> - - <p>This FAQ gives quick answers to frequently asked questions about - <a href="http://www.privoxy.org/" target="_top">Privoxy</a>. It is - not a substitute for the <a class="CITETITLE c1" href= - "../user-manual/index.html" target="_top">Privoxy User - Manual</a>.</p> - - <p>What is Privoxy?</p> - - <p>Privoxy is a non-caching web proxy with advanced filtering - capabilities for enhancing privacy, modifying web page data and HTTP - headers, controlling access, and removing ads and other obnoxious - Internet junk. Privoxy has a flexible configuration and can be - customized to suit individual needs and tastes. It has application - for both stand-alone systems and multi-user networks.</p> - - <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p> - - <p>Privoxy is an associated project of Software in the Public - Interest (SPI).</p> - - <p>Helping hands and donations are welcome:</p> - - <ul> - <li> - <p><a href="http://www.privoxy.org/faq/general.html#PARTICIPATE" - target= - "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a></p> - </li> - - <li> - <p><a href="http://www.privoxy.org/faq/general.html#DONATE" - target= - "_top">http://www.privoxy.org/faq/general.html#DONATE</a></p> - </li> - </ul> - - <p>Please note that this document is a work in progress. This copy - represents the state at the release of version 3.0.19. You can find - the latest version of the document at <a href= - "http://www.privoxy.org/faq/" target= - "_top">http://www.privoxy.org/faq/</a>. Please see the <a href= - "contact.html">Contact section</a> if you want to contact the - developers.</p> - </div> - <hr> - </div> - - <div class="TOC"> - <dl> - <dt class="c2">Table of Contents</dt> - - <dt>1. <a href="general.html">General Information</a></dt> - - <dd> - <dl> - <dt>1.1. <a href="general.html#WHO-USES">Who should give - <span class="APPLICATION">Privoxy</span> a try?</a></dt> - - <dt>1.2. <a href="general.html#BESTCHOICE">Is Privoxy the best - choice for me?</a></dt> - - <dt>1.3. <a href="general.html#PROXYMORON">What is a <span class= - "QUOTE">"proxy"</span>? How does Privoxy work?</a></dt> - - <dt>1.4. <a href="general.html#OTHERSTUFF">Does Privoxy do - anything more than ad blocking?</a></dt> - - <dt>1.5. <a href="general.html#NEWJB">What is this new version of - <span class="QUOTE">"Junkbuster"</span>?</a></dt> - - <dt>1.6. <a href="general.html#AEN85">Why <span class= - "QUOTE">"Privoxy"</span>? Why change the name from Junkbuster at - all?</a></dt> - - <dt>1.7. <a href="general.html#DIFFERS">How does Privoxy differ - from the old Junkbuster?</a></dt> - - <dt>1.8. <a href="general.html#WHATSANAD">How does Privoxy know - what is an ad, and what is not?</a></dt> - - <dt>1.9. <a href="general.html#AEN163">Can Privoxy make mistakes? - This does not sound very scientific.</a></dt> - - <dt>1.10. <a href="general.html#AEN169">Will I have to configure - Privoxy before I can use it?</a></dt> - - <dt>1.11. <a href="general.html#LAN">Can Privoxy run as a server - on a network?</a></dt> - - <dt>1.12. <a href="general.html#BROWSERS2">My browser does the - same things as Privoxy. Why should I use Privoxy at all?</a></dt> - - <dt>1.13. <a href="general.html#WHYTRUST">Why should I trust - Privoxy?</a></dt> - - <dt>1.14. <a href="general.html#LICENSE">Is there is a license or - fee? What about a warranty? Registration?</a></dt> - - <dt>1.15. <a href="general.html#SPYWARE">Can Privoxy remove - spyware? Adware? Viruses?</a></dt> - - <dt>1.16. <a href="general.html#OTHERADS">Can I use Privoxy with - other ad-blocking software?</a></dt> - - <dt>1.17. <a href="general.html#HELP-THE-DEVELOPERS">I would like - to help you, what can I do?</a></dt> - - <dd> - <dl> - <dt>1.17.1. <a href="general.html#PARTICIPATE">Would you like - to participate?</a></dt> - - <dt>1.17.2. <a href="general.html#DONATE">Would you like to - donate?</a></dt> - </dl> - </dd> - </dl> - </dd> - - <dt>2. <a href="installation.html">Installation</a></dt> - - <dd> - <dl> - <dt>2.1. <a href="installation.html#WHICHBROWSERS">Which browsers - are supported by Privoxy?</a></dt> - - <dt>2.2. <a href="installation.html#WHICHOS">Which operating - systems are supported?</a></dt> - - <dt>2.3. <a href="installation.html#EMAIL-CLIENT">Can I use - Privoxy with my email client?</a></dt> - - <dt>2.4. <a href="installation.html#FIRSTSTEP">I just installed - Privoxy. Is there anything special I have to do now?</a></dt> - - <dt>2.5. <a href="installation.html#LOCALHOST">What is the proxy - address of Privoxy?</a></dt> - - <dt>2.6. <a href="installation.html#NOTHING">I just installed - Privoxy, and nothing is happening. All the ads are there. What's - wrong?</a></dt> - - <dt>2.7. <a href="installation.html#NOTUSED">I get a <span class= - "QUOTE">"Privoxy is not being used"</span> dummy page although - Privoxy is running and being used.</a></dt> - </dl> - </dd> - - <dt>3. <a href="configuration.html">Configuration</a></dt> - - <dd> - <dl> - <dt>3.1. <a href="configuration.html#AEN369">What exactly is an - <span class="QUOTE">"actions"</span> file?</a></dt> - - <dt>3.2. <a href="configuration.html#ACTIONSS">The <span class= - "QUOTE">"actions"</span> concept confuses me. Please list some of - these <span class="QUOTE">"actions"</span>.</a></dt> - - <dt>3.3. <a href="configuration.html#AEN392">How are actions - files configured? What is the easiest way to do this?</a></dt> - - <dt>3.4. <a href="configuration.html#AEN401">There are several - different <span class="QUOTE">"actions"</span> files. What are - the differences?</a></dt> - - <dt>3.5. <a href="configuration.html#GETUPDATES">Where can I get - updated Actions Files?</a></dt> - - <dt>3.6. <a href="configuration.html#NEWCONFIG">Can I use my old - config files?</a></dt> - - <dt>3.7. <a href="configuration.html#DIFFICULT">Why is the - configuration so complicated?</a></dt> - - <dt>3.8. <a href="configuration.html#YAHOO">How can I make my - Yahoo/Hotmail/Gmail account work?</a></dt> - - <dt>3.9. <a href="configuration.html#CONFIGFILES">What's the - difference between the <span class="QUOTE">"Cautious"</span>, - <span class="QUOTE">"Medium"</span> and <span class= - "QUOTE">"Advanced"</span> defaults?</a></dt> - - <dt>3.10. <a href="configuration.html#BROWSECONFIG">Why can I - change the configuration with a browser? Does that not raise - security issues?</a></dt> - - <dt>3.11. <a href="configuration.html#AEN489">What is the - <tt class="FILENAME">default.filter</tt> file? What is a - <span class="QUOTE">"filter"</span>?</a></dt> - - <dt>3.12. <a href="configuration.html#LANCONFIG">How can I set up - Privoxy to act as a proxy for my LAN?</a></dt> - - <dt>3.13. <a href="configuration.html#AEN540">Instead of ads, now - I get a checkerboard pattern. I don't want to see - anything.</a></dt> - - <dt>3.14. <a href="configuration.html#AEN557">Why would anybody - want to see a checkerboard pattern?</a></dt> - - <dt>3.15. <a href="configuration.html#AEN563">I see some images - being replaced with text instead of the checkerboard image. Why - and how do I get rid of this?</a></dt> - - <dt>3.16. <a href="configuration.html#SRVANY">Can Privoxy run as - a service on Win2K/NT/XP?</a></dt> - - <dt>3.17. <a href="configuration.html#OTHERPROXY">How can I make - Privoxy work with other proxies?</a></dt> - - <dt>3.18. <a href="configuration.html#PORT-80">Can I just set - Privoxy to use port 80 and thus avoid individual browser - configuration?</a></dt> - - <dt>3.19. <a href="configuration.html#TRANSPARENT">Can Privoxy - run as a <span class="QUOTE">"transparent"</span> proxy?</a></dt> - - <dt>3.20. <a href="configuration.html#INTERCEPTING">Can Privoxy - run as a <span class="QUOTE">"intercepting"</span> - proxy?</a></dt> - - <dt>3.21. <a href="configuration.html#OUTLOOK">How can I - configure Privoxy for use with Outlook?</a></dt> - - <dt>3.22. <a href="configuration.html#OUTLOOK-MORE">How can I - have separate rules just for HTML mail?</a></dt> - - <dt>3.23. <a href="configuration.html#SNEAKY-COOKIES">I sometimes - notice cookies sneaking through. How?</a></dt> - - <dt>3.24. <a href="configuration.html#EVIL-COOKIES">Are all - cookies bad? Why?</a></dt> - - <dt>3.25. <a href="configuration.html#ALLOW-COOKIES">How can I - allow permanent cookies for my trusted sites?</a></dt> - - <dt>3.26. <a href="configuration.html#MULTIPLES">Can I have - separate configurations for different users?</a></dt> - - <dt>3.27. <a href="configuration.html#WHITELISTS">Can I set-up - Privoxy as a whitelist of <span class="QUOTE">"good"</span> - sites?</a></dt> - - <dt>3.28. <a href="configuration.html#NO-ADBLOCK">How can I turn - off ad-blocking?</a></dt> - - <dt>3.29. <a href="configuration.html#TEMPLATES">How can I have - custom template pages, like the <span class= - "emphasis EMPHASIS c3">BLOCKED</span> page?</a></dt> - - <dt>3.30. <a href="configuration.html#BLOCKALL">How can I remove - the <span class="QUOTE">"Go There Anyway"</span> link from the - <span class="emphasis EMPHASIS c3">BLOCKED</span> page?</a></dt> - </dl> - </dd> - - <dt>4. <a href="misc.html">Miscellaneous</a></dt> - - <dd> - <dl> - <dt>4.1. <a href="misc.html#AEN738">How much does Privoxy slow my - browsing down? This has to add extra time to browsing.</a></dt> - - <dt>4.2. <a href="misc.html#LOADINGTIMES">I notice considerable - delays in page requests. What's wrong?</a></dt> - - <dt>4.3. <a href="misc.html#CONFIGURL">What are - "http://config.privoxy.org/" and "http://p.p/"?</a></dt> - - <dt>4.4. <a href="misc.html#NEWADS">How can I submit new ads, or - report problems?</a></dt> - - <dt>4.5. <a href="misc.html#NEWADS2">If I do submit missed ads, - will they be included in future updates?</a></dt> - - <dt>4.6. <a href="misc.html#NOONECARES">Why doesn't anyone answer - my support request?</a></dt> - - <dt>4.7. <a href="misc.html#IP">How can I hide my IP - address?</a></dt> - - <dt>4.8. <a href="misc.html#AEN803">Can Privoxy guarantee I am - anonymous?</a></dt> - - <dt>4.9. <a href="misc.html#AEN821">A test site says I am not - using a Proxy.</a></dt> - - <dt>4.10. <a href="misc.html#TOR">How do I use Privoxy together - with Tor?</a></dt> - - <dt>4.11. <a href="misc.html#AEN877">Might some things break - because header information or content is being altered?</a></dt> - - <dt>4.12. <a href="misc.html#AEN891">Can Privoxy act as a - <span class="QUOTE">"caching"</span> proxy to speed up web - browsing?</a></dt> - - <dt>4.13. <a href="misc.html#AEN901">What about as a firewall? - Can Privoxy protect me?</a></dt> - - <dt>4.14. <a href="misc.html#AEN906">I have large empty spaces / - a checkerboard pattern now where ads used to be. Why?</a></dt> - - <dt>4.15. <a href="misc.html#AEN914">How can Privoxy filter - Secure (HTTPS) URLs?</a></dt> - - <dt>4.16. <a href="misc.html#AEN928">Privoxy runs as a - <span class="QUOTE">"server"</span>. How secure is it? Do I need - to take any special precautions?</a></dt> - - <dt>4.17. <a href="misc.html#TURNOFF">Can I temporarily disable - Privoxy?</a></dt> - - <dt>4.18. <a href="misc.html#REALLYOFF">When <span class= - "QUOTE">"disabled"</span> is Privoxy totally out of the - picture?</a></dt> - - <dt>4.19. <a href="misc.html#TURNOFF2">How can I tell Privoxy to - totally ignore certain sites?</a></dt> - - <dt>4.20. <a href="misc.html#CRUNCH">My logs show Privoxy - <span class="QUOTE">"crunches"</span> ads, but also its own - internal CGI pages. What is a <span class= - "QUOTE">"crunch"</span>?</a></dt> - - <dt>4.21. <a href="misc.html#DOWNLOADS">Can Privoxy effect files - that I download from a webserver? FTP server?</a></dt> - - <dt>4.22. <a href="misc.html#DOWNLOADS2">I just downloaded a Perl - script, and Privoxy altered it! Yikes, what is wrong!</a></dt> - - <dt>4.23. <a href="misc.html#HOSTSFILE">Should I continue to use - a <span class="QUOTE">"HOSTS"</span> file for - ad-blocking?</a></dt> - - <dt>4.24. <a href="misc.html#SEEALSO">Where can I find more - information about Privoxy and related issues?</a></dt> - - <dt>4.25. <a href="misc.html#MICROSUCK">I've noticed that Privoxy - changes <span class="QUOTE">"Microsoft"</span> to <span class= - "QUOTE">"MicroSuck"</span>! Why are you manipulating my - browsing?</a></dt> - - <dt>4.26. <a href="misc.html#VALID">Does Privoxy produce - <span class="QUOTE">"valid"</span> HTML (or XHTML)?</a></dt> - - <dt>4.27. <a href="misc.html#SURPRISE-PRIVOXY">How did you manage - to get Privoxy on my computer without my consent?</a></dt> - </dl> - </dd> - - <dt>5. <a href="trouble.html">Troubleshooting</a></dt> - - <dd> - <dl> - <dt>5.1. <a href="trouble.html#AEN1100">I cannot connect to any - websites. Or, I am getting <span class="QUOTE">"connection - refused"</span> message with every web page. Why?</a></dt> - - <dt>5.2. <a href="trouble.html#ERROR503">Why am I getting a 503 - Error (WSAECONNREFUSED) on every page?</a></dt> - - <dt>5.3. <a href="trouble.html#AEN1123">I just added a new rule, - but the steenkin ad is still getting through. How?</a></dt> - - <dt>5.4. <a href="trouble.html#BADSITE">One of my favorite sites - does not work with Privoxy. What can I do?</a></dt> - - <dt>5.5. <a href="trouble.html#DUN">After installing Privoxy, I - have to log in every time I start IE. What gives?</a></dt> - - <dt>5.6. <a href="trouble.html#FTP">I cannot connect to any FTP - sites. Privoxy is blocking me.</a></dt> - - <dt>5.7. <a href="trouble.html#MACOSXIE">In Mac OS X, I can't - configure Microsoft Internet Explorer to use Privoxy as the HTTP - proxy.</a></dt> - - <dt>5.8. <a href="trouble.html#MACOSXUNINSTALL">In Mac OS X, I - dragged the Privoxy folder to the trash in order to uninstall it. - Now the finder tells me I don't have sufficient privileges to - empty the trash.</a></dt> - - <dt>5.9. <a href="trouble.html#MACOSXIMAGES">In Mac OS X Panther - (10.3), images often fail to load and/or I experience random - delays in page loading. I'm using <tt class= - "LITERAL">localhost</tt> as my browser's proxy setting.</a></dt> - - <dt>5.10. <a href="trouble.html#BLANKPAGE">I get a completely - blank page at one site. <span class="QUOTE">"View Source"</span> - shows only: <span class= - "MARKUP"><html><body></body></html></span>. - Without Privoxy the page loads fine.</a></dt> - - <dt>5.11. <a href="trouble.html#NOHOSTNAME">My logs show many - <span class="QUOTE">"Unable to get my own hostname"</span> lines. - Why?</a></dt> - - <dt>5.12. <a href="trouble.html#INUSE">When I try to launch - Privoxy, I get an error message <span class="QUOTE">"port 8118 is - already in use"</span> (or similar wording). Why?</a></dt> - - <dt>5.13. <a href="trouble.html#DEMORONIZER">Pages with UTF-8 - fonts are garbled.</a></dt> - - <dt>5.14. <a href="trouble.html#DEMORONIZER2">Why are binary - files (such as images) corrupted when Privoxy is used?</a></dt> - - <dt>5.15. <a href="trouble.html#DEMORONIZER3">What is the - <span class="QUOTE">"demoronizer"</span> and why is it - there?</a></dt> - - <dt>5.16. <a href="trouble.html#WINDOWOPEN">Why do I keep seeing - <span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw source - code?</a></dt> - - <dt>5.17. <a href="trouble.html#DNSERRORS">I am getting too many - DNS errors like <span class="QUOTE">"404 No Such Domain"</span>. - Why can't Privoxy do this better?</a></dt> - - <dt>5.18. <a href="trouble.html#ALLCPU">At one site Privoxy just - hangs, and starts taking all CPU. Why is this?</a></dt> - - <dt>5.19. <a href="trouble.html#SLOWCRAWL">I just installed - Privoxy, and all my browsing has slowed to a crawl. What - gives?</a></dt> - - <dt>5.20. <a href="trouble.html#PREVENTCOMP">Why do my filters - work on some sites but not on others?</a></dt> - - <dt>5.21. <a href="trouble.html#SSL-WARNINGS">On some HTTPS sites - my browser warns me about unauthenticated content, the URL bar - doesn't get highlighted and the lock symbol appears to be broken. - What's going on?</a></dt> - - <dt>5.22. <a href="trouble.html#SE-LINUX">I get selinux error - messages. How can I fix this?</a></dt> - - <dt>5.23. <a href="trouble.html#GENTOO-RICERS">I compiled - <span class="APPLICATION">Privoxy</span> with Gentoo's portage - and it appears to be very slow. Why?</a></dt> - </dl> - </dd> - - <dt>6. <a href="contact.html">Contacting the developers, Bug - Reporting and Feature Requests</a></dt> - - <dd> - <dl> - <dt>6.1. <a href="contact.html#CONTACT-SUPPORT">Get - Support</a></dt> - - <dt>6.2. <a href="contact.html#REPORTING">Reporting - Problems</a></dt> - - <dd> - <dl> - <dt>6.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads - or Other Configuration Problems</a></dt> - - <dt>6.2.2. <a href="contact.html#CONTACT-BUGS">Reporting - Bugs</a></dt> - </dl> - </dd> - - <dt>6.3. <a href="contact.html#CONTACT-FEATURE">Request New - Features</a></dt> - - <dt>6.4. <a href="contact.html#MAILING-LISTS">Mailing - Lists</a></dt> - </dl> - </dd> - - <dt>7. <a href="copyright.html">Privoxy Copyright, License and - History</a></dt> - - <dd> - <dl> - <dt>7.1. <a href="copyright.html#AEN1475">License</a></dt> - - <dt>7.2. <a href="copyright.html#AEN1491">History</a></dt> - </dl> - </dd> - </dl> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c4" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"> </td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top"><a href="general.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top"> </td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">General Information</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Privoxy Frequently Asked Questions</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="NEXT" +TITLE="General Information" +HREF="general.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="ARTICLE" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="ARTICLE" +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +><A +NAME="AEN2" +>Privoxy Frequently Asked Questions</A +></H1 +><P +CLASS="PUBDATE" +> <SUB +> <A +HREF="copyright.html" +>Copyright</A +> © 2001-2009 by + <A +HREF="http://www.privoxy.org/" +TARGET="_top" +>Privoxy Developers</A +> + </SUB +><BR></P +><P +CLASS="PUBDATE" +>$Id: index.html,v 1.51 2009/03/21 12:59:04 fabiankeil Exp $<BR></P +><DIV +><DIV +CLASS="ABSTRACT" +><P +></P +><A +NAME="AEN9" +></A +><P +> This FAQ gives quick answers to frequently asked questions about + <A +HREF="http://www.privoxy.org/" +TARGET="_top" +>Privoxy</A +>. + It is not a substitute for the + <A +HREF="../user-manual/index.html" +TARGET="_top" +><I +CLASS="CITETITLE" +>Privoxy User Manual</I +></A +>. + + </P +><P +>What is Privoxy?</P +><P +> Privoxy is a non-caching web proxy with advanced filtering capabilities + for enhancing privacy, modifying web page data and HTTP headers, controlling + access, and removing ads and other obnoxious Internet junk. Privoxy has a + flexible configuration and can be customized to suit individual needs and tastes. + It has application for both stand-alone systems and multi-user networks.</P +><P +> Privoxy is Free Software and licensed under the GPL2.</P +><P +> Privoxy is an associated project of Software in the Public Interest (SPI). + <A +HREF="http://www.privoxy.org/faq/general.html#DONATE" +TARGET="_top" +>Donations are welcome</A +>.</P +><P +> Please note that this document is a work in progress. This copy represents + the state at the release of version 3.0.12. + You can find the latest version of the document at <A +HREF="http://www.privoxy.org/faq/" +TARGET="_top" +>http://www.privoxy.org/faq/</A +>. + Please see the <A +HREF="contact.html" +>Contact section</A +> if you want to + contact the developers. + </P +><P +></P +></DIV +></DIV +><HR></DIV +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +>1. <A +HREF="general.html" +>General Information</A +></DT +><DD +><DL +><DT +>1.1. <A +HREF="general.html#WHO-USES" +>Who should give <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> a try?</A +></DT +><DT +>1.2. <A +HREF="general.html#BESTCHOICE" +>Is Privoxy the best choice for +me?</A +></DT +><DT +>1.3. <A +HREF="general.html#PROXYMORON" +>What is a <SPAN +CLASS="QUOTE" +>"proxy"</SPAN +>? How does +Privoxy work?</A +></DT +><DT +>1.4. <A +HREF="general.html#OTHERSTUFF" +>Does Privoxy do anything more than ad blocking?</A +></DT +><DT +>1.5. <A +HREF="general.html#NEWJB" +>What is this new version of +<SPAN +CLASS="QUOTE" +>"Junkbuster"</SPAN +>?</A +></DT +><DT +>1.6. <A +HREF="general.html#AEN78" +>Why <SPAN +CLASS="QUOTE" +>"Privoxy"</SPAN +>? Why change the name from +Junkbuster at all?</A +></DT +><DT +>1.7. <A +HREF="general.html#DIFFERS" +>How does Privoxy differ +from the old Junkbuster?</A +></DT +><DT +>1.8. <A +HREF="general.html#WHATSANAD" +>How does Privoxy know what is +an ad, and what is not?</A +></DT +><DT +>1.9. <A +HREF="general.html#AEN160" +>Can Privoxy make mistakes? +This does not sound very scientific.</A +></DT +><DT +>1.10. <A +HREF="general.html#AEN166" +>Will I have to configure Privoxy + before I can use it?</A +></DT +><DT +>1.11. <A +HREF="general.html#LAN" +>Can Privoxy run as a server on a network?</A +></DT +><DT +>1.12. <A +HREF="general.html#BROWSERS2" +>My browser does the same things as +Privoxy. Why should I use Privoxy at all?</A +></DT +><DT +>1.13. <A +HREF="general.html#WHYTRUST" +>Why should I trust Privoxy?</A +></DT +><DT +>1.14. <A +HREF="general.html#LICENSE" +>Is there is a license or fee? What about a +warranty? Registration?</A +></DT +><DT +>1.15. <A +HREF="general.html#SPYWARE" +>Can Privoxy remove spyware? Adware? Viruses?</A +></DT +><DT +>1.16. <A +HREF="general.html#OTHERADS" +>Can I use Privoxy with other ad-blocking software?</A +></DT +><DT +>1.17. <A +HREF="general.html#JOINTEAM" +>I would like to help you, what can I do?</A +></DT +><DD +><DL +><DT +>1.17.1. <A +HREF="general.html#JOINTEAM-WORK" +>Would you like to participate?</A +></DT +><DT +>1.17.2. <A +HREF="general.html#DONATE" +>Would you like to donate?</A +></DT +></DL +></DD +></DL +></DD +><DT +>2. <A +HREF="installation.html" +>Installation</A +></DT +><DD +><DL +><DT +>2.1. <A +HREF="installation.html#WHICHBROWSERS" +>Which browsers are supported by Privoxy?</A +></DT +><DT +>2.2. <A +HREF="installation.html#WHICHOS" +>Which operating systems are supported?</A +></DT +><DT +>2.3. <A +HREF="installation.html#EMAIL-CLIENT" +>Can I use Privoxy with my email client?</A +></DT +><DT +>2.4. <A +HREF="installation.html#FIRSTSTEP" +>I just installed Privoxy. Is there anything +special I have to do now?</A +></DT +><DT +>2.5. <A +HREF="installation.html#LOCALHOST" +>What is the proxy address of Privoxy?</A +></DT +><DT +>2.6. <A +HREF="installation.html#NOTHING" +>I just installed Privoxy, and nothing is happening. +All the ads are there. What's wrong?</A +></DT +><DT +>2.7. <A +HREF="installation.html#NOTUSED" +>I get a <SPAN +CLASS="QUOTE" +>"Privoxy is not being used"</SPAN +> dummy page although +Privoxy is running and being used.</A +></DT +></DL +></DD +><DT +>3. <A +HREF="configuration.html" +>Configuration</A +></DT +><DD +><DL +><DT +>3.1. <A +HREF="configuration.html#AEN354" +>What exactly is an <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> file?</A +></DT +><DT +>3.2. <A +HREF="configuration.html#ACTIONSS" +>The <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> concept confuses me. Please list +some of these <SPAN +CLASS="QUOTE" +>"actions"</SPAN +>.</A +></DT +><DT +>3.3. <A +HREF="configuration.html#AEN377" +>How are actions files configured? What is the easiest +way to do this?</A +></DT +><DT +>3.4. <A +HREF="configuration.html#AEN386" +>There are several different <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> files. What are +the differences?</A +></DT +><DT +>3.5. <A +HREF="configuration.html#GETUPDATES" +>Where can I get updated Actions Files?</A +></DT +><DT +>3.6. <A +HREF="configuration.html#NEWCONFIG" +>Can I use my old config files?</A +></DT +><DT +>3.7. <A +HREF="configuration.html#DIFFICULT" +>Why is the configuration so complicated?</A +></DT +><DT +>3.8. <A +HREF="configuration.html#YAHOO" +>How can I make my Yahoo/Hotmail/Gmail account work?</A +></DT +><DT +>3.9. <A +HREF="configuration.html#CONFIGFILES" +>What's the difference between the +<SPAN +CLASS="QUOTE" +>"Cautious"</SPAN +>, <SPAN +CLASS="QUOTE" +>"Medium"</SPAN +> and <SPAN +CLASS="QUOTE" +>"Advanced"</SPAN +> defaults?</A +></DT +><DT +>3.10. <A +HREF="configuration.html#BROWSECONFIG" +>Why can I change the configuration +with a browser? Does that not raise security issues?</A +></DT +><DT +>3.11. <A +HREF="configuration.html#AEN481" +>What is the <TT +CLASS="FILENAME" +>default.filter</TT +> file? What is a <SPAN +CLASS="QUOTE" +>"filter"</SPAN +>?</A +></DT +><DT +>3.12. <A +HREF="configuration.html#LANCONFIG" +>How can I set up Privoxy to act as a proxy for my + LAN?</A +></DT +><DT +>3.13. <A +HREF="configuration.html#AEN532" +>Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A +></DT +><DT +>3.14. <A +HREF="configuration.html#AEN549" +>Why would anybody want to see a checkerboard pattern?</A +></DT +><DT +>3.15. <A +HREF="configuration.html#AEN555" +>I see some images being replaced with text +instead of the checkerboard image. Why and how do I get rid of this?</A +></DT +><DT +>3.16. <A +HREF="configuration.html#SRVANY" +>Can Privoxy run as a service +on Win2K/NT/XP?</A +></DT +><DT +>3.17. <A +HREF="configuration.html#OTHERPROXY" +>How can I make Privoxy work with other +proxies like Squid or Tor?</A +></DT +><DT +>3.18. <A +HREF="configuration.html#PORT-80" +>Can I just set Privoxy to use port 80 +and thus avoid individual browser configuration?</A +></DT +><DT +>3.19. <A +HREF="configuration.html#TRANSPARENT" +>Can Privoxy run as a <SPAN +CLASS="QUOTE" +>"transparent"</SPAN +> proxy?</A +></DT +><DT +>3.20. <A +HREF="configuration.html#INTERCEPTING" +>Can Privoxy run as a <SPAN +CLASS="QUOTE" +>"intercepting"</SPAN +> proxy?</A +></DT +><DT +>3.21. <A +HREF="configuration.html#OUTLOOK" +>How can I configure Privoxy for use with Outlook?</A +></DT +><DT +>3.22. <A +HREF="configuration.html#OUTLOOK-MORE" +>How can I have separate rules just for HTML mail?</A +></DT +><DT +>3.23. <A +HREF="configuration.html#SNEAKY-COOKIES" +>I sometimes notice cookies sneaking through. How?</A +></DT +><DT +>3.24. <A +HREF="configuration.html#EVIL-COOKIES" +>Are all cookies bad? Why?</A +></DT +><DT +>3.25. <A +HREF="configuration.html#ALLOW-COOKIES" +>How can I allow permanent cookies for my trusted sites?</A +></DT +><DT +>3.26. <A +HREF="configuration.html#MULTIPLES" +>Can I have separate configurations for different users?</A +></DT +><DT +>3.27. <A +HREF="configuration.html#WHITELISTS" +>Can I set-up Privoxy as a whitelist of +<SPAN +CLASS="QUOTE" +>"good"</SPAN +> sites?</A +></DT +><DT +>3.28. <A +HREF="configuration.html#NO-ADBLOCK" +>How can I turn off ad-blocking?</A +></DT +><DT +>3.29. <A +HREF="configuration.html#TEMPLATES" +>How can I have custom template pages, like the +<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>BLOCKED</I +></SPAN +> page?</A +></DT +><DT +>3.30. <A +HREF="configuration.html#BLOCKALL" +>How can I remove the <SPAN +CLASS="QUOTE" +>"Go There Anyway"</SPAN +> link from +the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>BLOCKED</I +></SPAN +> page?</A +></DT +></DL +></DD +><DT +>4. <A +HREF="misc.html" +>Miscellaneous</A +></DT +><DD +><DL +><DT +>4.1. <A +HREF="misc.html#AEN729" +>How much does Privoxy slow my browsing down? This +has to add extra time to browsing.</A +></DT +><DT +>4.2. <A +HREF="misc.html#LOADINGTIMES" +>I notice considerable +delays in page requests. What's wrong?</A +></DT +><DT +>4.3. <A +HREF="misc.html#CONFIGURL" +>What are "http://config.privoxy.org/" and +"http://p.p/%22?</A +></DT +><DT +>4.4. <A +HREF="misc.html#NEWADS" +>How can I submit new ads, or report +problems?</A +></DT +><DT +>4.5. <A +HREF="misc.html#NEWADS2" +>If I do submit missed ads, will +they be included in future updates?</A +></DT +><DT +>4.6. <A +HREF="misc.html#NOONECARES" +>Why doesn't anyone answer my support +request?</A +></DT +><DT +>4.7. <A +HREF="misc.html#IP" +>How can I hide my IP address?</A +></DT +><DT +>4.8. <A +HREF="misc.html#AEN794" +>Can Privoxy guarantee I am anonymous?</A +></DT +><DT +>4.9. <A +HREF="misc.html#AEN812" +>A test site says I am not using a Proxy.</A +></DT +><DT +>4.10. <A +HREF="misc.html#TOR" +>How do I use Privoxy + together with Tor?</A +></DT +><DT +>4.11. <A +HREF="misc.html#AEN868" +>Might some things break because header information or +content is being altered?</A +></DT +><DT +>4.12. <A +HREF="misc.html#AEN882" +>Can Privoxy act as a <SPAN +CLASS="QUOTE" +>"caching"</SPAN +> proxy to +speed up web browsing?</A +></DT +><DT +>4.13. <A +HREF="misc.html#AEN892" +>What about as a firewall? Can Privoxy protect me?</A +></DT +><DT +>4.14. <A +HREF="misc.html#AEN897" +>I have large empty spaces / a checkerboard pattern now where +ads used to be. Why?</A +></DT +><DT +>4.15. <A +HREF="misc.html#AEN905" +>How can Privoxy filter Secure (HTTPS) URLs?</A +></DT +><DT +>4.16. <A +HREF="misc.html#AEN919" +>Privoxy runs as a <SPAN +CLASS="QUOTE" +>"server"</SPAN +>. How +secure is it? Do I need to take any special precautions?</A +></DT +><DT +>4.17. <A +HREF="misc.html#TURNOFF" +>Can I temporarily disable Privoxy?</A +></DT +><DT +>4.18. <A +HREF="misc.html#REALLYOFF" +>When <SPAN +CLASS="QUOTE" +>"disabled"</SPAN +> is Privoxy totally +out of the picture?</A +></DT +><DT +>4.19. <A +HREF="misc.html#TURNOFF2" +>How can I tell Privoxy to totally ignore certain sites?</A +></DT +><DT +>4.20. <A +HREF="misc.html#CRUNCH" +>My logs show Privoxy <SPAN +CLASS="QUOTE" +>"crunches"</SPAN +> +ads, but also its own internal CGI pages. What is a <SPAN +CLASS="QUOTE" +>"crunch"</SPAN +>?</A +></DT +><DT +>4.21. <A +HREF="misc.html#DOWNLOADS" +>Can Privoxy effect files that I download +from a webserver? FTP server?</A +></DT +><DT +>4.22. <A +HREF="misc.html#DOWNLOADS2" +>I just downloaded a Perl script, and Privoxy +altered it! Yikes, what is wrong!</A +></DT +><DT +>4.23. <A +HREF="misc.html#HOSTSFILE" +>Should I continue to use a <SPAN +CLASS="QUOTE" +>"HOSTS"</SPAN +> file for ad-blocking?</A +></DT +><DT +>4.24. <A +HREF="misc.html#SEEALSO" +>Where can I find more information about Privoxy +and related issues?</A +></DT +><DT +>4.25. <A +HREF="misc.html#MICROSUCK" +>I've noticed that Privoxy changes <SPAN +CLASS="QUOTE" +>"Microsoft"</SPAN +> to +<SPAN +CLASS="QUOTE" +>"MicroSuck"</SPAN +>! Why are you manipulating my browsing?</A +></DT +><DT +>4.26. <A +HREF="misc.html#VALID" +>Does Privoxy produce <SPAN +CLASS="QUOTE" +>"valid"</SPAN +> HTML (or XHTML)?</A +></DT +></DL +></DD +><DT +>5. <A +HREF="trouble.html" +>Troubleshooting</A +></DT +><DD +><DL +><DT +>5.1. <A +HREF="trouble.html#AEN1084" +>I cannot connect to any websites. Or, I am getting +<SPAN +CLASS="QUOTE" +>"connection refused"</SPAN +> message with every web page. Why?</A +></DT +><DT +>5.2. <A +HREF="trouble.html#ERROR503" +>Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</A +></DT +><DT +>5.3. <A +HREF="trouble.html#AEN1107" +>I just added a new rule, but the steenkin ad is +still getting through. How?</A +></DT +><DT +>5.4. <A +HREF="trouble.html#BADSITE" +>One of my favorite sites does not work with Privoxy. +What can I do?</A +></DT +><DT +>5.5. <A +HREF="trouble.html#DUN" +>After installing Privoxy, I have to log in +every time I start IE. What gives?</A +></DT +><DT +>5.6. <A +HREF="trouble.html#FTP" +>I cannot connect to any FTP sites. Privoxy + is blocking me.</A +></DT +><DT +>5.7. <A +HREF="trouble.html#MACOSXIE" +>In Mac OS X, I can't configure Microsoft Internet Explorer to use + Privoxy as the HTTP proxy.</A +></DT +><DT +>5.8. <A +HREF="trouble.html#MACOSXUNINSTALL" +>In Mac OS X, I dragged the Privoxy folder to the trash in order to + uninstall it. Now the finder tells me I don't have sufficient privileges to + empty the trash.</A +></DT +><DT +>5.9. <A +HREF="trouble.html#MACOSXIMAGES" +>In Mac OS X Panther (10.3), images often fail to load and/or I + experience random delays in page loading. I'm using + <TT +CLASS="LITERAL" +>localhost</TT +> as my browser's proxy setting.</A +></DT +><DT +>5.10. <A +HREF="trouble.html#BLANKPAGE" +>I get a completely blank page at one site. <SPAN +CLASS="QUOTE" +>"View Source"</SPAN +> + shows only: <SPAN +CLASS="MARKUP" +><html><body></body></html></SPAN +>. Without + Privoxy the page loads fine.</A +></DT +><DT +>5.11. <A +HREF="trouble.html#NOHOSTNAME" +>My logs show many <SPAN +CLASS="QUOTE" +>"Unable to get my own hostname"</SPAN +> lines. +Why?</A +></DT +><DT +>5.12. <A +HREF="trouble.html#INUSE" +>When I try to launch Privoxy, I get an +error message <SPAN +CLASS="QUOTE" +>"port 8118 is already in use"</SPAN +> (or similar wording). +Why?</A +></DT +><DT +>5.13. <A +HREF="trouble.html#DEMORONIZER" +>Pages with UTF-8 fonts are garbled.</A +></DT +><DT +>5.14. <A +HREF="trouble.html#DEMORONIZER2" +>Why are binary files (such as images) corrupted when Privoxy + is used?</A +></DT +><DT +>5.15. <A +HREF="trouble.html#DEMORONIZER3" +>What is the <SPAN +CLASS="QUOTE" +>"demoronizer"</SPAN +> and why is it there?</A +></DT +><DT +>5.16. <A +HREF="trouble.html#WINDOWOPEN" +>Why do I keep seeing <SPAN +CLASS="QUOTE" +>"PrivoxyWindowOpen()"</SPAN +> in raw source code?</A +></DT +><DT +>5.17. <A +HREF="trouble.html#DNSERRORS" +>I am getting too many DNS errors like <SPAN +CLASS="QUOTE" +>"404 No Such Domain"</SPAN +>. Why + can't Privoxy do this better?</A +></DT +><DT +>5.18. <A +HREF="trouble.html#ALLCPU" +>At one site Privoxy just hangs, and starts taking + all CPU. Why is this?</A +></DT +><DT +>5.19. <A +HREF="trouble.html#SLOWCRAWL" +>I just installed Privoxy, and all my +browsing has slowed to a crawl. What gives?</A +></DT +><DT +>5.20. <A +HREF="trouble.html#PREVENTCOMP" +>Why do my filters work on some sites but not on others?</A +></DT +><DT +>5.21. <A +HREF="trouble.html#SSL-WARNINGS" +>On some HTTPS sites my browser warns me about unauthenticated content, + the URL bar doesn't get highlighted and the lock symbol appears to be broken. + What's going on?</A +></DT +><DT +>5.22. <A +HREF="trouble.html#SE-LINUX" +>I get selinux error messages. How can I fix this?</A +></DT +><DT +>5.23. <A +HREF="trouble.html#GENTOO-RICERS" +>I compiled <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with Gentoo's portage and it appears to be very slow. Why?</A +></DT +></DL +></DD +><DT +>6. <A +HREF="contact.html" +>Contacting the developers, Bug Reporting and Feature Requests</A +></DT +><DD +><DL +><DT +>6.1. <A +HREF="contact.html#CONTACT-SUPPORT" +>Get Support</A +></DT +><DT +>6.2. <A +HREF="contact.html#REPORTING" +>Reporting Problems</A +></DT +><DD +><DL +><DT +>6.2.1. <A +HREF="contact.html#CONTACT-ADS" +>Reporting Ads or Other Configuration Problems</A +></DT +><DT +>6.2.2. <A +HREF="contact.html#CONTACT-BUGS" +>Reporting Bugs</A +></DT +></DL +></DD +><DT +>6.3. <A +HREF="contact.html#CONTACT-FEATURE" +>Request New Features</A +></DT +><DT +>6.4. <A +HREF="contact.html#CONTACT-OTHER" +>Other</A +></DT +></DL +></DD +><DT +>7. <A +HREF="copyright.html" +>Privoxy Copyright, License and History</A +></DT +><DD +><DL +><DT +>7.1. <A +HREF="copyright.html#AEN1451" +>License</A +></DT +><DT +>7.2. <A +HREF="copyright.html#AEN1467" +>History</A +></DT +></DL +></DD +></DL +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +> </TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="general.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +> </TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>General Information</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/faq/installation.html b/external/privoxy/doc/webserver/faq/installation.html index 47ecf73..1e99b30 100644 --- a/external/privoxy/doc/webserver/faq/installation.html +++ b/external/privoxy/doc/webserver/faq/installation.html @@ -1,259 +1,569 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Installation</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Frequently Asked Questions" href= - "index.html"> - <link rel="PREVIOUS" title="General Information" href="general.html"> - <link rel="NEXT" title="Configuration" href="configuration.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Frequently Asked - Questions</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="general.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "configuration.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="INSTALLATION" id="INSTALLATION">2. - Installation</a></h1> - - <div class="SECT2"> - <h3 class="SECT2"><a name="WHICHBROWSERS" id="WHICHBROWSERS">2.1. Which - browsers are supported by Privoxy?</a></h3> - - <p>Any browser that can be configured to use a proxy, which should be - virtually all browsers, including <span class= - "APPLICATION">Firefox</span>, <span class="APPLICATION">Internet - Explorer</span>, <span class="APPLICATION">Opera</span>, and - <span class="APPLICATION">Safari</span> among others. Direct browser - support is not an absolute requirement since <span class= - "APPLICATION">Privoxy</span> runs as a separate application and talks - to the browser in the standardized HTTP protocol, just like a web - server does.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="WHICHOS" id="WHICHOS">2.2. Which operating - systems are supported?</a></h3> - - <p>At present, <span class="APPLICATION">Privoxy</span> is known to run - on Windows(95, 98, ME, 2000, XP, Vista), GNU/Linux (RedHat, SuSE, - Debian, Fedora, Gentoo, Slackware and others), Mac OSX, OS/2, AmigaOS, - FreeBSD, NetBSD, OpenBSD, Solaris, and various other flavors of - Unix.</p> - - <p>But any operating system that runs TCP/IP, can conceivably take - advantage of <span class="APPLICATION">Privoxy</span> in a networked - situation where <span class="APPLICATION">Privoxy</span> would run as a - server on a LAN gateway. Then only the <span class= - "QUOTE">"gateway"</span> needs to be running one of the above operating - systems.</p> - - <p>Source code is freely available, so porting to other operating - systems is always a possibility.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="EMAIL-CLIENT" id="EMAIL-CLIENT">2.3. Can I - use Privoxy with my email client?</a></h3> - - <p>As long as there is some way to set a HTTP proxy for the client, - then yes, any application can be used, whether it is strictly speaking - a <span class="QUOTE">"browser"</span> or not. Though this may not be - the best approach for dealing with some of the common abuses of HTML in - email. See <a href="configuration.html#OUTLOOK">How can I configure - <span class="APPLICATION">Privoxy</span> with <span class= - "APPLICATION">Outlook</span>?</a> below for more on this.</p> - - <p>Be aware that HTML email presents a number of unique security and - privacy related issues, that can require advanced skills to overcome. - The developers recommend using email clients that can be configured to - convert HTML to plain text for these reasons.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="FIRSTSTEP" id="FIRSTSTEP">2.4. I just - installed Privoxy. Is there anything special I have to do now?</a></h3> - - <p>All browsers should be told to use <span class= - "APPLICATION">Privoxy</span> as a proxy by specifying the correct proxy - address and port number in the appropriate configuration area for the - browser. It's possible to combine <span class= - "APPLICATION">Privoxy</span> with a packet filter to intercept HTTP - requests even if the client isn't explicitly configured to use - <span class="APPLICATION">Privoxy</span>, but where possible, - configuring the client is recommended. See <a href= - "../user-manual/startup.html" target="_top">the User Manual for more - details</a>. You should also flush your browser's memory and disk cache - to get rid of any cached junk items, and remove any stored <a href= - "http://en.wikipedia.org/wiki/Browser_cookie" target= - "_top">cookies</a>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="LOCALHOST" id="LOCALHOST">2.5. What is the - proxy address of Privoxy?</a></h3> - - <p>If you set up the <span class="APPLICATION">Privoxy</span> to run on - the computer you browse from (rather than your ISP's server or some - networked computer on a LAN), the proxy will be on <tt class= - "LITERAL">127.0.0.1</tt> (sometimes referred to as <span class= - "QUOTE">"localhost"</span>, which is the special name used by every - computer on the Internet to refer to itself) and the port will be 8118 - (unless you used the <a href= - "../user-manual/config.html#LISTEN-ADDRESS" target= - "_top">listen-address</a> config option to tell <span class= - "APPLICATION">Privoxy</span> to run on a different port).</p> - - <p>When configuring your browser's proxy settings you typically enter - the word <span class="QUOTE">"localhost"</span> or the IP address - <span class="QUOTE">"127.0.0.1"</span> in the boxes next to - <span class="QUOTE">"HTTP"</span> and <span class= - "QUOTE">"Secure"</span> (HTTPS) and then the number <span class= - "QUOTE">"8118"</span> for <span class="QUOTE">"port"</span>. This tells - your browser to send all web requests to <span class= - "APPLICATION">Privoxy</span> instead of directly to the Internet.</p> - - <p><span class="APPLICATION">Privoxy</span> can also be used to proxy - for a Local Area Network. In this case, your would enter either the IP - address of the LAN host where <span class="APPLICATION">Privoxy</span> - is running, or the equivalent hostname, e.g. <tt class= - "LITERAL">192.168.1.1</tt>. Port assignment would be same as above. - Note that <span class="APPLICATION">Privoxy</span> doesn't listen on - any LAN interfaces by default.</p> - - <p><span class="APPLICATION">Privoxy</span> does not currently handle - any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="NOTHING" id="NOTHING">2.6. I just installed - Privoxy, and nothing is happening. All the ads are there. What's - wrong?</a></h3> - - <p>Did you configure your browser to use <span class= - "APPLICATION">Privoxy</span> as a proxy? It does not sound like it. See - above. You might also try flushing the browser's caches to force a full - re-reading of pages. You can verify that <span class= - "APPLICATION">Privoxy</span> is running, and your browser is correctly - configured by entering the special URL: <a href="http://p.p/" target= - "_top">http://p.p/</a>. This should take you to a page titled - <span class="QUOTE">"This is Privoxy.."</span> with access to - <span class="APPLICATION">Privoxy's</span> internal configuration. If - you see this, then you are good to go. If you receive a page saying - <span class="QUOTE">"Privoxy is not running"</span>, then the browser - is not set up to use your <span class="APPLICATION">Privoxy</span> - installation. If you receive anything else (probably nothing at all), - it could either be that the browser is not set up correctly, or that - <span class="APPLICATION">Privoxy</span> is not running at all. Check - the <a href="../user-manual/config.html#LOGFILE" target="_top">log - file</a>. For instructions on starting <span class= - "APPLICATION">Privoxy</span> and browser configuration, see the - <a href="http://www.privoxy.org/user-manual/startup.html" target= - "_top">chapter on starting <span class="APPLICATION">Privoxy</span></a> - in the <a href="http://www.privoxy.org/user-manual/" target="_top">User - Manual</a>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="NOTUSED" id="NOTUSED">2.7. I get a - <span class="QUOTE">"Privoxy is not being used"</span> dummy page - although Privoxy is running and being used.</a></h3> - - <p>First, make sure that Privoxy is <span class= - "emphasis EMPHASIS c2">really</span> running and being used by visiting - <a href="http://p.p/" target="_top">http://p.p/</a>. You should see the - <span class="APPLICATION">Privoxy</span> main page. If not, see the - <a href="http://www.privoxy.org/user-manual/startup.html" target= - "_top">chapter on starting <span class="APPLICATION">Privoxy</span></a> - in the <a href="http://www.privoxy.org/user-manual/" target="_top">User - Manual</a>.</p> - - <p>Now if <a href="http://p.p/" target="_top">http://p.p/</a> works for - you, but other parts of <span class="APPLICATION">Privoxy</span>'s web - interface show the dummy page, your browser has cached a redirection it - encountered before <span class="APPLICATION">Privoxy</span> was being - used. You need to clear your browser's cache. Note that shift-reloading - the dummy page won't help, since that'll only refresh the dummy page, - not the redirection that lead you there.</p> - - <p>The procedure for clearing the cache varies from browser to browser. - For example, <span class="APPLICATION">Mozilla/Netscape</span> users - would click <span class="GUIBUTTON">Edit</span> --> <span class= - "GUIBUTTON">Preferences</span> --> <span class= - "GUIBUTTON">Advanced</span> --> <span class="GUIBUTTON">Cache</span> - and then click both <span class="QUOTE">"<span class="GUIBUTTON">Clear - Memory Cache</span>"</span> and <span class="QUOTE">"<span class= - "GUIBUTTON">Clear Disk Cache</span>"</span>. In some <span class= - "APPLICATION">Firefox</span> versions it's <span class= - "GUIBUTTON">Tools</span> --> <span class="GUIBUTTON">Options</span> - --> <span class="GUIBUTTON">Privacy</span> --> <span class= - "GUIBUTTON">Cache</span> and then click <span class= - "QUOTE">"<span class="GUIBUTTON">Clear Cache Now</span>"</span>.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="general.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href= - "configuration.html" accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">General Information</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Configuration</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Installation</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Frequently Asked Questions" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="General Information" +HREF="general.html"><LINK +REL="NEXT" +TITLE="Configuration" +HREF="configuration.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Frequently Asked Questions</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="general.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="configuration.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INSTALLATION" +>2. Installation</A +></H1 +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="WHICHBROWSERS" +>2.1. Which browsers are supported by Privoxy?</A +></H3 +><P +> Any browser that can be configured to use a proxy, which + should be virtually all browsers, including + <SPAN +CLASS="APPLICATION" +>Firefox</SPAN +>, <SPAN +CLASS="APPLICATION" +>Internet + Explorer</SPAN +>, <SPAN +CLASS="APPLICATION" +>Opera</SPAN +>, and + <SPAN +CLASS="APPLICATION" +>Safari</SPAN +> among others. + Direct browser support is not an absolute requirement since + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> runs as a separate application and talks + to the browser in the standardized HTTP protocol, just like a web server + does.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="WHICHOS" +>2.2. Which operating systems are supported?</A +></H3 +><P +> At present, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is known to run on + Windows(95, 98, ME, 2000, XP, Vista), GNU/Linux (RedHat, SuSE, Debian, + Fedora, Gentoo, Slackware and others), Mac OSX, OS/2, AmigaOS, FreeBSD, + NetBSD, OpenBSD, Solaris, and various other flavors of Unix.</P +><P +> But any operating system that runs TCP/IP, can conceivably take advantage of + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> in a networked situation where + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> would run as a server on a LAN gateway. + Then only the <SPAN +CLASS="QUOTE" +>"gateway"</SPAN +> needs to be running one of the above + operating systems.</P +><P +> Source code is freely available, so porting to other operating systems + is always a possibility.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="EMAIL-CLIENT" +>2.3. Can I use Privoxy with my email client?</A +></H3 +><P +> As long as there is some way to set a HTTP proxy for the client, then yes, + any application can be used, whether it is strictly speaking a + <SPAN +CLASS="QUOTE" +>"browser"</SPAN +> or not. Though this may not be the best approach for + dealing with some of the common abuses of HTML in email. See <A +HREF="configuration.html#OUTLOOK" +>How can I configure <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + with <SPAN +CLASS="APPLICATION" +>Outlook</SPAN +>?</A +> below for more on + this. </P +><P +> Be aware that HTML email presents a number of unique security and privacy + related issues, that can require advanced skills to overcome. The developers + recommend using email clients that can be configured to convert HTML to plain + text for these reasons.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="FIRSTSTEP" +>2.4. I just installed Privoxy. Is there anything +special I have to do now?</A +></H3 +><P +> All browsers should be told to use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + as a proxy by specifying the correct proxy address and port number + in the appropriate configuration area for the browser. It's possible + to combine <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with a packet filter to intercept HTTP requests + even if the client isn't explicitly configured to use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, + but where possible, configuring the client is recommended. See + <A +HREF="../user-manual/startup.html" +TARGET="_top" +>the User Manual for more + details</A +>. You should also flush your browser's memory and disk + cache to get rid of any cached junk items, and remove any stored + <A +HREF="http://en.wikipedia.org/wiki/Browser_cookie" +TARGET="_top" +>cookies</A +>. </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="LOCALHOST" +>2.5. What is the proxy address of Privoxy?</A +></H3 +><P +> If you set up the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to run on + the computer you browse from (rather than your ISP's server or some + networked computer on a LAN), the proxy will be on <TT +CLASS="LITERAL" +>127.0.0.1</TT +> + (sometimes referred to as <SPAN +CLASS="QUOTE" +>"localhost"</SPAN +>, + which is the special name used by every computer on the Internet to refer + to itself) and the port will be 8118 (unless you used the <A +HREF="../user-manual/config.html#LISTEN-ADDRESS" +TARGET="_top" +>listen-address</A +> + config option to tell <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to run on + a different port). + </P +><P +> When configuring your browser's proxy settings you typically enter + the word <SPAN +CLASS="QUOTE" +>"localhost"</SPAN +> or the IP address <SPAN +CLASS="QUOTE" +>"127.0.0.1"</SPAN +> + in the boxes next to <SPAN +CLASS="QUOTE" +>"HTTP"</SPAN +> and <SPAN +CLASS="QUOTE" +>"Secure"</SPAN +> (HTTPS) and + then the number <SPAN +CLASS="QUOTE" +>"8118"</SPAN +> for <SPAN +CLASS="QUOTE" +>"port"</SPAN +>. + This tells your browser to send all web requests to <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + instead of directly to the Internet. + </P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can also be used to proxy for + a Local Area Network. In this case, your would enter either the IP + address of the LAN host where <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + is running, or the equivalent hostname, e.g. <TT +CLASS="LITERAL" +>192.168.1.1</TT +>. + Port assignment would be same as above. Note that + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> doesn't listen on any LAN interfaces by + default. + </P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> does not currently handle + any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="NOTHING" +>2.6. I just installed Privoxy, and nothing is happening. +All the ads are there. What's wrong?</A +></H3 +><P +> Did you configure your browser to use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + as a proxy? It does not sound like it. See above. You might also try flushing + the browser's caches to force a full re-reading of pages. You can verify + that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is running, and your browser + is correctly configured by entering the special URL: + <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +>. + + This should take you to a page titled <SPAN +CLASS="QUOTE" +>"This is Privoxy.."</SPAN +> with + access to <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> internal configuration. + If you see this, then you are good to go. If you receive a page saying + <SPAN +CLASS="QUOTE" +>"Privoxy is not running"</SPAN +>, then the browser is not set up to use + your <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> installation. + If you receive anything else (probably nothing at all), it could either + be that the browser is not set up correctly, or that + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is not running at all. Check the <A +HREF="../user-manual/config.html#LOGFILE" +TARGET="_top" +>log file</A +>. For instructions + on starting <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and browser configuration, + see the <A +HREF="http://www.privoxy.org/user-manual/startup.html" +TARGET="_top" +>chapter + on starting <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +></A +> in the + <A +HREF="http://www.privoxy.org/user-manual/" +TARGET="_top" +>User Manual</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="NOTUSED" +>2.7. I get a <SPAN +CLASS="QUOTE" +>"Privoxy is not being used"</SPAN +> dummy page although +Privoxy is running and being used.</A +></H3 +><P +> First, make sure that Privoxy is <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>really</I +></SPAN +> running and + being used by visiting <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +>. You + should see the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> main page. If not, see + the <A +HREF="http://www.privoxy.org/user-manual/startup.html" +TARGET="_top" +>chapter + on starting <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +></A +> in the + <A +HREF="http://www.privoxy.org/user-manual/" +TARGET="_top" +>User Manual</A +>.</P +><P +> Now if <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +> works for you, but + other parts of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s web interface show + the dummy page, your browser has cached a redirection it encountered before + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> was being used. You need to clear your + browser's cache. Note that shift-reloading the dummy page won't help, since + that'll only refresh the dummy page, not the redirection that lead you there.</P +><P +> The procedure for clearing the cache varies from browser to browser. For + example, <SPAN +CLASS="APPLICATION" +>Mozilla/Netscape</SPAN +> users would click + <SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +> --> <SPAN +CLASS="GUIBUTTON" +>Preferences</SPAN +> --> + <SPAN +CLASS="GUIBUTTON" +>Advanced</SPAN +> --> <SPAN +CLASS="GUIBUTTON" +>Cache</SPAN +> and + then click both <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Clear Memory Cache</SPAN +>"</SPAN +> + and <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Clear Disk Cache</SPAN +>"</SPAN +>. + In some <SPAN +CLASS="APPLICATION" +>Firefox</SPAN +> versions it's + <SPAN +CLASS="GUIBUTTON" +>Tools</SPAN +> --> <SPAN +CLASS="GUIBUTTON" +>Options</SPAN +> --> + <SPAN +CLASS="GUIBUTTON" +>Privacy</SPAN +> --> <SPAN +CLASS="GUIBUTTON" +>Cache</SPAN +> and + then click <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Clear Cache Now</SPAN +>"</SPAN +>. + </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="general.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="configuration.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>General Information</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Configuration</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/faq/misc.html b/external/privoxy/doc/webserver/faq/misc.html index b028cf6..174722e 100644 --- a/external/privoxy/doc/webserver/faq/misc.html +++ b/external/privoxy/doc/webserver/faq/misc.html @@ -1,929 +1,1745 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Miscellaneous</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Frequently Asked Questions" href= - "index.html"> - <link rel="PREVIOUS" title="Configuration" href="configuration.html"> - <link rel="NEXT" title="Troubleshooting" href="trouble.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - table.c3 {background-color: #E0E0E0} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Frequently Asked - Questions</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "configuration.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="trouble.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="MISC" id="MISC">4. Miscellaneous</a></h1> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN738" id="AEN738">4.1. How much does - Privoxy slow my browsing down? This has to add extra time to - browsing.</a></h3> - - <p>How much of an impact depends on many things, including the CPU of - the host system, how aggressive the configuration is, which specific - actions are being triggered, the size of the page, the bandwidth of the - connection, etc.</p> - - <p>Overall, it should not slow you down any in real terms, and may - actually help speed things up since ads, banners and other junk are not - typically being retrieved and displayed. The actual processing time - required by <span class="APPLICATION">Privoxy</span> itself for each - page, is relatively small in the overall scheme of things, and happens - very quickly. This is typically more than offset by time saved not - downloading and rendering ad images and other junk content (if ad - blocking is being used).</p> - - <p><span class="QUOTE">"Filtering"</span> content via the <tt class= - "LITERAL"><a href="../user-manual/actions-file.html#FILTER" target= - "_top">filter</a></tt> or <tt class="LITERAL"><a href= - "../user-manual/actions-file.html#DEANIMATE-GIFS" target= - "_top">deanimate-gifs</a></tt> actions may cause a perceived slowdown, - since the entire document needs to be buffered before displaying. And - on very large documents, filtering may have some measurable impact. How - much depends on the page size, the actual definition of the filter(s), - etc. See below. Most other actions have little to no impact on - speed.</p> - - <p>Also, when filtering is enabled but zlib support isn't available, - compression is often disabled (see <a href= - "../user-manual/actions-file.html#PREVENT-COMPRESSION" target= - "_top">prevent-compression</a>). This can have an impact on speed as - well, although it's probably smaller than you might think. Again, the - page size, etc. will determine how much of an impact.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="LOADINGTIMES" id="LOADINGTIMES">4.2. I - notice considerable delays in page requests. What's wrong?</a></h3> - - <p>If you use any <tt class="LITERAL"><a href= - "../user-manual/actions-file.html#FILTER" target="_top">filter</a></tt> - action, such as filtering banners by size, web-bugs etc, or the - <tt class="LITERAL"><a href= - "../user-manual/actions-file.html#DEANIMATE-GIFS" target= - "_top">deanimate-gifs</a></tt> action, the entire document must be - loaded into memory in order for the filtering mechanism to work, and - nothing is sent to the browser during this time.</p> - - <p>The loading time typically does not really change much in real - numbers, but the feeling is different, because most browsers are able - to start rendering incomplete content, giving the user a feeling of "it - works". This effect is more noticeable on slower dialup connections. - Extremely large documents may have some impact on the time to load the - page where there is filtering being done. But overall, the difference - should be very minimal. If there is a big impact, then probably some - other situation is contributing (like anti-virus software).</p> - - <p>Filtering is automatically disabled for inappropriate MIME types. - But note that if the web server mis-reports the MIME type, then content - that should not be filtered, could be. <span class= - "APPLICATION">Privoxy</span> only knows how to differentiate filterable - content because of the MIME type as reported by the server, or because - of some configuration setting that enables/disables filtering.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="CONFIGURL" id="CONFIGURL">4.3. What are - "http://config.privoxy.org/" and "http://p.p/"?</a></h3> - - <p><a href="http://config.privoxy.org/" target= - "_top">http://config.privoxy.org/</a> is the address of <span class= - "APPLICATION">Privoxy</span>'s built-in user interface, and <a href= - "http://p.p/" target="_top">http://p.p/</a> is a shortcut for it.</p> - - <p>Since <span class="APPLICATION">Privoxy</span> sits between your web - browser and the Internet, it can simply intercept requests for these - addresses and answer them with its built-in <span class="QUOTE">"web - server"</span>.</p> - - <p>This also makes for a good test for your browser configuration: If - entering the URL <a href="http://config.privoxy.org/" target= - "_top">http://config.privoxy.org/</a> takes you to a page saying - <span class="QUOTE">"This is Privoxy ..."</span>, everything is OK. If - you get a page saying <span class="QUOTE">"Privoxy is not - working"</span> instead, then your browser didn't use <span class= - "APPLICATION">Privoxy</span> for the request, hence it could not be - intercepted, and you have accessed the <span class= - "emphasis EMPHASIS c2">real</span> web site at config.privoxy.org.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="NEWADS" id="NEWADS">4.4. How can I submit - new ads, or report problems?</a></h3> - - <p>Please see the <a href="contact.html">Contact section</a> for - various ways to interact with the developers.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="NEWADS2" id="NEWADS2">4.5. If I do submit - missed ads, will they be included in future updates?</a></h3> - - <p>Whether such submissions are eventually included in the <tt class= - "FILENAME">default.action</tt> configuration file depends on how - significant the issue is. We of course want to address any potential - problem with major, high-profile sites such as <i class= - "CITETITLE">Google</i>, <i class="CITETITLE">Yahoo</i>, etc. Any site - with global or regional reach, has a good chance of being a candidate. - But at the other end of the spectrum are any number of smaller, - low-profile sites such as for local clubs or schools. Since their reach - and impact are much less, they are best handled by inclusion in the - user's <tt class="FILENAME">user.action</tt>, and thus would be - unlikely to be included.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="NOONECARES" id="NOONECARES">4.6. Why doesn't - anyone answer my support request?</a></h3> - - <p>Rest assured that it has been read and considered. Why it is not - answered, could be for various reasons, including no one has a good - answer for it, no one has had time to yet investigate it thoroughly, it - has been reported numerous times already, or because not enough - information was provided to help us help you. Your efforts are not - wasted, and we do appreciate them.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="IP" id="IP">4.7. How can I hide my IP - address?</a></h3> - - <p>If you run both the browser and <span class= - "APPLICATION">Privoxy</span> locally, you cannot hide your IP address - with <span class="APPLICATION">Privoxy</span> or ultimately any other - software alone. The server needs to know your IP address so that it - knows where to send the responses back.</p> - - <p>There are many publicly usable "anonymous" proxies out there, which - provide a further level of indirection between you and the web - server.</p> - - <p>However, these proxies are called "anonymous" because you don't need - to authenticate, not because they would offer any real anonymity. Most - of them will log your IP address and make it available to the - authorities in case you violate the law of the country they run in. In - fact you can't even rule out that some of them only exist to *collect* - information on (those suspicious) people with a more than average - preference for privacy.</p> - - <p>If you want to hide your IP address from most adversaries, you - should consider chaining <span class="APPLICATION">Privoxy</span> with - <a href="https://www.torproject.org/" target="_top">Tor</a>. The - configuration details can be found in <a href="#TOR" target="_top">How - do I use <span class="APPLICATION">Privoxy</span> together with - <span class="APPLICATION">Tor</span> section</a> just below.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN803" id="AEN803">4.8. Can Privoxy - guarantee I am anonymous?</a></h3> - - <p>No. Your chances of remaining anonymous are improved, but unless you - <a href="#TOR" target="_top">chain <span class= - "APPLICATION">Privoxy</span> with <span class= - "APPLICATION">Tor</span></a> or a similar proxy and know what you're - doing when it comes to configuring the rest of your system, you should - assume that everything you do on the Web can be traced back to you.</p> - - <p><span class="APPLICATION">Privoxy</span> can remove various - information about you, and allows <span class= - "emphasis EMPHASIS c2">you</span> more freedom to decide which sites - you can trust, and what details you want to reveal. But it neither - hides your IP address, nor can it guarantee that the rest of the system - behaves correctly. There are several possibilities how a web sites can - find out who you are, even if you are using a strict <span class= - "APPLICATION">Privoxy</span> configuration and chained it with - <span class="APPLICATION">Tor</span>.</p> - - <p>Most of <span class="APPLICATION">Privoxy's</span> privacy-enhancing - features can be easily subverted by an insecure browser configuration, - therefore you should use a browser that can be configured to only - execute code from trusted sites, and be careful which sites you trust. - For example there is no point in having <span class= - "APPLICATION">Privoxy</span> modify the User-Agent header, if websites - can get all the information they want through JavaScript, ActiveX, - Flash, Java etc.</p> - - <p>A few browsers disclose the user's email address in certain - situations, such as when transferring a file by FTP. <span class= - "APPLICATION">Privoxy</span> does not filter FTP. If you need this - feature, or are concerned about the mail handler of your browser - disclosing your email address, you might consider products such as - <span class="APPLICATION">NSClean</span>.</p> - - <p>Browsers available only as binaries could use non-standard headers - to give out any information they can have access to: see the - manufacturer's license agreement. It's impossible to anticipate and - prevent every breach of privacy that might occur. The professionally - paranoid prefer browsers available as source code, because anticipating - their behavior is easier. Trust the source, Luke!</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN821" id="AEN821">4.9. A test site says I - am not using a Proxy.</a></h3> - - <p>Good! Actually, they are probably testing for some other kinds of - proxies. Hiding yourself completely would require additional steps.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="TOR" id="TOR">4.10. How do I use Privoxy - together with Tor?</a></h3> - - <p>Before you configure <span class="APPLICATION">Privoxy</span> to use - <a href="https://www.torproject.org/" target="_top">Tor</a>, please - follow the <i class="CITETITLE">User Manual</i> chapters <a href= - "../user-manual/installation.html" target="_top">2. Installation</a> - and <a href="../user-manual/startup.html" target="_top">5. Startup</a> - to make sure <span class="APPLICATION">Privoxy</span> itself is setup - correctly.</p> - - <p>If it is, refer to <a href= - "https://www.torproject.org/documentation.html" target="_top">Tor's - extensive documentation</a> to learn how to install <span class= - "APPLICATION">Tor</span>, and make sure <span class= - "APPLICATION">Tor</span>'s logfile says that <span class="QUOTE">"Tor - has successfully opened a circuit"</span> and it <span class= - "QUOTE">"looks like client functionality is working"</span>.</p> - - <p>If either <span class="APPLICATION">Tor</span> or <span class= - "APPLICATION">Privoxy</span> isn't working, their combination most - likely will neither. Testing them on their own will also help you to - direct problem reports to the right audience. If <span class= - "APPLICATION">Privoxy</span> isn't working, don't bother the - <span class="APPLICATION">Tor</span> developers. If <span class= - "APPLICATION">Tor</span> isn't working, don't send bug reports to the - <span class="APPLICATION">Privoxy</span> Team.</p> - - <p>If you verified that <span class="APPLICATION">Privoxy</span> and - <span class="APPLICATION">Tor</span> are working, it is time to connect - them. As far as <span class="APPLICATION">Privoxy</span> is concerned, - <span class="APPLICATION">Tor</span> is just another proxy that can be - reached by socks4, socks4a and socks5. Most likely you are interested - in <span class="APPLICATION">Tor</span> to increase your anonymity - level, therefore you should use socks5, to make sure DNS requests are - done through <span class="APPLICATION">Tor</span> and thus invisible to - your local network. Using socks4a would work too, but with socks5 you - get more precise error messages.</p> - - <p>Since <span class="APPLICATION">Privoxy</span> 3.0.5, its <a href= - "../user-manual/config.html" target="_top">main configuration file</a> - is already prepared for <span class="APPLICATION">Tor</span>, if you - are using a default <span class="APPLICATION">Tor</span> configuration - and run it on the same system as <span class= - "APPLICATION">Privoxy</span>, you just have to edit the <a href= - "../user-manual/config.html#FORWARDING" target="_top">forwarding - section</a> and uncomment the line:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# forward-socks5 / 127.0.0.1:9050 . - -</pre> - </td> - </tr> - </table> - - <p>This is enough to reach the Internet, but additionally you might - want to uncomment the following forward rules, to make sure your local - network is still reachable through Privoxy:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# forward 192.168.*.*/ . +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Miscellaneous</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Frequently Asked Questions" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Configuration" +HREF="configuration.html"><LINK +REL="NEXT" +TITLE="Troubleshooting" +HREF="trouble.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Frequently Asked Questions</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="configuration.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="trouble.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="MISC" +>4. Miscellaneous</A +></H1 +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN729" +>4.1. How much does Privoxy slow my browsing down? This +has to add extra time to browsing.</A +></H3 +><P +> How much of an impact depends on many things, including the CPU of the host + system, how aggressive the configuration is, which specific actions are being triggered, + the size of the page, the bandwidth of the connection, etc.</P +><P +> Overall, it should not slow you down any in real terms, and may actually help + speed things up since ads, banners and other junk are not typically being + retrieved and displayed. The actual processing time required by + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> itself for each page, is relatively small + in the overall scheme of things, and happens very quickly. This is typically + more than offset by time saved not downloading and rendering ad images and + other junk content (if ad blocking is being used).</P +><P +> <SPAN +CLASS="QUOTE" +>"Filtering"</SPAN +> content via the <TT +CLASS="LITERAL" +><A +HREF="../user-manual/actions-file.html#FILTER" +TARGET="_top" +>filter</A +></TT +> or + <TT +CLASS="LITERAL" +><A +HREF="../user-manual/actions-file.html#DEANIMATE-GIFS" +TARGET="_top" +>deanimate-gifs</A +></TT +> + actions may cause a perceived slowdown, since the entire document + needs to be buffered before displaying. And on very large documents, + filtering may have some measurable impact. How much depends on the page size, + the actual definition of the filter(s), etc. See below. Most other actions + have little to no impact on speed.</P +><P +> Also, when filtering is enabled but zlib support isn't available, compression + is often disabled (see <A +HREF="../user-manual/actions-file.html#PREVENT-COMPRESSION" +TARGET="_top" +>prevent-compression</A +>). + This can have an impact on speed as well, although it's probably smaller than + you might think. Again, the page size, etc. will determine how much of an impact.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="LOADINGTIMES" +>4.2. I notice considerable +delays in page requests. What's wrong?</A +></H3 +><P +> If you use any <TT +CLASS="LITERAL" +><A +HREF="../user-manual/actions-file.html#FILTER" +TARGET="_top" +>filter</A +></TT +> action, + such as filtering banners by size, web-bugs etc, or the <TT +CLASS="LITERAL" +><A +HREF="../user-manual/actions-file.html#DEANIMATE-GIFS" +TARGET="_top" +>deanimate-gifs</A +></TT +> + action, the entire document must be loaded into memory in order for the filtering + mechanism to work, and nothing is sent to the browser during this time.</P +><P +> The loading time typically does not really change much in real numbers, but + the feeling is different, because most browsers are able to start rendering + incomplete content, giving the user a feeling of "it works". This effect is + more noticeable on slower dialup connections. Extremely large documents + may have some impact on the time to load the page where there is filtering + being done. But overall, the difference should be very minimal. If there is a + big impact, then probably some other situation is contributing (like + anti-virus software). + </P +><P +> Filtering is automatically disabled for inappropriate MIME types. But note + that if the web server mis-reports the MIME type, then content that should + not be filtered, could be. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> only knows how + to differentiate filterable content because of the MIME type as reported by + the server, or because of some configuration setting that enables/disables + filtering.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="CONFIGURL" +>4.3. What are "http://config.privoxy.org/" and +"http://p.p/%22?</A +></H3 +><P +> <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>http://config.privoxy.org/</A +> is the + address of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s built-in user interface, and + <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +> is a shortcut for it.</P +><P +> Since <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> sits between your web browser and the Internet, + it can simply intercept requests for these addresses and answer them with its built-in + <SPAN +CLASS="QUOTE" +>"web server"</SPAN +>.</P +><P +> This also makes for a good test for your browser configuration: If entering the + URL <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>http://config.privoxy.org/</A +> + takes you to a page saying <SPAN +CLASS="QUOTE" +>"This is Privoxy ..."</SPAN +>, everything is OK. + If you get a page saying <SPAN +CLASS="QUOTE" +>"Privoxy is not working"</SPAN +> instead, then + your browser didn't use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> for the request, + hence it could not be intercepted, and you have accessed the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>real</I +></SPAN +> + web site at config.privoxy.org.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="NEWADS" +>4.4. How can I submit new ads, or report +problems?</A +></H3 +><P +>Please see the <A +HREF="contact.html" +>Contact section</A +> for +various ways to interact with the developers.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="NEWADS2" +>4.5. If I do submit missed ads, will +they be included in future updates?</A +></H3 +><P +> Whether such submissions are eventually included in the + <TT +CLASS="FILENAME" +>default.action</TT +> configuration file depends on how + significant the issue is. We of course want to address any potential + problem with major, high-profile sites such as <I +CLASS="CITETITLE" +>Google</I +>, + <I +CLASS="CITETITLE" +>Yahoo</I +>, etc. Any site with global or regional reach, + has a good chance of being a candidate. But at the other end of the spectrum + are any number of smaller, low-profile sites such as for local clubs or + schools. Since their reach and impact are much less, they are best handled by + inclusion in the user's <TT +CLASS="FILENAME" +>user.action</TT +>, and thus would be + unlikely to be included. </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="NOONECARES" +>4.6. Why doesn't anyone answer my support +request?</A +></H3 +><P +>Rest assured that it has been read and considered. Why it is not answered, +could be for various reasons, including no one has a good answer for it, no +one has had time to yet investigate it thoroughly, it has been reported +numerous times already, or because not enough information was provided to help +us help you. Your efforts are not wasted, and we do appreciate them.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="IP" +>4.7. How can I hide my IP address?</A +></H3 +><P +> If you run both the browser and <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> locally, you cannot hide your IP + address with <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> or ultimately any other + software alone. The server needs to know your IP address so that it knows + where to send the responses back. </P +><P +> There are many publicly usable "anonymous" proxies out there, which + provide a further level of indirection between you and the web server.</P +><P +> However, these proxies are called "anonymous" because you don't need + to authenticate, not because they would offer any real anonymity. + Most of them will log your IP address and make it available to the + authorities in case you violate the law of the country they run in. In fact + you can't even rule out that some of them only exist to *collect* information + on (those suspicious) people with a more than average preference for privacy.</P +><P +> If you want to hide your IP address from most adversaries, + you should consider chaining <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + with <A +HREF="https://www.torproject.org/" +TARGET="_top" +>Tor</A +>. + The configuration details can be found in + <A +HREF="#TOR" +TARGET="_top" +>How do I use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> together + with <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> section</A +> + just below.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN794" +>4.8. Can Privoxy guarantee I am anonymous?</A +></H3 +><P +> No. Your chances of remaining anonymous are improved, but unless you + <A +HREF="#TOR" +TARGET="_top" +>chain <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with <SPAN +CLASS="APPLICATION" +>Tor</SPAN +></A +> + or a similar proxy and know what you're doing when it comes to configuring + the rest of your system, you should assume that everything you do + on the Web can be traced back to you.</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can remove various information about you, + and allows <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>you</I +></SPAN +> more freedom to decide which sites + you can trust, and what details you want to reveal. But it neither + hides your IP address, nor can it guarantee that the rest of the system + behaves correctly. There are several possibilities how a web sites can find + out who you are, even if you are using a strict <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + configuration and chained it with <SPAN +CLASS="APPLICATION" +>Tor</SPAN +>.</P +><P +> Most of <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> privacy-enhancing features can be easily subverted + by an insecure browser configuration, therefore you should use a browser that can + be configured to only execute code from trusted sites, and be careful which sites you trust. + For example there is no point in having <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + modify the User-Agent header, if websites can get all the information they want + through JavaScript, ActiveX, Flash, Java etc.</P +><P +> A few browsers disclose the user's email address in certain situations, such + as when transferring a file by FTP. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + does not filter FTP. If you need this feature, or are concerned about the + mail handler of your browser disclosing your email address, you might + consider products such as <SPAN +CLASS="APPLICATION" +>NSClean</SPAN +>.</P +><P +> Browsers available only as binaries could use non-standard headers to give + out any information they can have access to: see the manufacturer's license + agreement. It's impossible to anticipate and prevent every breach of privacy + that might occur. The professionally paranoid prefer browsers available as + source code, because anticipating their behavior is easier. Trust the source, + Luke!</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN812" +>4.9. A test site says I am not using a Proxy.</A +></H3 +><P +> Good! Actually, they are probably testing for some other kinds of proxies. + Hiding yourself completely would require additional steps.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="TOR" +>4.10. How do I use Privoxy + together with Tor?</A +></H3 +><P +> Before you configure <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to use + <A +HREF="https://www.torproject.org/" +TARGET="_top" +>Tor</A +>, + please follow the <I +CLASS="CITETITLE" +>User Manual</I +> chapters + <A +HREF="../user-manual/installation.html" +TARGET="_top" +>2. Installation</A +> and + <A +HREF="../user-manual/startup.html" +TARGET="_top" +>5. Startup</A +> to make sure + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> itself is setup correctly.</P +><P +> + If it is, refer to <A +HREF="https://www.torproject.org/documentation.html" +TARGET="_top" +>Tor's + extensive documentation</A +> to learn how to install <SPAN +CLASS="APPLICATION" +>Tor</SPAN +>, + and make sure <SPAN +CLASS="APPLICATION" +>Tor</SPAN +>'s logfile says that + <SPAN +CLASS="QUOTE" +>"Tor has successfully opened a circuit"</SPAN +> and it + <SPAN +CLASS="QUOTE" +>"looks like client functionality is working"</SPAN +>.</P +><P +> If either <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> or <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + isn't working, their combination most likely will neither. Testing them on their + own will also help you to direct problem reports to the right audience. + If <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> isn't working, don't bother the + <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> developers. If <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> + isn't working, don't send bug reports to the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> Team.</P +><P +> If you verified that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> + are working, it is time to connect them. As far as <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + is concerned, <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> is just another proxy that can be reached + by socks4 or socks4a. Most likely you are interested in <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> + to increase your anonymity level, therefore you should use socks4a, to make sure DNS requests are + done through <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> and thus invisible to your local network.</P +><P +> Since <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> 3.0.5, its + <A +HREF="../user-manual/config.html" +TARGET="_top" +>main configuration file</A +> + is already prepared for <SPAN +CLASS="APPLICATION" +>Tor</SPAN +>, if you are using a + default <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> configuration and run it on the same + system as <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, you just have to edit the + <A +HREF="../user-manual/config.html#FORWARDING" +TARGET="_top" +>forwarding section</A +> + and uncomment the line:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># forward-socks4a / 127.0.0.1:9050 . + </PRE +></TD +></TR +></TABLE +></P +><P +> This is enough to reach the Internet, but additionally you might want to + uncomment the following forward rules, to make sure your local network is still + reachable through Privoxy:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># forward 192.168.*.*/ . # forward 10.*.*.*/ . # forward 127.*.*.*/ . - -</pre> - </td> - </tr> - </table> - - <p>Unencrypted connections to systems in these address ranges will be - as (un)secure as the local network is, but the alternative is that your - browser can't reach the network at all. Then again, that may actually - be desired and if you don't know for sure that your browser has to be - able to reach the local network, there's no reason to allow it.</p> - - <p>If you want your browser to be able to reach servers in your local - network by using their names, you will need additional exceptions that - look like this:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# forward localhost/ . - -</pre> - </td> - </tr> - </table> - - <p>Save the modified configuration file and open <a href= - "http://config.privoxy.org/show-status" target= - "_top">http://config.privoxy.org/show-status/</a> in your browser, - confirm that <span class="APPLICATION">Privoxy</span> has reloaded its - configuration and that there are no other forward lines, unless you - know that you need them. If everything looks good, refer to <a href= - "https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#IsMyConnectionPriv..." - target="_top">Tor Faq 4.2</a> to learn how to verify that you are - really using <span class="APPLICATION">Tor</span>.</p> - - <p>Afterward, please take the time to at least skim through the rest of - <span class="APPLICATION">Tor's</span> documentation. Make sure you - understand what <span class="APPLICATION">Tor</span> does, why it is no - replacement for application level security, and why you probably don't - want to use it for unencrypted logins.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN877" id="AEN877">4.11. Might some things - break because header information or content is being altered?</a></h3> - - <p>Definitely. It is common for sites to use browser type, browser - version, HTTP header content, and various other techniques in order to - dynamically decide what to display and how to display it. What you see, - and what I see, might be very different. There are many, many ways that - this can be handled, so having hard and fast rules, is tricky.</p> - - <p>The <span class="QUOTE">"User-Agent"</span> is sometimes used in - this way to identify the browser, and adjust content accordingly.</p> - - <p>Also, different browsers use different encodings of non-English - characters, certain web servers convert pages on-the-fly according to - the User Agent header. Giving a <span class="QUOTE">"User Agent"</span> - with the wrong operating system or browser manufacturer causes some - sites in these languages to be garbled; Surfers to Eastern European - sites should change it to something closer. And then some page access - counters work by looking at the <span class="QUOTE">"Referer"</span> - header; they may fail or break if unavailable. The weather maps of - Intellicast have been blocked by their server when no <span class= - "QUOTE">"Referer"</span> or cookie is provided, is another example. - (But you can forge both headers without giving information away). There - are many other ways things can go wrong when trying to fool a web - server. The results of which could inadvertently cause pages to load - incorrectly, partially, or even not at all. And there may be no obvious - clues as to just what went wrong, or why. Nowhere will there be a - message that says <span class="QUOTE">"<span class= - "emphasis EMPHASIS c2">Turn off <tt class="LITERAL">fast-redirects</tt> - or else!</span> "</span></p> - - <p>Similar thoughts apply to modifying JavaScript, and, to a lesser - degree, HTML elements.</p> - - <p>If you have problems with a site, you will have to adjust your - configuration accordingly. Cookies are probably the most likely - adjustment that may be required, but by no means the only one.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN891" id="AEN891">4.12. Can Privoxy act as - a <span class="QUOTE">"caching"</span> proxy to speed up web - browsing?</a></h3> - - <p>No, it does not have this ability at all. You want something like - <a href="http://www.squid-cache.org/" target="_top">Squid</a> or - <a href="http://www.pps.jussieu.fr/~jch/software/polipo/" target= - "_top">Polipo</a> for this. And, yes, before you ask, <span class= - "APPLICATION">Privoxy</span> can co-exist with other kinds of proxies - like <span class="APPLICATION">Squid</span>. See the <a href= - "../user-manual/config.html#FORWARDING" target="_top">forwarding - chapter</a> in the <a href="../user-manual/index.html" target= - "_top">user manual</a> for details.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN901" id="AEN901">4.13. What about as a - firewall? Can Privoxy protect me?</a></h3> - - <p>Not in the way you mean, or in the way some firewall vendors claim - they can. <span class="APPLICATION">Privoxy</span> can help protect - your privacy, but can't protect your system from intrusion attempts. It - is, of course, perfectly possible to use <span class= - "emphasis EMPHASIS c2">both</span>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN906" id="AEN906">4.14. I have large empty - spaces / a checkerboard pattern now where ads used to be. Why?</a></h3> - - <p>It is technically possible to eliminate banners and ads in a way - that frees their allocated page space. This could easily be done by - blocking with <span class="APPLICATION">Privoxy's</span> filters, and - eliminating the <span class="emphasis EMPHASIS c2">entire</span> image - references from the HTML page source.</p> - - <p>But, this would consume considerably more CPU resources (IOW, slow - things down), would likely destroy the layout of some web pages which - rely on the banners utilizing a certain amount of page space, and might - fail in other cases, where the screen space is reserved (e.g. by HTML - tables for instance). Also, making ads and banners disappear without - any trace complicates troubleshooting, and would sooner or later be - problematic.</p> - - <p>The better alternative is to instead let them stay, and block the - resulting requests for the banners themselves as is now the case. This - leaves either empty space, or the familiar checkerboard pattern.</p> - - <p>So the developers won't support this in the default configuration, - but you can of course define appropriate filters yourself to achieve - this.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN914" id="AEN914">4.15. How can Privoxy - filter Secure (HTTPS) URLs?</a></h3> - - <p>Since secure HTTP connections are encrypted SSL sessions between - your browser and the secure site, and are meant to be reliably - <span class="emphasis EMPHASIS c2">secure</span>, there is little that - <span class="APPLICATION">Privoxy</span> can do but hand the raw - gibberish data though from one end to the other unprocessed.</p> - - <p>The only exception to this is blocking by host patterns, as the - client needs to tell <span class="APPLICATION">Privoxy</span> the name - of the remote server, so that <span class="APPLICATION">Privoxy</span> - can establish the connection. If that name matches a host-only pattern, - the connection will be blocked.</p> - - <p>As far as ad blocking is concerned, this is less of a restriction - than it may seem, since ad sources are often identifiable by the host - name, and often the banners to be placed in an encrypted page come - unencrypted nonetheless for efficiency reasons, which exposes them to - the full power of <span class="APPLICATION">Privoxy</span>'s ad - blocking.</p> - - <p><span class="QUOTE">"Content cookies"</span> (those that are - embedded in the actual HTML or JS page content, see <tt class= - "LITERAL"><a href= - "../user-manual/actions-file.html#FILTER-CONTENT-COOKIES" target= - "_top">filter{content-cookies}</a></tt>), in an SSL transaction will be - impossible to block under these conditions. Fortunately, this does not - seem to be a very common scenario since most cookies come by - traditional means.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN928" id="AEN928">4.16. Privoxy runs as a - <span class="QUOTE">"server"</span>. How secure is it? Do I need to - take any special precautions?</a></h3> - - <p>On Unix-like systems, <span class="APPLICATION">Privoxy</span> can - run as a non-privileged user, which is how we recommend it be run. - Also, by default <span class="APPLICATION">Privoxy</span> listens to - requests from <span class="QUOTE">"localhost"</span> only.</p> - - <p>The server aspect of <span class="APPLICATION">Privoxy</span> is not - itself directly exposed to the Internet in this configuration. If you - want to have <span class="APPLICATION">Privoxy</span> serve as a LAN - proxy, this will have to be opened up to allow for LAN requests. In - this case, we'd recommend you specify only the LAN gateway address, - e.g. 192.168.1.1, in the main <span class="APPLICATION">Privoxy</span> - configuration file and check all <a href= - "../user-manual/config.html#ACCESS-CONTROL" target="_top">access - control and security options</a>. All LAN hosts can then use this as - their proxy address in the browser proxy configuration, but - <span class="APPLICATION">Privoxy</span> will not listen on any - external interfaces. ACLs can be defined in addition, and using a - firewall is always good too. Better safe than sorry.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="TURNOFF" id="TURNOFF">4.17. Can I - temporarily disable Privoxy?</a></h3> - - <p><span class="APPLICATION">Privoxy</span> doesn't have a transparent - proxy mode, but you can toggle off blocking and content filtering.</p> - - <p>The easiest way to do that is to point your browser to the remote - toggle URL: <a href="http://config.privoxy.org/toggle" target= - "_top">http://config.privoxy.org/toggle</a>.</p> - - <p>See the <a href="../user-manual/appendix.html#BOOKMARKLETS" target= - "_top">Bookmarklets section</a> of the <i class="CITETITLE">User - Manual</i> for an easy way to access this feature. Note that this is a - feature that may need to be enabled in the main <tt class= - "FILENAME">config</tt> file.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="REALLYOFF" id="REALLYOFF">4.18. When - <span class="QUOTE">"disabled"</span> is Privoxy totally out of the - picture?</a></h3> - - <p>No, this just means all optional filtering and actions are disabled. - <span class="APPLICATION">Privoxy</span> is still acting as a proxy, - but just doing less of the things that <span class= - "APPLICATION">Privoxy</span> would normally be expected to do. It is - still a <span class="QUOTE">"middle-man"</span> in the interaction - between your browser and web sites. See below to bypass the proxy.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="TURNOFF2" id="TURNOFF2">4.19. How can I tell - Privoxy to totally ignore certain sites?</a></h3> - - <p>Bypassing a proxy, or proxying based on arbitrary criteria, is - purely a browser configuration issue, not a <span class= - "APPLICATION">Privoxy</span> issue. Modern browsers typically do have - settings for not proxying certain sites. Check your browser's help - files.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="CRUNCH" id="CRUNCH">4.20. My logs show - Privoxy <span class="QUOTE">"crunches"</span> ads, but also its own - internal CGI pages. What is a <span class= - "QUOTE">"crunch"</span>?</a></h3> - - <p>A <span class="QUOTE">"crunch"</span> simply means <span class= - "APPLICATION">Privoxy</span> intercepted <span class= - "emphasis EMPHASIS c2">something</span>, nothing more. Often this is - indeed ads or banners, but <span class="APPLICATION">Privoxy</span> - uses the same mechanism for trapping requests for its own internal - pages. For instance, a request for <span class= - "APPLICATION">Privoxy's</span> configuration page at: <a href= - "http://config.privoxy.org" target= - "_top">http://config.privoxy.org</a>, is intercepted (i.e. it does not - go out to the 'net), and the familiar CGI configuration is returned to - the browser, and the log consequently will show a <span class= - "QUOTE">"crunch"</span>.</p> - - <p>Since version 3.0.7, Privoxy will also log the crunch reason. If you - are using an older version you might want to upgrade.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="DOWNLOADS" id="DOWNLOADS">4.21. Can Privoxy - effect files that I download from a webserver? FTP server?</a></h3> - - <p>From the webserver's perspective, there is no difference between - viewing a document (i.e. a page), and downloading a file. The same is - true of <span class="APPLICATION">Privoxy</span>. If there is a match - for a <tt class="LITERAL"><a href= - "../user-manual/actions-file.html#BLOCK" target="_top">block</a></tt> - pattern, it will still be blocked, and of course this is obvious.</p> - - <p>Filtering is potentially more of a concern since the results are not - always so obvious, and the effects of filtering are there whether the - file is simply viewed, or downloaded. And potentially whether the - content is some obnoxious advertisement, or Mr. Jimmy's latest/greatest - source code jewel. Of course, one of these presumably is <span class= - "QUOTE">"bad"</span> content that we don't want, and the other is - <span class="QUOTE">"good"</span> content that we do want. <span class= - "APPLICATION">Privoxy</span> is blind to the differences, and can only - distinguish <span class="QUOTE">"good from bad"</span> by the - configuration parameters <span class="emphasis EMPHASIS c2">we</span> - give it.</p> - - <p><span class="APPLICATION">Privoxy</span> knows the differences in - files according to the <span class="QUOTE">"Content Type"</span> as - reported by the webserver. If this is reported accurately (e.g. - <span class="QUOTE">"application/zip"</span> for a zip archive), then - <span class="APPLICATION">Privoxy</span> knows to ignore these where - appropriate. <span class="APPLICATION">Privoxy</span> potentially can - filter HTML as well as plain text documents, subject to configuration - parameters of course. Also, documents that are of an unknown type - (generally assumed to be <span class="QUOTE">"text/plain"</span>) can - be filtered, as will those that might be incorrectly reported by the - webserver. If such a file is a downloaded file that is intended to be - saved to disk, then any content that might have been altered by - filtering, will be saved too, for these (probably rare) cases.</p> - - <p>Note that versions later than 3.0.2 do NOT filter document types - reported as <span class="QUOTE">"text/plain"</span>. Prior to this, - <span class="APPLICATION">Privoxy</span> did filter this document - type.</p> - - <p>In short, filtering is <span class="QUOTE">"ON"</span> if a) the - content type as reported by the webserver is appropriate <span class= - "emphasis EMPHASIS c2">and</span> b) the configuration allows it (or at - least does not disallow it). That's it. There is no magic cookie - anywhere to say this is <span class="QUOTE">"good"</span> and this is - <span class="QUOTE">"bad"</span>. It's the configuration that lets it - all happen or not.</p> - - <p>If you download text files, you probably do not want these to be - filtered, particularly if the content is source code, or other critical - content. Source code sometimes might be mistaken for Javascript (i.e. - the kind that might open a pop-up window). It is recommended to turn - off filtering for download sites (particularly if the content may be - plain text files and you are using version 3.0.2 or earlier) in your - <tt class="FILENAME">user.action</tt> file. And also, for any site or - page where making <span class="emphasis EMPHASIS c2">any</span> changes - at all to the content is to be avoided.</p> - - <p><span class="APPLICATION">Privoxy</span> does not do FTP at all, - only HTTP and HTTPS (SSL) protocols.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="DOWNLOADS2" id="DOWNLOADS2">4.22. I just - downloaded a Perl script, and Privoxy altered it! Yikes, what is - wrong!</a></h3> - - <p>Please read above.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="HOSTSFILE" id="HOSTSFILE">4.23. Should I - continue to use a <span class="QUOTE">"HOSTS"</span> file for - ad-blocking?</a></h3> - - <p>One time-tested technique to defeat common ads is to trick the local - DNS system by giving a phony IP address for the ad generator in the - local <tt class="FILENAME">HOSTS</tt> file, typically using <tt class= - "LITERAL">127.0.0.1</tt>, aka <tt class="LITERAL">localhost</tt>. This - effectively blocks the ad.</p> - - <p>There is no reason to use this technique in conjunction with - <span class="APPLICATION">Privoxy</span>. <span class= - "APPLICATION">Privoxy</span> does essentially the same thing, much more - elegantly and with much more flexibility. A large <tt class= - "FILENAME">HOSTS</tt> file, in fact, not only duplicates effort, but - may get in the way and seriously slow down your system. It is - recommended to remove such entries from your <tt class= - "FILENAME">HOSTS</tt> file. If you think your hosts list is neglected - by <span class="APPLICATION">Privoxy's</span> configuration, consider - adding your list to your <tt class="FILENAME">user.action</tt> - file:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - { +block } + </PRE +></TD +></TR +></TABLE +></P +><P +> Unencrypted connections to systems in these address ranges will + be as (un)secure as the local network is, but the alternative is + that your browser can't reach the network at all. Then again, + that may actually be desired and if you don't know for sure + that your browser has to be able to reach the local network, + there's no reason to allow it.</P +><P +> If you want your browser to be able to reach servers in your local + network by using their names, you will need additional exceptions + that look like this:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># forward localhost/ . + </PRE +></TD +></TR +></TABLE +></P +><P +> Save the modified configuration file and open + <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status/</A +> + in your browser, confirm that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> has reloaded its configuration + and that there are no other forward lines, unless you know that you need them. If everything looks good, + refer to + <A +HREF="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#IsMyConnectionPriv..." +TARGET="_top" +>Tor + Faq 4.2</A +> to learn how to verify that you are really using <SPAN +CLASS="APPLICATION" +>Tor</SPAN +>.</P +><P +> Afterward, please take the time to at least skim through the rest + of <SPAN +CLASS="APPLICATION" +>Tor's</SPAN +> documentation. Make sure you understand + what <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> does, why it is no replacement for + application level security, and why you probably don't want to + use it for unencrypted logins.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN868" +>4.11. Might some things break because header information or +content is being altered?</A +></H3 +><P +> Definitely. It is common for sites to use browser type, browser version, + HTTP header content, and various other techniques in order to dynamically + decide what to display and how to display it. What you see, and what I see, + might be very different. There are many, many ways that this can be handled, + so having hard and fast rules, is tricky.</P +><P +> The <SPAN +CLASS="QUOTE" +>"User-Agent"</SPAN +> is sometimes used in this way to identify + the browser, and adjust content accordingly.</P +><P +> Also, different browsers use different encodings of non-English + characters, certain web servers convert pages on-the-fly according to the + User Agent header. Giving a <SPAN +CLASS="QUOTE" +>"User Agent"</SPAN +> with the wrong + operating system or browser manufacturer causes some sites in these languages + to be garbled; Surfers to Eastern European sites should change it to + something closer. And then some page access counters work by looking at the + <SPAN +CLASS="QUOTE" +>"Referer"</SPAN +> header; they may fail or break if unavailable. The + weather maps of Intellicast have been blocked by their server when no + <SPAN +CLASS="QUOTE" +>"Referer"</SPAN +> or cookie is provided, is another example. (But you + can forge both headers without giving information away). There are + many other ways things can go wrong when trying to fool a web server. The + results of which could inadvertently cause pages to load incorrectly, + partially, or even not at all. And there may be no obvious clues as to just + what went wrong, or why. Nowhere will there be a message that says + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Turn off <TT +CLASS="LITERAL" +>fast-redirects</TT +> or else!</I +></SPAN +> + "</SPAN +></P +><P +> Similar thoughts apply to modifying JavaScript, and, to a lesser degree, + HTML elements.</P +><P +> If you have problems with a site, you will have to adjust your configuration + accordingly. Cookies are probably the most likely adjustment that may + be required, but by no means the only one.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN882" +>4.12. Can Privoxy act as a <SPAN +CLASS="QUOTE" +>"caching"</SPAN +> proxy to +speed up web browsing?</A +></H3 +><P +> No, it does not have this ability at all. You want something like + <A +HREF="http://www.squid-cache.org/" +TARGET="_top" +>Squid</A +> or + <A +HREF="http://www.pps.jussieu.fr/~jch/software/polipo/" +TARGET="_top" +>Polipo</A +> for this. + And, yes, before you ask, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can co-exist + with other kinds of proxies like <SPAN +CLASS="APPLICATION" +>Squid</SPAN +>. + See the <A +HREF="../user-manual/config.html#FORWARDING" +TARGET="_top" +>forwarding + chapter</A +> in the <A +HREF="../user-manual/index.html" +TARGET="_top" +>user + manual</A +> for details.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN892" +>4.13. What about as a firewall? Can Privoxy protect me?</A +></H3 +><P +> Not in the way you mean, or in the way some firewall vendors claim they can. + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can help protect your privacy, but can't + protect your system from intrusion attempts. It is, of course, perfectly possible + to use <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>both</I +></SPAN +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN897" +>4.14. I have large empty spaces / a checkerboard pattern now where +ads used to be. Why?</A +></H3 +><P +> It is technically possible to eliminate banners and ads in a way that frees + their allocated page space. This could easily be done by blocking with + <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> filters, + and eliminating the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>entire</I +></SPAN +> image references from the + HTML page source. </P +><P +> But, this would consume considerably more CPU resources (IOW, slow things + down), would likely destroy the layout of some web pages which rely on the + banners utilizing a certain amount of page space, and might fail in other + cases, where the screen space is reserved (e.g. by HTML tables for instance). + Also, making ads and banners disappear without any trace complicates + troubleshooting, and would sooner or later be problematic.</P +><P +> The better alternative is to instead let them stay, and block the resulting + requests for the banners themselves as is now the case. This leaves either + empty space, or the familiar checkerboard pattern.</P +><P +> So the developers won't support this in the default configuration, but you + can of course define appropriate filters yourself to achieve this.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN905" +>4.15. How can Privoxy filter Secure (HTTPS) URLs?</A +></H3 +><P +> Since secure HTTP connections are encrypted SSL sessions between your browser + and the secure site, and are meant to be reliably <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>secure</I +></SPAN +>, + there is little that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can do but hand the raw + gibberish data though from one end to the other unprocessed.</P +><P +> The only exception to this is blocking by host patterns, as the client needs + to tell <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> the name of the remote server, + so that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can establish the connection. + If that name matches a host-only pattern, the connection will be blocked.</P +><P +> As far as ad blocking is concerned, this is less of a restriction than it may + seem, since ad sources are often identifiable by the host name, and often + the banners to be placed in an encrypted page come unencrypted nonetheless + for efficiency reasons, which exposes them to the full power of + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s ad blocking.</P +><P +> <SPAN +CLASS="QUOTE" +>"Content cookies"</SPAN +> (those that are embedded in the actual HTML or + JS page content, see <TT +CLASS="LITERAL" +><A +HREF="../user-manual/actions-file.html#FILTER-CONTENT-COOKIES" +TARGET="_top" +>filter{content-cookies}</A +></TT +>), + in an SSL transaction will be impossible to block under these conditions. + Fortunately, this does not seem to be a very common scenario since most + cookies come by traditional means.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN919" +>4.16. Privoxy runs as a <SPAN +CLASS="QUOTE" +>"server"</SPAN +>. How +secure is it? Do I need to take any special precautions?</A +></H3 +><P +> On Unix-like systems, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can run as a non-privileged + user, which is how we recommend it be run. Also, by default + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> listens to requests from <SPAN +CLASS="QUOTE" +>"localhost"</SPAN +> + only.</P +><P +> The server aspect of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is not itself directly + exposed to the Internet in this configuration. If you want to have + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> serve as a LAN proxy, this will have to + be opened up to allow for LAN requests. In this case, we'd recommend + you specify only the LAN gateway address, e.g. 192.168.1.1, in the main + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> configuration file and check all <A +HREF="../user-manual/config.html#ACCESS-CONTROL" +TARGET="_top" +>access control and security + options</A +>. All LAN hosts can then use this as their proxy address + in the browser proxy configuration, but <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + will not listen on any external interfaces. ACLs can be defined in addition, + and using a firewall is always good too. Better safe than sorry.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="TURNOFF" +>4.17. Can I temporarily disable Privoxy?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> doesn't have a transparent proxy mode, + but you can toggle off blocking and content filtering.</P +><P +> The easiest way to do that is to point your browser + to the remote toggle URL: <A +HREF="http://config.privoxy.org/toggle" +TARGET="_top" +>http://config.privoxy.org/toggle</A +>.</P +><P +> See the <A +HREF="../user-manual/appendix.html#BOOKMARKLETS" +TARGET="_top" +>Bookmarklets section</A +> + of the <I +CLASS="CITETITLE" +>User Manual</I +> for an easy way to access this + feature. Note that this is a feature that may need to be enabled in the main + <TT +CLASS="FILENAME" +>config</TT +> file.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="REALLYOFF" +>4.18. When <SPAN +CLASS="QUOTE" +>"disabled"</SPAN +> is Privoxy totally +out of the picture?</A +></H3 +><P +> No, this just means all optional filtering and actions are disabled. + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is still acting as a proxy, but just + doing less of the things that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> would + normally be expected to do. It is still a <SPAN +CLASS="QUOTE" +>"middle-man"</SPAN +> in + the interaction between your browser and web sites. See below to bypass + the proxy.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="TURNOFF2" +>4.19. How can I tell Privoxy to totally ignore certain sites?</A +></H3 +><P +> Bypassing a proxy, or proxying based on arbitrary criteria, is purely a browser + configuration issue, not a <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> issue. Modern browsers typically do have + settings for not proxying certain sites. Check your browser's help files.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="CRUNCH" +>4.20. My logs show Privoxy <SPAN +CLASS="QUOTE" +>"crunches"</SPAN +> +ads, but also its own internal CGI pages. What is a <SPAN +CLASS="QUOTE" +>"crunch"</SPAN +>?</A +></H3 +><P +> A <SPAN +CLASS="QUOTE" +>"crunch"</SPAN +> simply means <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> intercepted + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>something</I +></SPAN +>, nothing more. Often this is indeed ads or + banners, but <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> uses the same mechanism for + trapping requests for its own internal pages. For instance, a request for + <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> configuration page at: <A +HREF="http://config.privoxy.org" +TARGET="_top" +>http://config.privoxy.org</A +>, is + intercepted (i.e. it does not go out to the 'net), and the familiar CGI + configuration is returned to the browser, and the log consequently will show + a <SPAN +CLASS="QUOTE" +>"crunch"</SPAN +>.</P +><P +> Since version 3.0.7, Privoxy will also log the crunch reason. + If you are using an older version you might want to upgrade.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="DOWNLOADS" +>4.21. Can Privoxy effect files that I download +from a webserver? FTP server?</A +></H3 +><P +> From the webserver's perspective, there is no difference between + viewing a document (i.e. a page), and downloading a file. The same is true of + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. If there is a match for a <TT +CLASS="LITERAL" +><A +HREF="../user-manual/actions-file.html#BLOCK" +TARGET="_top" +>block</A +></TT +> pattern, + it will still be blocked, and of course this is obvious. + </P +><P +> Filtering is potentially more of a concern since the results are not always + so obvious, and the effects of filtering are there whether the file is simply + viewed, or downloaded. And potentially whether the content is some obnoxious + advertisement, or Mr. Jimmy's latest/greatest source code jewel. Of course, + one of these presumably is <SPAN +CLASS="QUOTE" +>"bad"</SPAN +> content that we don't want, and + the other is <SPAN +CLASS="QUOTE" +>"good"</SPAN +> content that we do want. + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is blind to the differences, and can only + distinguish <SPAN +CLASS="QUOTE" +>"good from bad"</SPAN +> by the configuration parameters + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>we</I +></SPAN +> give it.</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> knows the differences in files according + to the <SPAN +CLASS="QUOTE" +>"Content Type"</SPAN +> as reported by the webserver. If this is + reported accurately (e.g. <SPAN +CLASS="QUOTE" +>"application/zip"</SPAN +> for a zip archive), + then <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> knows to ignore these where + appropriate. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> potentially can filter HTML + as well as plain text documents, subject to configuration parameters of + course. Also, documents that are of an unknown type (generally assumed to be + <SPAN +CLASS="QUOTE" +>"text/plain"</SPAN +>) can be filtered, as will those that might be + incorrectly reported by the webserver. If such a file is a downloaded file + that is intended to be saved to disk, then any content that might have been + altered by filtering, will be saved too, for these (probably rare) cases.</P +><P +> Note that versions later than 3.0.2 do NOT filter document types reported as + <SPAN +CLASS="QUOTE" +>"text/plain"</SPAN +>. Prior to this, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + did filter this document type.</P +><P +> In short, filtering is <SPAN +CLASS="QUOTE" +>"ON"</SPAN +> if a) the content type as reported + by the webserver is appropriate <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>and</I +></SPAN +> b) the configuration + allows it (or at least does not disallow it). That's it. There is no magic + cookie anywhere to say this is <SPAN +CLASS="QUOTE" +>"good"</SPAN +> and this is + <SPAN +CLASS="QUOTE" +>"bad"</SPAN +>. It's the configuration that lets it all happen or not.</P +><P +> If you download text files, you probably do not want these to be filtered, + particularly if the content is source code, or other critical content. Source + code sometimes might be mistaken for Javascript (i.e. the kind that might + open a pop-up window). It is recommended to turn off filtering for download + sites (particularly if the content may be plain text files and you are using + version 3.0.2 or earlier) in your <TT +CLASS="FILENAME" +>user.action</TT +> file. And + also, for any site or page where making <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>any</I +></SPAN +> changes at + all to the content is to be avoided.</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> does not do FTP at all, only HTTP + and HTTPS (SSL) protocols.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="DOWNLOADS2" +>4.22. I just downloaded a Perl script, and Privoxy +altered it! Yikes, what is wrong!</A +></H3 +><P +> Please read above.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="HOSTSFILE" +>4.23. Should I continue to use a <SPAN +CLASS="QUOTE" +>"HOSTS"</SPAN +> file for ad-blocking?</A +></H3 +><P +> One time-tested technique to defeat common ads is to trick the local DNS + system by giving a phony IP address for the ad generator in the local + <TT +CLASS="FILENAME" +>HOSTS</TT +> file, typically using <TT +CLASS="LITERAL" +>127.0.0.1</TT +>, aka + <TT +CLASS="LITERAL" +>localhost</TT +>. This effectively blocks the ad.</P +><P +> There is no reason to use this technique in conjunction with + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + does essentially the same thing, much more elegantly and with much more + flexibility. A large <TT +CLASS="FILENAME" +>HOSTS</TT +> file, in fact, not only + duplicates effort, but may get in the way and seriously slow down your system. + It is recommended to remove such entries from your <TT +CLASS="FILENAME" +>HOSTS</TT +> file. If you think + your hosts list is neglected by <SPAN +CLASS="APPLICATION" +>Privoxy's </SPAN +> + configuration, consider adding your list to your <TT +CLASS="FILENAME" +>user.action</TT +> file:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> { +block } www.ad.example1.com ad.example2.com ads.galore.example.com - etc.example.com -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="SEEALSO" id="SEEALSO">4.24. Where can I find - more information about Privoxy and related issues?</a></h3> - - <p>Other references and sites of interest to <span class= - "APPLICATION">Privoxy</span> users:</p> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.privoxy.org/" target= - "_top">http://www.privoxy.org/</a>, the <span class= - "APPLICATION">Privoxy</span> Home page.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.privoxy.org/faq/" target= - "_top">http://www.privoxy.org/faq/</a>, the <span class= - "APPLICATION">Privoxy</span> FAQ.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.privoxy.org/developer-manual/" target= - "_top">http://www.privoxy.org/developer-manual/</a>, the - <span class="APPLICATION">Privoxy</span> developer manual.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="https://sourceforge.net/projects/ijbswa/" target= - "_top">https://sourceforge.net/projects/ijbswa/</a>, the Project - Page for <span class="APPLICATION">Privoxy</span> on <a href= - "http://sourceforge.net" target="_top">SourceForge</a>.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://config.privoxy.org/" target= - "_top">http://config.privoxy.org/</a>, the web-based user - interface. <span class="APPLICATION">Privoxy</span> must be - running for this to work. Shortcut: <a href="http://p.p/" target= - "_top">http://p.p/</a></td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href= - "https://sourceforge.net/tracker/?group_id=11118&atid=460288" - target= - "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>, - to submit <span class="QUOTE">"misses"</span> and other - configuration related suggestions to the developers.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.junkbusters.com/ht/en/cookies.html" - target="_top">http://www.junkbusters.com/ht/en/cookies.html</a>, - an explanation how cookies are used to track web users.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.junkbusters.com/ijb.html" target= - "_top">http://www.junkbusters.com/ijb.html</a>, the original - Internet Junkbuster.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.squid-cache.org/" target= - "_top">http://www.squid-cache.org/</a>, a popular caching proxy, - which is often used together with <span class= - "APPLICATION">Privoxy</span>.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.pps.jussieu.fr/~jch/software/polipo/" - target= - "_top">http://www.pps.jussieu.fr/~jch/software/polipo/</a>, - <span class="APPLICATION">Polipo</span> is a caching proxy with - advanced features like pipelining, multiplexing and caching of - partial instances. In many setups it can be used as <span class= - "APPLICATION">Squid</span> replacement.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="https://www.torproject.org/" target= - "_top">https://www.torproject.org/</a>, <span class= - "APPLICATION">Tor</span> can help anonymize web browsing, web - publishing, instant messaging, IRC, SSH, and other - applications.</td> - </tr> - </tbody> - </table> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="MICROSUCK" id="MICROSUCK">4.25. I've noticed - that Privoxy changes <span class="QUOTE">"Microsoft"</span> to - <span class="QUOTE">"MicroSuck"</span>! Why are you manipulating my - browsing?</a></h3> - - <p>We're not. The text substitutions that you are seeing are disabled - in the default configuration as shipped. You have either manually - activated the <span class="QUOTE">"<tt class="LITERAL">fun</tt>"</span> - filter which is clearly labeled <span class="QUOTE">"Text replacements - for subversive browsing fun!"</span> or you are using an older Privoxy - version and have implicitly activated it by choosing the <span class= - "QUOTE">"Advanced"</span> profile in the web-based editor. Please - upgrade.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="VALID" id="VALID">4.26. Does Privoxy produce - <span class="QUOTE">"valid"</span> HTML (or XHTML)?</a></h3> - - <p>Privoxy generates HTML in both its own <span class= - "QUOTE">"templates"</span>, and possibly whenever there are text - substitutions via a <span class="APPLICATION">Privoxy</span> filter. - While this should always conform to the HTML 4.01 specifications, it - has not been validated against this or any other standard.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="SURPRISE-PRIVOXY" id= - "SURPRISE-PRIVOXY">4.27. How did you manage to get Privoxy on my - computer without my consent?</a></h3> - - <p>We didn't. We make Privoxy available for download, but we don't go - around installing it on other people's systems behind their back. If - you discover Privoxy running on your system and are sure you didn't - install it yourself, somebody else did. You may not even be running the - real Privoxy, but maybe something else that only pretends to be - Privoxy, or maybe something that is based on the real Privoxy, but has - been modified.</p> - - <p>Lately there have been reports of problems with some kind of Privoxy - versions that come preinstalled on some Netbooks. Some of the problems - described are inconsistent with the behaviour of official Privoxy - versions, which suggests that the preinstalled software may contain - vendor modifications that we don't know about and thus can't debug.</p> - - <p>Privoxy's <a href="copyright.html">license</a> allows vendor - modifications, but the vendor has to comply with the license, which - involves informing the user about the changes and to make the changes - available under the same license as Privoxy itself.</p> - - <p>If you are having trouble with a modified Privoxy version, please - try to talk to whoever made the modifications before reporting the - problem to us. Please also try to convince whoever made the - modifications to talk to us. If you think somebody gave you a modified - Privoxy version without complying to the license, please let us - know.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href= - "configuration.html" accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="trouble.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Configuration</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Troubleshooting</td> - </tr> - </table> - </div> -</body> -</html> + etc.example.com</PRE +></TD +></TR +></TABLE +></P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="SEEALSO" +>4.24. Where can I find more information about Privoxy +and related issues?</A +></H3 +><P +> Other references and sites of interest to <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + users:</P +><P +> <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/" +TARGET="_top" +>http://www.privoxy.org/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> Home page. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/faq/" +TARGET="_top" +>http://www.privoxy.org/faq/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> FAQ. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/developer-manual/" +TARGET="_top" +>http://www.privoxy.org/developer-manual/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developer manual. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="https://sourceforge.net/projects/ijbswa/" +TARGET="_top" +>https://sourceforge.net/projects/ijbswa/</A +>, + the Project Page for <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on + <A +HREF="http://sourceforge.net" +TARGET="_top" +>SourceForge</A +>. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>http://config.privoxy.org/</A +>, + the web-based user interface. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> must be + running for this to work. Shortcut: <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +> + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="https://sourceforge.net/tracker/?group_id=11118&atid=460288" +TARGET="_top" +>https://sourceforge.net/tracker/?group_id=11118&atid=460288</A +>, to submit <SPAN +CLASS="QUOTE" +>"misses"</SPAN +> and other + configuration related suggestions to the developers. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + + + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.junkbusters.com/ht/en/cookies.html" +TARGET="_top" +>http://www.junkbusters.com/ht/en/cookies.html</A +>, + an explanation how cookies are used to track web users. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +>http://www.junkbusters.com/ijb.html</A +>, + the original Internet Junkbuster. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.squid-cache.org/" +TARGET="_top" +>http://www.squid-cache.org/</A +>, a popular + caching proxy, which is often used together with <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.pps.jussieu.fr/~jch/software/polipo/" +TARGET="_top" +>http://www.pps.jussieu.fr/~jch/software/polipo/</A +>, + <SPAN +CLASS="APPLICATION" +>Polipo</SPAN +> is a caching proxy with advanced features + like pipelining, multiplexing and caching of partial instances. In many setups + it can be used as <SPAN +CLASS="APPLICATION" +>Squid</SPAN +> replacement. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="https://www.torproject.org/" +TARGET="_top" +>https://www.torproject.org/</A +>, + <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> can help anonymize web browsing, + web publishing, instant messaging, IRC, SSH, and other applications. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="MICROSUCK" +>4.25. I've noticed that Privoxy changes <SPAN +CLASS="QUOTE" +>"Microsoft"</SPAN +> to +<SPAN +CLASS="QUOTE" +>"MicroSuck"</SPAN +>! Why are you manipulating my browsing?</A +></H3 +><P +> We're not. The text substitutions that you are seeing are disabled + in the default configuration as shipped. You have either manually + activated the <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +>fun</TT +>"</SPAN +> filter which + is clearly labeled <SPAN +CLASS="QUOTE" +>"Text replacements for subversive browsing + fun!"</SPAN +> or you are using an older Privoxy version and have implicitly + activated it by choosing the <SPAN +CLASS="QUOTE" +>"Advanced"</SPAN +> profile in the + web-based editor. Please upgrade.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="VALID" +>4.26. Does Privoxy produce <SPAN +CLASS="QUOTE" +>"valid"</SPAN +> HTML (or XHTML)?</A +></H3 +><P +> Privoxy generates HTML in both its own <SPAN +CLASS="QUOTE" +>"templates"</SPAN +>, and possibly + whenever there are text substitutions via a <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> filter. While this + should always conform to the HTML 4.01 specifications, it has not been + validated against this or any other standard. </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="configuration.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="trouble.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Configuration</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Troubleshooting</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/faq/trouble.html b/external/privoxy/doc/webserver/faq/trouble.html index 12fc01d..8bc5b70 100644 --- a/external/privoxy/doc/webserver/faq/trouble.html +++ b/external/privoxy/doc/webserver/faq/trouble.html @@ -1,157 +1,239 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Troubleshooting</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy Frequently Asked Questions" href= - "index.html"> - <link rel="PREVIOUS" title="Miscellaneous" href="misc.html"> - <link rel="NEXT" title= - "Contacting the developers, Bug Reporting and Feature Requests" href= - "contact.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - span.c3 {font-style: italic} - table.c2 {background-color: #E0E0E0} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy Frequently Asked - Questions</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="misc.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="contact.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="TROUBLE" id="TROUBLE">5. - Troubleshooting</a></h1> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN1100" id="AEN1100">5.1. I cannot connect - to any websites. Or, I am getting <span class="QUOTE">"connection - refused"</span> message with every web page. Why?</a></h3> - - <p>There are several possibilities:</p> - - <ul> - <li> - <p><span class="APPLICATION">Privoxy</span> is not running. - Solution: verify that <span class="APPLICATION">Privoxy</span> is - installed correctly, has not crashed, and is indeed running. Turn - on <span class="APPLICATION">Privoxy's</span> logging, and look at - the logs to see what they say.</p> - </li> - - <li> - <p>Or your browser is configured for a different port than what - <span class="APPLICATION">Privoxy</span> is using. Solution: verify - that <span class="APPLICATION">Privoxy</span> and your browser are - set to the same port (<tt class="LITERAL">listen-address</tt>).</p> - </li> - - <li> - <p>Or if using a forwarding rule, you have a configuration problem - or a problem with a host in the forwarding chain. Solution: - temporarily alter your configuration and take the forwarders out of - the equation.</p> - </li> - - <li> - <p>Or you have a firewall that is interfering and blocking you. - Solution: try disabling or removing the firewall as a simple - test.</p> - </li> - </ul> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="ERROR503" id="ERROR503">5.2. Why am I - getting a 503 Error (WSAECONNREFUSED) on every page?</a></h3> - - <p>More than likely this is a problem with your TCP/IP networking. - ZoneAlarm has been reported to cause this symptom -- even if not - running! The solution is to either fight the ZA configuration, or - uninstall ZoneAlarm, and then find something better behaved in its - place. Other personal firewall type products may cause similar type - problems if not configured correctly.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="AEN1123" id="AEN1123">5.3. I just added a - new rule, but the steenkin ad is still getting through. How?</a></h3> - - <p>If the ad had been displayed before you added its URL, it will - probably be held in the browser's cache for some time, so it will be - displayed without the need for any request to the server, and - <span class="APPLICATION">Privoxy</span> will not be involved. Flush - the browser's caches, and then try again.</p> - - <p>If this doesn't help, you probably have an error in the rule you - applied. Try pasting the full URL of the offending ad into <a href= - "http://config.privoxy.org/show-url-info" target= - "_top">http://config.privoxy.org/show-url-info</a> and see if it really - matches your new rule. Blocking ads is like blocking spam: a lot of - tinkering is required to stay ahead of the game. And remember you need - to block the URL of the ad in question, which may be entirely different - from the site URL itself. Most ads are hosted on different servers than - the main site itself. If you right-click on the ad, you should be able - to get all the relevant information you need. Alternately, you can find - the correct URL by looking at <span class= - "APPLICATION">Privoxy's</span> logs (you may need to enable logging in - the main config file if its disabled).</p> - - <p>Below is a slightly modified real-life log snippet that originates - with one requested URL: <tt class="LITERAL">www.example.com</tt> (name - of site was changed for this example, the number of requests is real). - You can see in this the complexity of what goes into making up this one - <span class="QUOTE">"page"</span>. There are eight different domains - involved here, with thirty two separate URLs requested in all, making - up all manner of images, Shockwave Flash, JavaScript, CSS stylesheets, - scripts, and other related content. Some of this content is obviously - <span class="QUOTE">"good"</span> or <span class="QUOTE">"bad"</span>, - but not all. Many of the more questionable looking requests, are going - to outside domains that seem to be identifying themselves with - suspicious looking names, making our job a little easier. <span class= - "APPLICATION">Privoxy</span> has <span class="QUOTE">"crunched"</span> - (meaning caught and BLOCKED) quite a few items in this example, but - perhaps missed a few as well.</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -Request: www.example.com/ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Troubleshooting</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy Frequently Asked Questions" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Miscellaneous" +HREF="misc.html"><LINK +REL="NEXT" +TITLE="Contacting the developers, Bug Reporting and Feature Requests" +HREF="contact.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy Frequently Asked Questions</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="misc.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="contact.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="TROUBLE" +>5. Troubleshooting</A +></H1 +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN1084" +>5.1. I cannot connect to any websites. Or, I am getting +<SPAN +CLASS="QUOTE" +>"connection refused"</SPAN +> message with every web page. Why?</A +></H3 +><P +> There are several possibilities:</P +><P +><P +></P +><UL +><LI +><P +><SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is not running. Solution: verify + that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is installed correctly, has not crashed, and is indeed running. + Turn on <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> logging, and look at the logs to see what they say.</P +></LI +><LI +><P +>Or your browser is configured for a different port than what + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is using. Solution: verify that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + and your browser are set to the same port (<TT +CLASS="LITERAL" +>listen-address</TT +>).</P +></LI +><LI +><P +>Or if using a forwarding rule, you have a configuration problem or a + problem with a host in the forwarding chain. Solution: temporarily alter your + configuration and take the forwarders out of the equation.</P +></LI +><LI +><P +> Or you have a firewall that is interfering and blocking you. Solution: + try disabling or removing the firewall as a simple test. + </P +></LI +></UL +></P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="ERROR503" +>5.2. Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</A +></H3 +><P +> More than likely this is a problem with your TCP/IP networking. ZoneAlarm has + been reported to cause this symptom -- even if not running! The solution is + to either fight the ZA configuration, or uninstall ZoneAlarm, and then find + something better behaved in its place. Other personal firewall type products + may cause similar type problems if not configured correctly. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN1107" +>5.3. I just added a new rule, but the steenkin ad is +still getting through. How?</A +></H3 +><P +> If the ad had been displayed before you added its URL, it will probably be + held in the browser's cache for some time, so it will be displayed without + the need for any request to the server, and <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + will not be involved. Flush the browser's caches, and then try again.</P +><P +> If this doesn't help, you probably have an error in the rule you + applied. Try pasting the full URL of the offending ad into <A +HREF="http://config.privoxy.org/show-url-info" +TARGET="_top" +>http://config.privoxy.org/show-url-info</A +> + and see if it really matches your new rule. Blocking ads is like blocking + spam: a lot of tinkering is required to stay ahead of the game. And + remember you need to block the URL of the ad in question, which may be + entirely different from the site URL itself. Most ads are hosted on different + servers than the main site itself. If you right-click on the ad, you should + be able to get all the relevant information you need. Alternately, you can + find the correct URL by looking at <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> logs + (you may need to enable logging in the main config file if its disabled).</P +><P +> Below is a slightly modified real-life log snippet that originates with one + requested URL: <TT +CLASS="LITERAL" +>www.example.com</TT +> (name of site was changed + for this example, the number of requests is real). You can see in this the + complexity of what goes into making up this one <SPAN +CLASS="QUOTE" +>"page"</SPAN +>. There + are eight different domains involved here, with thirty two separate URLs + requested in all, making up all manner of images, Shockwave Flash, + JavaScript, CSS stylesheets, scripts, and other related content. Some of this + content is obviously <SPAN +CLASS="QUOTE" +>"good"</SPAN +> or <SPAN +CLASS="QUOTE" +>"bad"</SPAN +>, but not all. + Many of the more questionable looking requests, are going to outside domains + that seem to be identifying themselves with suspicious looking names, making + our job a little easier. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> has <SPAN +CLASS="QUOTE" +>"crunched"</SPAN +> (meaning caught + and BLOCKED) quite a few items in this example, but perhaps missed a few as well. </P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>Request: www.example.com/ Request: www.example.com/favicon.ico Request: img.example.com/main.css Request: img.example.com/sr.js @@ -161,8 +243,8 @@ Request: img.example.com/pb.png Request: www.google-analytics.com/urchin.js crunch! (Blocked) Request: www.advertising-department.com/ats/switch.ps.php?26856 crunch! (Blocked) Request: img.example.com/p.gif -Request: www.popuptraffic.com/assign.php?l=example&mode=behind crunch! (Blocked) -Request: www.popuptraffic.com/scripts/popup.php?hid=5c3cf&tmpl=PBa.tmpl crunch! (Blocked) +Request: www.popuptraffic.com/assign.php?l=example&mode=behind crunch! (Blocked) +Request: www.popuptraffic.com/scripts/popup.php?hid=5c3cf&tmpl=PBa.tmpl crunch! (Blocked) Request: www.popuptraffic.com/assign.php?l=example crunch! (Blocked) Request: www.lik-sang.com/Banners/best_sellers/best_sellers.css Request: www.adtrak.net/adx.js crunch! (Blocked) @@ -171,566 +253,1024 @@ Request: img.example.com/example.jpg Request: img.example.com/mt.png Request: img.example.com/mm.png Request: img.example.com/mb.png -Request: www.popuptraffic.com/scripts/popup.php?hid=a71b91fa5&tmpl=Ua.tmp crunch! (Blocked) +Request: www.popuptraffic.com/scripts/popup.php?hid=a71b91fa5&tmpl=Ua.tmp crunch! (Blocked) Request: www.example.com/tracker.js Request: www.lik-sang.com/Banners/best_sellers/lsi_head.gif -Request: www.adtrak.net/adjs.php?n=020548130&what=zone:61 crunch! (Blocked) -Request: www.adtrak.net/adjs.php?n=463594413&what=zone:58&source=Ua crunch! (Blocked) +Request: www.adtrak.net/adjs.php?n=020548130&what=zone:61 crunch! (Blocked) +Request: www.adtrak.net/adjs.php?n=463594413&what=zone:58&source=Ua crunch! (Blocked) Request: www.lik-sang.com/Banners/best_sellers/bottomani.swf -Request: mmm.elitemediagroup.net/install.php?allowpop=no&popupmincook=0&allowsp2=1 crunch! (Blocked) -Request: www.example.com/tracker.js?screen=1400x1050&win=962x693 -Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=61 crunch! (Blocked) -Request: 66.70.21.80/scripts/click.php?hid=5c3cf599a9efd0320d26&si +Request: mmm.elitemediagroup.net/install.php?allowpop=no&popupmincook=0&allowsp2=1 crunch! (Blocked) +Request: www.example.com/tracker.js?screen=1400x1050&win=962x693 +Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=61 crunch! (Blocked) +Request: 66.70.21.80/scripts/click.php?hid=5c3cf599a9efd0320d26&si Request: 66.70.21.80/img/pixel.gif -Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=58&source=Ua&block=86400 crunch! (Blocked) -Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua -</pre> - </td> - </tr> - </table> - - <p>Despite 12 out of 32 requests being blocked, the page looked, and - seemed to behave perfectly <span class="QUOTE">"normal"</span> (minus - some ads, of course).</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="BADSITE" id="BADSITE">5.4. One of my - favorite sites does not work with Privoxy. What can I do?</a></h3> - - <p>First verify that it is indeed a <span class= - "APPLICATION">Privoxy</span> problem, by toggling off <span class= - "APPLICATION">Privoxy</span> through <a href= - "http://config.privoxy.org/toggle" target= - "_top">http://config.privoxy.org/toggle</a> (the toggle feature may - need to be enabled in the main <tt class="FILENAME">config</tt>), and - then shift-reloading the problem page (i.e. holding down the shift key - while clicking reload. Alternatively, flush your browser's disk and - memory caches).</p> - - <p>If the problem went away, we know we have a configuration related - problem. Now go to <a href="http://config.privoxy.org/show-url-info" - target="_top">http://config.privoxy.org/show-url-info</a> and paste the - full URL of the page in question into the prompt. See which actions are - being applied to the URL, and which matches in which actions files are - responsible for that. It might be helpful also to look at your logs for - this site too, to see what else might be happening (note: logging may - need to be enabled in the main config file). Many sites are complex and - require a number of related pages to help present their content. Look - at what else might be used by the page in question, and what of that - might be <span class="emphasis EMPHASIS c3">required</span>. Now, armed - with this information, go to <a href= - "http://config.privoxy.org/show-status" target= - "_top">http://config.privoxy.org/show-status</a> and select the - appropriate actions files for editing.</p> - - <p>You can now either look for a section which disables the actions - that you suspect to cause the problem and add a pattern for your site - there, or make up a completely new section for your site. In any case, - the recommended way is to disable only the prime suspect, reload the - problem page, and only if the problem persists, disable more and more - actions until you have identified the culprit. You may or may not want - to turn the other actions on again. Remember to flush your browser's - caches in between any such changes!</p> - - <p>Alternately, if you are comfortable with a text editor, you can - accomplish the same thing by editing the appropriate actions file. - Probably the easiest way to deal with such problems when editing by - hand is to add your site to a <tt class="LITERAL">{ fragile }</tt> - section in <tt class="FILENAME">user.action</tt>, which is an alias - that turns off most <span class="QUOTE">"dangerous"</span> actions, but - is also likely to turn off more actions then needed, and thus lower - your privacy and protection more than necessary,</p> - - <p>Troubleshooting actions is discussed in more detail in the <a href= - "../user-manual/appendix.html#ACTIONSANAT" target="_top">User Manual - appendix, Troubleshooting: the Anatomy of an Action</a>. There is also - an <a href="../user-manual/actions-file.html#ACT-EXAMPLES" target= - "_top">actions tutorial</a> with general configuration information and - examples.</p> - - <p>As a last resort, you can always see if your browser has a setting - that will bypass the proxy setting for selective sites. Modern browsers - can do this.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="DUN" id="DUN">5.5. After installing Privoxy, - I have to log in every time I start IE. What gives?</a></h3> - - <p>This is a quirk that effects the installation of <span class= - "APPLICATION">Privoxy</span>, in conjunction with Internet Explorer and - Internet Connection Sharing on Windows 2000 and Windows XP. The - symptoms may appear to be corrupted or invalid DUN settings, or - passwords.</p> - - <p>When setting up an NT based Windows system with <span class= - "APPLICATION">Privoxy</span> you may find that things do not seem to be - doing what you expect. When you set your system up you will probably - have set up Internet Connection Sharing (ICS) with Dial up Networking - (DUN) when logged in with administrator privileges. You will probably - have made this DUN connection available to other accounts that you may - have set-up on your system. E.g. Mum or Dad sets up the system and - makes accounts suitably configured for the kids.</p> - - <p>When setting up <span class="APPLICATION">Privoxy</span> in this - environment you will have to alter the proxy set-up of Internet - Explorer (IE) for the specific DUN connection on which you wish to use - <span class="APPLICATION">Privoxy</span>. When you do this the ICS DUN - set-up becomes user specific. In this instance you will see no - difference if you change the DUN connection under the account used to - set-up the connection. However when you do this from another user you - will notice that the DUN connection changes to make available to "Me - only". You will also find that you have to store the password under - each different user!</p> - - <p>The reason for this is that each user's set-up for IE is user - specific. Each set-up DUN connection and each LAN connection in IE - store the settings for each user individually. As such this enforces - individual configurations rather than common ones. Hence the first time - you use a DUN connection after re-booting your system it may not - perform as you expect, and prompt you for the password. Just set and - save the password again and all should be OK.</p> - - <p>[Thanks to Ray Griffith for this submission.]</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="FTP" id="FTP">5.6. I cannot connect to any - FTP sites. Privoxy is blocking me.</a></h3> - - <p><span class="APPLICATION">Privoxy</span> cannot act as a proxy for - FTP traffic, so do not configure your browser to use <span class= - "APPLICATION">Privoxy</span> as an FTP proxy. The same is true for - <span class="emphasis EMPHASIS c3">any protocol other than HTTP or - HTTPS (SSL)</span>.</p> - - <p>Most browsers understand FTP as well as HTTP. If you connect to a - site, with a URL like <tt class="LITERAL">ftp://ftp.example.com</tt>, - your browser is making an FTP connection, and not a HTTP connection. So - while your browser may speak FTP, <span class= - "APPLICATION">Privoxy</span> does not, and cannot proxy such - traffic.</p> - - <p>To complicate matters, some systems may have a generic <span class= - "QUOTE">"proxy"</span> setting, which will enable various protocols, - including <span class="emphasis EMPHASIS c3">both</span> HTTP and FTP - proxying! So it is possible to accidentally enable FTP proxying in - these cases. And of course, if this happens, <span class= - "APPLICATION">Privoxy</span> will indeed cause problems since it does - not know FTP. Newer version will give a sane error message if a FTP - connection is attempted. Just disable the FTP setting and all will be - well again.</p> - - <p>Will <span class="APPLICATION">Privoxy</span> ever proxy FTP - traffic? Unlikely. There just is not much reason, and the work to make - this happen is more than it may seem.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="MACOSXIE" id="MACOSXIE">5.7. In Mac OS X, I - can't configure Microsoft Internet Explorer to use Privoxy as the HTTP - proxy.</a></h3> - - <p>Microsoft Internet Explorer (in versions like 5.1) respects - system-wide network settings. In order to change the HTTP proxy, open - System Preferences, and click on the Network icon. In the settings pane - that comes up, click on the Proxies tab. Ensure the "Web Proxy (HTTP)" - checkbox is checked and enter <tt class="LITERAL">127.0.0.1</tt> in the - entry field. Enter <tt class="LITERAL">8118</tt> in the Port field. The - next time you start IE, it should reflect these values.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="MACOSXUNINSTALL" id="MACOSXUNINSTALL">5.8. - In Mac OS X, I dragged the Privoxy folder to the trash in order to - uninstall it. Now the finder tells me I don't have sufficient - privileges to empty the trash.</a></h3> - - <p>Note: This ONLY applies to privoxy 3.0.6 and earlier.</p> - - <p>Just dragging the <span class="APPLICATION">Privoxy</span> folder to - the trash is not enough to delete it. <span class= - "APPLICATION">Privoxy</span> supplies an <span class= - "APPLICATION">uninstall.command</span> file that takes care of these - details. Open the trash, drag the <span class= - "APPLICATION">uninstall.command</span> file out of the trash and - double-click on it. You will be prompted for confirmation and the - administration password.</p> - - <p>The trash may still appear full after this command; emptying the - trash from the desktop should make it appear empty again.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="MACOSXIMAGES" id="MACOSXIMAGES">5.9. In Mac - OS X Panther (10.3), images often fail to load and/or I experience - random delays in page loading. I'm using <tt class= - "LITERAL">localhost</tt> as my browser's proxy setting.</a></h3> - - <p>We believe this is due to an IPv6-related bug in Mac OS X, but don't - fully understand the issue yet. In any case, changing the proxy setting - to <tt class="LITERAL">127.0.0.1</tt> instead of <tt class= - "LITERAL">localhost</tt> works around the problem.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="BLANKPAGE" id="BLANKPAGE">5.10. I get a - completely blank page at one site. <span class="QUOTE">"View - Source"</span> shows only: <span class= - "MARKUP"><html><body></body></html></span>. - Without Privoxy the page loads fine.</a></h3> - - <p>Chances are that the site suffers from a bug in <a href= - "http://www.php.net/" target="_top"><span class= - "APPLICATION">PHP</span></a>, which results in empty pages being sent - if the client explicitly requests an uncompressed page, like - <span class="APPLICATION">Privoxy</span> does. This bug has been fixed - in PHP 4.2.3.</p> - - <p>To find out if this is in fact the source of the problem, try adding - the site to a <tt class="LITERAL">-prevent-compression</tt> section in - <tt class="FILENAME">user.action</tt>:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - # Make exceptions for ill-behaved sites: - # - {-prevent-compression} - .example.com -</pre> - </td> - </tr> - </table> - - <p>If that works, you may also want to report the problem to the site's - webmasters, telling them to use zlib.output_compression instead of - ob_gzhandler in their PHP applications (workaround) or upgrade to PHP - 4.2.3 or later (fix).</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.11. My logs - show many <span class="QUOTE">"Unable to get my own hostname"</span> - lines. Why?</a></h3> - - <p><span class="APPLICATION">Privoxy</span> tries to get the hostname - of the system its running on from the IP address of the system - interface it is bound to (from the <tt class="FILENAME">config</tt> - file <span class="emphasis EMPHASIS c3">listen-address</span> setting). - If the system cannot supply this information, <span class= - "APPLICATION">Privoxy</span> logs this condition.</p> - - <p>Typically, this would be considered a minor system configuration - error. It is not a fatal error to <span class= - "APPLICATION">Privoxy</span> however, but may result in a much slower - response from <span class="APPLICATION">Privoxy</span> on some - platforms due to DNS timeouts.</p> - - <p>This can be caused by a problem with the local <tt class= - "FILENAME">hosts</tt> file. If this file has been changed from the - original, try reverting it to see if that helps. Make sure whatever - name(s) are used for the local system, that they resolve both ways.</p> - - <p>You should also be able to work around the problem with the <a href= - "../user-manual/config.html#HOSTNAME" target="_top">hostname - option</a>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="INUSE" id="INUSE">5.12. When I try to launch - Privoxy, I get an error message <span class="QUOTE">"port 8118 is - already in use"</span> (or similar wording). Why?</a></h3> - - <p>Port 8118 is <span class="APPLICATION">Privoxy's</span> default TCP - <span class="QUOTE">"listening"</span> port. Typically this message - would mean that there is already one instance of <span class= - "APPLICATION">Privoxy</span> running, and your system is actually - trying to start a second <span class="APPLICATION">Privoxy</span> on - the same port, which will not work. (You can have multiple instances - but they must be assigned different ports.) How and why this might - happen varies from platform to platform, but you need to check your - installation and start-up procedures.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.13. Pages - with UTF-8 fonts are garbled.</a></h3> - - <p>This is caused by the <span class="QUOTE">"demoronizer"</span> - filter. You should either upgrade <span class= - "APPLICATION">Privoxy</span>, or at least upgrade to the most recent - <tt class="FILENAME">default.action</tt> file available from <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118" target= - "_top">SourceForge</a>. Or you can simply disable the demoronizer - filter.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.14. Why - are binary files (such as images) corrupted when Privoxy is - used?</a></h3> - - <p>This may also be caused by the <span class= - "QUOTE">"demoronizer"</span> filter, in conjunction with a web server - that is misreporting the content type. Binary files are exempted from - <span class="APPLICATION">Privoxy's</span> filtering (unless the web - server by mistake says the file is something else). Either upgrade - <span class="APPLICATION">Privoxy</span>, or go to the most recent - <tt class="FILENAME">default.action</tt> file available from <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118" target= - "_top">SourceForge</a>.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.15. What - is the <span class="QUOTE">"demoronizer"</span> and why is it - there?</a></h3> - - <p>The original demoronizer was a Perl script that cleaned up HTML - pages which were created with certain Microsoft products. MS has used - proprietary extensions to standardized font encodings (ISO 8859-1), - which has caused problems for pages that are viewed with non-Microsoft - products (and are expecting to see a standard set of fonts). The - demoronizer corrected these errors so the pages displayed correctly. - <span class="APPLICATION">Privoxy</span> borrowed from this script, - introducing a filter based on the original demoronizer, which in turn - could correct these errors on the fly.</p> - - <p>But this is only needed in some situations, and will cause serious - problems in some other situations.</p> - - <p>If you are using Microsoft products, you do not need it. If you need - to view pages with UTF-8 characters (such as Cyrillic or Chinese), then - it will cause corruption of the fonts, and thus <span class= - "emphasis EMPHASIS c3">should not be on</span>.</p> - - <p>On the other hand, if you use non-Microsoft products, and you - occasionally notice weird characters on pages, you might want to try - it.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.16. Why do I - keep seeing <span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw - source code?</a></h3> - - <p><span class="APPLICATION">Privoxy</span> is attempting to disable - malicious <a href="http://en.wikipedia.org/wiki/Javascript" target= - "_top">Javascript</a> in this case, with the <tt class= - "LITERAL">unsolicited-popups</tt> filter. <span class= - "APPLICATION">Privoxy</span> cannot tell very well <span class= - "QUOTE">"good"</span> code snippets from <span class= - "QUOTE">"bad"</span> code snippets.</p> - - <p>If you see this in HTML source, and the page displays without - problems, then this is good, and likely some pop-up window was - disabled. If you see this where it is causing a problem, such as a - downloaded program source code file, then you should set an exception - for this site or page such that the integrity of the page stays in tact - by disabling all filtering.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.17. I am getting - too many DNS errors like <span class="QUOTE">"404 No Such - Domain"</span>. Why can't Privoxy do this better?</a></h3> - - <p>There are potentially several factors here. First of all, the DNS - resolution is done by the underlying operating system -- not - <span class="APPLICATION">Privoxy</span> itself. <span class= - "APPLICATION">Privoxy</span> merely initiates the process and hands it - off, and then later reports whatever the outcome was and tries to give - a coherent message if there seems to be a problem. In some cases, this - might otherwise be mitigated by the browser itself which might try some - work-arounds and alternate approaches (e.g adding <span class= - "QUOTE">"www."</span> to the URL).</p> - - <p>In other cases, if <span class="APPLICATION">Privoxy</span> is being - chained with another proxy, this could complicate the issue, and cause - undue delays and timeouts. In the case of a <span class= - "QUOTE">"socks4a"</span> proxy, the socks server handles all the DNS. - <span class="APPLICATION">Privoxy</span> would just be the <span class= - "QUOTE">"messenger"</span> which is reporting whatever problem occurred - downstream, and not the root cause of the error.</p> - - <p>In any case, versions newer than 3.0.3 include various improvements - to help <span class="APPLICATION">Privoxy</span> better handle these - cases.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.18. At one site - Privoxy just hangs, and starts taking all CPU. Why is this?</a></h3> - - <p>This is probably a manifestation of the <span class="QUOTE">"100% - cpu"</span> problem that occurs on pages containing many (thousands - upon thousands) of blank lines. The blank lines are in the raw HTML - source of the page, and the browser just ignores them. But the pattern - matching in <span class="APPLICATION">Privoxy's</span> page filtering - mechanism is trying to match against absurdly long strings and this - becomes very CPU-intensive, taking a long, long time to complete.</p> - - <p>Until a better solution comes along, disable filtering on these - pages, particularly the <tt class="LITERAL">js-annoyances</tt> and - <tt class="LITERAL">unsolicited-popups</tt> filters. If you run into - this problem with a recent <span class="APPLICATION">Privoxy</span> - version, please send a problem report.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.19. I just - installed Privoxy, and all my browsing has slowed to a crawl. What - gives?</a></h3> - - <p>This should not happen, and for the overwhelming number of users - world-wide, it does not happen. I would suspect some inadvertent - interaction of software components such as anti-virus software, spyware - protectors, personal firewalls or similar components. Try disabling (or - uninstalling) these one at a time and see if that helps. Either way, if - you are using a recent <span class="APPLICATION">Privoxy</span> - version, please report the problem.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.20. Why do - my filters work on some sites but not on others?</a></h3> - - <p>It's probably due to compression. It is a common practice for web - servers to send their content <span class="QUOTE">"compressed"</span> - in order to speed things up, and then let the browser <span class= - "QUOTE">"uncompress"</span> them. When compiled with zlib support - <span class="APPLICATION">Privoxy</span> can decompress content before - filtering, otherwise you may want to enable <a href= - "../user-manual/actions-file.html#PREVENT-COMPRESSION" target= - "_top">prevent-compression</a>.</p> - - <p>As of <span class="APPLICATION">Privoxy</span> 3.0.9, zlib support - is enabled in the default builds.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.21. On - some HTTPS sites my browser warns me about unauthenticated content, the - URL bar doesn't get highlighted and the lock symbol appears to be - broken. What's going on?</a></h3> - - <p>Probably the browser is requesting ads through HTTPS and - <span class="APPLICATION">Privoxy</span> is blocking the requests. - Privoxy's error messages are delivered unencrypted and while it's - obvious for the browser that the HTTPS request is already blocked by - the proxy, some warn about unauthenticated content anyway.</p> - - <p>To work around the problem you can redirect those requests to an - invalid local address instead of blocking them. While the redirects - aren't encrypted either, many browsers don't care. They simply follow - the redirect, fail to reach a server and display an error message - instead of the ad.</p> - - <p>To do that, enable logging to figure out which requests get blocked - by <span class="APPLICATION">Privoxy</span> and add the hosts (no path - patterns) to a section like this:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{+redirect{http://127.0.0.1:0/%7D -block -limit-connect} -.ivwbox.de:443/ -</pre> - </td> - </tr> - </table> - - <p>Additionally you have to configure your browser to contact - <span class="QUOTE">"127.0.0.1:0"</span> directly (instead of through - <span class="APPLICATION">Privoxy</span>).</p> - - <p>To add a proxy exception in <span class="APPLICATION">Mozilla - Firefox</span> open the <span class="QUOTE">"Preferences"</span>, click - the <span class="QUOTE">"Settings"</span> button located on the - <span class="QUOTE">"Network"</span> tab in the <span class= - "QUOTE">"Advanced"</span> section, and add <span class= - "QUOTE">"127.0.0.1:0"</span> in the <span class="QUOTE">"No Proxy - for:"</span> field.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.22. I get selinux - error messages. How can I fix this?</a></h3> - - <p>Please report the problem to the creator of your selinux - policies.</p> - - <p>The problem is that some selinux policy writers aren't familiar with - the application they are trying to <span class="QUOTE">"secure"</span> - and thus create policies that make no sense.</p> - - <p>In <span class="APPLICATION">Privoxy's</span> case the problem - usually is that the policy only allows outgoing connections for certain - destination ports (e.g. 80 and 443). While this may cover the standard - ports, websites occasionally use other ports as well. This isn't a - security problem and therefore <span class= - "APPLICATION">Privoxy's</span> default configuration doesn't block - these requests.</p> - - <p>If you really want to block these ports (and don't be able to load - websites that don't use standard ports), you should configure Privoxy - to block these ports as well, so it doesn't trigger the selinux - warnings.</p> - </div> - - <div class="SECT2"> - <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.23. I - compiled <span class="APPLICATION">Privoxy</span> with Gentoo's portage - and it appears to be very slow. Why?</a></h3> - - <p>Probably you unintentionally compiled <span class= - "APPLICATION">Privoxy</span> without threading support in which case - requests have to be serialized and only one can be served at the same - time.</p> - - <p>Check your <span class="QUOTE">"USE"</span> flags and make sure they - include <span class="QUOTE">"threads"</span>. If they don't, add the - flag and rebuild <span class="APPLICATION">Privoxy</span>.</p> - - <p>If you compiled <span class="APPLICATION">Privoxy</span> with - threading support (on POSIX-based systems), the <span class= - "QUOTE">"Conditional #defines"</span> section on <a href= - "http://config.privoxy.org/show-status" target= - "_top">http://config.privoxy.org/show-status</a> will list <span class= - "QUOTE">"FEATURE_PTHREAD"</span> as <span class= - "QUOTE">"enabled"</span>.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="misc.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="contact.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Miscellaneous</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Contacting the developers, - Bug Reporting and Feature Requests</td> - </tr> - </table> - </div> -</body> -</html> +Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=58&source=Ua&block=86400 crunch! (Blocked) +Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua</PRE +></TD +></TR +></TABLE +></P +><P +> Despite 12 out of 32 requests being blocked, the page looked, and seemed to + behave perfectly <SPAN +CLASS="QUOTE" +>"normal"</SPAN +> (minus some ads, of course).</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="BADSITE" +>5.4. One of my favorite sites does not work with Privoxy. +What can I do?</A +></H3 +><P +> First verify that it is indeed a <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> problem, + by toggling off <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> through <A +HREF="http://config.privoxy.org/toggle" +TARGET="_top" +>http://config.privoxy.org/toggle</A +> + (the toggle feature may need to be enabled in the main + <TT +CLASS="FILENAME" +>config</TT +>), + and then shift-reloading the problem page (i.e. holding down the shift key + while clicking reload. Alternatively, flush your browser's disk and memory + caches).</P +><P +> If the problem went away, we know we have a configuration related problem. + Now go to <A +HREF="http://config.privoxy.org/show-url-info" +TARGET="_top" +>http://config.privoxy.org/show-url-info</A +> + and paste the full URL of the page in question into the prompt. See which + actions are being applied to the URL, and which matches in which actions + files are responsible for that. It might be helpful also to look at your logs + for this site too, to see what else might be happening (note: logging may need + to be enabled in the main config file). Many sites are + complex and require a number of related pages to help present their content. + Look at what else might be used by the page in question, and what of that + might be <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>required</I +></SPAN +>. + Now, armed with this information, go to + <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +> + and select the appropriate actions files for editing. </P +><P +> You can now either look for a section which disables the actions that + you suspect to cause the problem and add a pattern for your site there, + or make up a completely new section for your site. In any case, the recommended + way is to disable only the prime suspect, reload the problem page, and only + if the problem persists, disable more and more actions until you have + identified the culprit. You may or may not want to turn the other actions + on again. Remember to flush your browser's caches in between any such changes!</P +><P +> Alternately, if you are comfortable with a text editor, you can accomplish + the same thing by editing the appropriate actions file. Probably the easiest + way to deal with such problems when editing by hand is to add your + site to a <TT +CLASS="LITERAL" +>{ fragile }</TT +> section in <TT +CLASS="FILENAME" +>user.action</TT +>, + which is an alias that turns off most <SPAN +CLASS="QUOTE" +>"dangerous"</SPAN +> + actions, but is also likely to turn off more actions then needed, and thus lower + your privacy and protection more than necessary, </P +><P +> Troubleshooting actions is discussed in more detail in the <A +HREF="../user-manual/appendix.html#ACTIONSANAT" +TARGET="_top" +>User Manual appendix, + Troubleshooting: the Anatomy of an Action</A +>. + There is also an <A +HREF="../user-manual/actions-file.html#ACT-EXAMPLES" +TARGET="_top" +>actions tutorial</A +> + with general configuration information and examples.</P +><P +> As a last resort, you can always see if your browser has a setting that will + bypass the proxy setting for selective sites. Modern browsers can do this.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="DUN" +>5.5. After installing Privoxy, I have to log in +every time I start IE. What gives?</A +></H3 +><P +> This is a quirk that effects the installation of + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, in conjunction with Internet Explorer and + Internet Connection Sharing on Windows 2000 and Windows XP. The symptoms may + appear to be corrupted or invalid DUN settings, or passwords.</P +><P +> When setting up an NT based Windows system with + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> you may find that things do not seem to be + doing what you expect. When you set your system up you will probably have set + up Internet Connection Sharing (ICS) with Dial up Networking (DUN) when + logged in with administrator privileges. You will probably have made this DUN + connection available to other accounts that you may have set-up on your + system. E.g. Mum or Dad sets up the system and makes accounts suitably + configured for the kids.</P +><P +> When setting up <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> in this environment you + will have to alter the proxy set-up of Internet Explorer (IE) for the + specific DUN connection on which you wish to use + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. When you do this the ICS DUN set-up + becomes user specific. In this instance you will see no difference if you + change the DUN connection under the account used to set-up the connection. + However when you do this from another user you will notice that the DUN + connection changes to make available to "Me only". You will also find that + you have to store the password under each different user!</P +><P +> The reason for this is that each user's set-up for IE is user specific. Each + set-up DUN connection and each LAN connection in IE store the settings for + each user individually. As such this enforces individual configurations + rather than common ones. Hence the first time you use a DUN connection after + re-booting your system it may not perform as you expect, and prompt you for + the password. Just set and save the password again and all should be OK.</P +><P +>[Thanks to Ray Griffith for this submission.]</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="FTP" +>5.6. I cannot connect to any FTP sites. Privoxy + is blocking me.</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> cannot act as a proxy for FTP traffic, + so do not configure your browser to use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + as an FTP proxy. The same is true for <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>any protocol other than HTTP + or HTTPS (SSL)</I +></SPAN +>. + </P +><P +> Most browsers understand FTP as well as HTTP. If you connect to a site, with + a URL like <TT +CLASS="LITERAL" +>ftp://ftp.example.com</TT +>, your browser is making + an FTP connection, and not a HTTP connection. So while your browser may + speak FTP, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> does not, and cannot proxy + such traffic. + </P +><P +> To complicate matters, some systems may have a generic <SPAN +CLASS="QUOTE" +>"proxy"</SPAN +> + setting, which will enable various protocols, including + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>both</I +></SPAN +> HTTP and FTP proxying! So it is possible to + accidentally enable FTP proxying in these cases. And of course, if this + happens, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will indeed cause problems since + it does not know FTP. Newer version will give a sane error + message if a FTP connection is attempted. Just disable the FTP setting + and all will be well again. + </P +><P +> Will <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> ever proxy FTP traffic? Unlikely. + There just is not much reason, and the work to make this happen is more than + it may seem. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="MACOSXIE" +>5.7. In Mac OS X, I can't configure Microsoft Internet Explorer to use + Privoxy as the HTTP proxy.</A +></H3 +><P +> Microsoft Internet Explorer (in versions like 5.1) respects system-wide + network settings. In order to change the HTTP proxy, open System + Preferences, and click on the Network icon. In the settings pane that + comes up, click on the Proxies tab. Ensure the "Web Proxy (HTTP)" checkbox + is checked and enter <TT +CLASS="LITERAL" +>127.0.0.1</TT +> in the entry field. + Enter <TT +CLASS="LITERAL" +>8118</TT +> in the Port field. The next time you start + IE, it should reflect these values. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="MACOSXUNINSTALL" +>5.8. In Mac OS X, I dragged the Privoxy folder to the trash in order to + uninstall it. Now the finder tells me I don't have sufficient privileges to + empty the trash.</A +></H3 +><P +> Note: This ONLY applies to privoxy 3.0.6 and earlier. + </P +><P +> Just dragging the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> folder to the trash is + not enough to delete it. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> supplies an + <SPAN +CLASS="APPLICATION" +>uninstall.command</SPAN +> file that takes care of + these details. Open the trash, drag the <SPAN +CLASS="APPLICATION" +>uninstall.command</SPAN +> + file out of the trash and double-click on it. You will be prompted for + confirmation and the administration password. + </P +><P +> The trash may still appear full after this command; emptying the trash + from the desktop should make it appear empty again. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="MACOSXIMAGES" +>5.9. In Mac OS X Panther (10.3), images often fail to load and/or I + experience random delays in page loading. I'm using + <TT +CLASS="LITERAL" +>localhost</TT +> as my browser's proxy setting.</A +></H3 +><P +> We believe this is due to an IPv6-related bug in Mac OS X, but don't fully + understand the issue yet. In any case, changing the proxy setting to + <TT +CLASS="LITERAL" +>127.0.0.1</TT +> instead of <TT +CLASS="LITERAL" +>localhost</TT +> + works around the problem. + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="BLANKPAGE" +>5.10. I get a completely blank page at one site. <SPAN +CLASS="QUOTE" +>"View Source"</SPAN +> + shows only: <SPAN +CLASS="MARKUP" +><html><body></body></html></SPAN +>. Without + Privoxy the page loads fine.</A +></H3 +><P +> Chances are that the site suffers from a bug in + <A +HREF="http://www.php.net/" +TARGET="_top" +><SPAN +CLASS="APPLICATION" +>PHP</SPAN +></A +>, + which results in empty pages being sent if the client explicitly requests + an uncompressed page, like <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> does. + This bug has been fixed in PHP 4.2.3. + </P +><P +> To find out if this is in fact the source of the problem, try adding + the site to a <TT +CLASS="LITERAL" +>-prevent-compression</TT +> section in + <TT +CLASS="FILENAME" +>user.action</TT +>: + </P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> # Make exceptions for ill-behaved sites: + # + {-prevent-compression} + .example.com</PRE +></TD +></TR +></TABLE +><P +> If that works, you may also want to report the problem to the + site's webmasters, telling them to use zlib.output_compression + instead of ob_gzhandler in their PHP applications (workaround) + or upgrade to PHP 4.2.3 or later (fix). + </P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="NOHOSTNAME" +>5.11. My logs show many <SPAN +CLASS="QUOTE" +>"Unable to get my own hostname"</SPAN +> lines. +Why?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> tries to get the hostname of the system + its running on from the IP address of the system interface it is bound to + (from the <TT +CLASS="FILENAME" +>config</TT +> file + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>listen-address</I +></SPAN +> setting). If the system cannot supply + this information, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> logs this condition. </P +><P +> Typically, this would be considered a minor system configuration error. It is + not a fatal error to <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> however, but may + result in a much slower response from <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on + some platforms due to DNS timeouts.</P +><P +> This can be caused by a problem with the local <TT +CLASS="FILENAME" +>hosts</TT +> + file. If this file has been changed from the original, try reverting it to + see if that helps. Make sure whatever name(s) are used for the local system, + that they resolve both ways.</P +><P +> You should also be able to work around the problem with the + <A +HREF="../user-manual/config.html#HOSTNAME" +TARGET="_top" +>hostname option</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="INUSE" +>5.12. When I try to launch Privoxy, I get an +error message <SPAN +CLASS="QUOTE" +>"port 8118 is already in use"</SPAN +> (or similar wording). +Why?</A +></H3 +><P +> Port 8118 is <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> default TCP + <SPAN +CLASS="QUOTE" +>"listening"</SPAN +> port. Typically this message would mean that there + is already one instance of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> running, and + your system is actually trying to start a second + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on the same port, which will not work. + (You can have multiple instances but they must be assigned different ports.) + How and why this might happen varies from platform to platform, but you need + to check your installation and start-up procedures.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="DEMORONIZER" +>5.13. Pages with UTF-8 fonts are garbled.</A +></H3 +><P +> This is caused by the <SPAN +CLASS="QUOTE" +>"demoronizer"</SPAN +> filter. You should either + upgrade <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, or at least upgrade to the most + recent <TT +CLASS="FILENAME" +>default.action</TT +> file available from <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>SourceForge</A +>. + Or you can simply disable the demoronizer filter.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="DEMORONIZER2" +>5.14. Why are binary files (such as images) corrupted when Privoxy + is used?</A +></H3 +><P +> This may also be caused by the <SPAN +CLASS="QUOTE" +>"demoronizer"</SPAN +> filter, + in conjunction with a web server that is misreporting the content type. Binary + files are exempted from <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> filtering + (unless the web server by mistake says the file is something else). Either + upgrade <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, or go to the most recent + <TT +CLASS="FILENAME" +>default.action</TT +> file available from <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>SourceForge</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="DEMORONIZER3" +>5.15. What is the <SPAN +CLASS="QUOTE" +>"demoronizer"</SPAN +> and why is it there?</A +></H3 +><P +> The original demoronizer was a Perl script that cleaned up HTML pages which + were created with certain Microsoft products. MS has used proprietary extensions + to standardized font encodings (ISO 8859-1), which has caused problems for pages + that are viewed with non-Microsoft products (and are expecting to see a + standard set of fonts). The demoronizer corrected these errors so the pages + displayed correctly. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> borrowed from this + script, introducing a filter based on the original demoronizer, which in turn could + correct these errors on the fly. </P +><P +> But this is only needed in some situations, and will cause serious problems in some + other situations.</P +><P +> If you are using Microsoft products, you do not need it. If you need to view + pages with UTF-8 characters (such as Cyrillic or Chinese), then it will + cause corruption of the fonts, and thus <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>should not be on</I +></SPAN +>.</P +><P +> On the other hand, if you use non-Microsoft products, and you occasionally + notice weird characters on pages, you might want to try it.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="WINDOWOPEN" +>5.16. Why do I keep seeing <SPAN +CLASS="QUOTE" +>"PrivoxyWindowOpen()"</SPAN +> in raw source code?</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is attempting to disable malicious + <A +HREF="http://en.wikipedia.org/wiki/Javascript" +TARGET="_top" +>Javascript</A +> + in this case, with the <TT +CLASS="LITERAL" +>unsolicited-popups</TT +> + filter. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> cannot tell very well + <SPAN +CLASS="QUOTE" +>"good"</SPAN +> code snippets from <SPAN +CLASS="QUOTE" +>"bad"</SPAN +> code snippets.</P +><P +> If you see this in HTML source, and the page displays without problems, then + this is good, and likely some pop-up window was disabled. If you see this + where it is causing a problem, such as a downloaded program source code file, + then you should set an exception for this site or page such that the + integrity of the page stays in tact by disabling all filtering.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="DNSERRORS" +>5.17. I am getting too many DNS errors like <SPAN +CLASS="QUOTE" +>"404 No Such Domain"</SPAN +>. Why + can't Privoxy do this better?</A +></H3 +><P +> There are potentially several factors here. First of all, the DNS resolution + is done by the underlying operating system -- not + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> itself. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + merely initiates the process and hands it off, and then later reports + whatever the outcome was and tries to give a coherent message if there seems + to be a problem. In some cases, this might otherwise be mitigated by the + browser itself which might try some work-arounds and alternate approaches (e.g + adding <SPAN +CLASS="QUOTE" +>"www."</SPAN +> to the URL).</P +><P +> In other cases, if <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is being chained + with another proxy, this could complicate the issue, and cause undue + delays and timeouts. In the case of a <SPAN +CLASS="QUOTE" +>"socks4a"</SPAN +> proxy, the socks + server handles all the DNS. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> would just be + the <SPAN +CLASS="QUOTE" +>"messenger"</SPAN +> which is reporting whatever problem occurred + downstream, and not the root cause of the error.</P +><P +> In any case, versions newer than 3.0.3 include various improvements to help + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> better handle these cases.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="ALLCPU" +>5.18. At one site Privoxy just hangs, and starts taking + all CPU. Why is this?</A +></H3 +><P +> This is probably a manifestation of the <SPAN +CLASS="QUOTE" +>"100% cpu"</SPAN +> problem that + occurs on pages containing many (thousands upon thousands) of blank lines. The blank lines + are in the raw HTML source of the page, and the browser just ignores them. But the + pattern matching in <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> page filtering + mechanism is trying to match against absurdly long strings and this becomes + very CPU-intensive, taking a long, long time to complete.</P +><P +> Until a better solution comes along, disable filtering on these pages, + particularly the <TT +CLASS="LITERAL" +>js-annoyances</TT +> and + <TT +CLASS="LITERAL" +>unsolicited-popups</TT +> filters. If you run into this problem + with a recent <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version, please send a problem report.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="SLOWCRAWL" +>5.19. I just installed Privoxy, and all my +browsing has slowed to a crawl. What gives?</A +></H3 +><P +> This should not happen, and for the overwhelming number of users world-wide, + it does not happen. I would suspect some inadvertent interaction of software + components such as anti-virus software, spyware protectors, personal + firewalls or similar components. Try disabling (or uninstalling) these one + at a time and see if that helps. Either way, if you are using a + recent <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version, please report the problem.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="PREVENTCOMP" +>5.20. Why do my filters work on some sites but not on others?</A +></H3 +><P +> It's probably due to compression. It is a common practice for web servers to + send their content <SPAN +CLASS="QUOTE" +>"compressed"</SPAN +> in order to speed things up, and + then let the browser <SPAN +CLASS="QUOTE" +>"uncompress"</SPAN +> them. When compiled with zlib support + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can decompress content before filtering, otherwise you may want to enable +<A +HREF="../user-manual/actions-file.html#PREVENT-COMPRESSION" +TARGET="_top" +>prevent-compression</A +>.</P +><P +> As of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> 3.0.9, zlib support is enabled in the default builds.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="SSL-WARNINGS" +>5.21. On some HTTPS sites my browser warns me about unauthenticated content, + the URL bar doesn't get highlighted and the lock symbol appears to be broken. + What's going on?</A +></H3 +><P +> Probably the browser is requesting ads through HTTPS and <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + is blocking the requests. Privoxy's error messages are delivered + unencrypted and while it's obvious for the browser that the HTTPS + request is already blocked by the proxy, some warn about unauthenticated + content anyway.</P +><P +> To work around the problem you can redirect those requests to an invalid + local address instead of blocking them. While the redirects aren't + encrypted either, many browsers don't care. They simply follow the + redirect, fail to reach a server and display an error message instead + of the ad.</P +><P +> To do that, enable logging to figure out which requests get blocked by + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and add the hosts (no path patterns) to a section like this:</P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{+redirect{http://127.0.0.1:0/%7D -block -limit-connect} +.ivwbox.de:443/</PRE +></TD +></TR +></TABLE +></P +><P +> Additionally you have to configure your browser to contact + <SPAN +CLASS="QUOTE" +>"127.0.0.1:0"</SPAN +> directly (instead of through <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>).</P +><P +> To add a proxy exception in <SPAN +CLASS="APPLICATION" +>Mozilla Firefox</SPAN +> + open the <SPAN +CLASS="QUOTE" +>"Preferences"</SPAN +>, click the <SPAN +CLASS="QUOTE" +>"Settings"</SPAN +> + button located on the <SPAN +CLASS="QUOTE" +>"Network"</SPAN +> tab in the <SPAN +CLASS="QUOTE" +>"Advanced"</SPAN +> + section, and add <SPAN +CLASS="QUOTE" +>"127.0.0.1:0"</SPAN +> in the <SPAN +CLASS="QUOTE" +>"No Proxy for:"</SPAN +> + field.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="SE-LINUX" +>5.22. I get selinux error messages. How can I fix this?</A +></H3 +><P +> Please report the problem to the creator of your selinux policies.</P +><P +> The problem is that some selinux policy writers aren't familiar + with the application they are trying to <SPAN +CLASS="QUOTE" +>"secure"</SPAN +> and + thus create policies that make no sense.</P +><P +> In <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> case the problem usually + is that the policy only allows outgoing connections for certain + destination ports (e.g. 80 and 443). While this may cover the + standard ports, websites occasionally use other ports as well. + This isn't a security problem and therefore <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + default configuration doesn't block these requests.</P +><P +> If you really want to block these ports (and don't be able + to load websites that don't use standard ports), you should + configure Privoxy to block these ports as well, so it doesn't + trigger the selinux warnings.</P +></DIV +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="GENTOO-RICERS" +>5.23. I compiled <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with Gentoo's portage and it appears to be very slow. Why?</A +></H3 +><P +> Probably you unintentionally compiled <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> without threading support + in which case requests have to be serialized and only one can be served + at the same time.</P +><P +> Check your <SPAN +CLASS="QUOTE" +>"USE"</SPAN +> flags and make sure they include + <SPAN +CLASS="QUOTE" +>"threads"</SPAN +>. If they don't, add the flag and rebuild <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>.</P +><P +> If you compiled <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with threading support (on POSIX-based systems), + the <SPAN +CLASS="QUOTE" +>"Conditional #defines"</SPAN +> section on <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +> + will list <SPAN +CLASS="QUOTE" +>"FEATURE_PTHREAD"</SPAN +> as <SPAN +CLASS="QUOTE" +>"enabled"</SPAN +>. </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="misc.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="contact.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Miscellaneous</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Contacting the developers, Bug Reporting and Feature Requests</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/index.html b/external/privoxy/doc/webserver/index.html index f52958f..3afc2d9 100644 --- a/external/privoxy/doc/webserver/index.html +++ b/external/privoxy/doc/webserver/index.html @@ -1,207 +1,328 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy - Home Page</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <meta name="KEYWORD" content="privoxy"> - <meta name="KEYWORD" content="HTTP"> - <meta name="KEYWORD" content="proxy"> - <meta name="KEYWORD" content="privacy"> - <meta name="KEYWORD" content="popups"> - <meta name="KEYWORD" content="po-ups"> - <meta name="KEYWORD" content="HTML"> - <meta name="KEYWORD" content="JavaScript"> - <meta name="KEYWORD" content="cleaning"> - <meta name="KEYWORD" content="blocking"> - <meta name="KEYWORD" content="cleaner"> - <meta name="KEYWORD" content="blocker"> - <meta name="KEYWORD" content="filter"> - <meta name="KEYWORD" content="proxy"> - <meta name="KEYWORD" content="junk"> - <meta name="KEYWORD" content="ad"> - <meta name="KEYWORD" content="advertisement"> - <meta name="KEYWORD" content="banner"> - <meta name="KEYWORD" content="webbugs"> - <meta name="KEYWORD" content="web-bugs"> - <meta name="KEYWORD" content="werbung"> - <meta name="KEYWORD" content="junkbusters"> - <meta name="KEYWORD" content="junkbuster"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <meta name="description" content= - "Privoxy helps users to protect their privacy."> - <meta name="MSSmartTagsPreventParsing" content="TRUE"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - col.c1 {text-align: center} - </style> -</head> - -<body class="ARTICLE"> - <div class="ARTICLE"> - <div class="TITLEPAGE"> - <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy - Home Page</a></h1> - - <div class="ABSTRACT"> - <a name="AEN28" id="AEN28"></a> - - <p>Privoxy is a non-caching web proxy with advanced filtering - capabilities for enhancing privacy, modifying web page data and HTTP - headers, controlling access, and removing ads and other obnoxious - Internet junk. Privoxy has a flexible configuration and can be - customized to suit individual needs and tastes. It has application - for both stand-alone systems and multi-user networks.</p> - - <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p> - - <p>Privoxy is an associated project of Software in the Public - Interest (SPI).</p> - - <p>Helping hands and donations are welcome:</p> - - <ul> - <li> - <p><a href="http://www.privoxy.org/faq/general.html#PARTICIPATE" - target= - "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a></p> - </li> - - <li> - <p><a href="http://www.privoxy.org/faq/general.html#DONATE" - target= - "_top">http://www.privoxy.org/faq/general.html#DONATE</a></p> - </li> - </ul> - - <p>The most recent release is <a href="announce.txt" target= - "_top">3.0.19 (stable)</a>.</p> - </div> - <hr> - </div> - - <div class="SECT1"> - <h3 class="SECT1"><a name="DOWNLOAD" id="DOWNLOAD">Download</a></h3> - - <ul> - <li> - <p><a href="https://sourceforge.net/projects/ijbswa/files/" target= - "_top">Download recent releases</a></p> - </li> - - <li> - <p><a href="user-manual/quickstart.html" target="_top">Quickstart - after installation</a></p> - </li> - </ul> - </div> - - <div class="SECT1"> - <hr> - - <h3 class="SECT1"><a name="DOCS" id="DOCS">Documentation</a></h3> - - <ul> - <li> - <p><a href="user-manual/index.html" target="_top">User - manual</a></p> - </li> - - <li> - <p><a href="faq/index.html" target="_top">Frequently Asked - Questions</a></p> - </li> - - <li> - <p><a href="developer-manual/index.html" target="_top">Developer - Manual</a></p> - </li> - - <li> - <p><a href="man-page/privoxy-man-page.html" target="_top">Classic - Man Page</a></p> - </li> - </ul> - </div> - - <div class="SECT1"> - <hr> - - <h3 class="SECT1"><a name="MOREINFO" id="MOREINFO">More - information</a></h3> - - <ul> - <li> - <p><a href="user-manual/contact.html" target="_top">Support & - Service</a></p> - </li> - - <li> - <p><a href="user-manual/copyright.html" target="_top">Copyright, - License, History & Authors</a></p> - </li> - - <li> - <p><a href="user-manual/introduction.html#FEATURES" target= - "_top">List of (new) Features</a></p> - </li> - - <li> - <p><a href="https://sourceforge.net/projects/ijbswa/" target= - "_top">The project page</a></p> - </li> - - <li> - <p><a href="user-manual/seealso.html" target="_top">Related - links</a></p> - </li> - - <li> - <p><a href="http://www.privoxy.org/team/index.html" target= - "_top">Pictures of the Privoxy Team</a></p> - </li> - </ul> - </div> - - <div class="SECT1"> - <hr> - - <h2 class="SECT1"><a name="AEN90" id="AEN90"></a></h2> - - <div class="INFORMALTABLE"> - <a name="AEN93" id="AEN93"></a> - - <table border="0" frame="void" rules="all" width="100%" class= - "CALSTABLE"> - <col class="c1" width="100%" title="C1"> - - <tbody> - <tr> - <td align="center">Privoxy is developed on:</td> - </tr> - - <tr> - <td align="center"><a href="http://sourceforge.net/" target= - "_top"><img src= - "http://sourceforge.net/sflogo.php?group_id=11118&type=1&dummy=.gif%2...</a></td> - </tr> - </tbody> - </table> - </div> - - <p><sub>Copyright © 2001-2010 by Privoxy Developers</sub></p> - </div> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Privoxy - Home Page</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><META +NAME="KEYWORD" +CONTENT="privoxy"><META +NAME="KEYWORD" +CONTENT="HTTP"><META +NAME="KEYWORD" +CONTENT="proxy"><META +NAME="KEYWORD" +CONTENT="privacy"><META +NAME="KEYWORD" +CONTENT="popups"><META +NAME="KEYWORD" +CONTENT="po-ups"><META +NAME="KEYWORD" +CONTENT="HTML"><META +NAME="KEYWORD" +CONTENT="JavaScript"><META +NAME="KEYWORD" +CONTENT="cleaning"><META +NAME="KEYWORD" +CONTENT="blocking"><META +NAME="KEYWORD" +CONTENT="cleaner"><META +NAME="KEYWORD" +CONTENT="blocker"><META +NAME="KEYWORD" +CONTENT="filter"><META +NAME="KEYWORD" +CONTENT="proxy"><META +NAME="KEYWORD" +CONTENT="junk"><META +NAME="KEYWORD" +CONTENT="ad"><META +NAME="KEYWORD" +CONTENT="advertisement"><META +NAME="KEYWORD" +CONTENT="banner"><META +NAME="KEYWORD" +CONTENT="webbugs"><META +NAME="KEYWORD" +CONTENT="web-bugs"><META +NAME="KEYWORD" +CONTENT="werbung"><META +NAME="KEYWORD" +CONTENT="junkbusters"><META +NAME="KEYWORD" +CONTENT="junkbuster"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<meta name="description" content="Privoxy helps users to protect their privacy."> +<meta name="MSSmartTagsPreventParsing" content="TRUE"></HEAD +><BODY +CLASS="ARTICLE" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="ARTICLE" +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +><A +NAME="AEN2" +>Privoxy - Home Page</A +></H1 +><DIV +><DIV +CLASS="ABSTRACT" +><P +></P +><A +NAME="AEN28" +></A +><P +> Privoxy is a non-caching web proxy with advanced filtering capabilities + for enhancing privacy, modifying web page data and HTTP headers, controlling + access, and removing ads and other obnoxious Internet junk. Privoxy has a + flexible configuration and can be customized to suit individual needs and tastes. + It has application for both stand-alone systems and multi-user networks.</P +><P +> Privoxy is Free Software and licensed under the GPL2.</P +><P +> Privoxy is an associated project of Software in the Public Interest (SPI). + <A +HREF="http://www.privoxy.org/faq/general.html#DONATE" +TARGET="_top" +>Donations are welcome</A +>.</P +><P +> The most recent release is <A +HREF="announce.txt" +TARGET="_top" +>3.0.12 (stable)</A +>. + </P +><P +></P +></DIV +></DIV +><HR></DIV +><DIV +CLASS="SECT1" +><H3 +CLASS="SECT1" +><A +NAME="DOWNLOAD" +>Download</A +></H3 +><P +> <P +></P +><UL +><LI +><P +> <A +HREF="https://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>Download recent releases</A +> + </P +></LI +><LI +><P +> <A +HREF="user-manual/quickstart.html" +TARGET="_top" +>Quickstart after installation</A +> + </P +></LI +></UL +></P +></DIV +><DIV +CLASS="SECT1" +><HR><H3 +CLASS="SECT1" +><A +NAME="DOCS" +>Documentation</A +></H3 +><P +> <P +></P +><UL +><LI +><P +> <A +HREF="user-manual/index.html" +TARGET="_top" +>User manual</A +> + </P +></LI +><LI +><P +> <A +HREF="faq/index.html" +TARGET="_top" +>Frequently Asked Questions</A +> + </P +></LI +><LI +><P +> <A +HREF="developer-manual/index.html" +TARGET="_top" +>Developer Manual</A +> + </P +></LI +><LI +><P +> <A +HREF="man-page/privoxy-man-page.html" +TARGET="_top" +>Classic Man Page</A +> + </P +></LI +></UL +></P +></DIV +><DIV +CLASS="SECT1" +><HR><H3 +CLASS="SECT1" +><A +NAME="MOREINFO" +>More information</A +></H3 +><P +> <P +></P +><UL +><LI +><P +> <A +HREF="user-manual/contact.html" +TARGET="_top" +>Support & Service</A +> + </P +></LI +><LI +><P +> <A +HREF="user-manual/copyright.html" +TARGET="_top" +>Copyright, License, History & Authors</A +> + </P +></LI +><LI +><P +> <A +HREF="user-manual/introduction.html#FEATURES" +TARGET="_top" +>List of (new) Features</A +> + </P +></LI +><LI +><P +> <A +HREF="https://sourceforge.net/projects/ijbswa/" +TARGET="_top" +>The project page</A +> + </P +></LI +><LI +><P +> <A +HREF="user-manual/seealso.html" +TARGET="_top" +>Related links</A +> + </P +></LI +><LI +><P +> + + <A +HREF="http://privoxy.org/team/index.html" +TARGET="_top" +>Pictures of the Privoxy Team</A +> + </P +></LI +></UL +></P +></DIV +><DIV +CLASS="SECT1" +><HR><H2 +CLASS="SECT1" +><A +NAME="AEN83" +></A +></H2 +><P +><DIV +CLASS="INFORMALTABLE" +><P +></P +><A +NAME="AEN86" +></A +><TABLE +BORDER="0" +FRAME="void" +RULES="all" +WIDTH="100%" +CLASS="CALSTABLE" +><COL +WIDTH="100%" +ALIGN="CENTER" +TITLE="C1"><TBODY +><TR +><TD +ALIGN="CENTER" +>Privoxy is developed on:</TD +></TR +><TR +><TD +ALIGN="CENTER" +> <A +HREF="http://sourceforge.net/" +TARGET="_top" +> <IMG +SRC="http://sourceforge.net/sflogo.php?group_id=11118&type=1&dummy=.gif%2... + </A +> + </TD +></TR +></TBODY +></TABLE +><P +></P +></DIV +></P +><P +> <SUB +> Copyright © 2001-2009 by Privoxy Developers + </SUB +></P +></DIV +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/man-page/privoxy-man-page.html b/external/privoxy/doc/webserver/man-page/privoxy-man-page.html index 58e137d..91f045d 100644 --- a/external/privoxy/doc/webserver/man-page/privoxy-man-page.html +++ b/external/privoxy/doc/webserver/man-page/privoxy-man-page.html @@ -1,213 +1,294 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
-<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy Man page</title> - <link rel="stylesheet" type="text/css" href="../p_web.css"> -</head> - -<body> - <h2>NAME</h2> - <pre> -<!-- Manpage converted by man2html 3.0.1 --> - -</pre> - - <h2>SYNOPSIS</h2> - <pre> - <b>privoxy</b> [<b>--help</b> ] [<b>--version</b> ] [<b>--no-daemon</b> ] [<b>--pidfile</b> <i>pidfile</i> ] - [<b>--user</b> <i>user[.group]</i> ] [<b>--chroot</b> ] [<b>--pre-chroot-nslookup</b> <i>hostname</i> ] - [<i>configfile</i> ] - - - -</pre> - - <h2>OPTIONS</h2> - <pre> - <b>Privoxy</b> may be invoked with the following command line options: - - <b>--help</b> Print brief usage info and exit. - - <b>--version</b> - Print version info and exit. - - <b>--no-daemon</b> - Don't become a daemon, i.e. don't fork and become process - group leader, don't detach from controlling tty, and do all log- - ging there. - - <b>--pidfile</b> <i>pidfile</i> - On startup, write the process ID to <i>pidfile</i>. Delete the <i>pidfile</i> - on exit. Failure to create or delete the <i>pidfile</i> is non-fatal. - If no <b>--pidfile</b> option is given, no PID file will be used. - - <b>--user</b> <i>user[.group]</i> - After (optionally) writing the PID file, assume the user ID of - <i>user</i> and the GID of <i>group</i>, or, if the optional <i>group</i> was not - given, the default group of <i>user</i>. Exit if the privileges are not - sufficient to do so. - - <b>--chroot</b> - Before changing to the user ID given in the --user option, - chroot to that user's home directory, i.e. make the kernel pre- - tend to the <b>Privoxy</b> process that the directory tree starts - there. If set up carefully, this can limit the impact of possi- - ble vulnerabilities in <b>Privoxy</b> to the files contained in that - hierarchy. - - <b>--pre-chroot-nslookup</b> <i>hostname</i> - Initialize the resolver library using <i>hostname</i> before - chroot'ing. On some systems this reduces the number of files - that must be copied into the chroot tree. - - If the <i>configfile</i> is not specified on the command line, <b>Privoxy</b> - will look for a file named <i>config</i> in the current directory. If no <i>con-</i> - <i>figfile</i> is found, <b>Privoxy</b> will fail to start. - - -</pre> - - <h2>DESCRIPTION</h2> - <pre> - Privoxy is a non-caching web proxy with advanced filtering capabilities - for enhancing privacy, modifying web page data and HTTP headers, con- - trolling access, and removing ads and other obnoxious Internet junk. - Privoxy has a flexible configuration and can be customized to suit - - -</pre> - - <h2>INSTALLATION AND USAGE</h2> - <pre> - Browsers can either be individually configured to use <b>Privoxy</b> as a HTTP - proxy (recommended), or <b>Privoxy</b> can be combined with a packet filter to - build an intercepting proxy (see <i>config</i>). The default setting is for - localhost, on port 8118 (configurable in the main config file). To - set the HTTP proxy in Firefox, go through: <b>Tools</b>; <b>Options</b>; <b>General</b>; - <b>Connection</b> <b>Settings</b>; <b>Manual</b> <b>Proxy</b> <b>Configuration</b>. - - For Internet Explorer, go through: <b>Tools</b>; <b>Internet</b> <b>Properties</b>; <b>Connec-</b> - <b>tions</b>; <b>LAN</b> <b>Settings</b>. - - The Secure (SSL) Proxy should also be set to the same values, otherwise - https: URLs will not be proxied. Note: <b>Privoxy</b> can only proxy HTTP and - HTTPS traffic. Do not try it with FTP or other protocols. HTTPS - presents some limitations, and not all features will work with HTTPS - connections. - - For other browsers, check the documentation. - - -</pre> - - <h2>CONFIGURATION</h2> - <pre> - <b>Privoxy</b> can be configured with the various configuration files. The - default configuration files are: <i>config</i>, <i>default.filter</i>, <i>default.action</i> - and <i>default.action</i>. <i>user.action</i> should be used for locally defined - exceptions to the default rules in <i>match-all.action</i> and <i>default.action</i>, - and <i>user.filter</i> for locally defined filters. These are well commented. - On Unix and Unix-like systems, these are located in <i>/etc/privoxy/</i> by - default. - - <b>Privoxy</b> uses the concept of <b>actions</b> in order to manipulate the data - stream between the browser and remote sites. There are various actions - available with specific functions for such things as blocking web - sites, managing cookies, etc. These actions can be invoked individually - or combined, and used against individual URLs, or groups of URLs that - can be defined using wildcards and regular expressions. The result is - that the user has greatly enhanced control and freedom. - - The actions list (ad blocks, etc) can also be configured with your web - browser at http://config.privoxy.org/ (assuming the configuration - allows it). <b>Privoxy's</b> configuration parameters can also be viewed at - the same page. In addition, <b>Privoxy</b> can be toggled on/off. This is an - internal page, and does not require Internet access. - - See the <i>User</i> <i>Manual</i> for a detailed explanation of installation, general - usage, all configuration options, new features and notes on upgrading. - - -</pre> - - <h2>FILES</h2> - <pre> - <i>/usr/sbin/privoxy</i> - <i>/etc/privoxy/config</i> - <i>/etc/privoxy/match-all.action</i> - <i>/etc/privoxy/default.action</i> - <i>/etc/privoxy/user.action</i> - <i>/etc/privoxy/default.filter</i> - detect them automatically. - - -</pre> - - <h2>NOTES</h2> - <pre> - This is a UNRELEASED version of <b>Privoxy</b>. Not all features are well - tested. - - Please see the <i>User</i> <i>Manual</i> on how to contact the developers, for fea- - ture requests, reporting problems, and other questions. - - -</pre> - - <h2>SEE ALSO</h2> - <pre> - Other references and sites of interest to <b>Privoxy</b> users: - - - http://www.privoxy.org/, the <b>Privoxy</b> Home page. - - http://www.privoxy.org/faq/, the <b>Privoxy</b> FAQ. - - http://www.privoxy.org/developer-manual/, the <b>Privoxy</b> developer manual. - - https://sourceforge.net/projects/ijbswa/, the Project Page for <b>Privoxy</b> - on SourceForge. - - http://config.privoxy.org/, the web-based user interface. <b>Privoxy</b> must - be running for this to work. Shortcut: http://p.p/ - - https://sourceforge.net/tracker/?group_id=11118&atid=460288, to submit - ``misses'' and other configuration related suggestions to the develop- - ers. - - -</pre> - - <h2>DEVELOPMENT TEAM</h2> - <pre> - Fabian Keil, lead developer - David Schmidt, developer - - Hal Burgiss - Lee Rian - Roland Rosenfeld - - -</pre> - - <h2>COPYRIGHT AND LICENSE</h2> - <pre> - <b>COPYRIGHT</b> - Copyright (C) 2001-2011 by Privoxy Developers <ijbswa-develop- - ers@lists.sourceforge.net> - - Some source code is based on code Copyright (C) 1997 by Anonymous - Coders and Junkbusters, Inc. and licensed under the <i>GNU</i> <i>General</i> <i>Public</i> - <i>License</i>. - - <b>LICENSE</b> - <b>Privoxy</b> is free software; you can redistribute it and/or modify it - under the terms of the <i>GNU</i> <i>General</i> <i>Public</i> <i>License</i>, version 2, as pub- - lished by the Free Software Foundation. -</pre> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<HTML><HEAD><TITLE>Man page of PRIVOXY</TITLE> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="../p_doc.css"></HEAD><BODY> +<H1>PRIVOXY</H1> +Section: (1)<BR>Updated: 21 March 2009<BR><A HREF="#index">Index</A> +<HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +privoxy - Privacy Enhancing Proxy +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<P> +<B>privoxy</B> [<B>--help</B> ] [<B>--version</B> ] [<B>--no-daemon</B> ] [<B>--pidfile </B><I>pidfile</I><B></B> ] [<B>--user </B><I>user[.group]</I><B></B> ] [<B>--chroot</B> ] [<B>--pre-chroot-nslookup </B><I>hostname</I><B></B> ] [<B></B><I>configfile</I><B></B> ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +<P> + +<B>Privoxy</B> may be invoked with the following command line +options: +<DL COMPACT> +<DT><B>--help</B><DD> +Print brief usage info and exit. +<DT><B>--version</B><DD> +Print version info and exit. +<DT><B>--no-daemon</B><DD> +Don't become a daemon, i.e. don't fork and become process group +leader, don't detach from controlling tty, and do all logging there. +<DT><B>--pidfile </B><I>pidfile</I><B></B><DD> +On startup, write the process ID to <I>pidfile</I>. +Delete the <I>pidfile</I> on exit. +Failure to create or delete the <I>pidfile</I> +is non-fatal. If no <B>--pidfile</B> option is given, no PID file will be used. +<DT><B>--user </B><I>user[.group]</I><B></B><DD> +After (optionally) writing the PID file, assume the user ID of +<I>user</I> and the GID of +<I>group</I>, or, if the optional +<I>group</I> was not given, the default group of +<I>user</I>. Exit if the privileges are not +sufficient to do so. +<DT><B>--chroot</B><DD> +Before changing to the user ID given in the --user option, chroot to +that user's home directory, i.e. make the kernel pretend to the +<B>Privoxy</B> process that the directory tree starts +there. If set up carefully, this can limit the impact of possible +vulnerabilities in <B>Privoxy</B> to the files contained in +that hierarchy. +<DT><B>--pre-chroot-nslookup </B><I>hostname</I><B></B><DD> +Initialize the resolver library using <I>hostname</I> +before chroot'ing. On some systems this reduces the number of files +that must be copied into the chroot tree. +</DL> +<P> + +If the <I>configfile</I> is not specified on the command line, +<B>Privoxy</B> will look for a file named +<I>config</I> in the current directory. If no +<I>configfile</I> is found, <B>Privoxy</B> will +fail to start. +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +<P> + +Privoxy is a non-caching web proxy with advanced filtering capabilities +for enhancing privacy, modifying web page data and HTTP headers, controlling +access, and removing ads and other obnoxious Internet junk. Privoxy has a +flexible configuration and can be customized to suit individual needs and tastes. +It has application for both stand-alone systems and multi-user networks. +<P> + +Privoxy is Free Software and licensed under the GPL2. +<A NAME="lbAF"> </A> +<H2>INSTALLATION AND USAGE</H2> + +<P> + +Browsers can either be individually configured to use +<B>Privoxy</B> as a HTTP proxy (recommended), +or <B>Privoxy</B> can be combined with a packet +filter to build an intercepting proxy +(see <I>config</I>). The default setting is for +localhost, on port 8118 (configurable in the main config file). To set the +HTTP proxy in Firefox, go through: <B>Tools</B>; +<B>Options</B>; <B>General</B>; +<B>Connection Settings</B>; +<B>Manual Proxy Configuration</B>. +<P> + +For Internet Explorer, go through: <B>Tools</B>; +<B>Internet Properties</B>; <B>Connections</B>; +<B>LAN Settings</B>. +<P> + +The Secure (SSL) Proxy should also be set to the same values, otherwise +https: URLs will not be proxied. Note: <B>Privoxy</B> can only +proxy HTTP and HTTPS traffic. Do not try it with FTP or other protocols. +HTTPS presents some limitations, and not all features will work with HTTPS +connections. +<P> + +For other browsers, check the documentation. +<A NAME="lbAG"> </A> +<H2>CONFIGURATION</H2> + +<P> + +<B>Privoxy</B> can be configured with the various configuration +files. The default configuration files are: <I>config</I>, +<I>default.filter</I>, <I>default.action</I> and +<I>default.action</I>. <I>user.action</I> should +be used for locally defined exceptions to the default rules in +<I>match-all.action</I> and <I>default.action</I>, +and <I>user.filter</I> for locally defined filters. These are +well commented. On Unix and Unix-like systems, these are located in +<I>/etc/privoxy/</I> by default. +<P> + +<B>Privoxy</B> uses the concept of <B>actions</B> +in order to manipulate the data stream between the browser and remote sites. +There are various actions available with specific functions for such things +as blocking web sites, managing cookies, etc. These actions can be invoked +individually or combined, and used against individual URLs, or groups of URLs +that can be defined using wildcards and regular expressions. The result is +that the user has greatly enhanced control and freedom. +<P> + +The actions list (ad blocks, etc) can also be configured with your +web browser at <A HREF="http://config.privoxy.org/">http://config.privoxy.org/</A> +(assuming the configuration allows it). +<B>Privoxy's</B> configuration parameters can also be viewed at +the same page. In addition, <B>Privoxy</B> can be toggled on/off. +This is an internal page, and does not require Internet access. +<P> + +See the <I>User Manual</I> for a detailed +explanation of installation, general usage, all configuration options, new +features and notes on upgrading. +<A NAME="lbAH"> </A> +<H2>FILES</H2> + +<P> +<PRE> + + <I>/usr/sbin/privoxy</I> + <I>/etc/privoxy/config</I> + <I>/etc/privoxy/match-all.action</I> + <I>/etc/privoxy/default.action</I> + <I>/etc/privoxy/user.action</I> + <I>/etc/privoxy/default.filter</I> + <I>/etc/privoxy/user.filter</I> + <I>/etc/privoxy/trust</I> + <I>/etc/privoxy/templates/*</I> + <I>/var/log/privoxy/logfile</I> +</PRE> + +<P> + +Various other files should be included, but may vary depending on platform +and build configuration. Additional documentation should be included in the local +documentation directory. +<A NAME="lbAI"> </A> +<H2>SIGNALS</H2> + +<P> + +<B>Privoxy</B> terminates on the <B>SIGINT</B>, +<B>SIGTERM</B> and <B>SIGABRT</B> signals. Log +rotation scripts may cause a re-opening of the logfile by sending a +<B>SIGHUP</B> to <B>Privoxy</B>. Note that unlike +other daemons, <B>Privoxy</B> does not need to be made aware of +config file changes by <B>SIGHUP</B> -- it will detect them +automatically. +<A NAME="lbAJ"> </A> +<H2>NOTES</H2> + +<P> + +Please see the <I>User Manual</I> on how to contact the +developers, for feature requests, reporting problems, and other questions. +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +<P> + +Other references and sites of interest to <B>Privoxy</B> +users: +<P> + +<P> +<A HREF="http://www.privoxy.org/">http://www.privoxy.org/,</A> +the <B>Privoxy</B> Home page. +<P> +<A HREF="http://www.privoxy.org/faq/">http://www.privoxy.org/faq/,</A> +the <B>Privoxy</B> FAQ. +<P> +<A HREF="http://www.privoxy.org/developer-manual/">http://www.privoxy.org/developer-manual/,</A> +the <B>Privoxy</B> developer manual. +<P> +<A HREF="https://sourceforge.net/projects/ijbswa/">https://sourceforge.net/projects/ijbswa/,</A> +the Project Page for <B>Privoxy</B> on +SourceForge. +<P> +<A HREF="http://config.privoxy.org/">http://config.privoxy.org/,</A> +the web-based user interface. <B>Privoxy</B> must be +running for this to work. Shortcut: <A HREF="http://p.p/">http://p.p/</A> +<P> +<A HREF="https://sourceforge.net/tracker/?group_id=11118">https://sourceforge.net/tracker/?group_id=11118</A>&atid=460288, to submit ``misses'' and other +configuration related suggestions to the developers. +<A NAME="lbAL"> </A> +<H2>DEVELOPMENT TEAM</H2> + +<P> +<PRE> + Fabian Keil, lead developer + David Schmidt, developer + + Hal Burgiss + Mark Miller + Gerry Murphy + Lee Rian + Roland Rosenfeld + Jörg Strohmayer +</PRE> + +<A NAME="lbAM"> </A> +<H2>COPYRIGHT AND LICENSE</H2> + +<A NAME="lbAN"> </A> +<H3>COPYRIGHT</H3> + +<P> + +Copyright (C) 2001-2009 by Privoxy Developers <<A HREF="mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</A>> +<P> + +Some source code is based on code Copyright (C) 1997 by Anonymous Coders +and Junkbusters, Inc. and licensed under the <I>GNU General Public +License</I>. +<A NAME="lbAO"> </A> +<H3>LICENSE</H3> + +<P> + +<B>Privoxy</B> is free software; you can +redistribute it and/or modify it under the terms of the +<I>GNU General Public License</I>, version 2, +as published by the Free Software Foundation. +<P> + +This program is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE. See the <I>GNU General Public License</I> for details. +<P> + +You should have received a copy of the <I>GNU GPL</I> +along with this program; if not, write to the Free Software +Foundation, Inc. 51 Franklin Street, Fifth Floor +Boston, MA 02110-1301 +USA +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">INSTALLATION AND USAGE</A><DD> +<DT><A HREF="#lbAG">CONFIGURATION</A><DD> +<DT><A HREF="#lbAH">FILES</A><DD> +<DT><A HREF="#lbAI">SIGNALS</A><DD> +<DT><A HREF="#lbAJ">NOTES</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +<DT><A HREF="#lbAL">DEVELOPMENT TEAM</A><DD> +<DT><A HREF="#lbAM">COPYRIGHT AND LICENSE</A><DD> +<DL> +<DT><A HREF="#lbAN">COPYRIGHT</A><DD> +<DT><A HREF="#lbAO">LICENSE</A><DD> +</DL> +</DL> +<HR> +This document was created by +man2html, +using the manual pages.<BR> +Time: 11:32:52 GMT, March 21, 2009 +</BODY> +</HTML> diff --git a/external/privoxy/doc/webserver/privoxy-index.html b/external/privoxy/doc/webserver/privoxy-index.html index 4bde44a..22cec35 100644 --- a/external/privoxy/doc/webserver/privoxy-index.html +++ b/external/privoxy/doc/webserver/privoxy-index.html @@ -1,185 +1,283 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy - The Privacy Enhancing Proxy</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <meta name="KEYWORD" content="privoxy"> - <meta name="KEYWORD" content="HTTP"> - <meta name="KEYWORD" content="proxy"> - <meta name="KEYWORD" content="privacy"> - <meta name="KEYWORD" content="popups"> - <meta name="KEYWORD" content="po-ups"> - <meta name="KEYWORD" content="HTML"> - <meta name="KEYWORD" content="JavaScript"> - <meta name="KEYWORD" content="cleaning"> - <meta name="KEYWORD" content="blocking"> - <meta name="KEYWORD" content="cleaner"> - <meta name="KEYWORD" content="blocker"> - <meta name="KEYWORD" content="filter"> - <meta name="KEYWORD" content="proxy"> - <meta name="KEYWORD" content="junk"> - <meta name="KEYWORD" content="ad"> - <meta name="KEYWORD" content="advertisement"> - <meta name="KEYWORD" content="banner"> - <meta name="KEYWORD" content="webbugs"> - <meta name="KEYWORD" content="web-bugs"> - <meta name="KEYWORD" content="werbung"> - <meta name="KEYWORD" content="junkbusters"> - <meta name="KEYWORD" content="junkbuster"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <meta name="description" content= - "Privoxy helps users to protect their privacy."> - <meta name="MSSmartTagsPreventParsing" content="TRUE"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - </style> -</head> - -<body class="ARTICLE"> - <div class="ARTICLE"> - <div class="TITLEPAGE"> - <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy - The Privacy - Enhancing Proxy</a></h1> - - <h2 class="SUBTITLE">Project Index Page v3.0.19</h2> - - <div class="ABSTRACT"> - <a name="AEN29" id="AEN29"></a> - - <p>Privoxy is a non-caching web proxy with advanced filtering - capabilities for enhancing privacy, modifying web page data and HTTP - headers, controlling access, and removing ads and other obnoxious - Internet junk. Privoxy has a flexible configuration and can be - customized to suit individual needs and tastes. It has application - for both stand-alone systems and multi-user networks.</p> - - <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p> - - <p>Privoxy is an associated project of Software in the Public - Interest (SPI).</p> - - <p>Helping hands and donations are welcome:</p> - - <ul> - <li> - <p><a href="http://www.privoxy.org/faq/general.html#PARTICIPATE" - target= - "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a></p> - </li> - - <li> - <p><a href="http://www.privoxy.org/faq/general.html#DONATE" - target= - "_top">http://www.privoxy.org/faq/general.html#DONATE</a></p> - </li> - </ul> - </div> - <hr> - </div> - - <div class="SECT1"> - <h3 class="SECT1"><a name="DOWNLOAD" id="DOWNLOAD">Download</a></h3> - - <ul> - <li> - <p><a href="https://sourceforge.net/projects/ijbswa/files/" target= - "_top">Download recent releases</a></p> - </li> - - <li> - <p><a href="user-manual/quickstart.html" target="_top">Quickstart - after installation</a></p> - </li> - </ul> - </div> - - <div class="SECT1"> - <hr> - - <h3 class="SECT1"><a name="DOCS" id="DOCS">Documentation</a></h3> - - <ul> - <li> - <p><a href="user-manual/index.html" target="_top">User - manual</a></p> - </li> - - <li> - <p><a href="faq/index.html" target="_top">Frequently Asked - Questions</a></p> - </li> - - <li> - <p><a href="developer-manual/index.html" target="_top">Developer - Manual</a></p> - </li> - - <li> - <p><a href="man-page/privoxy-man-page.html" target="_top">Classic - Man Page</a></p> - </li> - </ul> - </div> - - <div class="SECT1"> - <hr> - - <h3 class="SECT1"><a name="MOREINFO" id="MOREINFO">More - information</a></h3> - - <ul> - <li> - <p><a href="user-manual/contact.html" target="_top">Support & - Service</a></p> - </li> - - <li> - <p><a href="user-manual/copyright.html" target="_top">Copyright, - License, History & Authors</a></p> - </li> - - <li> - <p><a href="user-manual/introduction.html#FEATURES" target= - "_top">List of (new) Features</a></p> - </li> - - <li> - <p><a href="https://sourceforge.net/projects/ijbswa/" target= - "_top">The project page</a></p> - </li> - - <li> - <p><a href="user-manual/seealso.html" target="_top">Related - links</a></p> - </li> - - <li> - <p><a href="http://www.privoxy.org/team/index.html" target= - "_top">Pictures of the Privoxy Team</a></p> - </li> - </ul> - </div> - - <div class="SECT1"> - <hr> - - <h2 class="SECT1"><a name="AEN89" id="AEN89"></a></h2> - - <p><sub>Copyright © 2001-2010 by Privoxy Developers</sub></p> - </div> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Privoxy - The Privacy Enhancing Proxy</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><META +NAME="KEYWORD" +CONTENT="privoxy"><META +NAME="KEYWORD" +CONTENT="HTTP"><META +NAME="KEYWORD" +CONTENT="proxy"><META +NAME="KEYWORD" +CONTENT="privacy"><META +NAME="KEYWORD" +CONTENT="popups"><META +NAME="KEYWORD" +CONTENT="po-ups"><META +NAME="KEYWORD" +CONTENT="HTML"><META +NAME="KEYWORD" +CONTENT="JavaScript"><META +NAME="KEYWORD" +CONTENT="cleaning"><META +NAME="KEYWORD" +CONTENT="blocking"><META +NAME="KEYWORD" +CONTENT="cleaner"><META +NAME="KEYWORD" +CONTENT="blocker"><META +NAME="KEYWORD" +CONTENT="filter"><META +NAME="KEYWORD" +CONTENT="proxy"><META +NAME="KEYWORD" +CONTENT="junk"><META +NAME="KEYWORD" +CONTENT="ad"><META +NAME="KEYWORD" +CONTENT="advertisement"><META +NAME="KEYWORD" +CONTENT="banner"><META +NAME="KEYWORD" +CONTENT="webbugs"><META +NAME="KEYWORD" +CONTENT="web-bugs"><META +NAME="KEYWORD" +CONTENT="werbung"><META +NAME="KEYWORD" +CONTENT="junkbusters"><META +NAME="KEYWORD" +CONTENT="junkbuster"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<meta name="description" content="Privoxy helps users to protect their privacy."> +<meta name="MSSmartTagsPreventParsing" content="TRUE"></HEAD +><BODY +CLASS="ARTICLE" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="ARTICLE" +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +><A +NAME="AEN2" +>Privoxy - The Privacy Enhancing Proxy</A +></H1 +><H2 +CLASS="SUBTITLE" +>Project Index Page v3.0.12</H2 +><DIV +><DIV +CLASS="ABSTRACT" +><P +></P +><A +NAME="AEN29" +></A +><P +> Privoxy is a non-caching web proxy with advanced filtering capabilities + for enhancing privacy, modifying web page data and HTTP headers, controlling + access, and removing ads and other obnoxious Internet junk. Privoxy has a + flexible configuration and can be customized to suit individual needs and tastes. + It has application for both stand-alone systems and multi-user networks.</P +><P +> Privoxy is Free Software and licensed under the GPL2.</P +><P +> Privoxy is an associated project of Software in the Public Interest (SPI). + <A +HREF="http://www.privoxy.org/faq/general.html#DONATE" +TARGET="_top" +>Donations are welcome</A +>.</P +><P +></P +></DIV +></DIV +><HR></DIV +><DIV +CLASS="SECT1" +><H3 +CLASS="SECT1" +><A +NAME="DOWNLOAD" +>Download</A +></H3 +><P +> <P +></P +><UL +><LI +><P +> <A +HREF="https://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>Download recent releases</A +> + </P +></LI +><LI +><P +> <A +HREF="user-manual/quickstart.html" +TARGET="_top" +>Quickstart after installation</A +> + </P +></LI +></UL +></P +></DIV +><DIV +CLASS="SECT1" +><HR><H3 +CLASS="SECT1" +><A +NAME="DOCS" +>Documentation</A +></H3 +><P +> <P +></P +><UL +><LI +><P +> <A +HREF="user-manual/index.html" +TARGET="_top" +>User manual</A +> + </P +></LI +><LI +><P +> <A +HREF="faq/index.html" +TARGET="_top" +>Frequently Asked Questions</A +> + </P +></LI +><LI +><P +> <A +HREF="developer-manual/index.html" +TARGET="_top" +>Developer Manual</A +> + </P +></LI +><LI +><P +> <A +HREF="man-page/privoxy-man-page.html" +TARGET="_top" +>Classic Man Page</A +> + </P +></LI +></UL +></P +></DIV +><DIV +CLASS="SECT1" +><HR><H3 +CLASS="SECT1" +><A +NAME="MOREINFO" +>More information</A +></H3 +><P +> <P +></P +><UL +><LI +><P +> <A +HREF="user-manual/contact.html" +TARGET="_top" +>Support & Service</A +> + </P +></LI +><LI +><P +> <A +HREF="user-manual/copyright.html" +TARGET="_top" +>Copyright, License, History & Authors</A +> + </P +></LI +><LI +><P +> <A +HREF="user-manual/introduction.html#FEATURES" +TARGET="_top" +>List of (new) Features</A +> + </P +></LI +><LI +><P +> <A +HREF="https://sourceforge.net/projects/ijbswa/" +TARGET="_top" +>The project page</A +> + </P +></LI +><LI +><P +> <A +HREF="user-manual/seealso.html" +TARGET="_top" +>Related links</A +> + </P +></LI +><LI +><P +> + + <A +HREF="http://privoxy.org/team/index.html" +TARGET="_top" +>Pictures of the Privoxy Team</A +> + </P +></LI +></UL +></P +></DIV +><DIV +CLASS="SECT1" +><HR><H2 +CLASS="SECT1" +><A +NAME="AEN82" +></A +></H2 +><P +> <SUB +> Copyright © 2001-2009 by Privoxy Developers + </SUB +></P +></DIV +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/team/index.html b/external/privoxy/doc/webserver/team/index.html index 168c963..2903bcf 100644 --- a/external/privoxy/doc/webserver/team/index.html +++ b/external/privoxy/doc/webserver/team/index.html @@ -1,52 +1,26 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> - <html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - + <head> + <meta http-equiv="Content-Type"content="text/html; charset=iso-8859-1"> <title>Privoxy - Team Photos</title> <link rel="stylesheet" type="text/css" href="../p_doc.css"> - <style type="text/css"> -h1.c1 {margin-left: 0%} - </style> -</head> - -<body> - <h1 class="c1">Privoxy - Team Photos</h1> + </head> + <body> + <h1 style="margin-left: 0%">Privoxy - Team Photos</h1> <hr> - <p>In our day jobs, we're all models ;-)</p> - <table align="center"> - <tr> - <td><a href="01stefanw.jpg"><img src="01stefanw_t.jpg" width="80" - height="80" border="0" title="Stefan Waldherr"></a></td> - - <td><a href="02jon.jpg"><img src="02jon_t.jpg" width="80" height="80" - border="0" title="Jon Foster"></a></td> - - <td><a href="03andreas.jpg"><img src="03andreas_t.jpg" width="80" - height="80" border="0" title="Andreas Oesterhelt"></a></td> - - <td><a href="04rodney.jpg"><img src="04rodney_t.jpg" width="80" height= - "80" border="0" title="Rodney Stromlund"></a></td> - </tr> - - <tr> - <td><a href="05david.jpg"><img src="05david_t.jpg" width="80" height= - "80" border="0" title="David Schmidt"></a></td> - - <td><a href="06member.jpg"><img src="06member_t.jpg" width="80" height= - "80" border="0" title="N/A"></a></td> - - <td><a href="07member.jpg"><img src="07member_t.jpg" width="80" height= - "80" border="0" title="N/A"></a></td> - - <td><a href="08member.jpg"><img src="08member_t.jpg" width="80" height= - "80" border="0" title="N/A"></a></td> - </tr> + <tr> + <td><a href="01stefanw.jpg"><img src="01stefanw_t.jpg" width="80" height="80" border="0" title="Stefan Waldherr"></a></td> + <td><a href="02jon.jpg"><img src="02jon_t.jpg" width="80" height="80" border="0" title="Jon Foster"></a></td> + <td><a href="03andreas.jpg"><img src="03andreas_t.jpg" width="80" height="80" border="0" title="Andreas Oesterhelt"></a></td> + <td><a href="04rodney.jpg"><img src="04rodney_t.jpg" width="80" height="80" border="0" title="Rodney Stromlund"></a></td> + </tr> + <tr> + <td><a href="05david.jpg"><img src="05david_t.jpg" width="80" height="80" border="0" title="David Schmidt"></a></td> + <td><a href="06member.jpg"><img src="06member_t.jpg" width="80" height="80" border="0" title="N/A"></a></td> + <td><a href="07member.jpg"><img src="07member_t.jpg" width="80" height="80" border="0" title="N/A"></a></td> + <td><a href="08member.jpg"><img src="08member_t.jpg" width="80" height="80" border="0" title="N/A"></a></td> + </tr> </table> -</body> + </body> </html> diff --git a/external/privoxy/doc/webserver/user-manual/actions-file.html b/external/privoxy/doc/webserver/user-manual/actions-file.html index 4546113..be87aa7 100644 --- a/external/privoxy/doc/webserver/user-manual/actions-file.html +++ b/external/privoxy/doc/webserver/user-manual/actions-file.html @@ -1,1301 +1,2238 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Actions Files</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="The Main Configuration File" href= - "config.html"> - <link rel="NEXT" title="Filter Files" href="filter-file.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - td.c6 {font-weight: bold} - tt.c5 {font-style: italic} - table.c4 {background-color: #E0E0E0} - p.c3 {font-weight: bold} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="config.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "filter-file.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="ACTIONS-FILE" id="ACTIONS-FILE">8. Actions - Files</a></h1> - - <p>The actions files are used to define what <span class= - "emphasis EMPHASIS c2">actions</span> <span class= - "APPLICATION">Privoxy</span> takes for which URLs, and thus determines - how ad images, cookies and various other aspects of HTTP content and - transactions are handled, and on which sites (or even parts thereof). - There are a number of such actions, with a wide range of functionality. - Each action does something a little different. These actions give us a - veritable arsenal of tools with which to exert our control, preferences - and independence. Actions can be combined so that their effects are - aggregated when applied against a given set of URLs.</p> - - <p>There are three action files included with <span class= - "APPLICATION">Privoxy</span> with differing purposes:</p> - - <ul> - <li> - <p><tt class="FILENAME">match-all.action</tt> - is used to define - which <span class="QUOTE">"actions"</span> relating to - banner-blocking, images, pop-ups, content modification, cookie - handling etc should be applied by default. It should be the first - actions file loaded</p> - </li> - - <li> - <p><tt class="FILENAME">default.action</tt> - defines many exceptions - (both positive and negative) from the default set of actions that's - configured in <tt class="FILENAME">match-all.action</tt>. It is a set - of rules that should work reasonably well as-is for most users. This - file is only supposed to be edited by the developers. It should be - the second actions file loaded.</p> - </li> - - <li> - <p><tt class="FILENAME">user.action</tt> - is intended to be for - local site preferences and exceptions. As an example, if your ISP or - your bank has specific requirements, and need special handling, this - kind of thing should go here. This file will not be upgraded.</p> - </li> - - <li> - <p><span class="GUIBUTTON">Edit</span> <span class="GUIBUTTON">Set to - Cautious</span> <span class="GUIBUTTON">Set to Medium</span> - <span class="GUIBUTTON">Set to Advanced</span></p> - - <p>These have increasing levels of aggressiveness <span class= - "emphasis EMPHASIS c2">and have no influence on your browsing unless - you select them explicitly in the editor</span>. A default - installation should be pre-set to <tt class="LITERAL">Cautious</tt>. - New users should try this for a while before adjusting the settings - to more aggressive levels. The more aggressive the settings, then the - more likelihood there is of problems such as sites not working as - they should.</p> - - <p>The <span class="GUIBUTTON">Edit</span> button allows you to turn - each action on/off individually for fine-tuning. The <span class= - "GUIBUTTON">Cautious</span> button changes the actions list to - low/safe settings which will activate ad blocking and a minimal set - of <span class="APPLICATION">Privoxy</span>'s features, and - subsequently there will be less of a chance for accidental problems. - The <span class="GUIBUTTON">Medium</span> button sets the list to a - medium level of other features and a low level set of privacy - features. The <span class="GUIBUTTON">Advanced</span> button sets the - list to a high level of ad blocking and medium level of privacy. See - the chart below. The latter three buttons over-ride any changes via - with the <span class="GUIBUTTON">Edit</span> button. More fine-tuning - can be done in the lower sections of this internal page.</p> - - <p>While the actions file editor allows to enable these settings in - all actions files, they are only supposed to be enabled in the first - one to make sure you don't unintentionally overrule earlier - rules.</p> - - <p>The default profiles, and their associated actions, as pre-defined - in <tt class="FILENAME">default.action</tt> are:</p> - - <div class="TABLE"> - <a name="AEN2780" id="AEN2780"></a> - - <p class="c3">Table 1. Default Configurations</p> - - <table border="1" frame="border" rules="all" class="CALSTABLE"> - <col width="1*" title="C1"> - <col width="1*" title="C2"> - <col width="1*" title="C3"> - <col width="1*" title="C4"> - - <thead> - <tr> - <th>Feature</th> - - <th>Cautious</th> - - <th>Medium</th> - - <th>Advanced</th> - </tr> - </thead> - - <tbody> - <tr> - <td>Ad-blocking Aggressiveness</td> - - <td>medium</td> - - <td>high</td> - - <td>high</td> - </tr> - - <tr> - <td>Ad-filtering by size</td> - - <td>no</td> - - <td>yes</td> - - <td>yes</td> - </tr> - - <tr> - <td>Ad-filtering by link</td> - - <td>no</td> - - <td>no</td> - - <td>yes</td> - </tr> - - <tr> - <td>Pop-up killing</td> - - <td>blocks only</td> - - <td>blocks only</td> - - <td>blocks only</td> - </tr> - - <tr> - <td>Privacy Features</td> - - <td>low</td> - - <td>medium</td> - - <td>medium/high</td> - </tr> - - <tr> - <td>Cookie handling</td> - - <td>none</td> - - <td>session-only</td> - - <td>kill</td> - </tr> - - <tr> - <td>Referer forging</td> - - <td>no</td> - - <td>yes</td> - - <td>yes</td> - </tr> - - <tr> - <td>GIF de-animation</td> - - <td>no</td> - - <td>yes</td> - - <td>yes</td> - </tr> - - <tr> - <td>Fast redirects</td> - - <td>no</td> - - <td>no</td> - - <td>yes</td> - </tr> - - <tr> - <td>HTML taming</td> - - <td>no</td> - - <td>no</td> - - <td>yes</td> - </tr> - - <tr> - <td>JavaScript taming</td> - - <td>no</td> - - <td>no</td> - - <td>yes</td> - </tr> - - <tr> - <td>Web-bug killing</td> - - <td>no</td> - - <td>yes</td> - - <td>yes</td> - </tr> - - <tr> - <td>Image tag reordering</td> - - <td>no</td> - - <td>yes</td> - - <td>yes</td> - </tr> - </tbody> - </table> - </div> - </li> - </ul> - - <p>The list of actions files to be used are defined in the main - configuration file, and are processed in the order they are defined (e.g. - <tt class="FILENAME">default.action</tt> is typically processed before - <tt class="FILENAME">user.action</tt>). The content of these can all be - viewed and edited from <a href="http://config.privoxy.org/show-status" - target="_top">http://config.privoxy.org/show-status</a>. The over-riding - principle when applying actions, is that the last action that matches a - given URL wins. The broadest, most general rules go first (defined in - <tt class="FILENAME">default.action</tt>), followed by any exceptions - (typically also in <tt class="FILENAME">default.action</tt>), which are - then followed lastly by any local preferences (typically in <span class= - "emphasis EMPHASIS c2">user</span><tt class="FILENAME">.action</tt>). - Generally, <tt class="FILENAME">user.action</tt> has the last word.</p> - - <p>An actions file typically has multiple sections. If you want to use - <span class="QUOTE">"aliases"</span> in an actions file, you have to - place the (optional) <a href="actions-file.html#ALIASES">alias - section</a> at the top of that file. Then comes the default set of rules - which will apply universally to all sites and pages (be <span class= - "emphasis EMPHASIS c2">very careful</span> with using such a universal - set in <tt class="FILENAME">user.action</tt> or any other actions file - after <tt class="FILENAME">default.action</tt>, because it will override - the result from consulting any previous file). And then below that, - exceptions to the defined universal policies. You can regard <tt class= - "FILENAME">user.action</tt> as an appendix to <tt class= - "FILENAME">default.action</tt>, with the advantage that it is a separate - file, which makes preserving your personal settings across <span class= - "APPLICATION">Privoxy</span> upgrades easier.</p> - - <p>Actions can be used to block anything you want, including ads, - banners, or just some obnoxious URL whose content you would rather not - see. Cookies can be accepted or rejected, or accepted only during the - current browser session (i.e. not written to disk), content can be - modified, some JavaScripts tamed, user-tracking fooled, and much more. - See below for a <a href="actions-file.html#ACTIONS">complete list of - actions</a>.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN2879" id="AEN2879">8.1. Finding the Right - Mix</a></h2> - - <p>Note that some <a href="actions-file.html#ACTIONS">actions</a>, like - cookie suppression or script disabling, may render some sites unusable - that rely on these techniques to work properly. Finding the right mix - of actions is not always easy and certainly a matter of personal taste. - And, things can always change, requiring refinements in the - configuration. In general, it can be said that the more <span class= - "QUOTE">"aggressive"</span> your default settings (in the top section - of the actions file) are, the more exceptions for <span class= - "QUOTE">"trusted"</span> sites you will have to make later. If, for - example, you want to crunch all cookies per default, you'll have to - make exceptions from that rule for sites that you regularly use and - that require cookies for actually useful purposes, like maybe your - bank, favorite shop, or newspaper.</p> - - <p>We have tried to provide you with reasonable rules to start from in - the distribution actions files. But there is no general rule of thumb - on these things. There just are too many variables, and sites are - constantly changing. Sooner or later you will want to change the rules - (and read this chapter again :).</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN2886" id="AEN2886">8.2. How to - Edit</a></h2> - - <p>The easiest way to edit the actions files is with a browser by using - our browser-based editor, which can be reached from <a href= - "http://config.privoxy.org/show-status" target= - "_top">http://config.privoxy.org/show-status</a>. Note: the config file - option <a href= - "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a> must be - enabled for this to work. The editor allows both fine-grained control - over every single feature on a per-URL basis, and easy choosing from - wholesale sets of defaults like <span class="QUOTE">"Cautious"</span>, - <span class="QUOTE">"Medium"</span> or <span class= - "QUOTE">"Advanced"</span>. Warning: the <span class= - "QUOTE">"Advanced"</span> setting is more aggressive, and will be more - likely to cause problems for some sites. Experienced users only!</p> - - <p>If you prefer plain text editing to GUIs, you can of course also - directly edit the the actions files with your favorite text editor. - Look at <tt class="FILENAME">default.action</tt> which is richly - commented with many good examples.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="ACTIONS-APPLY" id="ACTIONS-APPLY">8.3. How - Actions are Applied to Requests</a></h2> - - <p>Actions files are divided into sections. There are special sections, - like the <span class="QUOTE">"<a href= - "actions-file.html#ALIASES">alias</a>"</span> sections which will be - discussed later. For now let's concentrate on regular sections: They - have a heading line (often split up to multiple lines for readability) - which consist of a list of actions, separated by whitespace and - enclosed in curly braces. Below that, there is a list of URL and tag - patterns, each on a separate line.</p> - - <p>To determine which actions apply to a request, the URL of the - request is compared to all URL patterns in each <span class= - "QUOTE">"action file"</span>. Every time it matches, the list of - applicable actions for the request is incrementally updated, using the - heading of the section in which the pattern is located. The same is - done again for tags and tag patterns later on.</p> - - <p>If multiple applying sections set the same action differently, the - last match wins. If not, the effects are aggregated. E.g. a URL might - match a regular section with a heading line of <tt class="LITERAL">{ - +<a href="actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a> - }</tt>, then later another one with just <tt class="LITERAL">{ - +<a href="actions-file.html#BLOCK">block</a> }</tt>, resulting in - <span class="emphasis EMPHASIS c2">both</span> actions to apply. And - there may well be cases where you will want to combine actions - together. Such a section then might look like:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - { +<tt class="LITERAL">handle-as-image</tt> +<tt class= -"LITERAL">block{Banner ads.}</tt> } +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Actions Files</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="The Main Configuration File" +HREF="config.html"><LINK +REL="NEXT" +TITLE="Filter Files" +HREF="filter-file.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="config.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="filter-file.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="ACTIONS-FILE" +>8. Actions Files</A +></H1 +><P +> The actions files are used to define what <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>actions</I +></SPAN +> + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> takes for which URLs, and thus determines + how ad images, cookies and various other aspects of HTTP content and + transactions are handled, and on which sites (or even parts thereof). + There are a number of such actions, with a wide range of functionality. + Each action does something a little different. + These actions give us a veritable arsenal of tools with which to exert + our control, preferences and independence. Actions can be combined so that + their effects are aggregated when applied against a given set of URLs.</P +><P +> There + are three action files included with <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with + differing purposes:</P +><P +> <P +></P +><UL +><LI +><P +> <TT +CLASS="FILENAME" +>match-all.action</TT +> - is used to define which + <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> relating to banner-blocking, images, pop-ups, + content modification, cookie handling etc should be applied by default. + It should be the first actions file loaded + </P +></LI +><LI +><P +> <TT +CLASS="FILENAME" +>default.action</TT +> - defines many exceptions (both + positive and negative) from the default set of actions that's configured + in <TT +CLASS="FILENAME" +>match-all.action</TT +>. It is a set of rules that should + work reasonably well as-is for most users. This file is only supposed to + be edited by the developers. It should be the second actions file loaded. + </P +></LI +><LI +><P +> <TT +CLASS="FILENAME" +>user.action</TT +> - is intended to be for local site + preferences and exceptions. As an example, if your ISP or your bank + has specific requirements, and need special handling, this kind of + thing should go here. This file will not be upgraded. + </P +></LI +><LI +><P +> <SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +> <SPAN +CLASS="GUIBUTTON" +>Set to Cautious</SPAN +> <SPAN +CLASS="GUIBUTTON" +>Set to Medium</SPAN +> <SPAN +CLASS="GUIBUTTON" +>Set to Advanced</SPAN +> + </P +><P +> These have increasing levels of aggressiveness <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>and have no + influence on your browsing unless you select them explicitly in the + editor</I +></SPAN +>. A default installation should be pre-set to + <TT +CLASS="LITERAL" +>Cautious</TT +>. New users should try this for a while before + adjusting the settings to more aggressive levels. The more aggressive + the settings, then the more likelihood there is of problems such as sites + not working as they should. + </P +><P +> The <SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +> button allows you to turn each + action on/off individually for fine-tuning. The <SPAN +CLASS="GUIBUTTON" +>Cautious</SPAN +> + button changes the actions list to low/safe settings which will activate + ad blocking and a minimal set of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s features, and subsequently + there will be less of a chance for accidental problems. The + <SPAN +CLASS="GUIBUTTON" +>Medium</SPAN +> button sets the list to a medium level of + other features and a low level set of privacy features. The + <SPAN +CLASS="GUIBUTTON" +>Advanced</SPAN +> button sets the list to a high level of + ad blocking and medium level of privacy. See the chart below. The latter + three buttons over-ride any changes via with the + <SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +> button. More fine-tuning can be done in the + lower sections of this internal page. + </P +><P +> While the actions file editor allows to enable these settings in all + actions files, they are only supposed to be enabled in the first one + to make sure you don't unintentionally overrule earlier rules. + </P +><P +> The default profiles, and their associated actions, as pre-defined in + <TT +CLASS="FILENAME" +>default.action</TT +> are: + </P +><P +> <DIV +CLASS="TABLE" +><A +NAME="AEN2189" +></A +><P +><B +>Table 1. Default Configurations</B +></P +><TABLE +BORDER="1" +FRAME="border" +RULES="all" +CLASS="CALSTABLE" +><COL +WIDTH="1*" +TITLE="C1"><COL +WIDTH="1*" +TITLE="C2"><COL +WIDTH="1*" +TITLE="C3"><COL +WIDTH="1*" +TITLE="C4"><THEAD +><TR +><TH +>Feature</TH +><TH +>Cautious</TH +><TH +>Medium</TH +><TH +>Advanced</TH +></TR +></THEAD +><TBODY +><TR +><TD +>Ad-blocking Aggressiveness</TD +><TD +>medium</TD +><TD +>high</TD +><TD +>high</TD +></TR +><TR +><TD +>Ad-filtering by size</TD +><TD +>no</TD +><TD +>yes</TD +><TD +>yes</TD +></TR +><TR +><TD +>Ad-filtering by link</TD +><TD +>no</TD +><TD +>no</TD +><TD +>yes</TD +></TR +><TR +><TD +>Pop-up killing</TD +><TD +>blocks only</TD +><TD +>blocks only</TD +><TD +>blocks only</TD +></TR +><TR +><TD +>Privacy Features</TD +><TD +>low</TD +><TD +>medium</TD +><TD +>medium/high</TD +></TR +><TR +><TD +>Cookie handling</TD +><TD +>none</TD +><TD +>session-only</TD +><TD +>kill</TD +></TR +><TR +><TD +>Referer forging</TD +><TD +>no</TD +><TD +>yes</TD +><TD +>yes</TD +></TR +><TR +><TD +>GIF de-animation</TD +><TD +>no</TD +><TD +>yes</TD +><TD +>yes</TD +></TR +><TR +><TD +>Fast redirects</TD +><TD +>no</TD +><TD +>no</TD +><TD +>yes</TD +></TR +><TR +><TD +>HTML taming</TD +><TD +>no</TD +><TD +>no</TD +><TD +>yes</TD +></TR +><TR +><TD +>JavaScript taming</TD +><TD +>no</TD +><TD +>no</TD +><TD +>yes</TD +></TR +><TR +><TD +>Web-bug killing</TD +><TD +>no</TD +><TD +>yes</TD +><TD +>yes</TD +></TR +><TR +><TD +>Image tag reordering</TD +><TD +>no</TD +><TD +>yes</TD +><TD +>yes</TD +></TR +></TBODY +></TABLE +></DIV +> + </P +></LI +></UL +></P +><P +> The list of actions files to be used are defined in the main configuration + file, and are processed in the order they are defined (e.g. + <TT +CLASS="FILENAME" +>default.action</TT +> is typically processed before + <TT +CLASS="FILENAME" +>user.action</TT +>). The content of these can all be viewed and + edited from <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +>. + The over-riding principle when applying actions, is that the last action that + matches a given URL wins. The broadest, most general rules go first + (defined in <TT +CLASS="FILENAME" +>default.action</TT +>), + followed by any exceptions (typically also in + <TT +CLASS="FILENAME" +>default.action</TT +>), which are then followed lastly by any + local preferences (typically in <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>user</I +></SPAN +><TT +CLASS="FILENAME" +>.action</TT +>). + Generally, <TT +CLASS="FILENAME" +>user.action</TT +> has the last word. + </P +><P +> An actions file typically has multiple sections. If you want to use + <SPAN +CLASS="QUOTE" +>"aliases"</SPAN +> in an actions file, you have to place the (optional) + <A +HREF="actions-file.html#ALIASES" +>alias section</A +> at the top of that file. + Then comes the default set of rules which will apply universally to all + sites and pages (be <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>very careful</I +></SPAN +> with using such a + universal set in <TT +CLASS="FILENAME" +>user.action</TT +> or any other actions file after + <TT +CLASS="FILENAME" +>default.action</TT +>, because it will override the result + from consulting any previous file). And then below that, + exceptions to the defined universal policies. You can regard + <TT +CLASS="FILENAME" +>user.action</TT +> as an appendix to <TT +CLASS="FILENAME" +>default.action</TT +>, + with the advantage that it is a separate file, which makes preserving your + personal settings across <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> upgrades easier.</P +><P +> + Actions can be used to block anything you want, including ads, banners, or + just some obnoxious URL whose content you would rather not see. Cookies can be accepted + or rejected, or accepted only during the current browser session (i.e. not + written to disk), content can be modified, some JavaScripts tamed, user-tracking + fooled, and much more. See below for a <A +HREF="actions-file.html#ACTIONS" +>complete list + of actions</A +>.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN2288" +>8.1. Finding the Right Mix</A +></H2 +><P +> Note that some <A +HREF="actions-file.html#ACTIONS" +>actions</A +>, like cookie suppression + or script disabling, may render some sites unusable that rely on these + techniques to work properly. Finding the right mix of actions is not always easy and + certainly a matter of personal taste. And, things can always change, requiring + refinements in the configuration. In general, it can be said that the more + <SPAN +CLASS="QUOTE" +>"aggressive"</SPAN +> your default settings (in the top section of the + actions file) are, the more exceptions for <SPAN +CLASS="QUOTE" +>"trusted"</SPAN +> sites you + will have to make later. If, for example, you want to crunch all cookies per + default, you'll have to make exceptions from that rule for sites that you + regularly use and that require cookies for actually useful purposes, like maybe + your bank, favorite shop, or newspaper.</P +><P +> We have tried to provide you with reasonable rules to start from in the + distribution actions files. But there is no general rule of thumb on these + things. There just are too many variables, and sites are constantly changing. + Sooner or later you will want to change the rules (and read this chapter again :).</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN2295" +>8.2. How to Edit</A +></H2 +><P +> The easiest way to edit the actions files is with a browser by + using our browser-based editor, which can be reached from <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +>. + Note: the config file option <A +HREF="config.html#ENABLE-EDIT-ACTIONS" +>enable-edit-actions</A +> must be enabled for + this to work. The editor allows both fine-grained control over every single + feature on a per-URL basis, and easy choosing from wholesale sets of defaults + like <SPAN +CLASS="QUOTE" +>"Cautious"</SPAN +>, <SPAN +CLASS="QUOTE" +>"Medium"</SPAN +> or + <SPAN +CLASS="QUOTE" +>"Advanced"</SPAN +>. Warning: the <SPAN +CLASS="QUOTE" +>"Advanced"</SPAN +> setting is more + aggressive, and will be more likely to cause problems for some sites. + Experienced users only! + </P +><P +> If you prefer plain text editing to GUIs, you can of course also directly edit the + the actions files with your favorite text editor. Look at + <TT +CLASS="FILENAME" +>default.action</TT +> which is richly commented with many + good examples.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="ACTIONS-APPLY" +>8.3. How Actions are Applied to Requests</A +></H2 +><P +> Actions files are divided into sections. There are special sections, + like the <SPAN +CLASS="QUOTE" +>"<A +HREF="actions-file.html#ALIASES" +>alias</A +>"</SPAN +> sections which will + be discussed later. For now let's concentrate on regular sections: They have a + heading line (often split up to multiple lines for readability) which consist + of a list of actions, separated by whitespace and enclosed in curly braces. + Below that, there is a list of URL and tag patterns, each on a separate line.</P +><P +> To determine which actions apply to a request, the URL of the request is + compared to all URL patterns in each <SPAN +CLASS="QUOTE" +>"action file"</SPAN +>. + Every time it matches, the list of applicable actions for the request is + incrementally updated, using the heading of the section in which the + pattern is located. The same is done again for tags and tag patterns later on.</P +><P +> If multiple applying sections set the same action differently, + the last match wins. If not, the effects are aggregated. + E.g. a URL might match a regular section with a heading line of <TT +CLASS="LITERAL" +>{ + +<A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +> }</TT +>, + then later another one with just <TT +CLASS="LITERAL" +>{ + +<A +HREF="actions-file.html#BLOCK" +>block</A +> }</TT +>, resulting + in <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>both</I +></SPAN +> actions to apply. And there may well be + cases where you will want to combine actions together. Such a section then + might look like:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> { +<TT +CLASS="LITERAL" +>handle-as-image</TT +> +<TT +CLASS="LITERAL" +>block{Banner ads.}</TT +> } # Block these as if they were images. Send no block page. banners.example.com media.example.com/.*banners - .example.com/images/ads/ -</pre> - </td> - </tr> - </table> - - <p>You can trace this process for URL patterns and any given URL by - visiting <a href="http://config.privoxy.org/show-url-info" target= - "_top">http://config.privoxy.org/show-url-info</a>.</p> - - <p>Examples and more detail on this is provided in the Appendix, - <a href="appendix.html#ACTIONSANAT">Troubleshooting: Anatomy of an - Action</a> section.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AF-PATTERNS" id="AF-PATTERNS">8.4. - Patterns</a></h2> - - <p>As mentioned, <span class="APPLICATION">Privoxy</span> uses - <span class="QUOTE">"patterns"</span> to determine what <span class= - "emphasis EMPHASIS c2">actions</span> might apply to which sites and - pages your browser attempts to access. These <span class= - "QUOTE">"patterns"</span> use wild card type <span class= - "emphasis EMPHASIS c2">pattern</span> matching to achieve a high degree - of flexibility. This allows one expression to be expanded and - potentially match against many similar patterns.</p> - - <p>Generally, an URL pattern has the form <tt class= - "LITERAL"><domain><port>/<path></tt>, where the - <tt class="LITERAL"><domain></tt>, the <tt class= - "LITERAL"><port></tt> and the <tt class= - "LITERAL"><path></tt> are optional. (This is why the special - <tt class="LITERAL">/</tt> pattern matches all URLs). Note that the - protocol portion of the URL pattern (e.g. <tt class= - "LITERAL">http://</tt>) should <span class= - "emphasis EMPHASIS c2">not</span> be included in the pattern. This is - assumed already!</p> - - <p>The pattern matching syntax is different for the domain and path - parts of the URL. The domain part uses a simple globbing type matching - technique, while the path part uses more flexible <a href= - "http://en.wikipedia.org/wiki/Regular_expressions" target= - "_top"><span class="QUOTE">"Regular Expressions"</span></a> (POSIX - 1003.2).</p> - - <p>The port part of a pattern is a decimal port number preceded by a - colon (<tt class="LITERAL">:</tt>). If the domain part contains a - numerical IPv6 address, it has to be put into angle brackets - (<tt class="LITERAL"><</tt>, <tt class="LITERAL">></tt>).</p> - - <div class="VARIABLELIST"> - <dl> - <dt><tt class="LITERAL">www.example.com/</tt></dt> - - <dd> - <p>is a domain-only pattern and will match any request to - <tt class="LITERAL">www.example.com</tt>, regardless of which - document on that server is requested. So ALL pages in this domain - would be covered by the scope of this action. Note that a simple - <tt class="LITERAL">example.com</tt> is different and would NOT - match.</p> - </dd> - - <dt><tt class="LITERAL">www.example.com</tt></dt> - - <dd> - <p>means exactly the same. For domain-only patterns, the trailing - <tt class="LITERAL">/</tt> may be omitted.</p> - </dd> - - <dt><tt class="LITERAL">www.example.com/index.html</tt></dt> - - <dd> - <p>matches all the documents on <tt class= - "LITERAL">www.example.com</tt> whose name starts with <tt class= - "LITERAL">/index.html</tt>.</p> - </dd> - - <dt><tt class="LITERAL">www.example.com/index.html$</tt></dt> - - <dd> - <p>matches only the single document <tt class= - "LITERAL">/index.html</tt> on <tt class= - "LITERAL">www.example.com</tt>.</p> - </dd> - - <dt><tt class="LITERAL">/index.html$</tt></dt> - - <dd> - <p>matches the document <tt class="LITERAL">/index.html</tt>, - regardless of the domain, i.e. on <span class= - "emphasis EMPHASIS c2">any</span> web server anywhere.</p> - </dd> - - <dt><tt class="LITERAL">/</tt></dt> - - <dd> - <p>Matches any URL because there's no requirement for either the - domain or the path to match anything.</p> - </dd> - - <dt><tt class="LITERAL">:8000/</tt></dt> - - <dd> - <p>Matches any URL pointing to TCP port 8000.</p> - </dd> - - <dt><tt class="LITERAL"><2001:db8::1>/</tt></dt> - - <dd> - <p>Matches any URL with the host address <tt class= - "LITERAL">2001:db8::1</tt>. (Note that the real URL uses plain - brackets, not angle brackets.)</p> - </dd> - - <dt><tt class="LITERAL">index.html</tt></dt> - - <dd> - <p>matches nothing, since it would be interpreted as a domain - name and there is no top-level domain called <tt class= - "LITERAL">.html</tt>. So its a mistake.</p> - </dd> - </dl> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="AEN2998" id="AEN2998">8.4.1. The Domain - Pattern</a></h3> - - <p>The matching of the domain part offers some flexible options: if - the domain starts or ends with a dot, it becomes unanchored at that - end. For example:</p> - - <div class="VARIABLELIST"> - <dl> - <dt><tt class="LITERAL">.example.com</tt></dt> - - <dd> - <p>matches any domain with first-level domain <tt class= - "LITERAL">com</tt> and second-level domain <tt class= - "LITERAL">example</tt>. For example <tt class= - "LITERAL">www.example.com</tt>, <tt class= - "LITERAL">example.com</tt> and <tt class= - "LITERAL">foo.bar.baz.example.com</tt>. Note that it wouldn't - match if the second-level domain was <tt class= - "LITERAL">another-example</tt>.</p> - </dd> - - <dt><tt class="LITERAL">www.</tt></dt> - - <dd> - <p>matches any domain that <span class= - "emphasis EMPHASIS c2">STARTS</span> with <tt class= - "LITERAL">www.</tt> (It also matches the domain <tt class= - "LITERAL">www</tt> but most of the time that doesn't - matter.)</p> - </dd> - - <dt><tt class="LITERAL">.example.</tt></dt> - - <dd> - <p>matches any domain that <span class= - "emphasis EMPHASIS c2">CONTAINS</span> <tt class= - "LITERAL">.example.</tt>. And, by the way, also included would - be any files or documents that exist within that domain since - no path limitations are specified. (Correctly speaking: It - matches any FQDN that contains <tt class="LITERAL">example</tt> - as a domain.) This might be <tt class= - "LITERAL">www.example.com</tt>, <tt class= - "LITERAL">news.example.de</tt>, or <tt class= - "LITERAL">www.example.net/cgi/testing.pl</tt> for instance. All - these cases are matched.</p> - </dd> - </dl> - </div> - - <p>Additionally, there are wild-cards that you can use in the domain - names themselves. These work similarly to shell globbing type - wild-cards: <span class="QUOTE">"*"</span> represents zero or more - arbitrary characters (this is equivalent to the <a href= - "http://en.wikipedia.org/wiki/Regular_expressions" target= - "_top"><span class="QUOTE">"Regular Expression"</span></a> based - syntax of <span class="QUOTE">".*"</span>), <span class= - "QUOTE">"?"</span> represents any single character (this is - equivalent to the regular expression syntax of a simple <span class= - "QUOTE">"."</span>), and you can define <span class= - "QUOTE">"character classes"</span> in square brackets which is - similar to the same regular expression technique. All of this can be - freely mixed:</p> - - <div class="VARIABLELIST"> - <dl> - <dt><tt class="LITERAL">ad*.example.com</tt></dt> - - <dd> - <p>matches <span class="QUOTE">"adserver.example.com"</span>, - <span class="QUOTE">"ads.example.com"</span>, etc but not - <span class="QUOTE">"sfads.example.com"</span></p> - </dd> - - <dt><tt class="LITERAL">*ad*.example.com</tt></dt> - - <dd> - <p>matches all of the above, and then some.</p> - </dd> - - <dt><tt class="LITERAL">.?pix.com</tt></dt> - - <dd> - <p>matches <tt class="LITERAL">www.ipix.com</tt>, <tt class= - "LITERAL">pictures.epix.com</tt>, <tt class= - "LITERAL">a.b.c.d.e.upix.com</tt> etc.</p> - </dd> - - <dt><tt class="LITERAL">www[1-9a-ez].example.c*</tt></dt> - - <dd> - <p>matches <tt class="LITERAL">www1.example.com</tt>, - <tt class="LITERAL">www4.example.cc</tt>, <tt class= - "LITERAL">wwwd.example.cy</tt>, <tt class= - "LITERAL">wwwz.example.com</tt> etc., but <span class= - "emphasis EMPHASIS c2">not</span> <tt class= - "LITERAL">wwww.example.com</tt>.</p> - </dd> - </dl> - </div> - - <p>While flexible, this is not the sophistication of full regular - expression based syntax.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="AEN3074" id="AEN3074">8.4.2. The Path - Pattern</a></h3> - - <p><span class="APPLICATION">Privoxy</span> uses <span class= - "QUOTE">"modern"</span> POSIX 1003.2 <a href= - "http://en.wikipedia.org/wiki/Regular_expressions" target= - "_top"><span class="QUOTE">"Regular Expressions"</span></a> for - matching the path portion (after the slash), and is thus more - flexible.</p> - - <p>There is an <a href="appendix.html#REGEX">Appendix</a> with a - brief quick-start into regular expressions, you also might want to - have a look at your operating system's documentation on regular - expressions (try <tt class="LITERAL">man re_format</tt>).</p> - - <p>Note that the path pattern is automatically left-anchored at the - <span class="QUOTE">"/"</span>, i.e. it matches as if it would start - with a <span class="QUOTE">"^"</span> (regular expression speak for - the beginning of a line).</p> - - <p>Please also note that matching in the path is <span class= - "emphasis EMPHASIS c2">CASE INSENSITIVE</span> by default, but you - can switch to case sensitive at any point in the pattern by using the - <span class="QUOTE">"(?-i)"</span> switch: <tt class= - "LITERAL">www.example.com/(?-i)PaTtErN.*</tt> will match only - documents whose path starts with <tt class="LITERAL">PaTtErN</tt> in - <span class="emphasis EMPHASIS c2">exactly</span> this - capitalization.</p> - - <div class="VARIABLELIST"> - <dl> - <dt><tt class="LITERAL">.example.com/.*</tt></dt> - - <dd> - <p>Is equivalent to just <span class= - "QUOTE">".example.com"</span>, since any documents within that - domain are matched with or without the <span class= - "QUOTE">".*"</span> regular expression. This is redundant</p> - </dd> - - <dt><tt class="LITERAL">.example.com/.*/index.html$</tt></dt> - - <dd> - <p>Will match any page in the domain of <span class= - "QUOTE">"example.com"</span> that is named <span class= - "QUOTE">"index.html"</span>, and that is part of some path. For - example, it matches <span class= - "QUOTE">"www.example.com/testing/index.html"</span> but NOT - <span class="QUOTE">"www.example.com/index.html"</span> because - the regular expression called for at least two <span class= - "QUOTE">"/'s"</span>, thus the path requirement. It also would - match <span class= - "QUOTE">"www.example.com/testing/index_html"</span>, because of - the special meta-character <span class="QUOTE">"."</span>.</p> - </dd> - - <dt><tt class="LITERAL">.example.com/(.*/)?index.html$</tt></dt> - - <dd> - <p>This regular expression is conditional so it will match any - page named <span class="QUOTE">"index.html"</span> regardless - of path which in this case can have one or more <span class= - "QUOTE">"/'s"</span>. And this one must contain exactly - <span class="QUOTE">".html"</span> (but does not have to end - with that!).</p> - </dd> - - <dt><tt class= - "LITERAL">.example.com/(.*/)(ads|banners?|junk)</tt></dt> - - <dd> - <p>This regular expression will match any path of <span class= - "QUOTE">"example.com"</span> that contains any of the words - <span class="QUOTE">"ads"</span>, <span class= - "QUOTE">"banner"</span>, <span class="QUOTE">"banners"</span> - (because of the <span class="QUOTE">"?"</span>) or <span class= - "QUOTE">"junk"</span>. The path does not have to end in these - words, just contain them.</p> - </dd> - - <dt><tt class= - "LITERAL">.example.com/(.*/)(ads|banners?|junk)/.*.(jpe?g|gif|png)$</tt></dt> - - <dd> - <p>This is very much the same as above, except now it must end - in either <span class="QUOTE">".jpg"</span>, <span class= - "QUOTE">".jpeg"</span>, <span class="QUOTE">".gif"</span> or - <span class="QUOTE">".png"</span>. So this one is limited to - common image formats.</p> - </dd> - </dl> - </div> - - <p>There are many, many good examples to be found in <tt class= - "FILENAME">default.action</tt>, and more tutorials below in <a href= - "appendix.html#REGEX">Appendix on regular expressions</a>.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="TAG-PATTERN" id="TAG-PATTERN">8.4.3. The - Tag Pattern</a></h3> - - <p>Tag patterns are used to change the applying actions based on the - request's tags. Tags can be created with either the <a href= - "actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a> or - the <a href= - "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a> - action.</p> - - <p>Tag patterns have to start with <span class="QUOTE">"TAG:"</span>, - so <span class="APPLICATION">Privoxy</span> can tell them apart from - URL patterns. Everything after the colon including white space, is - interpreted as a regular expression with path pattern syntax, except - that tag patterns aren't left-anchored automatically (<span class= - "APPLICATION">Privoxy</span> doesn't silently add a <span class= - "QUOTE">"^"</span>, you have to do it yourself if you need it).</p> - - <p>To match all requests that are tagged with <span class= - "QUOTE">"foo"</span> your pattern line should be <span class= - "QUOTE">"TAG:^foo$"</span>, <span class="QUOTE">"TAG:foo"</span> - would work as well, but it would also match requests whose tags - contain <span class="QUOTE">"foo"</span> somewhere. <span class= - "QUOTE">"TAG: foo"</span> wouldn't work as it requires white - space.</p> - - <p>Sections can contain URL and tag patterns at the same time, but - tag patterns are checked after the URL patterns and thus always - overrule them, even if they are located before the URL patterns.</p> - - <p>Once a new tag is added, Privoxy checks right away if it's matched - by one of the tag patterns and updates the action settings - accordingly. As a result tags can be used to activate other tagger - actions, as long as these other taggers look for headers that haven't - already be parsed.</p> - - <p>For example you could tag client requests which use the <tt class= - "LITERAL">POST</tt> method, then use this tag to activate another - tagger that adds a tag if cookies are sent, and then use a block - action based on the cookie tag. This allows the outcome of one - action, to be input into a subsequent action. However if you'd - reverse the position of the described taggers, and activated the - method tagger based on the cookie tagger, no method tags would be - created. The method tagger would look for the request line, but at - the time the cookie tag is created, the request line has already been - parsed.</p> - - <p>While this is a limitation you should be aware of, this kind of - indirection is seldom needed anyway and even the example doesn't make - too much sense.</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="ACTIONS" id="ACTIONS">8.5. Actions</a></h2> - - <p>All actions are disabled by default, until they are explicitly - enabled somewhere in an actions file. Actions are turned on if preceded - with a <span class="QUOTE">"+"</span>, and turned off if preceded with - a <span class="QUOTE">"-"</span>. So a <tt class="LITERAL">+action</tt> - means <span class="QUOTE">"do that action"</span>, e.g. <tt class= - "LITERAL">+block</tt> means <span class="QUOTE">"please block URLs that - match the following patterns"</span>, and <tt class= - "LITERAL">-block</tt> means <span class="QUOTE">"don't block URLs that - match the following patterns, even if <tt class="LITERAL">+block</tt> - previously applied."</span></p> - - <p>Again, actions are invoked by placing them on a line, enclosed in - curly braces and separated by whitespace, like in <tt class= - "LITERAL">{+some-action -some-other-action{some-parameter}}</tt>, - followed by a list of URL patterns, one per line, to which they apply. - Together, the actions line and the following pattern lines make up a - section of the actions file.</p> - - <p>Actions fall into three categories:</p> - - <ul> - <li> - <p>Boolean, i.e the action can only be <span class= - "QUOTE">"enabled"</span> or <span class="QUOTE">"disabled"</span>. - Syntax:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - +<tt class="REPLACEABLE c5">name</tt> # enable action <tt class= -"REPLACEABLE c5">name</tt> - -<tt class="REPLACEABLE c5">name</tt> # disable action <tt class= -"REPLACEABLE c5">name</tt> -</pre> - </td> - </tr> - </table> - - <p>Example: <tt class="LITERAL">+handle-as-image</tt></p> - </li> - - <li> - <p>Parameterized, where some value is required in order to enable - this type of action. Syntax:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - +<tt class="REPLACEABLE c5">name</tt>{<tt class= -"REPLACEABLE c5">param</tt>} # enable action and set parameter to <tt class= -"REPLACEABLE c5">param</tt>, + .example.com/images/ads/</PRE +></TD +></TR +></TABLE +> + </P +><P +> You can trace this process for URL patterns and any given URL by visiting <A +HREF="http://config.privoxy.org/show-url-info" +TARGET="_top" +>http://config.privoxy.org/show-url-info</A +>.</P +><P +> Examples and more detail on this is provided in the Appendix, <A +HREF="appendix.html#ACTIONSANAT" +> Troubleshooting: Anatomy of an Action</A +> section.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AF-PATTERNS" +>8.4. Patterns</A +></H2 +><P +> + As mentioned, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> uses <SPAN +CLASS="QUOTE" +>"patterns"</SPAN +> + to determine what <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>actions</I +></SPAN +> might apply to which sites and + pages your browser attempts to access. These <SPAN +CLASS="QUOTE" +>"patterns"</SPAN +> use wild + card type <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>pattern</I +></SPAN +> matching to achieve a high degree of + flexibility. This allows one expression to be expanded and potentially match + against many similar patterns.</P +><P +> Generally, an URL pattern has the form + <TT +CLASS="LITERAL" +><domain>/<path></TT +>, where both the + <TT +CLASS="LITERAL" +><domain></TT +> and <TT +CLASS="LITERAL" +><path></TT +> are + optional. (This is why the special <TT +CLASS="LITERAL" +>/</TT +> pattern matches all + URLs). Note that the protocol portion of the URL pattern (e.g. + <TT +CLASS="LITERAL" +>http://</TT +>) should <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not</I +></SPAN +> be included in + the pattern. This is assumed already!</P +><P +> The pattern matching syntax is different for the domain and path parts of + the URL. The domain part uses a simple globbing type matching technique, + while the path part uses more flexible + <A +HREF="http://en.wikipedia.org/wiki/Regular_expressions" +TARGET="_top" +><SPAN +CLASS="QUOTE" +>"Regular + Expressions"</SPAN +></A +> (POSIX 1003.2).</P +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +><TT +CLASS="LITERAL" +>www.example.com/</TT +></DT +><DD +><P +> is a domain-only pattern and will match any request to <TT +CLASS="LITERAL" +>www.example.com</TT +>, + regardless of which document on that server is requested. So ALL pages in + this domain would be covered by the scope of this action. Note that a + simple <TT +CLASS="LITERAL" +>example.com</TT +> is different and would NOT match. + </P +></DD +><DT +><TT +CLASS="LITERAL" +>www.example.com</TT +></DT +><DD +><P +> means exactly the same. For domain-only patterns, the trailing <TT +CLASS="LITERAL" +>/</TT +> may + be omitted. + </P +></DD +><DT +><TT +CLASS="LITERAL" +>www.example.com/index.html</TT +></DT +><DD +><P +> matches all the documents on <TT +CLASS="LITERAL" +>www.example.com</TT +> + whose name starts with <TT +CLASS="LITERAL" +>/index.html</TT +>. + </P +></DD +><DT +><TT +CLASS="LITERAL" +>www.example.com/index.html$</TT +></DT +><DD +><P +> matches only the single document <TT +CLASS="LITERAL" +>/index.html</TT +> + on <TT +CLASS="LITERAL" +>www.example.com</TT +>. + </P +></DD +><DT +><TT +CLASS="LITERAL" +>/index.html$</TT +></DT +><DD +><P +> matches the document <TT +CLASS="LITERAL" +>/index.html</TT +>, regardless of the domain, + i.e. on <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>any</I +></SPAN +> web server anywhere. + </P +></DD +><DT +><TT +CLASS="LITERAL" +>index.html</TT +></DT +><DD +><P +> matches nothing, since it would be interpreted as a domain name and + there is no top-level domain called <TT +CLASS="LITERAL" +>.html</TT +>. So its + a mistake. + </P +></DD +></DL +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="AEN2386" +>8.4.1. The Domain Pattern</A +></H3 +><P +> The matching of the domain part offers some flexible options: if the + domain starts or ends with a dot, it becomes unanchored at that end. + For example:</P +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +><TT +CLASS="LITERAL" +>.example.com</TT +></DT +><DD +><P +> matches any domain with first-level domain <TT +CLASS="LITERAL" +>com</TT +> + and second-level domain <TT +CLASS="LITERAL" +>example</TT +>. + For example <TT +CLASS="LITERAL" +>www.example.com</TT +>, + <TT +CLASS="LITERAL" +>example.com</TT +> and <TT +CLASS="LITERAL" +>foo.bar.baz.example.com</TT +>. + Note that it wouldn't match if the second-level domain was <TT +CLASS="LITERAL" +>another-example</TT +>. + </P +></DD +><DT +><TT +CLASS="LITERAL" +>www.</TT +></DT +><DD +><P +> matches any domain that <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>STARTS</I +></SPAN +> with + <TT +CLASS="LITERAL" +>www.</TT +> (It also matches the domain + <TT +CLASS="LITERAL" +>www</TT +> but most of the time that doesn't matter.) + </P +></DD +><DT +><TT +CLASS="LITERAL" +>.example.</TT +></DT +><DD +><P +> matches any domain that <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>CONTAINS</I +></SPAN +> <TT +CLASS="LITERAL" +>.example.</TT +>. + And, by the way, also included would be any files or documents that exist + within that domain since no path limitations are specified. (Correctly + speaking: It matches any FQDN that contains <TT +CLASS="LITERAL" +>example</TT +> as + a domain.) This might be <TT +CLASS="LITERAL" +>www.example.com</TT +>, + <TT +CLASS="LITERAL" +>news.example.de</TT +>, or + <TT +CLASS="LITERAL" +>www.example.net/cgi/testing.pl</TT +> for instance. All these + cases are matched. + </P +></DD +></DL +></DIV +><P +> Additionally, there are wild-cards that you can use in the domain names + themselves. These work similarly to shell globbing type wild-cards: + <SPAN +CLASS="QUOTE" +>"*"</SPAN +> represents zero or more arbitrary characters (this is + equivalent to the + <A +HREF="http://en.wikipedia.org/wiki/Regular_expressions" +TARGET="_top" +><SPAN +CLASS="QUOTE" +>"Regular + Expression"</SPAN +></A +> based syntax of <SPAN +CLASS="QUOTE" +>".*"</SPAN +>), + <SPAN +CLASS="QUOTE" +>"?"</SPAN +> represents any single character (this is equivalent to the + regular expression syntax of a simple <SPAN +CLASS="QUOTE" +>"."</SPAN +>), and you can define + <SPAN +CLASS="QUOTE" +>"character classes"</SPAN +> in square brackets which is similar to + the same regular expression technique. All of this can be freely mixed:</P +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +><TT +CLASS="LITERAL" +>ad*.example.com</TT +></DT +><DD +><P +> matches <SPAN +CLASS="QUOTE" +>"adserver.example.com"</SPAN +>, + <SPAN +CLASS="QUOTE" +>"ads.example.com"</SPAN +>, etc but not <SPAN +CLASS="QUOTE" +>"sfads.example.com"</SPAN +> + </P +></DD +><DT +><TT +CLASS="LITERAL" +>*ad*.example.com</TT +></DT +><DD +><P +> matches all of the above, and then some. + </P +></DD +><DT +><TT +CLASS="LITERAL" +>.?pix.com</TT +></DT +><DD +><P +> matches <TT +CLASS="LITERAL" +>www.ipix.com</TT +>, + <TT +CLASS="LITERAL" +>pictures.epix.com</TT +>, <TT +CLASS="LITERAL" +>a.b.c.d.e.upix.com</TT +> etc. + </P +></DD +><DT +><TT +CLASS="LITERAL" +>www[1-9a-ez].example.c*</TT +></DT +><DD +><P +> matches <TT +CLASS="LITERAL" +>www1.example.com</TT +>, + <TT +CLASS="LITERAL" +>www4.example.cc</TT +>, <TT +CLASS="LITERAL" +>wwwd.example.cy</TT +>, + <TT +CLASS="LITERAL" +>wwwz.example.com</TT +> etc., but <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not</I +></SPAN +> + <TT +CLASS="LITERAL" +>wwww.example.com</TT +>. + </P +></DD +></DL +></DIV +><P +> While flexible, this is not the sophistication of full regular expression based syntax.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="AEN2462" +>8.4.2. The Path Pattern</A +></H3 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> uses <SPAN +CLASS="QUOTE" +>"modern"</SPAN +> POSIX 1003.2 + <A +HREF="http://en.wikipedia.org/wiki/Regular_expressions" +TARGET="_top" +><SPAN +CLASS="QUOTE" +>"Regular + Expressions"</SPAN +></A +> for matching the path portion (after the slash), + and is thus more flexible.</P +><P +> There is an <A +HREF="appendix.html#REGEX" +>Appendix</A +> with a brief quick-start into regular + expressions, you also might want to have a look at your operating system's documentation + on regular expressions (try <TT +CLASS="LITERAL" +>man re_format</TT +>).</P +><P +> Note that the path pattern is automatically left-anchored at the <SPAN +CLASS="QUOTE" +>"/"</SPAN +>, + i.e. it matches as if it would start with a <SPAN +CLASS="QUOTE" +>"^"</SPAN +> (regular expression speak + for the beginning of a line).</P +><P +> Please also note that matching in the path is <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>CASE INSENSITIVE</I +></SPAN +> + by default, but you can switch to case sensitive at any point in the pattern by using the + <SPAN +CLASS="QUOTE" +>"(?-i)"</SPAN +> switch: <TT +CLASS="LITERAL" +>www.example.com/(?-i)PaTtErN.*</TT +> will match + only documents whose path starts with <TT +CLASS="LITERAL" +>PaTtErN</TT +> in + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>exactly</I +></SPAN +> this capitalization.</P +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +><TT +CLASS="LITERAL" +>.example.com/.*</TT +></DT +><DD +><P +> Is equivalent to just <SPAN +CLASS="QUOTE" +>".example.com"</SPAN +>, since any documents + within that domain are matched with or without the <SPAN +CLASS="QUOTE" +>".*"</SPAN +> + regular expression. This is redundant + </P +></DD +><DT +><TT +CLASS="LITERAL" +>.example.com/.*/index.html$</TT +></DT +><DD +><P +> Will match any page in the domain of <SPAN +CLASS="QUOTE" +>"example.com"</SPAN +> that is + named <SPAN +CLASS="QUOTE" +>"index.html"</SPAN +>, and that is part of some path. For + example, it matches <SPAN +CLASS="QUOTE" +>"www.example.com/testing/index.html"</SPAN +> but + NOT <SPAN +CLASS="QUOTE" +>"www.example.com/index.html"</SPAN +> because the regular + expression called for at least two <SPAN +CLASS="QUOTE" +>"/'s"</SPAN +>, thus the path + requirement. It also would match + <SPAN +CLASS="QUOTE" +>"www.example.com/testing/index_html"</SPAN +>, because of the + special meta-character <SPAN +CLASS="QUOTE" +>"."</SPAN +>. + </P +></DD +><DT +><TT +CLASS="LITERAL" +>.example.com/(.*/)?index.html$</TT +></DT +><DD +><P +> This regular expression is conditional so it will match any page + named <SPAN +CLASS="QUOTE" +>"index.html"</SPAN +> regardless of path which in this case can + have one or more <SPAN +CLASS="QUOTE" +>"/'s"</SPAN +>. And this one must contain exactly + <SPAN +CLASS="QUOTE" +>".html"</SPAN +> (but does not have to end with that!). + </P +></DD +><DT +><TT +CLASS="LITERAL" +>.example.com/(.*/)(ads|banners?|junk)</TT +></DT +><DD +><P +> This regular expression will match any path of <SPAN +CLASS="QUOTE" +>"example.com"</SPAN +> + that contains any of the words <SPAN +CLASS="QUOTE" +>"ads"</SPAN +>, <SPAN +CLASS="QUOTE" +>"banner"</SPAN +>, + <SPAN +CLASS="QUOTE" +>"banners"</SPAN +> (because of the <SPAN +CLASS="QUOTE" +>"?"</SPAN +>) or <SPAN +CLASS="QUOTE" +>"junk"</SPAN +>. + The path does not have to end in these words, just contain them. + </P +></DD +><DT +><TT +CLASS="LITERAL" +>.example.com/(.*/)(ads|banners?|junk)/.*.(jpe?g|gif|png)$</TT +></DT +><DD +><P +> This is very much the same as above, except now it must end in either + <SPAN +CLASS="QUOTE" +>".jpg"</SPAN +>, <SPAN +CLASS="QUOTE" +>".jpeg"</SPAN +>, <SPAN +CLASS="QUOTE" +>".gif"</SPAN +> or <SPAN +CLASS="QUOTE" +>".png"</SPAN +>. So this + one is limited to common image formats. + </P +></DD +></DL +></DIV +><P +> There are many, many good examples to be found in <TT +CLASS="FILENAME" +>default.action</TT +>, + and more tutorials below in <A +HREF="appendix.html#REGEX" +>Appendix on regular expressions</A +>.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="TAG-PATTERN" +>8.4.3. The Tag Pattern</A +></H3 +><P +> Tag patterns are used to change the applying actions based on the + request's tags. Tags can be created with either the + <A +HREF="actions-file.html#CLIENT-HEADER-TAGGER" +>client-header-tagger</A +> + or the <A +HREF="actions-file.html#SERVER-HEADER-TAGGER" +>server-header-tagger</A +> action.</P +><P +> Tag patterns have to start with <SPAN +CLASS="QUOTE" +>"TAG:"</SPAN +>, so <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + can tell them apart from URL patterns. Everything after the colon + including white space, is interpreted as a regular expression with + path pattern syntax, except that tag patterns aren't left-anchored + automatically (<SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> doesn't silently add a <SPAN +CLASS="QUOTE" +>"^"</SPAN +>, + you have to do it yourself if you need it).</P +><P +> To match all requests that are tagged with <SPAN +CLASS="QUOTE" +>"foo"</SPAN +> + your pattern line should be <SPAN +CLASS="QUOTE" +>"TAG:^foo$"</SPAN +>, + <SPAN +CLASS="QUOTE" +>"TAG:foo"</SPAN +> would work as well, but it would also + match requests whose tags contain <SPAN +CLASS="QUOTE" +>"foo"</SPAN +> somewhere. + <SPAN +CLASS="QUOTE" +>"TAG: foo"</SPAN +> wouldn't work as it requires white space.</P +><P +> Sections can contain URL and tag patterns at the same time, + but tag patterns are checked after the URL patterns and thus + always overrule them, even if they are located before the URL patterns.</P +><P +> Once a new tag is added, Privoxy checks right away if it's matched by one + of the tag patterns and updates the action settings accordingly. As a result + tags can be used to activate other tagger actions, as long as these other + taggers look for headers that haven't already be parsed.</P +><P +> For example you could tag client requests which use the + <TT +CLASS="LITERAL" +>POST</TT +> method, + then use this tag to activate another tagger that adds a tag if cookies + are sent, and then use a block action based on the cookie tag. This allows + the outcome of one action, to be input into a subsequent action. However if + you'd reverse the position of the described taggers, and activated the + method tagger based on the cookie tagger, no method tags would be created. + The method tagger would look for the request line, but at the time + the cookie tag is created, the request line has already been parsed.</P +><P +> While this is a limitation you should be aware of, this kind of + indirection is seldom needed anyway and even the example doesn't + make too much sense.</P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="ACTIONS" +>8.5. Actions</A +></H2 +><P +> All actions are disabled by default, until they are explicitly enabled + somewhere in an actions file. Actions are turned on if preceded with a + <SPAN +CLASS="QUOTE" +>"+"</SPAN +>, and turned off if preceded with a <SPAN +CLASS="QUOTE" +>"-"</SPAN +>. So a + <TT +CLASS="LITERAL" +>+action</TT +> means <SPAN +CLASS="QUOTE" +>"do that action"</SPAN +>, e.g. + <TT +CLASS="LITERAL" +>+block</TT +> means <SPAN +CLASS="QUOTE" +>"please block URLs that match the + following patterns"</SPAN +>, and <TT +CLASS="LITERAL" +>-block</TT +> means <SPAN +CLASS="QUOTE" +>"don't + block URLs that match the following patterns, even if <TT +CLASS="LITERAL" +>+block</TT +> + previously applied."</SPAN +> </P +><P +> + Again, actions are invoked by placing them on a line, enclosed in curly braces and + separated by whitespace, like in + <TT +CLASS="LITERAL" +>{+some-action -some-other-action{some-parameter}}</TT +>, + followed by a list of URL patterns, one per line, to which they apply. + Together, the actions line and the following pattern lines make up a section + of the actions file. </P +><P +> + Actions fall into three categories:</P +><P +> <P +></P +><UL +><LI +><P +> + Boolean, i.e the action can only be <SPAN +CLASS="QUOTE" +>"enabled"</SPAN +> or + <SPAN +CLASS="QUOTE" +>"disabled"</SPAN +>. Syntax: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> +<TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +> # enable action <TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +> + -<TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +> # disable action <TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +></PRE +></TD +></TR +></TABLE +> + </P +><P +> + Example: <TT +CLASS="LITERAL" +>+handle-as-image</TT +> + </P +></LI +><LI +><P +> + Parameterized, where some value is required in order to enable this type of action. + Syntax: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> +<TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +>{<TT +CLASS="REPLACEABLE" +><I +>param</I +></TT +>} # enable action and set parameter to <TT +CLASS="REPLACEABLE" +><I +>param</I +></TT +>, # overwriting parameter from previous match if necessary - -<tt class= -"REPLACEABLE c5">name</tt> # disable action. The parameter can be omitted -</pre> - </td> - </tr> - </table> - - <p>Note that if the URL matches multiple positive forms of a - parameterized action, the last match wins, i.e. the params from - earlier matches are simply ignored.</p> - - <p>Example: <tt class="LITERAL">+hide-user-agent{Mozilla/5.0 (X11; - U; FreeBSD i386; en-US; rv:1.8.1.4) Gecko/20070602 - Firefox/2.0.0.4}</tt></p> - </li> - - <li> - <p>Multi-value. These look exactly like parameterized actions, but - they behave differently: If the action applies multiple times to - the same URL, but with different parameters, <span class= - "emphasis EMPHASIS c2">all</span> the parameters from <span class= - "emphasis EMPHASIS c2">all</span> matches are remembered. This is - used for actions that can be executed for the same request - repeatedly, like adding multiple headers, or filtering through - multiple filters. Syntax:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - +<tt class="REPLACEABLE c5">name</tt>{<tt class= -"REPLACEABLE c5">param</tt>} # enable action and add <tt class= -"REPLACEABLE c5">param</tt> to the list of parameters - -<tt class="REPLACEABLE c5">name</tt>{<tt class= -"REPLACEABLE c5">param</tt>} # remove the parameter <tt class= -"REPLACEABLE c5">param</tt> from the list of parameters + -<TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +> # disable action. The parameter can be omitted</PRE +></TD +></TR +></TABLE +> + </P +><P +> Note that if the URL matches multiple positive forms of a parameterized action, + the last match wins, i.e. the params from earlier matches are simply ignored. + </P +><P +> + Example: <TT +CLASS="LITERAL" +>+hide-user-agent{Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.8.1.4) Gecko/20070602 Firefox/2.0.0.4}</TT +> + </P +></LI +><LI +><P +> + Multi-value. These look exactly like parameterized actions, + but they behave differently: If the action applies multiple times to the + same URL, but with different parameters, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> the parameters + from <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> matches are remembered. This is used for actions + that can be executed for the same request repeatedly, like adding multiple + headers, or filtering through multiple filters. Syntax: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> +<TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +>{<TT +CLASS="REPLACEABLE" +><I +>param</I +></TT +>} # enable action and add <TT +CLASS="REPLACEABLE" +><I +>param</I +></TT +> to the list of parameters + -<TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +>{<TT +CLASS="REPLACEABLE" +><I +>param</I +></TT +>} # remove the parameter <TT +CLASS="REPLACEABLE" +><I +>param</I +></TT +> from the list of parameters # If it was the last one left, disable the action. - <tt class= -"REPLACEABLE c5">-name</tt> # disable this action completely and remove all parameters from the list -</pre> - </td> - </tr> - </table> - - <p>Examples: <tt class="LITERAL">+add-header{X-Fun-Header: Some - text}</tt> and <tt class= - "LITERAL">+filter{html-annoyances}</tt></p> - </li> - </ul> - - <p>If nothing is specified in any actions file, no <span class= - "QUOTE">"actions"</span> are taken. So in this case <span class= - "APPLICATION">Privoxy</span> would just be a normal, non-blocking, - non-filtering proxy. You must specifically enable the privacy and - blocking features you need (although the provided default actions files - will give a good starting point).</p> - - <p>Later defined action sections always over-ride earlier ones of the - same type. So exceptions to any rules you make, should come in the - latter part of the file (or in a file that is processed later when - using multiple actions files such as <tt class= - "FILENAME">user.action</tt>). For multi-valued actions, the actions are - applied in the order they are specified. Actions files are processed in - the order they are defined in <tt class="FILENAME">config</tt> (the - default installation has three actions files). It also quite possible - for any given URL to match more than one <span class= - "QUOTE">"pattern"</span> (because of wildcards and regular - expressions), and thus to trigger more than one set of actions! Last - match wins.</p> - - <p>The list of valid <span class="APPLICATION">Privoxy</span> actions - are:</p> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ADD-HEADER" id="ADD-HEADER">8.5.1. - add-header</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Confuse log analysis, custom applications</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Sends a user defined HTTP header to the web server.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Multi-value.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>Any string value is possible. Validity of the defined HTTP - headers is not checked. It is recommended that you use the - <span class="QUOTE">"<tt class="LITERAL">X-</tt>"</span> prefix - for custom headers.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This action may be specified multiple times, in order to - define multiple headers. This is rarely needed for the typical - user. If you don't know what <span class="QUOTE">"HTTP - headers"</span> are, you definitely don't need to worry about - this one.</p> - - <p>Headers added by this action are not modified by other - actions.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+add-header{X-User-Tracking: sucks} -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="BLOCK" id="BLOCK">8.5.2. block</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Block ads or other unwanted content</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Requests for URLs to which this action applies are blocked, - i.e. the requests are trapped by <span class= - "APPLICATION">Privoxy</span> and the requested URL is never - retrieved, but is answered locally with a substitute page or - image, as determined by the <tt class="LITERAL"><a href= - "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt>, - <tt class="LITERAL"><a href= - "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></tt>, - and <tt class="LITERAL"><a href= - "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></tt> - actions.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>A block reason that should be given to the user.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p><span class="APPLICATION">Privoxy</span> sends a special - <span class="QUOTE">"BLOCKED"</span> page for requests to - blocked pages. This page contains the block reason given as - parameter, a link to find out why the block action applies, and - a click-through to the blocked content (the latter only if the - force feature is available and enabled).</p> - - <p>A very important exception occurs if <span class= - "emphasis EMPHASIS c2">both</span> <tt class= - "LITERAL">block</tt> and <tt class="LITERAL"><a href= - "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt>, - apply to the same request: it will then be replaced by an - image. If <tt class="LITERAL"><a href= - "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></tt> - (see below) also applies, the type of image will be determined - by its parameter, if not, the standard checkerboard pattern is - sent.</p> - - <p>It is important to understand this process, in order to - understand how <span class="APPLICATION">Privoxy</span> deals - with ads and other unwanted content. Blocking is a core - feature, and one upon which various other features depend.</p> - - <p>The <tt class="LITERAL"><a href= - "actions-file.html#FILTER">filter</a></tt> action can perform a - very similar task, by <span class="QUOTE">"blocking"</span> - banner images and other content through rewriting the relevant - URLs in the document's HTML source, so they don't get requested - in the first place. Note that this is a totally different - technique, and it's easy to confuse the two.</p> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -{+block{No nasty stuff for you.}} + <TT +CLASS="REPLACEABLE" +><I +>-name</I +></TT +> # disable this action completely and remove all parameters from the list</PRE +></TD +></TR +></TABLE +> + </P +><P +> + Examples: <TT +CLASS="LITERAL" +>+add-header{X-Fun-Header: Some text}</TT +> and + <TT +CLASS="LITERAL" +>+filter{html-annoyances}</TT +> + </P +></LI +></UL +></P +><P +> If nothing is specified in any actions file, no <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> are + taken. So in this case <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> would just be a + normal, non-blocking, non-filtering proxy. You must specifically enable the + privacy and blocking features you need (although the provided default actions + files will give a good starting point).</P +><P +> Later defined action sections always over-ride earlier ones of the same type. + So exceptions to any rules you make, should come in the latter part of the file (or + in a file that is processed later when using multiple actions files such + as <TT +CLASS="FILENAME" +>user.action</TT +>). For multi-valued actions, the actions + are applied in the order they are specified. Actions files are processed in + the order they are defined in <TT +CLASS="FILENAME" +>config</TT +> (the default + installation has three actions files). It also quite possible for any given + URL to match more than one <SPAN +CLASS="QUOTE" +>"pattern"</SPAN +> (because of wildcards and + regular expressions), and thus to trigger more than one set of actions! Last + match wins.</P +><P +> The list of valid <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> actions are:</P +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ADD-HEADER" +>8.5.1. add-header</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Confuse log analysis, custom applications</P +></DD +><DT +>Effect:</DT +><DD +><P +> Sends a user defined HTTP header to the web server. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Multi-value.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> Any string value is possible. Validity of the defined HTTP headers is not checked. + It is recommended that you use the <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +>X-</TT +>"</SPAN +> prefix + for custom headers. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> This action may be specified multiple times, in order to define multiple + headers. This is rarely needed for the typical user. If you don't know what + <SPAN +CLASS="QUOTE" +>"HTTP headers"</SPAN +> are, you definitely don't need to worry about this + one. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+add-header{X-User-Tracking: sucks}</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="BLOCK" +>8.5.2. block</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Block ads or other unwanted content</P +></DD +><DT +>Effect:</DT +><DD +><P +> Requests for URLs to which this action applies are blocked, i.e. the + requests are trapped by <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and the requested URL is never retrieved, + but is answered locally with a substitute page or image, as determined by + the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +></TT +>, + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker</A +></TT +>, and + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT" +>handle-as-empty-document</A +></TT +> actions. + + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +>A block reason that should be given to the user.</P +></DD +><DT +>Notes:</DT +><DD +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> sends a special <SPAN +CLASS="QUOTE" +>"BLOCKED"</SPAN +> page + for requests to blocked pages. This page contains the block reason given as + parameter, a link to find out why the block action applies, and a click-through + to the blocked content (the latter only if the force feature is available and + enabled). + </P +><P +> + A very important exception occurs if <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>both</I +></SPAN +> + <TT +CLASS="LITERAL" +>block</TT +> and <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +></TT +>, + apply to the same request: it will then be replaced by an image. If + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker</A +></TT +> + (see below) also applies, the type of image will be determined by its parameter, + if not, the standard checkerboard pattern is sent. + </P +><P +> It is important to understand this process, in order + to understand how <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> deals with + ads and other unwanted content. Blocking is a core feature, and one + upon which various other features depend. + </P +><P +> The <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FILTER" +>filter</A +></TT +> + action can perform a very similar task, by <SPAN +CLASS="QUOTE" +>"blocking"</SPAN +> + banner images and other content through rewriting the relevant URLs in the + document's HTML source, so they don't get requested in the first place. + Note that this is a totally different technique, and it's easy to confuse the two. + </P +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{+block{No nasty stuff for you.}} # Block and replace with "blocked" page .nasty-stuff.example.com
-{+block{Doubleclick banners.} +handle-as-image} +{+block{Doubleclick banners.} +handle-as-image} # Block and replace with image .ad.doubleclick.net .ads.r.us/banners/
-{+block{Layered ads.} +handle-as-empty-document} +{+block{Layered ads.} +handle-as-empty-document} # Block and then ignore - adserver.example.net/.*.js$ -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CHANGE-X-FORWARDED-FOR" id= - "CHANGE-X-FORWARDED-FOR">8.5.3. change-x-forwarded-for</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Improve privacy by not forwarding the source of the request - in the HTTP headers.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes the <span class="QUOTE">"X-Forwarded-For:"</span> - HTTP header from the client request, or adds a new one.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <ul> - <li> - <p><span class="QUOTE">"block"</span> to delete the - header.</p> - </li> - - <li> - <p><span class="QUOTE">"add"</span> to create the header - (or append the client's IP address to an already existing - one).</p> - </li> - </ul> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>It is safe and recommended to use <tt class= - "LITERAL">block</tt>.</p> - - <p>Forwarding the source address of the request may make sense - in some multi-user setups but is also a privacy risk.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+change-x-forwarded-for{block} -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CLIENT-HEADER-FILTER" id= - "CLIENT-HEADER-FILTER">8.5.4. client-header-filter</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Rewrite or remove single client headers.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>All client headers to which this action applies are filtered - on-the-fly through the specified regular expression based - substitutions.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>The name of a client-header filter, as defined in one of the - <a href="filter-file.html">filter files</a>.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Client-header filters are applied to each header on its own, - not to all at once. This makes it easier to diagnose problems, - but on the downside you can't write filters that only change - header x if header y's value is z. You can do that by using - tags though.</p> - - <p>Client-header filters are executed after the other header - actions have finished and use their output as input.</p> - - <p>If the request URL gets changed, <span class= - "APPLICATION">Privoxy</span> will detect that and use the new - one. This can be used to rewrite the request destination behind - the client's back, for example to specify a Tor exit relay for - certain requests.</p> - - <p>Please refer to the <a href="filter-file.html">filter file - chapter</a> to learn which client-header filters are available - by default, and how to create your own.</p> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Hide Tor exit notation in Host and Referer Headers + adserver.example.net/.*.js$</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="CHANGE-X-FORWARDED-FOR" +>8.5.3. change-x-forwarded-for</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Improve privacy by not forwarding the source of the request in the HTTP headers.</P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes the <SPAN +CLASS="QUOTE" +>"X-Forwarded-For:"</SPAN +> HTTP header from the client request, + or adds a new one. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +></P +><UL +><LI +><P +><SPAN +CLASS="QUOTE" +>"block"</SPAN +> to delete the header.</P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"add"</SPAN +> to create the header (or append + the client's IP address to an already existing one). + </P +></LI +></UL +></DD +><DT +>Notes:</DT +><DD +><P +> It is safe and recommended to use <TT +CLASS="LITERAL" +>block</TT +>. + </P +><P +> Forwarding the source address of the request may make + sense in some multi-user setups but is also a privacy risk. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+change-x-forwarded-for{block}</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="CLIENT-HEADER-FILTER" +>8.5.4. client-header-filter</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +> Rewrite or remove single client headers. + </P +></DD +><DT +>Effect:</DT +><DD +><P +> All client headers to which this action applies are filtered on-the-fly through + the specified regular expression based substitutions. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> The name of a client-header filter, as defined in one of the + <A +HREF="filter-file.html" +>filter files</A +>. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Client-header filters are applied to each header on its own, not to + all at once. This makes it easier to diagnose problems, but on the downside + you can't write filters that only change header x if header y's value is z. + You can do that by using tags though. + </P +><P +> Client-header filters are executed after the other header actions have finished + and use their output as input. + </P +><P +> If the request URL gets changed, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will detect that and use the new + one. This can be used to rewrite the request destination behind the client's + back, for example to specify a Tor exit relay for certain requests. + </P +><P +> Please refer to the <A +HREF="filter-file.html" +>filter file chapter</A +> + to learn which client-header filters are available by default, and how to + create your own. + </P +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Hide Tor exit notation in Host and Referer Headers {+client-header-filter{hide-tor-exit-notation}} / - -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CLIENT-HEADER-TAGGER" id= - "CLIENT-HEADER-TAGGER">8.5.5. client-header-tagger</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Block requests based on their headers.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Client headers to which this action applies are filtered - on-the-fly through the specified regular expression based - substitutions, the result is used as tag.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>The name of a client-header tagger, as defined in one of the - <a href="filter-file.html">filter files</a>.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Client-header taggers are applied to each header on its own, - and as the header isn't modified, each tagger <span class= - "QUOTE">"sees"</span> the original.</p> - - <p>Client-header taggers are the first actions that are - executed and their tags can be used to control every other - action.</p> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Tag every request with the User-Agent header + </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="CLIENT-HEADER-TAGGER" +>8.5.5. client-header-tagger</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +> Block requests based on their headers. + </P +></DD +><DT +>Effect:</DT +><DD +><P +> Client headers to which this action applies are filtered on-the-fly through + the specified regular expression based substitutions, the result is used as + tag. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> The name of a client-header tagger, as defined in one of the + <A +HREF="filter-file.html" +>filter files</A +>. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Client-header taggers are applied to each header on its own, + and as the header isn't modified, each tagger <SPAN +CLASS="QUOTE" +>"sees"</SPAN +> + the original. + </P +><P +> Client-header taggers are the first actions that are executed + and their tags can be used to control every other action. + </P +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Tag every request with the User-Agent header {+client-header-tagger{user-agent}} /
@@ -1317,2314 +2254,3478 @@ TAG:^User-Agent: RPM APT-HTTP/ TAG:^User-Agent: fetch libfetch/ TAG:^User-Agent: Ubuntu APT-HTTP/ TAG:^User-Agent: MPlayer/ - -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CONTENT-TYPE-OVERWRITE" id= - "CONTENT-TYPE-OVERWRITE">8.5.6. content-type-overwrite</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Stop useless download menus from popping up, or change the - browser's rendering mode</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Replaces the <span class="QUOTE">"Content-Type:"</span> HTTP - server header.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>Any string.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>The <span class="QUOTE">"Content-Type:"</span> HTTP server - header is used by the browser to decide what to do with the - document. The value of this header can cause the browser to - open a download menu instead of displaying the document by - itself, even if the document's format is supported by the - browser.</p> - - <p>The declared content type can also affect which rendering - mode the browser chooses. If XHTML is delivered as <span class= - "QUOTE">"text/html"</span>, many browsers treat it as yet - another broken HTML document. If it is send as <span class= - "QUOTE">"application/xml"</span>, browsers with XHTML support - will only display it, if the syntax is correct.</p> - - <p>If you see a web site that proudly uses XHTML buttons, but - sets <span class="QUOTE">"Content-Type: text/html"</span>, you - can use <span class="APPLICATION">Privoxy</span> to overwrite - it with <span class="QUOTE">"application/xml"</span> and - validate the web master's claim inside your XHTML-supporting - browser. If the syntax is incorrect, the browser will complain - loudly.</p> - - <p>You can also go the opposite direction: if your browser - prints error messages instead of rendering a document falsely - declared as XHTML, you can overwrite the content type with - <span class="QUOTE">"text/html"</span> and have it rendered as - broken HTML document.</p> - - <p>By default <tt class="LITERAL">content-type-overwrite</tt> - only replaces <span class="QUOTE">"Content-Type:"</span> - headers that look like some kind of text. If you want to - overwrite it unconditionally, you have to combine it with - <tt class="LITERAL"><a href= - "actions-file.html#FORCE-TEXT-MODE">force-text-mode</a></tt>. - This limitation exists for a reason, think twice before - circumventing it.</p> - - <p>Most of the time it's easier to replace this action with a - custom <tt class="LITERAL"><a href= - "actions-file.html#SERVER-HEADER-FILTER">server-header - filter</a></tt>. It allows you to activate it for every - document of a certain site and it will still only replace the - content types you aimed at.</p> - - <p>Of course you can apply <tt class= - "LITERAL">content-type-overwrite</tt> to a whole site and then - make URL based exceptions, but it's a lot more work to get the - same precision.</p> - </dd> - - <dt>Example usage (sections):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Check if www.example.net/ really uses valid XHTML -{ +content-type-overwrite{application/xml} } -www.example.net/ + </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="CONTENT-TYPE-OVERWRITE" +>8.5.6. content-type-overwrite</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Stop useless download menus from popping up, or change the browser's rendering mode</P +></DD +><DT +>Effect:</DT +><DD +><P +> Replaces the <SPAN +CLASS="QUOTE" +>"Content-Type:"</SPAN +> HTTP server header. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> Any string. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> The <SPAN +CLASS="QUOTE" +>"Content-Type:"</SPAN +> HTTP server header is used by the + browser to decide what to do with the document. The value of this + header can cause the browser to open a download menu instead of + displaying the document by itself, even if the document's format is + supported by the browser. + </P +><P +> The declared content type can also affect which rendering mode + the browser chooses. If XHTML is delivered as <SPAN +CLASS="QUOTE" +>"text/html"</SPAN +>, + many browsers treat it as yet another broken HTML document. + If it is send as <SPAN +CLASS="QUOTE" +>"application/xml"</SPAN +>, browsers with + XHTML support will only display it, if the syntax is correct. + </P +><P +> If you see a web site that proudly uses XHTML buttons, but sets + <SPAN +CLASS="QUOTE" +>"Content-Type: text/html"</SPAN +>, you can use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + to overwrite it with <SPAN +CLASS="QUOTE" +>"application/xml"</SPAN +> and validate + the web master's claim inside your XHTML-supporting browser. + If the syntax is incorrect, the browser will complain loudly. + </P +><P +> You can also go the opposite direction: if your browser prints + error messages instead of rendering a document falsely declared + as XHTML, you can overwrite the content type with + <SPAN +CLASS="QUOTE" +>"text/html"</SPAN +> and have it rendered as broken HTML document. + </P +><P +> By default <TT +CLASS="LITERAL" +>content-type-overwrite</TT +> only replaces + <SPAN +CLASS="QUOTE" +>"Content-Type:"</SPAN +> headers that look like some kind of text. + If you want to overwrite it unconditionally, you have to combine it with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FORCE-TEXT-MODE" +>force-text-mode</A +></TT +>. + This limitation exists for a reason, think twice before circumventing it. + </P +><P +> Most of the time it's easier to replace this action with a custom + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SERVER-HEADER-FILTER" +>server-header filter</A +></TT +>. + It allows you to activate it for every document of a certain site and it will still + only replace the content types you aimed at. + </P +><P +> Of course you can apply <TT +CLASS="LITERAL" +>content-type-overwrite</TT +> + to a whole site and then make URL based exceptions, but it's a lot + more work to get the same precision. + </P +></DD +><DT +>Example usage (sections):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Check if www.example.net/ really uses valid XHTML +{ +content-type-overwrite{application/xml} } +www.example.net/
# but leave the content type unmodified if the URL looks like a style sheet {-content-type-overwrite} www.example.net/.*.css$ -www.example.net/.*style -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CRUNCH-CLIENT-HEADER" id= - "CRUNCH-CLIENT-HEADER">8.5.7. crunch-client-header</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Remove a client header <span class= - "APPLICATION">Privoxy</span> has no dedicated action for.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes every header sent by the client that contains the - string the user supplied as parameter.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>Any string.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This action allows you to block client headers for which no - dedicated <span class="APPLICATION">Privoxy</span> action - exists. <span class="APPLICATION">Privoxy</span> will remove - every client header that contains the string you supplied as - parameter.</p> - - <p>Regular expressions are <span class= - "emphasis EMPHASIS c2">not supported</span> and you can't use - this action to block different headers in the same request, - unless they contain the same string.</p> - - <p><tt class="LITERAL">crunch-client-header</tt> is only meant - for quick tests. If you have to block several different - headers, or only want to modify parts of them, you should use a - <tt class="LITERAL"><a href= - "actions-file.html#CLIENT-HEADER-FILTER">client-header - filter</a></tt>.</p> - - <div class="WARNING"> - <table class="WARNING" border="1" width="90%"> - <tr> - <td class="c6" align="center">Warning</td> - </tr> - - <tr> - <td align="left"> - <p>Don't block any header without understanding the - consequences.</p> - </td> - </tr> - </table> - </div> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Block the non-existent "Privacy-Violation:" client header -{ +crunch-client-header{Privacy-Violation:} } -/ - -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CRUNCH-IF-NONE-MATCH" id= - "CRUNCH-IF-NONE-MATCH">8.5.8. crunch-if-none-match</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Prevent yet another way to track the user's steps between - sessions.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes the <span class="QUOTE">"If-None-Match:"</span> HTTP - client header.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Boolean.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>N/A</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Removing the <span class="QUOTE">"If-None-Match:"</span> - HTTP client header is useful for filter testing, where you want - to force a real reload instead of getting status code - <span class="QUOTE">"304"</span> which would cause the browser - to use a cached copy of the page.</p> - - <p>It is also useful to make sure the header isn't used as a - cookie replacement (unlikely but possible).</p> - - <p>Blocking the <span class="QUOTE">"If-None-Match:"</span> - header shouldn't cause any caching problems, as long as the - <span class="QUOTE">"If-Modified-Since:"</span> header isn't - blocked or missing as well.</p> - - <p>It is recommended to use this action together with - <tt class="LITERAL"><a href= - "actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a></tt> - and <tt class="LITERAL"><a href= - "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></tt>.</p> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Let the browser revalidate cached documents but don't -# allow the server to use the revalidation headers for user tracking. -{+hide-if-modified-since{-60} \ - +overwrite-last-modified{randomize} \ - +crunch-if-none-match} -/ -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CRUNCH-INCOMING-COOKIES" id= - "CRUNCH-INCOMING-COOKIES">8.5.9. crunch-incoming-cookies</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Prevent the web server from setting HTTP cookies on your - system</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes any <span class="QUOTE">"Set-Cookie:"</span> HTTP - headers from server replies.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Boolean.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>N/A</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This action is only concerned with <span class= - "emphasis EMPHASIS c2">incoming</span> HTTP cookies. For - <span class="emphasis EMPHASIS c2">outgoing</span> HTTP - cookies, use <tt class="LITERAL"><a href= - "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></tt>. - Use <span class="emphasis EMPHASIS c2">both</span> to disable - HTTP cookies completely.</p> - - <p>It makes <span class="emphasis EMPHASIS c2">no sense at - all</span> to use this action in conjunction with the - <tt class="LITERAL"><a href= - "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></tt> - action, since it would prevent the session cookies from being - set. See also <tt class="LITERAL"><a href= - "actions-file.html#FILTER-CONTENT-COOKIES">filter-content-cookies</a></tt>.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+crunch-incoming-cookies -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CRUNCH-SERVER-HEADER" id= - "CRUNCH-SERVER-HEADER">8.5.10. crunch-server-header</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Remove a server header <span class= - "APPLICATION">Privoxy</span> has no dedicated action for.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes every header sent by the server that contains the - string the user supplied as parameter.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>Any string.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This action allows you to block server headers for which no - dedicated <span class="APPLICATION">Privoxy</span> action - exists. <span class="APPLICATION">Privoxy</span> will remove - every server header that contains the string you supplied as - parameter.</p> - - <p>Regular expressions are <span class= - "emphasis EMPHASIS c2">not supported</span> and you can't use - this action to block different headers in the same request, - unless they contain the same string.</p> - - <p><tt class="LITERAL">crunch-server-header</tt> is only meant - for quick tests. If you have to block several different - headers, or only want to modify parts of them, you should use a - custom <tt class="LITERAL"><a href= - "actions-file.html#SERVER-HEADER-FILTER">server-header - filter</a></tt>.</p> - - <div class="WARNING"> - <table class="WARNING" border="1" width="90%"> - <tr> - <td class="c6" align="center">Warning</td> - </tr> - - <tr> - <td align="left"> - <p>Don't block any header without understanding the - consequences.</p> - </td> - </tr> - </table> - </div> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Crunch server headers that try to prevent caching -{ +crunch-server-header{no-cache} } -/ -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CRUNCH-OUTGOING-COOKIES" id= - "CRUNCH-OUTGOING-COOKIES">8.5.11. crunch-outgoing-cookies</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Prevent the web server from reading any HTTP cookies from - your system</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes any <span class="QUOTE">"Cookie:"</span> HTTP - headers from client requests.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Boolean.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>N/A</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This action is only concerned with <span class= - "emphasis EMPHASIS c2">outgoing</span> HTTP cookies. For - <span class="emphasis EMPHASIS c2">incoming</span> HTTP - cookies, use <tt class="LITERAL"><a href= - "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></tt>. - Use <span class="emphasis EMPHASIS c2">both</span> to disable - HTTP cookies completely.</p> - - <p>It makes <span class="emphasis EMPHASIS c2">no sense at - all</span> to use this action in conjunction with the - <tt class="LITERAL"><a href= - "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></tt> - action, since it would prevent the session cookies from being - read.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+crunch-outgoing-cookies -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="DEANIMATE-GIFS" id= - "DEANIMATE-GIFS">8.5.12. deanimate-gifs</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Stop those annoying, distracting animated GIF images.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>De-animate GIF animations, i.e. reduce them to their first - or last image.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p><span class="QUOTE">"last"</span> or <span class= - "QUOTE">"first"</span></p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This will also shrink the images considerably (in bytes, not - pixels!). If the option <span class="QUOTE">"first"</span> is - given, the first frame of the animation is used as the - replacement. If <span class="QUOTE">"last"</span> is given, the - last frame of the animation is used instead, which probably - makes more sense for most banner animations, but also has the - risk of not showing the entire last frame (if it is only a - delta to an earlier frame).</p> - - <p>You can safely use this action with patterns that will also - match non-GIF objects, because no attempt will be made at - anything that doesn't look like a GIF.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+deanimate-gifs{last} -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="DOWNGRADE-HTTP-VERSION" id= - "DOWNGRADE-HTTP-VERSION">8.5.13. downgrade-http-version</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Work around (very rare) problems with HTTP/1.1</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Downgrades HTTP/1.1 client requests and server replies to - HTTP/1.0.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Boolean.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>N/A</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This is a left-over from the time when <span class= - "APPLICATION">Privoxy</span> didn't support important HTTP/1.1 - features well. It is left here for the unlikely case that you - experience HTTP/1.1-related problems with some server out - there.</p> - - <p>Note that enabling this action is only a workaround. It - should not be enabled for sites that work without it. While it - shouldn't break any pages, it has an (usually negative) - performance impact.</p> - - <p>If you come across a site where enabling this action helps, - please report it, so the cause of the problem can be analyzed. - If the problem turns out to be caused by a bug in <span class= - "APPLICATION">Privoxy</span> it should be fixed so the - following release works without the work around.</p> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -{+downgrade-http-version} -problem-host.example.com -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="FAST-REDIRECTS" id= - "FAST-REDIRECTS">8.5.14. fast-redirects</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Fool some click-tracking scripts and speed up indirect - links.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Detects redirection URLs and redirects the browser without - contacting the redirection server first.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <ul> - <li> - <p><span class="QUOTE">"simple-check"</span> to just search - for the string <span class="QUOTE">"http://"</span> to - detect redirection URLs.</p> - </li> - - <li> - <p><span class="QUOTE">"check-decoded-url"</span> to decode - URLs (if necessary) before searching for redirection - URLs.</p> - </li> - </ul> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Many sites, like yahoo.com, don't just link to other sites. - Instead, they will link to some script on their own servers, - giving the destination as a parameter, which will then redirect - you to the final target. URLs resulting from this scheme - typically look like: <span class= - "QUOTE">"http://www.example.org/click-tracker.cgi?target=http%3a//www.example.net/"</span>.</p> - - <p>Sometimes, there are even multiple consecutive redirects - encoded in the URL. These redirections via scripts make your - web browsing 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 asks - the server for one redirect after the other. Plus, it feeds the - advertisers.</p> - - <p>This feature is currently not very smart and is scheduled - for improvement. If it is enabled by default, you will have to - create some exceptions to this action. It can lead to failures - in several ways:</p> - - <p>Not every URLs with other URLs as parameters is evil. Some - sites offer a real service that requires this information to - work. For example a validation service needs to know, which - document to validate. <tt class="LITERAL">fast-redirects</tt> - assumes that every URL parameter that looks like another URL is - a redirection target, and will always redirect to the last one. - Most of the time the assumption is correct, but if it isn't, - the user gets redirected anyway.</p> - - <p>Another failure occurs if the URL contains other parameters - after the URL parameter. The URL: <span class= - "QUOTE">"http://www.example.org/?redirect=http%3a//www.example.net/&foo=bar"</span>. - contains the redirection URL <span class= - "QUOTE">"http://www.example.net/"</span>, followed by another - parameter. <tt class="LITERAL">fast-redirects</tt> doesn't know - that and will cause a redirect to <span class= - "QUOTE">"http://www.example.net/&foo=bar"</span>. Depending - on the target server configuration, the parameter will be - silently ignored or lead to a <span class="QUOTE">"page not - found"</span> error. You can prevent this problem by first - using the <tt class="LITERAL"><a href= - "actions-file.html#REDIRECT">redirect</a></tt> action to remove - the last part of the URL, but it requires a little effort.</p> - - <p>To detect a redirection URL, <tt class= - "LITERAL">fast-redirects</tt> only looks for the string - <span class="QUOTE">"http://"</span>, either in plain text - (invalid but often used) or encoded as <span class= - "QUOTE">"http%3a//"</span>. Some sites use their own URL - encoding scheme, encrypt the address of the target server or - replace it with a database id. In theses cases <tt class= - "LITERAL">fast-redirects</tt> is fooled and the request reaches - the redirection server where it probably gets logged.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - { +fast-redirects{simple-check} } - one.example.com - - { +fast-redirects{check-decoded-url} } - another.example.com/testing -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="FILTER" id="FILTER">8.5.15. - filter</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Get rid of HTML and JavaScript annoyances, banner - advertisements (by size), do fun text replacements, add - personalized effects, etc.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>All instances of text-based type, most notably HTML and - JavaScript, to which this action applies, can be filtered - on-the-fly through the specified regular expression based - substitutions. (Note: as of version 3.0.3 plain text documents - are exempted from filtering, because web servers often use the - <tt class="LITERAL">text/plain</tt> MIME type for all files - whose type they don't know.)</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>The name of a content filter, as defined in the <a href= - "filter-file.html">filter file</a>. Filters can be defined in - one or more files as defined by the <tt class= - "LITERAL"><a href="config.html#FILTERFILE">filterfile</a></tt> - option in the <a href="config.html">config file</a>. <tt class= - "FILENAME">default.filter</tt> is the collection of filters - supplied by the developers. Locally defined filters should go - in their own file, such as <tt class= - "FILENAME">user.filter</tt>.</p> - - <p>When used in its negative form, and without parameters, - <span class="emphasis EMPHASIS c2">all</span> filtering is - completely disabled.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>For your convenience, there are a number of pre-defined - filters available in the distribution filter file that you can - use. See the examples below for a list.</p> - - <p>Filtering requires buffering the page content, which may - appear to slow down page rendering since nothing is displayed - until all content has passed the filters. (The total time until - the page is completely rendered doesn't change much, but it may - be perceived as slower since the page is not incrementally - displayed.) This effect will be more noticeable on slower - connections.</p> - - <p><span class="QUOTE">"Rolling your own"</span> filters - requires a knowledge of <a href= - "http://en.wikipedia.org/wiki/Regular_expressions" target= - "_top"><span class="QUOTE">"Regular Expressions"</span></a> and - <a href="http://en.wikipedia.org/wiki/Html" target= - "_top"><span class="QUOTE">"HTML"</span></a>. This is very - powerful feature, and potentially very intrusive. Filters - should be used with caution, and where an equivalent - <span class="QUOTE">"action"</span> is not available.</p> - - <p>The amount of data that can be filtered is limited to the - <tt class="LITERAL"><a href= - "config.html#BUFFER-LIMIT">buffer-limit</a></tt> option in the - main <a href="config.html">config file</a>. The default is 4096 - KB (4 Megs). Once this limit is exceeded, the buffered data, - and all pending data, is passed through unfiltered.</p> - - <p>Inappropriate MIME types, such as zipped files, are not - filtered at all. (Again, only text-based types except plain - text). Encrypted SSL data (from HTTPS servers) cannot be - filtered either, since this would violate the integrity of the - secure transaction. In some situations it might be necessary to - protect certain text, like source code, from filtering by - defining appropriate <tt class="LITERAL">-filter</tt> - exceptions.</p> - - <p>Compressed content can't be filtered either, but if - <span class="APPLICATION">Privoxy</span> is compiled with zlib - support and a supported compression algorithm is used (gzip or - deflate), <span class="APPLICATION">Privoxy</span> can first - decompress the content and then filter it.</p> - - <p>If you use a <span class="APPLICATION">Privoxy</span> - version without zlib support, but want filtering to work on as - much documents as possible, even those that would normally be - sent compressed, you must use the <tt class="LITERAL"><a href= - "actions-file.html#PREVENT-COMPRESSION">prevent-compression</a></tt> - action in conjunction with <tt class="LITERAL">filter</tt>.</p> - - <p>Content filtering can achieve some of the same effects as - the <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt> action, i.e. it can be - used to block ads and banners. But the mechanism works quite - differently. One effective use, is to block ad banners based on - their size (see below), since many of these seem to be somewhat - standardized.</p> - - <p><a href="contact.html">Feedback</a> with suggestions for new - or improved filters is particularly welcome!</p> - - <p>The below list has only the names and a one-line description - of each predefined filter. There are <a href= - "filter-file.html#PREDEFINED-FILTERS">more verbose - explanations</a> of what these filters do in the <a href= - "filter-file.html">filter file chapter</a>.</p> - </dd> - - <dt>Example usage (with filters from the distribution <tt class= - "FILENAME">default.filter</tt> file). See <a href= - "filter-file.html#PREDEFINED-FILTERS">the Predefined Filters - section</a> for more explanation on each:</dt> - - <dd> - <p><a name="FILTER-JS-ANNOYANCES" id= - "FILTER-JS-ANNOYANCES"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{js-annoyances} # Get rid of particularly annoying JavaScript abuse. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-JS-EVENTS" id="FILTER-JS-EVENTS"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{js-events} # Kill all JS event bindings and timers (Radically destructive! Only for extra nasty sites). -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-HTML-ANNOYANCES" id= - "FILTER-HTML-ANNOYANCES"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{html-annoyances} # Get rid of particularly annoying HTML abuse. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-CONTENT-COOKIES" id= - "FILTER-CONTENT-COOKIES"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{content-cookies} # Kill cookies that come in the HTML or JS content. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-REFRESH-TAGS" id= - "FILTER-REFRESH-TAGS"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{refresh-tags} # Kill automatic refresh tags (for dial-on-demand setups). -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-UNSOLICITED-POPUPS" id= - "FILTER-UNSOLICITED-POPUPS"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{unsolicited-popups} # Disable only unsolicited pop-up windows. Useful if your browser lacks this ability. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-ALL-POPUPS" id="FILTER-ALL-POPUPS"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{all-popups} # Kill all popups in JavaScript and HTML. Useful if your browser lacks this ability. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-IMG-REORDER" id= - "FILTER-IMG-REORDER"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{img-reorder} # Reorder attributes in <img> tags to make the banners-by-* filters more effective. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-BANNERS-BY-SIZE" id= - "FILTER-BANNERS-BY-SIZE"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{banners-by-size} # Kill banners by size. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-BANNERS-BY-LINK" id= - "FILTER-BANNERS-BY-LINK"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{banners-by-link} # Kill banners by their links to known clicktrackers. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-WEBBUGS" id="FILTER-WEBBUGS"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{webbugs} # Squish WebBugs (1x1 invisible GIFs used for user tracking). -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-TINY-TEXTFORMS" id= - "FILTER-TINY-TEXTFORMS"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{tiny-textforms} # Extend those tiny textareas up to 40x80 and kill the hard wrap. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-JUMPING-WINDOWS" id= - "FILTER-JUMPING-WINDOWS"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{jumping-windows} # Prevent windows from resizing and moving themselves. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-FRAMESET-BORDERS" id= - "FILTER-FRAMESET-BORDERS"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{frameset-borders} # Give frames a border and make them resizable. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-DEMORONIZER" id= - "FILTER-DEMORONIZER"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{demoronizer} # Fix MS's non-standard use of standard charsets. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-SHOCKWAVE-FLASH" id= - "FILTER-SHOCKWAVE-FLASH"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{shockwave-flash} # Kill embedded Shockwave Flash objects. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-QUICKTIME-KIOSKMODE" id= - "FILTER-QUICKTIME-KIOSKMODE"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{quicktime-kioskmode} # Make Quicktime movies saveable. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-FUN" id="FILTER-FUN"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{fun} # Text replacements for subversive browsing fun! -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-CRUDE-PARENTAL" id= - "FILTER-CRUDE-PARENTAL"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{crude-parental} # Crude parental filtering. Note that this filter doesn't work reliably. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-IE-EXPLOITS" id= - "FILTER-IE-EXPLOITS"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{ie-exploits} # Disable some known Internet Explorer bug exploits. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-SITE-SPECIFICS" id= - "FILTER-SITE-SPECIFICS"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{site-specifics} # Cure for site-specific problems. Don't apply generally! -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-NO-PING" id="FILTER-NO-PING"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{no-ping} # Removes non-standard ping attributes in <a> and <area> tags. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-GOOGLE" id="FILTER-GOOGLE"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{google} # CSS-based block for Google text ads. Also removes a width limitation and the toolbar advertisement. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-YAHOO" id="FILTER-YAHOO"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{yahoo} # CSS-based block for Yahoo text ads. Also removes a width limitation. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-MSN" id="FILTER-MSN"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{msn} # CSS-based block for MSN text ads. Also removes tracking URLs and a width limitation. -</pre> - </td> - </tr> - </table> - - <p><a name="FILTER-BLOGSPOT" id="FILTER-BLOGSPOT"></a></p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+filter{blogspot} # Cleans up some Blogspot blogs. Read the fine print before using this. -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="FORCE-TEXT-MODE" id= - "FORCE-TEXT-MODE">8.5.16. force-text-mode</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Force <span class="APPLICATION">Privoxy</span> to treat a - document as if it was in some kind of <span class= - "emphasis EMPHASIS c2">text</span> format.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Declares a document as text, even if the <span class= - "QUOTE">"Content-Type:"</span> isn't detected as such.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Boolean.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>N/A</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>As explained <tt class="LITERAL"><a href= - "actions-file.html#FILTER">above</a></tt>, <span class= - "APPLICATION">Privoxy</span> tries to only filter files that - are in some kind of text format. The same restrictions apply to - <tt class="LITERAL"><a href= - "actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite</a></tt>. - <tt class="LITERAL">force-text-mode</tt> declares a document as - text, without looking at the <span class= - "QUOTE">"Content-Type:"</span> first.</p> - - <div class="WARNING"> - <table class="WARNING" border="1" width="90%"> - <tr> - <td class="c6" align="center">Warning</td> - </tr> - - <tr> - <td align="left"> - <p>Think twice before activating this action. Filtering - binary data with regular expressions can cause file - damage.</p> - </td> - </tr> - </table> - </div> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+force-text-mode - -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="FORWARD-OVERRIDE" id= - "FORWARD-OVERRIDE">8.5.17. forward-override</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Change the forwarding settings based on User-Agent or - request origin</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Overrules the forward directives in the configuration - file.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Multi-value.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <ul> - <li> - <p><span class="QUOTE">"forward ."</span> to use a direct - connection without any additional proxies.</p> - </li> - - <li> - <p><span class="QUOTE">"forward 127.0.0.1:8123"</span> to - use the HTTP proxy listening at 127.0.0.1 port 8123.</p> - </li> - - <li> - <p><span class="QUOTE">"forward-socks4a 127.0.0.1:9050 - ."</span> to use the socks4a proxy listening at 127.0.0.1 - port 9050. Replace <span class= - "QUOTE">"forward-socks4a"</span> with <span class= - "QUOTE">"forward-socks4"</span> to use a socks4 connection - (with local DNS resolution) instead, use <span class= - "QUOTE">"forward-socks5"</span> for socks5 connections - (with remote DNS resolution).</p> - </li> - - <li> - <p><span class="QUOTE">"forward-socks4a 127.0.0.1:9050 - proxy.example.org:8000"</span> to use the socks4a proxy - listening at 127.0.0.1 port 9050 to reach the HTTP proxy - listening at proxy.example.org port 8000. Replace - <span class="QUOTE">"forward-socks4a"</span> with - <span class="QUOTE">"forward-socks4"</span> to use a socks4 - connection (with local DNS resolution) instead, use - <span class="QUOTE">"forward-socks5"</span> for socks5 - connections (with remote DNS resolution).</p> - </li> - </ul> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This action takes parameters similar to the <a href= - "config.html#FORWARDING">forward</a> directives in the - configuration file, but without the URL pattern. It can be used - as replacement, but normally it's only used in cases where - matching based on the request URL isn't sufficient.</p> - - <div class="WARNING"> - <table class="WARNING" border="1" width="90%"> - <tr> - <td class="c6" align="center">Warning</td> - </tr> - - <tr> - <td align="left"> - <p>Please read the description for the <a href= - "config.html#FORWARDING">forward</a> directives before - using this action. Forwarding to the wrong people will - reduce your privacy and increase the chances of - man-in-the-middle attacks.</p> - - <p>If the ports are missing or invalid, default values - will be used. This might change in the future and you - shouldn't rely on it. Otherwise incorrect syntax causes - Privoxy to exit.</p> - - <p>Use the <a href= - "http://config.privoxy.org/show-url-info" target= - "_top">show-url-info CGI page</a> to verify that your - forward settings do what you thought the do.</p> - </td> - </tr> - </table> - </div> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Always use direct connections for requests previously tagged as -# <span class="QUOTE">"User-Agent: fetch libfetch/2.0"</span> and make sure -# resuming downloads continues to work. -# This way you can continue to use Tor for your normal browsing, -# without overloading the Tor network with your FreeBSD ports updates -# or downloads of bigger files like ISOs. -# Note that HTTP headers are easy to fake and therefore their -# values are as (un)trustworthy as your clients and users. -{+forward-override{forward .} \ - -hide-if-modified-since \ - -overwrite-last-modified \ -} -TAG:^User-Agent: fetch libfetch/2.0$ - -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="HANDLE-AS-EMPTY-DOCUMENT" id= - "HANDLE-AS-EMPTY-DOCUMENT">8.5.18. handle-as-empty-document</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Mark URLs that should be replaced by empty documents - <span class="emphasis EMPHASIS c2">if they get - blocked</span></p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>This action alone doesn't do anything noticeable. It just - marks URLs. If the <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt> action <span class= - "emphasis EMPHASIS c2">also applies</span>, the presence or - absence of this mark decides whether an HTML <span class= - "QUOTE">"BLOCKED"</span> page, or an empty document will be - sent to the client as a substitute for the blocked content. The - <span class="emphasis EMPHASIS c2">empty</span> document isn't - literally empty, but actually contains a single space.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Boolean.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>N/A</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Some browsers complain about syntax errors if JavaScript - documents are blocked with <span class= - "APPLICATION">Privoxy's</span> default HTML page; this option - can be used to silence them. And of course this action can also - be used to eliminate the <span class= - "APPLICATION">Privoxy</span> BLOCKED message in frames.</p> - - <p>The content type for the empty document can be specified - with <tt class="LITERAL"><a href= - "actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite{}</a></tt>, - but usually this isn't necessary.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Block all documents on example.org that end with ".js", -# but send an empty document instead of the usual HTML message. -{+block{Blocked JavaScript} +handle-as-empty-document} -example.org/.*.js$ - -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="HANDLE-AS-IMAGE" id= - "HANDLE-AS-IMAGE">8.5.19. handle-as-image</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Mark URLs as belonging to images (so they'll be replaced by - images <span class="emphasis EMPHASIS c2">if they do get - blocked</span>, rather than HTML pages)</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>This action alone doesn't do anything noticeable. It just - marks URLs as images. If the <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt> action <span class= - "emphasis EMPHASIS c2">also applies</span>, the presence or - absence of this mark decides whether an HTML <span class= - "QUOTE">"blocked"</span> page, or a replacement image (as - determined by the <tt class="LITERAL"><a href= - "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></tt> - action) will be sent to the client as a substitute for the - blocked content.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Boolean.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>N/A</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>The below generic example section is actually part of - <tt class="FILENAME">default.action</tt>. It marks all URLs - with well-known image file name extensions as images and should - be left intact.</p> - - <p>Users will probably only want to use the handle-as-image - action in conjunction with <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt>, to block sources of - banners, whose URLs don't reflect the file type, like in the - second example section.</p> - - <p>Note that you cannot treat HTML pages as images in most - cases. For instance, (in-line) ad frames require an HTML page - to be sent, or they won't display properly. Forcing <tt class= - "LITERAL">handle-as-image</tt> in this situation will not - replace the ad frame with an image, but lead to error - messages.</p> - </dd> - - <dt>Example usage (sections):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Generic image extensions: -# -{+handle-as-image} -/.*.(gif|jpg|jpeg|png|bmp|ico)$ - -# These don't look like images, but they're banners and should be -# blocked as images: -# -{+block{Nasty banners.} +handle-as-image} -nasty-banner-server.example.com/junk.cgi?output=trash -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="HIDE-ACCEPT-LANGUAGE" id= - "HIDE-ACCEPT-LANGUAGE">8.5.20. hide-accept-language</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Pretend to use different language settings.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes or replaces the <span class= - "QUOTE">"Accept-Language:"</span> HTTP header in client - requests.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>Keyword: <span class="QUOTE">"block"</span>, or any user - defined value.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Faking the browser's language settings can be useful to make - a foreign User-Agent set with <tt class="LITERAL"><a href= - "actions-file.html#HIDE-USER-AGENT">hide-user-agent</a></tt> - more believable.</p> - - <p>However some sites with content in different languages check - the <span class="QUOTE">"Accept-Language:"</span> to decide - which one to take by default. Sometimes it isn't possible to - later switch to another language without changing the - <span class="QUOTE">"Accept-Language:"</span> header first.</p> - - <p>Therefore it's a good idea to either only change the - <span class="QUOTE">"Accept-Language:"</span> header to - languages you understand, or to languages that aren't wide - spread.</p> - - <p>Before setting the <span class= - "QUOTE">"Accept-Language:"</span> header to a rare language, - you should consider that it helps to make your requests unique - and thus easier to trace. If you don't plan to change this - header frequently, you should stick to a common language.</p> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Pretend to use Canadian language settings. -{+hide-accept-language{en-ca} \ -+hide-user-agent{Mozilla/5.0 (X11; U; OpenBSD i386; en-CA; rv:1.8.0.4) Gecko/20060628 Firefox/1.5.0.4} \ -} -/ -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="HIDE-CONTENT-DISPOSITION" id= - "HIDE-CONTENT-DISPOSITION">8.5.21. hide-content-disposition</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Prevent download menus for content you prefer to view inside - the browser.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes or replaces the <span class= - "QUOTE">"Content-Disposition:"</span> HTTP header set by some - servers.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>Keyword: <span class="QUOTE">"block"</span>, or any user - defined value.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Some servers set the <span class= - "QUOTE">"Content-Disposition:"</span> HTTP header for documents - they assume you want to save locally before viewing them. The - <span class="QUOTE">"Content-Disposition:"</span> header - contains the file name the browser is supposed to use by - default.</p> - - <p>In most browsers that understand this header, it makes it - impossible to <span class="emphasis EMPHASIS c2">just - view</span> the document, without downloading it first, even if - it's just a simple text file or an image.</p> - - <p>Removing the <span class= - "QUOTE">"Content-Disposition:"</span> header helps to prevent - this annoyance, but some browsers additionally check the - <span class="QUOTE">"Content-Type:"</span> header, before they - decide if they can display a document without saving it first. - In these cases, you have to change this header as well, before - the browser stops displaying download menus.</p> - - <p>It is also possible to change the server's file name - suggestion to another one, but in most cases it isn't worth the - time to set it up.</p> - - <p>This action will probably be removed in the future, use - server-header filters instead.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Disarm the download link in Sourceforge's patch tracker -{ -filter \ - +content-type-overwrite{text/plain}\ - +hide-content-disposition{block} } - .sourceforge.net/tracker/download.php -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="HIDE-IF-MODIFIED-SINCE" id= - "HIDE-IF-MODIFIED-SINCE">8.5.22. hide-if-modified-since</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Prevent yet another way to track the user's steps between - sessions.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes the <span class="QUOTE">"If-Modified-Since:"</span> - HTTP client header or modifies its value.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>Keyword: <span class="QUOTE">"block"</span>, or a user - defined value that specifies a range of hours.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Removing this header is useful for filter testing, where you - want to force a real reload instead of getting status code - <span class="QUOTE">"304"</span>, which would cause the browser - to use a cached copy of the page.</p> - - <p>Instead of removing the header, <tt class= - "LITERAL">hide-if-modified-since</tt> can also add or subtract - a random amount of time to/from the header's value. You specify - a range of minutes where the random factor should be chosen - from and <span class="APPLICATION">Privoxy</span> does the - rest. A negative value means subtracting, a positive value - adding.</p> - - <p>Randomizing the value of the <span class= - "QUOTE">"If-Modified-Since:"</span> makes it less likely that - the server can use the time as a cookie replacement, but you - will run into caching problems if the random range is too - high.</p> - - <p>It is a good idea to only use a small negative value and let - <tt class="LITERAL"><a href= - "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></tt> - handle the greater changes.</p> - - <p>It is also recommended to use this action together with - <tt class="LITERAL"><a href= - "actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a></tt>, - otherwise it's more or less pointless.</p> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Let the browser revalidate but make tracking based on the time less likely. -{+hide-if-modified-since{-60} \ - +overwrite-last-modified{randomize} \ - +crunch-if-none-match} -/ -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="HIDE-FROM-HEADER" id= - "HIDE-FROM-HEADER">8.5.23. hide-from-header</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Keep your (old and ill) browser from telling web servers - your email address</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes any existing <span class="QUOTE">"From:"</span> HTTP - header, or replaces it with the specified string.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>Keyword: <span class="QUOTE">"block"</span>, or any user - defined value.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>The keyword <span class="QUOTE">"block"</span> will - completely remove the header (not to be confused with the - <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt> action).</p> - - <p>Alternately, you can specify any value you prefer to be sent - to the web server. If you do, it is a matter of fairness not to - use any address that is actually used by a real person.</p> - - <p>This action is rarely needed, as modern web browsers don't - send <span class="QUOTE">"From:"</span> headers anymore.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+hide-from-header{block} -</pre> - </td> - </tr> - </table>or - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+hide-from-header{spam-me-senseless@sittingduck.example.com} -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="HIDE-REFERRER" id="HIDE-REFERRER">8.5.24. - hide-referrer</a></h4><a name="HIDE-REFERER" id="HIDE-REFERER"></a> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Conceal which link you followed to get to a particular - site</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes the <span class="QUOTE">"Referer:"</span> (sic) HTTP - header from the client request, or replaces it with a forged - one.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <ul> - <li> - <p><span class="QUOTE">"conditional-block"</span> to delete - the header completely if the host has changed.</p> - </li> - - <li> - <p><span class="QUOTE">"conditional-forge"</span> to forge - the header if the host has changed.</p> - </li> - - <li> - <p><span class="QUOTE">"block"</span> to delete the header - unconditionally.</p> - </li> - - <li> - <p><span class="QUOTE">"forge"</span> to pretend to be - coming from the homepage of the server we are talking - to.</p> - </li> - - <li> - <p>Any other string to set a user defined referrer.</p> - </li> - </ul> - </dd> - - <dt>Notes:</dt> - - <dd> - <p><tt class="LITERAL">conditional-block</tt> is the only - parameter, that isn't easily detected in the server's log file. - If it blocks the referrer, the request will look like the - visitor used a bookmark or typed in the address directly.</p> - - <p>Leaving the referrer unmodified for requests on the same - host allows the server owner to see the visitor's <span class= - "QUOTE">"click path"</span>, but in most cases she could also - get that information by comparing other parts of the log file: - for example the User-Agent if it isn't a very common one, or - the user's IP address if it doesn't change between different - requests.</p> - - <p>Always blocking the referrer, or using a custom one, can - lead to failures on servers that check the referrer before they - answer any requests, in an attempt to prevent their content - from being embedded or linked to elsewhere.</p> - - <p>Both <tt class="LITERAL">conditional-block</tt> and - <tt class="LITERAL">forge</tt> will work with referrer checks, - as long as content and valid referring page are on the same - host. Most of the time that's the case.</p> - - <p><tt class="LITERAL">hide-referer</tt> is an alternate - spelling of <tt class="LITERAL">hide-referrer</tt> and the two - can be can be freely substituted with each other. (<span class= - "QUOTE">"referrer"</span> is the correct English spelling, - however the HTTP specification has a bug - it requires it to be - spelled as <span class="QUOTE">"referer"</span>.)</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+hide-referrer{forge} -</pre> - </td> - </tr> - </table>or - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+hide-referrer{http://www.yahoo.com/%7D -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="HIDE-USER-AGENT" id= - "HIDE-USER-AGENT">8.5.25. hide-user-agent</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Try to conceal your type of browser and client operating - system</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Replaces the value of the <span class= - "QUOTE">"User-Agent:"</span> HTTP header in client requests - with the specified value.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>Any user-defined string.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <div class="WARNING"> - <table class="WARNING" border="1" width="90%"> - <tr> - <td class="c6" align="center">Warning</td> - </tr> - - <tr> - <td align="left"> - <p>This can lead to problems on web sites that depend - on looking at this header in order to customize their - content for different browsers (which, by the way, is - <span class="emphasis EMPHASIS c2">NOT</span> the right - thing to do: good web sites work - browser-independently).</p> - </td> - </tr> - </table> - </div> - - <p>Using this action in multi-user setups or wherever different - types of browsers will access the same <span class= - "APPLICATION">Privoxy</span> is <span class= - "emphasis EMPHASIS c2">not recommended</span>. In single-user, - single-browser setups, you might use it to delete your OS - version information from the headers, because it is an - invitation to exploit known bugs for your OS. It is also - occasionally useful to forge this in order to access sites that - won't let you in otherwise (though there may be a good reason - in some cases).</p> - - <p>More information on known user-agent strings can be found at - <a href="http://www.user-agents.org/" target= - "_top">http://www.user-agents.org/</a> and <a href= - "http://en.wikipedia.org/wiki/User_agent" target= - "_top">http://en.wikipedia.org/wiki/User_agent</a>.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+hide-user-agent{Netscape 6.1 (X11; I; Linux 2.4.18 i686)} -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="LIMIT-CONNECT" id="LIMIT-CONNECT">8.5.26. - limit-connect</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Prevent abuse of <span class="APPLICATION">Privoxy</span> as - a TCP proxy relay or disable SSL for untrusted sites</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Specifies to which ports HTTP CONNECT requests are - allowable.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>A comma-separated list of ports or port ranges (the latter - using dashes, with the minimum defaulting to 0 and the maximum - to 65K).</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>By default, i.e. if no <tt class= - "LITERAL">limit-connect</tt> action applies, <span class= - "APPLICATION">Privoxy</span> allows HTTP CONNECT requests to - all ports. Use <tt class="LITERAL">limit-connect</tt> if - fine-grained control is desired for some or all - destinations.</p> - - <p>The CONNECT methods exists in HTTP to allow access to secure - websites (<span class="QUOTE">"https://"</span> URLs) through - proxies. It works very simply: the proxy connects to the server - on the specified port, and then short-circuits its connections - to the client and to the remote server. This means - CONNECT-enabled proxies can be used as TCP relays very - easily.</p> - - <p><span class="APPLICATION">Privoxy</span> relays HTTPS - traffic without seeing the decoded content. Websites can - leverage this limitation to circumvent <span class= - "APPLICATION">Privoxy</span>'s filters. By specifying an - invalid port range you can disable HTTPS entirely.</p> - </dd> +www.example.net/.*style</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="CRUNCH-CLIENT-HEADER" +>8.5.7. crunch-client-header</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Remove a client header <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> has no dedicated action for.</P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes every header sent by the client that contains the string the user supplied as parameter. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> Any string. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> This action allows you to block client headers for which no dedicated + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> action exists. + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will remove every client header that + contains the string you supplied as parameter. + </P +><P +> Regular expressions are <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not supported</I +></SPAN +> and you can't + use this action to block different headers in the same request, unless + they contain the same string. + </P +><P +> <TT +CLASS="LITERAL" +>crunch-client-header</TT +> is only meant for quick tests. + If you have to block several different headers, or only want to modify + parts of them, you should use a + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CLIENT-HEADER-FILTER" +>client-header filter</A +></TT +>. + </P +><DIV +CLASS="WARNING" +><P +></P +><TABLE +CLASS="WARNING" +BORDER="1" +WIDTH="90%" +><TR +><TD +ALIGN="CENTER" +><B +>Warning</B +></TD +></TR +><TR +><TD +ALIGN="LEFT" +><P +> Don't block any header without understanding the consequences. + </P +></TD +></TR +></TABLE +></DIV +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Block the non-existent "Privacy-Violation:" client header +{ +crunch-client-header{Privacy-Violation:} } +/ + </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="CRUNCH-IF-NONE-MATCH" +>8.5.8. crunch-if-none-match</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Prevent yet another way to track the user's steps between sessions.</P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes the <SPAN +CLASS="QUOTE" +>"If-None-Match:"</SPAN +> HTTP client header. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Boolean.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> N/A + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Removing the <SPAN +CLASS="QUOTE" +>"If-None-Match:"</SPAN +> HTTP client header + is useful for filter testing, where you want to force a real + reload instead of getting status code <SPAN +CLASS="QUOTE" +>"304"</SPAN +> which + would cause the browser to use a cached copy of the page. + </P +><P +> It is also useful to make sure the header isn't used as a cookie + replacement (unlikely but possible). + </P +><P +> Blocking the <SPAN +CLASS="QUOTE" +>"If-None-Match:"</SPAN +> header shouldn't cause any + caching problems, as long as the <SPAN +CLASS="QUOTE" +>"If-Modified-Since:"</SPAN +> header + isn't blocked or missing as well. + </P +><P +> It is recommended to use this action together with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE" +>hide-if-modified-since</A +></TT +> + and + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#OVERWRITE-LAST-MODIFIED" +>overwrite-last-modified</A +></TT +>. + </P +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Let the browser revalidate cached documents but don't +# allow the server to use the revalidation headers for user tracking. +{+hide-if-modified-since{-60} \ + +overwrite-last-modified{randomize} \ + +crunch-if-none-match} +/ </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="CRUNCH-INCOMING-COOKIES" +>8.5.9. crunch-incoming-cookies</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +> Prevent the web server from setting HTTP cookies on your system + </P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes any <SPAN +CLASS="QUOTE" +>"Set-Cookie:"</SPAN +> HTTP headers from server replies. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Boolean.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> N/A + </P +></DD +><DT +>Notes:</DT +><DD +><P +> This action is only concerned with <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>incoming</I +></SPAN +> HTTP cookies. For + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>outgoing</I +></SPAN +> HTTP cookies, use + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES" +>crunch-outgoing-cookies</A +></TT +>. + Use <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>both</I +></SPAN +> to disable HTTP cookies completely. + </P +><P +> It makes <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>no sense at all</I +></SPAN +> to use this action in conjunction + with the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SESSION-COOKIES-ONLY" +>session-cookies-only</A +></TT +> action, + since it would prevent the session cookies from being set. See also + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FILTER-CONTENT-COOKIES" +>filter-content-cookies</A +></TT +>. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+crunch-incoming-cookies</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="CRUNCH-SERVER-HEADER" +>8.5.10. crunch-server-header</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Remove a server header <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> has no dedicated action for.</P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes every header sent by the server that contains the string the user supplied as parameter. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> Any string. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> This action allows you to block server headers for which no dedicated + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> action exists. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + will remove every server header that contains the string you supplied as parameter. + </P +><P +> Regular expressions are <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not supported</I +></SPAN +> and you can't + use this action to block different headers in the same request, unless + they contain the same string. + </P +><P +> <TT +CLASS="LITERAL" +>crunch-server-header</TT +> is only meant for quick tests. + If you have to block several different headers, or only want to modify + parts of them, you should use a custom + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SERVER-HEADER-FILTER" +>server-header filter</A +></TT +>. + </P +><DIV +CLASS="WARNING" +><P +></P +><TABLE +CLASS="WARNING" +BORDER="1" +WIDTH="90%" +><TR +><TD +ALIGN="CENTER" +><B +>Warning</B +></TD +></TR +><TR +><TD +ALIGN="LEFT" +><P +> Don't block any header without understanding the consequences. + </P +></TD +></TR +></TABLE +></DIV +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Crunch server headers that try to prevent caching +{ +crunch-server-header{no-cache} } +/ </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="CRUNCH-OUTGOING-COOKIES" +>8.5.11. crunch-outgoing-cookies</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +> Prevent the web server from reading any HTTP cookies from your system + </P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes any <SPAN +CLASS="QUOTE" +>"Cookie:"</SPAN +> HTTP headers from client requests. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Boolean.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> N/A + </P +></DD +><DT +>Notes:</DT +><DD +><P +> This action is only concerned with <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>outgoing</I +></SPAN +> HTTP cookies. For + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>incoming</I +></SPAN +> HTTP cookies, use + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +>crunch-incoming-cookies</A +></TT +>. + Use <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>both</I +></SPAN +> to disable HTTP cookies completely. + </P +><P +> It makes <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>no sense at all</I +></SPAN +> to use this action in conjunction + with the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SESSION-COOKIES-ONLY" +>session-cookies-only</A +></TT +> action, + since it would prevent the session cookies from being read. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+crunch-outgoing-cookies</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="DEANIMATE-GIFS" +>8.5.12. deanimate-gifs</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Stop those annoying, distracting animated GIF images.</P +></DD +><DT +>Effect:</DT +><DD +><P +> De-animate GIF animations, i.e. reduce them to their first or last image. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> <SPAN +CLASS="QUOTE" +>"last"</SPAN +> or <SPAN +CLASS="QUOTE" +>"first"</SPAN +> + </P +></DD +><DT +>Notes:</DT +><DD +><P +> This will also shrink the images considerably (in bytes, not pixels!). If + the option <SPAN +CLASS="QUOTE" +>"first"</SPAN +> is given, the first frame of the animation + is used as the replacement. If <SPAN +CLASS="QUOTE" +>"last"</SPAN +> is given, the last + frame of the animation is used instead, which probably makes more sense for + most banner animations, but also has the risk of not showing the entire + last frame (if it is only a delta to an earlier frame). + </P +><P +> You can safely use this action with patterns that will also match non-GIF + objects, because no attempt will be made at anything that doesn't look like + a GIF. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+deanimate-gifs{last}</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="DOWNGRADE-HTTP-VERSION" +>8.5.13. downgrade-http-version</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Work around (very rare) problems with HTTP/1.1</P +></DD +><DT +>Effect:</DT +><DD +><P +> Downgrades HTTP/1.1 client requests and server replies to HTTP/1.0. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Boolean.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> N/A + </P +></DD +><DT +>Notes:</DT +><DD +><P +> This is a left-over from the time when <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + didn't support important HTTP/1.1 features well. It is left here for the + unlikely case that you experience HTTP/1.1 related problems with some server + out there. Not all HTTP/1.1 features and requirements are supported yet, + so there is a chance you might need this action. + </P +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{+downgrade-http-version} +problem-host.example.com</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="FAST-REDIRECTS" +>8.5.14. fast-redirects</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Fool some click-tracking scripts and speed up indirect links.</P +></DD +><DT +>Effect:</DT +><DD +><P +> Detects redirection URLs and redirects the browser without contacting + the redirection server first. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +></P +><UL +><LI +><P +> <SPAN +CLASS="QUOTE" +>"simple-check"</SPAN +> to just search for the string <SPAN +CLASS="QUOTE" +>"http://"</SPAN +> + to detect redirection URLs. + </P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"check-decoded-url"</SPAN +> to decode URLs (if necessary) before searching + for redirection URLs. + </P +></LI +></UL +></DD +><DT +>Notes:</DT +><DD +><P +> + Many sites, like yahoo.com, don't just link to other sites. Instead, they + will link to some script on their own servers, giving the destination as a + parameter, which will then redirect you to the final target. URLs + resulting from this scheme typically look like: + <SPAN +CLASS="QUOTE" +>"http://www.example.org/click-tracker.cgi?target=http%3a//www.example.net/"</SPAN +>. + </P +><P +> Sometimes, there are even multiple consecutive redirects encoded in the + URL. These redirections via scripts make your web browsing 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 asks the server for one redirect after the other. Plus, it feeds + the advertisers. + </P +><P +> This feature is currently not very smart and is scheduled for improvement. + If it is enabled by default, you will have to create some exceptions to + this action. It can lead to failures in several ways: + </P +><P +> Not every URLs with other URLs as parameters is evil. + Some sites offer a real service that requires this information to work. + For example a validation service needs to know, which document to validate. + <TT +CLASS="LITERAL" +>fast-redirects</TT +> assumes that every URL parameter that + looks like another URL is a redirection target, and will always redirect to + the last one. Most of the time the assumption is correct, but if it isn't, + the user gets redirected anyway. + </P +><P +> Another failure occurs if the URL contains other parameters after the URL parameter. + The URL: + <SPAN +CLASS="QUOTE" +>"http://www.example.org/?redirect=http%3a//www.example.net/&foo=bar"</SPAN +>. + contains the redirection URL <SPAN +CLASS="QUOTE" +>"http://www.example.net/"</SPAN +>, + followed by another parameter. <TT +CLASS="LITERAL" +>fast-redirects</TT +> doesn't know that + and will cause a redirect to <SPAN +CLASS="QUOTE" +>"http://www.example.net/&foo=bar"</SPAN +>. + Depending on the target server configuration, the parameter will be silently ignored + or lead to a <SPAN +CLASS="QUOTE" +>"page not found"</SPAN +> error. You can prevent this problem by + first using the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#REDIRECT" +>redirect</A +></TT +> action + to remove the last part of the URL, but it requires a little effort. + </P +><P +> To detect a redirection URL, <TT +CLASS="LITERAL" +>fast-redirects</TT +> only + looks for the string <SPAN +CLASS="QUOTE" +>"http://"</SPAN +>, either in plain text + (invalid but often used) or encoded as <SPAN +CLASS="QUOTE" +>"http%3a//"</SPAN +>. + Some sites use their own URL encoding scheme, encrypt the address + of the target server or replace it with a database id. In theses cases + <TT +CLASS="LITERAL" +>fast-redirects</TT +> is fooled and the request reaches the + redirection server where it probably gets logged. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> { +fast-redirects{simple-check} } + one.example.com
- <dt>Example usages:</dt> + { +fast-redirects{check-decoded-url} } + another.example.com/testing</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="FILTER" +>8.5.15. filter</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Get rid of HTML and JavaScript annoyances, banner advertisements (by size), + do fun text replacements, add personalized effects, etc.</P +></DD +><DT +>Effect:</DT +><DD +><P +> All instances of text-based type, most notably HTML and JavaScript, to which + this action applies, can be filtered on-the-fly through the specified regular + expression based substitutions. (Note: as of version 3.0.3 plain text documents + are exempted from filtering, because web servers often use the + <TT +CLASS="LITERAL" +>text/plain</TT +> MIME type for all files whose type they don't know.) + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> The name of a content filter, as defined in the <A +HREF="filter-file.html" +>filter file</A +>. + Filters can be defined in one or more files as defined by the + <TT +CLASS="LITERAL" +><A +HREF="config.html#FILTERFILE" +>filterfile</A +></TT +> + option in the <A +HREF="config.html" +>config file</A +>. + <TT +CLASS="FILENAME" +>default.filter</TT +> is the collection of filters + supplied by the developers. Locally defined filters should go + in their own file, such as <TT +CLASS="FILENAME" +>user.filter</TT +>. + </P +><P +> When used in its negative form, + and without parameters, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> filtering is completely disabled. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> For your convenience, there are a number of pre-defined filters available + in the distribution filter file that you can use. See the examples below for + a list. + </P +><P +> Filtering requires buffering the page content, which may appear to + slow down page rendering since nothing is displayed until all content has + passed the filters. (It does not really take longer, but seems that way + since the page is not incrementally displayed.) This effect will be more + noticeable on slower connections. + </P +><P +> <SPAN +CLASS="QUOTE" +>"Rolling your own"</SPAN +> + filters requires a knowledge of + <A +HREF="http://en.wikipedia.org/wiki/Regular_expressions" +TARGET="_top" +><SPAN +CLASS="QUOTE" +>"Regular + Expressions"</SPAN +></A +> and + <A +HREF="http://en.wikipedia.org/wiki/Html" +TARGET="_top" +><SPAN +CLASS="QUOTE" +>"HTML"</SPAN +></A +>. + This is very powerful feature, and potentially very intrusive. + Filters should be used with caution, and where an equivalent + <SPAN +CLASS="QUOTE" +>"action"</SPAN +> is not available. + </P +><P +> The amount of data that can be filtered is limited to the + <TT +CLASS="LITERAL" +><A +HREF="config.html#BUFFER-LIMIT" +>buffer-limit</A +></TT +> + option in the main <A +HREF="config.html" +>config file</A +>. The + default is 4096 KB (4 Megs). Once this limit is exceeded, the buffered + data, and all pending data, is passed through unfiltered. + </P +><P +> Inappropriate MIME types, such as zipped files, are not filtered at all. + (Again, only text-based types except plain text). Encrypted SSL data + (from HTTPS servers) cannot be filtered either, since this would violate + the integrity of the secure transaction. In some situations it might + be necessary to protect certain text, like source code, from filtering + by defining appropriate <TT +CLASS="LITERAL" +>-filter</TT +> exceptions. + </P +><P +> Compressed content can't be filtered either, unless <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + is compiled with zlib support (requires at least <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> 3.0.7), + in which case <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will decompress the content before filtering + it. + </P +><P +> If you use a <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version without zlib support, but want filtering to work on + as much documents as possible, even those that would normally be sent compressed, + you must use the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#PREVENT-COMPRESSION" +>prevent-compression</A +></TT +> + action in conjunction with <TT +CLASS="LITERAL" +>filter</TT +>. + </P +><P +> Content filtering can achieve some of the same effects as the + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> + action, i.e. it can be used to block ads and banners. But the mechanism + works quite differently. One effective use, is to block ad banners + based on their size (see below), since many of these seem to be somewhat + standardized. + </P +><P +> <A +HREF="contact.html" +>Feedback</A +> with suggestions for new or + improved filters is particularly welcome! + </P +><P +> The below list has only the names and a one-line description of each + predefined filter. There are <A +HREF="filter-file.html#PREDEFINED-FILTERS" +>more + verbose explanations</A +> of what these filters do in the <A +HREF="filter-file.html" +>filter file chapter</A +>. + </P +></DD +><DT +>Example usage (with filters from the distribution <TT +CLASS="FILENAME" +>default.filter</TT +> file). + See <A +HREF="filter-file.html#PREDEFINED-FILTERS" +>the Predefined Filters section</A +> for + more explanation on each:</DT +><DD +><P +> <A +NAME="FILTER-JS-ANNOYANCES" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{js-annoyances} # Get rid of particularly annoying JavaScript abuse.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-JS-EVENTS" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{js-events} # Kill all JS event bindings and timers (Radically destructive! Only for extra nasty sites).</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-HTML-ANNOYANCES" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{html-annoyances} # Get rid of particularly annoying HTML abuse.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-CONTENT-COOKIES" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{content-cookies} # Kill cookies that come in the HTML or JS content.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-REFRESH-TAGS" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{refresh-tags} # Kill automatic refresh tags (for dial-on-demand setups).</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-UNSOLICITED-POPUPS" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{unsolicited-popups} # Disable only unsolicited pop-up windows. Useful if your browser lacks this ability.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-ALL-POPUPS" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{all-popups} # Kill all popups in JavaScript and HTML. Useful if your browser lacks this ability.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-IMG-REORDER" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{img-reorder} # Reorder attributes in <img> tags to make the banners-by-* filters more effective.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-BANNERS-BY-SIZE" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{banners-by-size} # Kill banners by size.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-BANNERS-BY-LINK" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{banners-by-link} # Kill banners by their links to known clicktrackers.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-WEBBUGS" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{webbugs} # Squish WebBugs (1x1 invisible GIFs used for user tracking).</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-TINY-TEXTFORMS" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{tiny-textforms} # Extend those tiny textareas up to 40x80 and kill the hard wrap.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-JUMPING-WINDOWS" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{jumping-windows} # Prevent windows from resizing and moving themselves.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-FRAMESET-BORDERS" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{frameset-borders} # Give frames a border and make them resizable.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-DEMORONIZER" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{demoronizer} # Fix MS's non-standard use of standard charsets.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-SHOCKWAVE-FLASH" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{shockwave-flash} # Kill embedded Shockwave Flash objects.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-QUICKTIME-KIOSKMODE" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{quicktime-kioskmode} # Make Quicktime movies saveable.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-FUN" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{fun} # Text replacements for subversive browsing fun!</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-CRUDE-PARENTAL" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{crude-parental} # Crude parental filtering. Note that this filter doesn't work reliably.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-IE-EXPLOITS" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{ie-exploits} # Disable some known Internet Explorer bug exploits.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-SITE-SPECIFICS" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{site-specifics} # Cure for site-specific problems. Don't apply generally!</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-NO-PING" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{no-ping} # Removes non-standard ping attributes in <a> and <area> tags.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-GOOGLE" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{google} # CSS-based block for Google text ads. Also removes a width limitation and the toolbar advertisement.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-YAHOO" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{yahoo} # CSS-based block for Yahoo text ads. Also removes a width limitation.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-MSN" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{msn} # CSS-based block for MSN text ads. Also removes tracking URLs and a width limitation.</PRE +></TD +></TR +></TABLE +> + </P +><P +> <A +NAME="FILTER-BLOGSPOT" +></A +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+filter{blogspot} # Cleans up some Blogspot blogs. Read the fine print before using this.</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="FORCE-TEXT-MODE" +>8.5.16. force-text-mode</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Force <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to treat a document as if it was in some kind of <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>text</I +></SPAN +> format. </P +></DD +><DT +>Effect:</DT +><DD +><P +> Declares a document as text, even if the <SPAN +CLASS="QUOTE" +>"Content-Type:"</SPAN +> isn't detected as such. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Boolean.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> N/A + </P +></DD +><DT +>Notes:</DT +><DD +><P +> As explained <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FILTER" +>above</A +></TT +>, + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> tries to only filter files that are + in some kind of text format. The same restrictions apply to + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CONTENT-TYPE-OVERWRITE" +>content-type-overwrite</A +></TT +>. + <TT +CLASS="LITERAL" +>force-text-mode</TT +> declares a document as text, + without looking at the <SPAN +CLASS="QUOTE" +>"Content-Type:"</SPAN +> first. + </P +><DIV +CLASS="WARNING" +><P +></P +><TABLE +CLASS="WARNING" +BORDER="1" +WIDTH="90%" +><TR +><TD +ALIGN="CENTER" +><B +>Warning</B +></TD +></TR +><TR +><TD +ALIGN="LEFT" +><P +> Think twice before activating this action. Filtering binary data + with regular expressions can cause file damage. + </P +></TD +></TR +></TABLE +></DIV +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+force-text-mode + </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="FORWARD-OVERRIDE" +>8.5.17. forward-override</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Change the forwarding settings based on User-Agent or request origin</P +></DD +><DT +>Effect:</DT +><DD +><P +> Overrules the forward directives in the configuration file. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Multi-value.</P +></DD +><DT +>Parameter:</DT +><DD +><P +></P +><UL +><LI +><P +><SPAN +CLASS="QUOTE" +>"forward ."</SPAN +> to use a direct connection without any additional proxies.</P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"forward 127.0.0.1:8123"</SPAN +> to use the HTTP proxy listening at 127.0.0.1 port 8123. + </P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"forward-socks4a 127.0.0.1:9050 ."</SPAN +> to use the socks4a proxy listening at + 127.0.0.1 port 9050. Replace <SPAN +CLASS="QUOTE" +>"forward-socks4a"</SPAN +> with <SPAN +CLASS="QUOTE" +>"forward-socks4"</SPAN +> + to use a socks4 connection (with local DNS resolution) instead, use <SPAN +CLASS="QUOTE" +>"forward-socks5"</SPAN +> + for socks5 connections (with remote DNS resolution). + </P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"forward-socks4a 127.0.0.1:9050 proxy.example.org:8000"</SPAN +> to use the socks4a proxy + listening at 127.0.0.1 port 9050 to reach the HTTP proxy listening at proxy.example.org port 8000. + Replace <SPAN +CLASS="QUOTE" +>"forward-socks4a"</SPAN +> with <SPAN +CLASS="QUOTE" +>"forward-socks4"</SPAN +> to use a socks4 connection + (with local DNS resolution) instead, use <SPAN +CLASS="QUOTE" +>"forward-socks5"</SPAN +> + for socks5 connections (with remote DNS resolution). + </P +></LI +></UL +></DD +><DT +>Notes:</DT +><DD +><P +> This action takes parameters similar to the + <A +HREF="config.html#FORWARDING" +>forward</A +> directives in the configuration + file, but without the URL pattern. It can be used as replacement, but normally it's only + used in cases where matching based on the request URL isn't sufficient. + </P +><DIV +CLASS="WARNING" +><P +></P +><TABLE +CLASS="WARNING" +BORDER="1" +WIDTH="90%" +><TR +><TD +ALIGN="CENTER" +><B +>Warning</B +></TD +></TR +><TR +><TD +ALIGN="LEFT" +><P +> Please read the description for the <A +HREF="config.html#FORWARDING" +>forward</A +> directives before + using this action. Forwarding to the wrong people will reduce your privacy and increase the + chances of man-in-the-middle attacks. + </P +><P +> If the ports are missing or invalid, default values will be used. This might change + in the future and you shouldn't rely on it. Otherwise incorrect syntax causes Privoxy + to exit. + </P +><P +> Use the <A +HREF="http://config.privoxy.org/show-url-info" +TARGET="_top" +>show-url-info CGI page</A +> + to verify that your forward settings do what you thought the do. + </P +></TD +></TR +></TABLE +></DIV +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Always use direct connections for requests previously tagged as +# <SPAN +CLASS="QUOTE" +>"User-Agent: fetch libfetch/2.0"</SPAN +> and make sure +# resuming downloads continues to work. +# This way you can continue to use Tor for your normal browsing, +# without overloading the Tor network with your FreeBSD ports updates +# or downloads of bigger files like ISOs. +# Note that HTTP headers are easy to fake and therefore their +# values are as (un)trustworthy as your clients and users. +{+forward-override{forward .} \ + -hide-if-modified-since \ + -overwrite-last-modified \ +} +TAG:^User-Agent: fetch libfetch/2.0$ + </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="HANDLE-AS-EMPTY-DOCUMENT" +>8.5.18. handle-as-empty-document</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Mark URLs that should be replaced by empty documents <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>if they get blocked</I +></SPAN +></P +></DD +><DT +>Effect:</DT +><DD +><P +> This action alone doesn't do anything noticeable. It just marks URLs. + If the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> action <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>also applies</I +></SPAN +>, + the presence or absence of this mark decides whether an HTML <SPAN +CLASS="QUOTE" +>"BLOCKED"</SPAN +> + page, or an empty document will be sent to the client as a substitute for the blocked content. + The <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>empty</I +></SPAN +> document isn't literally empty, but actually contains a single space. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Boolean.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> N/A + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Some browsers complain about syntax errors if JavaScript documents + are blocked with <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + default HTML page; this option can be used to silence them. + And of course this action can also be used to eliminate the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + BLOCKED message in frames. + </P +><P +> The content type for the empty document can be specified with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CONTENT-TYPE-OVERWRITE" +>content-type-overwrite{}</A +></TT +>, + but usually this isn't necessary. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Block all documents on example.org that end with ".js", +# but send an empty document instead of the usual HTML message. +{+block{Blocked JavaScript} +handle-as-empty-document} +example.org/.*.js$ + </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="HANDLE-AS-IMAGE" +>8.5.19. handle-as-image</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Mark URLs as belonging to images (so they'll be replaced by images <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>if they do get blocked</I +></SPAN +>, rather than HTML pages)</P +></DD +><DT +>Effect:</DT +><DD +><P +> This action alone doesn't do anything noticeable. It just marks URLs as images. + If the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> action <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>also applies</I +></SPAN +>, + the presence or absence of this mark decides whether an HTML <SPAN +CLASS="QUOTE" +>"blocked"</SPAN +> + page, or a replacement image (as determined by the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker</A +></TT +> action) will be sent to the + client as a substitute for the blocked content. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Boolean.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> N/A + </P +></DD +><DT +>Notes:</DT +><DD +><P +> The below generic example section is actually part of <TT +CLASS="FILENAME" +>default.action</TT +>. + It marks all URLs with well-known image file name extensions as images and should + be left intact. + </P +><P +> Users will probably only want to use the handle-as-image action in conjunction with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +>, to block sources of banners, whose URLs don't + reflect the file type, like in the second example section. + </P +><P +> Note that you cannot treat HTML pages as images in most cases. For instance, (in-line) ad + frames require an HTML page to be sent, or they won't display properly. + Forcing <TT +CLASS="LITERAL" +>handle-as-image</TT +> in this situation will not replace the + ad frame with an image, but lead to error messages. + </P +></DD +><DT +>Example usage (sections):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Generic image extensions: +# +{+handle-as-image} +/.*.(gif|jpg|jpeg|png|bmp|ico)$
- <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+limit-connect{443} # Port 443 is OK. +# These don't look like images, but they're banners and should be +# blocked as images: +# +{+block{Nasty banners.} +handle-as-image} +nasty-banner-server.example.com/junk.cgi?output=trash</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="HIDE-ACCEPT-LANGUAGE" +>8.5.20. hide-accept-language</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Pretend to use different language settings.</P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes or replaces the <SPAN +CLASS="QUOTE" +>"Accept-Language:"</SPAN +> HTTP header in client requests. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> Keyword: <SPAN +CLASS="QUOTE" +>"block"</SPAN +>, or any user defined value. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Faking the browser's language settings can be useful to make a + foreign User-Agent set with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HIDE-USER-AGENT" +>hide-user-agent</A +></TT +> + more believable. + </P +><P +> However some sites with content in different languages check the + <SPAN +CLASS="QUOTE" +>"Accept-Language:"</SPAN +> to decide which one to take by default. + Sometimes it isn't possible to later switch to another language without + changing the <SPAN +CLASS="QUOTE" +>"Accept-Language:"</SPAN +> header first. + </P +><P +> Therefore it's a good idea to either only change the + <SPAN +CLASS="QUOTE" +>"Accept-Language:"</SPAN +> header to languages you understand, + or to languages that aren't wide spread. + </P +><P +> Before setting the <SPAN +CLASS="QUOTE" +>"Accept-Language:"</SPAN +> header + to a rare language, you should consider that it helps to + make your requests unique and thus easier to trace. + If you don't plan to change this header frequently, + you should stick to a common language. + </P +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Pretend to use Canadian language settings. +{+hide-accept-language{en-ca} \ ++hide-user-agent{Mozilla/5.0 (X11; U; OpenBSD i386; en-CA; rv:1.8.0.4) Gecko/20060628 Firefox/1.5.0.4} \ +} +/ </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="HIDE-CONTENT-DISPOSITION" +>8.5.21. hide-content-disposition</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Prevent download menus for content you prefer to view inside the browser.</P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes or replaces the <SPAN +CLASS="QUOTE" +>"Content-Disposition:"</SPAN +> HTTP header set by some servers. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> Keyword: <SPAN +CLASS="QUOTE" +>"block"</SPAN +>, or any user defined value. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Some servers set the <SPAN +CLASS="QUOTE" +>"Content-Disposition:"</SPAN +> HTTP header for + documents they assume you want to save locally before viewing them. + The <SPAN +CLASS="QUOTE" +>"Content-Disposition:"</SPAN +> header contains the file name + the browser is supposed to use by default. + </P +><P +> In most browsers that understand this header, it makes it impossible to + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>just view</I +></SPAN +> the document, without downloading it first, + even if it's just a simple text file or an image. + </P +><P +> Removing the <SPAN +CLASS="QUOTE" +>"Content-Disposition:"</SPAN +> header helps + to prevent this annoyance, but some browsers additionally check the + <SPAN +CLASS="QUOTE" +>"Content-Type:"</SPAN +> header, before they decide if they can + display a document without saving it first. In these cases, you have + to change this header as well, before the browser stops displaying + download menus. + </P +><P +> It is also possible to change the server's file name suggestion + to another one, but in most cases it isn't worth the time to set + it up. + </P +><P +> This action will probably be removed in the future, + use server-header filters instead. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Disarm the download link in Sourceforge's patch tracker +{ -filter \ + +content-type-overwrite{text/plain}\ + +hide-content-disposition{block} } + .sourceforge.net/tracker/download.php</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="HIDE-IF-MODIFIED-SINCE" +>8.5.22. hide-if-modified-since</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Prevent yet another way to track the user's steps between sessions.</P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes the <SPAN +CLASS="QUOTE" +>"If-Modified-Since:"</SPAN +> HTTP client header or modifies its value. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> Keyword: <SPAN +CLASS="QUOTE" +>"block"</SPAN +>, or a user defined value that specifies a range of hours. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Removing this header is useful for filter testing, where you want to force a real + reload instead of getting status code <SPAN +CLASS="QUOTE" +>"304"</SPAN +>, which would cause the + browser to use a cached copy of the page. + </P +><P +> Instead of removing the header, <TT +CLASS="LITERAL" +>hide-if-modified-since</TT +> can + also add or subtract a random amount of time to/from the header's value. + You specify a range of minutes where the random factor should be chosen from and + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> does the rest. A negative value means + subtracting, a positive value adding. + </P +><P +> Randomizing the value of the <SPAN +CLASS="QUOTE" +>"If-Modified-Since:"</SPAN +> makes + it less likely that the server can use the time as a cookie replacement, + but you will run into caching problems if the random range is too high. + </P +><P +> It is a good idea to only use a small negative value and let + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#OVERWRITE-LAST-MODIFIED" +>overwrite-last-modified</A +></TT +> + handle the greater changes. + </P +><P +> It is also recommended to use this action together with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-IF-NONE-MATCH" +>crunch-if-none-match</A +></TT +>, + otherwise it's more or less pointless. + </P +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Let the browser revalidate but make tracking based on the time less likely. +{+hide-if-modified-since{-60} \ + +overwrite-last-modified{randomize} \ + +crunch-if-none-match} +/</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="HIDE-FROM-HEADER" +>8.5.23. hide-from-header</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Keep your (old and ill) browser from telling web servers your email address</P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes any existing <SPAN +CLASS="QUOTE" +>"From:"</SPAN +> HTTP header, or replaces it with the + specified string. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> Keyword: <SPAN +CLASS="QUOTE" +>"block"</SPAN +>, or any user defined value. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> The keyword <SPAN +CLASS="QUOTE" +>"block"</SPAN +> will completely remove the header + (not to be confused with the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> + action). + </P +><P +> Alternately, you can specify any value you prefer to be sent to the web + server. If you do, it is a matter of fairness not to use any address that + is actually used by a real person. + </P +><P +> This action is rarely needed, as modern web browsers don't send + <SPAN +CLASS="QUOTE" +>"From:"</SPAN +> headers anymore. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+hide-from-header{block}</PRE +></TD +></TR +></TABLE +> or + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+hide-from-header{spam-me-senseless@sittingduck.example.com}</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="HIDE-REFERRER" +>8.5.24. hide-referrer</A +></H4 +><A +NAME="HIDE-REFERER" +></A +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Conceal which link you followed to get to a particular site</P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes the <SPAN +CLASS="QUOTE" +>"Referer:"</SPAN +> (sic) HTTP header from the client request, + or replaces it with a forged one. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +></P +><UL +><LI +><P +><SPAN +CLASS="QUOTE" +>"conditional-block"</SPAN +> to delete the header completely if the host has changed.</P +></LI +><LI +><P +><SPAN +CLASS="QUOTE" +>"conditional-forge"</SPAN +> to forge the header if the host has changed.</P +></LI +><LI +><P +><SPAN +CLASS="QUOTE" +>"block"</SPAN +> to delete the header unconditionally.</P +></LI +><LI +><P +><SPAN +CLASS="QUOTE" +>"forge"</SPAN +> to pretend to be coming from the homepage of the server we are talking to.</P +></LI +><LI +><P +>Any other string to set a user defined referrer.</P +></LI +></UL +></DD +><DT +>Notes:</DT +><DD +><P +> <TT +CLASS="LITERAL" +>conditional-block</TT +> is the only parameter, + that isn't easily detected in the server's log file. If it blocks the + referrer, the request will look like the visitor used a bookmark or + typed in the address directly. + </P +><P +> Leaving the referrer unmodified for requests on the same host + allows the server owner to see the visitor's <SPAN +CLASS="QUOTE" +>"click path"</SPAN +>, + but in most cases she could also get that information by comparing + other parts of the log file: for example the User-Agent if it isn't + a very common one, or the user's IP address if it doesn't change between + different requests. + </P +><P +> Always blocking the referrer, or using a custom one, can lead to + failures on servers that check the referrer before they answer any + requests, in an attempt to prevent their content from being + embedded or linked to elsewhere. + </P +><P +> Both <TT +CLASS="LITERAL" +>conditional-block</TT +> and <TT +CLASS="LITERAL" +>forge</TT +> + will work with referrer checks, as long as content and valid referring page + are on the same host. Most of the time that's the case. + </P +><P +> + <TT +CLASS="LITERAL" +>hide-referer</TT +> is an alternate spelling of + <TT +CLASS="LITERAL" +>hide-referrer</TT +> and the two can be can be freely + substituted with each other. (<SPAN +CLASS="QUOTE" +>"referrer"</SPAN +> is the + correct English spelling, however the HTTP specification has a bug - it + requires it to be spelled as <SPAN +CLASS="QUOTE" +>"referer"</SPAN +>.) + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+hide-referrer{forge}</PRE +></TD +></TR +></TABLE +> or + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+hide-referrer{http://www.yahoo.com/%7D</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="HIDE-USER-AGENT" +>8.5.25. hide-user-agent</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Try to conceal your type of browser and client operating system</P +></DD +><DT +>Effect:</DT +><DD +><P +> Replaces the value of the <SPAN +CLASS="QUOTE" +>"User-Agent:"</SPAN +> HTTP header + in client requests with the specified value. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> Any user-defined string. + </P +></DD +><DT +>Notes:</DT +><DD +><DIV +CLASS="WARNING" +><P +></P +><TABLE +CLASS="WARNING" +BORDER="1" +WIDTH="90%" +><TR +><TD +ALIGN="CENTER" +><B +>Warning</B +></TD +></TR +><TR +><TD +ALIGN="LEFT" +><P +> This can lead to problems on web sites that depend on looking at this header in + order to customize their content for different browsers (which, by the + way, is <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>NOT</I +></SPAN +> the right thing to do: good web sites + work browser-independently). + </P +></TD +></TR +></TABLE +></DIV +><P +> Using this action in multi-user setups or wherever different types of + browsers will access the same <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not recommended</I +></SPAN +>. In single-user, single-browser + setups, you might use it to delete your OS version information from + the headers, because it is an invitation to exploit known bugs for your + OS. It is also occasionally useful to forge this in order to access + sites that won't let you in otherwise (though there may be a good + reason in some cases). Example of this: some MSN sites will not + let <SPAN +CLASS="APPLICATION" +>Mozilla</SPAN +> enter, yet forging to a + <SPAN +CLASS="APPLICATION" +>Netscape 6.1</SPAN +> user-agent works just fine. + (Must be just a silly MS goof, I'm sure :-). + </P +><P +> More information on known user-agent strings can be found at + <A +HREF="http://www.user-agents.org/" +TARGET="_top" +>http://www.user-agents.org/</A +> + and + <A +HREF="http://en.wikipedia.org/wiki/User_agent" +TARGET="_top" +>http://en.wikipedia.org/wiki/User_agent</A +>. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+hide-user-agent{Netscape 6.1 (X11; I; Linux 2.4.18 i686)}</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="LIMIT-CONNECT" +>8.5.26. limit-connect</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Prevent abuse of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> as a TCP proxy relay or disable SSL for untrusted sites</P +></DD +><DT +>Effect:</DT +><DD +><P +> Specifies to which ports HTTP CONNECT requests are allowable. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> A comma-separated list of ports or port ranges (the latter using dashes, with the minimum + defaulting to 0 and the maximum to 65K). + </P +></DD +><DT +>Notes:</DT +><DD +><P +> By default, i.e. if no <TT +CLASS="LITERAL" +>limit-connect</TT +> action applies, + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> allows HTTP CONNECT requests to all + ports. Use <TT +CLASS="LITERAL" +>limit-connect</TT +> if fine-grained control + is desired for some or all destinations. + </P +><P +> The CONNECT methods exists in HTTP to allow access to secure websites + (<SPAN +CLASS="QUOTE" +>"https://"</SPAN +> URLs) through proxies. It works very simply: + the proxy connects to the server on the specified port, and then + short-circuits its connections to the client and to the remote server. + This means CONNECT-enabled proxies can be used as TCP relays very easily. + </P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> relays HTTPS traffic without seeing + the decoded content. Websites can leverage this limitation to circumvent <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s + filters. By specifying an invalid port range you can disable HTTPS entirely. + </P +></DD +><DT +>Example usages:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+limit-connect{443} # Port 443 is OK. +limit-connect{80,443} # Ports 80 and 443 are OK. +limit-connect{-3, 7, 20-100, 500-} # Ports less than 3, 7, 20 to 100 and above 500 are OK. +limit-connect{-} # All ports are OK -+limit-connect{,} # No HTTPS/SSL traffic is allowed -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="PREVENT-COMPRESSION" id= - "PREVENT-COMPRESSION">8.5.27. prevent-compression</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Ensure that servers send the content uncompressed, so it can - be passed through <tt class="LITERAL"><a href= - "actions-file.html#FILTER">filter</a></tt>s.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Removes the Accept-Encoding header which can be used to ask - for compressed transfer.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Boolean.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>N/A</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>More and more websites send their content compressed by - default, which is generally a good idea and saves bandwidth. - But the <tt class="LITERAL"><a href= - "actions-file.html#FILTER">filter</a></tt> and <tt class= - "LITERAL"><a href= - "actions-file.html#DEANIMATE-GIFS">deanimate-gifs</a></tt> - actions need access to the uncompressed data.</p> - - <p>When compiled with zlib support (available since - <span class="APPLICATION">Privoxy</span> 3.0.7), content that - should be filtered is decompressed on-the-fly and you don't - have to worry about this action. If you are using an older - <span class="APPLICATION">Privoxy</span> version, or one that - hasn't been compiled with zlib support, this action can be used - to convince the server to send the content uncompressed.</p> - - <p>Most text-based instances compress very well, the size is - seldom decreased by less than 50%, for markup-heavy instances - like news feeds saving more than 90% of the original size isn't - unusual.</p> - - <p>Not using compression will therefore slow down the transfer, - and you should only enable this action if you really need it. - As of <span class="APPLICATION">Privoxy</span> 3.0.7 it's - disabled in all predefined action settings.</p> - - <p>Note that some (rare) ill-configured sites don't handle - requests for uncompressed documents correctly. Broken PHP - applications tend to send an empty document body, some IIS - versions only send the beginning of the content. If you enable - <tt class="LITERAL">prevent-compression</tt> per default, you - might want to add exceptions for those sites. See the example - for how to do that.</p> - </dd> - - <dt>Example usage (sections):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Selectively turn off compression, and enable a filter ++limit-connect{,} # No HTTPS/SSL traffic is allowed</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="PREVENT-COMPRESSION" +>8.5.27. prevent-compression</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +> Ensure that servers send the content uncompressed, so it can be + passed through <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FILTER" +>filter</A +></TT +>s. + </P +></DD +><DT +>Effect:</DT +><DD +><P +> Removes the Accept-Encoding header which can be used to ask for compressed transfer. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Boolean.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> N/A + </P +></DD +><DT +>Notes:</DT +><DD +><P +> More and more websites send their content compressed by default, which + is generally a good idea and saves bandwidth. But the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FILTER" +>filter</A +></TT +> and + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#DEANIMATE-GIFS" +>deanimate-gifs</A +></TT +> + actions need access to the uncompressed data. + </P +><P +> When compiled with zlib support (available since <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> 3.0.7), content that should be + filtered is decompressed on-the-fly and you don't have to worry about this action. + If you are using an older <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version, or one that hasn't been compiled with zlib + support, this action can be used to convince the server to send the content uncompressed. + </P +><P +> Most text-based instances compress very well, the size is seldom decreased by less than 50%, + for markup-heavy instances like news feeds saving more than 90% of the original size isn't + unusual. + </P +><P +> Not using compression will therefore slow down the transfer, and you should only + enable this action if you really need it. As of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> 3.0.7 it's disabled in all + predefined action settings. + </P +><P +> Note that some (rare) ill-configured sites don't handle requests for uncompressed + documents correctly. Broken PHP applications tend to send an empty document body, + some IIS versions only send the beginning of the content. If you enable + <TT +CLASS="LITERAL" +>prevent-compression</TT +> per default, you might want to add + exceptions for those sites. See the example for how to do that. + </P +></DD +><DT +>Example usage (sections):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Selectively turn off compression, and enable a filter # { +filter{tiny-textforms} +prevent-compression } # Match only these sites @@ -3640,653 +5741,1076 @@ nasty-banner-server.example.com/junk.cgi?output=trash # Then maybe make exceptions for broken sites: # { -prevent-compression } -.compusa.com/ -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="OVERWRITE-LAST-MODIFIED" id= - "OVERWRITE-LAST-MODIFIED">8.5.28. overwrite-last-modified</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Prevent yet another way to track the user's steps between - sessions.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes the <span class="QUOTE">"Last-Modified:"</span> HTTP - server header or modifies its value.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>One of the keywords: <span class="QUOTE">"block"</span>, - <span class="QUOTE">"reset-to-request-time"</span> and - <span class="QUOTE">"randomize"</span></p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Removing the <span class="QUOTE">"Last-Modified:"</span> - header is useful for filter testing, where you want to force a - real reload instead of getting status code <span class= - "QUOTE">"304"</span>, which would cause the browser to reuse - the old version of the page.</p> - - <p>The <span class="QUOTE">"randomize"</span> option overwrites - the value of the <span class="QUOTE">"Last-Modified:"</span> - header with a randomly chosen time between the original value - and the current time. In theory the server could send each - document with a different <span class= - "QUOTE">"Last-Modified:"</span> header to track visits without - using cookies. <span class="QUOTE">"Randomize"</span> makes it - impossible and the browser can still revalidate cached - documents.</p> - - <p><span class="QUOTE">"reset-to-request-time"</span> - overwrites the value of the <span class= - "QUOTE">"Last-Modified:"</span> header with the current time. - You could use this option together with <tt class= - "LITERAL"><a href= - "actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a></tt> - to further customize your random range.</p> - - <p>The preferred parameter here is <span class= - "QUOTE">"randomize"</span>. It is safe to use, as long as the - time settings are more or less correct. If the server sets the - <span class="QUOTE">"Last-Modified:"</span> header to the time - of the request, the random range becomes zero and the value - stays the same. Therefore you should later randomize it a - second time with <tt class="LITERAL"><a href= - "actions-file.html#HIDE-IF-MODIFIED-SINCE">hided-if-modified-since</a></tt>, - just to be sure.</p> - - <p>It is also recommended to use this action together with - <tt class="LITERAL"><a href= - "actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a></tt>.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Let the browser revalidate without being tracked across sessions +.compusa.com/</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="OVERWRITE-LAST-MODIFIED" +>8.5.28. overwrite-last-modified</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Prevent yet another way to track the user's steps between sessions.</P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes the <SPAN +CLASS="QUOTE" +>"Last-Modified:"</SPAN +> HTTP server header or modifies its value. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> One of the keywords: <SPAN +CLASS="QUOTE" +>"block"</SPAN +>, <SPAN +CLASS="QUOTE" +>"reset-to-request-time"</SPAN +> + and <SPAN +CLASS="QUOTE" +>"randomize"</SPAN +> + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Removing the <SPAN +CLASS="QUOTE" +>"Last-Modified:"</SPAN +> header is useful for filter + testing, where you want to force a real reload instead of getting status + code <SPAN +CLASS="QUOTE" +>"304"</SPAN +>, which would cause the browser to reuse the old + version of the page. + </P +><P +> The <SPAN +CLASS="QUOTE" +>"randomize"</SPAN +> option overwrites the value of the + <SPAN +CLASS="QUOTE" +>"Last-Modified:"</SPAN +> header with a randomly chosen time + between the original value and the current time. In theory the server + could send each document with a different <SPAN +CLASS="QUOTE" +>"Last-Modified:"</SPAN +> + header to track visits without using cookies. <SPAN +CLASS="QUOTE" +>"Randomize"</SPAN +> + makes it impossible and the browser can still revalidate cached documents. + </P +><P +> <SPAN +CLASS="QUOTE" +>"reset-to-request-time"</SPAN +> overwrites the value of the + <SPAN +CLASS="QUOTE" +>"Last-Modified:"</SPAN +> header with the current time. You could use + this option together with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE" +>hide-if-modified-since</A +></TT +> + to further customize your random range. + </P +><P +> The preferred parameter here is <SPAN +CLASS="QUOTE" +>"randomize"</SPAN +>. It is safe + to use, as long as the time settings are more or less correct. + If the server sets the <SPAN +CLASS="QUOTE" +>"Last-Modified:"</SPAN +> header to the time + of the request, the random range becomes zero and the value stays the same. + Therefore you should later randomize it a second time with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE" +>hided-if-modified-since</A +></TT +>, + just to be sure. + </P +><P +> It is also recommended to use this action together with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-IF-NONE-MATCH" +>crunch-if-none-match</A +></TT +>. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Let the browser revalidate without being tracked across sessions { +hide-if-modified-since{-60} \ +overwrite-last-modified{randomize} \ +crunch-if-none-match} -/ -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="REDIRECT" id="REDIRECT">8.5.29. - redirect</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Redirect requests to other sites.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Convinces the browser that the requested document has been - moved to another location and the browser should get it from - there.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>An absolute URL or a single pcrs command.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Requests to which this action applies are answered with a - HTTP redirect to URLs of your choosing. The new URL is either - provided as parameter, or derived by applying a single pcrs - command to the original URL.</p> - - <p>This action will be ignored if you use it together with - <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt>. It can be combined - with <tt class="LITERAL"><a href= - "actions-file.html#FAST-REDIRECTS">fast-redirects{check-decoded-url}</a></tt> - to redirect to a decoded version of a rewritten URL.</p> - - <p>Use this action carefully, make sure not to create - redirection loops and be aware that using your own redirects - might make it possible to fingerprint your requests.</p> - - <p>In case of problems with your redirects, or simply to watch - them working, enable <a href="config.html#DEBUG">debug - 128</a>.</p> - </dd> - - <dt>Example usages:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Replace example.com's style sheet with another one +/</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="REDIRECT" +>8.5.29. redirect</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +> Redirect requests to other sites. + </P +></DD +><DT +>Effect:</DT +><DD +><P +> Convinces the browser that the requested document has been moved + to another location and the browser should get it from there. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized</P +></DD +><DT +>Parameter:</DT +><DD +><P +> An absolute URL or a single pcrs command. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Requests to which this action applies are answered with a + HTTP redirect to URLs of your choosing. The new URL is + either provided as parameter, or derived by applying a + single pcrs command to the original URL. + </P +><P +> This action will be ignored if you use it together with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +>. + It can be combined with + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FAST-REDIRECTS" +>fast-redirects{check-decoded-url}</A +></TT +> + to redirect to a decoded version of a rewritten URL. + </P +><P +> Use this action carefully, make sure not to create redirection loops + and be aware that using your own redirects might make it + possible to fingerprint your requests. + </P +><P +> In case of problems with your redirects, or simply to watch + them working, enable <A +HREF="config.html#DEBUG" +>debug 128</A +>. + </P +></DD +><DT +>Example usages:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Replace example.com's style sheet with another one { +redirect{http://localhost/css-replacements/example.com.css%7D } example.com/stylesheet.css
# Create a short, easy to remember nickname for a favorite site -# (relies on the browser accept and forward invalid URLs to <span class= -"APPLICATION">Privoxy</span>) +# (relies on the browser accept and forward invalid URLs to <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>) { +redirect{http://www.privoxy.org/user-manual/actions-file.html%7D } a
# Always use the expanded view for Undeadly.org articles # (Note the $ at the end of the URL pattern to make sure # the request for the rewritten URL isn't redirected as well) -{+redirect{s@$@&mode=expanded@}} -undeadly.org/cgi?action=article&sid=\d*$ +{+redirect{s@$@&mode=expanded@}} +undeadly.org/cgi?action=article&sid=\d*$
# Redirect Google search requests to MSN -{+redirect{s@^http://%5B%5E/%5D*/search%5C?q=(%5B%5E&%5D*).*@http://search.msn.com/res... +{+redirect{s@^http://%5B%5E/%5D*/search%5C?q=(%5B%5E&%5D*).*@http://search.msn.com/res... .google.com/search
# Redirect MSN search requests to Yahoo -{+redirect{s@^http://%5B%5E/%5D*/results%5C.aspx%5C?q=(%5B%5E&%5D*).*@http://search.ya... +{+redirect{s@^http://%5B%5E/%5D*/results%5C.aspx%5C?q=(%5B%5E&%5D*).*@http://search.ya... search.msn.com//results.aspx?q=
# Redirect remote requests for this manual # to the local version delivered by Privoxy {+redirect{s@^http://www@http://config@%7D%7D -www.privoxy.org/user-manual/ -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="SERVER-HEADER-FILTER" id= - "SERVER-HEADER-FILTER">8.5.30. server-header-filter</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Rewrite or remove single server headers.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>All server headers to which this action applies are filtered - on-the-fly through the specified regular expression based - substitutions.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>The name of a server-header filter, as defined in one of the - <a href="filter-file.html">filter files</a>.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Server-header filters are applied to each header on its own, - not to all at once. This makes it easier to diagnose problems, - but on the downside you can't write filters that only change - header x if header y's value is z. You can do that by using - tags though.</p> - - <p>Server-header filters are executed after the other header - actions have finished and use their output as input.</p> - - <p>Please refer to the <a href="filter-file.html">filter file - chapter</a> to learn which server-header filters are available - by default, and how to create your own.</p> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -{+server-header-filter{html-to-xml}} +www.privoxy.org/user-manual/</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="SERVER-HEADER-FILTER" +>8.5.30. server-header-filter</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +> Rewrite or remove single server headers. + </P +></DD +><DT +>Effect:</DT +><DD +><P +> All server headers to which this action applies are filtered on-the-fly + through the specified regular expression based substitutions. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> The name of a server-header filter, as defined in one of the + <A +HREF="filter-file.html" +>filter files</A +>. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Server-header filters are applied to each header on its own, not to + all at once. This makes it easier to diagnose problems, but on the downside + you can't write filters that only change header x if header y's value is z. + You can do that by using tags though. + </P +><P +> Server-header filters are executed after the other header actions have finished + and use their output as input. + </P +><P +> Please refer to the <A +HREF="filter-file.html" +>filter file chapter</A +> + to learn which server-header filters are available by default, and how to + create your own. + </P +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{+server-header-filter{html-to-xml}} example.org/xml-instance-that-is-delivered-as-html
{+server-header-filter{xml-to-html}} example.org/instance-that-is-delivered-as-xml-but-is-not - -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="SERVER-HEADER-TAGGER" id= - "SERVER-HEADER-TAGGER">8.5.31. server-header-tagger</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Enable or disable filters based on the Content-Type - header.</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Server headers to which this action applies are filtered - on-the-fly through the specified regular expression based - substitutions, the result is used as tag.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>The name of a server-header tagger, as defined in one of the - <a href="filter-file.html">filter files</a>.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Server-header taggers are applied to each header on its own, - and as the header isn't modified, each tagger <span class= - "QUOTE">"sees"</span> the original.</p> - - <p>Server-header taggers are executed before all other header - actions that modify server headers. Their tags can be used to - control all of the other server-header actions, the content - filters and the crunch actions (<a href= - "actions-file.html#REDIRECT">redirect</a> and <a href= - "actions-file.html#BLOCK">block</a>).</p> - - <p>Obviously crunching based on tags created by server-header - taggers doesn't prevent the request from showing up in the - server's log file.</p> - </dd> - - <dt>Example usage (section):</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -# Tag every request with the content type declared by the server + </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="SERVER-HEADER-TAGGER" +>8.5.31. server-header-tagger</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +> Enable or disable filters based on the Content-Type header. + </P +></DD +><DT +>Effect:</DT +><DD +><P +> Server headers to which this action applies are filtered on-the-fly through + the specified regular expression based substitutions, the result is used as + tag. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> The name of a server-header tagger, as defined in one of the + <A +HREF="filter-file.html" +>filter files</A +>. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Server-header taggers are applied to each header on its own, + and as the header isn't modified, each tagger <SPAN +CLASS="QUOTE" +>"sees"</SPAN +> + the original. + </P +><P +> Server-header taggers are executed before all other header actions + that modify server headers. Their tags can be used to control + all of the other server-header actions, the content filters + and the crunch actions (<A +HREF="actions-file.html#REDIRECT" +>redirect</A +> + and <A +HREF="actions-file.html#BLOCK" +>block</A +>). + </P +><P +> Obviously crunching based on tags created by server-header taggers + doesn't prevent the request from showing up in the server's log file. + </P +></DD +><DT +>Example usage (section):</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Tag every request with the content type declared by the server {+server-header-tagger{content-type}} / - -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="SESSION-COOKIES-ONLY" id= - "SESSION-COOKIES-ONLY">8.5.32. session-cookies-only</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Allow only temporary <span class="QUOTE">"session"</span> - cookies (for the current browser session <span class= - "emphasis EMPHASIS c2">only</span>).</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>Deletes the <span class="QUOTE">"expires"</span> field from - <span class="QUOTE">"Set-Cookie:"</span> server headers. Most - browsers will not store such cookies permanently and forget - them in between sessions.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Boolean.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <p>N/A</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This is less strict than <tt class="LITERAL"><a href= - "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></tt> - / <tt class="LITERAL"><a href= - "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></tt> - and allows you to browse websites that insist or rely on - setting cookies, without compromising your privacy too - badly.</p> - - <p>Most browsers will not permanently store cookies that have - been processed by <tt class="LITERAL">session-cookies-only</tt> - and will forget about them between sessions. This makes - profiling cookies useless, but won't break sites which require - cookies so that you can log in for transactions. This is - generally turned on for all sites, and is the recommended - setting.</p> - - <p>It makes <span class="emphasis EMPHASIS c2">no sense at - all</span> to use <tt class="LITERAL">session-cookies-only</tt> - together with <tt class="LITERAL"><a href= - "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></tt> - or <tt class="LITERAL"><a href= - "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></tt>. - If you do, cookies will be plainly killed.</p> - - <p>Note that it is up to the browser how it handles such - cookies without an <span class="QUOTE">"expires"</span> field. - If you use an exotic browser, you might want to try it out to - be sure.</p> - - <p>This setting also has no effect on cookies that may have - been stored previously by the browser before starting - <span class="APPLICATION">Privoxy</span>. These would have to - be removed manually.</p> - - <p><span class="APPLICATION">Privoxy</span> also uses the - <a href= - "actions-file.html#FILTER-CONTENT-COOKIES">content-cookies - filter</a> to block some types of cookies. Content cookies are - not effected by <tt class= - "LITERAL">session-cookies-only</tt>.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+session-cookies-only -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="SET-IMAGE-BLOCKER" id= - "SET-IMAGE-BLOCKER">8.5.33. set-image-blocker</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Typical use:</dt> - - <dd> - <p>Choose the replacement for blocked images</p> - </dd> - - <dt>Effect:</dt> - - <dd> - <p>This action alone doesn't do anything noticeable. If - <span class="emphasis EMPHASIS c2">both</span> <tt class= - "LITERAL"><a href="actions-file.html#BLOCK">block</a></tt> - <span class="emphasis EMPHASIS c2">and</span> <tt class= - "LITERAL"><a href= - "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt> - <span class="emphasis EMPHASIS c2">also</span> apply, i.e. if - the request is to be blocked as an image, <span class= - "emphasis EMPHASIS c2">then</span> the parameter of this action - decides what will be sent as a replacement.</p> - </dd> - - <dt>Type:</dt> - - <dd> - <p>Parameterized.</p> - </dd> - - <dt>Parameter:</dt> - - <dd> - <ul> - <li> - <p><span class="QUOTE">"pattern"</span> to send a built-in - checkerboard pattern image. The image is visually decent, - scales very well, and makes it obvious where banners were - busted.</p> - </li> - - <li> - <p><span class="QUOTE">"blank"</span> to send a built-in - transparent image. This makes banners disappear completely, - but makes it hard to detect where <span class= - "APPLICATION">Privoxy</span> has blocked images on a given - page and complicates troubleshooting if <span class= - "APPLICATION">Privoxy</span> has blocked innocent images, - like navigation icons.</p> - </li> - - <li> - <p><span class="QUOTE">"<tt class= - "REPLACEABLE c5">target-url</tt>"</span> to send a redirect - to <tt class="REPLACEABLE c5">target-url</tt>. You can - redirect to any image anywhere, even in your local - filesystem via <span class="QUOTE">"file:///"</span> URL. - (But note that not all browsers support redirecting to a - local file system).</p> - - <p>A good application of redirects is to use special - <span class="APPLICATION">Privoxy</span>-built-in URLs, - which send the built-in images, as <tt class= - "REPLACEABLE c5">target-url</tt>. This has the same visual - effect as specifying <span class="QUOTE">"blank"</span> or - <span class="QUOTE">"pattern"</span> in the first place, - but enables your browser to cache the replacement image, - instead of requesting it over and over again.</p> - </li> - </ul> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>The URLs for the built-in images are <span class= - "QUOTE">"http://config.privoxy.org/send-banner?type=<tt class= - "REPLACEABLE c5">type</tt>"</span>, where <tt class= - "REPLACEABLE c5">type</tt> is either <span class= - "QUOTE">"blank"</span> or <span class= - "QUOTE">"pattern"</span>.</p> - - <p>There is a third (advanced) type, called <span class= - "QUOTE">"auto"</span>. It is <span class= - "emphasis EMPHASIS c2">NOT</span> to be used in <tt class= - "LITERAL">set-image-blocker</tt>, but meant for use from - <a href="filter-file.html">filters</a>. Auto will select the - type of image that would have applied to the referring page, - had it been an image.</p> - </dd> - - <dt>Example usage:</dt> - - <dd> - <p>Built-in pattern:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+set-image-blocker{pattern} -</pre> - </td> - </tr> - </table> - - <p>Redirect to the BSD daemon:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+set-image-blocker{http://www.freebsd.org/gifs/dae_up3.gif%7D -</pre> - </td> - </tr> - </table> - - <p>Redirect to the built-in pattern for better caching:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> -+set-image-blocker{http://config.privoxy.org/send-banner?type=pattern%7D -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4706" id="AEN4706">8.5.34. - Summary</a></h3> - - <p>Note that many of these actions have the potential to cause a page - to misbehave, possibly even not to display at all. There are many - ways a site designer may choose to design his site, and what HTTP - header content, and other criteria, he may depend on. There is no way - to have hard and fast rules for all sites. See the <a href= - "appendix.html#ACTIONSANAT">Appendix</a> for a brief example on - troubleshooting actions.</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="ALIASES" id="ALIASES">8.6. Aliases</a></h2> - - <p>Custom <span class="QUOTE">"actions"</span>, known to <span class= - "APPLICATION">Privoxy</span> as <span class="QUOTE">"aliases"</span>, - can be defined by combining other actions. These can in turn be invoked - just like the built-in actions. Currently, an alias name can contain - any character except space, tab, <span class="QUOTE">"="</span>, - <span class="QUOTE">"{"</span> and <span class="QUOTE">"}"</span>, but - we <span class="emphasis EMPHASIS c2">strongly recommend</span> that - you only use <span class="QUOTE">"a"</span> to <span class= - "QUOTE">"z"</span>, <span class="QUOTE">"0"</span> to <span class= - "QUOTE">"9"</span>, <span class="QUOTE">"+"</span>, and <span class= - "QUOTE">"-"</span>. Alias names are not case sensitive, and are not - required to start with a <span class="QUOTE">"+"</span> or <span class= - "QUOTE">"-"</span> sign, since they are merely textually expanded.</p> - - <p>Aliases can be used throughout the actions file, but they - <span class="emphasis EMPHASIS c2">must be defined in a special section - at the top of the file!</span> And there can only be one such section - per actions file. Each actions file may have its own alias section, and - the aliases defined in it are only visible within that file.</p> - - <p>There are two main reasons to use aliases: One is to save typing for - frequently used combinations of actions, the other one is a gain in - flexibility: If you decide once how you want to handle shops by - defining an alias called <span class="QUOTE">"shop"</span>, you can - later change your policy on shops in <span class= - "emphasis EMPHASIS c2">one</span> place, and your changes will take - effect everywhere in the actions file where the <span class= - "QUOTE">"shop"</span> alias is used. Calling aliases by their purpose - also makes your actions files more readable.</p> - - <p>Currently, there is one big drawback to using aliases, though: - <span class="APPLICATION">Privoxy</span>'s built-in web-based action - file editor honors aliases when reading the actions files, but it - expands them before writing. So the effects of your aliases are of - course preserved, but the aliases themselves are lost when you edit - sections that use aliases with it.</p> - - <p>Now let's define some aliases...</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - # Useful custom aliases we can use later. + </PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="SESSION-COOKIES-ONLY" +>8.5.32. session-cookies-only</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +> Allow only temporary <SPAN +CLASS="QUOTE" +>"session"</SPAN +> cookies (for the current + browser session <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>only</I +></SPAN +>). + </P +></DD +><DT +>Effect:</DT +><DD +><P +> Deletes the <SPAN +CLASS="QUOTE" +>"expires"</SPAN +> field from <SPAN +CLASS="QUOTE" +>"Set-Cookie:"</SPAN +> + server headers. Most browsers will not store such cookies permanently and + forget them in between sessions. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Boolean.</P +></DD +><DT +>Parameter:</DT +><DD +><P +> N/A + </P +></DD +><DT +>Notes:</DT +><DD +><P +> This is less strict than <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +>crunch-incoming-cookies</A +></TT +> / + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES" +>crunch-outgoing-cookies</A +></TT +> and allows you to browse + websites that insist or rely on setting cookies, without compromising your privacy too badly. + </P +><P +> Most browsers will not permanently store cookies that have been processed by + <TT +CLASS="LITERAL" +>session-cookies-only</TT +> and will forget about them between sessions. + This makes profiling cookies useless, but won't break sites which require cookies so + that you can log in for transactions. This is generally turned on for all + sites, and is the recommended setting. + </P +><P +> It makes <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>no sense at all</I +></SPAN +> to use <TT +CLASS="LITERAL" +>session-cookies-only</TT +> + together with <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +>crunch-incoming-cookies</A +></TT +> or + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES" +>crunch-outgoing-cookies</A +></TT +>. If you do, cookies + will be plainly killed. + </P +><P +> Note that it is up to the browser how it handles such cookies without an <SPAN +CLASS="QUOTE" +>"expires"</SPAN +> + field. If you use an exotic browser, you might want to try it out to be sure. + </P +><P +> This setting also has no effect on cookies that may have been stored + previously by the browser before starting <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + These would have to be removed manually. + </P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> also uses + the <A +HREF="actions-file.html#FILTER-CONTENT-COOKIES" +>content-cookies filter</A +> + to block some types of cookies. Content cookies are not effected by + <TT +CLASS="LITERAL" +>session-cookies-only</TT +>. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+session-cookies-only</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="SET-IMAGE-BLOCKER" +>8.5.33. set-image-blocker</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Typical use:</DT +><DD +><P +>Choose the replacement for blocked images</P +></DD +><DT +>Effect:</DT +><DD +><P +> This action alone doesn't do anything noticeable. If <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>both</I +></SPAN +> + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>and</I +></SPAN +> <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +></TT +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>also</I +></SPAN +> + apply, i.e. if the request is to be blocked as an image, + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>then</I +></SPAN +> the parameter of this action decides what will be + sent as a replacement. + </P +></DD +><DT +>Type:</DT +><DD +><P +>Parameterized.</P +></DD +><DT +>Parameter:</DT +><DD +><P +></P +><UL +><LI +><P +> <SPAN +CLASS="QUOTE" +>"pattern"</SPAN +> to send a built-in checkerboard pattern image. The image is visually + decent, scales very well, and makes it obvious where banners were busted. + </P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"blank"</SPAN +> to send a built-in transparent image. This makes banners disappear + completely, but makes it hard to detect where <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> has blocked + images on a given page and complicates troubleshooting if <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + has blocked innocent images, like navigation icons. + </P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"<TT +CLASS="REPLACEABLE" +><I +>target-url</I +></TT +>"</SPAN +> to + send a redirect to <TT +CLASS="REPLACEABLE" +><I +>target-url</I +></TT +>. You can redirect + to any image anywhere, even in your local filesystem via <SPAN +CLASS="QUOTE" +>"file:///"</SPAN +> URL. + (But note that not all browsers support redirecting to a local file system). + </P +><P +> A good application of redirects is to use special <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>-built-in + URLs, which send the built-in images, as <TT +CLASS="REPLACEABLE" +><I +>target-url</I +></TT +>. + This has the same visual effect as specifying <SPAN +CLASS="QUOTE" +>"blank"</SPAN +> or <SPAN +CLASS="QUOTE" +>"pattern"</SPAN +> in + the first place, but enables your browser to cache the replacement image, instead of requesting + it over and over again. + </P +></LI +></UL +></DD +><DT +>Notes:</DT +><DD +><P +> The URLs for the built-in images are <SPAN +CLASS="QUOTE" +>"http://config.privoxy.org/send-banner?type=<TT +CLASS="REPLACEABLE" +><I +>type</I +></TT +>"</SPAN +>, where <TT +CLASS="REPLACEABLE" +><I +>type</I +></TT +> is + either <SPAN +CLASS="QUOTE" +>"blank"</SPAN +> or <SPAN +CLASS="QUOTE" +>"pattern"</SPAN +>. + </P +><P +> There is a third (advanced) type, called <SPAN +CLASS="QUOTE" +>"auto"</SPAN +>. It is <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>NOT</I +></SPAN +> to be + used in <TT +CLASS="LITERAL" +>set-image-blocker</TT +>, but meant for use from <A +HREF="filter-file.html" +>filters</A +>. + Auto will select the type of image that would have applied to the referring page, had it been an image. + </P +></DD +><DT +>Example usage:</DT +><DD +><P +> Built-in pattern: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+set-image-blocker{pattern}</PRE +></TD +></TR +></TABLE +> + </P +><P +> Redirect to the BSD daemon: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+set-image-blocker{http://www.freebsd.org/gifs/dae_up3.gif%7D</PRE +></TD +></TR +></TABLE +> + </P +><P +> Redirect to the built-in pattern for better caching: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +>+set-image-blocker{http://config.privoxy.org/send-banner?type=pattern%7D</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="AEN4093" +>8.5.34. Summary</A +></H3 +><P +> Note that many of these actions have the potential to cause a page to + misbehave, possibly even not to display at all. There are many ways + a site designer may choose to design his site, and what HTTP header + content, and other criteria, he may depend on. There is no way to have hard + and fast rules for all sites. See the <A +HREF="appendix.html#ACTIONSANAT" +>Appendix</A +> for a brief example on troubleshooting + actions.</P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="ALIASES" +>8.6. Aliases</A +></H2 +><P +> Custom <SPAN +CLASS="QUOTE" +>"actions"</SPAN +>, known to <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + as <SPAN +CLASS="QUOTE" +>"aliases"</SPAN +>, can be defined by combining other actions. + These can in turn be invoked just like the built-in actions. + Currently, an alias name can contain any character except space, tab, + <SPAN +CLASS="QUOTE" +>"="</SPAN +>, + <SPAN +CLASS="QUOTE" +>"{"</SPAN +> and <SPAN +CLASS="QUOTE" +>"}"</SPAN +>, but we <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>strongly + recommend</I +></SPAN +> that you only use <SPAN +CLASS="QUOTE" +>"a"</SPAN +> to <SPAN +CLASS="QUOTE" +>"z"</SPAN +>, + <SPAN +CLASS="QUOTE" +>"0"</SPAN +> to <SPAN +CLASS="QUOTE" +>"9"</SPAN +>, <SPAN +CLASS="QUOTE" +>"+"</SPAN +>, and <SPAN +CLASS="QUOTE" +>"-"</SPAN +>. + Alias names are not case sensitive, and are not required to start with a + <SPAN +CLASS="QUOTE" +>"+"</SPAN +> or <SPAN +CLASS="QUOTE" +>"-"</SPAN +> sign, since they are merely textually + expanded.</P +><P +> Aliases can be used throughout the actions file, but they <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>must be + defined in a special section at the top of the file!</I +></SPAN +> + And there can only be one such section per actions file. Each actions file may + have its own alias section, and the aliases defined in it are only visible + within that file.</P +><P +> There are two main reasons to use aliases: One is to save typing for frequently + used combinations of actions, the other one is a gain in flexibility: If you + decide once how you want to handle shops by defining an alias called + <SPAN +CLASS="QUOTE" +>"shop"</SPAN +>, you can later change your policy on shops in + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>one</I +></SPAN +> place, and your changes will take effect everywhere + in the actions file where the <SPAN +CLASS="QUOTE" +>"shop"</SPAN +> alias is used. Calling aliases + by their purpose also makes your actions files more readable.</P +><P +> Currently, there is one big drawback to using aliases, though: + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s built-in web-based action file + editor honors aliases when reading the actions files, but it expands + them before writing. So the effects of your aliases are of course preserved, + but the aliases themselves are lost when you edit sections that use aliases + with it.</P +><P +> Now let's define some aliases...</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> # Useful custom aliases we can use later. # # Note the (required!) section header line and that this section # must be at the top of the actions file! @@ -4296,46 +6820,79 @@ example.org/instance-that-is-delivered-as-xml-but-is-not # These aliases just save typing later: # (Note that some already use other aliases!) # - +crunch-all-cookies = +<a href= -"actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a> +<a href="actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a> - -crunch-all-cookies = -<a href= -"actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a> -<a href="actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a> + +crunch-all-cookies = +<A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +>crunch-incoming-cookies</A +> +<A +HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES" +>crunch-outgoing-cookies</A +> + -crunch-all-cookies = -<A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +>crunch-incoming-cookies</A +> -<A +HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES" +>crunch-outgoing-cookies</A +> +block-as-image = +block{Blocked image.} +handle-as-image - allow-all-cookies = -crunch-all-cookies -<a href= -"actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a> -<a href= -"actions-file.html#FILTER-CONTENT-COOKIES">filter{content-cookies}</a> + allow-all-cookies = -crunch-all-cookies -<A +HREF="actions-file.html#SESSION-COOKIES-ONLY" +>session-cookies-only</A +> -<A +HREF="actions-file.html#FILTER-CONTENT-COOKIES" +>filter{content-cookies}</A +>
# These aliases define combinations of actions # that are useful for certain types of sites: # - fragile = -<a href="actions-file.html#BLOCK">block</a> -<a href= -"actions-file.html#FILTER">filter</a> -crunch-all-cookies -<a href= -"actions-file.html#FAST-REDIRECTS">fast-redirects</a> -<a href= -"actions-file.html#HIDE-REFERER">hide-referrer</a> -<a href= -"actions-file.html#PREVENT-COMPRESSION">prevent-compression</a> - - shop = -crunch-all-cookies -<a href= -"actions-file.html#FILTER-ALL-POPUPS">filter{all-popups}</a> + fragile = -<A +HREF="actions-file.html#BLOCK" +>block</A +> -<A +HREF="actions-file.html#FILTER" +>filter</A +> -crunch-all-cookies -<A +HREF="actions-file.html#FAST-REDIRECTS" +>fast-redirects</A +> -<A +HREF="actions-file.html#HIDE-REFERER" +>hide-referrer</A +> -<A +HREF="actions-file.html#PREVENT-COMPRESSION" +>prevent-compression</A +> + + shop = -crunch-all-cookies -<A +HREF="actions-file.html#FILTER-ALL-POPUPS" +>filter{all-popups}</A +>
# Short names for other aliases, for really lazy people ;-) # c0 = +crunch-all-cookies - c1 = -crunch-all-cookies -</pre> - </td> - </tr> - </table> - - <p>...and put them to use. These sections would appear in the lower - part of an actions file and define exceptions to the default actions - (as specified further up for the <span class="QUOTE">"/"</span> - pattern):</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - # These sites are either very complex or very keen on + c1 = -crunch-all-cookies</PRE +></TD +></TR +></TABLE +></P +><P +> ...and put them to use. These sections would appear in the lower part of an + actions file and define exceptions to the default actions (as specified further + up for the <SPAN +CLASS="QUOTE" +>"/"</SPAN +> pattern):</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> # These sites are either very complex or very keen on # user data and require minimal interference to work: # {fragile} @@ -4346,7 +6903,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not
# Shopping sites: # Allow cookies (for setting and retrieving your customer data) - # + # {shop} .quietpc.com .worldpay.com # for quietpc.com @@ -4356,123 +6913,234 @@ example.org/instance-that-is-delivered-as-xml-but-is-not # {-filter{all-popups} -filter{unsolicited-popups}} .dabs.com - .overclockers.co.uk -</pre> - </td> - </tr> - </table> - - <p>Aliases like <span class="QUOTE">"shop"</span> and <span class= - "QUOTE">"fragile"</span> are typically used for <span class= - "QUOTE">"problem"</span> sites that require more than one action to be - disabled in order to function properly.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="ACT-EXAMPLES" id="ACT-EXAMPLES">8.7. Actions - Files Tutorial</a></h2> - - <p>The above chapters have shown <a href="actions-file.html">which - actions files there are and how they are organized</a>, how actions are - <a href="actions-file.html#ACTIONS">specified</a> and <a href= - "actions-file.html#ACTIONS-APPLY">applied to URLs</a>, how <a href= - "actions-file.html#AF-PATTERNS">patterns</a> work, and how to define - and use <a href="actions-file.html#ALIASES">aliases</a>. Now, let's - look at an example <tt class="FILENAME">match-all.action</tt>, - <tt class="FILENAME">default.action</tt> and <tt class= - "FILENAME">user.action</tt> file and see how all these pieces come - together:</p> - - <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4770" id="AEN4770">8.7.1. - match-all.action</a></h3> - - <p>Remember <span class="emphasis EMPHASIS c2">all actions are - disabled when matching starts</span>, so we have to explicitly enable - the ones we want.</p> - - <p>While the <tt class="FILENAME">match-all.action</tt> file only - contains a single section, it is probably the most important one. It - has only one pattern, <span class="QUOTE">"<tt class= - "LITERAL">/</tt>"</span>, but this pattern <a href= - "actions-file.html#AF-PATTERNS">matches all URLs</a>. Therefore, the - set of actions used in this <span class="QUOTE">"default"</span> - section <span class="emphasis EMPHASIS c2">will be applied to all - requests as a start</span>. It can be partly or wholly overridden by - other actions files like <tt class="FILENAME">default.action</tt> and - <tt class="FILENAME">user.action</tt>, but it will still be largely - responsible for your overall browsing experience.</p> - - <p>Again, at the start of matching, all actions are disabled, so - there is no need to disable any actions here. (Remember: a - <span class="QUOTE">"+"</span> preceding the action name enables the - action, a <span class="QUOTE">"-"</span> disables!). Also note how - this long line has been made more readable by splitting it into - multiple lines with line continuation.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ \ - +<a href= -"actions-file.html#CHANGE-X-FORWARDED-FOR">change-x-forwarded-for{block}</a> \ - +<a href="actions-file.html#HIDE-FROM-HEADER">hide-from-header{block}</a> \ - +<a href= -"actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker{pattern}</a> \ + .overclockers.co.uk</PRE +></TD +></TR +></TABLE +></P +><P +> Aliases like <SPAN +CLASS="QUOTE" +>"shop"</SPAN +> and <SPAN +CLASS="QUOTE" +>"fragile"</SPAN +> are typically used for + <SPAN +CLASS="QUOTE" +>"problem"</SPAN +> sites that require more than one action to be disabled + in order to function properly.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="ACT-EXAMPLES" +>8.7. Actions Files Tutorial</A +></H2 +><P +> The above chapters have shown <A +HREF="actions-file.html" +>which actions files + there are and how they are organized</A +>, how actions are <A +HREF="actions-file.html#ACTIONS" +>specified</A +> and <A +HREF="actions-file.html#ACTIONS-APPLY" +>applied + to URLs</A +>, how <A +HREF="actions-file.html#AF-PATTERNS" +>patterns</A +> work, and how to + define and use <A +HREF="actions-file.html#ALIASES" +>aliases</A +>. Now, let's look at an + example <TT +CLASS="FILENAME" +>match-all.action</TT +>, <TT +CLASS="FILENAME" +>default.action</TT +> + and <TT +CLASS="FILENAME" +>user.action</TT +> file and see how all these pieces come together:</P +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="AEN4157" +>8.7.1. match-all.action</A +></H3 +><P +> Remember <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all actions are disabled when matching starts</I +></SPAN +>, + so we have to explicitly enable the ones we want.</P +><P +> While the <TT +CLASS="FILENAME" +>match-all.action</TT +> file only contains a + single section, it is probably the most important one. It has only one + pattern, <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +>/</TT +>"</SPAN +>, but this pattern + <A +HREF="actions-file.html#AF-PATTERNS" +>matches all URLs</A +>. Therefore, the set of + actions used in this <SPAN +CLASS="QUOTE" +>"default"</SPAN +> section <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>will + be applied to all requests as a start</I +></SPAN +>. It can be partly or + wholly overridden by other actions files like <TT +CLASS="FILENAME" +>default.action</TT +> + and <TT +CLASS="FILENAME" +>user.action</TT +>, but it will still be largely responsible + for your overall browsing experience.</P +><P +> Again, at the start of matching, all actions are disabled, so there is + no need to disable any actions here. (Remember: a <SPAN +CLASS="QUOTE" +>"+"</SPAN +> + preceding the action name enables the action, a <SPAN +CLASS="QUOTE" +>"-"</SPAN +> disables!). + Also note how this long line has been made more readable by splitting it into + multiple lines with line continuation.</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ \ + +<A +HREF="actions-file.html#CHANGE-X-FORWARDED-FOR" +>change-x-forwarded-for{block}</A +> \ + +<A +HREF="actions-file.html#HIDE-FROM-HEADER" +>hide-from-header{block}</A +> \ + +<A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker{pattern}</A +> \ } / # Match all URLs - -</pre> - </td> - </tr> - </table> - - <p>The default behavior is now set.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4792" id="AEN4792">8.7.2. - default.action</a></h3> - - <p>If you aren't a developer, there's no need for you to edit the - <tt class="FILENAME">default.action</tt> file. It is maintained by - the <span class="APPLICATION">Privoxy</span> developers and if you - disagree with some of the sections, you should overrule them in your - <tt class="FILENAME">user.action</tt>.</p> - - <p>Understanding the <tt class="FILENAME">default.action</tt> file - can help you with your <tt class="FILENAME">user.action</tt>, - though.</p> - - <p>The first section in this file is a special section for internal - use that prevents older <span class="APPLICATION">Privoxy</span> - versions from reading the file:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -########################################################################## + </PRE +></TD +></TR +></TABLE +></P +><P +> The default behavior is now set.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="AEN4179" +>8.7.2. default.action</A +></H3 +><P +> If you aren't a developer, there's no need for you to edit the + <TT +CLASS="FILENAME" +>default.action</TT +> file. It is maintained by + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developers and if you disagree with some of the + sections, you should overrule them in your <TT +CLASS="FILENAME" +>user.action</TT +>.</P +><P +> Understanding the <TT +CLASS="FILENAME" +>default.action</TT +> file can + help you with your <TT +CLASS="FILENAME" +>user.action</TT +>, though.</P +><P +> The first section in this file is a special section for internal use + that prevents older <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> versions from reading the file:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>########################################################################## # Settings -- Don't change! For internal Privoxy use ONLY. ########################################################################## {{settings}} -for-privoxy-version=3.0.11 -</pre> - </td> - </tr> - </table> - - <p>After that comes the (optional) alias section. We'll use the - example section from the above <a href= - "actions-file.html#ALIASES">chapter on aliases</a>, that also - explains why and how aliases are used:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -########################################################################## +for-privoxy-version=3.0.11</PRE +></TD +></TR +></TABLE +></P +><P +> After that comes the (optional) alias section. We'll use the example + section from the above <A +HREF="actions-file.html#ALIASES" +>chapter on aliases</A +>, + that also explains why and how aliases are used:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>########################################################################## # Aliases ########################################################################## {{alias}} @@ -4480,42 +7148,76 @@ for-privoxy-version=3.0.11 # These aliases just save typing later: # (Note that some already use other aliases!) # - +crunch-all-cookies = +<a href= -"actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a> +<a href="actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a> - -crunch-all-cookies = -<a href= -"actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a> -<a href="actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a> + +crunch-all-cookies = +<A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +>crunch-incoming-cookies</A +> +<A +HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES" +>crunch-outgoing-cookies</A +> + -crunch-all-cookies = -<A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +>crunch-incoming-cookies</A +> -<A +HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES" +>crunch-outgoing-cookies</A +> +block-as-image = +block{Blocked image.} +handle-as-image - mercy-for-cookies = -crunch-all-cookies -<a href= -"actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a> -<a href= -"actions-file.html#FILTER-CONTENT-COOKIES">filter{content-cookies}</a> + mercy-for-cookies = -crunch-all-cookies -<A +HREF="actions-file.html#SESSION-COOKIES-ONLY" +>session-cookies-only</A +> -<A +HREF="actions-file.html#FILTER-CONTENT-COOKIES" +>filter{content-cookies}</A +>
# These aliases define combinations of actions # that are useful for certain types of sites: # - fragile = -<a href="actions-file.html#BLOCK">block</a> -<a href= -"actions-file.html#FILTER">filter</a> -crunch-all-cookies -<a href= -"actions-file.html#FAST-REDIRECTS">fast-redirects</a> -<a href= -"actions-file.html#HIDE-REFERER">hide-referrer</a> - shop = -crunch-all-cookies -<a href= -"actions-file.html#FILTER-ALL-POPUPS">filter{all-popups}</a> -</pre> - </td> - </tr> - </table> - - <p>The first of our specialized sections is concerned with - <span class="QUOTE">"fragile"</span> sites, i.e. sites that require - minimum interference, because they are either very complex or very - keen on tracking you (and have mechanisms in place that make them - unusable for people who avoid being tracked). We will simply use our - pre-defined <tt class="LITERAL">fragile</tt> alias instead of stating - the list of actions explicitly:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -########################################################################## + fragile = -<A +HREF="actions-file.html#BLOCK" +>block</A +> -<A +HREF="actions-file.html#FILTER" +>filter</A +> -crunch-all-cookies -<A +HREF="actions-file.html#FAST-REDIRECTS" +>fast-redirects</A +> -<A +HREF="actions-file.html#HIDE-REFERER" +>hide-referrer</A +> + shop = -crunch-all-cookies -<A +HREF="actions-file.html#FILTER-ALL-POPUPS" +>filter{all-popups}</A +></PRE +></TD +></TR +></TABLE +></P +><P +> The first of our specialized sections is concerned with <SPAN +CLASS="QUOTE" +>"fragile"</SPAN +> + sites, i.e. sites that require minimum interference, because they are either + very complex or very keen on tracking you (and have mechanisms in place that + make them unusable for people who avoid being tracked). We will simply use + our pre-defined <TT +CLASS="LITERAL" +>fragile</TT +> alias instead of stating the list + of actions explicitly:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>########################################################################## # Exceptions for sites that'll break under the default action set: ##########################################################################
@@ -4524,148 +7226,239 @@ for-privoxy-version=3.0.11 { fragile } .office.microsoft.com # surprise, surprise! .windowsupdate.microsoft.com -mail.google.com -</pre> - </td> - </tr> - </table> - - <p>Shopping sites are not as fragile, but they typically require - cookies to log in, and pop-up windows for shopping carts or item - details. Again, we'll use a pre-defined alias:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# Shopping sites: +mail.google.com</PRE +></TD +></TR +></TABLE +></P +><P +> Shopping sites are not as fragile, but they typically + require cookies to log in, and pop-up windows for shopping + carts or item details. Again, we'll use a pre-defined alias:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Shopping sites: # { shop } -.quietpc.com +.quietpc.com .worldpay.com # for quietpc.com .jungle.com -.scan.co.uk -</pre> - </td> - </tr> - </table> - - <p>The <tt class="LITERAL"><a href= - "actions-file.html#FAST-REDIRECTS">fast-redirects</a></tt> action, - which may have been enabled in <tt class= - "FILENAME">match-all.action</tt>, breaks some sites. So disable it - for popular sites where we know it misbehaves:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ -<a href="actions-file.html#FAST-REDIRECTS">fast-redirects</a> } +.scan.co.uk</PRE +></TD +></TR +></TABLE +></P +><P +> The <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FAST-REDIRECTS" +>fast-redirects</A +></TT +> + action, which may have been enabled in <TT +CLASS="FILENAME" +>match-all.action</TT +>, + breaks some sites. So disable it for popular sites where we know it misbehaves:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ -<A +HREF="actions-file.html#FAST-REDIRECTS" +>fast-redirects</A +> } login.yahoo.com edit.*.yahoo.com .google.com .altavista.com/.*(like|url|link):http .altavista.com/trans.*urltext=http -.nytimes.com -</pre> - </td> - </tr> - </table> - - <p>It is important that <span class="APPLICATION">Privoxy</span> - knows which URLs belong to images, so that <span class= - "emphasis EMPHASIS c2">if</span> they are to be blocked, a substitute - image can be sent, rather than an HTML page. Contacting the remote - site to find out is not an option, since it would destroy the loading - time advantage of banner blocking, and it would feed the advertisers - information about you. We can mark any URL as an image with the - <tt class="LITERAL"><a href= - "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt> action, - and marking all URLs that end in a known image file extension is a - good start:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -########################################################################## +.nytimes.com</PRE +></TD +></TR +></TABLE +></P +><P +> It is important that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> knows which + URLs belong to images, so that <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>if</I +></SPAN +> they are to + be blocked, a substitute image can be sent, rather than an HTML page. + Contacting the remote site to find out is not an option, since it + would destroy the loading time advantage of banner blocking, and it + would feed the advertisers information about you. We can mark any + URL as an image with the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +></TT +> action, + and marking all URLs that end in a known image file extension is a + good start:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>########################################################################## # Images: ##########################################################################
# Define which file types will be treated as images, in case they get # blocked further down this file: # -{ +<a href="actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a> } -/.*.(gif|jpe?g|png|bmp|ico)$ -</pre> - </td> - </tr> - </table> - - <p>And then there are known banner sources. They often use scripts to - generate the banners, so it won't be visible from the URL that the - request is for an image. Hence we block them <span class= - "emphasis EMPHASIS c2">and</span> mark them as images in one go, with - the help of our <tt class="LITERAL">+block-as-image</tt> alias - defined above. (We could of course just as well use <tt class= - "LITERAL">+<a href="actions-file.html#BLOCK">block</a> +<a href= - "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt> here.) - Remember that the type of the replacement image is chosen by the - <tt class="LITERAL"><a href= - "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></tt> - action. Since all URLs have matched the default section with its - <tt class="LITERAL">+<a href= - "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a>{pattern}</tt> - action before, it still applies and needn't be repeated:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# Known ad generators: +{ +<A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +> } +/.*.(gif|jpe?g|png|bmp|ico)$</PRE +></TD +></TR +></TABLE +></P +><P +> And then there are known banner sources. They often use scripts to + generate the banners, so it won't be visible from the URL that the + request is for an image. Hence we block them <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>and</I +></SPAN +> + mark them as images in one go, with the help of our + <TT +CLASS="LITERAL" +>+block-as-image</TT +> alias defined above. (We could of + course just as well use <TT +CLASS="LITERAL" +>+<A +HREF="actions-file.html#BLOCK" +>block</A +> + +<A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +></TT +> here.) + Remember that the type of the replacement image is chosen by the + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker</A +></TT +> + action. Since all URLs have matched the default section with its + <TT +CLASS="LITERAL" +>+<A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker</A +>{pattern}</TT +> + action before, it still applies and needn't be repeated:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Known ad generators: # { +block-as-image } -ar.atwola.com +ar.atwola.com .ad.doubleclick.net .ad.*.doubleclick.net .a.yimg.com/(?:(?!/i/).)*$ .a[0-9].yimg.com/(?:(?!/i/).)*$ bs*.gsanet.com -.qkimg.net -</pre> - </td> - </tr> - </table> - - <p>One of the most important jobs of <span class= - "APPLICATION">Privoxy</span> is to block banners. Many of these can - be <span class="QUOTE">"blocked"</span> by the <tt class= - "LITERAL"><a href= - "actions-file.html#FILTER">filter</a>{banners-by-size}</tt> action, - which we enabled above, and which deletes the references to banner - images from the pages while they are loaded, so the browser doesn't - request them anymore, and hence they don't need to be blocked here. - But this naturally doesn't catch all banners, and some people choose - not to use filters, so we need a comprehensive list of patterns for - banner URLs here, and apply the <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt> action to them.</p> - - <p>First comes many generic patterns, which do most of the work, by - matching typical domain and path name components of banners. Then - comes a list of individual patterns for specific sites, which is - omitted here to keep the example short:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -########################################################################## +.qkimg.net</PRE +></TD +></TR +></TABLE +></P +><P +> One of the most important jobs of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + is to block banners. Many of these can be <SPAN +CLASS="QUOTE" +>"blocked"</SPAN +> + by the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FILTER" +>filter</A +>{banners-by-size}</TT +> + action, which we enabled above, and which deletes the references to banner + images from the pages while they are loaded, so the browser doesn't request + them anymore, and hence they don't need to be blocked here. But this naturally + doesn't catch all banners, and some people choose not to use filters, so we + need a comprehensive list of patterns for banner URLs here, and apply the + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> action to them.</P +><P +> First comes many generic patterns, which do most of the work, by + matching typical domain and path name components of banners. Then comes + a list of individual patterns for specific sites, which is omitted here + to keep the example short:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>########################################################################## # Block these fine banners: ########################################################################## -{ <a href="actions-file.html#BLOCK">+block{Banner ads.}</a> } +{ <A +HREF="actions-file.html#BLOCK" +>+block{Banner ads.}</A +> }
# Generic patterns: -# +# ad*. .*ads. banner?. @@ -4675,56 +7468,137 @@ count*.
# Site-specific patterns (abbreviated): # -.hitbox.com -</pre> - </td> - </tr> - </table> - - <p>It's quite remarkable how many advertisers actually call their - banner servers ads.<tt class="REPLACEABLE c5">company</tt>.com, or - call the directory in which the banners are stored simply - <span class="QUOTE">"banners"</span>. So the above generic patterns - are surprisingly effective.</p> - - <p>But being very generic, they necessarily also catch URLs that we - don't want to block. The pattern <tt class="LITERAL">.*ads.</tt> e.g. - catches <span class="QUOTE">"nasty-<span class= - "emphasis EMPHASIS c2">ads</span>.nasty-corp.com"</span> as intended, - but also <span class="QUOTE">"downlo<span class= - "emphasis EMPHASIS c2">ads</span>.sourcefroge.net"</span> or - <span class="QUOTE">"<span class= - "emphasis EMPHASIS c2">ads</span>l.some-provider.net."</span> So here - come some well-known exceptions to the <tt class="LITERAL">+<a href= - "actions-file.html#BLOCK">block</a></tt> section above.</p> - - <p>Note that these are exceptions to exceptions from the default! - Consider the URL <span class= - "QUOTE">"downloads.sourcefroge.net"</span>: Initially, all actions - are deactivated, so it wouldn't get blocked. Then comes the defaults - section, which matches the URL, but just deactivates the <tt class= - "LITERAL"><a href="actions-file.html#BLOCK">block</a></tt> action - once again. Then it matches <tt class="LITERAL">.*ads.</tt>, an - exception to the general non-blocking policy, and suddenly <tt class= - "LITERAL"><a href="actions-file.html#BLOCK">+block</a></tt> applies. - And now, it'll match <tt class="LITERAL">.*loads.</tt>, where - <tt class="LITERAL"><a href="actions-file.html#BLOCK">-block</a></tt> - applies, so (unless it matches <span class= - "emphasis EMPHASIS c2">again</span> further down) it ends up with no - <tt class="LITERAL"><a href="actions-file.html#BLOCK">block</a></tt> - action applying.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -########################################################################## +.hitbox.com</PRE +></TD +></TR +></TABLE +></P +><P +> It's quite remarkable how many advertisers actually call their banner + servers ads.<TT +CLASS="REPLACEABLE" +><I +>company</I +></TT +>.com, or call the directory + in which the banners are stored simply <SPAN +CLASS="QUOTE" +>"banners"</SPAN +>. So the above + generic patterns are surprisingly effective.</P +><P +> But being very generic, they necessarily also catch URLs that we don't want + to block. The pattern <TT +CLASS="LITERAL" +>.*ads.</TT +> e.g. catches + <SPAN +CLASS="QUOTE" +>"nasty-<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>ads</I +></SPAN +>.nasty-corp.com"</SPAN +> as intended, + but also <SPAN +CLASS="QUOTE" +>"downlo<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>ads</I +></SPAN +>.sourcefroge.net"</SPAN +> or + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>ads</I +></SPAN +>l.some-provider.net."</SPAN +> So here come some + well-known exceptions to the <TT +CLASS="LITERAL" +>+<A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> + section above.</P +><P +> Note that these are exceptions to exceptions from the default! Consider the URL + <SPAN +CLASS="QUOTE" +>"downloads.sourcefroge.net"</SPAN +>: Initially, all actions are deactivated, + so it wouldn't get blocked. Then comes the defaults section, which matches the + URL, but just deactivates the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> + action once again. Then it matches <TT +CLASS="LITERAL" +>.*ads.</TT +>, an exception to the + general non-blocking policy, and suddenly + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>+block</A +></TT +> applies. And now, it'll match + <TT +CLASS="LITERAL" +>.*loads.</TT +>, where <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>-block</A +></TT +> + applies, so (unless it matches <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>again</I +></SPAN +> further down) it ends up + with no <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> action applying.</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>########################################################################## # Save some innocent victims of the above generic block patterns: ##########################################################################
# By domain: -# -{ -<a href="actions-file.html#BLOCK">block</a> } +# +{ -<A +HREF="actions-file.html#BLOCK" +>block</A +> } adv[io]*. # (for advogato.org and advice.*) adsl. # (has nothing to do with ads) adobe. # (has nothing to do with ads either) @@ -4739,87 +7613,147 @@ ad[ud]*. # (adult.* and add.*) # Site-specific: # www.globalintersec.com/adv # (adv = advanced) -www.ugu.com/sui/ugu/adv -</pre> - </td> - </tr> - </table> - - <p>Filtering source code can have nasty side effects, so make an - exception for our friends at sourceforge.net, and all paths with - <span class="QUOTE">"cvs"</span> in them. Note that <tt class= - "LITERAL">-<a href="actions-file.html#FILTER">filter</a></tt> - disables <span class="emphasis EMPHASIS c2">all</span> filters in one - fell swoop!</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# Don't filter code! +www.ugu.com/sui/ugu/adv</PRE +></TD +></TR +></TABLE +></P +><P +> Filtering source code can have nasty side effects, + so make an exception for our friends at sourceforge.net, + and all paths with <SPAN +CLASS="QUOTE" +>"cvs"</SPAN +> in them. Note that + <TT +CLASS="LITERAL" +>-<A +HREF="actions-file.html#FILTER" +>filter</A +></TT +> + disables <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> filters in one fell swoop!</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Don't filter code! # -{ -<a href="actions-file.html#FILTER">filter</a> } +{ -<A +HREF="actions-file.html#FILTER" +>filter</A +> } /(.*/)?cvs bugzilla. developer. wiki. -.sourceforge.net -</pre> - </td> - </tr> - </table> - - <p>The actual <tt class="FILENAME">default.action</tt> is of course - much more comprehensive, but we hope this example made clear how it - works.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4905" id="AEN4905">8.7.3. - user.action</a></h3> - - <p>So far we are painting with a broad brush by setting general - policies, which would be a reasonable starting point for many people. - Now, you might want to be more specific and have customized rules - that are more suitable to your personal habits and preferences. These - would be for narrowly defined situations like your ISP or your bank, - and should be placed in <tt class="FILENAME">user.action</tt>, which - is parsed after all other actions files and hence has the last word, - over-riding any previously defined actions. <tt class= - "FILENAME">user.action</tt> is also a <span class= - "emphasis EMPHASIS c2">safe</span> place for your personal settings, - since <tt class="FILENAME">default.action</tt> is actively maintained - by the <span class="APPLICATION">Privoxy</span> developers and you'll - probably want to install updated versions from time to time.</p> - - <p>So let's look at a few examples of things that one might typically - do in <tt class="FILENAME">user.action</tt>:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# My user.action file. <fred@example.com> -</pre> - </td> - </tr> - </table> - - <p>As <a href="actions-file.html#ALIASES">aliases</a> are local to - the actions file that they are defined in, you can't use the ones - from <tt class="FILENAME">default.action</tt>, unless you repeat them - here:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# Aliases are local to the file they are defined in. +.sourceforge.net</PRE +></TD +></TR +></TABLE +></P +><P +> The actual <TT +CLASS="FILENAME" +>default.action</TT +> is of course much more + comprehensive, but we hope this example made clear how it works.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="AEN4292" +>8.7.3. user.action</A +></H3 +><P +> So far we are painting with a broad brush by setting general policies, + which would be a reasonable starting point for many people. Now, + you might want to be more specific and have customized rules that + are more suitable to your personal habits and preferences. These would + be for narrowly defined situations like your ISP or your bank, and should + be placed in <TT +CLASS="FILENAME" +>user.action</TT +>, which is parsed after all other + actions files and hence has the last word, over-riding any previously + defined actions. <TT +CLASS="FILENAME" +>user.action</TT +> is also a + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>safe</I +></SPAN +> place for your personal settings, since + <TT +CLASS="FILENAME" +>default.action</TT +> is actively maintained by the + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developers and you'll probably want + to install updated versions from time to time.</P +><P +> So let's look at a few examples of things that one might typically do in + <TT +CLASS="FILENAME" +>user.action</TT +>: </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># My user.action file. <fred@example.com></PRE +></TD +></TR +></TABLE +></P +><P +> As <A +HREF="actions-file.html#ALIASES" +>aliases</A +> are local to the actions + file that they are defined in, you can't use the ones from + <TT +CLASS="FILENAME" +>default.action</TT +>, unless you repeat them here:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Aliases are local to the file they are defined in. # (Re-)define aliases for this file: # {{alias}} -# -# These aliases just save typing later, and the alias names should +# +# These aliases just save typing later, and the alias names should # be self explanatory. # +crunch-all-cookies = +crunch-incoming-cookies +crunch-outgoing-cookies @@ -4841,56 +7775,83 @@ allow-ads = -block -filter{banners-by-size} -filter{banners-by-link}
# Alias for specific file types that are text, but might have conflicting # MIME types. We want the browser to force these to be text documents. -handle-as-text = -<a href="actions-file.html#FILTER">filter</a> +-<a href= -"actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite{text/plain}</a> +-<a href="actions-file.html#FORCE-TEXT-MODE">force-text-mode</a> -<a href="actions-file.html#HIDE-CONTENT-DISPOSITION">hide-content-disposition</a> -</pre> - </td> - </tr> - </table> - - <p>Say you have accounts on some sites that you visit regularly, and - you don't want to have to log in manually each time. So you'd like to - allow persistent cookies for these sites. The <tt class= - "LITERAL">allow-all-cookies</tt> alias defined above does exactly - that, i.e. it disables crunching of cookies in any direction, and the - processing of cookies to make them only temporary.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ allow-all-cookies } +handle-as-text = -<A +HREF="actions-file.html#FILTER" +>filter</A +> +-<A +HREF="actions-file.html#CONTENT-TYPE-OVERWRITE" +>content-type-overwrite{text/plain}</A +> +-<A +HREF="actions-file.html#FORCE-TEXT-MODE" +>force-text-mode</A +> -<A +HREF="actions-file.html#HIDE-CONTENT-DISPOSITION" +>hide-content-disposition</A +></PRE +></TD +></TR +></TABLE +> </P +><P +> Say you have accounts on some sites that you visit regularly, and + you don't want to have to log in manually each time. So you'd like + to allow persistent cookies for these sites. The + <TT +CLASS="LITERAL" +>allow-all-cookies</TT +> alias defined above does exactly + that, i.e. it disables crunching of cookies in any direction, and the + processing of cookies to make them only temporary.</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ allow-all-cookies } sourceforge.net .yahoo.com .msdn.microsoft.com - .redhat.com -</pre> - </td> - </tr> - </table> - - <p>Your bank is allergic to some filter, but you don't know which, so - you disable them all:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ -<a href="actions-file.html#FILTER">filter</a> } - .your-home-banking-site.com -</pre> - </td> - </tr> - </table> - - <p>Some file types you may not want to filter for various - reasons:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# Technical documentation is likely to contain strings that might + .redhat.com</PRE +></TD +></TR +></TABLE +></P +><P +> Your bank is allergic to some filter, but you don't know which, so you disable them all:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ -<A +HREF="actions-file.html#FILTER" +>filter</A +> } + .your-home-banking-site.com</PRE +></TD +></TR +></TABLE +></P +><P +> Some file types you may not want to filter for various reasons:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Technical documentation is likely to contain strings that might # erroneously get altered by the JavaScript-oriented filters: # .tldp.org @@ -4899,198 +7860,355 @@ handle-as-text = -<a href="actions-file.html#FILTER">filter</a> +-<a href= # And this stupid host sends streaming video with a wrong MIME type, # so that Privoxy thinks it is getting HTML and starts filtering: # -stupid-server.example.com/ -</pre> - </td> - </tr> - </table> - - <p>Example of a simple <a href="actions-file.html#BLOCK">block</a> - action. Say you've seen an ad on your favourite page on example.com - that you want to get rid of. You have right-clicked the image, - selected <span class="QUOTE">"copy image location"</span> and pasted - the URL below while removing the leading http://, into a <tt class= - "LITERAL">{ +block{} }</tt> section. Note that <tt class="LITERAL">{ - +handle-as-image }</tt> need not be specified, since all URLs ending - in <tt class="LITERAL">.gif</tt> will be tagged as images by the - general rules as set in default.action anyway:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ +<a href="actions-file.html#BLOCK">block</a>{Nasty ads.} } +stupid-server.example.com/</PRE +></TD +></TR +></TABLE +></P +><P +> Example of a simple <A +HREF="actions-file.html#BLOCK" +>block</A +> action. Say you've + seen an ad on your favourite page on example.com that you want to get rid of. + You have right-clicked the image, selected <SPAN +CLASS="QUOTE" +>"copy image location"</SPAN +> + and pasted the URL below while removing the leading http://, into a + <TT +CLASS="LITERAL" +>{ +block{} }</TT +> section. Note that <TT +CLASS="LITERAL" +>{ +handle-as-image + }</TT +> need not be specified, since all URLs ending in + <TT +CLASS="LITERAL" +>.gif</TT +> will be tagged as images by the general rules as set + in default.action anyway:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ +<A +HREF="actions-file.html#BLOCK" +>block</A +>{Nasty ads.} } www.example.com/nasty-ads/sponsor.gif - another.example.net/more/junk/here/ -</pre> - </td> - </tr> - </table> - - <p>The URLs of dynamically generated banners, especially from large - banner farms, often don't use the well-known image file name - extensions, which makes it impossible for <span class= - "APPLICATION">Privoxy</span> to guess the file type just by looking - at the URL. You can use the <tt class="LITERAL">+block-as-image</tt> - alias defined above for these cases. Note that objects which match - this rule but then turn out NOT to be an image are typically rendered - as a <span class="QUOTE">"broken image"</span> icon by the browser. - Use cautiously.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ +block-as-image } + another.example.net/more/junk/here/</PRE +></TD +></TR +></TABLE +></P +><P +> The URLs of dynamically generated banners, especially from large banner + farms, often don't use the well-known image file name extensions, which + makes it impossible for <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to guess + the file type just by looking at the URL. + You can use the <TT +CLASS="LITERAL" +>+block-as-image</TT +> alias defined above for + these cases. + Note that objects which match this rule but then turn out NOT to be an + image are typically rendered as a <SPAN +CLASS="QUOTE" +>"broken image"</SPAN +> icon by the + browser. Use cautiously.</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ +block-as-image } .doubleclick.net .fastclick.net /Realmedia/ads/ - ar.atwola.com/ -</pre> - </td> - </tr> - </table> - - <p>Now you noticed that the default configuration breaks Forbes - Magazine, but you were too lazy to find out which action is the - culprit, and you were again too lazy to give <a href= - "contact.html">feedback</a>, so you just used the <tt class= - "LITERAL">fragile</tt> alias on the site, and -- <span class= - "emphasis EMPHASIS c2">whoa!</span> -- it worked. The <tt class= - "LITERAL">fragile</tt> aliases disables those actions that are most - likely to break a site. Also, good for testing purposes to see if it - is <span class="APPLICATION">Privoxy</span> that is causing the - problem or not. We later find other regular sites that misbehave, and - add those to our personalized list of troublemakers:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ fragile } + ar.atwola.com/</PRE +></TD +></TR +></TABLE +></P +><P +> Now you noticed that the default configuration breaks Forbes Magazine, + but you were too lazy to find out which action is the culprit, and you + were again too lazy to give <A +HREF="contact.html" +>feedback</A +>, so + you just used the <TT +CLASS="LITERAL" +>fragile</TT +> alias on the site, and + -- <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>whoa!</I +></SPAN +> -- it worked. The <TT +CLASS="LITERAL" +>fragile</TT +> + aliases disables those actions that are most likely to break a site. Also, + good for testing purposes to see if it is <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + that is causing the problem or not. We later find other regular sites + that misbehave, and add those to our personalized list of troublemakers:</P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ fragile } .forbes.com webmail.example.com - .mybank.com -</pre> - </td> - </tr> - </table> - - <p>You like the <span class="QUOTE">"fun"</span> text replacements in - <tt class="FILENAME">default.filter</tt>, but it is disabled in the - distributed actions file. So you'd like to turn it on in your - private, update-safe config, once and for all:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ +<a href="actions-file.html#FILTER-FUN">filter{fun}</a> } - / # For ALL sites! -</pre> - </td> - </tr> - </table> - - <p>Note that the above is not really a good idea: There are - exceptions to the filters in <tt class="FILENAME">default.action</tt> - for things that really shouldn't be filtered, like code on - CVS->Web interfaces. Since <tt class="FILENAME">user.action</tt> - has the last word, these exceptions won't be valid for the - <span class="QUOTE">"fun"</span> filtering specified here.</p> - - <p>You might also worry about how your favourite free websites are - funded, and find that they rely on displaying banner advertisements - to survive. So you might want to specifically allow banners for those - sites that you feel provide value to you:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ allow-ads } + .mybank.com</PRE +></TD +></TR +></TABLE +></P +><P +> You like the <SPAN +CLASS="QUOTE" +>"fun"</SPAN +> text replacements in <TT +CLASS="FILENAME" +>default.filter</TT +>, + but it is disabled in the distributed actions file. + So you'd like to turn it on in your private, + update-safe config, once and for all:</P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ +<A +HREF="actions-file.html#FILTER-FUN" +>filter{fun}</A +> } + / # For ALL sites!</PRE +></TD +></TR +></TABLE +></P +><P +> Note that the above is not really a good idea: There are exceptions + to the filters in <TT +CLASS="FILENAME" +>default.action</TT +> for things that + really shouldn't be filtered, like code on CVS->Web interfaces. Since + <TT +CLASS="FILENAME" +>user.action</TT +> has the last word, these exceptions + won't be valid for the <SPAN +CLASS="QUOTE" +>"fun"</SPAN +> filtering specified here.</P +><P +> You might also worry about how your favourite free websites are + funded, and find that they rely on displaying banner advertisements + to survive. So you might want to specifically allow banners for those + sites that you feel provide value to you:</P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ allow-ads } .sourceforge.net .slashdot.org - .osdn.net -</pre> - </td> - </tr> - </table> - - <p>Note that <tt class="LITERAL">allow-ads</tt> has been aliased to - <tt class="LITERAL">-<a href= - "actions-file.html#BLOCK">block</a></tt>, <tt class= - "LITERAL">-<a href= - "actions-file.html#FILTER-BANNERS-BY-SIZE">filter{banners-by-size}</a></tt>, - and <tt class="LITERAL">-<a href= - "actions-file.html#FILTER-BANNERS-BY-LINK">filter{banners-by-link}</a></tt> - above.</p> - - <p>Invoke another alias here to force an over-ride of the MIME type - <tt class="LITERAL">application/x-sh</tt> which typically would open - a download type dialog. In my case, I want to look at the shell - script, and then I can save it should I choose to.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ handle-as-text } - /.*.sh$ -</pre> - </td> - </tr> - </table> - - <p><tt class="FILENAME">user.action</tt> is generally the best place - to define exceptions and additions to the default policies of - <tt class="FILENAME">default.action</tt>. Some actions are safe to - have their default policies set here though. So let's set a default - policy to have a <span class="QUOTE">"blank"</span> image as opposed - to the checkerboard pattern for <span class= - "emphasis EMPHASIS c2">ALL</span> sites. <span class= - "QUOTE">"/"</span> of course matches all URL paths and patterns:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -{ +<a href= -"actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker{blank}</a> } -/ # ALL sites -</pre> - </td> - </tr> - </table> - </div> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="config.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="filter-file.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">The Main Configuration - File</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Filter Files</td> - </tr> - </table> - </div> -</body> -</html> + .osdn.net</PRE +></TD +></TR +></TABLE +> </P +><P +> Note that <TT +CLASS="LITERAL" +>allow-ads</TT +> has been aliased to + <TT +CLASS="LITERAL" +>-<A +HREF="actions-file.html#BLOCK" +>block</A +></TT +>, + <TT +CLASS="LITERAL" +>-<A +HREF="actions-file.html#FILTER-BANNERS-BY-SIZE" +>filter{banners-by-size}</A +></TT +>, and + <TT +CLASS="LITERAL" +>-<A +HREF="actions-file.html#FILTER-BANNERS-BY-LINK" +>filter{banners-by-link}</A +></TT +> above.</P +><P +> Invoke another alias here to force an over-ride of the MIME type <TT +CLASS="LITERAL" +> application/x-sh</TT +> which typically would open a download type + dialog. In my case, I want to look at the shell script, and then I can save + it should I choose to.</P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ handle-as-text } + /.*.sh$</PRE +></TD +></TR +></TABLE +> </P +><P +> <TT +CLASS="FILENAME" +>user.action</TT +> is generally the best place to define + exceptions and additions to the default policies of + <TT +CLASS="FILENAME" +>default.action</TT +>. Some actions are safe to have their + default policies set here though. So let's set a default policy to have a + <SPAN +CLASS="QUOTE" +>"blank"</SPAN +> image as opposed to the checkerboard pattern for + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>ALL</I +></SPAN +> sites. <SPAN +CLASS="QUOTE" +>"/"</SPAN +> of course matches all URL + paths and patterns:</P +><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>{ +<A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker{blank}</A +> } +/ # ALL sites</PRE +></TD +></TR +></TABLE +></P +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="config.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="filter-file.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>The Main Configuration File</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Filter Files</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/appendix.html b/external/privoxy/doc/webserver/user-manual/appendix.html index 1091844..4df57a4 100644 --- a/external/privoxy/doc/webserver/user-manual/appendix.html +++ b/external/privoxy/doc/webserver/user-manual/appendix.html @@ -1,665 +1,1454 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Appendix</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="See Also" href="seealso.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - table.c3 {background-color: #E0E0E0} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="seealso.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"> </td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="APPENDIX" id="APPENDIX">14. Appendix</a></h1> - - <div class="SECT2"> - <h2 class="SECT2"><a name="REGEX" id="REGEX">14.1. Regular - Expressions</a></h2> - - <p><span class="APPLICATION">Privoxy</span> uses Perl-style - <span class="QUOTE">"regular expressions"</span> in its <a href= - "actions-file.html">actions files</a> and <a href= - "filter-file.html">filter file</a>, through the <a href= - "http://www.pcre.org/" target="_top">PCRE</a> and <span class= - "APPLICATION">PCRS</span> libraries.</p> - - <p>If you are reading this, you probably don't understand what - <span class="QUOTE">"regular expressions"</span> are, or what they can - do. So this will be a very brief introduction only. A full explanation - would require a <a href="http://www.oreilly.com/catalog/regex/" target= - "_top">book</a> ;-)</p> - - <p>Regular expressions provide a language to describe patterns that can - be run against strings of characters (letter, numbers, etc), to see if - they match the string or not. The patterns are themselves (sometimes - complex) strings of literal characters, combined with wild-cards, and - other special characters, called meta-characters. The <span class= - "QUOTE">"meta-characters"</span> have special meanings and are used to - build complex patterns to be matched against. Perl Compatible Regular - Expressions are an especially convenient <span class= - "QUOTE">"dialect"</span> of the regular expression language.</p> - - <p>To make a simple analogy, we do something similar when we use - wild-card characters when listing files with the <b class= - "COMMAND">dir</b> command in DOS. <tt class="LITERAL">*.*</tt> matches - all filenames. The <span class="QUOTE">"special"</span> character here - is the asterisk which matches any and all characters. We can be more - specific and use <tt class="LITERAL">?</tt> to match just individual - characters. So <span class="QUOTE">"dir file?.text"</span> would match - <span class="QUOTE">"file1.txt"</span>, <span class= - "QUOTE">"file2.txt"</span>, etc. We are pattern matching, using a - similar technique to <span class="QUOTE">"regular - expressions"</span>!</p> - - <p>Regular expressions do essentially the same thing, but are much, - much more powerful. There are many more <span class="QUOTE">"special - characters"</span> and ways of building complex patterns however. Let's - look at a few of the common ones, and then some examples:</p> - - <table border="0"> - <tbody> - <tr> - <td><span class="emphasis EMPHASIS c2">.</span> - Matches any - single character, e.g. <span class="QUOTE">"a"</span>, - <span class="QUOTE">"A"</span>, <span class="QUOTE">"4"</span>, - <span class="QUOTE">":"</span>, or <span class= - "QUOTE">"@"</span>.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><span class="emphasis EMPHASIS c2">?</span> - The preceding - character or expression is matched ZERO or ONE times. - Either/or.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><span class="emphasis EMPHASIS c2">+</span> - The preceding - character or expression is matched ONE or MORE times.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><span class="emphasis EMPHASIS c2">*</span> - The preceding - character or expression is matched ZERO or MORE times.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><span class="emphasis EMPHASIS c2"></span> - The - <span class="QUOTE">"escape"</span> character denotes that the - following character should be taken literally. This is used where - one of the special characters (e.g. <span class= - "QUOTE">"."</span>) needs to be taken literally and not as a - special meta-character. Example: <span class= - "QUOTE">"example.com"</span>, makes sure the period is - recognized only as a period (and not expanded to its - meta-character meaning of any single character).</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><span class="emphasis EMPHASIS c2">[ ]</span> - Characters - enclosed in brackets will be matched if any of the enclosed - characters are encountered. For instance, <span class= - "QUOTE">"[0-9]"</span> matches any numeric digit (zero through - nine). As an example, we can combine this with <span class= - "QUOTE">"+"</span> to match any digit one of more times: - <span class="QUOTE">"[0-9]+"</span>.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><span class="emphasis EMPHASIS c2">( )</span> - parentheses - are used to group a sub-expression, or multiple - sub-expressions.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><span class="emphasis EMPHASIS c2">|</span> - The - <span class="QUOTE">"bar"</span> character works like an - <span class="QUOTE">"or"</span> conditional statement. A match is - successful if the sub-expression on either side of <span class= - "QUOTE">"|"</span> matches. As an example: <span class= - "QUOTE">"/(this|that) example/"</span> uses grouping and the bar - character and would match either <span class="QUOTE">"this - example"</span> or <span class="QUOTE">"that example"</span>, and - nothing else.</td> - </tr> - </tbody> - </table> - - <p>These are just some of the ones you are likely to use when matching - URLs with <span class="APPLICATION">Privoxy</span>, and is a long way - from a definitive list. This is enough to get us started with a few - simple examples which may be more illuminating:</p> - - <p><span class="emphasis EMPHASIS c2"><tt class= - "LITERAL">/.*/banners/.*</tt></span> - A simple example that uses the - common combination of <span class="QUOTE">"."</span> and <span class= - "QUOTE">"*"</span> to denote any character, zero or more times. In - other words, any string at all. So we start with a literal forward - slash, then our regular expression pattern (<span class= - "QUOTE">".*"</span>) another literal forward slash, the string - <span class="QUOTE">"banners"</span>, another forward slash, and lastly - another <span class="QUOTE">".*"</span>. We are building a directory - path here. This will match any file with the path that has a directory - named <span class="QUOTE">"banners"</span> in it. The <span class= - "QUOTE">".*"</span> matches any characters, and this could conceivably - be more forward slashes, so it might expand into a much longer looking - path. For example, this could match: <span class= - "QUOTE">"/eye/hate/spammers/banners/annoy_me_please.gif"</span>, or - just <span class="QUOTE">"/banners/annoying.html"</span>, or almost an - infinite number of other possible combinations, just so it has - <span class="QUOTE">"banners"</span> in the path somewhere.</p> - - <p>And now something a little more complex:</p> - - <p><span class="emphasis EMPHASIS c2"><tt class= - "LITERAL">/.*/adv((er)?ts?|ertis(ing|ements?))?/</tt></span> - We have - several literal forward slashes again (<span class="QUOTE">"/"</span>), - so we are building another expression that is a file path statement. We - have another <span class="QUOTE">".*"</span>, so we are matching - against any conceivable sub-path, just so it matches our expression. - The only true literal that <span class="emphasis EMPHASIS c2">must - match</span> our pattern is <span class="APPLICATION">adv</span>, - together with the forward slashes. What comes after the <span class= - "QUOTE">"adv"</span> string is the interesting part.</p> - - <p>Remember the <span class="QUOTE">"?"</span> means the preceding - expression (either a literal character or anything grouped with - <span class="QUOTE">"(...)"</span> in this case) can exist or not, - since this means either zero or one match. So <span class= - "QUOTE">"((er)?ts?|ertis(ing|ements?))"</span> is optional, as are the - individual sub-expressions: <span class="QUOTE">"(er)"</span>, - <span class="QUOTE">"(ing|ements?)"</span>, and the <span class= - "QUOTE">"s"</span>. The <span class="QUOTE">"|"</span> means - <span class="QUOTE">"or"</span>. We have two of those. For instance, - <span class="QUOTE">"(ing|ements?)"</span>, can expand to match either - <span class="QUOTE">"ing"</span> <span class= - "emphasis EMPHASIS c2">OR</span> <span class="QUOTE">"ements?"</span>. - What is being done here, is an attempt at matching as many variations - of <span class="QUOTE">"advertisement"</span>, and similar, as - possible. So this would expand to match just <span class= - "QUOTE">"adv"</span>, or <span class="QUOTE">"advert"</span>, or - <span class="QUOTE">"adverts"</span>, or <span class= - "QUOTE">"advertising"</span>, or <span class= - "QUOTE">"advertisement"</span>, or <span class= - "QUOTE">"advertisements"</span>. You get the idea. But it would not - match <span class="QUOTE">"advertizements"</span> (with a <span class= - "QUOTE">"z"</span>). We could fix that by changing our regular - expression to: <span class= - "QUOTE">"/.*/adv((er)?ts?|erti(s|z)(ing|ements?))?/"</span>, which - would then match either spelling.</p> - - <p><span class="emphasis EMPHASIS c2"><tt class= - "LITERAL">/.*/advert[0-9]+.(gif|jpe?g)</tt></span> - Again another - path statement with forward slashes. Anything in the square brackets - <span class="QUOTE">"[ ]"</span> can be matched. This is using - <span class="QUOTE">"0-9"</span> as a shorthand expression to mean any - digit one through nine. It is the same as saying <span class= - "QUOTE">"0123456789"</span>. So any digit matches. The <span class= - "QUOTE">"+"</span> means one or more of the preceding expression must - be included. The preceding expression here is what is in the square - brackets -- in this case, any digit one through nine. Then, at the end, - we have a grouping: <span class="QUOTE">"(gif|jpe?g)"</span>. This - includes a <span class="QUOTE">"|"</span>, so this needs to match the - expression on either side of that bar character also. A simple - <span class="QUOTE">"gif"</span> on one side, and the other side will - in turn match either <span class="QUOTE">"jpeg"</span> or <span class= - "QUOTE">"jpg"</span>, since the <span class="QUOTE">"?"</span> means - the letter <span class="QUOTE">"e"</span> is optional and can be - matched once or not at all. So we are building an expression here to - match image GIF or JPEG type image file. It must include the literal - string <span class="QUOTE">"advert"</span>, then one or more digits, - and a <span class="QUOTE">"."</span> (which is now a literal, and not a - special character, since it is escaped with <span class= - "QUOTE">""</span>), and lastly either <span class= - "QUOTE">"gif"</span>, or <span class="QUOTE">"jpeg"</span>, or - <span class="QUOTE">"jpg"</span>. Some possible matches would include: - <span class="QUOTE">"//advert1.jpg"</span>, <span class= - "QUOTE">"/nasty/ads/advert1234.gif"</span>, <span class= - "QUOTE">"/banners/from/hell/advert99.jpg"</span>. It would not match - <span class="QUOTE">"advert1.gif"</span> (no leading slash), or - <span class="QUOTE">"/adverts232.jpg"</span> (the expression does not - include an <span class="QUOTE">"s"</span>), or <span class= - "QUOTE">"/advert1.jsp"</span> (<span class="QUOTE">"jsp"</span> is not - in the expression anywhere).</p> - - <p>We are barely scratching the surface of regular expressions here so - that you can understand the default <span class= - "APPLICATION">Privoxy</span> configuration files, and maybe use this - knowledge to customize your own installation. There is much, much more - that can be done with regular expressions. Now that you know enough to - get started, you can learn more on your own :/</p> - - <p>More reading on Perl Compatible Regular expressions: <a href= - "http://perldoc.perl.org/perlre.html" target= - "_top">http://perldoc.perl.org/perlre.html</a></p> - - <p>For information on regular expression based substitutions and their - applications in filters, please see the <a href= - "filter-file.html">filter file tutorial</a> in this manual.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN5795" id="AEN5795">14.2. Privoxy's - Internal Pages</a></h2> - - <p>Since <span class="APPLICATION">Privoxy</span> proxies each - requested web page, it is easy for <span class= - "APPLICATION">Privoxy</span> to trap certain special URLs. In this way, - we can talk directly to <span class="APPLICATION">Privoxy</span>, and - see how it is configured, see how our rules are being applied, change - these rules and other configuration options, and even turn <span class= - "APPLICATION">Privoxy's</span> filtering off, all with a web - browser.</p> - - <p>The URLs listed below are the special ones that allow direct access - to <span class="APPLICATION">Privoxy</span>. Of course, <span class= - "APPLICATION">Privoxy</span> must be running to access these. If not, - you will get a friendly error message. Internet access is not necessary - either.</p> - - <ul> - <li> - <p>Privoxy main page:</p><a name="AEN5809" id="AEN5809"></a> - - <blockquote class="BLOCKQUOTE"> - <p><a href="http://config.privoxy.org/" target= - "_top">http://config.privoxy.org/</a></p> - </blockquote> - - <p>There is a shortcut: <a href="http://p.p/" target= - "_top">http://p.p/</a> (But it doesn't provide a fall-back to a - real page, in case the request is not sent through <span class= - "APPLICATION">Privoxy</span>)</p> - </li> - - <li> - <p>Show information about the current configuration, including - viewing and editing of actions files:</p><a name="AEN5817" id= - "AEN5817"></a> - - <blockquote class="BLOCKQUOTE"> - <p><a href="http://config.privoxy.org/show-status" target= - "_top">http://config.privoxy.org/show-status</a></p> - </blockquote> - </li> - - <li> - <p>Show the source code version numbers:</p><a name="AEN5822" id= - "AEN5822"></a> - - <blockquote class="BLOCKQUOTE"> - <p><a href="http://config.privoxy.org/show-version" target= - "_top">http://config.privoxy.org/show-version</a></p> - </blockquote> - </li> - - <li> - <p>Show the browser's request headers:</p><a name="AEN5827" id= - "AEN5827"></a> - - <blockquote class="BLOCKQUOTE"> - <p><a href="http://config.privoxy.org/show-request" target= - "_top">http://config.privoxy.org/show-request</a></p> - </blockquote> - </li> - - <li> - <p>Show which actions apply to a URL and why:</p><a name="AEN5832" - id="AEN5832"></a> - - <blockquote class="BLOCKQUOTE"> - <p><a href="http://config.privoxy.org/show-url-info" target= - "_top">http://config.privoxy.org/show-url-info</a></p> - </blockquote> - </li> - - <li> - <p>Toggle Privoxy on or off. This feature can be turned off/on in - the main <tt class="FILENAME">config</tt> file. When toggled - <span class="QUOTE">"off"</span>, <span class= - "QUOTE">"Privoxy"</span> continues to run, but only as a - pass-through proxy, with no actions taking place:</p><a name= - "AEN5840" id="AEN5840"></a> - - <blockquote class="BLOCKQUOTE"> - <p><a href="http://config.privoxy.org/toggle" target= - "_top">http://config.privoxy.org/toggle</a></p> - </blockquote> - - <p>Short cuts. Turn off, then on:</p><a name="AEN5844" id= - "AEN5844"></a> - - <blockquote class="BLOCKQUOTE"> - <p><a href="http://config.privoxy.org/toggle?set=disable" target= - "_top">http://config.privoxy.org/toggle?set=disable</a></p> - </blockquote><a name="AEN5847" id="AEN5847"></a> - - <blockquote class="BLOCKQUOTE"> - <p><a href="http://config.privoxy.org/toggle?set=enable" target= - "_top">http://config.privoxy.org/toggle?set=enable</a></p> - </blockquote> - </li> - </ul> - - <p>These may be bookmarked for quick reference. See next.</p> - - <div class="SECT3"> - <h3 class="SECT3"><a name="BOOKMARKLETS" id="BOOKMARKLETS">14.2.1. - Bookmarklets</a></h3> - - <p>Below are some <span class="QUOTE">"bookmarklets"</span> to allow - you to easily access a <span class="QUOTE">"mini"</span> version of - some of <span class="APPLICATION">Privoxy's</span> special pages. - They are designed for MS Internet Explorer, but should work equally - well in Netscape, Mozilla, and other browsers which support - JavaScript. They are designed to run directly from your bookmarks - - not by clicking the links below (although that should work for - testing).</p> - - <p>To save them, right-click the link and choose <span class= - "QUOTE">"Add to Favorites"</span> (IE) or <span class="QUOTE">"Add - Bookmark"</span> (Netscape). You will get a warning that the bookmark - <span class="QUOTE">"may not be safe"</span> - just click OK. Then - you can run the Bookmarklet directly from your favorites/bookmarks. - For even faster access, you can put them on the <span class= - "QUOTE">"Links"</span> bar (IE) or the <span class="QUOTE">"Personal - Toolbar"</span> (Netscape), and run them with a single click.</p> - - <ul> - <li> - <p><a href= - "javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=enabled%27,%27ijbstatus%27,%...));" - target="_top">Privoxy - Enable</a></p> - </li> - - <li> - <p><a href= - "javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=disabled%27,%27ijbstatus%27,...));" - target="_top">Privoxy - Disable</a></p> - </li> - - <li> - <p><a href= - "javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=toggle%27,%27ijbstatus%27,%2...));" - target="_top">Privoxy - Toggle Privoxy</a> (Toggles between - enabled and disabled)</p> - </li> - - <li> - <p><a href= - "javascript:void(window.open('http://config.privoxy.org/toggle?mini=y%27,%27ijbstatus%27,%27width=250,heig...));" - target="_top">Privoxy- View Status</a></p> - </li> - - <li> - <p><a href= - "javascript:void(window.open('http://config.privoxy.org/show-url-info?url=%27+escape(location.href),%27Why...));" - target="_top">Privoxy - Why?</a></p> - </li> - </ul> - - <p>Credit: The site which gave us the general idea for these - bookmarklets is <a href="http://www.bookmarklets.com/" target= - "_top">www.bookmarklets.com</a>. They have more information about - bookmarklets.</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CHAIN" id="CHAIN">14.3. Chain of - Events</a></h2> - - <p>Let's take a quick look at how some of <span class= - "APPLICATION">Privoxy's</span> core features are triggered, and the - ensuing sequence of events when a web page is requested by your - browser:</p> - - <ul> - <li> - <p>First, your web browser requests a web page. The browser knows - to send the request to <span class="APPLICATION">Privoxy</span>, - which will in turn, relay the request to the remote web server - after passing the following tests:</p> - </li> - - <li> - <p><span class="APPLICATION">Privoxy</span> traps any request for - its own internal CGI pages (e.g <a href="http://p.p/" target= - "_top">http://p.p/</a>) and sends the CGI page back to the - browser.</p> - </li> - - <li> - <p>Next, <span class="APPLICATION">Privoxy</span> checks to see if - the URL matches any <a href="actions-file.html#BLOCK"><span class= - "QUOTE">"+block"</span></a> patterns. If so, the URL is then - blocked, and the remote web server will not be contacted. <a href= - "actions-file.html#HANDLE-AS-IMAGE"><span class= - "QUOTE">"+handle-as-image"</span></a> and <a href= - "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"><span class= - "QUOTE">"+handle-as-empty-document"</span></a> are then checked, - and if there is no match, an HTML <span class= - "QUOTE">"BLOCKED"</span> page is sent back to the browser. - Otherwise, if it does match, an image is returned for the former, - and an empty text document for the latter. The type of image would - depend on the setting of <a href= - "actions-file.html#SET-IMAGE-BLOCKER"><span class= - "QUOTE">"+set-image-blocker"</span></a> (blank, checkerboard - pattern, or an HTTP redirect to an image elsewhere).</p> - </li> - - <li> - <p>Untrusted URLs are blocked. If URLs are being added to the - <tt class="FILENAME">trust</tt> file, then that is done.</p> - </li> - - <li> - <p>If the URL pattern matches the <a href= - "actions-file.html#FAST-REDIRECTS"><span class= - "QUOTE">"+fast-redirects"</span></a> action, it is then processed. - Unwanted parts of the requested URL are stripped.</p> - </li> - - <li> - <p>Now the rest of the client browser's request headers are - processed. If any of these match any of the relevant actions (e.g. - <a href="actions-file.html#HIDE-USER-AGENT"><span class= - "QUOTE">"+hide-user-agent"</span></a>, etc.), headers are - suppressed or forged as determined by these actions and their - parameters.</p> - </li> - - <li> - <p>Now the web server starts sending its response back (i.e. - typically a web page).</p> - </li> - - <li> - <p>First, the server headers are read and processed to determine, - among other things, the MIME type (document type) and encoding. The - headers are then filtered as determined by the <a href= - "actions-file.html#CRUNCH-INCOMING-COOKIES"><span class= - "QUOTE">"+crunch-incoming-cookies"</span></a>, <a href= - "actions-file.html#SESSION-COOKIES-ONLY"><span class= - "QUOTE">"+session-cookies-only"</span></a>, and <a href= - "actions-file.html#DOWNGRADE-HTTP-VERSION"><span class= - "QUOTE">"+downgrade-http-version"</span></a> actions.</p> - </li> - - <li> - <p>If any <a href="actions-file.html#FILTER"><span class= - "QUOTE">"+filter"</span></a> action or <a href= - "actions-file.html#DEANIMATE-GIFS"><span class= - "QUOTE">"+deanimate-gifs"</span></a> action applies (and the - document type fits the action), the rest of the page is read into - memory (up to a configurable limit). Then the filter rules (from - <tt class="FILENAME">default.filter</tt> and any other filter - files) are processed against the buffered content. Filters are - applied in the order they are specified in one of the filter files. - Animated GIFs, if present, are reduced to either the first or last - frame, depending on the action setting.The entire page, which is - now filtered, is then sent by <span class= - "APPLICATION">Privoxy</span> back to your browser.</p> - - <p>If neither a <a href="actions-file.html#FILTER"><span class= - "QUOTE">"+filter"</span></a> action or <a href= - "actions-file.html#DEANIMATE-GIFS"><span class= - "QUOTE">"+deanimate-gifs"</span></a> matches, then <span class= - "APPLICATION">Privoxy</span> passes the raw data through to the - client browser as it becomes available.</p> - </li> - - <li> - <p>As the browser receives the now (possibly filtered) page - content, it reads and then requests any URLs that may be embedded - within the page source, e.g. ad images, stylesheets, JavaScript, - other HTML documents (e.g. frames), sounds, etc. For each of these - objects, the browser issues a separate request (this is easily - viewable in <span class="APPLICATION">Privoxy's</span> logs). And - each such request is in turn processed just as above. Note that a - complex web page will have many, many such embedded URLs. If these - secondary requests are to a different server, then quite possibly a - very differing set of actions is triggered.</p> - </li> - </ul> - - <p>NOTE: This is somewhat of a simplistic overview of what happens with - each URL request. For the sake of brevity and simplicity, we have - focused on <span class="APPLICATION">Privoxy's</span> core features - only.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="ACTIONSANAT" id="ACTIONSANAT">14.4. - Troubleshooting: Anatomy of an Action</a></h2> - - <p>The way <span class="APPLICATION">Privoxy</span> applies <a href= - "actions-file.html#ACTIONS">actions</a> and <a href= - "actions-file.html#FILTER">filters</a> to any given URL can be complex, - and not always so easy to understand what is happening. And sometimes - we need to be able to <span class="emphasis EMPHASIS c2">see</span> - just what <span class="APPLICATION">Privoxy</span> is doing. - Especially, if something <span class="APPLICATION">Privoxy</span> is - doing is causing us a problem inadvertently. It can be a little - daunting to look at the actions and filters files themselves, since - they tend to be filled with <a href="appendix.html#REGEX">regular - expressions</a> whose consequences are not always so obvious.</p> - - <p>One quick test to see if <span class="APPLICATION">Privoxy</span> is - causing a problem or not, is to disable it temporarily. This should be - the first troubleshooting step. See <a href= - "appendix.html#BOOKMARKLETS">the Bookmarklets</a> section on a quick - and easy way to do this (be sure to flush caches afterward!). Looking - at the logs is a good idea too. (Note that both the toggle feature and - logging are enabled via <tt class="FILENAME">config</tt> file settings, - and may need to be turned <span class="QUOTE">"on"</span>.)</p> - - <p>Another easy troubleshooting step to try is if you have done any - customization of your installation, revert back to the installed - defaults and see if that helps. There are times the developers get - complaints about one thing or another, and the problem is more related - to a customized configuration issue.</p> - - <p><span class="APPLICATION">Privoxy</span> also provides the <a href= - "http://config.privoxy.org/show-url-info" target= - "_top">http://config.privoxy.org/show-url-info</a> page that can show - us very specifically how <span class="APPLICATION">actions</span> are - being applied to any given URL. This is a big help for - troubleshooting.</p> - - <p>First, enter one URL (or partial URL) at the prompt, and then - <span class="APPLICATION">Privoxy</span> will tell us how the current - configuration will handle it. This will not help with filtering effects - (i.e. the <a href="actions-file.html#FILTER"><span class= - "QUOTE">"+filter"</span></a> action) from one of the filter files since - this is handled very differently and not so easy to trap! It also will - not tell you about any other URLs that may be embedded within the URL - you are testing. For instance, images such as ads are expressed as URLs - within the raw page source of HTML pages. So you will only get info for - the actual URL that is pasted into the prompt area -- not any sub-URLs. - If you want to know about embedded URLs like ads, you will have to dig - those out of the HTML source. Use your browser's <span class= - "QUOTE">"View Page Source"</span> option for this. Or right click on - the ad, and grab the URL.</p> - - <p>Let's try an example, <a href="http://google.com" target= - "_top">google.com</a>, and look at it one section at a time in a sample - configuration (your real configuration may vary):</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - Matches for http://www.google.com: - - In file: default.action <span class="GUIBUTTON">[ View ]</span> <span class= -"GUIBUTTON">[ Edit ]</span> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Appendix</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="See Also" +HREF="seealso.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="seealso.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +> </TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="APPENDIX" +>14. Appendix</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="REGEX" +>14.1. Regular Expressions</A +></H2 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> uses Perl-style <SPAN +CLASS="QUOTE" +>"regular + expressions"</SPAN +> in its <A +HREF="actions-file.html" +>actions + files</A +> and <A +HREF="filter-file.html" +>filter file</A +>, + through the <A +HREF="http://www.pcre.org/" +TARGET="_top" +>PCRE</A +> and + <SPAN +CLASS="APPLICATION" +>PCRS</SPAN +> libraries.</P +><P +> If you are reading this, you probably don't understand what <SPAN +CLASS="QUOTE" +>"regular + expressions"</SPAN +> are, or what they can do. So this will be a very brief + introduction only. A full explanation would require a <A +HREF="http://www.oreilly.com/catalog/regex/" +TARGET="_top" +>book</A +> ;-)</P +><P +> Regular expressions provide a language to describe patterns that can be + run against strings of characters (letter, numbers, etc), to see if they + match the string or not. The patterns are themselves (sometimes complex) + strings of literal characters, combined with wild-cards, and other special + characters, called meta-characters. The <SPAN +CLASS="QUOTE" +>"meta-characters"</SPAN +> have + special meanings and are used to build complex patterns to be matched against. + Perl Compatible Regular Expressions are an especially convenient + <SPAN +CLASS="QUOTE" +>"dialect"</SPAN +> of the regular expression language.</P +><P +> To make a simple analogy, we do something similar when we use wild-card + characters when listing files with the <B +CLASS="COMMAND" +>dir</B +> command in DOS. + <TT +CLASS="LITERAL" +>*.*</TT +> matches all filenames. The <SPAN +CLASS="QUOTE" +>"special"</SPAN +> + character here is the asterisk which matches any and all characters. We can be + more specific and use <TT +CLASS="LITERAL" +>?</TT +> to match just individual + characters. So <SPAN +CLASS="QUOTE" +>"dir file?.text"</SPAN +> would match + <SPAN +CLASS="QUOTE" +>"file1.txt"</SPAN +>, <SPAN +CLASS="QUOTE" +>"file2.txt"</SPAN +>, etc. We are pattern + matching, using a similar technique to <SPAN +CLASS="QUOTE" +>"regular expressions"</SPAN +>!</P +><P +> Regular expressions do essentially the same thing, but are much, much more + powerful. There are many more <SPAN +CLASS="QUOTE" +>"special characters"</SPAN +> and ways of + building complex patterns however. Let's look at a few of the common ones, + and then some examples:</P +><P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>.</I +></SPAN +> - Matches any single character, e.g. <SPAN +CLASS="QUOTE" +>"a"</SPAN +>, + <SPAN +CLASS="QUOTE" +>"A"</SPAN +>, <SPAN +CLASS="QUOTE" +>"4"</SPAN +>, <SPAN +CLASS="QUOTE" +>":"</SPAN +>, or <SPAN +CLASS="QUOTE" +>"@"</SPAN +>. + </TD +></TR +></TBODY +></TABLE +><P +></P +></P +><P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>?</I +></SPAN +> - The preceding character or expression is matched ZERO or ONE + times. Either/or. + </TD +></TR +></TBODY +></TABLE +><P +></P +></P +><P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>+</I +></SPAN +> - The preceding character or expression is matched ONE or MORE + times. + </TD +></TR +></TBODY +></TABLE +><P +></P +></P +><P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>*</I +></SPAN +> - The preceding character or expression is matched ZERO or MORE + times. + </TD +></TR +></TBODY +></TABLE +><P +></P +></P +><P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +></I +></SPAN +> - The <SPAN +CLASS="QUOTE" +>"escape"</SPAN +> character denotes that + the following character should be taken literally. This is used where one of the + special characters (e.g. <SPAN +CLASS="QUOTE" +>"."</SPAN +>) needs to be taken literally and + not as a special meta-character. Example: <SPAN +CLASS="QUOTE" +>"example.com"</SPAN +>, makes + sure the period is recognized only as a period (and not expanded to its + meta-character meaning of any single character). + </TD +></TR +></TBODY +></TABLE +><P +></P +></P +><P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>[ ]</I +></SPAN +> - Characters enclosed in brackets will be matched if + any of the enclosed characters are encountered. For instance, <SPAN +CLASS="QUOTE" +>"[0-9]"</SPAN +> + matches any numeric digit (zero through nine). As an example, we can combine + this with <SPAN +CLASS="QUOTE" +>"+"</SPAN +> to match any digit one of more times: <SPAN +CLASS="QUOTE" +>"[0-9]+"</SPAN +>. + </TD +></TR +></TBODY +></TABLE +><P +></P +></P +><P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>( )</I +></SPAN +> - parentheses are used to group a sub-expression, + or multiple sub-expressions. + </TD +></TR +></TBODY +></TABLE +><P +></P +></P +><P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>|</I +></SPAN +> - The <SPAN +CLASS="QUOTE" +>"bar"</SPAN +> character works like an + <SPAN +CLASS="QUOTE" +>"or"</SPAN +> conditional statement. A match is successful if the + sub-expression on either side of <SPAN +CLASS="QUOTE" +>"|"</SPAN +> matches. As an example: + <SPAN +CLASS="QUOTE" +>"/(this|that) example/"</SPAN +> uses grouping and the bar character + and would match either <SPAN +CLASS="QUOTE" +>"this example"</SPAN +> or <SPAN +CLASS="QUOTE" +>"that + example"</SPAN +>, and nothing else. + </TD +></TR +></TBODY +></TABLE +><P +></P +></P +><P +> These are just some of the ones you are likely to use when matching URLs with + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, and is a long way from a definitive + list. This is enough to get us started with a few simple examples which may + be more illuminating:</P +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><TT +CLASS="LITERAL" +>/.*/banners/.*</TT +></I +></SPAN +> - A simple example + that uses the common combination of <SPAN +CLASS="QUOTE" +>"."</SPAN +> and <SPAN +CLASS="QUOTE" +>"*"</SPAN +> to + denote any character, zero or more times. In other words, any string at all. + So we start with a literal forward slash, then our regular expression pattern + (<SPAN +CLASS="QUOTE" +>".*"</SPAN +>) another literal forward slash, the string + <SPAN +CLASS="QUOTE" +>"banners"</SPAN +>, another forward slash, and lastly another + <SPAN +CLASS="QUOTE" +>".*"</SPAN +>. We are building + a directory path here. This will match any file with the path that has a + directory named <SPAN +CLASS="QUOTE" +>"banners"</SPAN +> in it. The <SPAN +CLASS="QUOTE" +>".*"</SPAN +> matches + any characters, and this could conceivably be more forward slashes, so it + might expand into a much longer looking path. For example, this could match: + <SPAN +CLASS="QUOTE" +>"/eye/hate/spammers/banners/annoy_me_please.gif"</SPAN +>, or just + <SPAN +CLASS="QUOTE" +>"/banners/annoying.html"</SPAN +>, or almost an infinite number of other + possible combinations, just so it has <SPAN +CLASS="QUOTE" +>"banners"</SPAN +> in the path + somewhere.</P +><P +> And now something a little more complex:</P +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><TT +CLASS="LITERAL" +>/.*/adv((er)?ts?|ertis(ing|ements?))?/</TT +></I +></SPAN +> - + We have several literal forward slashes again (<SPAN +CLASS="QUOTE" +>"/"</SPAN +>), so we are + building another expression that is a file path statement. We have another + <SPAN +CLASS="QUOTE" +>".*"</SPAN +>, so we are matching against any conceivable sub-path, just so + it matches our expression. The only true literal that <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>must + match</I +></SPAN +> our pattern is <SPAN +CLASS="APPLICATION" +>adv</SPAN +>, together with + the forward slashes. What comes after the <SPAN +CLASS="QUOTE" +>"adv"</SPAN +> string is the + interesting part. </P +><P +> Remember the <SPAN +CLASS="QUOTE" +>"?"</SPAN +> means the preceding expression (either a + literal character or anything grouped with <SPAN +CLASS="QUOTE" +>"(...)"</SPAN +> in this case) + can exist or not, since this means either zero or one match. So + <SPAN +CLASS="QUOTE" +>"((er)?ts?|ertis(ing|ements?))"</SPAN +> is optional, as are the + individual sub-expressions: <SPAN +CLASS="QUOTE" +>"(er)"</SPAN +>, + <SPAN +CLASS="QUOTE" +>"(ing|ements?)"</SPAN +>, and the <SPAN +CLASS="QUOTE" +>"s"</SPAN +>. The <SPAN +CLASS="QUOTE" +>"|"</SPAN +> + means <SPAN +CLASS="QUOTE" +>"or"</SPAN +>. We have two of those. For instance, + <SPAN +CLASS="QUOTE" +>"(ing|ements?)"</SPAN +>, can expand to match either <SPAN +CLASS="QUOTE" +>"ing"</SPAN +> + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>OR</I +></SPAN +> <SPAN +CLASS="QUOTE" +>"ements?"</SPAN +>. What is being done here, is an + attempt at matching as many variations of <SPAN +CLASS="QUOTE" +>"advertisement"</SPAN +>, and + similar, as possible. So this would expand to match just <SPAN +CLASS="QUOTE" +>"adv"</SPAN +>, + or <SPAN +CLASS="QUOTE" +>"advert"</SPAN +>, or <SPAN +CLASS="QUOTE" +>"adverts"</SPAN +>, or + <SPAN +CLASS="QUOTE" +>"advertising"</SPAN +>, or <SPAN +CLASS="QUOTE" +>"advertisement"</SPAN +>, or + <SPAN +CLASS="QUOTE" +>"advertisements"</SPAN +>. You get the idea. But it would not match + <SPAN +CLASS="QUOTE" +>"advertizements"</SPAN +> (with a <SPAN +CLASS="QUOTE" +>"z"</SPAN +>). We could fix that by + changing our regular expression to: + <SPAN +CLASS="QUOTE" +>"/.*/adv((er)?ts?|erti(s|z)(ing|ements?))?/"</SPAN +>, which would then match + either spelling.</P +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +><TT +CLASS="LITERAL" +>/.*/advert[0-9]+.(gif|jpe?g)</TT +></I +></SPAN +> - Again + another path statement with forward slashes. Anything in the square brackets + <SPAN +CLASS="QUOTE" +>"[ ]"</SPAN +> can be matched. This is using <SPAN +CLASS="QUOTE" +>"0-9"</SPAN +> as a + shorthand expression to mean any digit one through nine. It is the same as + saying <SPAN +CLASS="QUOTE" +>"0123456789"</SPAN +>. So any digit matches. The <SPAN +CLASS="QUOTE" +>"+"</SPAN +> + means one or more of the preceding expression must be included. The preceding + expression here is what is in the square brackets -- in this case, any digit + one through nine. Then, at the end, we have a grouping: <SPAN +CLASS="QUOTE" +>"(gif|jpe?g)"</SPAN +>. + This includes a <SPAN +CLASS="QUOTE" +>"|"</SPAN +>, so this needs to match the expression on + either side of that bar character also. A simple <SPAN +CLASS="QUOTE" +>"gif"</SPAN +> on one side, and the other + side will in turn match either <SPAN +CLASS="QUOTE" +>"jpeg"</SPAN +> or <SPAN +CLASS="QUOTE" +>"jpg"</SPAN +>, + since the <SPAN +CLASS="QUOTE" +>"?"</SPAN +> means the letter <SPAN +CLASS="QUOTE" +>"e"</SPAN +> is optional and + can be matched once or not at all. So we are building an expression here to + match image GIF or JPEG type image file. It must include the literal + string <SPAN +CLASS="QUOTE" +>"advert"</SPAN +>, then one or more digits, and a <SPAN +CLASS="QUOTE" +>"."</SPAN +> + (which is now a literal, and not a special character, since it is escaped + with <SPAN +CLASS="QUOTE" +>""</SPAN +>), and lastly either <SPAN +CLASS="QUOTE" +>"gif"</SPAN +>, or + <SPAN +CLASS="QUOTE" +>"jpeg"</SPAN +>, or <SPAN +CLASS="QUOTE" +>"jpg"</SPAN +>. Some possible matches would + include: <SPAN +CLASS="QUOTE" +>"//advert1.jpg"</SPAN +>, + <SPAN +CLASS="QUOTE" +>"/nasty/ads/advert1234.gif"</SPAN +>, + <SPAN +CLASS="QUOTE" +>"/banners/from/hell/advert99.jpg"</SPAN +>. It would not match + <SPAN +CLASS="QUOTE" +>"advert1.gif"</SPAN +> (no leading slash), or + <SPAN +CLASS="QUOTE" +>"/adverts232.jpg"</SPAN +> (the expression does not include an + <SPAN +CLASS="QUOTE" +>"s"</SPAN +>), or <SPAN +CLASS="QUOTE" +>"/advert1.jsp"</SPAN +> (<SPAN +CLASS="QUOTE" +>"jsp"</SPAN +> is not + in the expression anywhere).</P +><P +> We are barely scratching the surface of regular expressions here so that you + can understand the default <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + configuration files, and maybe use this knowledge to customize your own + installation. There is much, much more that can be done with regular + expressions. Now that you know enough to get started, you can learn more on + your own :/</P +><P +> More reading on Perl Compatible Regular expressions: + <A +HREF="http://perldoc.perl.org/perlre.html" +TARGET="_top" +>http://perldoc.perl.org/perlre.html</A +></P +><P +> For information on regular expression based substitutions and their applications + in filters, please see the <A +HREF="filter-file.html" +>filter file tutorial</A +> + in this manual.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN5174" +>14.2. Privoxy's Internal Pages</A +></H2 +><P +> Since <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> proxies each requested + web page, it is easy for <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to + trap certain special URLs. In this way, we can talk directly to + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, and see how it is + configured, see how our rules are being applied, change these + rules and other configuration options, and even turn + <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> filtering off, all with + a web browser. </P +><P +> The URLs listed below are the special ones that allow direct access + to <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. Of course, + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> must be running to access these. If + not, you will get a friendly error message. Internet access is not + necessary either.</P +><P +> <P +></P +><UL +><LI +><P +> + Privoxy main page: + </P +><A +NAME="AEN5188" +></A +><BLOCKQUOTE +CLASS="BLOCKQUOTE" +><P +> + <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>http://config.privoxy.org/</A +> + </P +></BLOCKQUOTE +><P +> There is a shortcut: <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +> (But it + doesn't provide a fall-back to a real page, in case the request is not + sent through <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>) + </P +></LI +><LI +><P +> + Show information about the current configuration, including viewing and + editing of actions files: + </P +><A +NAME="AEN5196" +></A +><BLOCKQUOTE +CLASS="BLOCKQUOTE" +><P +> + <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +> + </P +></BLOCKQUOTE +></LI +><LI +><P +> + Show the source code version numbers: + </P +><A +NAME="AEN5201" +></A +><BLOCKQUOTE +CLASS="BLOCKQUOTE" +><P +> + <A +HREF="http://config.privoxy.org/show-version" +TARGET="_top" +>http://config.privoxy.org/show-version</A +> + </P +></BLOCKQUOTE +></LI +><LI +><P +> + Show the browser's request headers: + </P +><A +NAME="AEN5206" +></A +><BLOCKQUOTE +CLASS="BLOCKQUOTE" +><P +> + <A +HREF="http://config.privoxy.org/show-request" +TARGET="_top" +>http://config.privoxy.org/show-request</A +> + </P +></BLOCKQUOTE +></LI +><LI +><P +> + Show which actions apply to a URL and why: + </P +><A +NAME="AEN5211" +></A +><BLOCKQUOTE +CLASS="BLOCKQUOTE" +><P +> + <A +HREF="http://config.privoxy.org/show-url-info" +TARGET="_top" +>http://config.privoxy.org/show-url-info</A +> + </P +></BLOCKQUOTE +></LI +><LI +><P +> + Toggle Privoxy on or off. This feature can be turned off/on in the main + <TT +CLASS="FILENAME" +>config</TT +> file. When toggled <SPAN +CLASS="QUOTE" +>"off"</SPAN +>, <SPAN +CLASS="QUOTE" +>"Privoxy"</SPAN +> + continues to run, but only as a pass-through proxy, with no actions taking + place: + </P +><A +NAME="AEN5219" +></A +><BLOCKQUOTE +CLASS="BLOCKQUOTE" +><P +> + <A +HREF="http://config.privoxy.org/toggle" +TARGET="_top" +>http://config.privoxy.org/toggle</A +> + </P +></BLOCKQUOTE +><P +> Short cuts. Turn off, then on: + </P +><A +NAME="AEN5223" +></A +><BLOCKQUOTE +CLASS="BLOCKQUOTE" +><P +> + <A +HREF="http://config.privoxy.org/toggle?set=disable" +TARGET="_top" +>http://config.privoxy.org/toggle?set=disable</A +> + </P +></BLOCKQUOTE +><A +NAME="AEN5226" +></A +><BLOCKQUOTE +CLASS="BLOCKQUOTE" +><P +> + <A +HREF="http://config.privoxy.org/toggle?set=enable" +TARGET="_top" +>http://config.privoxy.org/toggle?set=enable</A +> + </P +></BLOCKQUOTE +></LI +></UL +></P +><P +> These may be bookmarked for quick reference. See next. </P +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="BOOKMARKLETS" +>14.2.1. Bookmarklets</A +></H3 +><P +> Below are some <SPAN +CLASS="QUOTE" +>"bookmarklets"</SPAN +> to allow you to easily access a + <SPAN +CLASS="QUOTE" +>"mini"</SPAN +> version of some of <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + special pages. They are designed for MS Internet Explorer, but should work + equally well in Netscape, Mozilla, and other browsers which support + JavaScript. They are designed to run directly from your bookmarks - not by + clicking the links below (although that should work for testing).</P +><P +> To save them, right-click the link and choose <SPAN +CLASS="QUOTE" +>"Add to Favorites"</SPAN +> + (IE) or <SPAN +CLASS="QUOTE" +>"Add Bookmark"</SPAN +> (Netscape). You will get a warning that + the bookmark <SPAN +CLASS="QUOTE" +>"may not be safe"</SPAN +> - just click OK. Then you can run the + Bookmarklet directly from your favorites/bookmarks. For even faster access, + you can put them on the <SPAN +CLASS="QUOTE" +>"Links"</SPAN +> bar (IE) or the <SPAN +CLASS="QUOTE" +>"Personal + Toolbar"</SPAN +> (Netscape), and run them with a single click. </P +><P +> <P +></P +><UL +><LI +><P +> <A +HREF="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=enabled%27,%27ijbstatus%27,%...));" +TARGET="_top" +>Privoxy - Enable</A +> + </P +></LI +><LI +><P +> <A +HREF="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=disabled%27,%27ijbstatus%27,...));" +TARGET="_top" +>Privoxy - Disable</A +> + </P +></LI +><LI +><P +> <A +HREF="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&set=toggle%27,%27ijbstatus%27,%2...));" +TARGET="_top" +>Privoxy - Toggle Privoxy</A +> (Toggles between enabled and disabled) + </P +></LI +><LI +><P +> <A +HREF="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y%27,%27ijbstatus%27,%27width=250,heig...));" +TARGET="_top" +>Privoxy- View Status</A +> + </P +></LI +><LI +><P +> <A +HREF="javascript:void(window.open('http://config.privoxy.org/show-url-info?url=%27+escape(location.href),%27Why...));" +TARGET="_top" +>Privoxy - Why?</A +> + </P +></LI +></UL +></P +><P +> Credit: The site which gave us the general idea for these bookmarklets is + <A +HREF="http://www.bookmarklets.com/" +TARGET="_top" +>www.bookmarklets.com</A +>. They + have more information about bookmarklets. </P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CHAIN" +>14.3. Chain of Events</A +></H2 +><P +> Let's take a quick look at how some of <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + core features are triggered, and the ensuing sequence of events when a web + page is requested by your browser:</P +><P +> <P +></P +><UL +><LI +><P +> First, your web browser requests a web page. The browser knows to send + the request to <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, which will in turn, + relay the request to the remote web server after passing the following + tests: + </P +></LI +><LI +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> traps any request for its own internal CGI + pages (e.g <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +>) and sends the CGI page back to the browser. + </P +></LI +><LI +><P +> Next, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> checks to see if the URL + matches any <A +HREF="actions-file.html#BLOCK" +><SPAN +CLASS="QUOTE" +>"+block"</SPAN +></A +> patterns. If + so, the URL is then blocked, and the remote web server will not be contacted. + <A +HREF="actions-file.html#HANDLE-AS-IMAGE" +><SPAN +CLASS="QUOTE" +>"+handle-as-image"</SPAN +></A +> + and + <A +HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT" +><SPAN +CLASS="QUOTE" +>"+handle-as-empty-document"</SPAN +></A +> + are then checked, and if there is no match, an + HTML <SPAN +CLASS="QUOTE" +>"BLOCKED"</SPAN +> page is sent back to the browser. Otherwise, if + it does match, an image is returned for the former, and an empty text + document for the latter. The type of image would depend on the setting of + <A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +><SPAN +CLASS="QUOTE" +>"+set-image-blocker"</SPAN +></A +> + (blank, checkerboard pattern, or an HTTP redirect to an image elsewhere). + </P +></LI +><LI +><P +> Untrusted URLs are blocked. If URLs are being added to the + <TT +CLASS="FILENAME" +>trust</TT +> file, then that is done. + </P +></LI +><LI +><P +> If the URL pattern matches the <A +HREF="actions-file.html#FAST-REDIRECTS" +><SPAN +CLASS="QUOTE" +>"+fast-redirects"</SPAN +></A +> action, + it is then processed. Unwanted parts of the requested URL are stripped. + </P +></LI +><LI +><P +> Now the rest of the client browser's request headers are processed. If any + of these match any of the relevant actions (e.g. <A +HREF="actions-file.html#HIDE-USER-AGENT" +><SPAN +CLASS="QUOTE" +>"+hide-user-agent"</SPAN +></A +>, + etc.), headers are suppressed or forged as determined by these actions and + their parameters. + </P +></LI +><LI +><P +> Now the web server starts sending its response back (i.e. typically a web + page). + </P +></LI +><LI +><P +> First, the server headers are read and processed to determine, among other + things, the MIME type (document type) and encoding. The headers are then + filtered as determined by the + <A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +><SPAN +CLASS="QUOTE" +>"+crunch-incoming-cookies"</SPAN +></A +>, + <A +HREF="actions-file.html#SESSION-COOKIES-ONLY" +><SPAN +CLASS="QUOTE" +>"+session-cookies-only"</SPAN +></A +>, + and <A +HREF="actions-file.html#DOWNGRADE-HTTP-VERSION" +><SPAN +CLASS="QUOTE" +>"+downgrade-http-version"</SPAN +></A +> + actions. + </P +></LI +><LI +><P +> If any <A +HREF="actions-file.html#FILTER" +><SPAN +CLASS="QUOTE" +>"+filter"</SPAN +></A +> action + or <A +HREF="actions-file.html#DEANIMATE-GIFS" +><SPAN +CLASS="QUOTE" +>"+deanimate-gifs"</SPAN +></A +> + action applies (and the document type fits the action), the rest of the page is + read into memory (up to a configurable limit). Then the filter rules (from + <TT +CLASS="FILENAME" +>default.filter</TT +> and any other filter files) are + processed against the buffered content. Filters are applied in the order + they are specified in one of the filter files. Animated GIFs, if present, + are reduced to either the first or last frame, depending on the action + setting.The entire page, which is now filtered, is then sent by + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> back to your browser. + </P +><P +> If neither a <A +HREF="actions-file.html#FILTER" +><SPAN +CLASS="QUOTE" +>"+filter"</SPAN +></A +> action + or <A +HREF="actions-file.html#DEANIMATE-GIFS" +><SPAN +CLASS="QUOTE" +>"+deanimate-gifs"</SPAN +></A +> + matches, then <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> passes the raw data through + to the client browser as it becomes available. + </P +></LI +><LI +><P +> As the browser receives the now (possibly filtered) page content, it + reads and then requests any URLs that may be embedded within the page + source, e.g. ad images, stylesheets, JavaScript, other HTML documents (e.g. + frames), sounds, etc. For each of these objects, the browser issues a + separate request (this is easily viewable in <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + logs). And each such request is in turn processed just as above. Note that a + complex web page will have many, many such embedded URLs. If these + secondary requests are to a different server, then quite possibly a very + differing set of actions is triggered. + </P +></LI +></UL +></P +><P +> NOTE: This is somewhat of a simplistic overview of what happens with each URL + request. For the sake of brevity and simplicity, we have focused on + <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> core features only.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="ACTIONSANAT" +>14.4. Troubleshooting: Anatomy of an Action</A +></H2 +><P +> The way <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> applies + <A +HREF="actions-file.html#ACTIONS" +>actions</A +> and <A +HREF="actions-file.html#FILTER" +>filters</A +> + to any given URL can be complex, and not always so + easy to understand what is happening. And sometimes we need to be able to + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>see</I +></SPAN +> just what <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is + doing. Especially, if something <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is doing + is causing us a problem inadvertently. It can be a little daunting to look at + the actions and filters files themselves, since they tend to be filled with + <A +HREF="appendix.html#REGEX" +>regular expressions</A +> whose consequences are not + always so obvious. </P +><P +> One quick test to see if <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is causing a problem + or not, is to disable it temporarily. This should be the first troubleshooting + step. See <A +HREF="appendix.html#BOOKMARKLETS" +>the Bookmarklets</A +> section on a quick + and easy way to do this (be sure to flush caches afterward!). Looking at the + logs is a good idea too. (Note that both the toggle feature and logging are + enabled via <TT +CLASS="FILENAME" +>config</TT +> file settings, and may need to be + turned <SPAN +CLASS="QUOTE" +>"on"</SPAN +>.)</P +><P +> Another easy troubleshooting step to try is if you have done any + customization of your installation, revert back to the installed + defaults and see if that helps. There are times the developers get complaints + about one thing or another, and the problem is more related to a customized + configuration issue.</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> also provides the + <A +HREF="http://config.privoxy.org/show-url-info" +TARGET="_top" +>http://config.privoxy.org/show-url-info</A +> + page that can show us very specifically how <SPAN +CLASS="APPLICATION" +>actions</SPAN +> + are being applied to any given URL. This is a big help for troubleshooting.</P +><P +> First, enter one URL (or partial URL) at the prompt, and then + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will tell us + how the current configuration will handle it. This will not + help with filtering effects (i.e. the <A +HREF="actions-file.html#FILTER" +><SPAN +CLASS="QUOTE" +>"+filter"</SPAN +></A +> action) from + one of the filter files since this is handled very + differently and not so easy to trap! It also will not tell you about any other + URLs that may be embedded within the URL you are testing. For instance, images + such as ads are expressed as URLs within the raw page source of HTML pages. So + you will only get info for the actual URL that is pasted into the prompt area + -- not any sub-URLs. If you want to know about embedded URLs like ads, you + will have to dig those out of the HTML source. Use your browser's <SPAN +CLASS="QUOTE" +>"View + Page Source"</SPAN +> option for this. Or right click on the ad, and grab the + URL.</P +><P +> Let's try an example, <A +HREF="http://google.com" +TARGET="_top" +>google.com</A +>, + and look at it one section at a time in a sample configuration (your real + configuration may vary):</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> Matches for http://www.google.com: + + In file: default.action <SPAN +CLASS="GUIBUTTON" +>[ View ]</SPAN +> <SPAN +CLASS="GUIBUTTON" +>[ Edit ]</SPAN +>
{+change-x-forwarded-for{block} +deanimate-gifs {last} @@ -675,86 +1464,180 @@ body { +session-cookies-only +set-image-blocker {pattern} / - + { -session-cookies-only } .google.com
{ -fast-redirects } .google.com
-In file: user.action <span class="GUIBUTTON">[ View ]</span> <span class= -"GUIBUTTON">[ Edit ]</span> -(no matches in this file) -</pre> - </td> - </tr> - </table> - - <p>This is telling us how we have defined our <a href= - "actions-file.html#ACTIONS"><span class="QUOTE">"actions"</span></a>, - and which ones match for our test case, <span class= - "QUOTE">"google.com"</span>. Displayed is all the actions that are - available to us. Remember, the <tt class="LITERAL">+</tt> sign denotes - <span class="QUOTE">"on"</span>. <tt class="LITERAL">-</tt> denotes - <span class="QUOTE">"off"</span>. So some are <span class= - "QUOTE">"on"</span> here, but many are <span class= - "QUOTE">"off"</span>. Each example we try may provide a slightly - different end result, depending on our configuration directives.</p> - - <p>The first listing is for our <tt class= - "FILENAME">default.action</tt> file. The large, multi-line listing, is - how the actions are set to match for all URLs, i.e. our default - settings. If you look at your <span class="QUOTE">"actions"</span> - file, this would be the section just below the <span class= - "QUOTE">"aliases"</span> section near the top. This will apply to all - URLs as signified by the single forward slash at the end of the listing - -- <span class="QUOTE">" / "</span>.</p> - - <p>But we have defined additional actions that would be exceptions to - these general rules, and then we list specific URLs (or patterns) that - these exceptions would apply to. Last match wins. Just below this then - are two explicit matches for <span class="QUOTE">".google.com"</span>. - The first is negating our previous cookie setting, which was for - <a href="actions-file.html#SESSION-COOKIES-ONLY"><span class= - "QUOTE">"+session-cookies-only"</span></a> (i.e. not persistent). So we - will allow persistent cookies for google, at least that is how it is in - this example. The second turns <span class= - "emphasis EMPHASIS c2">off</span> any <a href= - "actions-file.html#FAST-REDIRECTS"><span class= - "QUOTE">"+fast-redirects"</span></a> action, allowing this to take - place unmolested. Note that there is a leading dot here -- <span class= - "QUOTE">".google.com"</span>. This will match any hosts and - sub-domains, in the google.com domain also, such as <span class= - "QUOTE">"www.google.com"</span> or <span class= - "QUOTE">"mail.google.com"</span>. But it would not match <span class= - "QUOTE">"www.google.de"</span>! So, apparently, we have these two - actions defined as exceptions to the general rules at the top somewhere - in the lower part of our <tt class="FILENAME">default.action</tt> file, - and <span class="QUOTE">"google.com"</span> is referenced somewhere in - these latter sections.</p> - - <p>Then, for our <tt class="FILENAME">user.action</tt> file, we again - have no hits. So there is nothing google-specific that we might have - added to our own, local configuration. If there was, those actions - would over-rule any actions from previously processed files, such as - <tt class="FILENAME">default.action</tt>. <tt class= - "FILENAME">user.action</tt> typically has the last word. This is the - best place to put hard and fast exceptions,</p> - - <p>And finally we pull it all together in the bottom section and - summarize how <span class="APPLICATION">Privoxy</span> is applying all - its <span class="QUOTE">"actions"</span> to <span class= - "QUOTE">"google.com"</span>:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - Final results: - +In file: user.action <SPAN +CLASS="GUIBUTTON" +>[ View ]</SPAN +> <SPAN +CLASS="GUIBUTTON" +>[ Edit ]</SPAN +> +(no matches in this file) </PRE +></TD +></TR +></TABLE +></P +><P +> This is telling us how we have defined our + <A +HREF="actions-file.html#ACTIONS" +><SPAN +CLASS="QUOTE" +>"actions"</SPAN +></A +>, and + which ones match for our test case, <SPAN +CLASS="QUOTE" +>"google.com"</SPAN +>. + Displayed is all the actions that are available to us. Remember, + the <TT +CLASS="LITERAL" +>+</TT +> sign denotes <SPAN +CLASS="QUOTE" +>"on"</SPAN +>. <TT +CLASS="LITERAL" +>-</TT +> + denotes <SPAN +CLASS="QUOTE" +>"off"</SPAN +>. So some are <SPAN +CLASS="QUOTE" +>"on"</SPAN +> here, but many + are <SPAN +CLASS="QUOTE" +>"off"</SPAN +>. Each example we try may provide a slightly different + end result, depending on our configuration directives.</P +><P +> The first listing + is for our <TT +CLASS="FILENAME" +>default.action</TT +> file. The large, multi-line + listing, is how the actions are set to match for all URLs, i.e. our default + settings. If you look at your <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> file, this would be the + section just below the <SPAN +CLASS="QUOTE" +>"aliases"</SPAN +> section near the top. This + will apply to all URLs as signified by the single forward slash at the end + of the listing -- <SPAN +CLASS="QUOTE" +>" / "</SPAN +>.</P +><P +> But we have defined additional actions that would be exceptions to these general + rules, and then we list specific URLs (or patterns) that these exceptions + would apply to. Last match wins. Just below this then are two explicit + matches for <SPAN +CLASS="QUOTE" +>".google.com"</SPAN +>. The first is negating our previous + cookie setting, which was for <A +HREF="actions-file.html#SESSION-COOKIES-ONLY" +><SPAN +CLASS="QUOTE" +>"+session-cookies-only"</SPAN +></A +> + (i.e. not persistent). So we will allow persistent cookies for google, at + least that is how it is in this example. The second turns + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>off</I +></SPAN +> any <A +HREF="actions-file.html#FAST-REDIRECTS" +><SPAN +CLASS="QUOTE" +>"+fast-redirects"</SPAN +></A +> + action, allowing this to take place unmolested. Note that there is a leading + dot here -- <SPAN +CLASS="QUOTE" +>".google.com"</SPAN +>. This will match any hosts and + sub-domains, in the google.com domain also, such as + <SPAN +CLASS="QUOTE" +>"www.google.com"</SPAN +> or <SPAN +CLASS="QUOTE" +>"mail.google.com"</SPAN +>. But it would not + match <SPAN +CLASS="QUOTE" +>"www.google.de"</SPAN +>! So, apparently, we have these two actions + defined as exceptions to the general rules at the top somewhere in the lower + part of our <TT +CLASS="FILENAME" +>default.action</TT +> file, and + <SPAN +CLASS="QUOTE" +>"google.com"</SPAN +> is referenced somewhere in these latter sections.</P +><P +> Then, for our <TT +CLASS="FILENAME" +>user.action</TT +> file, we again have no hits. + So there is nothing google-specific that we might have added to our own, local + configuration. If there was, those actions would over-rule any actions from + previously processed files, such as <TT +CLASS="FILENAME" +>default.action</TT +>. + <TT +CLASS="FILENAME" +>user.action</TT +> typically has the last word. This is the + best place to put hard and fast exceptions,</P +><P +> And finally we pull it all together in the bottom section and summarize how + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is applying all its <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> + to <SPAN +CLASS="QUOTE" +>"google.com"</SPAN +>: </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> Final results: + -add-header -block - +change-x-forwarded-for{block} + +change-x-forwarded-for{block} -client-header-filter{hide-tor-exit-notation} -content-type-overwrite -crunch-client-header @@ -805,79 +1688,142 @@ In file: user.action <span class="GUIBUTTON">[ View ]</span> <span class= -prevent-compression -redirect -server-header-filter{xml-to-html} - -server-header-filter{html-to-xml} + -server-header-filter{html-to-xml} -session-cookies-only - +set-image-blocker {pattern} -</pre> - </td> - </tr> - </table> - - <p>Notice the only difference here to the previous listing, is to - <span class="QUOTE">"fast-redirects"</span> and <span class= - "QUOTE">"session-cookies-only"</span>, which are activated specifically - for this site in our configuration, and thus show in the <span class= - "QUOTE">"Final Results"</span>.</p> - - <p>Now another example, <span class= - "QUOTE">"ad.doubleclick.net"</span>:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - { +block{Domains starts with "ad"} } + +set-image-blocker {pattern} </PRE +></TD +></TR +></TABLE +></P +><P +> Notice the only difference here to the previous listing, is to + <SPAN +CLASS="QUOTE" +>"fast-redirects"</SPAN +> and <SPAN +CLASS="QUOTE" +>"session-cookies-only"</SPAN +>, + which are activated specifically for this site in our configuration, + and thus show in the <SPAN +CLASS="QUOTE" +>"Final Results"</SPAN +>.</P +><P +> Now another example, <SPAN +CLASS="QUOTE" +>"ad.doubleclick.net"</SPAN +>:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> { +block{Domains starts with "ad"} } ad*.
{ +block{Domain contains "ad"} } .ad.
{ +block{Doubleclick banner server} +handle-as-image } - .[a-vx-z]*.doubleclick.net -</pre> - </td> - </tr> - </table> - - <p>We'll just show the interesting part here - the explicit matches. It - is matched three different times. Two <span class= - "QUOTE">"+block{}"</span> sections, and a <span class="QUOTE">"+block{} - +handle-as-image"</span>, which is the expanded form of one of our - aliases that had been defined as: <span class= - "QUOTE">"+block-as-image"</span>. (<a href= - "actions-file.html#ALIASES"><span class="QUOTE">"Aliases"</span></a> - are defined in the first section of the actions file and typically used - to combine more than one action.)</p> - - <p>Any one of these would have done the trick and blocked this as an - unwanted image. This is unnecessarily redundant since the last case - effectively would also cover the first. No point in taking chances with - these guys though ;-) Note that if you want an ad or obnoxious URL to - be invisible, it should be defined as <span class= - "QUOTE">"ad.doubleclick.net"</span> is done here -- as both a <a href= - "actions-file.html#BLOCK"><span class="QUOTE">"+block{}"</span></a> - <span class="emphasis EMPHASIS c2">and</span> an <a href= - "actions-file.html#HANDLE-AS-IMAGE"><span class= - "QUOTE">"+handle-as-image"</span></a>. The custom alias <span class= - "QUOTE">"<tt class="LITERAL">+block-as-image</tt>"</span> just - simplifies the process and make it more readable.</p> - - <p>One last example. Let's try <span class= - "QUOTE">"http://www.example.net/adsl/HOWTO/"</span>. This one is giving - us problems. We are getting a blank page. Hmmm ...</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - Matches for http://www.example.net/adsl/HOWTO/: - - In file: default.action <span class="GUIBUTTON">[ View ]</span> <span class= -"GUIBUTTON">[ Edit ]</span> - - {-add-header + .[a-vx-z]*.doubleclick.net</PRE +></TD +></TR +></TABLE +></P +><P +> We'll just show the interesting part here - the explicit matches. It is + matched three different times. Two <SPAN +CLASS="QUOTE" +>"+block{}"</SPAN +> sections, + and a <SPAN +CLASS="QUOTE" +>"+block{} +handle-as-image"</SPAN +>, + which is the expanded form of one of our aliases that had been defined as: + <SPAN +CLASS="QUOTE" +>"+block-as-image"</SPAN +>. (<A +HREF="actions-file.html#ALIASES" +><SPAN +CLASS="QUOTE" +>"Aliases"</SPAN +></A +> are defined in + the first section of the actions file and typically used to combine more + than one action.)</P +><P +> Any one of these would have done the trick and blocked this as an unwanted + image. This is unnecessarily redundant since the last case effectively + would also cover the first. No point in taking chances with these guys + though ;-) Note that if you want an ad or obnoxious + URL to be invisible, it should be defined as <SPAN +CLASS="QUOTE" +>"ad.doubleclick.net"</SPAN +> + is done here -- as both a <A +HREF="actions-file.html#BLOCK" +><SPAN +CLASS="QUOTE" +>"+block{}"</SPAN +></A +> + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>and</I +></SPAN +> an + <A +HREF="actions-file.html#HANDLE-AS-IMAGE" +><SPAN +CLASS="QUOTE" +>"+handle-as-image"</SPAN +></A +>. + The custom alias <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +>+block-as-image</TT +>"</SPAN +> just + simplifies the process and make it more readable.</P +><P +> One last example. Let's try <SPAN +CLASS="QUOTE" +>"http://www.example.net/adsl/HOWTO/"</SPAN +>. + This one is giving us problems. We are getting a blank page. Hmmm ...</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> Matches for http://www.example.net/adsl/HOWTO/: + + In file: default.action <SPAN +CLASS="GUIBUTTON" +>[ View ]</SPAN +> <SPAN +CLASS="GUIBUTTON" +>[ Edit ]</SPAN +> + + {-add-header -block - +change-x-forwarded-for{block} + +change-x-forwarded-for{block} -client-header-filter{hide-tor-exit-notation} -content-type-overwrite -crunch-client-header @@ -885,8 +1831,8 @@ In file: user.action <span class="GUIBUTTON">[ View ]</span> <span class= -crunch-incoming-cookies -crunch-outgoing-cookies -crunch-server-header - +deanimate-gifs - -downgrade-http-version + +deanimate-gifs + -downgrade-http-version +fast-redirects {check-decoded-url} -filter {js-events} -filter {content-cookies} @@ -916,186 +1862,326 @@ In file: user.action <span class="GUIBUTTON">[ View ]</span> <span class= -filter {no-ping} -force-text-mode -handle-as-empty-document - -handle-as-image + -handle-as-image -hide-accept-language - -hide-content-disposition - +hide-from-header{block} - +hide-referer{forge} - -hide-user-agent + -hide-content-disposition + +hide-from-header{block} + +hide-referer{forge} + -hide-user-agent -overwrite-last-modified - +prevent-compression + +prevent-compression -redirect -server-header-filter{xml-to-html} - -server-header-filter{html-to-xml} - +session-cookies-only + -server-header-filter{html-to-xml} + +session-cookies-only +set-image-blocker{blank} } /
{ +block{Path contains "ads".} +handle-as-image } - /ads -</pre> - </td> - </tr> - </table> - - <p>Ooops, the <span class="QUOTE">"/adsl/"</span> is matching - <span class="QUOTE">"/ads"</span> in our configuration! But we did not - want this at all! Now we see why we get the blank page. It is actually - triggering two different actions here, and the effects are aggregated - so that the URL is blocked, and <span class= - "APPLICATION">Privoxy</span> is told to treat the block as if it were - an image. But this is, of course, all wrong. We could now add a new - action below this (or better in our own <tt class= - "FILENAME">user.action</tt> file) that explicitly <span class= - "emphasis EMPHASIS c2">un</span> blocks ( <a href= - "actions-file.html#BLOCK"><span class="QUOTE">"{-block}"</span></a>) - paths with <span class="QUOTE">"adsl"</span> in them (remember, last - match in the configuration wins). There are various ways to handle such - exceptions. Example:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - { -block } - /adsl -</pre> - </td> - </tr> - </table> - - <p>Now the page displays ;-) Remember to flush your browser's caches - when making these kinds of changes to your configuration to insure that - you get a freshly delivered page! Or, try using <tt class= - "LITERAL">Shift+Reload</tt>.</p> - - <p>But now what about a situation where we get no explicit matches like - we did with:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - { +block{Path starts with "ads".} +handle-as-image } - /ads -</pre> - </td> - </tr> - </table> - - <p>That actually was very helpful and pointed us quickly to where the - problem was. If you don't get this kind of match, then it means one of - the default rules in the first section of <tt class= - "FILENAME">default.action</tt> is causing the problem. This would - require some guesswork, and maybe a little trial and error to isolate - the offending rule. One likely cause would be one of the <a href= - "actions-file.html#FILTER"><span class="QUOTE">"+filter"</span></a> - actions. These tend to be harder to troubleshoot. Try adding the URL - for the site to one of aliases that turn off <a href= - "actions-file.html#FILTER"><span class= - "QUOTE">"+filter"</span></a>:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - { shop } + /ads</PRE +></TD +></TR +></TABLE +></P +><P +> Ooops, the <SPAN +CLASS="QUOTE" +>"/adsl/"</SPAN +> is matching <SPAN +CLASS="QUOTE" +>"/ads"</SPAN +> in our + configuration! But we did not want this at all! Now we see why we get the + blank page. It is actually triggering two different actions here, and + the effects are aggregated so that the URL is blocked, and <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is told + to treat the block as if it were an image. But this is, of course, all wrong. + We could now add a new action below this (or better in our own + <TT +CLASS="FILENAME" +>user.action</TT +> file) that explicitly + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>un</I +></SPAN +> blocks ( + <A +HREF="actions-file.html#BLOCK" +><SPAN +CLASS="QUOTE" +>"{-block}"</SPAN +></A +>) paths with + <SPAN +CLASS="QUOTE" +>"adsl"</SPAN +> in them (remember, last match in the configuration + wins). There are various ways to handle such exceptions. Example:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> { -block } + /adsl</PRE +></TD +></TR +></TABLE +></P +><P +> Now the page displays ;-) + Remember to flush your browser's caches when making these kinds of changes to + your configuration to insure that you get a freshly delivered page! Or, try + using <TT +CLASS="LITERAL" +>Shift+Reload</TT +>.</P +><P +> But now what about a situation where we get no explicit matches like + we did with:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> { +block{Path starts with "ads".} +handle-as-image } + /ads</PRE +></TD +></TR +></TABLE +></P +><P +> That actually was very helpful and pointed us quickly to where the problem + was. If you don't get this kind of match, then it means one of the default + rules in the first section of <TT +CLASS="FILENAME" +>default.action</TT +> is causing + the problem. This would require some guesswork, and maybe a little trial and + error to isolate the offending rule. One likely cause would be one of the + <A +HREF="actions-file.html#FILTER" +><SPAN +CLASS="QUOTE" +>"+filter"</SPAN +></A +> actions. + These tend to be harder to troubleshoot. + Try adding the URL for the site to one of aliases that turn off + <A +HREF="actions-file.html#FILTER" +><SPAN +CLASS="QUOTE" +>"+filter"</SPAN +></A +>:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> { shop } .quietpc.com .worldpay.com # for quietpc.com .jungle.com .scan.co.uk - .forbes.com -</pre> - </td> - </tr> - </table> - - <p><span class="QUOTE">"<tt class="LITERAL">{ shop }</tt>"</span> is an - <span class="QUOTE">"alias"</span> that expands to <span class= - "QUOTE">"<tt class="LITERAL">{ -filter -session-cookies-only - }</tt>"</span>. Or you could do your own exception to negate - filtering:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - { -filter } + .forbes.com</PRE +></TD +></TR +></TABLE +></P +><P +> <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +>{ shop }</TT +>"</SPAN +> is an <SPAN +CLASS="QUOTE" +>"alias"</SPAN +> that expands to + <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +>{ -filter -session-cookies-only }</TT +>"</SPAN +>. + Or you could do your own exception to negate filtering: </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> { -filter } # Disable ALL filter actions for sites in this section .forbes.com developer.ibm.com - localhost -</pre> - </td> - </tr> - </table> - - <p>This would turn off all filtering for these sites. This is best put - in <tt class="FILENAME">user.action</tt>, for local site exceptions. - Note that when a simple domain pattern is used by itself (without the - subsequent path portion), all sub-pages within that domain are included - automatically in the scope of the action.</p> - - <p>Images that are inexplicably being blocked, may well be hitting the - <a href="actions-file.html#FILTER-BANNERS-BY-SIZE"><span class= - "QUOTE">"+filter{banners-by-size}"</span></a> rule, which assumes that - images of certain sizes are ad banners (works well <span class= - "emphasis EMPHASIS c2">most of the time</span> since these tend to be - standardized).</p> - - <p><span class="QUOTE">"<tt class="LITERAL">{ fragile }</tt>"</span> is - an alias that disables most actions that are the most likely to cause - trouble. This can be used as a last resort for problem sites.</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - { fragile } + localhost</PRE +></TD +></TR +></TABLE +></P +><P +> This would turn off all filtering for these sites. This is best + put in <TT +CLASS="FILENAME" +>user.action</TT +>, for local site + exceptions. Note that when a simple domain pattern is used by itself (without + the subsequent path portion), all sub-pages within that domain are included + automatically in the scope of the action.</P +><P +> Images that are inexplicably being blocked, may well be hitting the +<A +HREF="actions-file.html#FILTER-BANNERS-BY-SIZE" +><SPAN +CLASS="QUOTE" +>"+filter{banners-by-size}"</SPAN +></A +> + rule, which assumes + that images of certain sizes are ad banners (works well + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>most of the time</I +></SPAN +> since these tend to be standardized).</P +><P +> <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +>{ fragile }</TT +>"</SPAN +> is an alias that disables most + actions that are the most likely to cause trouble. This can be used as a + last resort for problem sites. </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> { fragile } # Handle with care: easy to break mail.google. - mybank.example.com -</pre> - </td> - </tr> - </table> - - <p><span class="emphasis EMPHASIS c2">Remember to flush caches!</span> - Note that the <tt class="LITERAL">mail.google</tt> reference lacks the - TLD portion (e.g. <span class="QUOTE">".com"</span>). This will - effectively match any TLD with <tt class="LITERAL">google</tt> in it, - such as <tt class="LITERAL">mail.google.de.</tt>, just as an - example.</p> - - <p>If this still does not work, you will have to go through the - remaining actions one by one to find which one(s) is causing the - problem.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="seealso.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"> </td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">See Also</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top"> </td> - </tr> - </table> - </div> -</body> -</html> + mybank.example.com</PRE +></TD +></TR +></TABLE +></P +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Remember to flush caches!</I +></SPAN +> Note that the + <TT +CLASS="LITERAL" +>mail.google</TT +> reference lacks the TLD portion (e.g. + <SPAN +CLASS="QUOTE" +>".com"</SPAN +>). This will effectively match any TLD with + <TT +CLASS="LITERAL" +>google</TT +> in it, such as <TT +CLASS="LITERAL" +>mail.google.de.</TT +>, + just as an example.</P +><P +> + If this still does not work, you will have to go through the remaining + actions one by one to find which one(s) is causing the problem.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="seealso.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +> </TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>See Also</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +> </TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/config.html b/external/privoxy/doc/webserver/user-manual/config.html index 6626e00..05e19b3 100644 --- a/external/privoxy/doc/webserver/user-manual/config.html +++ b/external/privoxy/doc/webserver/user-manual/config.html @@ -1,3051 +1,4121 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>The Main Configuration File</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Privoxy Configuration" href= - "configuration.html"> - <link rel="NEXT" title="Actions Files" href="actions-file.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - td.c5 {font-weight: bold} - table.c4 {background-color: #E0E0E0} - tt.c3 {font-style: italic} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "configuration.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "actions-file.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="CONFIG" id="CONFIG">7. The Main Configuration - File</a></h1> - - <p>By default, the main configuration file is named <tt class= - "FILENAME">config</tt>, with the exception of Windows, where it is named - <tt class="FILENAME">config.txt</tt>. Configuration lines consist of an - initial keyword followed by a list of values, all separated by whitespace - (any number of spaces or tabs). For example:</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> <span class= - "emphasis EMPHASIS c2">confdir /etc/privoxy</span></tt></p> - - <p>Assigns the value <tt class="LITERAL">/etc/privoxy</tt> to the option - <tt class="LITERAL">confdir</tt> and thus indicates that the - configuration directory is named <span class= - "QUOTE">"/etc/privoxy/"</span>.</p> - - <p>All options in the config file except for <tt class= - "LITERAL">confdir</tt> and <tt class="LITERAL">logdir</tt> are optional. - Watch out in the below description for what happens if you leave them - unset.</p> - - <p>The main config file controls all aspects of <span class= - "APPLICATION">Privoxy</span>'s operation that are not location dependent - (i.e. they apply universally, no matter where you may be surfing). Like - the filter and action files, the config file is a plain text file and can - be modified with a text editor like emacs, vim or notepad.exe.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="LOCAL-SET-UP" id="LOCAL-SET-UP">7.1. Local - Set-up Documentation</a></h2> - - <p>If you intend to operate <span class="APPLICATION">Privoxy</span> - for more users than just yourself, it might be a good idea to let them - know how to reach you, what you block and why you do that, your - policies, etc.</p> - - <div class="SECT3"> - <h4 class="SECT3"><a name="USER-MANUAL" id="USER-MANUAL">7.1.1. - user-manual</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Location of the <span class="APPLICATION">Privoxy</span> - User Manual.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>A fully qualified URI</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p><a href="http://www.privoxy.org/user-manual/" target= - "_top">http://www.privoxy.org/<tt class= - "REPLACEABLE c3">version</tt>/user-manual/</a> will be used, - where <tt class="REPLACEABLE c3">version</tt> is the - <span class="APPLICATION">Privoxy</span> version.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>The User Manual URI is the single best source of information - on <span class="APPLICATION">Privoxy</span>, and is used for - help links from some of the internal CGI pages. The manual - itself is normally packaged with the binary distributions, so - you probably want to set this to a locally installed copy.</p> - - <p>Examples:</p> - - <p>The best all purpose solution is simply to put the full - local <tt class="LITERAL">PATH</tt> to where the <i class= - "CITETITLE">User Manual</i> is located:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - user-manual /usr/share/doc/privoxy/user-manual -</pre> - </td> - </tr> - </table> - - <p>The User Manual is then available to anyone with access to - <span class="APPLICATION">Privoxy</span>, by following the - built-in URL: <tt class= - "LITERAL">http://config.privoxy.org/user-manual/</tt> (or the - shortcut: <tt class= - "LITERAL">http://p.p/user-manual/</tt>).</p> - - <p>If the documentation is not on the local system, it can be - accessed from a remote server, as:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - user-manual http://example.com/privoxy/user-manual/ -</pre> - </td> - </tr> - </table> - - <div class="WARNING"> - <table class="WARNING" border="1" width="90%"> - <tr> - <td class="c5" align="center">Warning</td> - </tr> - - <tr> - <td align="left"> - <p>If set, this option should be <span class= - "emphasis EMPHASIS c2">the first option in the config - file</span>, because it is used while the config file - is being read on start-up.</p> - </td> - </tr> - </table> - </div> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="TRUST-INFO-URL" id="TRUST-INFO-URL">7.1.2. - trust-info-url</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>A URL to be displayed in the error page that users will see - if access to an untrusted page is denied.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>URL</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>No links are displayed on the "untrusted" error page.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>The value of this option only matters if the experimental - trust mechanism has been activated. (See <a href= - "config.html#TRUSTFILE"><span class= - "emphasis EMPHASIS c2">trustfile</span></a> below.)</p> - - <p>If you use the trust mechanism, it is a good idea to write - up some on-line documentation about your trust policy and to - specify the URL(s) here. Use multiple times for multiple - URLs.</p> - - <p>The URL(s) should be added to the trustfile as well, so - users don't end up locked out from the information on why they - were locked out in the first place!</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ADMIN-ADDRESS" id="ADMIN-ADDRESS">7.1.3. - admin-address</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>An email address to reach the <span class= - "APPLICATION">Privoxy</span> administrator.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>Email address</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>No email address is displayed on error pages and the CGI - user interface.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>If both <tt class="LITERAL">admin-address</tt> and - <tt class="LITERAL">proxy-info-url</tt> are unset, the whole - "Local Privoxy Support" box on all generated pages will not be - shown.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="PROXY-INFO-URL" id="PROXY-INFO-URL">7.1.4. - proxy-info-url</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>A URL to documentation about the local <span class= - "APPLICATION">Privoxy</span> setup, configuration or - policies.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>URL</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>No link to local documentation is displayed on error pages - and the CGI user interface.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>If both <tt class="LITERAL">admin-address</tt> and - <tt class="LITERAL">proxy-info-url</tt> are unset, the whole - "Local Privoxy Support" box on all generated pages will not be - shown.</p> - - <p>This URL shouldn't be blocked ;-)</p> - </dd> - </dl> - </div> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CONF-LOG-LOC" id="CONF-LOG-LOC">7.2. - Configuration and Log File Locations</a></h2> - - <p><span class="APPLICATION">Privoxy</span> can (and normally does) use - a number of other files for additional configuration, help and logging. - This section of the configuration file tells <span class= - "APPLICATION">Privoxy</span> where to find those other files.</p> - - <p>The user running <span class="APPLICATION">Privoxy</span>, must have - read permission for all configuration files, and write permission to - any files that would be modified, such as log files and actions - files.</p> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CONFDIR" id="CONFDIR">7.2.1. - confdir</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>The directory where the other configuration files are - located.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>Path name</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>/etc/privoxy (Unix) <span class= - "emphasis EMPHASIS c2">or</span> <span class= - "APPLICATION">Privoxy</span> installation dir (Windows)</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Mandatory</span></p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>No trailing <span class="QUOTE">"<tt class= - "LITERAL">/</tt>"</span>, please.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="TEMPLDIR" id="TEMPLDIR">7.2.2. - templdir</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>An alternative directory where the templates are loaded - from.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>Path name</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>unset</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>The templates are assumed to be located in - confdir/template.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p><span class="APPLICATION">Privoxy's</span> original - templates are usually overwritten with each update. Use this - option to relocate customized templates that should be kept. As - template variables might change between updates, you shouldn't - expect templates to work with <span class= - "APPLICATION">Privoxy</span> releases other than the one they - were part of, though.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="LOGDIR" id="LOGDIR">7.2.3. logdir</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>The directory where all logging takes place (i.e. where the - <tt class="FILENAME">logfile</tt> is located).</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>Path name</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>/var/log/privoxy (Unix) <span class= - "emphasis EMPHASIS c2">or</span> <span class= - "APPLICATION">Privoxy</span> installation dir (Windows)</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Mandatory</span></p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>No trailing <span class="QUOTE">"<tt class= - "LITERAL">/</tt>"</span>, please.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ACTIONSFILE" id="ACTIONSFILE">7.2.4. - actionsfile</a></h4><a name="DEFAULT.ACTION" id= - "DEFAULT.ACTION"></a><a name="STANDARD.ACTION" id= - "STANDARD.ACTION"></a><a name="USER.ACTION" id="USER.ACTION"></a> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>The <a href="actions-file.html">actions file(s)</a> to - use</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>Complete file name, relative to <tt class= - "LITERAL">confdir</tt></p> - </dd> - - <dt>Default values:</dt> - - <dd> - <table border="0"> - <tbody> - <tr> - <td> - <p class="LITERALLAYOUT"> - match-all.action # Actions that are applied to all sites and maybe overruled later on.</p> - </td> - </tr> - - <tr> - <td> - <p class="LITERALLAYOUT"> - default.action # Main actions file</p> - </td> - </tr> - - <tr> - <td> - <p class="LITERALLAYOUT"> - user.action # User customizations</p> - </td> - </tr> - </tbody> - </table> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>No actions are taken at all. More or less neutral - proxying.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Multiple <tt class="LITERAL">actionsfile</tt> lines are - permitted, and are in fact recommended!</p> - - <p>The default values are <tt class= - "FILENAME">default.action</tt>, which is the <span class= - "QUOTE">"main"</span> actions file maintained by the - developers, and <tt class="FILENAME">user.action</tt>, where - you can make your personal additions.</p> - - <p>Actions files contain all the per site and per URL - configuration for ad blocking, cookie management, privacy - considerations, etc. There is no point in using <span class= - "APPLICATION">Privoxy</span> without at least one actions - file.</p> - - <p>Note that since Privoxy 3.0.7, the complete filename, - including the <span class="QUOTE">".action"</span> extension - has to be specified. The syntax change was necessary to be - consistent with the other file options and to allow previously - forbidden characters.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="FILTERFILE" id="FILTERFILE">7.2.5. - filterfile</a></h4><a name="DEFAULT.FILTER" id="DEFAULT.FILTER"></a> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>The <a href="filter-file.html">filter file(s)</a> to use</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>File name, relative to <tt class="LITERAL">confdir</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>default.filter (Unix) <span class= - "emphasis EMPHASIS c2">or</span> default.filter.txt - (Windows)</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>No textual content filtering takes place, i.e. all - <tt class="LITERAL">+<a href= - "actions-file.html#FILTER">filter</a>{<tt class= - "REPLACEABLE c3">name</tt>}</tt> actions in the actions files - are turned neutral.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Multiple <tt class="LITERAL">filterfile</tt> lines are - permitted.</p> - - <p>The <a href="filter-file.html">filter files</a> contain - content modification rules that use <a href= - "appendix.html#REGEX">regular expressions</a>. These rules - permit powerful changes on the content of Web pages, and - optionally the headers as well, e.g., you could try to disable - your favorite JavaScript annoyances, re-write the actual - displayed text, or just have some fun playing buzzword bingo - with web pages.</p> - - <p>The <tt class="LITERAL">+<a href= - "actions-file.html#FILTER">filter</a>{<tt class= - "REPLACEABLE c3">name</tt>}</tt> actions rely on the relevant - filter (<tt class="REPLACEABLE c3">name</tt>) to be defined in - a filter file!</p> - - <p>A pre-defined filter file called <tt class= - "FILENAME">default.filter</tt> that contains a number of useful - filters for common problems is included in the distribution. - See the section on the <tt class="LITERAL"><a href= - "actions-file.html#FILTER">filter</a></tt> action for a - list.</p> - - <p>It is recommended to place any locally adapted filters into - a separate file, such as <tt class= - "FILENAME">user.filter</tt>.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="LOGFILE" id="LOGFILE">7.2.6. - logfile</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>The log file to use</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>File name, relative to <tt class="LITERAL">logdir</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset (commented - out)</span>. When activated: logfile (Unix) <span class= - "emphasis EMPHASIS c2">or</span> privoxy.log (Windows).</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>No logfile is written.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>The logfile is where all logging and error messages are - written. The level of detail and number of messages are set - with the <tt class="LITERAL">debug</tt> option (see below). The - logfile can be useful for tracking down a problem with - <span class="APPLICATION">Privoxy</span> (e.g., it's not - blocking an ad you think it should block) and it can help you - to monitor what your browser is doing.</p> - - <p>Depending on the debug options below, the logfile may be a - privacy risk if third parties can get access to it. As most - users will never look at it, <span class= - "APPLICATION">Privoxy</span> 3.0.7 and later only log fatal - errors by default.</p> - - <p>For most troubleshooting purposes, you will have to change - that, please refer to the debugging section for details.</p> - - <p>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 <span class="QUOTE">"man - cron"</span>). For Red Hat based Linux distributions, a - <b class="COMMAND">logrotate</b> script has been included.</p> - - <p>Any log files must be writable by whatever user <span class= - "APPLICATION">Privoxy</span> is being run as (on Unix, default - user id is <span class="QUOTE">"privoxy"</span>).</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="TRUSTFILE" id="TRUSTFILE">7.2.7. - trustfile</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>The name of the trust file to use</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>File name, relative to <tt class="LITERAL">confdir</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset (commented - out)</span>. When activated: trust (Unix) <span class= - "emphasis EMPHASIS c2">or</span> trust.txt (Windows)</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>The entire trust mechanism is disabled.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>The trust mechanism is an experimental feature for building - white-lists and should be used with care. It is <span class= - "emphasis EMPHASIS c2">NOT</span> recommended for the casual - user.</p> - - <p>If you specify a trust file, <span class= - "APPLICATION">Privoxy</span> will only allow access to sites - that are specified in the trustfile. Sites can be listed in one - of two ways:</p> - - <p>Prepending a <tt class="LITERAL">~</tt> character limits - access to this site only (and any sub-paths within this site), - e.g. <tt class="LITERAL">~www.example.com</tt> allows access to - <tt class="LITERAL">~www.example.com/features/news.html</tt>, - etc.</p> - - <p>Or, you can designate sites as <span class= - "emphasis EMPHASIS c2">trusted referrers</span>, by prepending - the name with a <tt class="LITERAL">+</tt> character. The - effect is that access to untrusted sites will be granted -- but - only if a link from this trusted referrer was used to get - there. The link target will then be added to the <span class= - "QUOTE">"trustfile"</span> so that future, direct accesses will - be granted. Sites added via this mechanism do not become - trusted referrers themselves (i.e. they are added with a - <tt class="LITERAL">~</tt> designation). There is a limit of - 512 such entries, after which new entries will not be made.</p> - - <p>If you use the <tt class="LITERAL">+</tt> operator in the - trust file, it may grow considerably over time.</p> - - <p>It is recommended that <span class= - "APPLICATION">Privoxy</span> be compiled with the <tt class= - "LITERAL">--disable-force</tt>, <tt class= - "LITERAL">--disable-toggle</tt> and <tt class= - "LITERAL">--disable-editor</tt> options, if this feature is to - be used.</p> - - <p>Possible applications include limiting Internet access for - children.</p> - </dd> - </dl> - </div> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="DEBUGGING" id="DEBUGGING">7.3. - Debugging</a></h2> - - <p>These options are mainly useful when tracing a problem. Note that - you might also want to invoke <span class="APPLICATION">Privoxy</span> - with the <tt class="LITERAL">--no-daemon</tt> command line option when - debugging.</p> - - <div class="SECT3"> - <h4 class="SECT3"><a name="DEBUG" id="DEBUG">7.3.1. debug</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Key values that determine what information gets logged.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>Integer values</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>0 (i.e.: only fatal errors (that cause Privoxy to exit) are - logged)</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Default value is used (see above).</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>The available debug levels are:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - debug 1 # Log the destination for each request <span class= -"APPLICATION">Privoxy</span> let through. See also debug 1024. +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>The Main Configuration File</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Privoxy Configuration" +HREF="configuration.html"><LINK +REL="NEXT" +TITLE="Actions Files" +HREF="actions-file.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="configuration.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="actions-file.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="CONFIG" +>7. The Main Configuration File</A +></H1 +><P +> Again, the main configuration file is named <TT +CLASS="FILENAME" +>config</TT +> on + Linux/Unix/BSD and OS/2, and <TT +CLASS="FILENAME" +>config.txt</TT +> on Windows. + Configuration lines consist of an initial keyword followed by a list of + values, all separated by whitespace (any number of spaces or tabs). For + example:</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>confdir /etc/privoxy</I +></SPAN +></P +> + </TT +> </P +><P +> Assigns the value <TT +CLASS="LITERAL" +>/etc/privoxy</TT +> to the option + <TT +CLASS="LITERAL" +>confdir</TT +> and thus indicates that the configuration + directory is named <SPAN +CLASS="QUOTE" +>"/etc/privoxy/"</SPAN +>.</P +><P +> All options in the config file except for <TT +CLASS="LITERAL" +>confdir</TT +> and + <TT +CLASS="LITERAL" +>logdir</TT +> are optional. Watch out in the below description + for what happens if you leave them unset.</P +><P +> The main config file controls all aspects of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s + operation that are not location dependent (i.e. they apply universally, no matter + where you may be surfing).</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="LOCAL-SET-UP" +>7.1. Local Set-up Documentation</A +></H2 +><P +> If you intend to operate <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> for more users + than just yourself, it might be a good idea to let them know how to reach + you, what you block and why you do that, your policies, etc. + </P +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="USER-MANUAL" +>7.1.1. user-manual</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Location of the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> User Manual. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>A fully qualified URI</P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> <A +HREF="http://www.privoxy.org/user-manual/" +TARGET="_top" +>http://www.privoxy.org/<TT +CLASS="REPLACEABLE" +><I +>version</I +></TT +>/user-manual/</A +> + will be used, where <TT +CLASS="REPLACEABLE" +><I +>version</I +></TT +> is the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> The User Manual URI is the single best source of information on + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, and is used for help links from some + of the internal CGI pages. The manual itself is normally packaged with the + binary distributions, so you probably want to set this to a locally + installed copy. + </P +><P +> Examples: + </P +><P +> The best all purpose solution is simply to put the full local + <TT +CLASS="LITERAL" +>PATH</TT +> to where the <I +CLASS="CITETITLE" +>User Manual</I +> is + located: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> user-manual /usr/share/doc/privoxy/user-manual</PRE +></TD +></TR +></TABLE +> + </P +><P +> The User Manual is then available to anyone with access to + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, by following the built-in URL: + <TT +CLASS="LITERAL" +>http://config.privoxy.org/user-manual/</TT +> + (or the shortcut: <TT +CLASS="LITERAL" +>http://p.p/user-manual/</TT +>). + </P +><P +> If the documentation is not on the local system, it can be accessed + from a remote server, as: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> user-manual http://example.com/privoxy/user-manual/</PRE +></TD +></TR +></TABLE +> + </P +><DIV +CLASS="WARNING" +><P +></P +><TABLE +CLASS="WARNING" +BORDER="1" +WIDTH="90%" +><TR +><TD +ALIGN="CENTER" +><B +>Warning</B +></TD +></TR +><TR +><TD +ALIGN="LEFT" +><P +> If set, this option should be <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>the first option in the config + file</I +></SPAN +>, because it is used while the config file is being read + on start-up. + </P +></TD +></TR +></TABLE +></DIV +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="TRUST-INFO-URL" +>7.1.2. trust-info-url</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> A URL to be displayed in the error page that users will see if access to an untrusted page is denied. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>URL</P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> No links are displayed on the "untrusted" error page. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> The value of this option only matters if the experimental trust mechanism has been + activated. (See <A +HREF="config.html#TRUSTFILE" +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>trustfile</I +></SPAN +></A +> below.) + </P +><P +> If you use the trust mechanism, it is a good idea to write up some on-line + documentation about your trust policy and to specify the URL(s) here. + Use multiple times for multiple URLs. + </P +><P +> The URL(s) should be added to the trustfile as well, so users don't end up + locked out from the information on why they were locked out in the first place! + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ADMIN-ADDRESS" +>7.1.3. admin-address</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> An email address to reach the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> administrator. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>Email address</P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> No email address is displayed on error pages and the CGI user interface. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> If both <TT +CLASS="LITERAL" +>admin-address</TT +> and <TT +CLASS="LITERAL" +>proxy-info-url</TT +> + are unset, the whole "Local Privoxy Support" box on all generated pages will + not be shown. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="PROXY-INFO-URL" +>7.1.4. proxy-info-url</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> A URL to documentation about the local <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> setup, + configuration or policies. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>URL</P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> No link to local documentation is displayed on error pages and the CGI user interface. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> If both <TT +CLASS="LITERAL" +>admin-address</TT +> and <TT +CLASS="LITERAL" +>proxy-info-url</TT +> + are unset, the whole "Local Privoxy Support" box on all generated pages will + not be shown. + </P +><P +> This URL shouldn't be blocked ;-) + </P +></DD +></DL +></DIV +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONF-LOG-LOC" +>7.2. Configuration and Log File Locations</A +></H2 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can (and normally does) use a number of + other files for additional configuration, help and logging. + This section of the configuration file tells <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + where to find those other files. </P +><P +> The user running <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, must have read + permission for all configuration files, and write permission to any files + that would be modified, such as log files and actions files.</P +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="CONFDIR" +>7.2.1. confdir</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +>The directory where the other configuration files are located.</P +></DD +><DT +>Type of value:</DT +><DD +><P +>Path name</P +></DD +><DT +>Default value:</DT +><DD +><P +>/etc/privoxy (Unix) <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>or</I +></SPAN +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> installation dir (Windows) </P +></DD +><DT +>Effect if unset:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Mandatory</I +></SPAN +></P +></DD +><DT +>Notes:</DT +><DD +><P +> No trailing <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +>/</TT +>"</SPAN +>, please. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="TEMPLDIR" +>7.2.2. templdir</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +>An alternative directory where the templates are loaded from.</P +></DD +><DT +>Type of value:</DT +><DD +><P +>Path name</P +></DD +><DT +>Default value:</DT +><DD +><P +>unset</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +>The templates are assumed to be located in confdir/template.</P +></DD +><DT +>Notes:</DT +><DD +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> original templates are usually + overwritten with each update. Use this option to relocate customized + templates that should be kept. As template variables might change + between updates, you shouldn't expect templates to work with + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> releases other than the one + they were part of, though. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="LOGDIR" +>7.2.3. logdir</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> The directory where all logging takes place + (i.e. where the <TT +CLASS="FILENAME" +>logfile</TT +> is located). + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>Path name</P +></DD +><DT +>Default value:</DT +><DD +><P +>/var/log/privoxy (Unix) <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>or</I +></SPAN +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> installation dir (Windows) </P +></DD +><DT +>Effect if unset:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Mandatory</I +></SPAN +></P +></DD +><DT +>Notes:</DT +><DD +><P +> No trailing <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +>/</TT +>"</SPAN +>, please. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ACTIONSFILE" +>7.2.4. actionsfile</A +></H4 +><A +NAME="DEFAULT.ACTION" +></A +><A +NAME="STANDARD.ACTION" +></A +><A +NAME="USER.ACTION" +></A +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> The <A +HREF="actions-file.html" +>actions file(s)</A +> to use + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>Complete file name, relative to <TT +CLASS="LITERAL" +>confdir</TT +></P +></DD +><DT +>Default values:</DT +><DD +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <P +CLASS="LITERALLAYOUT" +> match-all.action # Actions that are applied to all sites and maybe overruled later on.</P +> + </TD +></TR +><TR +><TD +> <P +CLASS="LITERALLAYOUT" +> default.action # Main actions file</P +> + </TD +></TR +><TR +><TD +> <P +CLASS="LITERALLAYOUT" +> user.action # User customizations</P +> + </TD +></TR +></TBODY +></TABLE +><P +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> No actions are taken at all. More or less neutral proxying. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Multiple <TT +CLASS="LITERAL" +>actionsfile</TT +> lines are permitted, and are in fact recommended! + </P +><P +> + The default values are <TT +CLASS="FILENAME" +>default.action</TT +>, which is the + <SPAN +CLASS="QUOTE" +>"main"</SPAN +> actions file maintained by the developers, and + <TT +CLASS="FILENAME" +>user.action</TT +>, where you can make your personal additions. + </P +><P +> + Actions files contain all the per site and per URL configuration for + ad blocking, cookie management, privacy considerations, etc. + There is no point in using <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> without at + least one actions file. + </P +><P +> Note that since Privoxy 3.0.7, the complete filename, including the <SPAN +CLASS="QUOTE" +>".action"</SPAN +> + extension has to be specified. The syntax change was necessary to be consistent + with the other file options and to allow previously forbidden characters. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="FILTERFILE" +>7.2.5. filterfile</A +></H4 +><A +NAME="DEFAULT.FILTER" +></A +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> The <A +HREF="filter-file.html" +>filter file(s)</A +> to use + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>File name, relative to <TT +CLASS="LITERAL" +>confdir</TT +></P +></DD +><DT +>Default value:</DT +><DD +><P +>default.filter (Unix) <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>or</I +></SPAN +> default.filter.txt (Windows)</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> No textual content filtering takes place, i.e. all + <TT +CLASS="LITERAL" +>+<A +HREF="actions-file.html#FILTER" +>filter</A +>{<TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +>}</TT +> + actions in the actions files are turned neutral. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Multiple <TT +CLASS="LITERAL" +>filterfile</TT +> lines are permitted. + </P +><P +> The <A +HREF="filter-file.html" +>filter files</A +> contain content modification + rules that use <A +HREF="appendix.html#REGEX" +>regular expressions</A +>. These rules permit + powerful changes on the content of Web pages, and optionally the headers + as well, e.g., you could try to disable your favorite JavaScript annoyances, + re-write the actual displayed text, or just have some fun + playing buzzword bingo with web pages. + </P +><P +> The + <TT +CLASS="LITERAL" +>+<A +HREF="actions-file.html#FILTER" +>filter</A +>{<TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +>}</TT +> + actions rely on the relevant filter (<TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +>) + to be defined in a filter file! + </P +><P +> A pre-defined filter file called <TT +CLASS="FILENAME" +>default.filter</TT +> that contains + a number of useful filters for common problems is included in the distribution. + See the section on the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FILTER" +>filter</A +></TT +> + action for a list. + </P +><P +> It is recommended to place any locally adapted filters into a separate + file, such as <TT +CLASS="FILENAME" +>user.filter</TT +>. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="LOGFILE" +>7.2.6. logfile</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> The log file to use + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>File name, relative to <TT +CLASS="LITERAL" +>logdir</TT +></P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset (commented out)</I +></SPAN +>. When activated: logfile (Unix) <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>or</I +></SPAN +> privoxy.log (Windows).</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> No logfile is written. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> The logfile is where all logging and error messages are written. The level + of detail and number of messages are set with the <TT +CLASS="LITERAL" +>debug</TT +> + option (see below). The logfile can be useful for tracking down a problem with + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> (e.g., it's not blocking an ad you + think it should block) and it can help you to monitor what your browser + is doing. + </P +><P +> Depending on the debug options below, the logfile may be a privacy risk + if third parties can get access to it. As most users will never look + at it, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> 3.0.7 and later only log fatal + errors by default. + </P +><P +> For most troubleshooting purposes, you will have to change that, + please refer to the debugging section for details. + </P +><P +> 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 <SPAN +CLASS="QUOTE" +>"man cron"</SPAN +>). For Red Hat based Linux distributions, a + <B +CLASS="COMMAND" +>logrotate</B +> script has been included. + </P +><P +> Any log files must be writable by whatever user <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + is being run as (on Unix, default user id is <SPAN +CLASS="QUOTE" +>"privoxy"</SPAN +>). + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="TRUSTFILE" +>7.2.7. trustfile</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> The name of the trust file to use + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>File name, relative to <TT +CLASS="LITERAL" +>confdir</TT +></P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset (commented out)</I +></SPAN +>. When activated: trust (Unix) <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>or</I +></SPAN +> trust.txt (Windows)</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> The entire trust mechanism is disabled. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> The trust mechanism is an experimental feature for building white-lists and should + be used with care. It is <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>NOT</I +></SPAN +> recommended for the casual user. + </P +><P +> If you specify a trust file, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will only allow + access to sites that are specified in the trustfile. Sites can be listed + in one of two ways: + </P +><P +> Prepending a <TT +CLASS="LITERAL" +>~</TT +> character limits access to this site + only (and any sub-paths within this site), e.g. + <TT +CLASS="LITERAL" +>~www.example.com</TT +> allows access to + <TT +CLASS="LITERAL" +>~www.example.com/features/news.html</TT +>, etc. + </P +><P +> Or, you can designate sites as <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>trusted referrers</I +></SPAN +>, by + prepending the name with a <TT +CLASS="LITERAL" +>+</TT +> character. The effect is that + access to untrusted sites will be granted -- but only if a link from this + trusted referrer was used to get there. The link target will then be added + to the <SPAN +CLASS="QUOTE" +>"trustfile"</SPAN +> so that future, direct accesses will be + granted. Sites added via this mechanism do not become trusted referrers + themselves (i.e. they are added with a <TT +CLASS="LITERAL" +>~</TT +> designation). + There is a limit of 512 such entries, after which new entries will not be + made. + </P +><P +> If you use the <TT +CLASS="LITERAL" +>+</TT +> operator in the trust file, it may grow + considerably over time. + </P +><P +> It is recommended that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> be compiled with + the <TT +CLASS="LITERAL" +>--disable-force</TT +>, <TT +CLASS="LITERAL" +>--disable-toggle</TT +> and + <TT +CLASS="LITERAL" +> --disable-editor</TT +> options, if this feature is to be + used. + </P +><P +> Possible applications include limiting Internet access for children. + </P +></DD +></DL +></DIV +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="DEBUGGING" +>7.3. Debugging</A +></H2 +><P +> These options are mainly useful when tracing a problem. + Note that you might also want to invoke + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with the <TT +CLASS="LITERAL" +>--no-daemon</TT +> + command line option when debugging. + </P +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="DEBUG" +>7.3.1. debug</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Key values that determine what information gets logged. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>Integer values</P +></DD +><DT +>Default value:</DT +><DD +><P +>0 (i.e.: only fatal errors (that cause Privoxy to exit) are logged)</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Default value is used (see above). + </P +></DD +><DT +>Notes:</DT +><DD +><P +> The available debug levels are: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> debug 1 # Log the destination for each request <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> let through. See also debug 1024. 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 + debug 16 # log all data written to the network into the logfile debug 32 # debug force feature debug 64 # debug regular expression filters debug 128 # debug redirects debug 256 # debug GIF de-animation debug 512 # Common Log Format - debug 1024 # Log the destination for requests <span class= -"APPLICATION">Privoxy</span> didn't let through, and the reason why. + debug 1024 # Log the destination for requests <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> didn't let through, and the reason why. 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 -</pre> - </td> - </tr> - </table> - - <p>To select multiple debug levels, you can either add them or - use multiple <tt class="LITERAL">debug</tt> lines.</p> - - <p>A debug level of 1 is informative because it will show you - each request as it happens. <span class= - "emphasis EMPHASIS c2">1, 1024, 4096 and 8192 are - recommended</span> so that you will notice when things go - wrong. The other levels are probably only of interest if you - are hunting down a specific problem. They can produce a hell of - an output (especially 16).</p> - - <p><span class="APPLICATION">Privoxy</span> used to ship with - the debug levels recommended above enabled by default, but due - to privacy concerns 3.0.7 and later are configured to only log - fatal errors.</p> - - <p>If you are used to the more verbose settings, simply enable - the debug lines below again.</p> - - <p>If you want to use pure CLF (Common Log Format), you should - set <span class="QUOTE">"debug 512"</span> <span class= - "emphasis EMPHASIS c2">ONLY</span> and not enable anything - else.</p> - - <p><span class="APPLICATION">Privoxy</span> has a hard-coded - limit for the length of log messages. If it's reached, messages - are logged truncated and marked with <span class="QUOTE">"... - [too long, truncated]"</span>.</p> - - <p>Please don't file any support requests without trying to - reproduce the problem with increased debug level first. Once - you read the log messages, you may even be able to solve the - problem on your own.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="SINGLE-THREADED" id= - "SINGLE-THREADED">7.3.2. single-threaded</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Whether to run only one server thread.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">None</span></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Multi-threaded (or, where unavailable: forked) operation, - i.e. the ability to serve multiple requests simultaneously.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This option is only there for debugging purposes. - <span class="emphasis EMPHASIS c2">It will drastically reduce - performance.</span></p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="HOSTNAME" id="HOSTNAME">7.3.3. - hostname</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>The hostname shown on the CGI pages.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>Text</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>The hostname provided by the operating system is used.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>On some misconfigured systems resolving the hostname fails - or takes too much time and slows Privoxy down. Setting a fixed - hostname works around the problem.</p> - - <p>In other circumstances it might be desirable to show a - hostname other than the one returned by the operating system. - For example if the system has several different hostnames and - you don't want to use the first one.</p> - - <p>Note that Privoxy does not validate the specified hostname - value.</p> - </dd> - </dl> - </div> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="ACCESS-CONTROL" id="ACCESS-CONTROL">7.4. - Access Control and Security</a></h2> - - <p>This section of the config file controls the security-relevant - aspects of <span class="APPLICATION">Privoxy</span>'s - configuration.</p> - - <div class="SECT3"> - <h4 class="SECT3"><a name="LISTEN-ADDRESS" id="LISTEN-ADDRESS">7.4.1. - listen-address</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>The address and TCP port on which <span class= - "APPLICATION">Privoxy</span> will listen for client - requests.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>[<tt class="REPLACEABLE c3">IP-Address</tt>]:<tt class= - "REPLACEABLE c3">Port</tt></p> - - <p>[<tt class="REPLACEABLE c3">Hostname</tt>]:<tt class= - "REPLACEABLE c3">Port</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>127.0.0.1:8118</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Bind to 127.0.0.1 (IPv4 localhost), port 8118. This is - suitable and recommended for home users who run <span class= - "APPLICATION">Privoxy</span> on the same machine as their - browser.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>You will need to configure your browser(s) to this proxy - address and port.</p> - - <p>If you already have another service running on port 8118, or - if you want to serve requests from other machines (e.g. on your - local network) as well, you will need to override the - default.</p> - - <p>You can use this statement multiple times to make - <span class="APPLICATION">Privoxy</span> listen on more ports - or more <abbr class="ABBREV">IP</abbr> addresses. Suitable if - your operating system does not support sharing <abbr class= - "ABBREV">IPv6</abbr> and <abbr class="ABBREV">IPv4</abbr> - protocols on the same socket.</p> - - <p>If a hostname is used instead of an IP address, <span class= - "APPLICATION">Privoxy</span> will try to resolve it to an IP - address and if there are multiple, use the first one - returned.</p> - - <p>If the address for the hostname isn't already known on the - system (for example because it's in /etc/hostname), this may - result in DNS traffic.</p> - - <p>If the specified address isn't available on the system, or - if the hostname can't be resolved, <span class= - "APPLICATION">Privoxy</span> will fail to start.</p> - - <p>IPv6 addresses containing colons have to be quoted by - brackets. They can only be used if <span class= - "APPLICATION">Privoxy</span> has been compiled with IPv6 - support. If you aren't sure if your version supports it, have a - look at <tt class= - "LITERAL">http://config.privoxy.org/show-status</tt>.</p> - - <p>Some operating systems will prefer IPv6 to IPv4 addresses - even if the system has no IPv6 connectivity which is usually - not expected by the user. Some even rely on DNS to resolve - localhost which mean the "localhost" address used may not - actually be local.</p> - - <p>It is therefore recommended to explicitly configure the - intended IP address instead of relying on the operating system, - unless there's a strong reason not to.</p> - - <p>If you leave out the address, <span class= - "APPLICATION">Privoxy</span> will bind to all IPv4 interfaces - (addresses) on your machine and may become reachable from the - Internet and/or the local network. Be aware that some GNU/Linux - distributions modify that behaviour without updating the - documentation. Check for non-standard patches if your - <span class="APPLICATION">Privoxy</span>version behaves - differently.</p> - - <p>If you configure <span class="APPLICATION">Privoxy</span>to - be reachable from the network, consider using <a href= - "config.html#ACLS">access control lists</a> (ACL's, see below), - and/or a firewall.</p> - - <p>If you open <span class="APPLICATION">Privoxy</span> to - untrusted users, you will also want to make sure that the - following actions are disabled: <tt class="LITERAL"><a href= - "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a></tt> - and <tt class="LITERAL"><a href= - "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a></tt></p> - - <p>With the exception noted above, listening on multiple - addresses is currently not supported by <span class= - "APPLICATION">Privoxy</span> directly. It can be done on most - operating systems by letting a packet filter redirect request - for certain addresses to Privoxy, though.</p> - </dd> - - <dt>Example:</dt> - - <dd> - <p>Suppose you are running <span class= - "APPLICATION">Privoxy</span> on a machine which has the address - 192.168.0.1 on your local private network (192.168.0.0) and has - another outside connection with a different address. You want - it to serve requests from inside only:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - listen-address 192.168.0.1:8118 -</pre> - </td> - </tr> - </table> - - <p>Suppose you are running <span class= - "APPLICATION">Privoxy</span> on an IPv6-capable machine and you - want it to listen on the IPv6 address of the loopback - device:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - listen-address [::1]:8118 -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="TOGGLE" id="TOGGLE">7.4.2. toggle</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Initial state of "toggle" status</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>1 or 0</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>1</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Act as if toggled on</p> - </dd> - - <dt>Notes:</dt> + debug 8192 # Non-fatal errors</PRE +></TD +></TR +></TABLE +> + </P +><P +> To select multiple debug levels, you can either add them or use + multiple <TT +CLASS="LITERAL" +>debug</TT +> lines. + </P +><P +> A debug level of 1 is informative because it will show you each request + as it happens. <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>1, 4096 and 8192 are recommended</I +></SPAN +> + so that you will notice when things go wrong. The other levels are + probably only of interest if you are hunting down a specific problem. + They can produce a hell of an output (especially 16). + + </P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> used to ship with the debug levels recommended above enabled by + default, but due to privacy concerns 3.0.7 and later are configured to + only log fatal errors. + </P +><P +> If you are used to the more verbose settings, simply enable the debug lines + below again. + </P +><P +> If you want to use pure CLF (Common Log Format), you should set <SPAN +CLASS="QUOTE" +>"debug + 512"</SPAN +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>ONLY</I +></SPAN +> and not enable anything else. + </P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> has a hard-coded limit for the + length of log messages. If it's reached, messages are logged truncated + and marked with <SPAN +CLASS="QUOTE" +>"... [too long, truncated]"</SPAN +>. + </P +><P +> Please don't file any support requests without trying to reproduce + the problem with increased debug level first. Once you read the log + messages, you may even be able to solve the problem on your own. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="SINGLE-THREADED" +>7.3.2. single-threaded</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Whether to run only one server thread. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>None</I +></SPAN +></P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Multi-threaded (or, where unavailable: forked) operation, i.e. the ability to + serve multiple requests simultaneously. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> This option is only there for debugging purposes. + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>It will drastically reduce performance.</I +></SPAN +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="HOSTNAME" +>7.3.3. hostname</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> The hostname shown on the CGI pages. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>Text</P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> The hostname provided by the operating system is used. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> On some misconfigured systems resolving the hostname fails or + takes too much time and slows Privoxy down. Setting a fixed hostname + works around the problem. + </P +><P +> In other circumstances it might be desirable to show a hostname + other than the one returned by the operating system. For example + if the system has several different hostnames and you don't want + to use the first one. + </P +><P +> Note that Privoxy does not validate the specified hostname value. + </P +></DD +></DL +></DIV +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="ACCESS-CONTROL" +>7.4. Access Control and Security</A +></H2 +><P +> This section of the config file controls the security-relevant aspects + of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s configuration. + </P +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="LISTEN-ADDRESS" +>7.4.1. listen-address</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> The IP address and TCP port on which <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will + listen for client requests. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>[<TT +CLASS="REPLACEABLE" +><I +>IP-Address</I +></TT +>]:<TT +CLASS="REPLACEABLE" +><I +>Port</I +></TT +></P +></DD +><DT +>Default value:</DT +><DD +><P +>127.0.0.1:8118</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Bind to 127.0.0.1 (localhost), port 8118. This is suitable and recommended for + home users who run <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on the same machine as + their browser. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> You will need to configure your browser(s) to this proxy address and port. + </P +><P +> If you already have another service running on port 8118, or if you want to + serve requests from other machines (e.g. on your local network) as well, you + will need to override the default. + </P +><P +> If you leave out the IP address, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will + bind to all interfaces (addresses) on your machine and may become reachable + from the Internet. In that case, consider using <A +HREF="config.html#ACLS" +>access control lists</A +> (ACL's, see below), and/or + a firewall. + </P +><P +> If you open <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to untrusted users, you will + also want to make sure that the following actions are disabled: <TT +CLASS="LITERAL" +><A +HREF="config.html#ENABLE-EDIT-ACTIONS" +>enable-edit-actions</A +></TT +> and + <TT +CLASS="LITERAL" +><A +HREF="config.html#ENABLE-REMOTE-TOGGLE" +>enable-remote-toggle</A +></TT +> + </P +></DD +><DT +>Example:</DT +><DD +><P +> Suppose you are running <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on + a machine which has the address 192.168.0.1 on your local private network + (192.168.0.0) and has another outside connection with a different address. + You want it to serve requests from inside only: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +> listen-address 192.168.0.1:8118</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="TOGGLE" +>7.4.2. toggle</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Initial state of "toggle" status + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>1 or 0</P +></DD +><DT +>Default value:</DT +><DD +><P +>1</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Act as if toggled on + </P +></DD +><DT +>Notes:</DT +><DD +><P +> If set to 0, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will start in + <SPAN +CLASS="QUOTE" +>"toggled off"</SPAN +> mode, i.e. mostly behave like a normal, + content-neutral proxy with both ad blocking and content filtering + disabled. See <TT +CLASS="LITERAL" +>enable-remote-toggle</TT +> below. + </P +><P +> The windows version will only display the toggle icon in the system tray + if this option is present. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ENABLE-REMOTE-TOGGLE" +>7.4.3. enable-remote-toggle</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Whether or not the <A +HREF="http://config.privoxy.org/toggle" +TARGET="_top" +>web-based toggle + feature</A +> may be used + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>0 or 1</P +></DD +><DT +>Default value:</DT +><DD +><P +>0</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> The web-based toggle feature is disabled. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> When toggled off, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> mostly acts like a normal, + content-neutral proxy, i.e. doesn't block ads or filter content. + </P +><P +> Access to the toggle feature can <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not</I +></SPAN +> be + controlled separately by <SPAN +CLASS="QUOTE" +>"ACLs"</SPAN +> or HTTP authentication, + so that everybody who can access <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> (see + <SPAN +CLASS="QUOTE" +>"ACLs"</SPAN +> and <TT +CLASS="LITERAL" +>listen-address</TT +> above) can + toggle it for all users. So this option is <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not recommended</I +></SPAN +> + for multi-user environments with untrusted users. + </P +><P +> Note that malicious client side code (e.g Java) is also + capable of using this option. + </P +><P +> As a lot of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> users don't read + documentation, this feature is disabled by default. + </P +><P +> Note that you must have compiled <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with + support for this feature, otherwise this option has no effect. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ENABLE-REMOTE-HTTP-TOGGLE" +>7.4.4. enable-remote-http-toggle</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Whether or not Privoxy recognizes special HTTP headers to change its behaviour. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>0 or 1</P +></DD +><DT +>Default value:</DT +><DD +><P +>0</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Privoxy ignores special HTTP headers. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> When toggled on, the client can change <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + behaviour by setting special HTTP headers. Currently the only supported + special header is <SPAN +CLASS="QUOTE" +>"X-Filter: No"</SPAN +>, to disable filtering for + the ongoing request, even if it is enabled in one of the action files. + </P +><P +> This feature is disabled by default. If you are using + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> in a environment with trusted clients, + you may enable this feature at your discretion. Note that malicious client + side code (e.g Java) is also capable of using this feature. + </P +><P +> This option will be removed in future releases as it has been obsoleted + by the more general header taggers. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ENABLE-EDIT-ACTIONS" +>7.4.5. enable-edit-actions</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Whether or not the <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>web-based actions + file editor</A +> may be used + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>0 or 1</P +></DD +><DT +>Default value:</DT +><DD +><P +>0</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> The web-based actions file editor is disabled. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Access to the editor can <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not</I +></SPAN +> be + controlled separately by <SPAN +CLASS="QUOTE" +>"ACLs"</SPAN +> or HTTP authentication, + so that everybody who can access <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> (see + <SPAN +CLASS="QUOTE" +>"ACLs"</SPAN +> and <TT +CLASS="LITERAL" +>listen-address</TT +> above) can + modify its configuration for all users. + </P +><P +> This option is <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not recommended</I +></SPAN +> for environments + with untrusted users and as a lot of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + users don't read documentation, this feature is disabled by default. + </P +><P +> Note that malicious client side code (e.g Java) is also + capable of using the actions editor and you shouldn't enable + this options unless you understand the consequences and are + sure your browser is configured correctly. + </P +><P +> Note that you must have compiled <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with + support for this feature, otherwise this option has no effect. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ENFORCE-BLOCKS" +>7.4.6. enforce-blocks</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Whether the user is allowed to ignore blocks and can <SPAN +CLASS="QUOTE" +>"go there anyway"</SPAN +>. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>0 or 1</I +></TT +> + </P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>0</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Blocks are not enforced. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is mainly used to block and filter + requests as a service to the user, for example to block ads and other + junk that clogs the pipes. <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> configuration + isn't perfect and sometimes innocent pages are blocked. In this situation it + makes sense to allow the user to enforce the request and have + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> ignore the block. + </P +><P +> In the default configuration <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + <SPAN +CLASS="QUOTE" +>"Blocked"</SPAN +> page contains a <SPAN +CLASS="QUOTE" +>"go there anyway"</SPAN +> + link to adds a special string (the force prefix) to the request URL. + If that link is used, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will + detect the force prefix, remove it again and let the request pass. + </P +><P +> Of course <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can also be used to enforce + a network policy. In that case the user obviously should not be able to + bypass any blocks, and that's what the <SPAN +CLASS="QUOTE" +>"enforce-blocks"</SPAN +> + option is for. If it's enabled, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> hides + the <SPAN +CLASS="QUOTE" +>"go there anyway"</SPAN +> link. If the user adds the force + prefix by hand, it will not be accepted and the circumvention attempt + is logged. + </P +></DD +><DT +>Examples:</DT +><DD +><P +> enforce-blocks 1 + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ACLS" +>7.4.7. ACLs: permit-access and deny-access</A +></H4 +><A +NAME="PERMIT-ACCESS" +></A +><A +NAME="DENY-ACCESS" +></A +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Who can access what. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>src_addr</I +></TT +>[/<TT +CLASS="REPLACEABLE" +><I +>src_masklen</I +></TT +>] + [<TT +CLASS="REPLACEABLE" +><I +>dst_addr</I +></TT +>[/<TT +CLASS="REPLACEABLE" +><I +>dst_masklen</I +></TT +>]] + </P +><P +> Where <TT +CLASS="REPLACEABLE" +><I +>src_addr</I +></TT +> and + <TT +CLASS="REPLACEABLE" +><I +>dst_addr</I +></TT +> are IP addresses in dotted decimal notation or valid + DNS names, and <TT +CLASS="REPLACEABLE" +><I +>src_masklen</I +></TT +> and + <TT +CLASS="REPLACEABLE" +><I +>dst_masklen</I +></TT +> are subnet masks in CIDR notation, i.e. integer + values from 2 to 30 representing the length (in bits) of the network address. The masks and the whole + destination part are optional. + </P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Don't restrict access further than implied by <TT +CLASS="LITERAL" +>listen-address</TT +> + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Access controls are included at the request of ISPs and systems + administrators, and <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>are not usually needed by individual users</I +></SPAN +>. + For a typical home user, it will normally suffice to ensure that + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> only listens on the localhost + (127.0.0.1) or internal (home) network address by means of the + <A +HREF="config.html#LISTEN-ADDRESS" +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>listen-address</I +></SPAN +></A +> + option. + </P +><P +> Please see the warnings in the FAQ that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + is not intended to be a substitute for a firewall or to encourage anyone + to defer addressing basic security weaknesses. + </P +><P +> Multiple ACL lines are OK. + If any ACLs are specified, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> only talks + to IP addresses that match at least one <TT +CLASS="LITERAL" +>permit-access</TT +> line + and don't match any subsequent <TT +CLASS="LITERAL" +>deny-access</TT +> line. In other words, the + last match wins, with the default being <TT +CLASS="LITERAL" +>deny-access</TT +>. + </P +><P +> If <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is using a forwarder (see <TT +CLASS="LITERAL" +>forward</TT +> below) + for a particular destination URL, the <TT +CLASS="REPLACEABLE" +><I +>dst_addr</I +></TT +> + that is examined is the address of the forwarder and <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>NOT</I +></SPAN +> the address + of the ultimate target. This is necessary because it may be impossible for the local + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to determine the IP address of the + ultimate target (that's often what gateways are used for). + </P +><P +> You should prefer using IP addresses over DNS names, because the address lookups take + time. All DNS names must resolve! You can <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not</I +></SPAN +> use domain patterns + like <SPAN +CLASS="QUOTE" +>"*.org"</SPAN +> or partial domain names. If a DNS name resolves to multiple + IP addresses, only the first one is used. + </P +><P +> Denying access to particular sites by ACL may have undesired side effects + if the site in question is hosted on a machine which also hosts other sites + (most sites are). + </P +></DD +><DT +>Examples:</DT +><DD +><P +> Explicitly define the default behavior if no ACL and + <TT +CLASS="LITERAL" +>listen-address</TT +> are set: <SPAN +CLASS="QUOTE" +>"localhost"</SPAN +> + is OK. The absence of a <TT +CLASS="REPLACEABLE" +><I +>dst_addr</I +></TT +> implies that + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> destination addresses are OK: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> permit-access localhost</PRE +></TD +></TR +></TABLE +> + </P +><P +> Allow any host on the same class C subnet as www.privoxy.org access to + nothing but www.example.com (or other domains hosted on the same system): + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> permit-access www.privoxy.org/24 www.example.com/32</PRE +></TD +></TR +></TABLE +> + </P +><P +> Allow access from any host on the 26-bit subnet 192.168.45.64 to anywhere, + with the exception that 192.168.45.73 may not access the IP address behind + www.dirty-stuff.example.com: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> permit-access 192.168.45.64/26 + deny-access 192.168.45.73 www.dirty-stuff.example.com</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="BUFFER-LIMIT" +>7.4.8. buffer-limit</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Maximum size of the buffer for content filtering. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +>Size in Kbytes</P +></DD +><DT +>Default value:</DT +><DD +><P +>4096</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Use a 4MB (4096 KB) limit. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> For content filtering, i.e. the <TT +CLASS="LITERAL" +>+filter</TT +> and + <TT +CLASS="LITERAL" +>+deanimate-gif</TT +> actions, it is necessary that + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> buffers the entire document body. + This can be potentially dangerous, since a server could just keep sending + data indefinitely and wait for your RAM to exhaust -- with nasty consequences. + Hence this option. + </P +><P +> When a document buffer size reaches the <TT +CLASS="LITERAL" +>buffer-limit</TT +>, it is + flushed to the client unfiltered and no further attempt to + filter the rest of the document is made. Remember that there may be multiple threads + running, which might require up to <TT +CLASS="LITERAL" +>buffer-limit</TT +> Kbytes + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>each</I +></SPAN +>, unless you have enabled <SPAN +CLASS="QUOTE" +>"single-threaded"</SPAN +> + above. + </P +></DD +></DL +></DIV +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="FORWARDING" +>7.5. Forwarding</A +></H2 +><P +> This feature allows routing of HTTP requests through a chain of + multiple proxies.</P +><P +> Forwarding can be used to chain Privoxy with a caching proxy to speed + up browsing. Using a parent proxy may also be necessary if the machine + that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> runs on has no direct Internet access.</P +><P +> Note that parent proxies can severely decrease your privacy level. + For example a parent proxy could add your IP address to the request + headers and if it's a caching proxy it may add the <SPAN +CLASS="QUOTE" +>"Etag"</SPAN +> + header to revalidation requests again, even though you configured Privoxy + to remove it. It may also ignore Privoxy's header time randomization and use the + original values which could be used by the server as cookie replacement + to track your steps between visits.</P +><P +> Also specified here are SOCKS proxies. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + supports the SOCKS 4 and SOCKS 4A protocols.</P +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="FORWARD" +>7.5.1. forward</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> To which parent HTTP proxy specific requests should be routed. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>target_pattern</I +></TT +> + <TT +CLASS="REPLACEABLE" +><I +>http_parent</I +></TT +>[:<TT +CLASS="REPLACEABLE" +><I +>port</I +></TT +>] + </P +><P +> where <TT +CLASS="REPLACEABLE" +><I +>target_pattern</I +></TT +> is a <A +HREF="actions-file.html#AF-PATTERNS" +>URL pattern</A +> + that specifies to which requests (i.e. URLs) this forward rule shall apply. Use <TT +CLASS="LITERAL" +>/</TT +> to + denote <SPAN +CLASS="QUOTE" +>"all URLs"</SPAN +>. + <TT +CLASS="REPLACEABLE" +><I +>http_parent</I +></TT +>[:<TT +CLASS="REPLACEABLE" +><I +>port</I +></TT +>] + is the DNS name or IP address of the parent HTTP proxy through which the requests should be forwarded, + optionally followed by its listening port (default: 8080). + Use a single dot (<TT +CLASS="LITERAL" +>.</TT +>) to denote <SPAN +CLASS="QUOTE" +>"no forwarding"</SPAN +>. + </P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Don't use parent HTTP proxies. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> If <TT +CLASS="REPLACEABLE" +><I +>http_parent</I +></TT +> is <SPAN +CLASS="QUOTE" +>"."</SPAN +>, then requests are not + forwarded to another HTTP proxy but are made directly to the web servers. + </P +><P +> Multiple lines are OK, they are checked in sequence, and the last match wins. + </P +></DD +><DT +>Examples:</DT +><DD +><P +> Everything goes to an example parent proxy, except SSL on port 443 (which it doesn't handle): + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> forward / parent-proxy.example.org:8080 + forward :443 .</PRE +></TD +></TR +></TABLE +> + </P +><P +> Everything goes to our example ISP's caching proxy, except for requests + to that ISP's sites: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> forward / caching-proxy.isp.example.net:8000 + forward .isp.example.net .</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="SOCKS" +>7.5.2. forward-socks4, forward-socks4a and forward-socks5</A +></H4 +><A +NAME="FORWARD-SOCKS4" +></A +><A +NAME="FORWARD-SOCKS4A" +></A +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Through which SOCKS proxy (and optionally to which parent HTTP proxy) specific requests should be routed. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>target_pattern</I +></TT +> + <TT +CLASS="REPLACEABLE" +><I +>socks_proxy</I +></TT +>[:<TT +CLASS="REPLACEABLE" +><I +>port</I +></TT +>] + <TT +CLASS="REPLACEABLE" +><I +>http_parent</I +></TT +>[:<TT +CLASS="REPLACEABLE" +><I +>port</I +></TT +>] + </P +><P +> where <TT +CLASS="REPLACEABLE" +><I +>target_pattern</I +></TT +> is a + <A +HREF="actions-file.html#AF-PATTERNS" +>URL pattern</A +> that specifies to which + requests (i.e. URLs) this forward rule shall apply. Use <TT +CLASS="LITERAL" +>/</TT +> to + denote <SPAN +CLASS="QUOTE" +>"all URLs"</SPAN +>. <TT +CLASS="REPLACEABLE" +><I +>http_parent</I +></TT +> + and <TT +CLASS="REPLACEABLE" +><I +>socks_proxy</I +></TT +> + are IP addresses in dotted decimal notation or valid DNS names + (<TT +CLASS="REPLACEABLE" +><I +>http_parent</I +></TT +> + may be <SPAN +CLASS="QUOTE" +>"."</SPAN +> to denote <SPAN +CLASS="QUOTE" +>"no HTTP forwarding"</SPAN +>), and the optional + <TT +CLASS="REPLACEABLE" +><I +>port</I +></TT +> parameters are TCP ports, + i.e. integer values from 1 to 65535 + </P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Unset</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Don't use SOCKS proxies. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Multiple lines are OK, they are checked in sequence, and the last match wins. + </P +><P +> The difference between <TT +CLASS="LITERAL" +>forward-socks4</TT +> and <TT +CLASS="LITERAL" +>forward-socks4a</TT +> + is that in the SOCKS 4A protocol, the DNS resolution of the target hostname happens on the SOCKS + server, while in SOCKS 4 it happens locally. + </P +><P +> With <TT +CLASS="LITERAL" +>forward-socks5</TT +> the DNS resolution will happen on the remote server as well. + </P +><P +> If <TT +CLASS="REPLACEABLE" +><I +>http_parent</I +></TT +> is <SPAN +CLASS="QUOTE" +>"."</SPAN +>, then requests are not + forwarded to another HTTP proxy but are made (HTTP-wise) directly to the web servers, albeit through + a SOCKS proxy. + </P +></DD +><DT +>Examples:</DT +><DD +><P +> From the company example.com, direct connections are made to all + <SPAN +CLASS="QUOTE" +>"internal"</SPAN +> domains, but everything outbound goes through + their ISP's proxy by way of example.com's corporate SOCKS 4A gateway to + the Internet. + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> forward-socks4a / socks-gw.example.com:1080 www-cache.isp.example.net:8080 + forward .example.com .</PRE +></TD +></TR +></TABLE +> + </P +><P +> A rule that uses a SOCKS 4 gateway for all destinations but no HTTP parent looks like this: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> forward-socks4 / socks-gw.example.com:1080 .</PRE +></TD +></TR +></TABLE +> + </P +><P +> To chain Privoxy and Tor, both running on the same system, you would use + something like: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> forward-socks4a / 127.0.0.1:9050 .</PRE +></TD +></TR +></TABLE +> + </P +><P +> The public <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> network can't be used to + reach your local network, if you need to access local servers you + therefore might want to make some exceptions: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> forward 192.168.*.*/ . + forward 10.*.*.*/ . + forward 127.*.*.*/ .</PRE +></TD +></TR +></TABLE +> + </P +><P +> Unencrypted connections to systems in these address ranges will + be as (un)secure as the local network is, but the alternative is that you + can't reach the local network through <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + at all. Of course this may actually be desired and there is no reason + to make these exceptions if you aren't sure you need them. + </P +><P +> If you also want to be able to reach servers in your local network by + using their names, you will need additional exceptions that look like + this: + </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD +><PRE +CLASS="SCREEN" +> forward localhost/ .</PRE +></TD +></TR +></TABLE +> + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ADVANCED-FORWARDING-EXAMPLES" +>7.5.3. Advanced Forwarding Examples</A +></H4 +><P +> If you have links to multiple ISPs that provide various special content + only to their subscribers, you can configure multiple <SPAN +CLASS="APPLICATION" +>Privoxies</SPAN +> + which have connections to the respective ISPs to act as forwarders to each other, so that + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>your</I +></SPAN +> users can see the internal content of all ISPs.</P +><P +> Assume that host-a has a PPP connection to isp-a.example.net. And host-b has a PPP connection to + isp-b.example.org. Both run <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. Their forwarding + configuration can look like this:</P +><P +> host-a:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> forward / . + forward .isp-b.example.net host-b:8118</PRE +></TD +></TR +></TABLE +></P +><P +> host-b:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> forward / . + forward .isp-a.example.org host-a:8118</PRE +></TD +></TR +></TABLE +></P +><P +> Now, your users can set their browser's proxy to use either + host-a or host-b and be able to browse the internal content + of both isp-a and isp-b.</P +><P +> If you intend to chain <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and + <SPAN +CLASS="APPLICATION" +>squid</SPAN +> locally, then chaining as + <TT +CLASS="LITERAL" +>browser -> squid -> privoxy</TT +> is the recommended way. </P +><P +> Assuming that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and <SPAN +CLASS="APPLICATION" +>squid</SPAN +> + run on the same box, your <SPAN +CLASS="APPLICATION" +>squid</SPAN +> configuration could then look like this:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> # Define Privoxy as parent proxy (without ICP) + cache_peer 127.0.0.1 parent 8118 7 no-query + + # Define ACL for protocol FTP + acl ftp proto FTP
- <dd> - <p>If set to 0, <span class="APPLICATION">Privoxy</span> will - start in <span class="QUOTE">"toggled off"</span> mode, i.e. - mostly behave like a normal, content-neutral proxy with both ad - blocking and content filtering disabled. See <tt class= - "LITERAL">enable-remote-toggle</tt> below.</p> - - <p>The windows version will only display the toggle icon in the - system tray if this option is present.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ENABLE-REMOTE-TOGGLE" id= - "ENABLE-REMOTE-TOGGLE">7.4.3. enable-remote-toggle</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Whether or not the <a href= - "http://config.privoxy.org/toggle" target="_top">web-based - toggle feature</a> may be used</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>0 or 1</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>0</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>The web-based toggle feature is disabled.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>When toggled off, <span class="APPLICATION">Privoxy</span> - mostly acts like a normal, content-neutral proxy, i.e. doesn't - block ads or filter content.</p> - - <p>Access to the toggle feature can <span class= - "emphasis EMPHASIS c2">not</span> be controlled separately by - <span class="QUOTE">"ACLs"</span> or HTTP authentication, so - that everybody who can access <span class= - "APPLICATION">Privoxy</span> (see <span class= - "QUOTE">"ACLs"</span> and <tt class= - "LITERAL">listen-address</tt> above) can toggle it for all - users. So this option is <span class="emphasis EMPHASIS c2">not - recommended</span> for multi-user environments with untrusted - users.</p> - - <p>Note that malicious client side code (e.g Java) is also - capable of using this option.</p> - - <p>As a lot of <span class="APPLICATION">Privoxy</span> users - don't read documentation, this feature is disabled by - default.</p> - - <p>Note that you must have compiled <span class= - "APPLICATION">Privoxy</span> with support for this feature, - otherwise this option has no effect.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ENABLE-REMOTE-HTTP-TOGGLE" id= - "ENABLE-REMOTE-HTTP-TOGGLE">7.4.4. enable-remote-http-toggle</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Whether or not Privoxy recognizes special HTTP headers to - change its behaviour.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>0 or 1</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>0</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Privoxy ignores special HTTP headers.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>When toggled on, the client can change <span class= - "APPLICATION">Privoxy's</span> behaviour by setting special - HTTP headers. Currently the only supported special header is - <span class="QUOTE">"X-Filter: No"</span>, to disable filtering - for the ongoing request, even if it is enabled in one of the - action files.</p> - - <p>This feature is disabled by default. If you are using - <span class="APPLICATION">Privoxy</span> in a environment with - trusted clients, you may enable this feature at your - discretion. Note that malicious client side code (e.g Java) is - also capable of using this feature.</p> - - <p>This option will be removed in future releases as it has - been obsoleted by the more general header taggers.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ENABLE-EDIT-ACTIONS" id= - "ENABLE-EDIT-ACTIONS">7.4.5. enable-edit-actions</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Whether or not the <a href= - "http://config.privoxy.org/show-status" target="_top">web-based - actions file editor</a> may be used</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>0 or 1</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>0</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>The web-based actions file editor is disabled.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Access to the editor can <span class= - "emphasis EMPHASIS c2">not</span> be controlled separately by - <span class="QUOTE">"ACLs"</span> or HTTP authentication, so - that everybody who can access <span class= - "APPLICATION">Privoxy</span> (see <span class= - "QUOTE">"ACLs"</span> and <tt class= - "LITERAL">listen-address</tt> above) can modify its - configuration for all users.</p> - - <p>This option is <span class="emphasis EMPHASIS c2">not - recommended</span> for environments with untrusted users and as - a lot of <span class="APPLICATION">Privoxy</span> users don't - read documentation, this feature is disabled by default.</p> - - <p>Note that malicious client side code (e.g Java) is also - capable of using the actions editor and you shouldn't enable - this options unless you understand the consequences and are - sure your browser is configured correctly.</p> - - <p>Note that you must have compiled <span class= - "APPLICATION">Privoxy</span> with support for this feature, - otherwise this option has no effect.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ENFORCE-BLOCKS" id="ENFORCE-BLOCKS">7.4.6. - enforce-blocks</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Whether the user is allowed to ignore blocks and can - <span class="QUOTE">"go there anyway"</span>.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">0 or 1</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">0</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Blocks are not enforced.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p><span class="APPLICATION">Privoxy</span> is mainly used to - block and filter requests as a service to the user, for example - to block ads and other junk that clogs the pipes. <span class= - "APPLICATION">Privoxy's</span> configuration isn't perfect and - sometimes innocent pages are blocked. In this situation it - makes sense to allow the user to enforce the request and have - <span class="APPLICATION">Privoxy</span> ignore the block.</p> - - <p>In the default configuration <span class= - "APPLICATION">Privoxy's</span> <span class= - "QUOTE">"Blocked"</span> page contains a <span class= - "QUOTE">"go there anyway"</span> link to adds a special string - (the force prefix) to the request URL. If that link is used, - <span class="APPLICATION">Privoxy</span> will detect the force - prefix, remove it again and let the request pass.</p> - - <p>Of course <span class="APPLICATION">Privoxy</span> can also - be used to enforce a network policy. In that case the user - obviously should not be able to bypass any blocks, and that's - what the <span class="QUOTE">"enforce-blocks"</span> option is - for. If it's enabled, <span class="APPLICATION">Privoxy</span> - hides the <span class="QUOTE">"go there anyway"</span> link. If - the user adds the force prefix by hand, it will not be accepted - and the circumvention attempt is logged.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>enforce-blocks 1</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ACLS" id="ACLS">7.4.7. ACLs: permit-access - and deny-access</a></h4><a name="PERMIT-ACCESS" id= - "PERMIT-ACCESS"></a><a name="DENY-ACCESS" id="DENY-ACCESS"></a> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Who can access what.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">src_addr</tt>[:<tt class= - "REPLACEABLE c3">port</tt>][/<tt class= - "REPLACEABLE c3">src_masklen</tt>] [<tt class= - "REPLACEABLE c3">dst_addr</tt>[:<tt class= - "REPLACEABLE c3">port</tt>][/<tt class= - "REPLACEABLE c3">dst_masklen</tt>]]</p> - - <p>Where <tt class="REPLACEABLE c3">src_addr</tt> and - <tt class="REPLACEABLE c3">dst_addr</tt> are IPv4 addresses in - dotted decimal notation or valid DNS names, <tt class= - "REPLACEABLE c3">port</tt> is a port number, and <tt class= - "REPLACEABLE c3">src_masklen</tt> and <tt class= - "REPLACEABLE c3">dst_masklen</tt> are subnet masks in CIDR - notation, i.e. integer values from 2 to 30 representing the - length (in bits) of the network address. The masks and the - whole destination part are optional.</p> - - <p>If your system implements <a href= - "http://tools.ietf.org/html/rfc3493" target="_top">RFC - 3493</a>, then <tt class="REPLACEABLE c3">src_addr</tt> and - <tt class="REPLACEABLE c3">dst_addr</tt> can be IPv6 addresses - delimeted by brackets, <tt class="REPLACEABLE c3">port</tt> can - be a number or a service name, and <tt class= - "REPLACEABLE c3">src_masklen</tt> and <tt class= - "REPLACEABLE c3">dst_masklen</tt> can be a number from 0 to - 128.</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset</span></p> - - <p>If no <tt class="REPLACEABLE c3">port</tt> is specified, any - port will match. If no <tt class= - "REPLACEABLE c3">src_masklen</tt> or <tt class= - "REPLACEABLE c3">src_masklen</tt> is given, the complete IP - address has to match (i.e. 32 bits for IPv4 and 128 bits for - IPv6).</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Don't restrict access further than implied by <tt class= - "LITERAL">listen-address</tt></p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Access controls are included at the request of ISPs and - systems administrators, and <span class= - "emphasis EMPHASIS c2">are not usually needed by individual - users</span>. For a typical home user, it will normally suffice - to ensure that <span class="APPLICATION">Privoxy</span> only - listens on the localhost (127.0.0.1) or internal (home) network - address by means of the <a href= - "config.html#LISTEN-ADDRESS"><span class= - "emphasis EMPHASIS c2">listen-address</span></a> option.</p> - - <p>Please see the warnings in the FAQ that <span class= - "APPLICATION">Privoxy</span> is not intended to be a substitute - for a firewall or to encourage anyone to defer addressing basic - security weaknesses.</p> - - <p>Multiple ACL lines are OK. If any ACLs are specified, - <span class="APPLICATION">Privoxy</span> only talks to IP - addresses that match at least one <tt class= - "LITERAL">permit-access</tt> line and don't match any - subsequent <tt class="LITERAL">deny-access</tt> line. In other - words, the last match wins, with the default being <tt class= - "LITERAL">deny-access</tt>.</p> - - <p>If <span class="APPLICATION">Privoxy</span> is using a - forwarder (see <tt class="LITERAL">forward</tt> below) for a - particular destination URL, the <tt class= - "REPLACEABLE c3">dst_addr</tt> that is examined is the address - of the forwarder and <span class= - "emphasis EMPHASIS c2">NOT</span> the address of the ultimate - target. This is necessary because it may be impossible for the - local <span class="APPLICATION">Privoxy</span> to determine the - IP address of the ultimate target (that's often what gateways - are used for).</p> - - <p>You should prefer using IP addresses over DNS names, because - the address lookups take time. All DNS names must resolve! You - can <span class="emphasis EMPHASIS c2">not</span> use domain - patterns like <span class="QUOTE">"*.org"</span> or partial - domain names. If a DNS name resolves to multiple IP addresses, - only the first one is used.</p> - - <p>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). - <span class="APPLICATION">Privoxy</span> can handle it and maps - such ACL addresses automatically.</p> - - <p>Denying access to particular sites by ACL may have undesired - side effects if the site in question is hosted on a machine - which also hosts other sites (most sites are).</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>Explicitly define the default behavior if no ACL and - <tt class="LITERAL">listen-address</tt> are set: <span class= - "QUOTE">"localhost"</span> is OK. The absence of a <tt class= - "REPLACEABLE c3">dst_addr</tt> implies that <span class= - "emphasis EMPHASIS c2">all</span> destination addresses are - OK:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - permit-access localhost -</pre> - </td> - </tr> - </table> - - <p>Allow any host on the same class C subnet as www.privoxy.org - access to nothing but www.example.com (or other domains hosted - on the same system):</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - permit-access www.privoxy.org/24 www.example.com/32 -</pre> - </td> - </tr> - </table> - - <p>Allow access from any host on the 26-bit subnet - 192.168.45.64 to anywhere, with the exception that - 192.168.45.73 may not access the IP address behind - www.dirty-stuff.example.com:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - permit-access 192.168.45.64/26 - deny-access 192.168.45.73 www.dirty-stuff.example.com -</pre> - </td> - </tr> - </table> - - <p>Allow access from the IPv4 network 192.0.2.0/24 even if - listening on an IPv6 wild card address (not supported on all - platforms):</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - permit-access 192.0.2.0/24 -</pre> - </td> - </tr> - </table> - - <p>This is equivalent to the following line even if listening - on an IPv4 address (not supported on all platforms):</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - permit-access [::ffff:192.0.2.0]/120 -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="BUFFER-LIMIT" id="BUFFER-LIMIT">7.4.8. - buffer-limit</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Maximum size of the buffer for content filtering.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p>Size in Kbytes</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>4096</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Use a 4MB (4096 KB) limit.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>For content filtering, i.e. the <tt class= - "LITERAL">+filter</tt> and <tt class= - "LITERAL">+deanimate-gif</tt> actions, it is necessary that - <span class="APPLICATION">Privoxy</span> buffers the entire - document body. This can be potentially dangerous, since a - server could just keep sending data indefinitely and wait for - your RAM to exhaust -- with nasty consequences. Hence this - option.</p> - - <p>When a document buffer size reaches the <tt class= - "LITERAL">buffer-limit</tt>, it is flushed to the client - unfiltered and no further attempt to filter the rest of the - document is made. Remember that there may be multiple threads - running, which might require up to <tt class= - "LITERAL">buffer-limit</tt> Kbytes <span class= - "emphasis EMPHASIS c2">each</span>, unless you have enabled - <span class="QUOTE">"single-threaded"</span> above.</p> - </dd> - </dl> - </div> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="FORWARDING" id="FORWARDING">7.5. - Forwarding</a></h2> - - <p>This feature allows routing of HTTP requests through a chain of - multiple proxies.</p> - - <p>Forwarding can be used to chain Privoxy with a caching proxy to - speed up browsing. Using a parent proxy may also be necessary if the - machine that <span class="APPLICATION">Privoxy</span> runs on has no - direct Internet access.</p> - - <p>Note that parent proxies can severely decrease your privacy level. - For example a parent proxy could add your IP address to the request - headers and if it's a caching proxy it may add the <span class= - "QUOTE">"Etag"</span> header to revalidation requests again, even - though you configured Privoxy to remove it. It may also ignore - Privoxy's header time randomization and use the original values which - could be used by the server as cookie replacement to track your steps - between visits.</p> - - <p>Also specified here are SOCKS proxies. <span class= - "APPLICATION">Privoxy</span> supports the SOCKS 4 and SOCKS 4A - protocols.</p> - - <div class="SECT3"> - <h4 class="SECT3"><a name="FORWARD" id="FORWARD">7.5.1. - forward</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>To which parent HTTP proxy specific requests should be - routed.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">target_pattern</tt> <tt class= - "REPLACEABLE c3">http_parent</tt>[:<tt class= - "REPLACEABLE c3">port</tt>]</p> - - <p>where <tt class="REPLACEABLE c3">target_pattern</tt> is a - <a href="actions-file.html#AF-PATTERNS">URL pattern</a> that - specifies to which requests (i.e. URLs) this forward rule shall - apply. Use <tt class="LITERAL">/</tt> to denote <span class= - "QUOTE">"all URLs"</span>. <tt class= - "REPLACEABLE c3">http_parent</tt>[:<tt class= - "REPLACEABLE c3">port</tt>] is the DNS name or IP address of - the parent HTTP proxy through which the requests should be - forwarded, optionally followed by its listening port (default: - 8000). Use a single dot (<tt class="LITERAL">.</tt>) to denote - <span class="QUOTE">"no forwarding"</span>.</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Don't use parent HTTP proxies.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>If <tt class="REPLACEABLE c3">http_parent</tt> is - <span class="QUOTE">"."</span>, then requests are not forwarded - to another HTTP proxy but are made directly to the web - servers.</p> - - <p><tt class="REPLACEABLE c3">http_parent</tt> can be a - numerical IPv6 address (if <a href= - "http://tools.ietf.org/html/rfc3493" target="_top">RFC 3493</a> - is implemented). To prevent clashes with the port delimiter, - the whole IP address has to be put into brackets. On the other - hand a <tt class="REPLACEABLE c3">target_pattern</tt> - containing an IPv6 address has to be put into angle brackets - (normal brackets are reserved for regular expressions - already).</p> - - <p>Multiple lines are OK, they are checked in sequence, and the - last match wins.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>Everything goes to an example parent proxy, except SSL on - port 443 (which it doesn't handle):</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - forward / parent-proxy.example.org:8080 - forward :443 . -</pre> - </td> - </tr> - </table> - - <p>Everything goes to our example ISP's caching proxy, except - for requests to that ISP's sites:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - forward / caching-proxy.isp.example.net:8000 - forward .isp.example.net . -</pre> - </td> - </tr> - </table> - - <p>Parent proxy specified by an IPv6 address:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - forward / [2001:DB8::1]:8000 -</pre> - </td> - </tr> - </table> - - <p>Suppose your parent proxy doesn't support IPv6:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="PROGRAMLISTING"> - forward / parent-proxy.example.org:8000 - forward ipv6-server.example.org . - forward <[2-3][0-9a-f][0-9a-f][0-9a-f]:*> . -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="SOCKS" id="SOCKS">7.5.2. forward-socks4, - forward-socks4a and forward-socks5</a></h4><a name="FORWARD-SOCKS4" - id="FORWARD-SOCKS4"></a><a name="FORWARD-SOCKS4A" id= - "FORWARD-SOCKS4A"></a> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Through which SOCKS proxy (and optionally to which parent - HTTP proxy) specific requests should be routed.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">target_pattern</tt> <tt class= - "REPLACEABLE c3">socks_proxy</tt>[:<tt class= - "REPLACEABLE c3">port</tt>] <tt class= - "REPLACEABLE c3">http_parent</tt>[:<tt class= - "REPLACEABLE c3">port</tt>]</p> - - <p>where <tt class="REPLACEABLE c3">target_pattern</tt> is a - <a href="actions-file.html#AF-PATTERNS">URL pattern</a> that - specifies to which requests (i.e. URLs) this forward rule shall - apply. Use <tt class="LITERAL">/</tt> to denote <span class= - "QUOTE">"all URLs"</span>. <tt class= - "REPLACEABLE c3">http_parent</tt> and <tt class= - "REPLACEABLE c3">socks_proxy</tt> are IP addresses in dotted - decimal notation or valid DNS names (<tt class= - "REPLACEABLE c3">http_parent</tt> may be <span class= - "QUOTE">"."</span> to denote <span class="QUOTE">"no HTTP - forwarding"</span>), and the optional <tt class= - "REPLACEABLE c3">port</tt> parameters are TCP ports, i.e. - integer values from 1 to 65535</p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">Unset</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Don't use SOCKS proxies.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Multiple lines are OK, they are checked in sequence, and the - last match wins.</p> - - <p>The difference between <tt class= - "LITERAL">forward-socks4</tt> and <tt class= - "LITERAL">forward-socks4a</tt> is that in the SOCKS 4A - protocol, the DNS resolution of the target hostname happens on - the SOCKS server, while in SOCKS 4 it happens locally.</p> - - <p>With <tt class="LITERAL">forward-socks5</tt> the DNS - resolution will happen on the remote server as well.</p> - - <p><tt class="REPLACEABLE c3">socks_proxy</tt> and <tt class= - "REPLACEABLE c3">http_parent</tt> can be a numerical IPv6 - address (if <a href="http://tools.ietf.org/html/rfc3493" - target="_top">RFC 3493</a> is implemented). To prevent clashes - with the port delimiter, the whole IP address has to be put - into brackets. On the other hand a <tt class= - "REPLACEABLE c3">target_pattern</tt> containing an IPv6 address - has to be put into angle brackets (normal brackets are reserved - for regular expressions already).</p> - - <p>If <tt class="REPLACEABLE c3">http_parent</tt> is - <span class="QUOTE">"."</span>, then requests are not forwarded - to another HTTP proxy but are made (HTTP-wise) directly to the - web servers, albeit through a SOCKS proxy.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>From the company example.com, direct connections are made to - all <span class="QUOTE">"internal"</span> domains, but - everything outbound goes through their ISP's proxy by way of - example.com's corporate SOCKS 4A gateway to the Internet.</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - forward-socks4a / socks-gw.example.com:1080 www-cache.isp.example.net:8080 - forward .example.com . -</pre> - </td> - </tr> - </table> - - <p>A rule that uses a SOCKS 4 gateway for all destinations but - no HTTP parent looks like this:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - forward-socks4 / socks-gw.example.com:1080 . -</pre> - </td> - </tr> - </table> - - <p>To chain Privoxy and Tor, both running on the same system, - you would use something like:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - forward-socks5 / 127.0.0.1:9050 . -</pre> - </td> - </tr> - </table> - - <p>The public <span class="APPLICATION">Tor</span> network - can't be used to reach your local network, if you need to - access local servers you therefore might want to make some - exceptions:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - forward 192.168.*.*/ . - forward 10.*.*.*/ . - forward 127.*.*.*/ . -</pre> - </td> - </tr> - </table> - - <p>Unencrypted connections to systems in these address ranges - will be as (un)secure as the local network is, but the - alternative is that you can't reach the local network through - <span class="APPLICATION">Privoxy</span> at all. Of course this - may actually be desired and there is no reason to make these - exceptions if you aren't sure you need them.</p> - - <p>If you also want to be able to reach servers in your local - network by using their names, you will need additional - exceptions that look like this:</p> - - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - forward localhost/ . -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ADVANCED-FORWARDING-EXAMPLES" id= - "ADVANCED-FORWARDING-EXAMPLES">7.5.3. Advanced Forwarding - Examples</a></h4> - - <p>If you have links to multiple ISPs that provide various special - content only to their subscribers, you can configure multiple - <span class="APPLICATION">Privoxies</span> which have connections to - the respective ISPs to act as forwarders to each other, so that - <span class="emphasis EMPHASIS c2">your</span> users can see the - internal content of all ISPs.</p> - - <p>Assume that host-a has a PPP connection to isp-a.example.net. And - host-b has a PPP connection to isp-b.example.org. Both run - <span class="APPLICATION">Privoxy</span>. Their forwarding - configuration can look like this:</p> - - <p>host-a:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - forward / . - forward .isp-b.example.net host-b:8118 -</pre> - </td> - </tr> - </table> - - <p>host-b:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - forward / . - forward .isp-a.example.org host-a:8118 -</pre> - </td> - </tr> - </table> - - <p>Now, your users can set their browser's proxy to use either host-a - or host-b and be able to browse the internal content of both isp-a - and isp-b.</p> - - <p>If you intend to chain <span class="APPLICATION">Privoxy</span> - and <span class="APPLICATION">squid</span> locally, then chaining as - <tt class="LITERAL">browser -> squid -> privoxy</tt> is the - recommended way.</p> - - <p>Assuming that <span class="APPLICATION">Privoxy</span> and - <span class="APPLICATION">squid</span> run on the same box, your - <span class="APPLICATION">squid</span> configuration could then look - like this:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - # Define Privoxy as parent proxy (without ICP) - cache_peer 127.0.0.1 parent 8118 7 no-query - - # Define ACL for protocol FTP - acl ftp proto FTP - - # Do not forward FTP requests to Privoxy - always_direct allow ftp + # Do not forward FTP requests to Privoxy + always_direct allow ftp
# Forward all the rest to Privoxy - never_direct allow all -</pre> - </td> - </tr> - </table> - - <p>You would then need to change your browser's proxy settings to - <span class="APPLICATION">squid</span>'s address and port. Squid - normally uses port 3128. If unsure consult <tt class= - "LITERAL">http_port</tt> in <tt class="FILENAME">squid.conf</tt>.</p> - - <p>You could just as well decide to only forward requests you suspect - of leading to Windows executables through a virus-scanning parent - proxy, say, on <tt class="LITERAL">antivir.example.com</tt>, port - 8010:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - forward / . - forward /.*.(exe|com|dll|zip)$ antivir.example.com:8010 -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="FORWARDED-CONNECT-RETRIES" id= - "FORWARDED-CONNECT-RETRIES">7.5.4. forwarded-connect-retries</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>How often Privoxy retries if a forwarded connection request - fails.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">Number of retries.</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">0</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Connections forwarded through other proxies are treated like - direct connections and no retry attempts are made.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">forwarded-connect-retries</tt> is - mainly interesting for socks4a connections, where <span class= - "APPLICATION">Privoxy</span> can't detect why the connections - failed. The connection might have failed because of a DNS - timeout in which case a retry makes sense, but it might also - have failed because the server doesn't exist or isn't - reachable. In this case the retry will just delay the - appearance of Privoxy's error message.</p> - - <p>Note that in the context of this option, <span class= - "QUOTE">"forwarded connections"</span> includes all connections - that Privoxy forwards through other proxies. This option is not - limited to the HTTP CONNECT method.</p> - - <p>Only use this option, if you are getting lots of - forwarding-related error messages 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.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>forwarded-connect-retries 1</p> - </dd> - </dl> - </div> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="MISC" id="MISC">7.6. Miscellaneous</a></h2> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ACCEPT-INTERCEPTED-REQUESTS" id= - "ACCEPT-INTERCEPTED-REQUESTS">7.6.1. - accept-intercepted-requests</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Whether intercepted requests should be treated as valid.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">0 or 1</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">0</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Only proxy requests are accepted, intercepted requests are - treated as invalid.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>If you don't trust your clients and want to force them to - use <span class="APPLICATION">Privoxy</span>, enable this - option and configure your packet filter to redirect outgoing - HTTP connections into <span class= - "APPLICATION">Privoxy</span>.</p> - - <p>Make sure that <span class="APPLICATION">Privoxy's</span> - own requests aren't redirected as well. Additionally take care - that <span class="APPLICATION">Privoxy</span> can't - intentionally connect to itself, otherwise you could run into - redirection loops if <span class="APPLICATION">Privoxy's</span> - listening port is reachable by the outside or an attacker has - access to the pages you visit.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>accept-intercepted-requests 1</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ALLOW-CGI-REQUEST-CRUNCHING" id= - "ALLOW-CGI-REQUEST-CRUNCHING">7.6.2. - allow-cgi-request-crunching</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Whether requests to <span class= - "APPLICATION">Privoxy's</span> CGI pages can be blocked or - redirected.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">0 or 1</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">0</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p><span class="APPLICATION">Privoxy</span> ignores block and - redirect actions for its CGI pages.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>By default <span class="APPLICATION">Privoxy</span> ignores - block or redirect actions for its CGI pages. Intercepting these - requests can be useful in multi-user setups to implement - fine-grained access control, but it can also render the - complete web interface useless and make debugging problems - painful if done without care.</p> - - <p>Don't enable this option unless you're sure that you really - need it.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>allow-cgi-request-crunching 1</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="SPLIT-LARGE-FORMS" id= - "SPLIT-LARGE-FORMS">7.6.3. split-large-forms</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Whether the CGI interface should stay compatible with broken - HTTP clients.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">0 or 1</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p><span class="emphasis EMPHASIS c2">0</span></p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>The CGI form generate long GET URLs.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p><span class="APPLICATION">Privoxy's</span> CGI forms can - lead to rather long URLs. This isn't a problem as far as the - HTTP standard is concerned, but it can confuse clients with - arbitrary URL length limitations.</p> - - <p>Enabling split-large-forms causes <span class= - "APPLICATION">Privoxy</span> to divide big forms into smaller - ones to keep the URL length down. It makes editing a lot less - convenient and you can no longer submit all changes at once, - but at least it works around this browser bug.</p> - - <p>If you don't notice any editing problems, there is no reason - to enable this option, but if one of the submit buttons appears - to be broken, you should give it a try.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>split-large-forms 1</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="KEEP-ALIVE-TIMEOUT" id= - "KEEP-ALIVE-TIMEOUT">7.6.4. keep-alive-timeout</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Number of seconds after which an open connection will no - longer be reused.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">Time in seconds.</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>None</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Connections are not kept alive.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This option allows clients to keep the connection to - <span class="APPLICATION">Privoxy</span> alive. If the server - supports it, <span class="APPLICATION">Privoxy</span> will keep - the connection to the server alive as well. Under certain - circumstances this may result in speed-ups.</p> - - <p>By default, <span class="APPLICATION">Privoxy</span> will - close the connection to the server if the client connection - gets closed, or if the specified timeout has been reached - without a new request coming in. This behaviour can be changed - with the <a href="#CONNECTION-SHARING" target= - "_top">connection-sharing</a> option.</p> - - <p>This option has no effect if <span class= - "APPLICATION">Privoxy</span> has been compiled without - keep-alive support.</p> - - <p>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 <span class="QUOTE">"grabbing"</span> all the - connections the browser allows, which means connections to - other websites can't be opened until the connections currently - in use time out.</p> - - <p>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.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>keep-alive-timeout 300</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="DEFAULT-SERVER-TIMEOUT" id= - "DEFAULT-SERVER-TIMEOUT">7.6.5. default-server-timeout</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Assumed server-side keep-alive timeout if not specified by - the server.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">Time in seconds.</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>None</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Connections for which the server didn't specify the - keep-alive timeout are not reused.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Enabling this option significantly increases the number of - connections that are reused, provided the <a href= - "#KEEP-ALIVE-TIMEOUT" target="_top">keep-alive-timeout</a> - option is also enabled.</p> - - <p>While it also increases the number of connections problems - when <span class="APPLICATION">Privoxy</span> tries to reuse a - connection that already has been closed on the server side, or - is closed while <span class="APPLICATION">Privoxy</span> is - trying to reuse it, this should only be a problem if it happens - for the first request sent by the client. If it happens for - requests on reused client connections, <span class= - "APPLICATION">Privoxy</span> will simply close the connection - and the client is supposed to retry the request without - bothering the user.</p> - - <p>Enabling this option is therefore only recommended if the - <a href="#CONNECTION-SHARING" target= - "_top">connection-sharing</a> option is disabled.</p> - - <p>It is an error to specify a value larger than the <a href= - "#KEEP-ALIVE-TIMEOUT" target="_top">keep-alive-timeout</a> - value.</p> - - <p>This option has no effect if <span class= - "APPLICATION">Privoxy</span> has been compiled without - keep-alive support.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>default-server-timeout 60</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="CONNECTION-SHARING" id= - "CONNECTION-SHARING">7.6.6. connection-sharing</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Whether or not outgoing connections that have been kept - alive should be shared between different incoming - connections.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">0 or 1</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>None</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Connections are not shared.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This option has no effect if <span class= - "APPLICATION">Privoxy</span> has been compiled without - keep-alive support, or if it's disabled.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Note that reusing connections doesn't necessary cause - speedups. There are also a few privacy implications you should - be aware of.</p> - - <p>If this option is effective, outgoing connections are shared - between clients (if there are more than one) and closing the - browser that initiated the outgoing connection does no longer - affect the connection between <span class= - "APPLICATION">Privoxy</span> and the server unless the client's - request hasn't been completed yet.</p> - - <p>If the outgoing connection is idle, it will not be closed - until either <span class="APPLICATION">Privoxy's</span> or the - server's timeout is reached. While it's open, the server knows - that the system running <span class= - "APPLICATION">Privoxy</span> is still there.</p> - - <p>If there are more than one client (maybe even belonging to - multiple users), they will be able to reuse each others - connections. This is potentially dangerous in case of - authentication schemes like NTLM where only the connection is - authenticated, instead of requiring authentication for each - request.</p> - - <p>If there is only a single client, and if said client can - keep connections alive on its own, enabling this option has - next to no effect. If the client doesn't support connection - keep-alive, enabling this option may make sense as it allows - <span class="APPLICATION">Privoxy</span> to keep outgoing - connections alive even if the client itself doesn't support - it.</p> - - <p>You should also be aware that enabling this option increases - the likelihood of getting the "No server or forwarder data" - error message, especially if you are using a slow connection to - the Internet.</p> - - <p>This option should only be used by experienced users who - understand the risks and can weight them against the - benefits.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>connection-sharing 1</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="SOCKET-TIMEOUT" id="SOCKET-TIMEOUT">7.6.7. - socket-timeout</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Number of seconds after which a socket times out if no data - is received.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">Time in seconds.</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>None</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>A default value of 300 seconds is used.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>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.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>socket-timeout 300</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="MAX-CLIENT-CONNECTIONS" id= - "MAX-CLIENT-CONNECTIONS">7.6.8. max-client-connections</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Maximum number of client connections that will be - served.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">Positive number.</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>None</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Connections are served until a resource limit is - reached.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p><span class="APPLICATION">Privoxy</span> creates one thread - (or process) for every incoming client connection that isn't - rejected based on the access control settings.</p> - - <p>If the system is powerful enough, <span class= - "APPLICATION">Privoxy</span> can theoretically deal with - several hundred (or thousand) connections at the same time, but - some operating systems enforce resource limits by shutting down - offending processes and their default limits may be below the - ones <span class="APPLICATION">Privoxy</span> would require - under heavy load.</p> - - <p>Configuring <span class="APPLICATION">Privoxy</span> to - enforce a connection limit below the thread or process limit - used by the operating system makes sure this doesn't happen. - Simply increasing the operating system's limit would work too, - but if <span class="APPLICATION">Privoxy</span> isn't the only - application running on the system, you may actually want to - limit the resources used by <span class= - "APPLICATION">Privoxy</span>.</p> - - <p>If <span class="APPLICATION">Privoxy</span> is only used by - a single trusted user, limiting the number of client - connections is probably unnecessary. If there are multiple - possibly untrusted users you probably still want to - additionally use a packet filter to limit the maximal number of - incoming connections per client. Otherwise a malicious user - could intentionally create a high number of connections to - prevent other users from using <span class= - "APPLICATION">Privoxy</span>.</p> - - <p>Obviously using this option only makes sense if you choose a - limit below the one enforced by the operating system.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <p>max-client-connections 256</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="HANDLE-AS-EMPTY-DOC-RETURNS-OK" id= - "HANDLE-AS-EMPTY-DOC-RETURNS-OK">7.6.9. - handle-as-empty-doc-returns-ok</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>The status code Privoxy returns for pages blocked with - <tt class="LITERAL"><a href= - "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT" target= - "_top">+handle-as-empty-document</a></tt>.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">0 or 1</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>0</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Privoxy returns a status 403(forbidden) for all blocked - pages.</p> - </dd> - - <dt>Effect if set:</dt> - - <dd> - <p>Privoxy returns a status 200(OK) for pages blocked with - +handle-as-empty-document and a status 403(Forbidden) for all - other blocked pages.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This is a work-around for Firefox bug 492459: <span class= - "QUOTE">" Websites are no longer rendered if SSL requests for - JavaScripts are blocked by a proxy. "</span> (<a href= - "https://bugzilla.mozilla.org/show_bug.cgi?id=492459" target= - "_top">https://bugzilla.mozilla.org/show_bug.cgi?id=492459</a>) - 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.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="ENABLE-COMPRESSION" id= - "ENABLE-COMPRESSION">7.6.10. enable-compression</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>Whether or not buffered content is compressed before - delivery.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">0 or 1</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>0</p> - </dd> - - <dt>Effect if unset:</dt> - - <dd> - <p>Privoxy does not compress buffered content.</p> - </dd> - - <dt>Effect if set:</dt> - - <dd> - <p>Privoxy compresses buffered content before delivering it to - the client, provided the client supports it.</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>This directive is only supported if Privoxy has been - compiled with FEATURE_COMPRESSION, which should not to be - confused with FEATURE_ZLIB.</p> - - <p>Compressing buffered content is mainly useful if Privoxy and - the client are running on different systems. If they are - running on the same system, enabling compression is likely to - slow things down. If you didn't measure otherwise, you should - assume that it does and keep this option disabled.</p> - - <p>Privoxy will not compress buffered content below a certain - length.</p> - </dd> - </dl> - </div> - </div> - - <div class="SECT3"> - <h4 class="SECT3"><a name="COMPRESSION-LEVEL" id= - "COMPRESSION-LEVEL">7.6.11. compression-level</a></h4> - - <div class="VARIABLELIST"> - <dl> - <dt>Specifies:</dt> - - <dd> - <p>The compression level that is passed to the zlib library - when compressing buffered content.</p> - </dd> - - <dt>Type of value:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">Positive number ranging from 0 to - 9.</tt></p> - </dd> - - <dt>Default value:</dt> - - <dd> - <p>1</p> - </dd> - - <dt>Notes:</dt> - - <dd> - <p>Compressing the data more takes usually longer than - compressing it less or not compressing it at all. Which level - is best depends on the connection between Privoxy and the - client. If you can't be bothered to benchmark it for yourself, - you should stick with the default and keep compression - disabled.</p> - - <p>If compression is disabled, the compression level is - irrelevant.</p> - </dd> - - <dt>Examples:</dt> - - <dd> - <table class="c4" border="0" width="90%"> - <tr> - <td> - <pre class="SCREEN"> - # Best speed (compared to the other levels) - compression-level 1 - # Best compression - compression-level 9 - # No compression. Only useful for testing as the added header - # slightly increases the amount of data that has to be sent. - # If your benchmark shows that using this compression level - # is superior to using no compression at all, the benchmark - # is likely to be flawed. - compression-level 0 - -</pre> - </td> - </tr> - </table> - </dd> - </dl> - </div> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="WINDOWS-GUI" id="WINDOWS-GUI">7.7. Windows - GUI Options</a></h2> - - <p><span class="APPLICATION">Privoxy</span> has a number of options - specific to the Windows GUI interface:</p><a name="ACTIVITY-ANIMATION" - id="ACTIVITY-ANIMATION"></a> - - <p>If <span class="QUOTE">"activity-animation"</span> is set to 1, the - <span class="APPLICATION">Privoxy</span> icon will animate when - <span class="QUOTE">"Privoxy"</span> is active. To turn off, set to - 0.</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> <span class= - "emphasis EMPHASIS c2">activity-animation 1</span><br> - </tt></p><a name="LOG-MESSAGES" id= - "LOG-MESSAGES"></a> - - <p>If <span class="QUOTE">"log-messages"</span> is set to 1, - <span class="APPLICATION">Privoxy</span> will log messages to the - console window:</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> <span class= - "emphasis EMPHASIS c2">log-messages 1</span><br> - </tt></p><a name="LOG-BUFFER-SIZE" id= - "LOG-BUFFER-SIZE"></a> - - <p>If <span class="QUOTE">"log-buffer-size"</span> is set to 1, the - size of the log buffer, i.e. the amount of memory used for the log - messages displayed in the console window, will be limited to - <span class="QUOTE">"log-max-lines"</span> (see below).</p> - - <p>Warning: Setting this to 0 will result in the buffer to grow - infinitely and eat up all your memory!</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> <span class= - "emphasis EMPHASIS c2">log-buffer-size 1</span><br> - </tt></p><a name="LOG-MAX-LINES" id= - "LOG-MAX-LINES"></a> - - <p><span class="APPLICATION">log-max-lines</span> is the maximum number - of lines held in the log buffer. See above.</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> <span class= - "emphasis EMPHASIS c2">log-max-lines 200</span><br> - </tt></p><a name="LOG-HIGHLIGHT-MESSAGES" id= - "LOG-HIGHLIGHT-MESSAGES"></a> - - <p>If <span class="QUOTE">"log-highlight-messages"</span> is set to 1, - <span class="APPLICATION">Privoxy</span> will highlight portions of the - log messages with a bold-faced font:</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> <span class= - "emphasis EMPHASIS c2">log-highlight-messages 1</span><br> - </tt></p><a name="LOG-FONT-NAME" id= - "LOG-FONT-NAME"></a> - - <p>The font used in the console window:</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> <span class= - "emphasis EMPHASIS c2">log-font-name Comic Sans MS</span><br> - </tt></p><a name="LOG-FONT-SIZE" id= - "LOG-FONT-SIZE"></a> - - <p>Font size used in the console window:</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> <span class= - "emphasis EMPHASIS c2">log-font-size 8</span><br> - </tt></p><a name="SHOW-ON-TASK-BAR" id= - "SHOW-ON-TASK-BAR"></a> - - <p><span class="QUOTE">"show-on-task-bar"</span> controls whether or - not <span class="APPLICATION">Privoxy</span> will appear as a button on - the Task bar when minimized:</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> <span class= - "emphasis EMPHASIS c2">show-on-task-bar 0</span><br> - </tt></p><a name="CLOSE-BUTTON-MINIMIZES" id= - "CLOSE-BUTTON-MINIMIZES"></a> - - <p>If <span class="QUOTE">"close-button-minimizes"</span> is set to 1, - the Windows close button will minimize <span class= - "APPLICATION">Privoxy</span> instead of closing the program (close with - the exit option on the File menu).</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> <span class= - "emphasis EMPHASIS c2">close-button-minimizes 1</span><br> - </tt></p><a name="HIDE-CONSOLE" id= - "HIDE-CONSOLE"></a> - - <p>The <span class="QUOTE">"hide-console"</span> option is specific to - the MS-Win console version of <span class="APPLICATION">Privoxy</span>. - If this option is used, <span class="APPLICATION">Privoxy</span> will - disconnect from and hide the command console.</p> - - <p class="LITERALLAYOUT"><tt class="LITERAL"> #<span class= - "emphasis EMPHASIS c2">hide-console</span><br> - </tt></p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href= - "configuration.html" accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href= - "actions-file.html" accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Privoxy Configuration</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Actions Files</td> - </tr> - </table> - </div> -</body> -</html> + never_direct allow all</PRE +></TD +></TR +></TABLE +></P +><P +> You would then need to change your browser's proxy settings to <SPAN +CLASS="APPLICATION" +>squid</SPAN +>'s address and port. + Squid normally uses port 3128. If unsure consult <TT +CLASS="LITERAL" +>http_port</TT +> in <TT +CLASS="FILENAME" +>squid.conf</TT +>.</P +><P +> You could just as well decide to only forward requests you suspect + of leading to Windows executables through a virus-scanning parent proxy, + say, on <TT +CLASS="LITERAL" +>antivir.example.com</TT +>, port 8010:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> forward / . + forward /.*.(exe|com|dll|zip)$ antivir.example.com:8010</PRE +></TD +></TR +></TABLE +> </P +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="FORWARDED-CONNECT-RETRIES" +>7.5.4. forwarded-connect-retries</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> How often Privoxy retries if a forwarded connection request fails. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>Number of retries.</I +></TT +> + </P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>0</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Connections forwarded through other proxies are treated like direct connections and no retry attempts are made. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>forwarded-connect-retries</I +></TT +> is mainly interesting + for socks4a connections, where <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can't detect why the connections failed. + The connection might have failed because of a DNS timeout in which case a retry makes sense, + but it might also have failed because the server doesn't exist or isn't reachable. In this + case the retry will just delay the appearance of Privoxy's error message. + </P +><P +> Note that in the context of this option, <SPAN +CLASS="QUOTE" +>"forwarded connections"</SPAN +> includes all connections + that Privoxy forwards through other proxies. This option is not limited to the HTTP CONNECT method. + </P +><P +> Only use this option, if you are getting lots of forwarding-related error messages + 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. + </P +></DD +><DT +>Examples:</DT +><DD +><P +> forwarded-connect-retries 1 + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ACCEPT-INTERCEPTED-REQUESTS" +>7.5.5. accept-intercepted-requests</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Whether intercepted requests should be treated as valid. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>0 or 1</I +></TT +> + </P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>0</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Only proxy requests are accepted, intercepted requests are treated as invalid. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> If you don't trust your clients and want to force them + to use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, enable this + option and configure your packet filter to redirect outgoing + HTTP connections into <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + </P +><P +> Make sure that <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> own requests + aren't redirected as well. Additionally take care that + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can't intentionally connect + to itself, otherwise you could run into redirection loops if + <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> listening port is reachable + by the outside or an attacker has access to the pages you visit. + </P +></DD +><DT +>Examples:</DT +><DD +><P +> accept-intercepted-requests 1 + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="ALLOW-CGI-REQUEST-CRUNCHING" +>7.5.6. allow-cgi-request-crunching</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Whether requests to <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> CGI pages can be blocked or redirected. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>0 or 1</I +></TT +> + </P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>0</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> ignores block and redirect actions for its CGI pages. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> By default <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> ignores block or redirect actions + for its CGI pages. Intercepting these requests can be useful in multi-user + setups to implement fine-grained access control, but it can also render the complete + web interface useless and make debugging problems painful if done without care. + </P +><P +> Don't enable this option unless you're sure that you really need it. + </P +></DD +><DT +>Examples:</DT +><DD +><P +> allow-cgi-request-crunching 1 + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="SPLIT-LARGE-FORMS" +>7.5.7. split-large-forms</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Whether the CGI interface should stay compatible with broken HTTP clients. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>0 or 1</I +></TT +> + </P +></DD +><DT +>Default value:</DT +><DD +><P +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>0</I +></SPAN +></P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> The CGI form generate long GET URLs. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> CGI forms can lead to + rather long URLs. This isn't a problem as far as the HTTP + standard is concerned, but it can confuse clients with arbitrary + URL length limitations. + </P +><P +> Enabling split-large-forms causes <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + to divide big forms into smaller ones to keep the URL length down. + It makes editing a lot less convenient and you can no longer + submit all changes at once, but at least it works around this + browser bug. + </P +><P +> If you don't notice any editing problems, there is no reason + to enable this option, but if one of the submit buttons appears + to be broken, you should give it a try. + </P +></DD +><DT +>Examples:</DT +><DD +><P +> split-large-forms 1 + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="KEEP-ALIVE-TIMEOUT" +>7.5.8. keep-alive-timeout</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Number of seconds after which an open connection will no longer be reused. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>Time in seconds.</I +></TT +> + </P +></DD +><DT +>Default value:</DT +><DD +><P +>None</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> Connections are not reused. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> This option has no effect if <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + has been compiled without keep-alive support. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> Note that reusing connections doesn't necessary cause speedups. + There are also a few privacy implications you should be aware of. + </P +><P +> Outgoing connections are shared between clients (if there are more + than one) and closing the client that initiated the outgoing connection + does not affect the connection between <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and the server unless + the client's request hasn't been completed yet. If the outgoing connection + is idle, it will not be closed until either <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + or the server's timeout is reached. While it's open, the server knows + that the system running <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is still there. + </P +></DD +><DT +>Examples:</DT +><DD +><P +> keep-alive-timeout 300 + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="SECT3" +><H4 +CLASS="SECT3" +><A +NAME="SOCKET-TIMEOUT" +>7.5.9. socket-timeout</A +></H4 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Specifies:</DT +><DD +><P +> Number of seconds after which a socket times out if + no data is received. + </P +></DD +><DT +>Type of value:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>Time in seconds.</I +></TT +> + </P +></DD +><DT +>Default value:</DT +><DD +><P +>None</P +></DD +><DT +>Effect if unset:</DT +><DD +><P +> A default value of 300 seconds is used. + </P +></DD +><DT +>Notes:</DT +><DD +><P +> For SOCKS requests the timeout currently doesn't start until + the SOCKS server accepted the request. This will be fixed in + the next release. + </P +></DD +><DT +>Examples:</DT +><DD +><P +> socket-timeout 300 + </P +></DD +></DL +></DIV +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="WINDOWS-GUI" +>7.6. Windows GUI Options</A +></H2 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> has a number of options specific to the + Windows GUI interface:</P +><A +NAME="ACTIVITY-ANIMATION" +></A +><P +> If <SPAN +CLASS="QUOTE" +>"activity-animation"</SPAN +> is set to 1, the + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> icon will animate when + <SPAN +CLASS="QUOTE" +>"Privoxy"</SPAN +> is active. To turn off, set to 0.</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>activity-animation 1</I +></SPAN +><br> + </P +> + </TT +></P +><A +NAME="LOG-MESSAGES" +></A +><P +> If <SPAN +CLASS="QUOTE" +>"log-messages"</SPAN +> is set to 1, + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will log messages to the console + window:</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>log-messages 1</I +></SPAN +><br> + </P +> + </TT +></P +><A +NAME="LOG-BUFFER-SIZE" +></A +><P +> + If <SPAN +CLASS="QUOTE" +>"log-buffer-size"</SPAN +> is set to 1, the size of the log buffer, + i.e. the amount of memory used for the log messages displayed in the + console window, will be limited to <SPAN +CLASS="QUOTE" +>"log-max-lines"</SPAN +> (see below).</P +><P +> Warning: Setting this to 0 will result in the buffer to grow infinitely and + eat up all your memory!</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>log-buffer-size 1</I +></SPAN +><br> + </P +> + </TT +></P +><A +NAME="LOG-MAX-LINES" +></A +><P +> <SPAN +CLASS="APPLICATION" +>log-max-lines</SPAN +> is the maximum number of lines held + in the log buffer. See above.</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>log-max-lines 200</I +></SPAN +><br> + </P +> + </TT +></P +><A +NAME="LOG-HIGHLIGHT-MESSAGES" +></A +><P +> If <SPAN +CLASS="QUOTE" +>"log-highlight-messages"</SPAN +> is set to 1, + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will highlight portions of the log + messages with a bold-faced font:</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>log-highlight-messages 1</I +></SPAN +><br> + </P +> + </TT +></P +><A +NAME="LOG-FONT-NAME" +></A +><P +> The font used in the console window:</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>log-font-name Comic Sans MS</I +></SPAN +><br> + </P +> + </TT +></P +><A +NAME="LOG-FONT-SIZE" +></A +><P +> Font size used in the console window:</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>log-font-size 8</I +></SPAN +><br> + </P +> + </TT +></P +><A +NAME="SHOW-ON-TASK-BAR" +></A +><P +> + <SPAN +CLASS="QUOTE" +>"show-on-task-bar"</SPAN +> controls whether or not + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will appear as a button on the Task bar + when minimized:</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>show-on-task-bar 0</I +></SPAN +><br> + </P +> + </TT +></P +><A +NAME="CLOSE-BUTTON-MINIMIZES" +></A +><P +> If <SPAN +CLASS="QUOTE" +>"close-button-minimizes"</SPAN +> is set to 1, the Windows close + button will minimize <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> instead of closing + the program (close with the exit option on the File menu).</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>close-button-minimizes 1</I +></SPAN +><br> + </P +> + </TT +></P +><A +NAME="HIDE-CONSOLE" +></A +><P +> The <SPAN +CLASS="QUOTE" +>"hide-console"</SPAN +> option is specific to the MS-Win console + version of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. If this option is used, + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will disconnect from and hide the + command console.</P +><P +> <TT +CLASS="LITERAL" +> <P +CLASS="LITERALLAYOUT" +> #<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>hide-console</I +></SPAN +><br> + </P +> + </TT +></P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="configuration.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="actions-file.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Privoxy Configuration</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Actions Files</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/configuration.html b/external/privoxy/doc/webserver/user-manual/configuration.html index 923fb87..b4f021e 100644 --- a/external/privoxy/doc/webserver/user-manual/configuration.html +++ b/external/privoxy/doc/webserver/user-manual/configuration.html @@ -1,282 +1,514 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy Configuration</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Starting Privoxy" href="startup.html"> - <link rel="NEXT" title="The Main Configuration File" href="config.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - span.c3 {font-style: italic} - table.c2 {background-color: #E0E0E0} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="startup.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="config.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="CONFIGURATION" id="CONFIGURATION">6. Privoxy - Configuration</a></h1> - - <p>All <span class="APPLICATION">Privoxy</span> configuration is stored - in text files. These files can be edited with a text editor. Many - important aspects of <span class="APPLICATION">Privoxy</span> can also be - controlled easily with a web browser.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN1090" id="AEN1090">6.1. Controlling - Privoxy with Your Web Browser</a></h2> - - <p><span class="APPLICATION">Privoxy</span>'s user interface can be - reached through the special URL <a href="http://config.privoxy.org/" - target="_top">http://config.privoxy.org/</a> (shortcut: <a href= - "http://p.p/" target="_top">http://p.p/</a>), which is a built-in page - and works without Internet access. You will see the following - section:</p> - - <table class="c2" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - -</pre> - - <h2 class="BRIDGEHEAD"><a name="AEN1098" id= - "AEN1098"></a> Privoxy Menu</h2> - <pre> -</pre> - - <table border="0"> - <tbody> - <tr> - <td> - ▪ <a href="http://config.privoxy.org/show-status" - target="_top">View & change the current - configuration</a></td> - </tr> - - <tr> - <td> - ▪ <a href="http://config.privoxy.org/show-version" - target="_top">View the source code version numbers</a></td> - </tr> - - <tr> - <td> - ▪ <a href="http://config.privoxy.org/show-request" - target="_top">View the request headers.</a></td> - </tr> - - <tr> - <td> - ▪ <a href="http://config.privoxy.org/show-url-info" - target="_top">Look up which actions apply to a URL and - why</a></td> - </tr> - - <tr> - <td> - ▪ <a href="http://config.privoxy.org/toggle" - target="_top">Toggle Privoxy on or off</a></td> - </tr> - - <tr> - <td> - ▪ <a href="http://www.privoxy.org/3.0.19/user-manual/" - target="_top">Documentation</a></td> - </tr> - </tbody> - </table> - </td> - </tr> - </table> - - <p>This should be self-explanatory. Note the first item leads to an - editor for the <a href="actions-file.html">actions files</a>, which is - where the ad, banner, cookie, and URL blocking magic is configured as - well as other advanced features of <span class= - "APPLICATION">Privoxy</span>. This is an easy way to adjust various - aspects of <span class="APPLICATION">Privoxy</span> configuration. The - actions file, and other configuration files, are explained in detail - below.</p> - - <p><span class="QUOTE">"Toggle Privoxy On or Off"</span> is handy for - sites that might have problems with your current actions and filters. - You can in fact use it as a test to see whether it is <span class= - "APPLICATION">Privoxy</span> causing the problem or not. <span class= - "APPLICATION">Privoxy</span> continues to run as a proxy in this case, - but all manipulation is disabled, i.e. <span class= - "APPLICATION">Privoxy</span> acts like a normal forwarding proxy. There - is even a toggle <a href="appendix.html#BOOKMARKLETS">Bookmarklet</a> - offered, so that you can toggle <span class= - "APPLICATION">Privoxy</span> with one click from your browser.</p> - - <p>Note that several of the features described above are disabled by - default in <span class="APPLICATION">Privoxy</span> 3.0.7 beta and - later. Check the <a href="config.html" target="_top">configuration - file</a> to learn why and in which cases it's safe to enable them - again.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CONFOVERVIEW" id="CONFOVERVIEW">6.2. - Configuration Files Overview</a></h2> - - <p>For Unix, *BSD and Linux, all configuration files are located in - <tt class="FILENAME">/etc/privoxy/</tt> by default. For MS Windows, - OS/2, and AmigaOS these are all in the same directory as the - <span class="APPLICATION">Privoxy</span> executable.</p> - - <p>The installed defaults provide a reasonable starting point, though - some settings may be aggressive by some standards. For the time being, - the principle configuration files are:</p> - - <ul> - <li> - <p>The <a href="config.html">main configuration file</a> is named - <tt class="FILENAME">config</tt> on Linux, Unix, BSD, OS/2, and - AmigaOS and <tt class="FILENAME">config.txt</tt> on Windows. This - is a required file.</p> - </li> - - <li> - <p><tt class="FILENAME">match-all.action</tt> is used to define - which <span class="QUOTE">"actions"</span> relating to - banner-blocking, images, pop-ups, content modification, cookie - handling etc should be applied by default. It should be the first - actions file loaded.</p> - - <p><tt class="FILENAME">default.action</tt> defines many exceptions - (both positive and negative) from the default set of actions that's - configured in <tt class="FILENAME">match-all.action</tt>. It should - be the second actions file loaded and shouldn't be edited by the - user.</p> - - <p>Multiple actions files may be defined in <tt class= - "FILENAME">config</tt>. These are processed in the order they are - defined. Local customizations and locally preferred exceptions to - the default policies as defined in <tt class= - "FILENAME">match-all.action</tt> (which you will most probably want - to define sooner or later) are best applied in <tt class= - "FILENAME">user.action</tt>, where you can preserve them across - upgrades. The file isn't installed by all installers, but you can - easily create it yourself with a text editor.</p> - - <p>There is also a web based editor that can be accessed from - <a href="http://config.privoxy.org/show-status" target= - "_top">http://config.privoxy.org/show-status</a> (Shortcut: - <a href="http://p.p/show-status" target= - "_top">http://p.p/show-status</a>) for the various actions - files.</p> - </li> - - <li> - <p><span class="QUOTE">"Filter files"</span> (the <a href= - "filter-file.html">filter file</a>) can be used to re-write the raw - page content, including viewable text as well as embedded HTML and - JavaScript, and whatever else lurks on any given web page. The - filtering jobs are only pre-defined here; whether to apply them or - not is up to the actions files. <tt class= - "FILENAME">default.filter</tt> includes various filters made - available for use by the developers. Some are much more intrusive - than others, and all should be used with caution. You may define - additional filter files in <tt class="FILENAME">config</tt> as you - can with actions files. We suggest <tt class= - "FILENAME">user.filter</tt> for any locally defined filters or - customizations.</p> - </li> - </ul> - - <p>The syntax of the configuration and filter files may change between - different Privoxy versions, unfortunately some enhancements cost - backwards compatibility.</p> - - <p>All files use the <span class="QUOTE">"<tt class= - "LITERAL">#</tt>"</span> character to denote a comment (the rest of the - line will be ignored) and understand line continuation through placing - a backslash ("<tt class="LITERAL"></tt>") as the very last character - in a line. If the <tt class="LITERAL">#</tt> is preceded by a - backslash, it looses its special function. Placing a <tt class= - "LITERAL">#</tt> in front of an otherwise valid configuration line to - prevent it from being interpreted is called "commenting out" that line. - Blank lines are ignored.</p> - - <p>The actions files and filter files can use Perl style <a href= - "appendix.html#REGEX">regular expressions</a> for maximum - flexibility.</p> - - <p>After making any changes, there is no need to restart <span class= - "APPLICATION">Privoxy</span> in order for the changes to take effect. - <span class="APPLICATION">Privoxy</span> detects such changes - automatically. Note, however, that it may take one or two additional - requests for the change to take effect. When changing the listening - address of <span class="APPLICATION">Privoxy</span>, these <span class= - "QUOTE">"wake up"</span> requests must obviously be sent to the - <span class="emphasis EMPHASIS c3">old</span> listening address.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="startup.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="config.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Starting Privoxy</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">The Main Configuration - File</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Privoxy Configuration</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Starting Privoxy" +HREF="startup.html"><LINK +REL="NEXT" +TITLE="The Main Configuration File" +HREF="config.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="startup.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="config.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="CONFIGURATION" +>6. Privoxy Configuration</A +></H1 +><P +> All <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> configuration is stored + in text files. These files can be edited with a text editor. + Many important aspects of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can + also be controlled easily with a web browser. + </P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN776" +>6.1. Controlling Privoxy with Your Web Browser</A +></H2 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s user interface can be reached through the special + URL <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>http://config.privoxy.org/</A +> + (shortcut: <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +>), + which is a built-in page and works without Internet access. + You will see the following section: </P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> <H2 +CLASS="BRIDGEHEAD" +><A +NAME="AEN784" +></A +> Privoxy Menu</H2 +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> ▪ <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>View & change the current configuration</A +> + </TD +></TR +><TR +><TD +> ▪ <A +HREF="http://config.privoxy.org/show-version" +TARGET="_top" +>View the source code version numbers</A +> + </TD +></TR +><TR +><TD +> ▪ <A +HREF="http://config.privoxy.org/show-request" +TARGET="_top" +>View the request headers.</A +> + </TD +></TR +><TR +><TD +> ▪ <A +HREF="http://config.privoxy.org/show-url-info" +TARGET="_top" +>Look up which actions apply to a URL and why</A +> + </TD +></TR +><TR +><TD +> ▪ <A +HREF="http://config.privoxy.org/toggle" +TARGET="_top" +>Toggle Privoxy on or off</A +> + </TD +></TR +><TR +><TD +> ▪ <A +HREF="http://www.privoxy.org/3.0.12/user-manual/" +TARGET="_top" +>Documentation</A +> + </TD +></TR +></TBODY +></TABLE +><P +></P +></PRE +></TD +></TR +></TABLE +><P +> This should be self-explanatory. Note the first item leads to an editor for the + <A +HREF="actions-file.html" +>actions files</A +>, which is where the ad, banner, + cookie, and URL blocking magic is configured as well as other advanced features of + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. This is an easy way to adjust various + aspects of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> configuration. The actions + file, and other configuration files, are explained in detail below. </P +><P +> <SPAN +CLASS="QUOTE" +>"Toggle Privoxy On or Off"</SPAN +> is handy for sites that might + have problems with your current actions and filters. You can in fact use + it as a test to see whether it is <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + causing the problem or not. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> continues + to run as a proxy in this case, but all manipulation is disabled, i.e. + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> acts like a normal forwarding proxy. There + is even a toggle <A +HREF="appendix.html#BOOKMARKLETS" +>Bookmarklet</A +> offered, so + that you can toggle <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with one click from + your browser.</P +><P +> Note that several of the features described above are disabled by default + in <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> 3.0.7 beta and later. + Check the + <A +HREF="config.html" +TARGET="_top" +>configuration file</A +> to learn why + and in which cases it's safe to enable them again.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONFOVERVIEW" +>6.2. Configuration Files Overview</A +></H2 +><P +> For Unix, *BSD and Linux, all configuration files are located in + <TT +CLASS="FILENAME" +>/etc/privoxy/</TT +> by default. For MS Windows, OS/2, and + AmigaOS these are all in the same directory as the + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> executable. </P +><P +> The installed defaults provide a reasonable starting point, though + some settings may be aggressive by some standards. For the time being, the + principle configuration files are:</P +><P +> <P +></P +><UL +><LI +><P +> The <A +HREF="config.html" +>main configuration file</A +> is named <TT +CLASS="FILENAME" +>config</TT +> + on Linux, Unix, BSD, OS/2, and AmigaOS and <TT +CLASS="FILENAME" +>config.txt</TT +> + on Windows. This is a required file. + </P +></LI +><LI +><P +> <TT +CLASS="FILENAME" +>match-all.action</TT +> is used to define which <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> + relating to banner-blocking, images, pop-ups, content modification, cookie handling + etc should be applied by default. It should be the first actions file loaded. + </P +><P +> <TT +CLASS="FILENAME" +>default.action</TT +> defines many exceptions (both positive and negative) + from the default set of actions that's configured in <TT +CLASS="FILENAME" +>match-all.action</TT +>. + It should be the second actions file loaded and shouldn't be edited by the user. + </P +><P +> Multiple actions files may be defined in <TT +CLASS="FILENAME" +>config</TT +>. These + are processed in the order they are defined. Local customizations and locally + preferred exceptions to the default policies as defined in + <TT +CLASS="FILENAME" +>match-all.action</TT +> (which you will most probably want + to define sooner or later) are best applied in <TT +CLASS="FILENAME" +>user.action</TT +>, + where you can preserve them across upgrades. The file isn't installed by all + installers, but you can easily create it yourself with a text editor. + </P +><P +> + There is also a web based editor that can be accessed from + <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +> + (Shortcut: <A +HREF="http://p.p/show-status" +TARGET="_top" +>http://p.p/show-status</A +>) for the + various actions files. + </P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"Filter files"</SPAN +> (the <A +HREF="filter-file.html" +>filter + file</A +>) can be used to re-write the raw page content, including + viewable text as well as embedded HTML and JavaScript, and whatever else + lurks on any given web page. The filtering jobs are only pre-defined here; + whether to apply them or not is up to the actions files. + <TT +CLASS="FILENAME" +>default.filter</TT +> includes various filters made + available for use by the developers. Some are much more intrusive than + others, and all should be used with caution. You may define additional + filter files in <TT +CLASS="FILENAME" +>config</TT +> as you can with + actions files. We suggest <TT +CLASS="FILENAME" +>user.filter</TT +> for any + locally defined filters or customizations. + </P +></LI +></UL +></P +><P +> The syntax of the configuration and filter files may change between different + Privoxy versions, unfortunately some enhancements cost backwards compatibility. + </P +><P +> All files use the <SPAN +CLASS="QUOTE" +>"<TT +CLASS="LITERAL" +>#</TT +>"</SPAN +> character to denote a + comment (the rest of the line will be ignored) and understand line continuation + through placing a backslash ("<TT +CLASS="LITERAL" +></TT +>") as the very last character + in a line. If the <TT +CLASS="LITERAL" +>#</TT +> is preceded by a backslash, it looses + its special function. Placing a <TT +CLASS="LITERAL" +>#</TT +> in front of an otherwise + valid configuration line to prevent it from being interpreted is called "commenting + out" that line. Blank lines are ignored.</P +><P +> The actions files and filter files + can use Perl style <A +HREF="appendix.html#REGEX" +>regular expressions</A +> for + maximum flexibility. </P +><P +> After making any changes, there is no need to restart + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> in order for the changes to take + effect. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> detects such changes + automatically. Note, however, that it may take one or two additional + requests for the change to take effect. When changing the listening address + of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, these <SPAN +CLASS="QUOTE" +>"wake up"</SPAN +> requests + must obviously be sent to the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>old</I +></SPAN +> listening address.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="startup.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="config.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Starting Privoxy</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>The Main Configuration File</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/contact.html b/external/privoxy/doc/webserver/user-manual/contact.html index 9b3bc0c..3fd43eb 100644 --- a/external/privoxy/doc/webserver/user-manual/contact.html +++ b/external/privoxy/doc/webserver/user-manual/contact.html @@ -1,364 +1,514 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Contacting the Developers, Bug Reporting and Feature - Requests</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Privoxy's Template Files" href= - "templates.html"> - <link rel="NEXT" title="Privoxy Copyright, License and History" href= - "copyright.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="templates.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "copyright.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="CONTACT" id="CONTACT">11. Contacting the - Developers, Bug Reporting and Feature Requests</a></h1> - - <p>We value your feedback. In fact, we rely on it to improve <span class= - "APPLICATION">Privoxy</span> and its configuration. However, please note - the following hints, so we can provide you with the best support:</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">11.1. - Get Support</a></h2> - - <p>For casual users, our <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=211118" - target="_top">support forum at SourceForge</a> is probably best suited: - <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=211118" - target="_top">http://sourceforge.net/tracker/?group_id=11118&atid=211118</a></p> - - <p>All users are of course welcome to discuss their issues on the - <a href="http://lists.sourceforge.net/lists/listinfo/ijbswa-users" - target="_top">users mailing list</a>, where the developers also hang - around.</p> - - <p>Please don't sent private support requests to individual Privoxy - developers, either use the mailing lists or the support trackers.</p> - - <p>If you have to contact a Privoxy developer directly for other - reasons, please send a real mail and do not bother with SourceForge's - messaging system. Answers to SourceForge messages are usually bounced - by SourceForge's mail server in which case the developer wasted time - writing a response you don't get. From your point of view it will look - like your message has been completely ignored, so this is frustrating - for all parties involved.</p> - - <p>Note that the Privoxy mailing lists are moderated. Posts from - unsubscribed addresses have to be accepted manually by a moderator. - This may cause a delay of several days and if you use a subject that - doesn't clearly mention Privoxy or one of its features, your message - may be accidentally discarded as spam.</p> - - <p>If you aren't subscribed, you should therefore spend a few seconds - to come up with a proper subject. Additionally you should make it clear - that you want to get CC'd. Otherwise some responses will be directed to - the mailing list only, and you won't see them.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="REPORTING" id="REPORTING">11.2. Reporting - Problems</a></h2> - - <p><span class="QUOTE">"Problems"</span> for our purposes, come in two - forms:</p> - - <ul> - <li> - <p>Configuration issues, such as ads that slip through, or sites - that don't function properly due to one <span class= - "APPLICATION">Privoxy</span> <span class="QUOTE">"action"</span> or - another being turned <span class="QUOTE">"on"</span>.</p> - </li> - - <li> - <p><span class="QUOTE">"Bugs"</span> in the programming code that - makes up <span class="APPLICATION">Privoxy</span>, such as that - might cause a crash.</p> - </li> - </ul> - - <div class="SECT3"> - <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">11.2.1. - Reporting Ads or Other Configuration Problems</a></h3> - - <p>Please send feedback on ads that slipped through, innocent images - that were blocked, sites that don't work properly, and other - configuration related problem of <tt class= - "FILENAME">default.action</tt> file, to <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=460288" - target= - "_top">http://sourceforge.net/tracker/?group_id=11118&atid=460288</a>, - the Actions File Tracker.</p> - - <p>New, improved <tt class="FILENAME">default.action</tt> files may - occasionally be made available based on your feedback. These will be - announced on the <a href= - "http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" target= - "_top">ijbswa-announce</a> list and available from our the <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118" target= - "_top">files section</a> of our <a href= - "http://sf.net/projects/ijbswa/" target="_top">project page</a>.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">11.2.2. - Reporting Bugs</a></h3> - - <p>Please report all bugs through our bug tracker: <a href= - "http://sourceforge.net/tracker/?group_id=11118&atid=111118" - target= - "_top">http://sourceforge.net/tracker/?group_id=11118&atid=111118</a>.</p> - - <p>Before doing so, please make sure that the bug has <span class= - "emphasis EMPHASIS c2">not already been submitted</span> and observe - the additional hints at the top of the <a href= - "http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118" - target="_top">submit form</a>. If already submitted, please feel free - to add any info to the original report that might help to solve the - issue.</p> - - <p>Please try to verify that it is a <span class= - "APPLICATION">Privoxy</span> bug, and not a browser or site bug or - documented behaviour that just happens to be different than what you - expected. If unsure, try <a href= - "http://config.privoxy.org/toggle?set=disable" target="_top">toggling - off</a> <span class="APPLICATION">Privoxy</span>, and see if the - problem persists.</p> - - <p>If you are using your own custom configuration, please try the - stock configs to see if the problem is configuration related. If - you're having problems with a feature that is disabled by default, - please ask around on the mailing list if others can reproduce the - problem.</p> - - <p>If you aren't using the latest Privoxy version, the bug may have - been found and fixed in the meantime. We would appreciate if you - could take the time to <a href= - "http://www.privoxy.org/user-manual/installation.html" target= - "_top">upgrade to the latest version</a> (or even the latest CVS - snapshot) and verify that your bug still exists.</p> - - <p>Please be sure to provide the following information:</p> - - <ul> - <li> - <p>The exact <span class="APPLICATION">Privoxy</span> version you - are using (if you got the source from CVS, please also provide - the source code revisions as shown in <a href= - "http://config.privoxy.org/show-version" target= - "_top">http://config.privoxy.org/show-version</a>).</p> - </li> - - <li> - <p>The operating system and versions you run <span class= - "APPLICATION">Privoxy</span> on, (e.g. <span class= - "APPLICATION">Windows XP SP2</span>), if you are using a Unix - flavor, sending the output of <span class="QUOTE">"uname - -a"</span> should do, in case of GNU/Linux, please also name the - distribution.</p> - </li> - - <li> - <p>The name, platform, and version of the <span class= - "APPLICATION">browser</span> you were using (e.g. <span class= - "APPLICATION">Internet Explorer v5.5</span> for Mac).</p> - </li> - - <li> - <p>The URL where the problem occurred, or some way for us to - duplicate the problem (e.g. <tt class= - "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p> - </li> - - <li> - <p>Whether your version of <span class= - "APPLICATION">Privoxy</span> is one supplied by the <span class= - "APPLICATION">Privoxy</span> developers via SourceForge, or if - you got your copy somewhere else.</p> - </li> - - <li> - <p>Whether you are using <span class="APPLICATION">Privoxy</span> - in tandem with another proxy such as <span class= - "APPLICATION">Tor</span>. If so, please temporary disable the - other proxy to see if the symptoms change.</p> - </li> - - <li> - <p>Whether you are using a personal firewall product. If so, does - <span class="APPLICATION">Privoxy</span> work without it?</p> - </li> - - <li> - <p>Any other pertinent information to help identify the problem - such as config or log file excerpts (yes, you should have log - file entries for each action taken). To get a meaningful logfile, - please make sure that the <a href= - "../user-manual/config.html#LOGFILE" target="_top">logfile - directive</a> is being used and the following <a href= - "../user-manual/config.html#DEBUG" target="_top">debug - options</a> are enabled:</p> - - <p class="LITERALLAYOUT"> - debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br> - - debug 2 # show each connection status<br> - - debug 4 # show I/O status<br> - - debug 8 # show header parsing<br> - - debug 128 # debug redirects<br> - debug 256 # debug GIF de-animation<br> - - debug 512 # Common Log Format<br> - - debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br> - - debug 4096 # Startup banner and warnings.<br> - - debug 8192 # Non-fatal errors</p>If you - are having trouble with a filter, please additionally enable - - <p class="LITERALLAYOUT"> - debug 64 # debug regular expression filters</p>If - you are using Privoxy 3.0.17 or later and suspect that it - interprets the request or the response incorrectly, please enable - - <p class="LITERALLAYOUT"> - debug 32768 # log all data read from the network</p>Note - that Privoxy log files may contain sensitive information so - please don't submit any logfiles you didn't read first. You can - mask sensitive information as long as it's clear that you removed - something. - </li> - </ul> - - <p>You don't have to tell us your actual name when filing a problem - report, but if you don't, please use a nickname so we can - differentiate between your messages and the ones entered by other - "anonymous" users that may respond to your request if they have the - same problem or already found a solution. Note that due to spam the - trackers may not always allow to post without being logged into - SourceForge. If that's the case, you are still free to create a login - that isn't directly linked to your name, though.</p> - - <p>Please also check the status of your request a few days after - submitting it, as we may request additional information. If you use a - SF id, you should automatically get a mail when someone responds to - your request. Please don't bother to add an email address when using - the tracker. If you prefer to communicate through email, just use one - of the mailing lists directly.</p> - - <p>If you are new to reporting problems, you might be interested in - <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" - target="_top">How to Report Bugs Effectively</a>.</p> - - <p>The <a href= - "http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" - target="_top">appendix of the Privoxy User Manual</a> also has - helpful information on understanding <tt class= - "LITERAL">actions</tt>, and <tt class="LITERAL">action</tt> - debugging.</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CONTACT-FEATURE" id="CONTACT-FEATURE">11.3. - Request New Features</a></h2> - - <p>You are welcome to submit ideas on new features or other proposals - for improvement through our feature request tracker at <a href= - "http://sourceforge.net/tracker/?atid=361118&group_id=11118" - target="_top">http://sourceforge.net/tracker/?atid=361118&group_id=11118</a>.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">11.4. - Mailing Lists</a></h2> - - <p>If you prefer to communicate through email, instead of using a web - interface, feel free to use one of the mailing lists. To discuss issues - that haven't been completely diagnosed yet, please use the Privoxy - users list. Technically interested users and people who wish to - contribute to the project are always welcome on the developers list. - You can find an overview of all <span class= - "APPLICATION">Privoxy</span>-related mailing lists, including list - archives, at: <a href="http://sourceforge.net/mail/?group_id=11118" - target="_top">http://sourceforge.net/mail/?group_id=11118</a>.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="templates.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="copyright.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Privoxy's Template - Files</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Privoxy Copyright, License - and History</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Contacting the Developers, Bug Reporting and Feature +Requests</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Privoxy's Template Files" +HREF="templates.html"><LINK +REL="NEXT" +TITLE="Privoxy Copyright, License and History" +HREF="copyright.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="templates.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="copyright.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="CONTACT" +>11. Contacting the Developers, Bug Reporting and Feature +Requests</A +></H1 +><P +> We value your feedback. In fact, we rely on it to improve + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and its configuration. + However, please note the following hints, so we can + provide you with the best support:</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-SUPPORT" +>11.1. Get Support</A +></H2 +><P +> For casual users, our + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118" +TARGET="_top" +>support forum at SourceForge</A +> + is probably best suited: + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118" +TARGET="_top" +>http://sourceforge.net/tracker/?group_id=11118&atid=211118</A +></P +><P +> All users are of course welcome to discuss their issues on the <A +HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-users" +TARGET="_top" +>users + mailing list</A +>, where the developers also hang around.</P +><P +> Please don't sent private support requests to individual Privoxy + developers, either use the mailing lists or the support trackers.</P +><P +> Note that the Privoxy mailing lists are moderated. Posts from unsubscribed + addresses have to be accepted manually by a moderator. This may cause a + delay of several days and if you use a subject that doesn't clearly + mention Privoxy or one of its features, your message may be accidentally + discarded as spam.</P +><P +> If you aren't subscribed, you should therefore spend a few seconds + to come up with a proper subject. Additionally you should make it clear + that you want to get CC'd. Otherwise some responses will be directed to + the mailing list only, and you won't see them.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="REPORTING" +>11.2. Reporting Problems</A +></H2 +><P +><SPAN +CLASS="QUOTE" +>"Problems"</SPAN +> for our purposes, come in two forms:</P +><P +></P +><UL +><LI +><P +> Configuration issues, such as ads that slip through, or sites that + don't function properly due to one <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + <SPAN +CLASS="QUOTE" +>"action"</SPAN +> or another being turned <SPAN +CLASS="QUOTE" +>"on"</SPAN +>. + </P +></LI +><LI +><P +> <SPAN +CLASS="QUOTE" +>"Bugs"</SPAN +> in the programming code that makes up + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, such as that might cause a crash. + </P +></LI +></UL +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="CONTACT-ADS" +>11.2.1. Reporting Ads or Other Configuration Problems</A +></H3 +><P +> Please send feedback on ads that slipped through, innocent images that were + blocked, sites that don't work properly, and other configuration related problem of + <TT +CLASS="FILENAME" +>default.action</TT +> file, to + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288" +TARGET="_top" +> http://sourceforge.net/tracker/?group_id=11118&atid=460288</A +>, + the Actions File Tracker.</P +><P +> New, improved <TT +CLASS="FILENAME" +>default.action</TT +> files may occasionally be made + available based on your feedback. These will be announced on the <A +HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce" +TARGET="_top" +>ijbswa-announce</A +> + list and available from our the <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>files section</A +> of + our <A +HREF="http://sf.net/projects/ijbswa/" +TARGET="_top" +>project page</A +>.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="CONTACT-BUGS" +>11.2.2. Reporting Bugs</A +></H3 +><P +> Please report all bugs through our bug tracker: + <A +HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118" +TARGET="_top" +>http://sourceforge.net/tracker/?group_id=11118&atid=111118</A +>. </P +><P +> Before doing so, please make sure that the bug has <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not already been submitted</I +></SPAN +> + and observe the additional hints at the top of the <A +HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118" +TARGET="_top" +>submit + form</A +>. If already submitted, please feel free to add any info to the + original report that might help to solve the issue.</P +><P +> Please try to verify that it is a <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> bug, + and not a browser or site bug or documented behaviour that just happens + to be different than what you expected. If unsure, + try <A +HREF="http://config.privoxy.org/toggle?set=disable" +TARGET="_top" +>toggling + off</A +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, and see if the problem persists.</P +><P +> If you are using your own custom configuration, please try + the stock configs to see if the problem is configuration related. + If you're having problems with a feature that is disabled by default, + please ask around on the mailing list if others can reproduce the problem.</P +><P +> If you aren't using the latest Privoxy version, the bug may have been found + and fixed in the meantime. We would appreciate if you could take the time + to <A +HREF="http://www.privoxy.org/user-manual/installation.html" +TARGET="_top" +>upgrade + to the latest version</A +> (or even the latest CVS snapshot) and verify + that your bug still exists.</P +><P +>Please be sure to provide the following information:</P +><P +> <P +></P +><UL +><LI +><P +> The exact <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version you are using + (if you got the source from CVS, please also provide the source code revisions + as shown in <A +HREF="http://config.privoxy.org/show-version" +TARGET="_top" +>http://config.privoxy.org/show-version</A +>). + </P +></LI +><LI +><P +> The operating system and versions you run + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on, (e.g. <SPAN +CLASS="APPLICATION" +>Windows + XP SP2</SPAN +>), if you are using a Unix flavor, + sending the output of <SPAN +CLASS="QUOTE" +>"uname -a"</SPAN +> should do, + in case of GNU/Linux, please also name the distribution. + </P +></LI +><LI +><P +> The name, platform, and version of the <SPAN +CLASS="APPLICATION" +>browser</SPAN +> + you were using (e.g. <SPAN +CLASS="APPLICATION" +>Internet Explorer v5.5</SPAN +> for Mac). + </P +></LI +><LI +><P +> The URL where the problem occurred, or some way for us to duplicate the + problem (e.g. <TT +CLASS="LITERAL" +>http://somesite.example.com/?somethingelse=123</TT +>). + </P +></LI +><LI +><P +> Whether your version of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is one supplied + by the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developers via SourceForge, + or if you got your copy somewhere else. + </P +></LI +><LI +><P +> Whether you are using <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> in tandem with + another proxy such as <SPAN +CLASS="APPLICATION" +>Tor</SPAN +>. If so, please + temporary disable the other proxy to see if the symptoms change. + </P +></LI +><LI +><P +> Whether you are using a personal firewall product. If so, does + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> work without it? + </P +></LI +><LI +><P +> Any other pertinent information to help identify the problem such as config + or log file excerpts (yes, you should have log file entries for each + action taken). + </P +></LI +></UL +></P +><P +> You don't have to tell us your actual name when filing a problem + report, but please use a nickname so we can differentiate between + your messages and the ones entered by other "anonymous" users that + may respond to your request if they have the same problem or already + found a solution.</P +><P +> Please also check the status of your request a few days after submitting + it, as we may request additional information. If you use a SF id, + you should automatically get a mail when someone responds to your request.</P +><P +> The <A +HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" +TARGET="_top" +>appendix + of the Privoxy User Manual</A +> also has helpful information + on understanding <TT +CLASS="LITERAL" +>actions</TT +>, and <TT +CLASS="LITERAL" +>action</TT +> debugging. </P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-FEATURE" +>11.3. Request New Features</A +></H2 +><P +> You are welcome to submit ideas on new features or other proposals + for improvement through our feature request tracker at + <A +HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118" +TARGET="_top" +>http://sourceforge.net/tracker/?atid=361118&group_id=11118</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CONTACT-OTHER" +>11.4. Other</A +></H2 +><P +>For any other issues, feel free to use the mailing lists. Technically interested users +and people who wish to contribute to the project are also welcome on the developers list! +You can find an overview of all <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>-related mailing lists, +including list archives, at: +<A +HREF="http://sourceforge.net/mail/?group_id=11118" +TARGET="_top" +>http://sourceforge.net/mail/?group_id=11118</A +>.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="templates.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="copyright.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Privoxy's Template Files</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Privoxy Copyright, License and History</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/copyright.html b/external/privoxy/doc/webserver/user-manual/copyright.html index 59c7691..b2e1e96 100644 --- a/external/privoxy/doc/webserver/user-manual/copyright.html +++ b/external/privoxy/doc/webserver/user-manual/copyright.html @@ -1,285 +1,424 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy Copyright, License and History</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title= - "Contacting the Developers, Bug Reporting and Feature Requests" href= - "contact.html"> - <link rel="NEXT" title="See Also" href="seealso.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - a.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="contact.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="seealso.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="COPYRIGHT" id="COPYRIGHT">12. Privoxy - Copyright, License and History</a></h1> - - <p>Copyright © 2001-2011 by Privoxy Developers <code class= - "EMAIL"><<a href= - "mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</a>></code></p> - - <p>Some source code is based on code Copyright © 1997 by Anonymous - Coders and Junkbusters, Inc. and licensed under the <i class= - "CITETITLE">GNU General Public License</i>.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN5542" id="AEN5542">12.1. License</a></h2> - - <p><span class="APPLICATION">Privoxy</span> is free software; you can - redistribute it and/or modify it under the terms of the <i class= - "CITETITLE">GNU General Public License</i>, version 2, as published by - the Free Software Foundation.</p> - - <p>This program is distributed in the hope that it will be useful, but - WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the <a class= - "CITETITLE c2" href= - "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target= - "_top">GNU General Public License</a> for details.</p> - - <p>You should have received a copy of the <i class="CITETITLE">GNU - GPL</i> along with this program; if not, write to the</p> - - <p class="ADDRESS"> Free Software<br> - Foundation, Inc. <span class="STREET">51 Franklin - Street, Fifth Floor</span><br> - <span class="CITY">Boston</span>, <span class= - "STATE">MA</span> <span class="POSTCODE">02110-1301</span><br> - <span class="COUNTRY">USA</span> </p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="HISTORY" id="HISTORY">12.2. History</a></h2> - - <p>A long time ago, there was the <a href= - "http://www.junkbusters.com/ijb.html" target="_top"><span class= - "APPLICATION">Internet Junkbuster</span></a>, by Anonymous Coders and - <a href="http://www.junkbusters.com/" target="_top">Junkbusters - Corporation</a>. This saved many users a lot of pain in the early days - of web advertising and user tracking.</p> - - <p>But the web, its protocols and standards, and with it, the - techniques for forcing ads on users, give up autonomy over their - browsing, and for tracking them, keeps evolving. Unfortunately, the - <span class="APPLICATION">Internet Junkbuster</span> did not. Version - 2.0.2, published in 1998, was (and is) the last official <a href= - "http://www.junkbusters.com/ijbdist.html#release" target= - "_top">release</a> available from <a href="http://www.junkbusters.com" - target="_top">Junkbusters Corporation</a>. Fortunately, it had been - released under the GNU <a href= - "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target= - "_top">GPL</a>, which allowed further development by others.</p> - - <p>So Stefan Waldherr started maintaining an improved version of the - software, to which eventually a number of people contributed patches. - It could already replace banners with a transparent image, and had a - first version of pop-up killing, but it was still very closely based on - the original, with all its limitations, such as the lack of HTTP/1.1 - support, flexible per-site configuration, or content modification. The - last release from this effort was version 2.0.2-10, published in - 2000.</p> - - <p>Then, some <a href= - "http://www.privoxy.org/user-manual/copyright.html#AUTHORS" target= - "_top">developers</a> picked up the thread, and started turning the - software inside out, upside down, and then reassembled it, adding many - <a href="http://www.privoxy.org/user-manual/introduction.html#FEATURES" - target="_top">new features</a> along the way.</p> - - <p>The result of this is <span class="APPLICATION">Privoxy</span>, - whose first stable version, 3.0, was released August, 2002.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AUTHORS" id="AUTHORS">12.3. Authors</a></h2> - - <p>Current Privoxy Team:</p> - - <p class="LITERALLAYOUT"> - Fabian Keil, lead developer<br> - David Schmidt, developer<br> - Hal Burgiss<br> - Lee Rian<br> - Roland Rosenfeld</p> - - <p>Former Privoxy Team Members:</p> - - <p class="LITERALLAYOUT"> Johny Agotnes<br> - Rodrigo Barbosa<br> - Moritz Barsnick<br> - Ian Cummings<br> - Brian Dessent<br> - Jon Foster<br> - Karsten Hopp<br> - Alexander Lazic<br> - Daniel Leite<br> - Gábor Lipták<br> - Adam Lock<br> - Guy Laroche<br> - Justin McMurtry<br> - Mark Miller<br> - Gerry Murphy<br> - Andreas Oesterhelt<br> - Haroon Rafique<br> - Georg Sauthoff<br> - Thomas Steudten<br> - Jörg Strohmayer<br> - Rodney Stromlund<br> - Sviatoslav Sviridov<br> - Sarantis Paskalis<br> - Stefan Waldherr</p> - - <p>Thanks to the many people who have tested Privoxy, reported bugs, - provided patches, made suggestions or contributed in some way. These - include (in alphabetical order):</p> - - <p class="LITERALLAYOUT"> Ken Arromdee<br> - Devin Bayer<br> - Havard Berland<br> - Gergely Bor<br> - Francois Botha<br> - Reiner Buehl<br> - Andrew J. Caines<br> - Clifford Caoile<br> - Wan-Teh Chang<br> - Billy Crook<br> - Frédéric Crozat<br> - Michael T. Davis<br> - Mattes Dolak<br> - Matthias Drochner<br> - Peter E.<br> - Florian Effenberger<br> - Markus Elfring<br> - Dean Gaudet<br> - Stephen Gildea<br> - Daniel Griscom<br> - Felix Gröbert<br> - Jeff H.<br> - Aaron Hamid<br> - Darel Henman<br> - Magnus Holmgren<br> - Eric M. Hopper<br> - Ralf Horstmann<br> - Stefan Huehner<br> - Peter Hyman<br> - Derek Jennings<br> - Petr Kadlec<br> - David Laight<br> - Bert van Leeuwen<br> - Don Libes<br> - Paul Lieverse<br> - Han Liu<br> - Toby Lyward<br> - Wil Mahan<br> - Jindrich Makovicka<br> - Raphael Marichez<br> - Francois Marier<br> - David Mediavilla<br> - Raphael Moll<br> - Amuro Namie<br> - Adam Piggott<br> - Petr Písar<br> - Dan Price<br> - Roberto Ragusa<br> - Félix Rauch<br> - Maynard Riley<br> - Chung-chieh Shan<br> - Spinor S.<br> - Bart Schelstraete<br> - Dan Stahlke<br> - Oliver Stoeneberg<br> - Peter Thoenen<br> - Martin Thomas<br> - Bobby G. Vinyard<br> - Jochen Voss<br> - Glenn Washburn<br> - Song Weijia<br> - Jörg Weinmann<br> - Darren Wiebe<br> - Anduin Withers<br> - Oliver Yeoh<br> - Jamie Zawinski</p> - - <p>Privoxy is based in part on code originally developed by Junkbusters - Corp. and Anonymous Coders.</p> - - <p>Privoxy heavily relies on Philip Hazel's PCRE.</p> - - <p>The code to filter compressed content makes use of zlib which is - written by Jean-loup Gailly and Mark Adler.</p> - - <p>On systems that lack snprintf(), Privoxy is using a version written - by Mark Martinec. On systems that lack strptime(), Privoxy is using the - one from the GNU C Library written by Ulrich Drepper.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="contact.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="seealso.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Contacting the Developers, - Bug Reporting and Feature Requests</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">See Also</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Privoxy Copyright, License and History</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Contacting the Developers, Bug Reporting and Feature +Requests" +HREF="contact.html"><LINK +REL="NEXT" +TITLE="See Also" +HREF="seealso.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="contact.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="seealso.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="COPYRIGHT" +>12. Privoxy Copyright, License and History</A +></H1 +><P +> Copyright © 2001-2009 by Privoxy Developers <CODE +CLASS="EMAIL" +><<A +HREF="mailto:ijbswa-developers@lists.sourceforge.net" +>ijbswa-developers@lists.sourceforge.net</A +>></CODE +></P +><P +> Some source code is based on code Copyright © 1997 by Anonymous Coders + and Junkbusters, Inc. and licensed under the <I +CLASS="CITETITLE" +>GNU General Public + License</I +>.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN4921" +>12.1. License</A +></H2 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is free software; you can + redistribute it and/or modify it under the terms of the + <I +CLASS="CITETITLE" +>GNU General Public License</I +>, version 2, + as published by the Free Software Foundation.</P +><P +> This program is distributed in the hope that it will be useful, but WITHOUT + ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + FITNESS FOR A PARTICULAR PURPOSE. See the <A +HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" +TARGET="_top" +> <I +CLASS="CITETITLE" +>GNU General Public License</I +></A +> for details.</P +><P +> You should have received a copy of the <I +CLASS="CITETITLE" +>GNU GPL</I +> + along with this program; if not, write to the <P +CLASS="ADDRESS" +> Free Software<br> + Foundation, Inc. <SPAN +CLASS="STREET" +>51 Franklin Street, Fifth Floor</SPAN +><br> + <SPAN +CLASS="CITY" +>Boston</SPAN +>, <SPAN +CLASS="STATE" +>MA</SPAN +> <SPAN +CLASS="POSTCODE" +>02110-1301</SPAN +><br> + <SPAN +CLASS="COUNTRY" +>USA</SPAN +> </P +></P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="HISTORY" +>12.2. History</A +></H2 +><P +> A long time ago, there was the + <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +><SPAN +CLASS="APPLICATION" +>Internet Junkbuster</SPAN +></A +>, + by Anonymous Coders and <A +HREF="http://www.junkbusters.com/" +TARGET="_top" +>Junkbusters + Corporation</A +>. This saved many users a lot of pain in the early days of + web advertising and user tracking.</P +><P +> But the web, its protocols and standards, and with it, the techniques for + forcing ads on users, give up autonomy over their browsing, and + for tracking them, keeps evolving. Unfortunately, the <SPAN +CLASS="APPLICATION" +>Internet + Junkbuster</SPAN +> did not. Version 2.0.2, published in 1998, was + (and is) the last official + <A +HREF="http://www.junkbusters.com/ijbdist.html#release" +TARGET="_top" +>release</A +> + available from <A +HREF="http://www.junkbusters.com" +TARGET="_top" +>Junkbusters Corporation</A +>. + Fortunately, it had been released under the GNU + <A +HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" +TARGET="_top" +>GPL</A +>, + which allowed further development by others.</P +><P +> So Stefan Waldherr started maintaining an improved version of the + software, to which eventually a number of people contributed patches. + It could already replace banners with a transparent image, and had a first + version of pop-up killing, but it was still very closely based on the + original, with all its limitations, such as the lack of HTTP/1.1 support, + flexible per-site configuration, or content modification. The last release + from this effort was version 2.0.2-10, published in 2000.</P +><P +> Then, some + <A +HREF="http://www.privoxy.org/user-manual/copyright.html#AUTHORS" +TARGET="_top" +>developers</A +> + picked up the thread, and started turning the software inside out, upside down, + and then reassembled it, adding many + <A +HREF="http://www.privoxy.org/user-manual/introduction.html#FEATURES" +TARGET="_top" +>new + features</A +> along the way.</P +><P +> The result of this is <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, whose first + stable version, 3.0, was released August, 2002. + </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AUTHORS" +>12.3. Authors</A +></H2 +><P +>Current Privoxy Team:</P +><P +CLASS="LITERALLAYOUT" +> Fabian Keil, lead developer<br> + David Schmidt, developer<br> +<br> + Hal Burgiss<br> + Mark Miller<br> + Gerry Murphy<br> + Lee Rian<br> + Roland Rosenfeld<br> + Jörg Strohmayer</P +><P +> Former Privoxy Team Members:</P +><P +CLASS="LITERALLAYOUT" +> Johny Agotnes<br> + Rodrigo Barbosa<br> + Moritz Barsnick<br> + Ian Cummings<br> + Brian Dessent<br> + Jon Foster<br> + Karsten Hopp<br> + Alexander Lazic<br> + Daniel Leite<br> + Gábor Lipták<br> + Adam Lock<br> + Guy Laroche<br> + Justin McMurtry<br> + Andreas Oesterhelt<br> + Haroon Rafique<br> + Georg Sauthoff<br> + Thomas Steudten<br> + Rodney Stromlund<br> + Sviatoslav Sviridov<br> + Sarantis Paskalis<br> + Stefan Waldherr</P +><P +> Thanks to the many people who have tested Privoxy, reported bugs, provided + patches, made suggestions or contributed in some way. These include (in + alphabetical order):</P +><P +CLASS="LITERALLAYOUT" +> Ken Arromdee<br> + Devin Bayer<br> + Gergely Bor<br> + Reiner Buehl<br> + Andrew J. Caines<br> + Clifford Caoile<br> + Frédéric Crozat<br> + Michael T. Davis<br> + Mattes Dolak<br> + Matthias Drochner<br> + Peter E.<br> + Florian Effenberger<br> + Markus Elfring<br> + Dean Gaudet<br> + Stephen Gildea<br> + Daniel Griscom<br> + Felix Gröbert<br> + Aaron Hamid<br> + Darel Henman<br> + Magnus Holmgren<br> + Eric M. Hopper<br> + Ralf Horstmann<br> + Stefan Huehner<br> + Peter Hyman<br> + Derek Jennings<br> + Petr Kadlec<br> + David Laight<br> + Bert van Leeuwen<br> + Don Libes<br> + Paul Lieverse<br> + Toby Lyward<br> + Wil Mahan<br> + Jindrich Makovicka<br> + David Mediavilla<br> + Raphael Moll<br> + Amuro Namie<br> + Adam Piggott<br> + Dan Price<br> + Roberto Ragusa<br> + Félix Rauch<br> + Maynard Riley<br> + Chung-chieh Shan<br> + Spinor S.<br> + Bart Schelstraete<br> + Oliver Stoeneberg<br> + Peter Thoenen<br> + Martin Thomas<br> + Bobby G. Vinyard<br> + Jochen Voss<br> + Glenn Washburn<br> + Song Weijia<br> + Jörg Weinmann<br> + Darren Wiebe<br> + Anduin Withers<br> + Oliver Yeoh<br> + Jamie Zawinski</P +><P +> Privoxy is based in part on code originally developed by + Junkbusters Corp. and Anonymous Coders.</P +><P +> Privoxy heavily relies on Philip Hazel's PCRE.</P +><P +> The code to filter compressed content makes use of zlib + which is written by Jean-loup Gailly and Mark Adler.</P +><P +> On systems that lack snprintf(), Privoxy is using a version + written by Mark Martinec. On systems that lack strptime(), + Privoxy is using the one from the GNU C Library written + by Ulrich Drepper.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="contact.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="seealso.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Contacting the Developers, Bug Reporting and Feature +Requests</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>See Also</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/filter-file.html b/external/privoxy/doc/webserver/user-manual/filter-file.html index 2a3daff..3a2ec3a 100644 --- a/external/privoxy/doc/webserver/user-manual/filter-file.html +++ b/external/privoxy/doc/webserver/user-manual/filter-file.html @@ -1,407 +1,867 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Filter Files</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Actions Files" href="actions-file.html"> - <link rel="NEXT" title="Privoxy's Template Files" href="templates.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - table.c4 {background-color: #E0E0E0} - tt.c3 {font-style: italic} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "actions-file.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "templates.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="FILTER-FILE" id="FILTER-FILE">9. Filter - Files</a></h1> - - <p>On-the-fly text substitutions need to be defined in a <span class= - "QUOTE">"filter file"</span>. Once defined, they can then be invoked as - an <span class="QUOTE">"action"</span>.</p> - - <p><span class="APPLICATION">Privoxy</span> supports three different - filter actions: <tt class="LITERAL"><a href= - "actions-file.html#FILTER">filter</a></tt> to rewrite the content that is - send to the client, <tt class="LITERAL"><a href= - "actions-file.html#CLIENT-HEADER-FILTER">client-header-filter</a></tt> to - rewrite headers that are send by the client, and <tt class= - "LITERAL"><a href= - "actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a></tt> to - rewrite headers that are send by the server.</p> - - <p><span class="APPLICATION">Privoxy</span> also supports two tagger - actions: <tt class="LITERAL"><a href= - "actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a></tt> - and <tt class="LITERAL"><a href= - "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a></tt>. - Taggers and filters use the same syntax in the filter files, the - difference is that taggers don't modify the text they are filtering, but - use a rewritten version of the filtered text as tag. The tags can then be - used to change the applying actions through sections with <a href= - "actions-file.html#TAG-PATTERN">tag-patterns</a>.</p> - - <p>Multiple filter files can be defined through the <tt class= - "LITERAL"><a href="config.html#FILTERFILE">filterfile</a></tt> config - directive. The filters as supplied by the developers are located in - <tt class="FILENAME">default.filter</tt>. It is recommended that any - locally defined or modified filters go in a separately defined file such - as <tt class="FILENAME">user.filter</tt>.</p> - - <p>Common tasks for content filters are to eliminate common annoyances in - HTML and JavaScript, such as pop-up windows, exit consoles, crippled - windows without navigation tools, the infamous <BLINK> tag etc, to - suppress images with certain width and height attributes (standard banner - sizes or web-bugs), or just to have fun.</p> - - <p>Enabled content filters are applied to any content whose <span class= - "QUOTE">"Content Type"</span> header is recognised as a sign of - text-based content, with the exception of <tt class= - "LITERAL">text/plain</tt>. Use the <a href= - "actions-file.html#FORCE-TEXT-MODE">force-text-mode</a> action to also - filter other content.</p> - - <p>Substitutions are made at the source level, so if you want to - <span class="QUOTE">"roll your own"</span> filters, you should first be - familiar with HTML syntax, and, of course, regular expressions.</p> - - <p>Just like the <a href="actions-file.html">actions files</a>, the - filter file is organized in sections, which are called <span class= - "emphasis EMPHASIS c2">filters</span> here. Each filter consists of a - heading line, that starts with one of the <span class= - "emphasis EMPHASIS c2">keywords</span> <tt class="LITERAL">FILTER:</tt>, - <tt class="LITERAL">CLIENT-HEADER-FILTER:</tt> or <tt class= - "LITERAL">SERVER-HEADER-FILTER:</tt> followed by the filter's - <span class="emphasis EMPHASIS c2">name</span>, and a short (one line) - <span class="emphasis EMPHASIS c2">description</span> of what it does. - Below that line come the <span class="emphasis EMPHASIS c2">jobs</span>, - i.e. lines that define the actual text substitutions. By convention, the - name of a filter should describe what the filter <span class= - "emphasis EMPHASIS c2">eliminates</span>. The comment is used in the - <a href="http://config.privoxy.org/" target="_top">web-based user - interface</a>.</p> - - <p>Once a filter called <tt class="REPLACEABLE c3">name</tt> has been - defined in the filter file, it can be invoked by using an action of the - form +<tt class="LITERAL"><a href= - "actions-file.html#FILTER">filter</a>{<tt class= - "REPLACEABLE c3">name</tt>}</tt> in any <a href= - "actions-file.html">actions file</a>.</p> - - <p>Filter definitions start with a header line that contains the filter - type, the filter name and the filter description. A content filter header - line for a filter called <span class="QUOTE">"foo"</span> could look like - this:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -FILTER: foo Replace all "foo" with "bar" -</pre> - </td> - </tr> - </table> - - <p>Below that line, and up to the next header line, come the jobs that - define what text replacements the filter executes. They are specified in - a syntax that imitates <a href="http://www.perl.org/" target= - "_top">Perl</a>'s <tt class="LITERAL">s///</tt> operator. If you are - familiar with Perl, you will find this to be quite intuitive, and may - want to look at the PCRS documentation for the subtle differences to Perl - behaviour. Most notably, the non-standard option letter <tt class= - "LITERAL">U</tt> is supported, which turns the default to ungreedy - matching.</p> - - <p>If you are new to <a href= - "http://en.wikipedia.org/wiki/Regular_expressions" target= - "_top"><span class="QUOTE">"Regular Expressions"</span></a>, you might - want to take a look at the <a href="appendix.html#REGEX">Appendix on - regular expressions</a>, and see the <a href= - "http://perldoc.perl.org/perlre.html" target="_top">Perl manual</a> for - <a href="http://perldoc.perl.org/perlop.html" target="_top">the - <tt class="LITERAL">s///</tt> operator's syntax</a> and <a href= - "http://perldoc.perl.org/perlre.html" target="_top">Perl-style regular - expressions</a> in general. The below examples might also help to get you - started.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="AEN5060" id="AEN5060">9.1. Filter File - Tutorial</a></h2> - - <p>Now, let's complete our <span class="QUOTE">"foo"</span> content - filter. We have already defined the heading, but the jobs are still - missing. Since all it does is to replace <span class= - "QUOTE">"foo"</span> with <span class="QUOTE">"bar"</span>, there is - only one (trivial) job needed:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -s/foo/bar/ -</pre> - </td> - </tr> - </table> - - <p>But wait! Didn't the comment say that <span class= - "emphasis EMPHASIS c2">all</span> occurrences of <span class= - "QUOTE">"foo"</span> should be replaced? Our current job will only take - care of the first <span class="QUOTE">"foo"</span> on each page. For - global substitution, we'll need to add the <tt class="LITERAL">g</tt> - option:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -s/foo/bar/g -</pre> - </td> - </tr> - </table> - - <p>Our complete filter now looks like this:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -FILTER: foo Replace all "foo" with "bar" -s/foo/bar/g -</pre> - </td> - </tr> - </table> - - <p>Let's look at some real filters for more interesting examples. Here - you see a filter that protects against some common annoyances that - arise from JavaScript abuse. Let's look at its jobs one after the - other:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -FILTER: js-annoyances Get rid of particularly annoying JavaScript abuse +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Filter Files</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Actions Files" +HREF="actions-file.html"><LINK +REL="NEXT" +TITLE="Privoxy's Template Files" +HREF="templates.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="actions-file.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="templates.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="FILTER-FILE" +>9. Filter Files</A +></H1 +><P +> On-the-fly text substitutions need + to be defined in a <SPAN +CLASS="QUOTE" +>"filter file"</SPAN +>. Once defined, they + can then be invoked as an <SPAN +CLASS="QUOTE" +>"action"</SPAN +>.</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> supports three different filter actions: + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FILTER" +>filter</A +></TT +> to + rewrite the content that is send to the client, + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CLIENT-HEADER-FILTER" +>client-header-filter</A +></TT +> + to rewrite headers that are send by the client, and + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SERVER-HEADER-FILTER" +>server-header-filter</A +></TT +> + to rewrite headers that are send by the server.</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> also supports two tagger actions: + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CLIENT-HEADER-TAGGER" +>client-header-tagger</A +></TT +> + and + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SERVER-HEADER-TAGGER" +>server-header-tagger</A +></TT +>. + Taggers and filters use the same syntax in the filter files, the difference + is that taggers don't modify the text they are filtering, but use a rewritten + version of the filtered text as tag. The tags can then be used to change the + applying actions through sections with <A +HREF="actions-file.html#TAG-PATTERN" +>tag-patterns</A +>.</P +><P +> Multiple filter files can be defined through the <TT +CLASS="LITERAL" +> <A +HREF="config.html#FILTERFILE" +>filterfile</A +></TT +> config directive. The filters + as supplied by the developers are located in + <TT +CLASS="FILENAME" +>default.filter</TT +>. It is recommended that any locally + defined or modified filters go in a separately defined file such as + <TT +CLASS="FILENAME" +>user.filter</TT +>. + </P +><P +> Common tasks for content filters are to eliminate common annoyances in + HTML and JavaScript, such as pop-up windows, + exit consoles, crippled windows without navigation tools, the + infamous <BLINK> tag etc, to suppress images with certain + width and height attributes (standard banner sizes or web-bugs), + or just to have fun.</P +><P +> Enabled content filters are applied to any content whose + <SPAN +CLASS="QUOTE" +>"Content Type"</SPAN +> header is recognised as a sign + of text-based content, with the exception of <TT +CLASS="LITERAL" +>text/plain</TT +>. + Use the <A +HREF="actions-file.html#FORCE-TEXT-MODE" +>force-text-mode</A +> action + to also filter other content.</P +><P +> Substitutions are made at the source level, so if you want to <SPAN +CLASS="QUOTE" +>"roll + your own"</SPAN +> filters, you should first be familiar with HTML syntax, + and, of course, regular expressions.</P +><P +> Just like the <A +HREF="actions-file.html" +>actions files</A +>, the + filter file is organized in sections, which are called <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>filters</I +></SPAN +> + here. Each filter consists of a heading line, that starts with one of the + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>keywords</I +></SPAN +> <TT +CLASS="LITERAL" +>FILTER:</TT +>, + <TT +CLASS="LITERAL" +>CLIENT-HEADER-FILTER:</TT +> or <TT +CLASS="LITERAL" +>SERVER-HEADER-FILTER:</TT +> + followed by the filter's <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>name</I +></SPAN +>, and a short (one line) + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>description</I +></SPAN +> of what it does. Below that line + come the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>jobs</I +></SPAN +>, i.e. lines that define the actual + text substitutions. By convention, the name of a filter + should describe what the filter <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>eliminates</I +></SPAN +>. The + comment is used in the <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>web-based + user interface</A +>.</P +><P +> Once a filter called <TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +> has been defined + in the filter file, it can be invoked by using an action of the form + +<TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FILTER" +>filter</A +>{<TT +CLASS="REPLACEABLE" +><I +>name</I +></TT +>}</TT +> + in any <A +HREF="actions-file.html" +>actions file</A +>.</P +><P +> Filter definitions start with a header line that contains the filter + type, the filter name and the filter description. + A content filter header line for a filter called <SPAN +CLASS="QUOTE" +>"foo"</SPAN +> could look + like this:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>FILTER: foo Replace all "foo" with "bar"</PRE +></TD +></TR +></TABLE +></P +><P +> Below that line, and up to the next header line, come the jobs that + define what text replacements the filter executes. They are specified + in a syntax that imitates <A +HREF="http://www.perl.org/" +TARGET="_top" +>Perl</A +>'s + <TT +CLASS="LITERAL" +>s///</TT +> operator. If you are familiar with Perl, you + will find this to be quite intuitive, and may want to look at the + PCRS documentation for the subtle differences to Perl behaviour. Most + notably, the non-standard option letter <TT +CLASS="LITERAL" +>U</TT +> is supported, + which turns the default to ungreedy matching.</P +><P +> If you are new to + <A +HREF="http://en.wikipedia.org/wiki/Regular_expressions" +TARGET="_top" +><SPAN +CLASS="QUOTE" +>"Regular + Expressions"</SPAN +></A +>, you might want to take a look at + the <A +HREF="appendix.html#REGEX" +>Appendix on regular expressions</A +>, and + see the <A +HREF="http://perldoc.perl.org/perlre.html" +TARGET="_top" +>Perl + manual</A +> for + <A +HREF="http://perldoc.perl.org/perlop.html" +TARGET="_top" +>the + <TT +CLASS="LITERAL" +>s///</TT +> operator's syntax</A +> and <A +HREF="http://perldoc.perl.org/perlre.html" +TARGET="_top" +>Perl-style regular + expressions</A +> in general. + The below examples might also help to get you started.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN4447" +>9.1. Filter File Tutorial</A +></H2 +><P +> Now, let's complete our <SPAN +CLASS="QUOTE" +>"foo"</SPAN +> content filter. We have already defined + the heading, but the jobs are still missing. Since all it does is to replace + <SPAN +CLASS="QUOTE" +>"foo"</SPAN +> with <SPAN +CLASS="QUOTE" +>"bar"</SPAN +>, there is only one (trivial) job + needed:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>s/foo/bar/</PRE +></TD +></TR +></TABLE +></P +><P +> But wait! Didn't the comment say that <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> occurrences + of <SPAN +CLASS="QUOTE" +>"foo"</SPAN +> should be replaced? Our current job will only take + care of the first <SPAN +CLASS="QUOTE" +>"foo"</SPAN +> on each page. For global substitution, + we'll need to add the <TT +CLASS="LITERAL" +>g</TT +> option:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>s/foo/bar/g</PRE +></TD +></TR +></TABLE +></P +><P +> Our complete filter now looks like this:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>FILTER: foo Replace all "foo" with "bar" +s/foo/bar/g</PRE +></TD +></TR +></TABLE +></P +><P +> Let's look at some real filters for more interesting examples. Here you see + a filter that protects against some common annoyances that arise from JavaScript + abuse. Let's look at its jobs one after the other:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>FILTER: js-annoyances Get rid of particularly annoying JavaScript abuse
# Get rid of JavaScript referrer tracking. Test page: http://www.randomoddness.com/untitled.htm # -s|(<script.*)document.referrer(.*</script>)|$1"Not Your Business!"$2|Usg -</pre> - </td> - </tr> - </table> - - <p>Following the header line and a comment, you see the job. Note that - it uses <tt class="LITERAL">|</tt> as the delimiter instead of - <tt class="LITERAL">/</tt>, because the pattern contains a forward - slash, which would otherwise have to be escaped by a backslash - (<tt class="LITERAL"></tt>).</p> - - <p>Now, let's examine the pattern: it starts with the text <tt class= - "LITERAL"><script.*</tt> enclosed in parentheses. Since the dot - matches any character, and <tt class="LITERAL">*</tt> means: - <span class="QUOTE">"Match an arbitrary number of the element left of - myself"</span>, this matches <span class="QUOTE">"<script"</span>, - followed by <span class="emphasis EMPHASIS c2">any</span> text, i.e. it - matches the whole page, from the start of the first <script> - tag.</p> - - <p>That's more than we want, but the pattern continues: <tt class= - "LITERAL">document.referrer</tt> matches only the exact string - <span class="QUOTE">"document.referrer"</span>. The dot needed to be - <span class="emphasis EMPHASIS c2">escaped</span>, i.e. preceded by a - backslash, to take away its special meaning as a joker, and make it - just a regular dot. So far, the meaning is: Match from the start of the - first <script> tag in a the page, up to, and including, the text - <span class="QUOTE">"document.referrer"</span>, if <span class= - "emphasis EMPHASIS c2">both</span> are present in the page (and appear - in that order).</p> - - <p>But there's still more pattern to go. The next element, again - enclosed in parentheses, is <tt class="LITERAL">.*</script></tt>. - You already know what <tt class="LITERAL">.*</tt> means, so the whole - pattern translates to: Match from the start of the first <script> - tag in a page to the end of the last <script> tag, provided that - the text <span class="QUOTE">"document.referrer"</span> appears - somewhere in between.</p> - - <p>This is still not the whole story, since we have ignored the options - and the parentheses: The portions of the page matched by sub-patterns - that are enclosed in parentheses, will be remembered and be available - through the variables <tt class="LITERAL">$1, $2, ...</tt> in the - substitute. The <tt class="LITERAL">U</tt> option switches to ungreedy - matching, which means that the first <tt class="LITERAL">.*</tt> in the - pattern will only <span class="QUOTE">"eat up"</span> all text in - between <span class="QUOTE">"<script"</span> and the <span class= - "emphasis EMPHASIS c2">first</span> occurrence of <span class= - "QUOTE">"document.referrer"</span>, and that the second <tt class= - "LITERAL">.*</tt> will only span the text up to the <span class= - "emphasis EMPHASIS c2">first</span> <span class= - "QUOTE">"</script>"</span> tag. Furthermore, the <tt class= - "LITERAL">s</tt> option says that the match may span multiple lines in - the page, and the <tt class="LITERAL">g</tt> option again means that - the substitution is global.</p> - - <p>So, to summarize, the pattern means: Match all scripts that contain - the text <span class="QUOTE">"document.referrer"</span>. Remember the - parts of the script from (and including) the start tag up to (and - excluding) the string <span class="QUOTE">"document.referrer"</span> as - <tt class="LITERAL">$1</tt>, and the part following that string, up to - and including the closing tag, as <tt class="LITERAL">$2</tt>.</p> - - <p>Now the pattern is deciphered, but wasn't this about substituting - things? So lets look at the substitute: <tt class="LITERAL">$1"Not Your - Business!"$2</tt> is easy to read: The text remembered as <tt class= - "LITERAL">$1</tt>, followed by <tt class="LITERAL">"Not Your - Business!"</tt> (<span class="emphasis EMPHASIS c2">including</span> - the quotation marks!), followed by the text remembered as <tt class= - "LITERAL">$2</tt>. This produces an exact copy of the original string, - with the middle part (the <span class= - "QUOTE">"document.referrer"</span>) replaced by <tt class= - "LITERAL">"Not Your Business!"</tt>.</p> - - <p>The whole job now reads: Replace <span class= - "QUOTE">"document.referrer"</span> by <tt class="LITERAL">"Not Your - Business!"</tt> wherever it appears inside a <script> tag. Note - that this job won't break JavaScript syntax, since both the original - and the replacement are syntactically valid string objects. The script - just won't have access to the referrer information anymore.</p> - - <p>We'll show you two other jobs from the JavaScript taming department, - but this time only point out the constructs of special interest:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# The status bar is for displaying link targets, not pointless blahblah +s|(<script.*)document.referrer(.*</script>)|$1"Not Your Business!"$2|Usg</PRE +></TD +></TR +></TABLE +></P +><P +> Following the header line and a comment, you see the job. Note that it uses + <TT +CLASS="LITERAL" +>|</TT +> as the delimiter instead of <TT +CLASS="LITERAL" +>/</TT +>, because + the pattern contains a forward slash, which would otherwise have to be escaped + by a backslash (<TT +CLASS="LITERAL" +></TT +>).</P +><P +> Now, let's examine the pattern: it starts with the text <TT +CLASS="LITERAL" +><script.*</TT +> + enclosed in parentheses. Since the dot matches any character, and <TT +CLASS="LITERAL" +>*</TT +> + means: <SPAN +CLASS="QUOTE" +>"Match an arbitrary number of the element left of myself"</SPAN +>, this + matches <SPAN +CLASS="QUOTE" +>"<script"</SPAN +>, followed by <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>any</I +></SPAN +> text, i.e. + it matches the whole page, from the start of the first <script> tag.</P +><P +> That's more than we want, but the pattern continues: <TT +CLASS="LITERAL" +>document.referrer</TT +> + matches only the exact string <SPAN +CLASS="QUOTE" +>"document.referrer"</SPAN +>. The dot needed to + be <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>escaped</I +></SPAN +>, i.e. preceded by a backslash, to take away its + special meaning as a joker, and make it just a regular dot. So far, the meaning is: + Match from the start of the first <script> tag in a the page, up to, and including, + the text <SPAN +CLASS="QUOTE" +>"document.referrer"</SPAN +>, if <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>both</I +></SPAN +> are present + in the page (and appear in that order).</P +><P +> But there's still more pattern to go. The next element, again enclosed in parentheses, + is <TT +CLASS="LITERAL" +>.*</script></TT +>. You already know what <TT +CLASS="LITERAL" +>.*</TT +> + means, so the whole pattern translates to: Match from the start of the first <script> + tag in a page to the end of the last <script> tag, provided that the text + <SPAN +CLASS="QUOTE" +>"document.referrer"</SPAN +> appears somewhere in between.</P +><P +> This is still not the whole story, since we have ignored the options and the parentheses: + The portions of the page matched by sub-patterns that are enclosed in parentheses, will be + remembered and be available through the variables <TT +CLASS="LITERAL" +>$1, $2, ...</TT +> in + the substitute. The <TT +CLASS="LITERAL" +>U</TT +> option switches to ungreedy matching, which means + that the first <TT +CLASS="LITERAL" +>.*</TT +> in the pattern will only <SPAN +CLASS="QUOTE" +>"eat up"</SPAN +> all + text in between <SPAN +CLASS="QUOTE" +>"<script"</SPAN +> and the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>first</I +></SPAN +> occurrence + of <SPAN +CLASS="QUOTE" +>"document.referrer"</SPAN +>, and that the second <TT +CLASS="LITERAL" +>.*</TT +> will + only span the text up to the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>first</I +></SPAN +> <SPAN +CLASS="QUOTE" +>"</script>"</SPAN +> + tag. Furthermore, the <TT +CLASS="LITERAL" +>s</TT +> option says that the match may span + multiple lines in the page, and the <TT +CLASS="LITERAL" +>g</TT +> option again means that the + substitution is global.</P +><P +> So, to summarize, the pattern means: Match all scripts that contain the text + <SPAN +CLASS="QUOTE" +>"document.referrer"</SPAN +>. Remember the parts of the script from + (and including) the start tag up to (and excluding) the string + <SPAN +CLASS="QUOTE" +>"document.referrer"</SPAN +> as <TT +CLASS="LITERAL" +>$1</TT +>, and the part following + that string, up to and including the closing tag, as <TT +CLASS="LITERAL" +>$2</TT +>.</P +><P +> Now the pattern is deciphered, but wasn't this about substituting things? So + lets look at the substitute: <TT +CLASS="LITERAL" +>$1"Not Your Business!"$2</TT +> is + easy to read: The text remembered as <TT +CLASS="LITERAL" +>$1</TT +>, followed by + <TT +CLASS="LITERAL" +>"Not Your Business!"</TT +> (<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>including</I +></SPAN +> + the quotation marks!), followed by the text remembered as <TT +CLASS="LITERAL" +>$2</TT +>. + This produces an exact copy of the original string, with the middle part + (the <SPAN +CLASS="QUOTE" +>"document.referrer"</SPAN +>) replaced by <TT +CLASS="LITERAL" +>"Not Your + Business!"</TT +>.</P +><P +> The whole job now reads: Replace <SPAN +CLASS="QUOTE" +>"document.referrer"</SPAN +> by + <TT +CLASS="LITERAL" +>"Not Your Business!"</TT +> wherever it appears inside a + <script> tag. Note that this job won't break JavaScript syntax, + since both the original and the replacement are syntactically valid + string objects. The script just won't have access to the referrer + information anymore.</P +><P +> We'll show you two other jobs from the JavaScript taming department, but + this time only point out the constructs of special interest:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># The status bar is for displaying link targets, not pointless blahblah # -s/window.status\s*=\s*(['"]).*?\1/dUmMy=1/ig -</pre> - </td> - </tr> - </table> - - <p><tt class="LITERAL">\s</tt> stands for whitespace characters (space, - tab, newline, carriage return, form feed), so that <tt class= - "LITERAL">\s*</tt> means: <span class="QUOTE">"zero or more - whitespace"</span>. The <tt class="LITERAL">?</tt> in <tt class= - "LITERAL">.*?</tt> makes this matching of arbitrary text ungreedy. - (Note that the <tt class="LITERAL">U</tt> option is not set). The - <tt class="LITERAL">['"]</tt> construct means: <span class="QUOTE">"a - single <span class="emphasis EMPHASIS c2">or</span> a double - quote"</span>. Finally, <tt class="LITERAL">\1</tt> is a back-reference - to the first parenthesis just like <tt class="LITERAL">$1</tt> above, - with the difference that in the <span class= - "emphasis EMPHASIS c2">pattern</span>, a backslash indicates a - back-reference, whereas in the <span class= - "emphasis EMPHASIS c2">substitute</span>, it's the dollar.</p> - - <p>So what does this job do? It replaces assignments of single- or - double-quoted strings to the <span class="QUOTE">"window.status"</span> - object with a dummy assignment (using a variable name that is hopefully - odd enough not to conflict with real variables in scripts). Thus, it - catches many cases where e.g. pointless descriptions are displayed in - the status bar instead of the link target when you move your mouse over - links.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# Kill OnUnload popups. Yummy. Test: http://www.zdnet.com/zdsubs/yahoo/tree/yfs.html +s/window.status\s*=\s*(['"]).*?\1/dUmMy=1/ig</PRE +></TD +></TR +></TABLE +></P +><P +> <TT +CLASS="LITERAL" +>\s</TT +> stands for whitespace characters (space, tab, newline, + carriage return, form feed), so that <TT +CLASS="LITERAL" +>\s*</TT +> means: <SPAN +CLASS="QUOTE" +>"zero + or more whitespace"</SPAN +>. The <TT +CLASS="LITERAL" +>?</TT +> in <TT +CLASS="LITERAL" +>.*?</TT +> + makes this matching of arbitrary text ungreedy. (Note that the <TT +CLASS="LITERAL" +>U</TT +> + option is not set). The <TT +CLASS="LITERAL" +>['"]</TT +> construct means: <SPAN +CLASS="QUOTE" +>"a single + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>or</I +></SPAN +> a double quote"</SPAN +>. Finally, <TT +CLASS="LITERAL" +>\1</TT +> is + a back-reference to the first parenthesis just like <TT +CLASS="LITERAL" +>$1</TT +> above, + with the difference that in the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>pattern</I +></SPAN +>, a backslash indicates + a back-reference, whereas in the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>substitute</I +></SPAN +>, it's the dollar.</P +><P +> So what does this job do? It replaces assignments of single- or double-quoted + strings to the <SPAN +CLASS="QUOTE" +>"window.status"</SPAN +> object with a dummy assignment + (using a variable name that is hopefully odd enough not to conflict with + real variables in scripts). Thus, it catches many cases where e.g. pointless + descriptions are displayed in the status bar instead of the link target when + you move your mouse over links.</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Kill OnUnload popups. Yummy. Test: http://www.zdnet.com/zdsubs/yahoo/tree/yfs.html # -s/(<body [^>]*)onunload(.*>)/$1never$2/iU -</pre> - </td> - </tr> - </table> - - <p>Including the <a href= - "http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/events.html#Events..." - target="_top">OnUnload event binding</a> in the HTML DOM was a - <span class="emphasis EMPHASIS c2">CRIME</span>. When I close a browser - window, I want it to close and die. Basta. This job replaces the - <span class="QUOTE">"onunload"</span> attribute in <span class= - "QUOTE">"<body>"</span> tags with the dummy word <tt class= - "LITERAL">never</tt>. Note that the <tt class="LITERAL">i</tt> option - makes the pattern matching case-insensitive. Also note that ungreedy - matching alone doesn't always guarantee a minimal match: In the first - parenthesis, we had to use <tt class="LITERAL">[^>]*</tt> instead of - <tt class="LITERAL">.*</tt> to prevent the match from exceeding the - <body> tag if it doesn't contain <span class= - "QUOTE">"OnUnload"</span>, but the page's content does.</p> - - <p>The last example is from the fun department:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -FILTER: fun Fun text replacements +s/(<body [^>]*)onunload(.*>)/$1never$2/iU</PRE +></TD +></TR +></TABLE +></P +><P +> Including the + <A +HREF="http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/events.html#Events..." +TARGET="_top" +>OnUnload + event binding</A +> in the HTML DOM was a <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>CRIME</I +></SPAN +>. + When I close a browser window, I want it to close and die. Basta. + This job replaces the <SPAN +CLASS="QUOTE" +>"onunload"</SPAN +> attribute in + <SPAN +CLASS="QUOTE" +>"<body>"</SPAN +> tags with the dummy word <TT +CLASS="LITERAL" +>never</TT +>. + Note that the <TT +CLASS="LITERAL" +>i</TT +> option makes the pattern matching + case-insensitive. Also note that ungreedy matching alone doesn't always guarantee + a minimal match: In the first parenthesis, we had to use <TT +CLASS="LITERAL" +>[^>]*</TT +> + instead of <TT +CLASS="LITERAL" +>.*</TT +> to prevent the match from exceeding the + <body> tag if it doesn't contain <SPAN +CLASS="QUOTE" +>"OnUnload"</SPAN +>, but the page's + content does.</P +><P +> The last example is from the fun department:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +>FILTER: fun Fun text replacements
# Spice the daily news: # -s/microsoft(?!.com)/MicroSuck/ig -</pre> - </td> - </tr> - </table> - - <p>Note the <tt class="LITERAL">(?!.com)</tt> part (a so-called - negative lookahead) in the job's pattern, which means: Don't match, if - the string <span class="QUOTE">".com"</span> appears directly following - <span class="QUOTE">"microsoft"</span> in the page. This prevents links - to microsoft.com from being trashed, while still replacing the word - everywhere else.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -# Buzzword Bingo (example for extended regex syntax) +s/microsoft(?!.com)/MicroSuck/ig</PRE +></TD +></TR +></TABLE +></P +><P +> Note the <TT +CLASS="LITERAL" +>(?!.com)</TT +> part (a so-called negative lookahead) + in the job's pattern, which means: Don't match, if the string + <SPAN +CLASS="QUOTE" +>".com"</SPAN +> appears directly following <SPAN +CLASS="QUOTE" +>"microsoft"</SPAN +> + in the page. This prevents links to microsoft.com from being trashed, while + still replacing the word everywhere else.</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +># Buzzword Bingo (example for extended regex syntax) # s* industry[ -]leading \ | cutting[ -]edge \ @@ -413,432 +873,780 @@ s* industry[ -]leading \ | unmatched \ | unparalleled \ | unrivalled \ -*<font color="red"><b>BINGO!</b></font> \ -*igx -</pre> - </td> - </tr> - </table> - - <p>The <tt class="LITERAL">x</tt> option in this job turns on extended - syntax, and allows for e.g. the liberal use of (non-interpreted!) - whitespace for nicer formatting.</p> - - <p>You get the idea?</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="PREDEFINED-FILTERS" id= - "PREDEFINED-FILTERS">9.2. The Pre-defined Filters</a></h2> - - <p>The distribution <tt class="FILENAME">default.filter</tt> file - contains a selection of pre-defined filters for your convenience:</p> - - <div class="VARIABLELIST"> - <dl> - <dt><span class="emphasis EMPHASIS c2">js-annoyances</span></dt> - - <dd> - <p>The purpose of this filter is to get rid of particularly - annoying JavaScript abuse. To that end, it</p> - - <ul> - <li> - <p>replaces JavaScript references to the browser's referrer - information with the string "Not Your Business!". This - compliments the <tt class="LITERAL"><a href= - "actions-file.html#HIDE-REFERRER">hide-referrer</a></tt> - action on the content level.</p> - </li> - - <li> - <p>removes the bindings to the DOM's <a href= - "http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/events.html#Events..." - target="_top">unload event</a> which we feel has no right to - exist and is responsible for most <span class="QUOTE">"exit - consoles"</span>, i.e. nasty windows that pop up when you - close another one.</p> - </li> - - <li> - <p>removes code that causes new windows to be opened with - undesired properties, such as being full-screen, - non-resizeable, without location, status or menu bar etc.</p> - </li> - </ul> - - <p>Use with caution. This is an aggressive filter, and can break - sites that rely heavily on JavaScript.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">js-events</span></dt> - - <dd> - <p>This is a very radical measure. It removes virtually all - JavaScript event bindings, which means that scripts can not react - to user actions such as mouse movements or clicks, window - resizing etc, anymore. Use with caution!</p> - - <p>We <span class="emphasis EMPHASIS c2">strongly - discourage</span> using this filter as a default since it breaks - many legitimate scripts. It is meant for use only on extra-nasty - sites (should you really need to go there).</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">html-annoyances</span></dt> - - <dd> - <p>This filter will undo many common instances of HTML based - abuse.</p> - - <p>The <tt class="LITERAL">BLINK</tt> and <tt class= - "LITERAL">MARQUEE</tt> tags are neutralized (yeah baby!), and - browser windows will be created as resizeable (as of course they - should be!), and will have location, scroll and menu bars -- even - if specified otherwise.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">content-cookies</span></dt> - - <dd> - <p>Most cookies are set in the HTTP dialog, where they can be - intercepted by the <tt class="LITERAL"><a href= - "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></tt> - and <tt class="LITERAL"><a href= - "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></tt> - actions. But web sites increasingly make use of HTML meta tags - and JavaScript to sneak cookies to the browser on the content - level.</p> - - <p>This filter disables most HTML and JavaScript code that reads - or sets cookies. It cannot detect all clever uses of these types - of code, so it should not be relied on as an absolute fix. Use it - wherever you would also use the cookie crunch actions.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">refresh tags</span></dt> - - <dd> - <p>Disable any refresh tags if the interval is greater than nine - seconds (so that redirections done via refresh tags are not - destroyed). This is useful for dial-on-demand setups, or for - those who find this HTML feature annoying.</p> - </dd> - - <dt><span class= - "emphasis EMPHASIS c2">unsolicited-popups</span></dt> - - <dd> - <p>This filter attempts to prevent only <span class= - "QUOTE">"unsolicited"</span> pop-up windows from opening, yet - still allow pop-up windows that the user has explicitly chosen to - open. It was added in version 3.0.1, as an improvement over - earlier such filters.</p> - - <p>Technical note: The filter works by redefining the window.open - JavaScript function to a dummy function, <tt class= - "LITERAL">PrivoxyWindowOpen()</tt>, during the loading and - rendering phase of each HTML page access, and restoring the - function afterward.</p> - - <p>This is recommended only for browsers that cannot perform this - function reliably themselves. And be aware that some sites - require such windows in order to function normally. Use with - caution.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">all-popups</span></dt> - - <dd> - <p>Attempt to prevent <span class= - "emphasis EMPHASIS c2">all</span> pop-up windows from opening. - Note this should be used with even more discretion than the - above, since it is more likely to break some sites that require - pop-ups for normal usage. Use with caution.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">img-reorder</span></dt> - - <dd> - <p>This is a helper filter that has no value if used alone. It - makes the <tt class="LITERAL">banners-by-size</tt> and <tt class= - "LITERAL">banners-by-link</tt> (see below) filters more effective - and should be enabled together with them.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">banners-by-size</span></dt> - - <dd> - <p>This filter removes image tags purely based on what size they - are. Fortunately for us, many ads and banner images tend to - conform to certain standardized sizes, which makes this filter - quite effective for ad stripping purposes.</p> - - <p>Occasionally this filter will cause false positives on images - that are not ads, but just happen to be of one of the standard - banner sizes.</p> - - <p>Recommended only for those who require extreme ad blocking. - The default block rules should catch 95+% of all ads <span class= - "emphasis EMPHASIS c2">without</span> this filter enabled.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">banners-by-link</span></dt> - - <dd> - <p>This is an experimental filter that attempts to kill any - banners if their URLs seem to point to known or suspected click - trackers. It is currently not of much value and is not - recommended for use by default.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">webbugs</span></dt> - - <dd> - <p>Webbugs are small, invisible images (technically 1X1 GIF - images), that are used to track users across websites, and - collect information on them. As an HTML page is loaded by the - browser, an embedded image tag causes the browser to contact a - third-party site, disclosing the tracking information through the - requested URL and/or cookies for that third-party domain, without - the user ever becoming aware of the interaction with the - third-party site. HTML-ized spam also uses a similar technique to - verify email addresses.</p> - - <p>This filter removes the HTML code that loads such <span class= - "QUOTE">"webbugs"</span>.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">tiny-textforms</span></dt> - - <dd> - <p>A rather special-purpose filter that can be used to enlarge - textareas (those multi-line text boxes in web forms) and turn off - hard word wrap in them. It was written for the sourceforge.net - tracker system where such boxes are a nuisance, but it can be - handy on other sites, too.</p> - - <p>It is not recommended to use this filter as a default.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">jumping-windows</span></dt> - - <dd> - <p>Many consider windows that move, or resize themselves to be - abusive. This filter neutralizes the related JavaScript code. - Note that some sites might not display or behave as intended when - using this filter. Use with caution.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">frameset-borders</span></dt> - - <dd> - <p>Some web designers seem to assume that everyone in the world - will view their web sites using the same browser brand and - version, screen resolution etc, because only that assumption - could explain why they'd use static frame sizes, yet prevent - their frames from being resized by the user, should they be too - small to show their whole content.</p> - - <p>This filter removes the related HTML code. It should only be - applied to sites which need it.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">demoronizer</span></dt> - - <dd> - <p>Many Microsoft products that generate HTML use non-standard - extensions (read: violations) of the ISO 8859-1 aka Latin-1 - character set. This can cause those HTML documents to display - with errors on standard-compliant platforms.</p> - - <p>This filter translates the MS-only characters into Latin-1 - equivalents. It is not necessary when using MS products, and will - cause corruption of all documents that use 8-bit character sets - other than Latin-1. It's mostly worthwhile for Europeans on - non-MS platforms, if weird garbage characters sometimes appear on - some pages, or user agents that don't correct for this on the - fly.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">shockwave-flash</span></dt> - - <dd> - <p>A filter for shockwave haters. As the name suggests, this - filter strips code out of web pages that is used to embed - shockwave flash objects.</p> - </dd> - - <dt><span class= - "emphasis EMPHASIS c2">quicktime-kioskmode</span></dt> - - <dd> - <p>Change HTML code that embeds Quicktime objects so that - kioskmode, which prevents saving, is disabled.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">fun</span></dt> - - <dd> - <p>Text replacements for subversive browsing fun. Make fun of - your favorite Monopolist or play buzzword bingo.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">crude-parental</span></dt> - - <dd> - <p>A demonstration-only filter that shows how <span class= - "APPLICATION">Privoxy</span> can be used to delete web content on - a keyword basis.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">ie-exploits</span></dt> - - <dd> - <p>An experimental collection of text replacements to disable - malicious HTML and JavaScript code that exploits known security - holes in Internet Explorer.</p> - - <p>Presently, it only protects against Nimda and a cross-site - scripting bug, and would need active maintenance to provide more - substantial protection.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">site-specifics</span></dt> - - <dd> - <p>Some web sites have very specific problems, the cure for which - doesn't apply anywhere else, or could even cause damage on other - sites.</p> - - <p>This is a collection of such site-specific cures which should - only be applied to the sites they were intended for, which is - what the supplied <tt class="FILENAME">default.action</tt> file - does. Users shouldn't need to change anything regarding this - filter.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">google</span></dt> - - <dd> - <p>A CSS based block for Google text ads. Also removes a width - limitation and the toolbar advertisement.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">yahoo</span></dt> - - <dd> - <p>Another CSS based block, this time for Yahoo text ads. And - removes a width limitation as well.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">msn</span></dt> - - <dd> - <p>Another CSS based block, this time for MSN text ads. And - removes tracking URLs, as well as a width limitation.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">blogspot</span></dt> - - <dd> - <p>Cleans up some Blogspot blogs. Read the fine print before - using this one!</p> - - <p>This filter also intentionally removes some navigation stuff - and sets the page width to 100%. As a result, some rounded - <span class="QUOTE">"corners"</span> would appear to early or not - at all and as fixing this would require a browser that - understands background-size (CSS3), they are removed instead.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">xml-to-html</span></dt> - - <dd> - <p>Server-header filter to change the Content-Type from xml to - html.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">html-to-xml</span></dt> - - <dd> - <p>Server-header filter to change the Content-Type from html to - xml.</p> - </dd> - - <dt><span class="emphasis EMPHASIS c2">no-ping</span></dt> - - <dd> - <p>Removes the non-standard <tt class="LITERAL">ping</tt> - attribute from anchor and area HTML tags.</p> - </dd> - - <dt><span class= - "emphasis EMPHASIS c2">hide-tor-exit-notation</span></dt> - - <dd> - <p>Client-header filter to remove the <b class="COMMAND">Tor</b> - exit node notation found in Host and Referer headers.</p> - - <p>If <span class="APPLICATION">Privoxy</span> and <b class= - "COMMAND">Tor</b> are chained and <span class= - "APPLICATION">Privoxy</span> is configured to use socks4a, one - can use <span class= - "QUOTE">"http://www.example.org.foobar.exit/"</span> to access - the host <span class="QUOTE">"www.example.org"</span> through the - <b class="COMMAND">Tor</b> exit node <span class= - "QUOTE">"foobar"</span>.</p> - - <p>As the HTTP client isn't aware of this notation, it treats the - whole string <span class= - "QUOTE">"www.example.org.foobar.exit"</span> as host and uses it - for the <span class="QUOTE">"Host"</span> and <span class= - "QUOTE">"Referer"</span> headers. From the server's point of view - the resulting headers are invalid and can cause problems.</p> - - <p>An invalid <span class="QUOTE">"Referer"</span> header can - trigger <span class="QUOTE">"hot-linking"</span> protections, an - invalid <span class="QUOTE">"Host"</span> header will make it - impossible for the server to find the right vhost (several - domains hosted on the same IP address).</p> - - <p>This client-header filter removes the <span class= - "QUOTE">"foo.exit"</span> part in those headers to prevent the - mentioned problems. Note that it only modifies the HTTP headers, - it doesn't make it impossible for the server to detect your - <b class="COMMAND">Tor</b> exit node based on the IP address the - request is coming from.</p> - </dd> - </dl> - </div> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="actions-file.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="templates.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Actions Files</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Privoxy's Template - Files</td> - </tr> - </table> - </div> -</body> -</html> +*<font color="red"><b>BINGO!</b></font> \ +*igx</PRE +></TD +></TR +></TABLE +></P +><P +> The <TT +CLASS="LITERAL" +>x</TT +> option in this job turns on extended syntax, and allows for + e.g. the liberal use of (non-interpreted!) whitespace for nicer formatting. </P +><P +> You get the idea?</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="PREDEFINED-FILTERS" +>9.2. The Pre-defined Filters</A +></H2 +><P +>The distribution <TT +CLASS="FILENAME" +>default.filter</TT +> file contains a selection of +pre-defined filters for your convenience:</P +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>js-annoyances</I +></SPAN +></DT +><DD +><P +> The purpose of this filter is to get rid of particularly annoying JavaScript abuse. + To that end, it + <P +></P +><UL +><LI +><P +> replaces JavaScript references to the browser's referrer information + with the string "Not Your Business!". This compliments the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HIDE-REFERRER" +>hide-referrer</A +></TT +> action on the content level. + </P +></LI +><LI +><P +> removes the bindings to the DOM's + <A +HREF="http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/events.html#Events..." +TARGET="_top" +>unload + event</A +> which we feel has no right to exist and is responsible for most <SPAN +CLASS="QUOTE" +>"exit consoles"</SPAN +>, i.e. + nasty windows that pop up when you close another one. + </P +></LI +><LI +><P +> removes code that causes new windows to be opened with undesired properties, such as being + full-screen, non-resizeable, without location, status or menu bar etc. + </P +></LI +></UL +> + </P +><P +> Use with caution. This is an aggressive filter, and can break sites that + rely heavily on JavaScript. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>js-events</I +></SPAN +></DT +><DD +><P +> This is a very radical measure. It removes virtually all JavaScript event bindings, which + means that scripts can not react to user actions such as mouse movements or clicks, window + resizing etc, anymore. Use with caution! + </P +><P +> We <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>strongly discourage</I +></SPAN +> using this filter as a default since it breaks + many legitimate scripts. It is meant for use only on extra-nasty sites (should you really + need to go there). + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>html-annoyances</I +></SPAN +></DT +><DD +><P +> This filter will undo many common instances of HTML based abuse. + </P +><P +> The <TT +CLASS="LITERAL" +>BLINK</TT +> and <TT +CLASS="LITERAL" +>MARQUEE</TT +> tags + are neutralized (yeah baby!), and browser windows will be created as + resizeable (as of course they should be!), and will have location, + scroll and menu bars -- even if specified otherwise. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>content-cookies</I +></SPAN +></DT +><DD +><P +> Most cookies are set in the HTTP dialog, where they can be intercepted + by the + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +>crunch-incoming-cookies</A +></TT +> + and <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES" +>crunch-outgoing-cookies</A +></TT +> + actions. But web sites increasingly make use of HTML meta tags and JavaScript + to sneak cookies to the browser on the content level. + </P +><P +> This filter disables most HTML and JavaScript code that reads or sets + cookies. It cannot detect all clever uses of these types of code, so it + should not be relied on as an absolute fix. Use it wherever you would also + use the cookie crunch actions. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>refresh tags</I +></SPAN +></DT +><DD +><P +> Disable any refresh tags if the interval is greater than nine seconds (so + that redirections done via refresh tags are not destroyed). This is useful + for dial-on-demand setups, or for those who find this HTML feature + annoying. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>unsolicited-popups</I +></SPAN +></DT +><DD +><P +> This filter attempts to prevent only <SPAN +CLASS="QUOTE" +>"unsolicited"</SPAN +> pop-up + windows from opening, yet still allow pop-up windows that the user + has explicitly chosen to open. It was added in version 3.0.1, + as an improvement over earlier such filters. + </P +><P +> Technical note: The filter works by redefining the window.open JavaScript + function to a dummy function, <TT +CLASS="LITERAL" +>PrivoxyWindowOpen()</TT +>, + during the loading and rendering phase of each HTML page access, and + restoring the function afterward. + </P +><P +> This is recommended only for browsers that cannot perform this function + reliably themselves. And be aware that some sites require such windows + in order to function normally. Use with caution. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all-popups</I +></SPAN +></DT +><DD +><P +> Attempt to prevent <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> pop-up windows from opening. + Note this should be used with even more discretion than the above, since + it is more likely to break some sites that require pop-ups for normal + usage. Use with caution. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>img-reorder</I +></SPAN +></DT +><DD +><P +> This is a helper filter that has no value if used alone. It makes the + <TT +CLASS="LITERAL" +>banners-by-size</TT +> and <TT +CLASS="LITERAL" +>banners-by-link</TT +> + (see below) filters more effective and should be enabled together with them. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>banners-by-size</I +></SPAN +></DT +><DD +><P +> This filter removes image tags purely based on what size they are. Fortunately + for us, many ads and banner images tend to conform to certain standardized + sizes, which makes this filter quite effective for ad stripping purposes. + </P +><P +> Occasionally this filter will cause false positives on images that are not ads, + but just happen to be of one of the standard banner sizes. + </P +><P +> Recommended only for those who require extreme ad blocking. The default + block rules should catch 95+% of all ads <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>without</I +></SPAN +> this filter enabled. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>banners-by-link</I +></SPAN +></DT +><DD +><P +> This is an experimental filter that attempts to kill any banners if + their URLs seem to point to known or suspected click trackers. It is currently + not of much value and is not recommended for use by default. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>webbugs</I +></SPAN +></DT +><DD +><P +> Webbugs are small, invisible images (technically 1X1 GIF images), that + are used to track users across websites, and collect information on them. + As an HTML page is loaded by the browser, an embedded image tag causes the + browser to contact a third-party site, disclosing the tracking information + through the requested URL and/or cookies for that third-party domain, without + the user ever becoming aware of the interaction with the third-party site. + HTML-ized spam also uses a similar technique to verify email addresses. + </P +><P +> This filter removes the HTML code that loads such <SPAN +CLASS="QUOTE" +>"webbugs"</SPAN +>. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>tiny-textforms</I +></SPAN +></DT +><DD +><P +> A rather special-purpose filter that can be used to enlarge textareas (those + multi-line text boxes in web forms) and turn off hard word wrap in them. + It was written for the sourceforge.net tracker system where such boxes are + a nuisance, but it can be handy on other sites, too. + </P +><P +> It is not recommended to use this filter as a default. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>jumping-windows</I +></SPAN +></DT +><DD +><P +> Many consider windows that move, or resize themselves to be abusive. This filter + neutralizes the related JavaScript code. Note that some sites might not display + or behave as intended when using this filter. Use with caution. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>frameset-borders</I +></SPAN +></DT +><DD +><P +> Some web designers seem to assume that everyone in the world will view their + web sites using the same browser brand and version, screen resolution etc, + because only that assumption could explain why they'd use static frame sizes, + yet prevent their frames from being resized by the user, should they be too + small to show their whole content. + </P +><P +> This filter removes the related HTML code. It should only be applied to sites + which need it. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>demoronizer</I +></SPAN +></DT +><DD +><P +> Many Microsoft products that generate HTML use non-standard extensions (read: + violations) of the ISO 8859-1 aka Latin-1 character set. This can cause those + HTML documents to display with errors on standard-compliant platforms. + </P +><P +> This filter translates the MS-only characters into Latin-1 equivalents. + It is not necessary when using MS products, and will cause corruption of + all documents that use 8-bit character sets other than Latin-1. It's mostly + worthwhile for Europeans on non-MS platforms, if weird garbage characters + sometimes appear on some pages, or user agents that don't correct for this on + the fly. + + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>shockwave-flash</I +></SPAN +></DT +><DD +><P +> A filter for shockwave haters. As the name suggests, this filter strips code + out of web pages that is used to embed shockwave flash objects. + </P +><P +> </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>quicktime-kioskmode</I +></SPAN +></DT +><DD +><P +> Change HTML code that embeds Quicktime objects so that kioskmode, which + prevents saving, is disabled. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>fun</I +></SPAN +></DT +><DD +><P +> Text replacements for subversive browsing fun. Make fun of your favorite + Monopolist or play buzzword bingo. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>crude-parental</I +></SPAN +></DT +><DD +><P +> A demonstration-only filter that shows how <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + can be used to delete web content on a keyword basis. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>ie-exploits</I +></SPAN +></DT +><DD +><P +> An experimental collection of text replacements to disable malicious HTML and JavaScript + code that exploits known security holes in Internet Explorer. + </P +><P +> Presently, it only protects against Nimda and a cross-site scripting bug, and + would need active maintenance to provide more substantial protection. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>site-specifics</I +></SPAN +></DT +><DD +><P +> Some web sites have very specific problems, the cure for which doesn't apply + anywhere else, or could even cause damage on other sites. + </P +><P +> This is a collection of such site-specific cures which should only be applied + to the sites they were intended for, which is what the supplied + <TT +CLASS="FILENAME" +>default.action</TT +> file does. Users shouldn't need to change + anything regarding this filter. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>google</I +></SPAN +></DT +><DD +><P +> A CSS based block for Google text ads. Also removes a width limitation + and the toolbar advertisement. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>yahoo</I +></SPAN +></DT +><DD +><P +> Another CSS based block, this time for Yahoo text ads. And removes + a width limitation as well. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>msn</I +></SPAN +></DT +><DD +><P +> Another CSS based block, this time for MSN text ads. And removes + tracking URLs, as well as a width limitation. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>blogspot</I +></SPAN +></DT +><DD +><P +> Cleans up some Blogspot blogs. Read the fine print before using this one! + </P +><P +> This filter also intentionally removes some navigation stuff and sets the + page width to 100%. As a result, some rounded <SPAN +CLASS="QUOTE" +>"corners"</SPAN +> would + appear to early or not at all and as fixing this would require a browser + that understands background-size (CSS3), they are removed instead. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>xml-to-html</I +></SPAN +></DT +><DD +><P +> Server-header filter to change the Content-Type from xml to html. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>html-to-xml</I +></SPAN +></DT +><DD +><P +> Server-header filter to change the Content-Type from html to xml. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>no-ping</I +></SPAN +></DT +><DD +><P +> Removes the non-standard <TT +CLASS="LITERAL" +>ping</TT +> attribute from + anchor and area HTML tags. + </P +></DD +><DT +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>hide-tor-exit-notation</I +></SPAN +></DT +><DD +><P +> Client-header filter to remove the <B +CLASS="COMMAND" +>Tor</B +> exit node notation + found in Host and Referer headers. + </P +><P +> If <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> and <B +CLASS="COMMAND" +>Tor</B +> are chained and <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + is configured to use socks4a, one can use <SPAN +CLASS="QUOTE" +>"http://www.example.org.foobar.exit/"</SPAN +> + to access the host <SPAN +CLASS="QUOTE" +>"www.example.org"</SPAN +> through the + <B +CLASS="COMMAND" +>Tor</B +> exit node <SPAN +CLASS="QUOTE" +>"foobar"</SPAN +>. + </P +><P +> As the HTTP client isn't aware of this notation, it treats the + whole string <SPAN +CLASS="QUOTE" +>"www.example.org.foobar.exit"</SPAN +> as host and uses it + for the <SPAN +CLASS="QUOTE" +>"Host"</SPAN +> and <SPAN +CLASS="QUOTE" +>"Referer"</SPAN +> headers. From the + server's point of view the resulting headers are invalid and can cause problems. + </P +><P +> An invalid <SPAN +CLASS="QUOTE" +>"Referer"</SPAN +> header can trigger <SPAN +CLASS="QUOTE" +>"hot-linking"</SPAN +> + protections, an invalid <SPAN +CLASS="QUOTE" +>"Host"</SPAN +> header will make it impossible for + the server to find the right vhost (several domains hosted on the same IP address). + </P +><P +> This client-header filter removes the <SPAN +CLASS="QUOTE" +>"foo.exit"</SPAN +> part in those headers + to prevent the mentioned problems. Note that it only modifies + the HTTP headers, it doesn't make it impossible for the server + to detect your <B +CLASS="COMMAND" +>Tor</B +> exit node based on the IP address + the request is coming from. + </P +></DD +></DL +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="actions-file.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="templates.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Actions Files</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Privoxy's Template Files</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/index.html b/external/privoxy/doc/webserver/user-manual/index.html index 1fea85e..366386b 100644 --- a/external/privoxy/doc/webserver/user-manual/index.html +++ b/external/privoxy/doc/webserver/user-manual/index.html @@ -1,621 +1,963 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy 3.0.19 User Manual</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="NEXT" title="Introduction" href="introduction.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - hr.c2 {text-align: left} - dt.c1 {font-weight: bold} - </style> -</head> - -<body class="ARTICLE"> - <div class="ARTICLE"> - <div class="TITLEPAGE"> - <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.19 User - Manual</a></h1> - - <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> © - 2001-2011 by <a href="http://www.privoxy.org/" target="_top">Privoxy - Developers</a></sub><br></p> - - <p class="PUBDATE">$Id: user-manual.sgml,v 2.143 2011/11/20 17:16:36 - fabiankeil Exp $<br></p> - - <div class="ABSTRACT"> - <a name="AEN9" id="AEN9"></a> - - <p>The <i class="CITETITLE">Privoxy User Manual</i> gives users - information on how to install, configure and use <a href= - "http://www.privoxy.org/" target="_top">Privoxy</a>.</p> - - <p>Privoxy is a non-caching web proxy with advanced filtering - capabilities for enhancing privacy, modifying web page data and HTTP - headers, controlling access, and removing ads and other obnoxious - Internet junk. Privoxy has a flexible configuration and can be - customized to suit individual needs and tastes. It has application - for both stand-alone systems and multi-user networks.</p> - - <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p> - - <p>Privoxy is an associated project of Software in the Public - Interest (SPI).</p> - - <p>Helping hands and donations are welcome:</p> - - <ul> - <li> - <p><a href="http://www.privoxy.org/faq/general.html#PARTICIPATE" - target= - "_top">http://www.privoxy.org/faq/general.html#PARTICIPATE</a></p> - </li> - - <li> - <p><a href="http://www.privoxy.org/faq/general.html#DONATE" - target= - "_top">http://www.privoxy.org/faq/general.html#DONATE</a></p> - </li> - </ul> - - <p>You can find the latest version of the <i class= - "CITETITLE">Privoxy User Manual</i> at <a href= - "http://www.privoxy.org/user-manual/" target= - "_top">http://www.privoxy.org/user-manual/</a>. Please see the - <a href="contact.html">Contact section</a> on how to contact the - developers.</p> - </div> - <hr> - </div> - - <div class="TOC"> - <dl> - <dt class="c1">Table of Contents</dt> - - <dt>1. <a href="introduction.html">Introduction</a></dt> - - <dd> - <dl> - <dt>1.1. <a href="introduction.html#FEATURES">Features</a></dt> - </dl> - </dd> - - <dt>2. <a href="installation.html">Installation</a></dt> - - <dd> - <dl> - <dt>2.1. <a href="installation.html#INSTALLATION-PACKAGES">Binary - Packages</a></dt> - - <dd> - <dl> - <dt>2.1.1. <a href= - "installation.html#INSTALLATION-PACK-RPM">Red Hat and Fedora - RPMs</a></dt> - - <dt>2.1.2. <a href= - "installation.html#INSTALLATION-DEB">Debian and - Ubuntu</a></dt> - - <dt>2.1.3. <a href= - "installation.html#INSTALLATION-PACK-WIN">Windows</a></dt> - - <dt>2.1.4. <a href= - "installation.html#INSTALLATION-PACK-BINTGZ">Solaris</a></dt> - - <dt>2.1.5. <a href= - "installation.html#INSTALLATION-OS2">OS/2</a></dt> - - <dt>2.1.6. <a href="installation.html#INSTALLATION-MAC">Mac - OS X</a></dt> - - <dt>2.1.7. <a href= - "installation.html#INSTALLATION-AMIGA">AmigaOS</a></dt> - - <dt>2.1.8. <a href= - "installation.html#INSTALLATION-TBZ">FreeBSD</a></dt> - - <dt>2.1.9. <a href= - "installation.html#INSTALLATTION-GENTOO">Gentoo</a></dt> - </dl> - </dd> - - <dt>2.2. <a href="installation.html#INSTALLATION-SOURCE">Building - from Source</a></dt> - - <dt>2.3. <a href= - "installation.html#INSTALLATION-KEEPUPDATED">Keeping your - Installation Up-to-Date</a></dt> - </dl> - </dd> - - <dt>3. <a href="whatsnew.html">What's New in this Release</a></dt> - - <dd> - <dl> - <dt>3.1. <a href="whatsnew.html#UPGRADERSNOTE">Note to - Upgraders</a></dt> - </dl> - </dd> - - <dt>4. <a href="quickstart.html">Quickstart to Using Privoxy</a></dt> - - <dd> - <dl> - <dt>4.1. <a href= - "quickstart.html#QUICKSTART-AD-BLOCKING">Quickstart to Ad - Blocking</a></dt> - </dl> - </dd> - - <dt>5. <a href="startup.html">Starting Privoxy</a></dt> - - <dd> - <dl> - <dt>5.1. <a href="startup.html#START-REDHAT">Red Hat and - Fedora</a></dt> - - <dt>5.2. <a href="startup.html#START-DEBIAN">Debian</a></dt> - - <dt>5.3. <a href="startup.html#START-WINDOWS">Windows</a></dt> - - <dt>5.4. <a href="startup.html#START-UNICES">Solaris, NetBSD, - FreeBSD, HP-UX and others</a></dt> - - <dt>5.5. <a href="startup.html#START-OS2">OS/2</a></dt> - - <dt>5.6. <a href="startup.html#START-MACOSX">Mac OS X</a></dt> - - <dt>5.7. <a href="startup.html#START-AMIGAOS">AmigaOS</a></dt> - - <dt>5.8. <a href="startup.html#START-GENTOO">Gentoo</a></dt> - - <dt>5.9. <a href="startup.html#CMDOPTIONS">Command Line - Options</a></dt> - </dl> - </dd> - - <dt>6. <a href="configuration.html">Privoxy Configuration</a></dt> - - <dd> - <dl> - <dt>6.1. <a href="configuration.html#AEN1090">Controlling Privoxy - with Your Web Browser</a></dt> - - <dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration - Files Overview</a></dt> - </dl> - </dd> - - <dt>7. <a href="config.html">The Main Configuration File</a></dt> - - <dd> - <dl> - <dt>7.1. <a href="config.html#LOCAL-SET-UP">Local Set-up - Documentation</a></dt> - - <dd> - <dl> - <dt>7.1.1. <a href= - "config.html#USER-MANUAL">user-manual</a></dt> - - <dt>7.1.2. <a href= - "config.html#TRUST-INFO-URL">trust-info-url</a></dt> - - <dt>7.1.3. <a href= - "config.html#ADMIN-ADDRESS">admin-address</a></dt> - - <dt>7.1.4. <a href= - "config.html#PROXY-INFO-URL">proxy-info-url</a></dt> - </dl> - </dd> - - <dt>7.2. <a href="config.html#CONF-LOG-LOC">Configuration and Log - File Locations</a></dt> - - <dd> - <dl> - <dt>7.2.1. <a href="config.html#CONFDIR">confdir</a></dt> - - <dt>7.2.2. <a href="config.html#TEMPLDIR">templdir</a></dt> - - <dt>7.2.3. <a href="config.html#LOGDIR">logdir</a></dt> - - <dt>7.2.4. <a href= - "config.html#ACTIONSFILE">actionsfile</a></dt> - - <dt>7.2.5. <a href= - "config.html#FILTERFILE">filterfile</a></dt> - - <dt>7.2.6. <a href="config.html#LOGFILE">logfile</a></dt> - - <dt>7.2.7. <a href="config.html#TRUSTFILE">trustfile</a></dt> - </dl> - </dd> - - <dt>7.3. <a href="config.html#DEBUGGING">Debugging</a></dt> - - <dd> - <dl> - <dt>7.3.1. <a href="config.html#DEBUG">debug</a></dt> - - <dt>7.3.2. <a href= - "config.html#SINGLE-THREADED">single-threaded</a></dt> - - <dt>7.3.3. <a href="config.html#HOSTNAME">hostname</a></dt> - </dl> - </dd> - - <dt>7.4. <a href="config.html#ACCESS-CONTROL">Access Control and - Security</a></dt> - - <dd> - <dl> - <dt>7.4.1. <a href= - "config.html#LISTEN-ADDRESS">listen-address</a></dt> - - <dt>7.4.2. <a href="config.html#TOGGLE">toggle</a></dt> - - <dt>7.4.3. <a href= - "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a></dt> - - <dt>7.4.4. <a href= - "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a></dt> - - <dt>7.4.5. <a href= - "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a></dt> - - <dt>7.4.6. <a href= - "config.html#ENFORCE-BLOCKS">enforce-blocks</a></dt> - - <dt>7.4.7. <a href="config.html#ACLS">ACLs: permit-access and - deny-access</a></dt> - - <dt>7.4.8. <a href= - "config.html#BUFFER-LIMIT">buffer-limit</a></dt> - </dl> - </dd> - - <dt>7.5. <a href="config.html#FORWARDING">Forwarding</a></dt> - - <dd> - <dl> - <dt>7.5.1. <a href="config.html#FORWARD">forward</a></dt> - - <dt>7.5.2. <a href="config.html#SOCKS">forward-socks4, - forward-socks4a and forward-socks5</a></dt> - - <dt>7.5.3. <a href= - "config.html#ADVANCED-FORWARDING-EXAMPLES">Advanced - Forwarding Examples</a></dt> - - <dt>7.5.4. <a href= - "config.html#FORWARDED-CONNECT-RETRIES">forwarded-connect-retries</a></dt> - </dl> - </dd> - - <dt>7.6. <a href="config.html#MISC">Miscellaneous</a></dt> - - <dd> - <dl> - <dt>7.6.1. <a href= - "config.html#ACCEPT-INTERCEPTED-REQUESTS">accept-intercepted-requests</a></dt> - - <dt>7.6.2. <a href= - "config.html#ALLOW-CGI-REQUEST-CRUNCHING">allow-cgi-request-crunching</a></dt> - - <dt>7.6.3. <a href= - "config.html#SPLIT-LARGE-FORMS">split-large-forms</a></dt> - - <dt>7.6.4. <a href= - "config.html#KEEP-ALIVE-TIMEOUT">keep-alive-timeout</a></dt> - - <dt>7.6.5. <a href= - "config.html#DEFAULT-SERVER-TIMEOUT">default-server-timeout</a></dt> - - <dt>7.6.6. <a href= - "config.html#CONNECTION-SHARING">connection-sharing</a></dt> - - <dt>7.6.7. <a href= - "config.html#SOCKET-TIMEOUT">socket-timeout</a></dt> - - <dt>7.6.8. <a href= - "config.html#MAX-CLIENT-CONNECTIONS">max-client-connections</a></dt> - - <dt>7.6.9. <a href= - "config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK">handle-as-empty-doc-returns-ok</a></dt> - - <dt>7.6.10. <a href= - "config.html#ENABLE-COMPRESSION">enable-compression</a></dt> - - <dt>7.6.11. <a href= - "config.html#COMPRESSION-LEVEL">compression-level</a></dt> - </dl> - </dd> - - <dt>7.7. <a href="config.html#WINDOWS-GUI">Windows GUI - Options</a></dt> - </dl> - </dd> - - <dt>8. <a href="actions-file.html">Actions Files</a></dt> - - <dd> - <dl> - <dt>8.1. <a href="actions-file.html#AEN2879">Finding the Right - Mix</a></dt> - - <dt>8.2. <a href="actions-file.html#AEN2886">How to Edit</a></dt> - - <dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions - are Applied to Requests</a></dt> - - <dt>8.4. <a href= - "actions-file.html#AF-PATTERNS">Patterns</a></dt> - - <dd> - <dl> - <dt>8.4.1. <a href="actions-file.html#AEN2998">The Domain - Pattern</a></dt> - - <dt>8.4.2. <a href="actions-file.html#AEN3074">The Path - Pattern</a></dt> - - <dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag - Pattern</a></dt> - </dl> - </dd> - - <dt>8.5. <a href="actions-file.html#ACTIONS">Actions</a></dt> - - <dd> - <dl> - <dt>8.5.1. <a href= - "actions-file.html#ADD-HEADER">add-header</a></dt> - - <dt>8.5.2. <a href="actions-file.html#BLOCK">block</a></dt> - - <dt>8.5.3. <a href= - "actions-file.html#CHANGE-X-FORWARDED-FOR">change-x-forwarded-for</a></dt> - - <dt>8.5.4. <a href= - "actions-file.html#CLIENT-HEADER-FILTER">client-header-filter</a></dt> - - <dt>8.5.5. <a href= - "actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a></dt> - - <dt>8.5.6. <a href= - "actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite</a></dt> - - <dt>8.5.7. <a href= - "actions-file.html#CRUNCH-CLIENT-HEADER">crunch-client-header</a></dt> - - <dt>8.5.8. <a href= - "actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a></dt> - - <dt>8.5.9. <a href= - "actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></dt> - - <dt>8.5.10. <a href= - "actions-file.html#CRUNCH-SERVER-HEADER">crunch-server-header</a></dt> - - <dt>8.5.11. <a href= - "actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></dt> - - <dt>8.5.12. <a href= - "actions-file.html#DEANIMATE-GIFS">deanimate-gifs</a></dt> - - <dt>8.5.13. <a href= - "actions-file.html#DOWNGRADE-HTTP-VERSION">downgrade-http-version</a></dt> - - <dt>8.5.14. <a href= - "actions-file.html#FAST-REDIRECTS">fast-redirects</a></dt> - - <dt>8.5.15. <a href= - "actions-file.html#FILTER">filter</a></dt> - - <dt>8.5.16. <a href= - "actions-file.html#FORCE-TEXT-MODE">force-text-mode</a></dt> - - <dt>8.5.17. <a href= - "actions-file.html#FORWARD-OVERRIDE">forward-override</a></dt> - - <dt>8.5.18. <a href= - "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></dt> - - <dt>8.5.19. <a href= - "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></dt> - - <dt>8.5.20. <a href= - "actions-file.html#HIDE-ACCEPT-LANGUAGE">hide-accept-language</a></dt> - - <dt>8.5.21. <a href= - "actions-file.html#HIDE-CONTENT-DISPOSITION">hide-content-disposition</a></dt> - - <dt>8.5.22. <a href= - "actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a></dt> - - <dt>8.5.23. <a href= - "actions-file.html#HIDE-FROM-HEADER">hide-from-header</a></dt> - - <dt>8.5.24. <a href= - "actions-file.html#HIDE-REFERRER">hide-referrer</a></dt> - - <dt>8.5.25. <a href= - "actions-file.html#HIDE-USER-AGENT">hide-user-agent</a></dt> - - <dt>8.5.26. <a href= - "actions-file.html#LIMIT-CONNECT">limit-connect</a></dt> - - <dt>8.5.27. <a href= - "actions-file.html#PREVENT-COMPRESSION">prevent-compression</a></dt> - - <dt>8.5.28. <a href= - "actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></dt> - - <dt>8.5.29. <a href= - "actions-file.html#REDIRECT">redirect</a></dt> - - <dt>8.5.30. <a href= - "actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a></dt> - - <dt>8.5.31. <a href= - "actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a></dt> - - <dt>8.5.32. <a href= - "actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></dt> - - <dt>8.5.33. <a href= - "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt> - - <dt>8.5.34. <a href= - "actions-file.html#AEN4706">Summary</a></dt> - </dl> - </dd> - - <dt>8.6. <a href="actions-file.html#ALIASES">Aliases</a></dt> - - <dt>8.7. <a href="actions-file.html#ACT-EXAMPLES">Actions Files - Tutorial</a></dt> - - <dd> - <dl> - <dt>8.7.1. <a href= - "actions-file.html#AEN4770">match-all.action</a></dt> - - <dt>8.7.2. <a href= - "actions-file.html#AEN4792">default.action</a></dt> - - <dt>8.7.3. <a href= - "actions-file.html#AEN4905">user.action</a></dt> - </dl> - </dd> - </dl> - </dd> - - <dt>9. <a href="filter-file.html">Filter Files</a></dt> - - <dd> - <dl> - <dt>9.1. <a href="filter-file.html#AEN5060">Filter File - Tutorial</a></dt> - - <dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The - Pre-defined Filters</a></dt> - </dl> - </dd> - - <dt>10. <a href="templates.html">Privoxy's Template Files</a></dt> - - <dt>11. <a href="contact.html">Contacting the Developers, Bug - Reporting and Feature Requests</a></dt> - - <dd> - <dl> - <dt>11.1. <a href="contact.html#CONTACT-SUPPORT">Get - Support</a></dt> - - <dt>11.2. <a href="contact.html#REPORTING">Reporting - Problems</a></dt> - - <dd> - <dl> - <dt>11.2.1. <a href="contact.html#CONTACT-ADS">Reporting Ads - or Other Configuration Problems</a></dt> - - <dt>11.2.2. <a href="contact.html#CONTACT-BUGS">Reporting - Bugs</a></dt> - </dl> - </dd> - - <dt>11.3. <a href="contact.html#CONTACT-FEATURE">Request New - Features</a></dt> - - <dt>11.4. <a href="contact.html#MAILING-LISTS">Mailing - Lists</a></dt> - </dl> - </dd> - - <dt>12. <a href="copyright.html">Privoxy Copyright, License and - History</a></dt> - - <dd> - <dl> - <dt>12.1. <a href="copyright.html#AEN5542">License</a></dt> - - <dt>12.2. <a href="copyright.html#HISTORY">History</a></dt> - - <dt>12.3. <a href="copyright.html#AUTHORS">Authors</a></dt> - </dl> - </dd> - - <dt>13. <a href="seealso.html">See Also</a></dt> - - <dt>14. <a href="appendix.html">Appendix</a></dt> - - <dd> - <dl> - <dt>14.1. <a href="appendix.html#REGEX">Regular - Expressions</a></dt> - - <dt>14.2. <a href="appendix.html#AEN5795">Privoxy's Internal - Pages</a></dt> - - <dd> - <dl> - <dt>14.2.1. <a href= - "appendix.html#BOOKMARKLETS">Bookmarklets</a></dt> - </dl> - </dd> - - <dt>14.3. <a href="appendix.html#CHAIN">Chain of Events</a></dt> - - <dt>14.4. <a href="appendix.html#ACTIONSANAT">Troubleshooting: - Anatomy of an Action</a></dt> - </dl> - </dd> - </dl> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c2" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"> </td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top"><a href= - "introduction.html" accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top"> </td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Introduction</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Privoxy 3.0.12 User Manual</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="NEXT" +TITLE="Introduction" +HREF="introduction.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="ARTICLE" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="ARTICLE" +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +><A +NAME="AEN2" +>Privoxy 3.0.12 User Manual</A +></H1 +><P +CLASS="PUBDATE" +> <SUB +> <A +HREF="copyright.html" +>Copyright</A +> © 2001-2009 by + <A +HREF="http://www.privoxy.org/" +TARGET="_top" +>Privoxy Developers</A +> + </SUB +><BR></P +><P +CLASS="PUBDATE" +>$Id: index.html,v 1.60 2009/03/21 12:58:53 fabiankeil Exp $<BR></P +><DIV +><DIV +CLASS="ABSTRACT" +><P +></P +><A +NAME="AEN9" +></A +><P +> The <I +CLASS="CITETITLE" +>Privoxy User Manual</I +> gives users information on how to + install, configure and use <A +HREF="http://www.privoxy.org/" +TARGET="_top" +>Privoxy</A +>. + </P +><P +> Privoxy is a non-caching web proxy with advanced filtering capabilities + for enhancing privacy, modifying web page data and HTTP headers, controlling + access, and removing ads and other obnoxious Internet junk. Privoxy has a + flexible configuration and can be customized to suit individual needs and tastes. + It has application for both stand-alone systems and multi-user networks.</P +><P +> Privoxy is Free Software and licensed under the GPL2.</P +><P +> Privoxy is an associated project of Software in the Public Interest (SPI). + <A +HREF="http://www.privoxy.org/faq/general.html#DONATE" +TARGET="_top" +>Donations are welcome</A +>.</P +><P +> You can find the latest version of the <I +CLASS="CITETITLE" +>Privoxy User Manual</I +> at <A +HREF="http://www.privoxy.org/user-manual/" +TARGET="_top" +>http://www.privoxy.org/user-manual/</A +>. + Please see the <A +HREF="contact.html" +>Contact section</A +> on how to + contact the developers. + </P +><P +></P +></DIV +></DIV +><HR></DIV +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +>1. <A +HREF="introduction.html" +>Introduction</A +></DT +><DD +><DL +><DT +>1.1. <A +HREF="introduction.html#FEATURES" +>Features</A +></DT +></DL +></DD +><DT +>2. <A +HREF="installation.html" +>Installation</A +></DT +><DD +><DL +><DT +>2.1. <A +HREF="installation.html#INSTALLATION-PACKAGES" +>Binary Packages</A +></DT +><DD +><DL +><DT +>2.1.1. <A +HREF="installation.html#INSTALLATION-PACK-RPM" +>Red Hat and Fedora RPMs</A +></DT +><DT +>2.1.2. <A +HREF="installation.html#INSTALLATION-DEB" +>Debian and Ubuntu</A +></DT +><DT +>2.1.3. <A +HREF="installation.html#INSTALLATION-PACK-WIN" +>Windows</A +></DT +><DT +>2.1.4. <A +HREF="installation.html#INSTALLATION-PACK-BINTGZ" +>Solaris</A +></DT +><DT +>2.1.5. <A +HREF="installation.html#INSTALLATION-OS2" +>OS/2</A +></DT +><DT +>2.1.6. <A +HREF="installation.html#INSTALLATION-MAC" +>Mac OS X</A +></DT +><DT +>2.1.7. <A +HREF="installation.html#INSTALLATION-AMIGA" +>AmigaOS</A +></DT +><DT +>2.1.8. <A +HREF="installation.html#INSTALLATION-TBZ" +>FreeBSD</A +></DT +><DT +>2.1.9. <A +HREF="installation.html#INSTALLATTION-GENTOO" +>Gentoo</A +></DT +></DL +></DD +><DT +>2.2. <A +HREF="installation.html#INSTALLATION-SOURCE" +>Building from Source</A +></DT +><DT +>2.3. <A +HREF="installation.html#INSTALLATION-KEEPUPDATED" +>Keeping your Installation Up-to-Date</A +></DT +></DL +></DD +><DT +>3. <A +HREF="whatsnew.html" +>What's New in this Release</A +></DT +><DD +><DL +><DT +>3.1. <A +HREF="whatsnew.html#UPGRADERSNOTE" +>Note to Upgraders</A +></DT +></DL +></DD +><DT +>4. <A +HREF="quickstart.html" +>Quickstart to Using Privoxy</A +></DT +><DD +><DL +><DT +>4.1. <A +HREF="quickstart.html#QUICKSTART-AD-BLOCKING" +>Quickstart to Ad Blocking</A +></DT +></DL +></DD +><DT +>5. <A +HREF="startup.html" +>Starting Privoxy</A +></DT +><DD +><DL +><DT +>5.1. <A +HREF="startup.html#START-REDHAT" +>Red Hat and Fedora</A +></DT +><DT +>5.2. <A +HREF="startup.html#START-DEBIAN" +>Debian</A +></DT +><DT +>5.3. <A +HREF="startup.html#START-WINDOWS" +>Windows</A +></DT +><DT +>5.4. <A +HREF="startup.html#START-UNICES" +>Solaris, NetBSD, FreeBSD, HP-UX and others</A +></DT +><DT +>5.5. <A +HREF="startup.html#START-OS2" +>OS/2</A +></DT +><DT +>5.6. <A +HREF="startup.html#START-MACOSX" +>Mac OS X</A +></DT +><DT +>5.7. <A +HREF="startup.html#START-AMIGAOS" +>AmigaOS</A +></DT +><DT +>5.8. <A +HREF="startup.html#START-GENTOO" +>Gentoo</A +></DT +><DT +>5.9. <A +HREF="startup.html#CMDOPTIONS" +>Command Line Options</A +></DT +></DL +></DD +><DT +>6. <A +HREF="configuration.html" +>Privoxy Configuration</A +></DT +><DD +><DL +><DT +>6.1. <A +HREF="configuration.html#AEN776" +>Controlling Privoxy with Your Web Browser</A +></DT +><DT +>6.2. <A +HREF="configuration.html#CONFOVERVIEW" +>Configuration Files Overview</A +></DT +></DL +></DD +><DT +>7. <A +HREF="config.html" +>The Main Configuration File</A +></DT +><DD +><DL +><DT +>7.1. <A +HREF="config.html#LOCAL-SET-UP" +>Local Set-up Documentation</A +></DT +><DD +><DL +><DT +>7.1.1. <A +HREF="config.html#USER-MANUAL" +>user-manual</A +></DT +><DT +>7.1.2. <A +HREF="config.html#TRUST-INFO-URL" +>trust-info-url</A +></DT +><DT +>7.1.3. <A +HREF="config.html#ADMIN-ADDRESS" +>admin-address</A +></DT +><DT +>7.1.4. <A +HREF="config.html#PROXY-INFO-URL" +>proxy-info-url</A +></DT +></DL +></DD +><DT +>7.2. <A +HREF="config.html#CONF-LOG-LOC" +>Configuration and Log File Locations</A +></DT +><DD +><DL +><DT +>7.2.1. <A +HREF="config.html#CONFDIR" +>confdir</A +></DT +><DT +>7.2.2. <A +HREF="config.html#TEMPLDIR" +>templdir</A +></DT +><DT +>7.2.3. <A +HREF="config.html#LOGDIR" +>logdir</A +></DT +><DT +>7.2.4. <A +HREF="config.html#ACTIONSFILE" +>actionsfile</A +></DT +><DT +>7.2.5. <A +HREF="config.html#FILTERFILE" +>filterfile</A +></DT +><DT +>7.2.6. <A +HREF="config.html#LOGFILE" +>logfile</A +></DT +><DT +>7.2.7. <A +HREF="config.html#TRUSTFILE" +>trustfile</A +></DT +></DL +></DD +><DT +>7.3. <A +HREF="config.html#DEBUGGING" +>Debugging</A +></DT +><DD +><DL +><DT +>7.3.1. <A +HREF="config.html#DEBUG" +>debug</A +></DT +><DT +>7.3.2. <A +HREF="config.html#SINGLE-THREADED" +>single-threaded</A +></DT +><DT +>7.3.3. <A +HREF="config.html#HOSTNAME" +>hostname</A +></DT +></DL +></DD +><DT +>7.4. <A +HREF="config.html#ACCESS-CONTROL" +>Access Control and Security</A +></DT +><DD +><DL +><DT +>7.4.1. <A +HREF="config.html#LISTEN-ADDRESS" +>listen-address</A +></DT +><DT +>7.4.2. <A +HREF="config.html#TOGGLE" +>toggle</A +></DT +><DT +>7.4.3. <A +HREF="config.html#ENABLE-REMOTE-TOGGLE" +>enable-remote-toggle</A +></DT +><DT +>7.4.4. <A +HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE" +>enable-remote-http-toggle</A +></DT +><DT +>7.4.5. <A +HREF="config.html#ENABLE-EDIT-ACTIONS" +>enable-edit-actions</A +></DT +><DT +>7.4.6. <A +HREF="config.html#ENFORCE-BLOCKS" +>enforce-blocks</A +></DT +><DT +>7.4.7. <A +HREF="config.html#ACLS" +>ACLs: permit-access and deny-access</A +></DT +><DT +>7.4.8. <A +HREF="config.html#BUFFER-LIMIT" +>buffer-limit</A +></DT +></DL +></DD +><DT +>7.5. <A +HREF="config.html#FORWARDING" +>Forwarding</A +></DT +><DD +><DL +><DT +>7.5.1. <A +HREF="config.html#FORWARD" +>forward</A +></DT +><DT +>7.5.2. <A +HREF="config.html#SOCKS" +>forward-socks4, forward-socks4a and forward-socks5</A +></DT +><DT +>7.5.3. <A +HREF="config.html#ADVANCED-FORWARDING-EXAMPLES" +>Advanced Forwarding Examples</A +></DT +><DT +>7.5.4. <A +HREF="config.html#FORWARDED-CONNECT-RETRIES" +>forwarded-connect-retries</A +></DT +><DT +>7.5.5. <A +HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS" +>accept-intercepted-requests</A +></DT +><DT +>7.5.6. <A +HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING" +>allow-cgi-request-crunching</A +></DT +><DT +>7.5.7. <A +HREF="config.html#SPLIT-LARGE-FORMS" +>split-large-forms</A +></DT +><DT +>7.5.8. <A +HREF="config.html#KEEP-ALIVE-TIMEOUT" +>keep-alive-timeout</A +></DT +><DT +>7.5.9. <A +HREF="config.html#SOCKET-TIMEOUT" +>socket-timeout</A +></DT +></DL +></DD +><DT +>7.6. <A +HREF="config.html#WINDOWS-GUI" +>Windows GUI Options</A +></DT +></DL +></DD +><DT +>8. <A +HREF="actions-file.html" +>Actions Files</A +></DT +><DD +><DL +><DT +>8.1. <A +HREF="actions-file.html#AEN2288" +>Finding the Right Mix</A +></DT +><DT +>8.2. <A +HREF="actions-file.html#AEN2295" +>How to Edit</A +></DT +><DT +>8.3. <A +HREF="actions-file.html#ACTIONS-APPLY" +>How Actions are Applied to Requests</A +></DT +><DT +>8.4. <A +HREF="actions-file.html#AF-PATTERNS" +>Patterns</A +></DT +><DD +><DL +><DT +>8.4.1. <A +HREF="actions-file.html#AEN2386" +>The Domain Pattern</A +></DT +><DT +>8.4.2. <A +HREF="actions-file.html#AEN2462" +>The Path Pattern</A +></DT +><DT +>8.4.3. <A +HREF="actions-file.html#TAG-PATTERN" +>The Tag Pattern</A +></DT +></DL +></DD +><DT +>8.5. <A +HREF="actions-file.html#ACTIONS" +>Actions</A +></DT +><DD +><DL +><DT +>8.5.1. <A +HREF="actions-file.html#ADD-HEADER" +>add-header</A +></DT +><DT +>8.5.2. <A +HREF="actions-file.html#BLOCK" +>block</A +></DT +><DT +>8.5.3. <A +HREF="actions-file.html#CHANGE-X-FORWARDED-FOR" +>change-x-forwarded-for</A +></DT +><DT +>8.5.4. <A +HREF="actions-file.html#CLIENT-HEADER-FILTER" +>client-header-filter</A +></DT +><DT +>8.5.5. <A +HREF="actions-file.html#CLIENT-HEADER-TAGGER" +>client-header-tagger</A +></DT +><DT +>8.5.6. <A +HREF="actions-file.html#CONTENT-TYPE-OVERWRITE" +>content-type-overwrite</A +></DT +><DT +>8.5.7. <A +HREF="actions-file.html#CRUNCH-CLIENT-HEADER" +>crunch-client-header</A +></DT +><DT +>8.5.8. <A +HREF="actions-file.html#CRUNCH-IF-NONE-MATCH" +>crunch-if-none-match</A +></DT +><DT +>8.5.9. <A +HREF="actions-file.html#CRUNCH-INCOMING-COOKIES" +>crunch-incoming-cookies</A +></DT +><DT +>8.5.10. <A +HREF="actions-file.html#CRUNCH-SERVER-HEADER" +>crunch-server-header</A +></DT +><DT +>8.5.11. <A +HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES" +>crunch-outgoing-cookies</A +></DT +><DT +>8.5.12. <A +HREF="actions-file.html#DEANIMATE-GIFS" +>deanimate-gifs</A +></DT +><DT +>8.5.13. <A +HREF="actions-file.html#DOWNGRADE-HTTP-VERSION" +>downgrade-http-version</A +></DT +><DT +>8.5.14. <A +HREF="actions-file.html#FAST-REDIRECTS" +>fast-redirects</A +></DT +><DT +>8.5.15. <A +HREF="actions-file.html#FILTER" +>filter</A +></DT +><DT +>8.5.16. <A +HREF="actions-file.html#FORCE-TEXT-MODE" +>force-text-mode</A +></DT +><DT +>8.5.17. <A +HREF="actions-file.html#FORWARD-OVERRIDE" +>forward-override</A +></DT +><DT +>8.5.18. <A +HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT" +>handle-as-empty-document</A +></DT +><DT +>8.5.19. <A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +></DT +><DT +>8.5.20. <A +HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE" +>hide-accept-language</A +></DT +><DT +>8.5.21. <A +HREF="actions-file.html#HIDE-CONTENT-DISPOSITION" +>hide-content-disposition</A +></DT +><DT +>8.5.22. <A +HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE" +>hide-if-modified-since</A +></DT +><DT +>8.5.23. <A +HREF="actions-file.html#HIDE-FROM-HEADER" +>hide-from-header</A +></DT +><DT +>8.5.24. <A +HREF="actions-file.html#HIDE-REFERRER" +>hide-referrer</A +></DT +><DT +>8.5.25. <A +HREF="actions-file.html#HIDE-USER-AGENT" +>hide-user-agent</A +></DT +><DT +>8.5.26. <A +HREF="actions-file.html#LIMIT-CONNECT" +>limit-connect</A +></DT +><DT +>8.5.27. <A +HREF="actions-file.html#PREVENT-COMPRESSION" +>prevent-compression</A +></DT +><DT +>8.5.28. <A +HREF="actions-file.html#OVERWRITE-LAST-MODIFIED" +>overwrite-last-modified</A +></DT +><DT +>8.5.29. <A +HREF="actions-file.html#REDIRECT" +>redirect</A +></DT +><DT +>8.5.30. <A +HREF="actions-file.html#SERVER-HEADER-FILTER" +>server-header-filter</A +></DT +><DT +>8.5.31. <A +HREF="actions-file.html#SERVER-HEADER-TAGGER" +>server-header-tagger</A +></DT +><DT +>8.5.32. <A +HREF="actions-file.html#SESSION-COOKIES-ONLY" +>session-cookies-only</A +></DT +><DT +>8.5.33. <A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker</A +></DT +><DT +>8.5.34. <A +HREF="actions-file.html#AEN4093" +>Summary</A +></DT +></DL +></DD +><DT +>8.6. <A +HREF="actions-file.html#ALIASES" +>Aliases</A +></DT +><DT +>8.7. <A +HREF="actions-file.html#ACT-EXAMPLES" +>Actions Files Tutorial</A +></DT +><DD +><DL +><DT +>8.7.1. <A +HREF="actions-file.html#AEN4157" +>match-all.action</A +></DT +><DT +>8.7.2. <A +HREF="actions-file.html#AEN4179" +>default.action</A +></DT +><DT +>8.7.3. <A +HREF="actions-file.html#AEN4292" +>user.action</A +></DT +></DL +></DD +></DL +></DD +><DT +>9. <A +HREF="filter-file.html" +>Filter Files</A +></DT +><DD +><DL +><DT +>9.1. <A +HREF="filter-file.html#AEN4447" +>Filter File Tutorial</A +></DT +><DT +>9.2. <A +HREF="filter-file.html#PREDEFINED-FILTERS" +>The Pre-defined Filters</A +></DT +></DL +></DD +><DT +>10. <A +HREF="templates.html" +>Privoxy's Template Files</A +></DT +><DT +>11. <A +HREF="contact.html" +>Contacting the Developers, Bug Reporting and Feature +Requests</A +></DT +><DD +><DL +><DT +>11.1. <A +HREF="contact.html#CONTACT-SUPPORT" +>Get Support</A +></DT +><DT +>11.2. <A +HREF="contact.html#REPORTING" +>Reporting Problems</A +></DT +><DD +><DL +><DT +>11.2.1. <A +HREF="contact.html#CONTACT-ADS" +>Reporting Ads or Other Configuration Problems</A +></DT +><DT +>11.2.2. <A +HREF="contact.html#CONTACT-BUGS" +>Reporting Bugs</A +></DT +></DL +></DD +><DT +>11.3. <A +HREF="contact.html#CONTACT-FEATURE" +>Request New Features</A +></DT +><DT +>11.4. <A +HREF="contact.html#CONTACT-OTHER" +>Other</A +></DT +></DL +></DD +><DT +>12. <A +HREF="copyright.html" +>Privoxy Copyright, License and History</A +></DT +><DD +><DL +><DT +>12.1. <A +HREF="copyright.html#AEN4921" +>License</A +></DT +><DT +>12.2. <A +HREF="copyright.html#HISTORY" +>History</A +></DT +><DT +>12.3. <A +HREF="copyright.html#AUTHORS" +>Authors</A +></DT +></DL +></DD +><DT +>13. <A +HREF="seealso.html" +>See Also</A +></DT +><DT +>14. <A +HREF="appendix.html" +>Appendix</A +></DT +><DD +><DL +><DT +>14.1. <A +HREF="appendix.html#REGEX" +>Regular Expressions</A +></DT +><DT +>14.2. <A +HREF="appendix.html#AEN5174" +>Privoxy's Internal Pages</A +></DT +><DD +><DL +><DT +>14.2.1. <A +HREF="appendix.html#BOOKMARKLETS" +>Bookmarklets</A +></DT +></DL +></DD +><DT +>14.3. <A +HREF="appendix.html#CHAIN" +>Chain of Events</A +></DT +><DT +>14.4. <A +HREF="appendix.html#ACTIONSANAT" +>Troubleshooting: Anatomy of an Action</A +></DT +></DL +></DD +></DL +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +> </TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="introduction.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +> </TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Introduction</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/installation.html b/external/privoxy/doc/webserver/user-manual/installation.html index c8a184b..f5fefc2 100644 --- a/external/privoxy/doc/webserver/user-manual/installation.html +++ b/external/privoxy/doc/webserver/user-manual/installation.html @@ -1,563 +1,1082 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Installation</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Introduction" href="introduction.html"> - <link rel="NEXT" title="What's New in this Release" href="whatsnew.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - table.c4 {background-color: #E0E0E0} - tt.c3 {font-style: italic} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "introduction.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="whatsnew.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="INSTALLATION" id="INSTALLATION">2. - Installation</a></h1> - - <p><span class="APPLICATION">Privoxy</span> is available both in - convenient pre-compiled packages for a wide range of operating systems, - and as raw source code. For most users, we recommend using the packages, - which can be downloaded from our <a href= - "http://sourceforge.net/projects/ijbswa/" target="_top">Privoxy Project - Page</a>.</p> - - <p>Note: On some platforms, the installer may remove previously installed - versions, if found. (See below for your platform). In any case - <span class="emphasis EMPHASIS c2">be sure to backup your old - configuration if it is valuable to you.</span> See the <a href= - "whatsnew.html#UPGRADERSNOTE">note to upgraders</a> section below.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="INSTALLATION-PACKAGES" id= - "INSTALLATION-PACKAGES">2.1. Binary Packages</a></h2> - - <p>How to install the binary packages depends on your operating - system:</p> - - <div class="SECT3"> - <h3 class="SECT3"><a name="INSTALLATION-PACK-RPM" id= - "INSTALLATION-PACK-RPM">2.1.1. Red Hat and Fedora RPMs</a></h3> - - <p>RPMs can be installed with <tt class="LITERAL">rpm -Uvh - privoxy-3.0.19-1.rpm</tt>, and will use <tt class= - "FILENAME">/etc/privoxy</tt> for the location of configuration - files.</p> - - <p>Note that on Red Hat, <span class="APPLICATION">Privoxy</span> - will <span class="emphasis EMPHASIS c2">not</span> be automatically - started on system boot. You will need to enable that using <b class= - "COMMAND">chkconfig</b>, <b class="COMMAND">ntsysv</b>, or similar - methods.</p> - - <p>If you have problems with failed dependencies, try rebuilding the - SRC RPM: <tt class="LITERAL">rpm --rebuild - privoxy-3.0.19-1.src.rpm</tt>. This will use your locally installed - libraries and RPM version.</p> - - <p>Also note that if you have a <span class= - "APPLICATION">Junkbuster</span> RPM installed on your system, you - need to remove it first, because the packages conflict. Otherwise, - RPM will try to remove <span class="APPLICATION">Junkbuster</span> - automatically if found, before installing <span class= - "APPLICATION">Privoxy</span>.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="INSTALLATION-DEB" id= - "INSTALLATION-DEB">2.1.2. Debian and Ubuntu</a></h3> - - <p>DEBs can be installed with <tt class="LITERAL">apt-get install - privoxy</tt>, and will use <tt class="FILENAME">/etc/privoxy</tt> for - the location of configuration files.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="INSTALLATION-PACK-WIN" id= - "INSTALLATION-PACK-WIN">2.1.3. Windows</a></h3> - - <p>Just double-click the installer, which will guide you through the - installation process. You will find the configuration files in the - same directory as you installed <span class= - "APPLICATION">Privoxy</span> in.</p> - - <p>Version 3.0.5 beta introduced full <span class= - "APPLICATION">Windows</span> service functionality. On Windows only, - the <span class="APPLICATION">Privoxy</span> program has two new - command line arguments to install and uninstall <span class= - "APPLICATION">Privoxy</span> as a <span class= - "emphasis EMPHASIS c2">service</span>.</p> - - <div class="VARIABLELIST"> - <dl> - <dt>Arguments:</dt> - - <dd> - <p><tt class="REPLACEABLE c3">--install</tt>[:<tt class= - "REPLACEABLE c3">service_name</tt>]</p> - - <p><tt class="REPLACEABLE c3">--uninstall</tt>[:<tt class= - "REPLACEABLE c3">service_name</tt>]</p> - </dd> - </dl> - </div> - - <p>After invoking <span class="APPLICATION">Privoxy</span> with - <b class="COMMAND">--install</b>, you will need to bring up the - <span class="APPLICATION">Windows</span> service console to assign - the user you want <span class="APPLICATION">Privoxy</span> to run - under, and whether or not you want it to run whenever the system - starts. You can start the <span class="APPLICATION">Windows</span> - services console with the following command: <b class= - "COMMAND">services.msc</b>. If you do not take the manual step of - modifying <span class="APPLICATION">Privoxy's</span> service - settings, it will not start. Note too that you will need to give - Privoxy a user account that actually exists, or it will not be - permitted to write to its log and configuration files.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="INSTALLATION-PACK-BINTGZ" id= - "INSTALLATION-PACK-BINTGZ">2.1.4. Solaris</a></h3> - - <p>Create a new directory, <tt class="LITERAL">cd</tt> to it, then - unzip and untar the archive. For the most part, you'll have to figure - out where things go.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="INSTALLATION-OS2" id= - "INSTALLATION-OS2">2.1.5. OS/2</a></h3> - - <p>First, make sure that no previous installations of <span class= - "APPLICATION">Junkbuster</span> and / or <span class= - "APPLICATION">Privoxy</span> are left on your system. Check that no - <span class="APPLICATION">Junkbuster</span> or <span class= - "APPLICATION">Privoxy</span> objects are in your startup folder.</p> - - <p>Then, just double-click the WarpIN self-installing archive, which - will guide you through the installation process. A shadow of the - <span class="APPLICATION">Privoxy</span> executable will be placed in - your startup folder so it will start automatically whenever OS/2 - starts.</p> - - <p>The directory you choose to install <span class= - "APPLICATION">Privoxy</span> into will contain all of the - configuration files.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="INSTALLATION-MAC" id= - "INSTALLATION-MAC">2.1.6. Mac OS X</a></h3> - - <p>Unzip the downloaded file (you can either double-click on the zip - file icon from the Finder, or from the desktop if you downloaded it - there). Then, double-click on the package installer icon and follow - the installation process.</p> - - <p>The privoxy service will automatically start after a successful - installation (in addition to every time your computer starts up). To - prevent the privoxy service from automatically starting when your - computer starts up, remove or rename the folder named <tt class= - "LITERAL">/Library/StartupItems/Privoxy</tt>.</p> - - <p>To manually start or stop the privoxy service, use the Privoxy - Utility for Mac OS X. This application controls the privoxy service - (e.g. starting and stopping the service as well as uninstalling the - software).</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="INSTALLATION-AMIGA" id= - "INSTALLATION-AMIGA">2.1.7. AmigaOS</a></h3> - - <p>Copy and then unpack the <tt class="FILENAME">lha</tt> archive to - a suitable location. All necessary files will be installed into - <span class="APPLICATION">Privoxy</span> directory, including all - configuration and log files. To uninstall, just remove this - directory.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="INSTALLATION-TBZ" id= - "INSTALLATION-TBZ">2.1.8. FreeBSD</a></h3> - - <p>Privoxy is part of FreeBSD's Ports Collection, you can build and - install it with <tt class="LITERAL">cd /usr/ports/www/privoxy; make - install clean</tt>.</p> - - <p>If you don't use the ports, you can fetch and install the package - with <tt class="LITERAL">pkg_add -r privoxy</tt>.</p> - - <p>The port skeleton and the package can also be downloaded from the - <a href= - "https://sourceforge.net/project/showfiles.php?group_id=11118" - target="_top">File Release Page</a>, but there's no reason to use - them unless you're interested in the beta releases which are only - available there.</p> - </div> - - <div class="SECT3"> - <h3 class="SECT3"><a name="INSTALLATTION-GENTOO" id= - "INSTALLATTION-GENTOO">2.1.9. Gentoo</a></h3> - - <p>Gentoo source packages (Ebuilds) for <span class= - "APPLICATION">Privoxy</span> are contained in the Gentoo Portage Tree - (they are not on the download page, but there is a Gentoo section, - where you can see when a new <span class="APPLICATION">Privoxy</span> - Version is added to the Portage Tree).</p> - - <p>Before installing <span class="APPLICATION">Privoxy</span> under - Gentoo just do first <tt class="LITERAL">emerge --sync</tt> to get - the latest changes from the Portage tree. With <tt class= - "LITERAL">emerge privoxy</tt> you install the latest version.</p> - - <p>Configuration files are in <tt class="FILENAME">/etc/privoxy</tt>, - the documentation is in <tt class= - "FILENAME">/usr/share/doc/privoxy-3.0.19</tt> and the Log directory - is in <tt class="FILENAME">/var/log/privoxy</tt>.</p> - </div> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="INSTALLATION-SOURCE" id= - "INSTALLATION-SOURCE">2.2. Building from Source</a></h2> - - <p>The most convenient way to obtain the <span class= - "APPLICATION">Privoxy</span> sources is to download the source tarball - from our <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118&package_id=1..." - target="_top">project download page</a>.</p> - - <p>If you like to live on the bleeding edge and are not afraid of using - possibly unstable development versions, you can check out the - up-to-the-minute version directly from <a href= - "http://sourceforge.net/cvs/?group_id=11118" target="_top">the CVS - repository</a>.</p> - - <p>To build <span class="APPLICATION">Privoxy</span> from source, - <a href="http://www.gnu.org/software/autoconf/autoconf.html" target= - "_top">autoconf</a>, <a href= - "http://www.gnu.org/software/make/make.html" target="_top">GNU make - (gmake)</a>, and, of course, a C compiler like <a href= - "http://www.gnu.org/software/gcc/gcc.html" target="_top">gcc</a> are - required.</p> - - <p>When building from a source tarball, first unpack the source:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - tar xzvf privoxy-3.0.19-stable-src.tar.gz - cd privoxy-3.0.19-stable -</pre> - </td> - </tr> - </table> - - <p>For retrieving the current CVS sources, you'll need a CVS client - installed. Note that sources from CVS are typically development - quality, and may not be stable, or well tested. To download CVS source, - check the Sourceforge documentation, which might give commands - like:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - cvs -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa login +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Installation</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Introduction" +HREF="introduction.html"><LINK +REL="NEXT" +TITLE="What's New in this Release" +HREF="whatsnew.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="introduction.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="whatsnew.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INSTALLATION" +>2. Installation</A +></H1 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is available both in convenient pre-compiled + packages for a wide range of operating systems, and as raw source code. + For most users, we recommend using the packages, which can be downloaded from our + <A +HREF="http://sourceforge.net/projects/ijbswa/" +TARGET="_top" +>Privoxy Project + Page</A +>.</P +><P +> Note: + On some platforms, the installer may remove previously installed versions, if + found. (See below for your platform). In any case <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>be sure to backup + your old configuration if it is valuable to you.</I +></SPAN +> See the <A +HREF="whatsnew.html#UPGRADERSNOTE" +>note to upgraders</A +> section below.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="INSTALLATION-PACKAGES" +>2.1. Binary Packages</A +></H2 +><P +>How to install the binary packages depends on your operating system:</P +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="INSTALLATION-PACK-RPM" +>2.1.1. Red Hat and Fedora RPMs</A +></H3 +><P +> RPMs can be installed with <TT +CLASS="LITERAL" +>rpm -Uvh privoxy-3.0.12-1.rpm</TT +>, + and will use <TT +CLASS="FILENAME" +>/etc/privoxy</TT +> for the location + of configuration files.</P +><P +> Note that on Red Hat, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not</I +></SPAN +> be automatically started on system boot. You will + need to enable that using <B +CLASS="COMMAND" +>chkconfig</B +>, + <B +CLASS="COMMAND" +>ntsysv</B +>, or similar methods. </P +><P +> If you have problems with failed dependencies, try rebuilding the SRC RPM: + <TT +CLASS="LITERAL" +>rpm --rebuild privoxy-3.0.12-1.src.rpm</TT +>. This + will use your locally installed libraries and RPM version. </P +><P +> Also note that if you have a <SPAN +CLASS="APPLICATION" +>Junkbuster</SPAN +> RPM installed + on your system, you need to remove it first, because the packages conflict. + Otherwise, RPM will try to remove <SPAN +CLASS="APPLICATION" +>Junkbuster</SPAN +> + automatically if found, before installing <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="INSTALLATION-DEB" +>2.1.2. Debian and Ubuntu</A +></H3 +><P +> DEBs can be installed with <TT +CLASS="LITERAL" +>apt-get install privoxy</TT +>, + and will use <TT +CLASS="FILENAME" +>/etc/privoxy</TT +> for the location of + configuration files.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="INSTALLATION-PACK-WIN" +>2.1.3. Windows</A +></H3 +><P +> Just double-click the installer, which will guide you through + the installation process. You will find the configuration files + in the same directory as you installed <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> in. </P +><P +> Version 3.0.5 beta introduced full <SPAN +CLASS="APPLICATION" +>Windows</SPAN +> service + functionality. On Windows only, the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + program has two new command line arguments to install and uninstall + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> as a <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>service</I +></SPAN +>.</P +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Arguments:</DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>--install</I +></TT +>[:<TT +CLASS="REPLACEABLE" +><I +>service_name</I +></TT +>] + </P +><P +> <TT +CLASS="REPLACEABLE" +><I +>--uninstall</I +></TT +>[:<TT +CLASS="REPLACEABLE" +><I +>service_name</I +></TT +>] + </P +></DD +></DL +></DIV +><P +> After invoking <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> with + <B +CLASS="COMMAND" +>--install</B +>, you will need to bring up the + <SPAN +CLASS="APPLICATION" +>Windows</SPAN +> service console to assign the user you + want <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to run under, and whether or not you + want it to run whenever the system starts. You can start the + <SPAN +CLASS="APPLICATION" +>Windows</SPAN +> services console with the following + command: <B +CLASS="COMMAND" +>services.msc</B +>. If you do not take the manual step + of modifying <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> service settings, it will + not start. Note too that you will need to give Privoxy a user account that + actually exists, or it will not be permitted to + write to its log and configuration files.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="INSTALLATION-PACK-BINTGZ" +>2.1.4. Solaris</A +></H3 +><P +> Create a new directory, <TT +CLASS="LITERAL" +>cd</TT +> to it, then unzip and + untar the archive. For the most part, you'll have to figure out where + things go. </P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="INSTALLATION-OS2" +>2.1.5. OS/2</A +></H3 +><P +> First, make sure that no previous installations of + <SPAN +CLASS="APPLICATION" +>Junkbuster</SPAN +> and / or + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> are left on your + system. Check that no <SPAN +CLASS="APPLICATION" +>Junkbuster</SPAN +> + or <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> objects are in + your startup folder. </P +><P +> Then, just double-click the WarpIN self-installing archive, which will + guide you through the installation process. A shadow of the + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> executable will be placed in your + startup folder so it will start automatically whenever OS/2 starts.</P +><P +> The directory you choose to install <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + into will contain all of the configuration files.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="INSTALLATION-MAC" +>2.1.6. Mac OS X</A +></H3 +><P +> Unzip the downloaded file (you can either double-click on the zip file + icon from the Finder, or from the desktop if you downloaded it there). + Then, double-click on the package installer icon and follow the + installation process.</P +><P +> The privoxy service will automatically start after a successful + installation (in addition to every time your computer starts up). To + prevent the privoxy service from automatically starting when your + computer starts up, remove or rename the folder named + <TT +CLASS="LITERAL" +>/Library/StartupItems/Privoxy</TT +>. </P +><P +> To manually start or stop the privoxy service, use the Privoxy Utility + for Mac OS X. This application controls the privoxy service (e.g. + starting and stopping the service as well as uninstalling the software).</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="INSTALLATION-AMIGA" +>2.1.7. AmigaOS</A +></H3 +><P +> Copy and then unpack the <TT +CLASS="FILENAME" +>lha</TT +> archive to a suitable location. + All necessary files will be installed into <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + directory, including all configuration and log files. To uninstall, just + remove this directory.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="INSTALLATION-TBZ" +>2.1.8. FreeBSD</A +></H3 +><P +> Privoxy is part of FreeBSD's Ports Collection, you can build and install + it with <TT +CLASS="LITERAL" +>cd /usr/ports/www/privoxy; make install clean</TT +>.</P +><P +> If you don't use the ports, you can fetch and install + the package with <TT +CLASS="LITERAL" +>pkg_add -r privoxy</TT +>.</P +><P +> The port skeleton and the package can also be downloaded from the + <A +HREF="https://sourceforge.net/project/showfiles.php?group_id=11118" +TARGET="_top" +>File Release + Page</A +>, but there's no reason to use them unless you're interested in the + beta releases which are only available there.</P +></DIV +><DIV +CLASS="SECT3" +><H3 +CLASS="SECT3" +><A +NAME="INSTALLATTION-GENTOO" +>2.1.9. Gentoo</A +></H3 +><P +> Gentoo source packages (Ebuilds) for <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> are + contained in the Gentoo Portage Tree (they are not on the download page, + but there is a Gentoo section, where you can see when a new + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> Version is added to the Portage Tree).</P +><P +> Before installing <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> under Gentoo just do + first <TT +CLASS="LITERAL" +>emerge --sync</TT +> to get the latest changes from the + Portage tree. With <TT +CLASS="LITERAL" +>emerge privoxy</TT +> you install the latest + version.</P +><P +> Configuration files are in <TT +CLASS="FILENAME" +>/etc/privoxy</TT +>, the + documentation is in <TT +CLASS="FILENAME" +>/usr/share/doc/privoxy-3.0.12</TT +> + and the Log directory is in <TT +CLASS="FILENAME" +>/var/log/privoxy</TT +>.</P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="INSTALLATION-SOURCE" +>2.2. Building from Source</A +></H2 +><P +> The most convenient way to obtain the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> sources + is to download the source tarball from our + <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118&package_id=1..." +TARGET="_top" +>project download + page</A +>.</P +><P +> If you like to live on the bleeding edge and are not afraid of using + possibly unstable development versions, you can check out the up-to-the-minute + version directly from <A +HREF="http://sourceforge.net/cvs/?group_id=11118" +TARGET="_top" +>the + CVS repository</A +>. </P +><P +> To build <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> from source, + <A +HREF="http://www.gnu.org/software/autoconf/autoconf.html" +TARGET="_top" +>autoconf</A +>, + <A +HREF="http://www.gnu.org/software/make/make.html" +TARGET="_top" +>GNU make + (gmake)</A +>, and, of course, a C compiler like <A +HREF="http://www.gnu.org/software/gcc/gcc.html" +TARGET="_top" +>gcc</A +> are required.</P +><P +> When building from a source tarball, + first unpack the source: </P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> tar xzvf privoxy-3.0.12-stable-src.tar.gz + cd privoxy-3.0.12-stable</PRE +></TD +></TR +></TABLE +></P +><P +> For retrieving the current CVS sources, you'll need a CVS client installed. + Note that sources from CVS are typically development quality, and may not be + stable, or well tested. To download CVS source, check the Sourceforge + documentation, which might give commands like:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> cvs -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa login cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co current - cd current -</pre> - </td> - </tr> - </table> - - <p>This will create a directory named <tt class= - "FILENAME">current/</tt>, which will contain the source tree.</p> - - <p>You can also check out any <span class="APPLICATION">Privoxy</span> - <span class="QUOTE">"branch"</span>, just exchange the <span class= - "APPLICATION">current</span> name with the wanted branch name (Example: - v_3_0_branch for the 3.0 cvs tree).</p> - - <p>It is also strongly recommended to not run <span class= - "APPLICATION">Privoxy</span> as root. You should configure/install/run - <span class="APPLICATION">Privoxy</span> as an unprivileged user, - preferably by creating a <span class="QUOTE">"privoxy"</span> user and - group just for this purpose. See your local documentation for the - correct command line to do add new users and groups (something like - <b class="COMMAND">adduser</b>, but the command syntax may vary from - platform to platform).</p> - - <p><tt class="FILENAME">/etc/passwd</tt> might then look like:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell -</pre> - </td> - </tr> - </table> - - <p>And then <tt class="FILENAME">/etc/group</tt>, like:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - privoxy:*:7777: -</pre> - </td> - </tr> - </table> - - <p>Some binary packages may do this for you.</p> - - <p>Then, to build from either unpacked tarball or CVS source:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - autoheader + cd current</PRE +></TD +></TR +></TABLE +></P +><P +> This will create a directory named <TT +CLASS="FILENAME" +>current/</TT +>, which will + contain the source tree.</P +><P +> You can also check out any <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + <SPAN +CLASS="QUOTE" +>"branch"</SPAN +>, just exchange the <SPAN +CLASS="APPLICATION" +>current</SPAN +> + name with the wanted branch name (Example: v_3_0_branch for the 3.0 cvs + tree).</P +><P +> It is also strongly recommended to not run <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + as root. You should configure/install/run <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> as + an unprivileged user, preferably by creating a <SPAN +CLASS="QUOTE" +>"privoxy"</SPAN +> user + and group just for this purpose. See your local documentation for the correct + command line to do add new users and groups (something like + <B +CLASS="COMMAND" +>adduser</B +>, but the command syntax may vary from platform + to platform). </P +><P +> <TT +CLASS="FILENAME" +>/etc/passwd</TT +> might then look like:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell</PRE +></TD +></TR +></TABLE +></P +><P +> And then <TT +CLASS="FILENAME" +>/etc/group</TT +>, like:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> privoxy:*:7777:</PRE +></TD +></TR +></TABLE +></P +><P +> Some binary packages may do this for you.</P +><P +> Then, to build from either unpacked tarball or CVS source:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> autoheader autoconf ./configure # (--help to see options) - make # (the make from GNU, sometimes called gmake) + make # (the make from GNU, sometimes called gmake) su # Possibly required make -n install # (to see where all the files will go) - make -s install # (to really install, -s to silence output) -</pre> - </td> - </tr> - </table> - - <p>Using GNU <b class="COMMAND">make</b>, you can have the first four - steps automatically done for you by just typing:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - make -</pre> - </td> - </tr> - </table> - - <p>in the freshly downloaded or unpacked source directory.</p> - - <p>To build an executable with security enhanced features so that users - cannot easily bypass the proxy (e.g. <span class="QUOTE">"Go There - Anyway"</span>), or alter their own configurations, <b class= - "COMMAND">configure</b> like this:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - ./configure --disable-toggle --disable-editor --disable-force -</pre> - </td> - </tr> - </table> - - <p>Then build as above. In Privoxy 3.0.7 and later, all of these - options can also be disabled through the configuration file.</p> - - <p><span class="emphasis EMPHASIS c2">WARNING:</span> If installing as - root, the install will fail unless a non-root user or group is - specified, or a <tt class="LITERAL">privoxy</tt> user and group already - exist on the system. If a non-root user is specified, and no group, - then the installation will try to also use a group of the same name as - <span class="QUOTE">"user"</span>. If a group is specified (and no - user), then the support files will be installed as writable by that - group, and owned by the user running the installation.</p> - - <p><b class="COMMAND">configure</b> accepts <tt class= - "LITERAL">--with-user</tt> and <tt class="LITERAL">--with-group</tt> - options for setting user and group ownership of the configuration files - (which need to be writable by the daemon). The specified <span class= - "emphasis EMPHASIS c2">user must already exist</span>. When starting - <span class="APPLICATION">Privoxy</span>, it must be run as this same - user to insure write access to configuration and log files!</p> - - <p>Alternately, you can specify <tt class="LITERAL">user</tt> and - <tt class="LITERAL">group</tt> on the <b class="COMMAND">make</b> - command line, but be sure both already exist:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - make -s install USER=privoxy GROUP=privoxy -</pre> - </td> - </tr> - </table> - - <p>The default installation path for <b class="COMMAND">make - install</b> is <tt class="FILENAME">/usr/local</tt>. This may of course - be customized with the various <b class="COMMAND">./configure</b> path - options. If you are doing an install to anywhere besides <tt class= - "FILENAME">/usr/local</tt>, be sure to set the appropriate paths with - the correct configure options (<b class="COMMAND">./configure - --help</b>). Non-privileged users must of course have write access - permissions to wherever the target installation is going.</p> - - <p>If you do install to <tt class="FILENAME">/usr/local</tt>, the - install will use <tt class= - "LITERAL">sysconfdir=$prefix/etc/privoxy</tt> by default. All other - destinations, and the direct usage of <tt class= - "LITERAL">--sysconfdir</tt> flag behave like normal, i.e. will not add - the extra <tt class="FILENAME">privoxy</tt> directory. This is for a - safer install, as there may already exist another program that uses a - file with the <span class="QUOTE">"config"</span> name, and thus makes - <tt class="FILENAME">/usr/local/etc</tt> cleaner.</p> - - <p>If installing to <tt class="FILENAME">/usr/local</tt>, the - documentation will go by default to <tt class= - "FILENAME">$prefix/share/doc</tt>. But if this directory doesn't exist, - it will then try <tt class="FILENAME">$prefix/doc</tt> and install - there before creating a new <tt class="FILENAME">$prefix/share/doc</tt> - just for <span class="APPLICATION">Privoxy</span>.</p> - - <p>Again, if the installs goes to <tt class="FILENAME">/usr/local</tt>, - the <tt class="LITERAL">localstatedir</tt> (ie: <tt class= - "FILENAME">var/</tt>) will default to <tt class="FILENAME">/var</tt> - instead of <tt class="LITERAL">$prefix/var</tt> so the logs will go to - <tt class="FILENAME">/var/log/privoxy/</tt>, and the pid file will be - created in <tt class="FILENAME">/var/run/privoxy.pid</tt>.</p> - - <p><b class="COMMAND">make install</b> will attempt to set the correct - values in <tt class="FILENAME">config</tt> (main configuration file). - You should check this to make sure all values are correct. If - appropriate, an init script will be installed, but it is up to the user - to determine how and where to start <span class= - "APPLICATION">Privoxy</span>. The init script should be checked for - correct paths and values, if anything other than a default install is - done.</p> - - <p>If install finds previous versions of local configuration files, - most of these will not be overwritten, and the new ones will be - installed with a <span class="QUOTE">"new"</span> extension. - default.action and default.filter <span class= - "emphasis EMPHASIS c2">will be overwritten</span>. You will then need - to manually update the other installed configuration files as needed. - The default template files <span class= - "emphasis EMPHASIS c2">will</span> be overwritten. If you have - customized, local templates, these should be stored safely in a - separate directory and defined in <tt class="FILENAME">config</tt> by - the <span class="QUOTE">"templdir"</span> directive. It is of course - wise to always back-up any important configuration files <span class= - "QUOTE">"just in case"</span>. If a previous version of <span class= - "APPLICATION">Privoxy</span> is already running, you will have to - restart it manually.</p> - - <p>For more detailed instructions on how to build Redhat RPMs, Windows - self-extracting installers, building on platforms with special - requirements etc, please consult the <a href= - "http://www.privoxy.org/developer-manual/newrelease.html" target= - "_top">developer manual</a>.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="INSTALLATION-KEEPUPDATED" id= - "INSTALLATION-KEEPUPDATED">2.3. Keeping your Installation - Up-to-Date</a></h2> - - <p>As user feedback comes in and development continues, we will make - updated versions of both the main <a href="actions-file.html">actions - file</a> (as a <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118&release_id=1..." - target="_top">separate package</a>) and the software itself (including - the actions file) available for download.</p> - - <p>If you wish to receive an email notification whenever we release - updates of <span class="APPLICATION">Privoxy</span> or the actions - file, <a href= - "http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/" target= - "_top">subscribe to our announce mailing list</a>, - ijbswa-announce@lists.sourceforge.net.</p> - - <p>In order not to lose your personal changes and adjustments when - updating to the latest <tt class="LITERAL">default.action</tt> file we - <span class="emphasis EMPHASIS c2">strongly recommend</span> that you - use <tt class="LITERAL">user.action</tt> and <tt class= - "LITERAL">user.filter</tt> for your local customizations of - <span class="APPLICATION">Privoxy</span>. See the <a href= - "actions-file.html">Chapter on actions files</a> for details.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="introduction.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="whatsnew.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Introduction</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">What's New in this - Release</td> - </tr> - </table> - </div> -</body> -</html> + make -s install # (to really install, -s to silence output)</PRE +></TD +></TR +></TABLE +></P +><P +> Using GNU <B +CLASS="COMMAND" +>make</B +>, you can have the first four steps + automatically done for you by just typing:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> make</PRE +></TD +></TR +></TABLE +></P +><P +> in the freshly downloaded or unpacked source directory.</P +><P +> To build an executable with security enhanced features so that + users cannot easily bypass the proxy (e.g. <SPAN +CLASS="QUOTE" +>"Go There Anyway"</SPAN +>), or + alter their own configurations, <B +CLASS="COMMAND" +>configure</B +> like this:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> ./configure --disable-toggle --disable-editor --disable-force</PRE +></TD +></TR +></TABLE +></P +><P +>Then build as above. In Privoxy 3.0.7 and later, all of these options +can also be disabled through the configuration file.</P +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>WARNING:</I +></SPAN +> If installing as root, the install will fail + unless a non-root user or group is specified, or a <TT +CLASS="LITERAL" +>privoxy</TT +> + user and group already exist on the system. If a non-root user is specified, + and no group, then the installation will try to also use a group of the same name + as <SPAN +CLASS="QUOTE" +>"user"</SPAN +>. If a group is specified (and no user), then the + support files will be installed as writable by that group, and owned by the + user running the installation.</P +><P +> <B +CLASS="COMMAND" +>configure</B +> accepts <TT +CLASS="LITERAL" +>--with-user</TT +> and + <TT +CLASS="LITERAL" +>--with-group</TT +> options for setting user and group ownership + of the configuration files (which need to be writable by the daemon). The + specified <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>user must already exist</I +></SPAN +>. When starting + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, it must be run as this same user to + insure write access to configuration and log files!</P +><P +> Alternately, you can specify <TT +CLASS="LITERAL" +>user</TT +> and <TT +CLASS="LITERAL" +>group</TT +> + on the <B +CLASS="COMMAND" +>make</B +> command line, but be sure both already exist:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> make -s install USER=privoxy GROUP=privoxy</PRE +></TD +></TR +></TABLE +></P +><P +> The default installation path for <B +CLASS="COMMAND" +>make install</B +> is + <TT +CLASS="FILENAME" +>/usr/local</TT +>. This may of course be customized with + the various <B +CLASS="COMMAND" +>./configure</B +> path options. If you are doing + an install to anywhere besides <TT +CLASS="FILENAME" +>/usr/local</TT +>, be + sure to set the appropriate paths with the correct configure options + (<B +CLASS="COMMAND" +>./configure --help</B +>). Non-privileged users must of course + have write access permissions to wherever the target installation is going.</P +><P +> If you do install to <TT +CLASS="FILENAME" +>/usr/local</TT +>, the install will use + <TT +CLASS="LITERAL" +>sysconfdir=$prefix/etc/privoxy</TT +> by default. All other + destinations, and the direct usage of <TT +CLASS="LITERAL" +>--sysconfdir</TT +> flag + behave like normal, i.e. will not add the extra <TT +CLASS="FILENAME" +>privoxy</TT +> + directory. This is for a safer install, as there may already exist another + program that uses a file with the <SPAN +CLASS="QUOTE" +>"config"</SPAN +> name, and thus makes + <TT +CLASS="FILENAME" +>/usr/local/etc</TT +> cleaner.</P +><P +> If installing to <TT +CLASS="FILENAME" +>/usr/local</TT +>, the documentation will go + by default to <TT +CLASS="FILENAME" +>$prefix/share/doc</TT +>. But if this directory + doesn't exist, it will then try <TT +CLASS="FILENAME" +>$prefix/doc</TT +> and install + there before creating a new <TT +CLASS="FILENAME" +>$prefix/share/doc</TT +> just for + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>.</P +><P +> Again, if the installs goes to <TT +CLASS="FILENAME" +>/usr/local</TT +>, the + <TT +CLASS="LITERAL" +>localstatedir</TT +> (ie: <TT +CLASS="FILENAME" +>var/</TT +>) will default + to <TT +CLASS="FILENAME" +>/var</TT +> instead of <TT +CLASS="LITERAL" +>$prefix/var</TT +> so + the logs will go to <TT +CLASS="FILENAME" +>/var/log/privoxy/</TT +>, and the pid file + will be created in <TT +CLASS="FILENAME" +>/var/run/privoxy.pid</TT +>. </P +><P +> <B +CLASS="COMMAND" +>make install</B +> will attempt to set the correct values + in <TT +CLASS="FILENAME" +>config</TT +> (main configuration file). You should + check this to make sure all values are correct. If appropriate, + an init script will be installed, but it is up to the user to determine + how and where to start <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. The init + script should be checked for correct paths and values, if anything other than + a default install is done.</P +><P +> If install finds previous versions of local configuration files, most of + these will not be overwritten, and the new ones will be installed with a + <SPAN +CLASS="QUOTE" +>"new"</SPAN +> extension. default.action and default.filter + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>will be overwritten</I +></SPAN +>. You will then need + to manually update the other installed configuration files as needed. The + default template files <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>will</I +></SPAN +> be overwritten. If you have + customized, local templates, these should be stored safely in a separate + directory and defined in <TT +CLASS="FILENAME" +>config</TT +> by the + <SPAN +CLASS="QUOTE" +>"templdir"</SPAN +> directive. It is of course wise to always back-up any + important configuration files <SPAN +CLASS="QUOTE" +>"just in case"</SPAN +>. If a previous + version of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is already running, you will + have to restart it manually.</P +><P +> For more detailed instructions on how to build Redhat RPMs, + Windows self-extracting installers, building on platforms with + special requirements etc, please consult the <A +HREF="http://www.privoxy.org/developer-manual/newrelease.html" +TARGET="_top" +>developer manual</A +>.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="INSTALLATION-KEEPUPDATED" +>2.3. Keeping your Installation Up-to-Date</A +></H2 +><P +> As user feedback comes in and development continues, we will make updated versions + of both the main <A +HREF="actions-file.html" +>actions file</A +> (as a <A +HREF="http://sourceforge.net/project/showfiles.php?group_id=11118&release_id=1..." +TARGET="_top" +>separate + package</A +>) and the software itself (including the actions file) available for + download.</P +><P +> If you wish to receive an email notification whenever we release updates of + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> or the actions file, <A +HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/" +TARGET="_top" +>subscribe + to our announce mailing list</A +>, ijbswa-announce@lists.sourceforge.net.</P +><P +> In order not to lose your personal changes and adjustments when updating + to the latest <TT +CLASS="LITERAL" +>default.action</TT +> file we <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>strongly + recommend</I +></SPAN +> that you use <TT +CLASS="LITERAL" +>user.action</TT +> and + <TT +CLASS="LITERAL" +>user.filter</TT +> for your local + customizations of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. See the <A +HREF="actions-file.html" +>Chapter on actions files</A +> for details.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="introduction.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="whatsnew.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Introduction</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>What's New in this Release</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/introduction.html b/external/privoxy/doc/webserver/user-manual/introduction.html index d7d3906..aad9cc0 100644 --- a/external/privoxy/doc/webserver/user-manual/introduction.html +++ b/external/privoxy/doc/webserver/user-manual/introduction.html @@ -1,182 +1,292 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Introduction</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="NEXT" title="Installation" href="installation.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="index.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "installation.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="INTRODUCTION" id="INTRODUCTION">1. - Introduction</a></h1> - - <p>This documentation is included with the current stable version of - <span class="APPLICATION">Privoxy</span>, v.3.0.19.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="FEATURES" id="FEATURES">1.1. - Features</a></h2> - - <p>In addition to the core features of ad blocking and <a href= - "http://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookie</a> - management, <span class="APPLICATION">Privoxy</span> provides many - supplemental features, that give the end-user more control, more - privacy and more freedom:</p> - - <ul> - <li> - <p>Supports "Connection: keep-alive". Outgoing connections can be - kept alive independently from the client.</p> - </li> - - <li> - <p>Supports IPv6, provided the operating system does so too, and - the configure script detects it.</p> - </li> - - <li> - <p>Supports tagging which allows to change the behaviour based on - client and server headers.</p> - </li> - - <li> - <p>Can be run as an "intercepting" proxy, which obviates the need - to configure browsers individually.</p> - </li> - - <li> - <p>Sophisticated actions and filters for manipulating both server - and client headers.</p> - </li> - - <li> - <p>Can be chained with other proxies.</p> - </li> - - <li> - <p>Integrated browser-based configuration and control utility at - <a href="http://config.privoxy.org/" target= - "_top">http://config.privoxy.org/</a> (shortcut: <a href= - "http://p.p/" target="_top">http://p.p/</a>). Browser-based tracing - of rule and filter effects. Remote toggling.</p> - </li> - - <li> - <p>Web page filtering (text replacements, removes banners based on - size, invisible <span class="QUOTE">"web-bugs"</span> and HTML - annoyances, etc.)</p> - </li> - - <li> - <p>Modularized configuration that allows for standard settings and - user settings to reside in separate files, so that installing - updated actions files won't overwrite individual user settings.</p> - </li> - - <li> - <p>Support for Perl Compatible Regular Expressions in the - configuration files, and a more sophisticated and flexible - configuration syntax.</p> - </li> - - <li> - <p>GIF de-animation.</p> - </li> - - <li> - <p>Bypass many click-tracking scripts (avoids script - redirection).</p> - </li> - - <li> - <p>User-customizable HTML templates for most proxy-generated pages - (e.g. "blocked" page).</p> - </li> - - <li> - <p>Auto-detection and re-reading of config file changes.</p> - </li> - - <li> - <p>Most features are controllable on a per-site or per-location - basis.</p> - </li> - - <li> - <p>Many smaller new features added, limitations and bugs - removed.</p> - </li> - </ul> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="index.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href= - "installation.html" accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Privoxy 3.0.19 User - Manual</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Installation</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Introduction</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="NEXT" +TITLE="Installation" +HREF="installation.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="index.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="installation.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INTRODUCTION" +>1. Introduction</A +></H1 +><P +> This documentation is included with the current stable version of + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, v.3.0.12.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="FEATURES" +>1.1. Features</A +></H2 +><P +> In addition to the core + features of ad blocking and + <A +HREF="http://en.wikipedia.org/wiki/Browser_cookie" +TARGET="_top" +>cookie</A +> management, + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> provides many supplemental + features, + that give the end-user more control, more privacy and more freedom:</P +><P +> <P +></P +><UL +><LI +><P +> Can keep outgoing connections alive and reuse them later on. + </P +></LI +><LI +><P +> Supports tagging which allows to change the behaviour + based on client and server headers. + </P +></LI +><LI +><P +> Can be run as an "intercepting" proxy, which obviates the need to + configure browsers individually. + </P +></LI +><LI +><P +> Sophisticated actions and filters for manipulating both server and client + headers. + </P +></LI +><LI +><P +> Can be chained with other proxies. + </P +></LI +><LI +><P +> Integrated browser based configuration and control utility at <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>http://config.privoxy.org/</A +> + (shortcut: <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +>). Browser-based + tracing of rule and filter effects. Remote toggling. + </P +></LI +><LI +><P +> Web page filtering (text replacements, removes banners based on size, + invisible <SPAN +CLASS="QUOTE" +>"web-bugs"</SPAN +>, JavaScript and HTML annoyances, + pop-up windows, etc.) + </P +></LI +><LI +><P +> Modularized configuration that allows for standard settings and + user settings to reside in separate files, so that installing updated + actions files won't overwrite individual user settings. + </P +></LI +><LI +><P +> Support for Perl Compatible Regular Expressions in the configuration files, and + a more sophisticated and flexible configuration syntax. + </P +></LI +><LI +><P +> Improved cookie management features (e.g. session based cookies). + </P +></LI +><LI +><P +> GIF de-animation. + </P +></LI +><LI +><P +> Bypass many click-tracking scripts (avoids script redirection). + </P +></LI +><LI +><P +> Multi-threaded (POSIX and native threads). + </P +></LI +><LI +><P +> User-customizable HTML templates for most proxy-generated pages (e.g. "blocked" page). + </P +></LI +><LI +><P +> Auto-detection and re-reading of config file changes. + </P +></LI +><LI +><P +> Improved signal handling, and a true daemon mode (Unix). + </P +></LI +><LI +><P +> Every feature now controllable on a per-site or per-location basis, configuration + more powerful and versatile over-all. + </P +></LI +><LI +><P +> Many smaller new features added, limitations and bugs removed. + </P +></LI +></UL +></P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Privoxy 3.0.12 User Manual</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Installation</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/quickstart.html b/external/privoxy/doc/webserver/user-manual/quickstart.html index 3085eb5..0393689 100644 --- a/external/privoxy/doc/webserver/user-manual/quickstart.html +++ b/external/privoxy/doc/webserver/user-manual/quickstart.html @@ -1,451 +1,943 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Quickstart to Using Privoxy</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="What's New in this Release" href= - "whatsnew.html"> - <link rel="NEXT" title="Starting Privoxy" href="startup.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - p.c3 {font-weight: bold} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="whatsnew.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="startup.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="QUICKSTART" id="QUICKSTART">4. Quickstart to - Using Privoxy</a></h1> - - <ul> - <li> - <p>Install <span class="APPLICATION">Privoxy</span>. See the <a href= - "installation.html">Installation Section</a> below for platform - specific information.</p> - </li> - - <li> - <p>Advanced users and those who want to offer <span class= - "APPLICATION">Privoxy</span> service to more than just their local - machine should check the <a href="config.html">main config file</a>, - especially the <a href= - "config.html#ACCESS-CONTROL">security-relevant</a> options. These are - off by default.</p> - </li> - - <li> - <p>Start <span class="APPLICATION">Privoxy</span>, if the - installation program has not done this already (may vary according to - platform). See the section <a href="startup.html">Starting - <span class="APPLICATION">Privoxy</span></a>.</p> - </li> - - <li> - <p>Set your browser to use <span class="APPLICATION">Privoxy</span> - as HTTP and HTTPS (SSL) <a href= - "http://en.wikipedia.org/wiki/Proxy_server" target="_top">proxy</a> - by setting the proxy configuration for address of <tt class= - "LITERAL">127.0.0.1</tt> and port <tt class="LITERAL">8118</tt>. - <span class="emphasis EMPHASIS c2">DO NOT</span> activate proxying - for <tt class="LITERAL">FTP</tt> or any protocols besides HTTP and - HTTPS (SSL) unless you intend to prevent your browser from using - these protocols.</p> - </li> - - <li> - <p>Flush your browser's disk and memory caches, to remove any cached - ad images. If using <span class="APPLICATION">Privoxy</span> to - manage <a href="http://en.wikipedia.org/wiki/Browser_cookie" target= - "_top">cookies</a>, you should remove any currently stored cookies - too.</p> - </li> - - <li> - <p>A default installation should provide a reasonable starting point - for most. There will undoubtedly be occasions where you will want to - adjust the configuration, but that can be dealt with as the need - arises. Little to no initial configuration is required in most cases, - you may want to enable the <a href="config.html#ENABLE-EDIT-ACTIONS" - target="_top">web-based action editor</a> though. Be sure to read the - warnings first.</p> - - <p>See the <a href="configuration.html">Configuration section</a> for - more configuration options, and how to customize your installation. - You might also want to look at the <a href= - "quickstart.html#QUICKSTART-AD-BLOCKING">next section</a> for a quick - introduction to how <span class="APPLICATION">Privoxy</span> blocks - ads and banners.</p> - </li> - - <li> - <p>If you experience ads that slip through, innocent images that are - blocked, or otherwise feel the need to fine-tune <span class= - "APPLICATION">Privoxy's</span> behavior, take a look at the <a href= - "actions-file.html">actions files</a>. As a quick start, you might - find the <a href="actions-file.html#ACT-EXAMPLES">richly commented - examples</a> helpful. You can also view and edit the actions files - through the <a href="http://config.privoxy.org" target= - "_top">web-based user interface</a>. The Appendix <span class= - "QUOTE">"<a href="appendix.html#ACTIONSANAT">Troubleshooting: Anatomy - of an Action</a>"</span> has hints on how to understand and debug - actions that <span class="QUOTE">"misbehave"</span>.</p> - </li> - - <li> - <p>Please see the section <a href="contact.html">Contacting the - Developers</a> on how to report bugs, problems with websites or to - get help.</p> - </li> - - <li> - <p>Now enjoy surfing with enhanced control, comfort and privacy!</p> - </li> - </ul> - - <div class="SECT2"> - <h2 class="SECT2"><a name="QUICKSTART-AD-BLOCKING" id= - "QUICKSTART-AD-BLOCKING">4.1. Quickstart to Ad Blocking</a></h2> - - <p>Ad blocking is but one of <span class="APPLICATION">Privoxy's</span> - array of features. Many of these features are for the technically - minded advanced user. But, ad and banner blocking is surely common - ground for everybody.</p> - - <p>This section will provide a quick summary of ad blocking so you can - get up to speed quickly without having to read the more extensive - information provided below, though this is highly recommended.</p> - - <p>First a bit of a warning ... blocking ads is much like blocking - SPAM: the more aggressive you are about it, the more likely you are to - block things that were not intended. And the more likely that some - things may not work as intended. So there is a trade off here. If you - want extreme ad free browsing, be prepared to deal with more - <span class="QUOTE">"problem"</span> sites, and to spend more time - adjusting the configuration to solve these unintended consequences. In - short, there is not an easy way to eliminate <span class= - "emphasis EMPHASIS c2">all</span> ads. Either take the easy way and - settle for <span class="emphasis EMPHASIS c2">most</span> ads blocked - with the default configuration, or jump in and tweak it for your - personal surfing habits and preferences.</p> - - <p>Secondly, a brief explanation of <span class= - "APPLICATION">Privoxy's</span> <span class="QUOTE">"actions"</span>. - <span class="QUOTE">"Actions"</span> in this context, are the - directives we use to tell <span class="APPLICATION">Privoxy</span> to - perform some task relating to HTTP transactions (i.e. web browsing). We - tell <span class="APPLICATION">Privoxy</span> to take some <span class= - "QUOTE">"action"</span>. Each action has a unique name and function. - While there are many potential <span class="APPLICATION">actions</span> - in <span class="APPLICATION">Privoxy's</span> arsenal, only a few are - used for ad blocking. <a href="actions-file.html#ACTIONS">Actions</a>, - and <a href="actions-file.html">action configuration files</a>, are - explained in depth below.</p> - - <p>Actions are specified in <span class="APPLICATION">Privoxy's</span> - configuration, followed by one or more URLs to which the action should - apply. URLs can actually be URL type <a href= - "actions-file.html#AF-PATTERNS">patterns</a> that use wildcards so they - can apply potentially to a range of similar URLs. The actions, together - with the URL patterns are called a section.</p> - - <p>When you connect to a website, the full URL will either match one or - more of the sections as defined in <span class= - "APPLICATION">Privoxy's</span> configuration, or not. If so, then - <span class="APPLICATION">Privoxy</span> will perform the respective - actions. If not, then nothing special happens. Furthermore, web pages - may contain embedded, secondary URLs that your web browser will use to - load additional components of the page, as it parses the original - page's HTML content. An ad image for instance, is just an URL embedded - in the page somewhere. The image itself may be on the same server, or a - server somewhere else on the Internet. Complex web pages will have many - such embedded URLs. <span class="APPLICATION">Privoxy</span> can deal - with each URL individually, so, for instance, the main page text is not - touched, but images from such-and-such server are blocked.</p> - - <p>The most important actions for basic ad blocking are: <tt class= - "LITERAL"><a href="actions-file.html#BLOCK">block</a></tt>, <tt class= - "LITERAL"><a href= - "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt>, - <tt class="LITERAL"><a href= - "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></tt>,and - <tt class="LITERAL"><a href= - "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></tt>:</p> - - <ul> - <li> - <p><tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt> - this is perhaps the - single most used action, and is particularly important for ad - blocking. This action stops any contact between your browser and - any URL patterns that match this action's configuration. It can be - used for blocking ads, but also anything that is determined to be - unwanted. By itself, it simply stops any communication with the - remote server and sends <span class="APPLICATION">Privoxy</span>'s - own built-in BLOCKED page instead to let you now what has happened - (with some exceptions, see below).</p> - </li> - - <li> - <p><tt class="LITERAL"><a href= - "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt> - - tells <span class="APPLICATION">Privoxy</span> to treat this URL as - an image. <span class="APPLICATION">Privoxy</span>'s default - configuration already does this for all common image types (e.g. - GIF), but there are many situations where this is not so easy to - determine. So we'll force it in these cases. This is particularly - important for ad blocking, since only if we know that it's an image - of some kind, can we replace it with an image of our choosing, - instead of the <span class="APPLICATION">Privoxy</span> BLOCKED - page (which would only result in a <span class="QUOTE">"broken - image"</span> icon). There are some limitations to this though. For - instance, you can't just brute-force an image substitution for an - entire HTML page in most situations.</p> - </li> - - <li> - <p><tt class="LITERAL"><a href= - "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></tt> - - sends an empty document instead of <span class= - "APPLICATION">Privoxy's</span> normal BLOCKED HTML page. This is - useful for file types that are neither HTML nor images, such as - blocking JavaScript files.</p> - </li> - - <li> - <p><tt class="LITERAL"><a href= - "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></tt> - - tells <span class="APPLICATION">Privoxy</span> what to display in - place of an ad image that has hit a block rule. For this to come - into play, the URL must match a <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt> action somewhere in the - configuration, <span class="emphasis EMPHASIS c2">and</span>, it - must also match an <tt class="LITERAL"><a href= - "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt> - action.</p> - - <p>The configuration options on what to display instead of the ad - are:</p> - - <table border="0"> - <tbody> - <tr> - <td> <span class= - "emphasis EMPHASIS c2">pattern</span> - a checkerboard - pattern, so that an ad replacement is obvious. This is the - default.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td> <span class= - "emphasis EMPHASIS c2">blank</span> - A very small empty GIF - image is displayed. This is the so-called <span class= - "QUOTE">"invisible"</span> configuration option.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td> <span class= - "emphasis EMPHASIS c2">http://%3CURL%3E;</span> - A redirect - to any image anywhere of the user's choosing (advanced - usage).</td> - </tr> - </tbody> - </table> - </li> - </ul> - - <p>Advanced users will eventually want to explore <span class= - "APPLICATION">Privoxy</span> <tt class="LITERAL"><a href= - "actions-file.html#FILTER">filters</a></tt> as well. Filters are very - different from <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">blocks</a></tt>. A <span class= - "QUOTE">"block"</span> blocks a site, page, or unwanted contented. - Filters are a way of filtering or modifying what is actually on the - page. An example filter usage: a text replacement of <span class= - "QUOTE">"no-no"</span> for <span class="QUOTE">"nasty-word"</span>. - That is a very simple example. This process can be used for ad - blocking, but it is more in the realm of advanced usage and has some - pitfalls to be wary off.</p> - - <p>The quickest way to adjust any of these settings is with your - browser through the special <span class="APPLICATION">Privoxy</span> - editor at <a href="http://config.privoxy.org/show-status" target= - "_top">http://config.privoxy.org/show-status</a> (shortcut: <a href= - "http://p.p/" target="_top">http://p.p/show-status</a>). This is an - internal page, and does not require Internet access.</p> - - <p>Note that as of <span class="APPLICATION">Privoxy</span> 3.0.7 beta - the action editor is disabled by default. Check the <a href= - "config.html#ENABLE-EDIT-ACTIONS" target="_top">enable-edit-actions - section in the configuration file</a> to learn why and in which cases - it's safe to enable again.</p> - - <p>If you decided to enable the action editor, select the appropriate - <span class="QUOTE">"actions"</span> file, and click <span class= - "QUOTE">"<span class="GUIBUTTON">Edit</span>"</span>. It is best to put - personal or local preferences in <tt class="FILENAME">user.action</tt> - since this is not meant to be overwritten during upgrades, and will - over-ride the settings in other files. Here you can insert new - <span class="QUOTE">"actions"</span>, and URLs for ad blocking or other - purposes, and make other adjustments to the configuration. <span class= - "APPLICATION">Privoxy</span> will detect these changes - automatically.</p> - - <p>A quick and simple step by step example:</p> - - <ul> - <li> - <p>Right click on the ad image to be blocked, then select - <span class="QUOTE">"<span class="GUIMENUITEM">Copy Link - Location</span>"</span> from the pop-up menu.</p> - </li> - - <li> - <p>Set your browser to <a href= - "http://config.privoxy.org/show-status" target= - "_top">http://config.privoxy.org/show-status</a></p> - </li> - - <li> - <p>Find <tt class="FILENAME">user.action</tt> in the top section, - and click on <span class="QUOTE">"<span class= - "GUIBUTTON">Edit</span>"</span>:</p> - - <div class="FIGURE"> - <a name="AEN844" id="AEN844"></a> - - <p class="c3">Figure 1. Actions Files in Use</p> - - <div class="MEDIAOBJECT"> - <p><img src="files-in-use.jpg"></p> - </div> - </div> - </li> - - <li> - <p>You should have a section with only <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt> listed under <span class= - "QUOTE">"Actions:"</span>. If not, click a <span class= - "QUOTE">"<span class="GUIBUTTON">Insert new section - below</span>"</span> button, and in the new section that just - appeared, click the <span class="GUIBUTTON">Edit</span> button - right under the word <span class="QUOTE">"Actions:"</span>. This - will bring up a list of all actions. Find <tt class= - "LITERAL"><a href="actions-file.html#BLOCK">block</a></tt> near the - top, and click in the <span class="QUOTE">"Enabled"</span> column, - then <span class="QUOTE">"<span class= - "GUIBUTTON">Submit</span>"</span> just below the list.</p> - </li> - - <li> - <p>Now, in the <tt class="LITERAL"><a href= - "actions-file.html#BLOCK">block</a></tt> actions section, click the - <span class="QUOTE">"<span class="GUIBUTTON">Add</span>"</span> - button, and paste the URL the browser got from <span class= - "QUOTE">"<span class="GUIMENUITEM">Copy Link - Location</span>"</span>. Remove the <tt class= - "LITERAL">http://</tt> at the beginning of the URL. Then, click - <span class="QUOTE">"<span class="GUIBUTTON">Submit</span>"</span> - (or <span class="QUOTE">"<span class="GUIBUTTON">OK</span>"</span> - if in a pop-up window).</p> - </li> - - <li> - <p>Now go back to the original page, and press <b class= - "KEYCAP">SHIFT-Reload</b> (or flush all browser caches). The image - should be gone now.</p> - </li> - </ul> - - <p>This is a very crude and simple example. There might be good reasons - to use a wildcard pattern match to include potentially similar images - from the same site. For a more extensive explanation of <span class= - "QUOTE">"patterns"</span>, and the entire actions concept, see <a href= - "actions-file.html">the Actions section</a>.</p> - - <p>For advanced users who want to hand edit their config files, you - might want to now go to the <a href= - "actions-file.html#ACT-EXAMPLES">Actions Files Tutorial</a>. The ideas - explained therein also apply to the web-based editor.</p> - - <p>There are also various <a href= - "actions-file.html#FILTER">filters</a> that can be used for ad blocking - (filters are a special subset of actions). These fall into the - <span class="QUOTE">"advanced"</span> usage category, and are explained - in depth in later sections.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="whatsnew.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="startup.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">What's New in this - Release</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Starting Privoxy</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Quickstart to Using Privoxy</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="What's New in this Release" +HREF="whatsnew.html"><LINK +REL="NEXT" +TITLE="Starting Privoxy" +HREF="startup.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="whatsnew.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="startup.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="QUICKSTART" +>4. Quickstart to Using Privoxy</A +></H1 +><P +> <P +></P +><UL +><LI +><P +> Install <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. See the <A +HREF="installation.html" +>Installation Section</A +> below for platform specific + information. + </P +></LI +><LI +><P +> Advanced users and those who want to offer <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + service to more than just their local machine should check the <A +HREF="config.html" +>main config file</A +>, especially the <A +HREF="config.html#ACCESS-CONTROL" +>security-relevant</A +> options. These are + off by default. + </P +></LI +><LI +><P +> Start <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>, if the installation program has + not done this already (may vary according to platform). See the section + <A +HREF="startup.html" +>Starting <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +></A +>. + </P +></LI +><LI +><P +> Set your browser to use <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> as HTTP and + HTTPS (SSL) <A +HREF="http://en.wikipedia.org/wiki/Proxy_server" +TARGET="_top" +>proxy</A +> + by setting the proxy configuration for address of + <TT +CLASS="LITERAL" +>127.0.0.1</TT +> and port <TT +CLASS="LITERAL" +>8118</TT +>. + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>DO NOT</I +></SPAN +> activate proxying for <TT +CLASS="LITERAL" +>FTP</TT +> or + any protocols besides HTTP and HTTPS (SSL) unless you intend to prevent your + browser from using these protocols. + </P +></LI +><LI +><P +> Flush your browser's disk and memory caches, to remove any cached ad images. + If using <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to manage + <A +HREF="http://en.wikipedia.org/wiki/Browser_cookie" +TARGET="_top" +>cookies</A +>, + you should remove any currently stored cookies too. + </P +></LI +><LI +><P +> A default installation should provide a reasonable starting point for + most. There will undoubtedly be occasions where you will want to adjust the + configuration, but that can be dealt with as the need arises. Little + to no initial configuration is required in most cases, you may want + to enable the + <A +HREF="config.html#ENABLE-EDIT-ACTIONS" +TARGET="_top" +>web-based action editor</A +> though. + Be sure to read the warnings first. + </P +><P +> See the <A +HREF="configuration.html" +>Configuration section</A +> for more + configuration options, and how to customize your installation. + You might also want to look at the <A +HREF="quickstart.html#QUICKSTART-AD-BLOCKING" +>next section</A +> for a quick + introduction to how <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> blocks ads and + banners.</P +></LI +><LI +><P +> If you experience ads that slip through, innocent images that are + blocked, or otherwise feel the need to fine-tune + <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> behavior, take a look at the <A +HREF="actions-file.html" +>actions files</A +>. As a quick start, you might + find the <A +HREF="actions-file.html#ACT-EXAMPLES" +>richly commented examples</A +> + helpful. You can also view and edit the actions files through the <A +HREF="http://config.privoxy.org" +TARGET="_top" +>web-based user interface</A +>. The + Appendix <SPAN +CLASS="QUOTE" +>"<A +HREF="appendix.html#ACTIONSANAT" +>Troubleshooting: Anatomy of an + Action</A +>"</SPAN +> has hints on how to understand and debug actions that + <SPAN +CLASS="QUOTE" +>"misbehave"</SPAN +>. + </P +></LI +><LI +><P +> Please see the section <A +HREF="contact.html" +>Contacting the + Developers</A +> on how to report bugs, problems with websites or to get + help. + </P +></LI +><LI +><P +> Now enjoy surfing with enhanced control, comfort and privacy! + </P +></LI +></UL +></P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="QUICKSTART-AD-BLOCKING" +>4.1. Quickstart to Ad Blocking</A +></H2 +><P +> Ad blocking is but one of <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + array of features. Many of these features are for the technically minded advanced + user. But, ad and banner blocking is surely common ground for everybody.</P +><P +> + This section will provide a quick summary of ad blocking so + you can get up to speed quickly without having to read the more extensive + information provided below, though this is highly recommended.</P +><P +> First a bit of a warning ... blocking ads is much like blocking SPAM: the + more aggressive you are about it, the more likely you are to block + things that were not intended. And the more likely that some things + may not work as intended. So there is a trade off here. If you want + extreme ad free browsing, be prepared to deal with more + <SPAN +CLASS="QUOTE" +>"problem"</SPAN +> sites, and to spend more time adjusting the + configuration to solve these unintended consequences. In short, there is + not an easy way to eliminate <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all</I +></SPAN +> ads. Either take + the easy way and settle for <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>most</I +></SPAN +> ads blocked with the + default configuration, or jump in and tweak it for your personal surfing + habits and preferences.</P +><P +> Secondly, a brief explanation of <SPAN +CLASS="APPLICATION" +>Privoxy's </SPAN +> + <SPAN +CLASS="QUOTE" +>"actions"</SPAN +>. <SPAN +CLASS="QUOTE" +>"Actions"</SPAN +> in this context, are + the directives we use to tell <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to perform + some task relating to HTTP transactions (i.e. web browsing). We tell + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to take some <SPAN +CLASS="QUOTE" +>"action"</SPAN +>. Each + action has a unique name and function. While there are many potential + <SPAN +CLASS="APPLICATION" +>actions</SPAN +> in <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + arsenal, only a few are used for ad blocking. <A +HREF="actions-file.html#ACTIONS" +>Actions</A +>, and <A +HREF="actions-file.html" +>action + configuration files</A +>, are explained in depth below.</P +><P +> Actions are specified in <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> configuration, + followed by one or more URLs to which the action should apply. URLs + can actually be URL type <A +HREF="actions-file.html#AF-PATTERNS" +>patterns</A +> that use + wildcards so they can apply potentially to a range of similar URLs. The + actions, together with the URL patterns are called a section.</P +><P +> When you connect to a website, the full URL will either match one or more + of the sections as defined in <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> configuration, + or not. If so, then <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will perform the + respective actions. If not, then nothing special happens. Furthermore, web + pages may contain embedded, secondary URLs that your web browser will + use to load additional components of the page, as it parses the + original page's HTML content. An ad image for instance, is just an URL + embedded in the page somewhere. The image itself may be on the same server, + or a server somewhere else on the Internet. Complex web pages will have many + such embedded URLs. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can deal with each URL individually, so, for + instance, the main page text is not touched, but images from such-and-such + server are blocked.</P +><P +> The most important actions for basic ad blocking are: <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +>, <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +></TT +>, + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT" +>handle-as-empty-document</A +></TT +>,and + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker</A +></TT +>:</P +><P +> <P +></P +><UL +><LI +><P +> <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> - this is perhaps + the single most used action, and is particularly important for ad blocking. + This action stops any contact between your browser and any URL patterns + that match this action's configuration. It can be used for blocking ads, + but also anything that is determined to be unwanted. By itself, it simply + stops any communication with the remote server and sends + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s own built-in BLOCKED page instead to + let you now what has happened (with some exceptions, see below). + </P +></LI +><LI +><P +> <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +></TT +> - + tells <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to treat this URL as an image. + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>'s default configuration already does this + for all common image types (e.g. GIF), but there are many situations where this + is not so easy to determine. So we'll force it in these cases. This is particularly + important for ad blocking, since only if we know that it's an image of + some kind, can we replace it with an image of our choosing, instead of the + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> BLOCKED page (which would only result in + a <SPAN +CLASS="QUOTE" +>"broken image"</SPAN +> icon). There are some limitations to this + though. For instance, you can't just brute-force an image substitution for + an entire HTML page in most situations. + </P +></LI +><LI +><P +> <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT" +>handle-as-empty-document</A +></TT +> - + sends an empty document instead of <SPAN +CLASS="APPLICATION" +>Privoxy's</SPAN +> + normal BLOCKED HTML page. This is useful for file types that are neither + HTML nor images, such as blocking JavaScript files. + </P +></LI +><LI +><P +> <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#SET-IMAGE-BLOCKER" +>set-image-blocker</A +></TT +> - tells + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> what to display in place of an ad image that + has hit a block rule. For this to come into play, the URL must match a + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> action somewhere in the + configuration, <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>and</I +></SPAN +>, it must also match an + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#HANDLE-AS-IMAGE" +>handle-as-image</A +></TT +> action. + </P +><P +> The configuration options on what to display instead of the ad are: + </P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>pattern</I +></SPAN +> - a checkerboard pattern, so that an ad + replacement is obvious. This is the default. + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>blank</I +></SPAN +> - A very small empty GIF image is displayed. + This is the so-called <SPAN +CLASS="QUOTE" +>"invisible"</SPAN +> configuration option. + </TD +></TR +></TBODY +></TABLE +><P +></P +><P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>http://%3CURL%3E;</I +></SPAN +> - A redirect to any image anywhere + of the user's choosing (advanced usage). + </TD +></TR +></TBODY +></TABLE +><P +></P +></LI +></UL +></P +><P +> Advanced users will eventually want to explore <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#FILTER" +>filters</A +></TT +> as well. Filters + are very different from <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>blocks</A +></TT +>. + A <SPAN +CLASS="QUOTE" +>"block"</SPAN +> blocks a site, page, or unwanted contented. Filters + are a way of filtering or modifying what is actually on the page. An example + filter usage: a text replacement of <SPAN +CLASS="QUOTE" +>"no-no"</SPAN +> for + <SPAN +CLASS="QUOTE" +>"nasty-word"</SPAN +>. That is a very simple example. This process can be + used for ad blocking, but it is more in the realm of advanced usage and has + some pitfalls to be wary off.</P +><P +> The quickest way to adjust any of these settings is with your browser through + the special <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> editor at <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +> + (shortcut: <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/show-status</A +>). This + is an internal page, and does not require Internet access.</P +><P +> Note that as of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> 3.0.7 beta the + action editor is disabled by default. Check the + <A +HREF="config.html#ENABLE-EDIT-ACTIONS" +TARGET="_top" +>enable-edit-actions + section in the configuration file</A +> to learn why and in which + cases it's safe to enable again.</P +><P +> If you decided to enable the action editor, select the appropriate + <SPAN +CLASS="QUOTE" +>"actions"</SPAN +> file, and click + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +>"</SPAN +>. It is best to put personal or + local preferences in <TT +CLASS="FILENAME" +>user.action</TT +> since this is not + meant to be overwritten during upgrades, and will over-ride the settings in + other files. Here you can insert new <SPAN +CLASS="QUOTE" +>"actions"</SPAN +>, and URLs for ad + blocking or other purposes, and make other adjustments to the configuration. + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will detect these changes automatically.</P +><P +> A quick and simple step by step example:</P +><P +> <P +></P +><UL +><LI +><P +> Right click on the ad image to be blocked, then select + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIMENUITEM" +>Copy Link Location</SPAN +>"</SPAN +> from the + pop-up menu. + </P +></LI +><LI +><P +> Set your browser to + <A +HREF="http://config.privoxy.org/show-status" +TARGET="_top" +>http://config.privoxy.org/show-status</A +> + </P +></LI +><LI +><P +> Find <TT +CLASS="FILENAME" +>user.action</TT +> in the top section, and click + on <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +>"</SPAN +>: + </P +><P +> <DIV +CLASS="FIGURE" +><A +NAME="AEN530" +></A +><P +><B +>Figure 1. Actions Files in Use</B +></P +><DIV +CLASS="MEDIAOBJECT" +><P +><IMG +SRC="files-in-use.jpg"></P +></DIV +></DIV +> + </P +></LI +><LI +><P +> You should have a section with only + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> listed under + <SPAN +CLASS="QUOTE" +>"Actions:"</SPAN +>. + If not, click a <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Insert new section below</SPAN +>"</SPAN +> + button, and in the new section that just appeared, click the + <SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +> button right under the word <SPAN +CLASS="QUOTE" +>"Actions:"</SPAN +>. + This will bring up a list of all actions. Find + <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> near the top, and click + in the <SPAN +CLASS="QUOTE" +>"Enabled"</SPAN +> column, then <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Submit</SPAN +>"</SPAN +> + just below the list. + </P +></LI +><LI +><P +> Now, in the <TT +CLASS="LITERAL" +><A +HREF="actions-file.html#BLOCK" +>block</A +></TT +> actions section, + click the <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Add</SPAN +>"</SPAN +> button, and paste the URL the + browser got from <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIMENUITEM" +>Copy Link Location</SPAN +>"</SPAN +>. + Remove the <TT +CLASS="LITERAL" +>http://</TT +> at the beginning of the URL. Then, click + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>Submit</SPAN +>"</SPAN +> (or + <SPAN +CLASS="QUOTE" +>"<SPAN +CLASS="GUIBUTTON" +>OK</SPAN +>"</SPAN +> if in a pop-up window). + </P +></LI +><LI +><P +> Now go back to the original page, and press <B +CLASS="KEYCAP" +>SHIFT-Reload</B +> + (or flush all browser caches). The image should be gone now. + </P +></LI +></UL +></P +><P +> This is a very crude and simple example. There might be good reasons to use a + wildcard pattern match to include potentially similar images from the same + site. For a more extensive explanation of <SPAN +CLASS="QUOTE" +>"patterns"</SPAN +>, and + the entire actions concept, see <A +HREF="actions-file.html" +>the Actions + section</A +>.</P +><P +> For advanced users who want to hand edit their config files, you might want + to now go to the <A +HREF="actions-file.html#ACT-EXAMPLES" +>Actions Files Tutorial</A +>. + The ideas explained therein also apply to the web-based editor.</P +><P +> There are also various + <A +HREF="actions-file.html#FILTER" +>filters</A +> that can be used for ad blocking + (filters are a special subset of actions). These + fall into the <SPAN +CLASS="QUOTE" +>"advanced"</SPAN +> usage category, and are explained in + depth in later sections. </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="whatsnew.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="startup.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>What's New in this Release</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Starting Privoxy</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/seealso.html b/external/privoxy/doc/webserver/user-manual/seealso.html index 223f1ed..93a8b2d 100644 --- a/external/privoxy/doc/webserver/user-manual/seealso.html +++ b/external/privoxy/doc/webserver/user-manual/seealso.html @@ -1,208 +1,418 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>See Also</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Privoxy Copyright, License and History" href= - "copyright.html"> - <link rel="NEXT" title="Appendix" href="appendix.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href="copyright.html" - accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="appendix.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="SEEALSO" id="SEEALSO">13. See Also</a></h1> - - <p>Other references and sites of interest to <span class= - "APPLICATION">Privoxy</span> users:</p> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.privoxy.org/" target= - "_top">http://www.privoxy.org/</a>, the <span class= - "APPLICATION">Privoxy</span> Home page.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.privoxy.org/faq/" target= - "_top">http://www.privoxy.org/faq/</a>, the <span class= - "APPLICATION">Privoxy</span> FAQ.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.privoxy.org/developer-manual/" target= - "_top">http://www.privoxy.org/developer-manual/</a>, the - <span class="APPLICATION">Privoxy</span> developer manual.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="https://sourceforge.net/projects/ijbswa/" target= - "_top">https://sourceforge.net/projects/ijbswa/</a>, the Project - Page for <span class="APPLICATION">Privoxy</span> on <a href= - "http://sourceforge.net" target="_top">SourceForge</a>.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://config.privoxy.org/" target= - "_top">http://config.privoxy.org/</a>, the web-based user - interface. <span class="APPLICATION">Privoxy</span> must be running - for this to work. Shortcut: <a href="http://p.p/" target= - "_top">http://p.p/</a></td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href= - "https://sourceforge.net/tracker/?group_id=11118&atid=460288" - target= - "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>, - to submit <span class="QUOTE">"misses"</span> and other - configuration related suggestions to the developers.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.junkbusters.com/ht/en/cookies.html" target= - "_top">http://www.junkbusters.com/ht/en/cookies.html</a>, an - explanation how cookies are used to track web users.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.junkbusters.com/ijb.html" target= - "_top">http://www.junkbusters.com/ijb.html</a>, the original - Internet Junkbuster.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.squid-cache.org/" target= - "_top">http://www.squid-cache.org/</a>, a popular caching proxy, - which is often used together with <span class= - "APPLICATION">Privoxy</span>.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="http://www.pps.jussieu.fr/~jch/software/polipo/" - target="_top">http://www.pps.jussieu.fr/~jch/software/polipo/</a>, - <span class="APPLICATION">Polipo</span> is a caching proxy with - advanced features like pipelining, multiplexing and caching of - partial instances. In many setups it can be used as <span class= - "APPLICATION">Squid</span> replacement.</td> - </tr> - </tbody> - </table> - - <table border="0"> - <tbody> - <tr> - <td><a href="https://www.torproject.org/" target= - "_top">https://www.torproject.org/</a>, <span class= - "APPLICATION">Tor</span> can help anonymize web browsing, web - publishing, instant messaging, IRC, SSH, and other - applications.</td> - </tr> - </tbody> - </table> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="copyright.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="appendix.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Privoxy Copyright, License - and History</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Appendix</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>See Also</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Privoxy Copyright, License and History" +HREF="copyright.html"><LINK +REL="NEXT" +TITLE="Appendix" +HREF="appendix.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="copyright.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="appendix.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="SEEALSO" +>13. See Also</A +></H1 +><P +> Other references and sites of interest to <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + users:</P +><P +> <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/" +TARGET="_top" +>http://www.privoxy.org/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> Home page. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/faq/" +TARGET="_top" +>http://www.privoxy.org/faq/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> FAQ. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.privoxy.org/developer-manual/" +TARGET="_top" +>http://www.privoxy.org/developer-manual/</A +>, + the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> developer manual. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="https://sourceforge.net/projects/ijbswa/" +TARGET="_top" +>https://sourceforge.net/projects/ijbswa/</A +>, + the Project Page for <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> on + <A +HREF="http://sourceforge.net" +TARGET="_top" +>SourceForge</A +>. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>http://config.privoxy.org/</A +>, + the web-based user interface. <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> must be + running for this to work. Shortcut: <A +HREF="http://p.p/" +TARGET="_top" +>http://p.p/</A +> + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="https://sourceforge.net/tracker/?group_id=11118&atid=460288" +TARGET="_top" +>https://sourceforge.net/tracker/?group_id=11118&atid=460288</A +>, to submit <SPAN +CLASS="QUOTE" +>"misses"</SPAN +> and other + configuration related suggestions to the developers. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + + + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.junkbusters.com/ht/en/cookies.html" +TARGET="_top" +>http://www.junkbusters.com/ht/en/cookies.html</A +>, + an explanation how cookies are used to track web users. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.junkbusters.com/ijb.html" +TARGET="_top" +>http://www.junkbusters.com/ijb.html</A +>, + the original Internet Junkbuster. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.squid-cache.org/" +TARGET="_top" +>http://www.squid-cache.org/</A +>, a popular + caching proxy, which is often used together with <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="http://www.pps.jussieu.fr/~jch/software/polipo/" +TARGET="_top" +>http://www.pps.jussieu.fr/~jch/software/polipo/</A +>, + <SPAN +CLASS="APPLICATION" +>Polipo</SPAN +> is a caching proxy with advanced features + like pipelining, multiplexing and caching of partial instances. In many setups + it can be used as <SPAN +CLASS="APPLICATION" +>Squid</SPAN +> replacement. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + <P +></P +><TABLE +BORDER="0" +><TBODY +><TR +><TD +> <A +HREF="https://www.torproject.org/" +TARGET="_top" +>https://www.torproject.org/</A +>, + <SPAN +CLASS="APPLICATION" +>Tor</SPAN +> can help anonymize web browsing, + web publishing, instant messaging, IRC, SSH, and other applications. + </TD +></TR +></TBODY +></TABLE +><P +></P +> + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="copyright.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="appendix.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Privoxy Copyright, License and History</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Appendix</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/startup.html b/external/privoxy/doc/webserver/user-manual/startup.html index 9c9e944..e4f0c23 100644 --- a/external/privoxy/doc/webserver/user-manual/startup.html +++ b/external/privoxy/doc/webserver/user-manual/startup.html @@ -1,458 +1,902 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Starting Privoxy</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Quickstart to Using Privoxy" href= - "quickstart.html"> - <link rel="NEXT" title="Privoxy Configuration" href="configuration.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - table.c4 {background-color: #E0E0E0} - p.c3 {font-weight: bold} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "quickstart.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "configuration.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="STARTUP" id="STARTUP">5. Starting - Privoxy</a></h1> - - <p>Before launching <span class="APPLICATION">Privoxy</span> for the - first time, you will want to configure your browser(s) to use - <span class="APPLICATION">Privoxy</span> as a HTTP and HTTPS (SSL) - <a href="http://en.wikipedia.org/wiki/Proxy_server" target= - "_top">proxy</a>. The default is 127.0.0.1 (or localhost) for the proxy - address, and port 8118 (earlier versions used port 8000). This is the one - configuration step <span class="emphasis EMPHASIS c2">that must be - done</span>!</p> - - <p>Please note that <span class="APPLICATION">Privoxy</span> can only - proxy HTTP and HTTPS traffic. It will not work with FTP or other - protocols.</p> - - <div class="FIGURE"> - <a name="AEN899" id="AEN899"></a> - - <p class="c3">Figure 2. Proxy Configuration Showing Mozilla/Netscape - HTTP and HTTPS (SSL) Settings</p> - - <div class="MEDIAOBJECT"> - <p><img src="proxy_setup.jpg"></p> - </div> - </div> - - <p>With <span class="APPLICATION">Firefox</span>, this is typically set - under:</p> - - <p class="LITERALLAYOUT"> <span class= - "GUIBUTTON">Tools</span> -> <span class= - "GUIBUTTON">Options</span> -> <span class= - "GUIBUTTON">Advanced</span> -> <span class= - "GUIBUTTON">Network</span> -><span class= - "GUIBUTTON">Connection</span> -> <span class= - "GUIBUTTON">Settings</span><br></p> - - <p>Or optionally on some platforms:</p> - - <p class="LITERALLAYOUT"> <span class= - "GUIBUTTON">Edit</span> -> <span class= - "GUIBUTTON">Preferences</span> -> <span class= - "GUIBUTTON">General</span> -> <span class= - "GUIBUTTON">Connection Settings</span> -> <span class= - "GUIBUTTON">Manual Proxy Configuration</span><br></p> - - <p>With <span class="APPLICATION">Netscape</span> (and <span class= - "APPLICATION">Mozilla</span>), this can be set under:</p> - - <p class="LITERALLAYOUT"> <span class= - "GUIBUTTON">Edit</span> -> <span class= - "GUIBUTTON">Preferences</span> -> <span class= - "GUIBUTTON">Advanced</span> -> <span class= - "GUIBUTTON">Proxies</span> -> <span class="GUIBUTTON">HTTP - Proxy</span><br></p> - - <p>For <span class="APPLICATION">Internet Explorer v.5-7</span>:</p> - - <p class="LITERALLAYOUT"> <span class= - "GUIBUTTON">Tools</span> -> <span class="GUIBUTTON">Internet - Options</span> -> <span class= - "GUIBUTTON">Connections</span> -> <span class= - "GUIBUTTON">LAN Settings</span></p> - - <p>Then, check <span class="QUOTE">"Use Proxy"</span> and fill in the - appropriate info (Address: 127.0.0.1, Port: 8118). Include HTTPS (SSL), - if you want HTTPS proxy support too (sometimes labeled <span class= - "QUOTE">"Secure"</span>). Make sure any checkboxes like <span class= - "QUOTE">"Use the same proxy server for all protocols"</span> is - <span class="emphasis EMPHASIS c2">UNCHECKED</span>. You want only HTTP - and HTTPS (SSL)!</p> - - <div class="FIGURE"> - <a name="AEN944" id="AEN944"></a> - - <p class="c3">Figure 3. Proxy Configuration Showing Internet Explorer - HTTP and HTTPS (Secure) Settings</p> - - <div class="MEDIAOBJECT"> - <p><img src="proxy2.jpg"></p> - </div> - </div> - - <p>After doing this, flush your browser's disk and memory caches to force - a re-reading of all pages and to get rid of any ads that may be cached. - Remove any <a href="http://en.wikipedia.org/wiki/Browser_cookie" target= - "_top">cookies</a>, if you want <span class="APPLICATION">Privoxy</span> - to manage that. You are now ready to start enjoying the benefits of using - <span class="APPLICATION">Privoxy</span>!</p> - - <p><span class="APPLICATION">Privoxy</span> itself is typically started - by specifying the main configuration file to be used on the command line. - If no configuration file is specified on the command line, <span class= - "APPLICATION">Privoxy</span> will look for a file named <tt class= - "FILENAME">config</tt> in the current directory. Except on Win32 where it - will try <tt class="FILENAME">config.txt</tt>.</p> - - <div class="SECT2"> - <h2 class="SECT2"><a name="START-REDHAT" id="START-REDHAT">5.1. Red Hat - and Fedora</a></h2> - - <p>A default Red Hat installation may not start <span class= - "APPLICATION">Privoxy</span> upon boot. It will use the file <tt class= - "FILENAME">/etc/privoxy/config</tt> as its main configuration file.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - # /etc/rc.d/init.d/privoxy start -</pre> - </td> - </tr> - </table> - - <p>Or ...</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - # service privoxy start -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="START-DEBIAN" id="START-DEBIAN">5.2. - Debian</a></h2> - - <p>We use a script. Note that Debian typically starts <span class= - "APPLICATION">Privoxy</span> upon booting per default. It will use the - file <tt class="FILENAME">/etc/privoxy/config</tt> as its main - configuration file.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - # /etc/init.d/privoxy start -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="START-WINDOWS" id="START-WINDOWS">5.3. - Windows</a></h2> - - <p>Click on the <span class="APPLICATION">Privoxy</span> Icon to start - <span class="APPLICATION">Privoxy</span>. If no configuration file is - specified on the command line, <span class="APPLICATION">Privoxy</span> - will look for a file named <tt class="FILENAME">config.txt</tt>. Note - that Windows will automatically start <span class= - "APPLICATION">Privoxy</span> when the system starts if you chose that - option when installing.</p> - - <p><span class="APPLICATION">Privoxy</span> can run with full Windows - service functionality. On Windows only, the <span class= - "APPLICATION">Privoxy</span> program has two new command line arguments - to install and uninstall <span class="APPLICATION">Privoxy</span> as a - service. See the <a href= - "installation.html#INSTALLATION-PACK-WIN">Windows Installation - instructions</a> for details.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="START-UNICES" id="START-UNICES">5.4. - Solaris, NetBSD, FreeBSD, HP-UX and others</a></h2> - - <p>Example Unix startup command:</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - # /usr/sbin/privoxy /etc/privoxy/config -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="START-OS2" id="START-OS2">5.5. OS/2</a></h2> - - <p>During installation, <span class="APPLICATION">Privoxy</span> is - configured to start automatically when the system restarts. You can - start it manually by double-clicking on the <span class= - "APPLICATION">Privoxy</span> icon in the <span class= - "APPLICATION">Privoxy</span> folder.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="START-MACOSX" id="START-MACOSX">5.6. Mac OS - X</a></h2> - - <p>After downloading the privoxy software, unzip the downloaded file by - double-clicking on the zip file icon. Then, double-click on the - installer package icon and follow the installation process.</p> - - <p>The privoxy service will automatically start after a successful - installation. In addition, the privoxy service will automatically start - every time your computer starts up.</p> - - <p>To prevent the privoxy service from automatically starting when your - computer starts up, remove or rename the folder named - /Library/StartupItems/Privoxy.</p> - - <p>A simple application named Privoxy Utility has been created which - enables administrators to easily start and stop the privoxy - service.</p> - - <p>In addition, the Privoxy Utility presents a simple way for - administrators to edit the various privoxy config files. A method to - uninstall the software is also available.</p> - - <p>An administrator username and password must be supplied in order for - the Privoxy Utility to perform any of the tasks.</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="START-AMIGAOS" id="START-AMIGAOS">5.7. - AmigaOS</a></h2> - - <p>Start <span class="APPLICATION">Privoxy</span> (with RUN - <>NIL:) in your <tt class="FILENAME">startnet</tt> script - (AmiTCP), in <tt class="FILENAME">s:user-startup</tt> (RoadShow), as - startup program in your startup script (Genesis), or as startup action - (Miami and MiamiDx). <span class="APPLICATION">Privoxy</span> will - automatically quit when you quit your TCP/IP stack (just ignore the - harmless warning your TCP/IP stack may display that <span class= - "APPLICATION">Privoxy</span> is still running).</p> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="START-GENTOO" id="START-GENTOO">5.8. - Gentoo</a></h2> - - <p>A script is again used. It will use the file <tt class= - "FILENAME">/etc/privoxy/config</tt> as its main configuration file.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - /etc/init.d/privoxy start - -</pre> - </td> - </tr> - </table> - - <p>Note that <span class="APPLICATION">Privoxy</span> is not - automatically started at boot time by default. You can change this with - the <tt class="LITERAL">rc-update</tt> command.</p> - - <table class="c4" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> - rc-update add privoxy default - -</pre> - </td> - </tr> - </table> - </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="CMDOPTIONS" id="CMDOPTIONS">5.9. Command - Line Options</a></h2> - - <p><span class="APPLICATION">Privoxy</span> may be invoked with the - following command-line options:</p> - - <ul> - <li> - <p><span class="emphasis EMPHASIS c2">--version</span></p> - - <p>Print version info and exit. Unix only.</p> - </li> - - <li> - <p><span class="emphasis EMPHASIS c2">--help</span></p> - - <p>Print short usage info and exit. Unix only.</p> - </li> - - <li> - <p><span class="emphasis EMPHASIS c2">--no-daemon</span></p> - - <p>Don't become a daemon, i.e. don't fork and become process group - leader, and don't detach from controlling tty. Unix only.</p> - </li> - - <li> - <p><span class="emphasis EMPHASIS c2">--pidfile FILE</span></p> - - <p>On startup, write the process ID to <span class= - "emphasis EMPHASIS c2">FILE</span>. Delete the <span class= - "emphasis EMPHASIS c2">FILE</span> on exit. Failure to create or - delete the <span class="emphasis EMPHASIS c2">FILE</span> is - non-fatal. If no <span class="emphasis EMPHASIS c2">FILE</span> - option is given, no PID file will be used. Unix only.</p> - </li> - - <li> - <p><span class="emphasis EMPHASIS c2">--user - USER[.GROUP]</span></p> - - <p>After (optionally) writing the PID file, assume the user ID of - <span class="emphasis EMPHASIS c2">USER</span>, and if included the - GID of GROUP. Exit if the privileges are not sufficient to do so. - Unix only.</p> - </li> - - <li> - <p><span class="emphasis EMPHASIS c2">--chroot</span></p> - - <p>Before changing to the user ID given in the <span class= - "emphasis EMPHASIS c2">--user</span> option, chroot to that user's - home directory, i.e. make the kernel pretend to the <span class= - "APPLICATION">Privoxy</span> process that the directory tree starts - there. If set up carefully, this can limit the impact of possible - vulnerabilities in <span class="APPLICATION">Privoxy</span> to the - files contained in that hierarchy. Unix only.</p> - </li> - - <li> - <p><span class="emphasis EMPHASIS c2">--pre-chroot-nslookup - hostname</span></p> - - <p>Specifies a hostname to look up before doing a chroot. On some - systems, initializing the resolver library involves reading config - files from /etc and/or loading additional shared libraries from - /lib. On these systems, doing a hostname lookup before the chroot - reduces the number of files that must be copied into the chroot - tree.</p> - - <p>For fastest startup speed, a good value is a hostname that is - not in /etc/hosts but that your local name server (listed in - /etc/resolv.conf) can resolve without recursion (that is, without - having to ask any other name servers). The hostname need not exist, - but if it doesn't, an error message (which can be ignored) will be - output.</p> - </li> - - <li> - <p><span class="emphasis EMPHASIS c2">configfile</span></p> - - <p>If no <span class="emphasis EMPHASIS c2">configfile</span> is - included on the command line, <span class= - "APPLICATION">Privoxy</span> will look for a file named - <span class="QUOTE">"config"</span> in the current directory - (except on Win32 where it will look for <span class= - "QUOTE">"config.txt"</span> instead). Specify full path to avoid - confusion. If no config file is found, <span class= - "APPLICATION">Privoxy</span> will fail to start.</p> - </li> - </ul> - - <p>On <span class="APPLICATION">MS Windows</span> only there are two - additional command-line options to allow <span class= - "APPLICATION">Privoxy</span> to install and run as a <span class= - "emphasis EMPHASIS c2">service</span>. See the <a href= - "installation.html#INSTALLATION-PACK-WIN">Window Installation - section</a> for details.</p> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="quickstart.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href= - "configuration.html" accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Quickstart to Using - Privoxy</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Privoxy Configuration</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Starting Privoxy</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Quickstart to Using Privoxy" +HREF="quickstart.html"><LINK +REL="NEXT" +TITLE="Privoxy Configuration" +HREF="configuration.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="quickstart.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="configuration.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="STARTUP" +>5. Starting Privoxy</A +></H1 +><P +> Before launching <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> for the first time, you + will want to configure your browser(s) to use + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> as a HTTP and HTTPS (SSL) + <A +HREF="http://en.wikipedia.org/wiki/Proxy_server" +TARGET="_top" +>proxy</A +>. The default is + 127.0.0.1 (or localhost) for the proxy address, and port 8118 (earlier versions + used port 8000). This is the one configuration step <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>that must be done</I +></SPAN +>!</P +><P +> Please note that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can only proxy HTTP and + HTTPS traffic. It will not work with FTP or other protocols.</P +><P +> <DIV +CLASS="FIGURE" +><A +NAME="AEN585" +></A +><P +><B +>Figure 2. Proxy Configuration Showing + Mozilla/Netscape HTTP and HTTPS (SSL) Settings</B +></P +><DIV +CLASS="MEDIAOBJECT" +><P +><IMG +SRC="proxy_setup.jpg"></P +></DIV +></DIV +> + </P +><P +> + With <SPAN +CLASS="APPLICATION" +>Firefox</SPAN +>, this is typically set under:</P +><P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="GUIBUTTON" +>Tools</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Options</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Advanced</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Network</SPAN +> -><SPAN +CLASS="GUIBUTTON" +>Connection</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Settings</SPAN +><br> </P +><P +> + Or optionally on some platforms:</P +><P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Preferences</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>General</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Connection Settings</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Manual Proxy Configuration</SPAN +><br> </P +><P +> + With <SPAN +CLASS="APPLICATION" +>Netscape</SPAN +> (and + <SPAN +CLASS="APPLICATION" +>Mozilla</SPAN +>), this can be set under:</P +><P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="GUIBUTTON" +>Edit</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Preferences</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Advanced</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Proxies</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>HTTP Proxy</SPAN +><br> </P +><P +> For <SPAN +CLASS="APPLICATION" +>Internet Explorer v.5-7</SPAN +>: </P +><P +CLASS="LITERALLAYOUT" +> <SPAN +CLASS="GUIBUTTON" +>Tools</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Internet Options</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>Connections</SPAN +> -> <SPAN +CLASS="GUIBUTTON" +>LAN Settings</SPAN +></P +><P +> Then, check <SPAN +CLASS="QUOTE" +>"Use Proxy"</SPAN +> and fill in the appropriate info + (Address: 127.0.0.1, Port: 8118). Include HTTPS (SSL), if you want HTTPS + proxy support too (sometimes labeled <SPAN +CLASS="QUOTE" +>"Secure"</SPAN +>). Make sure any + checkboxes like <SPAN +CLASS="QUOTE" +>"Use the same proxy server for all protocols"</SPAN +> is + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>UNCHECKED</I +></SPAN +>. You want only HTTP and HTTPS (SSL)!</P +><P +> <DIV +CLASS="FIGURE" +><A +NAME="AEN630" +></A +><P +><B +>Figure 3. Proxy Configuration Showing + Internet Explorer HTTP and HTTPS (Secure) Settings</B +></P +><DIV +CLASS="MEDIAOBJECT" +><P +><IMG +SRC="proxy2.jpg"></P +></DIV +></DIV +> + </P +><P +> After doing this, flush your browser's disk and memory caches to force a + re-reading of all pages and to get rid of any ads that may be cached. Remove + any <A +HREF="http://en.wikipedia.org/wiki/Browser_cookie" +TARGET="_top" +>cookies</A +>, + if you want <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to manage that. You are now + ready to start enjoying the benefits of using + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>!</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> itself is typically started by specifying the + main configuration file to be used on the command line. If no configuration + file is specified on the command line, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + will look for a file named <TT +CLASS="FILENAME" +>config</TT +> in the current + directory. Except on Win32 where it will try <TT +CLASS="FILENAME" +>config.txt</TT +>.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="START-REDHAT" +>5.1. Red Hat and Fedora</A +></H2 +><P +> A default Red Hat installation may not start <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> upon boot. It will use + the file <TT +CLASS="FILENAME" +>/etc/privoxy/config</TT +> as its main configuration + file.</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> # /etc/rc.d/init.d/privoxy start</PRE +></TD +></TR +></TABLE +></P +><P +> Or ...</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> # service privoxy start</PRE +></TD +></TR +></TABLE +></P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="START-DEBIAN" +>5.2. Debian</A +></H2 +><P +> We use a script. Note that Debian typically starts <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> upon booting per + default. It will use the file + <TT +CLASS="FILENAME" +>/etc/privoxy/config</TT +> as its main configuration + file.</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> # /etc/init.d/privoxy start</PRE +></TD +></TR +></TABLE +></P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="START-WINDOWS" +>5.3. Windows</A +></H2 +><P +>Click on the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> Icon to start <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>. If no configuration file is + specified on the command line, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will look + for a file named <TT +CLASS="FILENAME" +>config.txt</TT +>. Note that Windows will + automatically start <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> when the system starts if you chose that option + when installing.</P +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> can run with full Windows service functionality. + On Windows only, the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> program has two new command line arguments + to install and uninstall <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> as a service. See the + <A +HREF="installation.html#INSTALLATION-PACK-WIN" +>Windows Installation + instructions</A +> for details.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="START-UNICES" +>5.4. Solaris, NetBSD, FreeBSD, HP-UX and others</A +></H2 +><P +>Example Unix startup command:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> # /usr/sbin/privoxy /etc/privoxy/config</PRE +></TD +></TR +></TABLE +></P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="START-OS2" +>5.5. OS/2</A +></H2 +><P +> During installation, <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is configured to + start automatically when the system restarts. You can start it manually by + double-clicking on the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> icon in the + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> folder.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="START-MACOSX" +>5.6. Mac OS X</A +></H2 +><P +> After downloading the privoxy software, unzip the downloaded file by + double-clicking on the zip file icon. Then, double-click on the + installer package icon and follow the installation process.</P +><P +> The privoxy service will automatically start after a successful + installation. In addition, the privoxy service will automatically + start every time your computer starts up.</P +><P +> To prevent the privoxy service from automatically starting when your + computer starts up, remove or rename the folder named + /Library/StartupItems/Privoxy.</P +><P +> A simple application named Privoxy Utility has been created which + enables administrators to easily start and stop the privoxy service.</P +><P +> In addition, the Privoxy Utility presents a simple way for + administrators to edit the various privoxy config files. A method + to uninstall the software is also available.</P +><P +> An administrator username and password must be supplied in order for + the Privoxy Utility to perform any of the tasks.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="START-AMIGAOS" +>5.7. AmigaOS</A +></H2 +><P +> Start <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> (with RUN <>NIL:) in your + <TT +CLASS="FILENAME" +>startnet</TT +> script (AmiTCP), in + <TT +CLASS="FILENAME" +>s:user-startup</TT +> (RoadShow), as startup program in your + startup script (Genesis), or as startup action (Miami and MiamiDx). + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will automatically quit when you quit your + TCP/IP stack (just ignore the harmless warning your TCP/IP stack may display that + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is still running).</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="START-GENTOO" +>5.8. Gentoo</A +></H2 +><P +> A script is again used. It will use the file <TT +CLASS="FILENAME" +>/etc/privoxy/config + </TT +> as its main configuration file.</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> /etc/init.d/privoxy start + </PRE +></TD +></TR +></TABLE +></P +><P +> Note that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is not automatically started at + boot time by default. You can change this with the <TT +CLASS="LITERAL" +>rc-update</TT +> + command.</P +><P +> + <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +> rc-update add privoxy default + </PRE +></TD +></TR +></TABLE +></P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="CMDOPTIONS" +>5.9. Command Line Options</A +></H2 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> may be invoked with the following + command-line options:</P +><P +> <P +></P +><UL +><LI +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--version</I +></SPAN +> + </P +><P +> Print version info and exit. Unix only. + </P +></LI +><LI +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--help</I +></SPAN +> + </P +><P +> Print short usage info and exit. Unix only. + </P +></LI +><LI +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--no-daemon</I +></SPAN +> + </P +><P +> Don't become a daemon, i.e. don't fork and become process group + leader, and don't detach from controlling tty. Unix only. + </P +></LI +><LI +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--pidfile FILE</I +></SPAN +> + </P +><P +> On startup, write the process ID to <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>FILE</I +></SPAN +>. Delete the + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>FILE</I +></SPAN +> on exit. Failure to create or delete the + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>FILE</I +></SPAN +> is non-fatal. If no <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>FILE</I +></SPAN +> + option is given, no PID file will be used. Unix only. + </P +></LI +><LI +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--user USER[.GROUP]</I +></SPAN +> + </P +><P +> After (optionally) writing the PID file, assume the user ID of + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>USER</I +></SPAN +>, and if included the GID of GROUP. Exit if the + privileges are not sufficient to do so. Unix only. + </P +></LI +><LI +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--chroot</I +></SPAN +> + </P +><P +> Before changing to the user ID given in the <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--user</I +></SPAN +> option, + chroot to that user's home directory, i.e. make the kernel pretend to the <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + process that the directory tree starts there. If set up carefully, this can limit + the impact of possible vulnerabilities in <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to the files contained in that hierarchy. + Unix only. + </P +></LI +><LI +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>--pre-chroot-nslookup hostname</I +></SPAN +> + </P +><P +> Specifies a hostname to look up before doing a chroot. On some systems, initializing the + resolver library involves reading config files from /etc and/or loading additional shared + libraries from /lib. On these systems, doing a hostname lookup before the chroot reduces + the number of files that must be copied into the chroot tree. + </P +><P +> For fastest startup speed, a good value is a hostname that is not in /etc/hosts but that + your local name server (listed in /etc/resolv.conf) can resolve without recursion + (that is, without having to ask any other name servers). The hostname need not exist, + but if it doesn't, an error message (which can be ignored) will be output. + </P +></LI +><LI +><P +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>configfile</I +></SPAN +> + </P +><P +> If no <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>configfile</I +></SPAN +> is included on the command line, + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will look for a file named + <SPAN +CLASS="QUOTE" +>"config"</SPAN +> in the current directory (except on Win32 + where it will look for <SPAN +CLASS="QUOTE" +>"config.txt"</SPAN +> instead). Specify + full path to avoid confusion. If no config file is found, + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> will fail to start. + </P +></LI +></UL +></P +><P +> On <SPAN +CLASS="APPLICATION" +>MS Windows</SPAN +> only there are two additional + command-line options to allow <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> to install and + run as a <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>service</I +></SPAN +>. See the +<A +HREF="installation.html#INSTALLATION-PACK-WIN" +>Window Installation section</A +> +for details.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="quickstart.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="configuration.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Quickstart to Using Privoxy</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Privoxy Configuration</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/templates.html b/external/privoxy/doc/webserver/user-manual/templates.html index 39dac40..7e31c75 100644 --- a/external/privoxy/doc/webserver/user-manual/templates.html +++ b/external/privoxy/doc/webserver/user-manual/templates.html @@ -1,172 +1,321 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>Privoxy's Template Files</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Filter Files" href="filter-file.html"> - <link rel="NEXT" title= - "Contacting the Developers, Bug Reporting and Feature Requests" href= - "contact.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - table.c3 {background-color: #E0E0E0} - span.c2 {font-style: italic} - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "filter-file.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href="contact.html" - accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="TEMPLATES" id="TEMPLATES">10. Privoxy's - Template Files</a></h1> - - <p>All <span class="APPLICATION">Privoxy</span> built-in pages, i.e. - error pages such as the <a href="http://show-the-404-error.page" target= - "_top"><span class="QUOTE">"404 - No Such Domain"</span> error page</a>, - the <a href="http://ads.bannerserver.example.com/nasty-ads/sponsor.html" - target="_top"><span class="QUOTE">"BLOCKED"</span> page</a> and all pages - of its <a href="http://config.privoxy.org/" target="_top">web-based user - interface</a>, are generated from <span class= - "emphasis EMPHASIS c2">templates</span>. (<span class= - "APPLICATION">Privoxy</span> must be running for the above links to work - as intended.)</p> - - <p>These templates are stored in a subdirectory of the <a href= - "config.html#CONFDIR">configuration directory</a> called <tt class= - "FILENAME">templates</tt>. On Unixish platforms, this is typically - <a href="file:///etc/privoxy/templates/" target="_top"><tt class= - "FILENAME">/etc/privoxy/templates/</tt></a>.</p> - - <p>The templates are basically normal HTML files, but with place-holders - (called symbols or exports), which <span class= - "APPLICATION">Privoxy</span> fills at run time. It is possible to edit - the templates with a normal text editor, should you want to customize - them. (<span class="emphasis EMPHASIS c2">Not recommended for the casual - user</span>). Should you create your own custom templates, you should use - the <tt class="FILENAME">config</tt> setting <a href= - "config.html#TEMPLDIR">templdir</a> to specify an alternate location, so - your templates do not get overwritten during upgrades.</p> - - <p>Note that just like in configuration files, lines starting with - <tt class="LITERAL">#</tt> are ignored when the templates are filled - in.</p> - - <p>The place-holders are of the form <tt class="LITERAL">@name@</tt>, and - you will find a list of available symbols, which vary from template to - template, in the comments at the start of each file. Note that these - comments are not always accurate, and that it's probably best to look at - the existing HTML code to find out which symbols are supported and what - they are filled in with.</p> - - <p>A special application of this substitution mechanism is to make whole - blocks of HTML code disappear when a specific symbol is set. We use this - for many purposes, one of them being to include the beta warning in all - our user interface (CGI) pages when <span class= - "APPLICATION">Privoxy</span> is in an alpha or beta development - stage:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -<!-- @if-unstable-start --> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Privoxy's Template Files</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Filter Files" +HREF="filter-file.html"><LINK +REL="NEXT" +TITLE="Contacting the Developers, Bug Reporting and Feature +Requests" +HREF="contact.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="filter-file.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="contact.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="TEMPLATES" +>10. Privoxy's Template Files</A +></H1 +><P +> All <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> built-in pages, i.e. error pages such as the + <A +HREF="http://show-the-404-error.page" +TARGET="_top" +><SPAN +CLASS="QUOTE" +>"404 - No Such Domain"</SPAN +> + error page</A +>, the <A +HREF="http://ads.bannerserver.example.com/nasty-ads/sponsor.html" +TARGET="_top" +><SPAN +CLASS="QUOTE" +>"BLOCKED"</SPAN +> + page</A +> + and all pages of its <A +HREF="http://config.privoxy.org/" +TARGET="_top" +>web-based + user interface</A +>, are generated from <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>templates</I +></SPAN +>. + (<SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> must be running for the above links to work as + intended.)</P +><P +> These templates are stored in a subdirectory of the <A +HREF="config.html#CONFDIR" +>configuration + directory</A +> called <TT +CLASS="FILENAME" +>templates</TT +>. On Unixish platforms, + this is typically + <A +HREF="file:///etc/privoxy/templates/" +TARGET="_top" +><TT +CLASS="FILENAME" +>/etc/privoxy/templates/</TT +></A +>.</P +><P +> The templates are basically normal HTML files, but with place-holders (called symbols + or exports), which <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> fills at run time. It + is possible to edit the templates with a normal text editor, should you want + to customize them. (<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Not recommended for the casual + user</I +></SPAN +>). Should you create your own custom templates, you should use + the <TT +CLASS="FILENAME" +>config</TT +> setting <A +HREF="config.html#TEMPLDIR" +>templdir</A +> + to specify an alternate location, so your templates do not get overwritten + during upgrades. + </P +><P +> Note that just like in configuration files, lines starting + with <TT +CLASS="LITERAL" +>#</TT +> are ignored when the templates are filled in.</P +><P +> The place-holders are of the form <TT +CLASS="LITERAL" +>@name@</TT +>, and you will + find a list of available symbols, which vary from template to template, + in the comments at the start of each file. Note that these comments are not + always accurate, and that it's probably best to look at the existing HTML + code to find out which symbols are supported and what they are filled in with.</P +><P +> A special application of this substitution mechanism is to make whole + blocks of HTML code disappear when a specific symbol is set. We use this + for many purposes, one of them being to include the beta warning in all + our user interface (CGI) pages when <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + is in an alpha or beta development stage:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +><!-- @if-unstable-start -->
... beta warning HTML code goes here ...
-<!-- if-unstable-end@ --> -</pre> - </td> - </tr> - </table> - - <p>If the "unstable" symbol is set, everything in between and including - <tt class="LITERAL">@if-unstable-start</tt> and <tt class= - "LITERAL">if-unstable-end@</tt> will disappear, leaving nothing but an - empty comment:</p> - - <table class="c3" border="0" width="100%"> - <tr> - <td> - <pre class="SCREEN"> -<!-- --> -</pre> - </td> - </tr> - </table> - - <p>There's also an if-then-else construct and an <tt class= - "LITERAL">#include</tt> mechanism, but you'll sure find out if you are - inclined to edit the templates ;-)</p> - - <p>All templates refer to a style located at <a href= - "http://config.privoxy.org/send-stylesheet" target="_top"><tt class= - "LITERAL">http://config.privoxy.org/send-stylesheet</tt></a>. This is, of - course, locally served by <span class="APPLICATION">Privoxy</span> and - the source for it can be found and edited in the <tt class= - "FILENAME">cgi-style.css</tt> template.</p> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="filter-file.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="contact.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Filter Files</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Contacting the Developers, - Bug Reporting and Feature Requests</td> - </tr> - </table> - </div> -</body> -</html> +<!-- if-unstable-end@ --></PRE +></TD +></TR +></TABLE +></P +><P +> If the "unstable" symbol is set, everything in between and including + <TT +CLASS="LITERAL" +>@if-unstable-start</TT +> and <TT +CLASS="LITERAL" +>if-unstable-end@</TT +> + will disappear, leaving nothing but an empty comment:</P +><P +> <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="SCREEN" +><!-- --></PRE +></TD +></TR +></TABLE +></P +><P +> There's also an if-then-else construct and an <TT +CLASS="LITERAL" +>#include</TT +> + mechanism, but you'll sure find out if you are inclined to edit the + templates ;-)</P +><P +> All templates refer to a style located at + <A +HREF="http://config.privoxy.org/send-stylesheet" +TARGET="_top" +><TT +CLASS="LITERAL" +>http://config.privoxy.org/send-stylesheet</TT +></A +>. + This is, of course, locally served by <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + and the source for it can be found and edited in the + <TT +CLASS="FILENAME" +>cgi-style.css</TT +> template.</P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="filter-file.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="contact.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Filter Files</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Contacting the Developers, Bug Reporting and Feature +Requests</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/doc/webserver/user-manual/whatsnew.html b/external/privoxy/doc/webserver/user-manual/whatsnew.html index 03730aa..5d7c0b2 100644 --- a/external/privoxy/doc/webserver/user-manual/whatsnew.html +++ b/external/privoxy/doc/webserver/user-manual/whatsnew.html @@ -1,1060 +1,351 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> - -<html> -<head> - <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org"> - - <title>What's New in this Release</title> - <meta name="GENERATOR" content= - "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.19 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Installation" href="installation.html"> - <link rel="NEXT" title="Quickstart to Using Privoxy" href= - "quickstart.html"> - <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> - <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> - <link rel="STYLESHEET" type="text/css" href="p_doc.css"> - <style type="text/css"> -body { - background-color: #EEEEEE; - color: #000000; - } - :link { color: #0000FF } - :visited { color: #840084 } - :active { color: #0000FF } - hr.c1 {text-align: left} - </style> -</head> - -<body class="SECT1"> - <div class="NAVHEADER"> - <table summary="Header navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <th colspan="3" align="center">Privoxy 3.0.19 User Manual</th> - </tr> - - <tr> - <td width="10%" align="left" valign="bottom"><a href= - "installation.html" accesskey="P">Prev</a></td> - - <td width="80%" align="center" valign="bottom"></td> - - <td width="10%" align="right" valign="bottom"><a href= - "quickstart.html" accesskey="N">Next</a></td> - </tr> - </table> - <hr class="c1" width="100%"> - </div> - - <div class="SECT1"> - <h1 class="SECT1"><a name="WHATSNEW" id="WHATSNEW">3. What's New in this - Release</a></h1> - - <p><span class="APPLICATION">Privoxy 3.0.19</span> is a stable release. - The changes since 3.0.18 stable are:</p> - - <ul> - <li> - <p>Bug fixes:</p> - - <ul> - <li> - <p>Prevent a segmentation fault when de-chunking buffered - content. It could be triggered by malicious web servers if - Privoxy was configured to filter the content and running on a - platform where SIZE_T_MAX isn't larger than UINT_MAX, which - probably includes most 32-bit systems. On those platforms, all - Privoxy versions before 3.0.19 appear to be affected. To be on - the safe side, this bug should be presumed to allow code - execution as proving that it doesn't seems unrealistic.</p> - </li> - - <li> - <p>Do not expect a response from the SOCKS4/4A server until it - got something to respond to. This regression was introduced in - 3.0.18 and prevented the SOCKS4/4A negotiation from working. - Reported by qqqqqw in #3459781.</p> - </li> - </ul> - </li> - - <li> - <p>General improvements:</p> - - <ul> - <li> - <p>Fix an off-by-one in an error message about connect - failures.</p> - </li> - - <li> - <p>Use a GNUMakefile variable for the webserver root directory - and update the path. Sourceforge changed it which broke various - web-related targets.</p> - </li> - - <li> - <p>Update the CODE_STATUS description.</p> - </li> - </ul> - </li> - </ul> - - <p>The following changes were made between 3.0.17 and 3.0.18:</p> - - <ul> - <li> - <p>Bug fixes:</p> - - <ul> - <li> - <p>If a generated redirect URL contains characters RFC 3986 - doesn't permit, they are (re)encoded. Not doing this makes - Privoxy versions from 3.0.5 to 3.0.17 susceptible to HTTP - response splitting (CWE-113) attacks if the - +fast-redirects{check-decoded-url} action is used.</p> - </li> - - <li> - <p>Fix a logic bug that could cause Privoxy to reuse a server - socket after it got tainted by a server-header-tagger-induced - block that was triggered before the whole server response had - been read. If keep-alive was enabled and the request following - the blocked one was to the same host and using the same - forwarding settings, Privoxy would send it on the tainted server - socket. While the server would simply treat it as a pipelined - request, Privoxy would later on fail to properly parse the - server's response as it would try to parse the unread data from - the first response as server headers for the second one. - Regression introduced in 3.0.17.</p> - </li> - - <li> - <p>When implying keep-alive in client_connection(), remember that - the client didn't. Fixes a regression introduced in 3.0.13 that - would cause Privoxy to wait for additional client requests after - receiving a HTTP/1.1 request with "Connection: close" set and - connection sharing enabled. With clients which terminates the - client connection after detecting that the whole body has been - received it doesn't really matter, but with clients that don't - the connection would be kept open until it timed out.</p> - </li> - - <li> - <p>Fix a subtle race condition between - prepare_csp_for_next_request() and sweep(). A thread preparing - itself for the next client request could briefly appear to be - inactive. If all other threads were already using more recent - files, the thread could get its files swept away under its feet. - So far this has only been reproduced while stress testing in - valgrind while touching action files in a loop. It's unlikely to - have caused any actual problems in the real world.</p> - </li> - - <li> - <p>Disable filters if SDCH compression is used unless filtering - is forced. If SDCH was combined with a supported compression - algorithm, Privoxy previously could try to decompress it and - ditch the Content-Encoding header even though the SDCH - compression wasn't dealt with. Reported by zebul666 in - #3225863.</p> - </li> - - <li> - <p>Make a copy of the --user value and only mess with that when - splitting user and group. On some operating systems modifying the - value directly is reflected in the output of ps and friends and - can be misleading. Reported by zepard in #3292710.</p> - </li> - - <li> - <p>If forwarded-connect-retries is set, only retry if Privoxy is - actually forwarding the request. Previously direct connections - would be retried as well.</p> - </li> - - <li> - <p>Fixed a small memory leak when retrying connections with IPv6 - support enabled.</p> - </li> - - <li> - <p>Remove an incorrect assertion in - compile_dynamic_pcrs_job_list() It could be triggered by a pcrs - job with an invalid pcre pattern (for example one that contains a - lone quantifier).</p> - </li> - - <li> - <p>If the --user argument user[.group] contains a dot, always - bail out if no group has been specified. Previously the intended, - but undocumented (and apparently untested), behaviour was to try - interpreting the whole argument as user name, but the detection - was flawed and checked for '0' instead of '\0', thus merely - preventing group names beginning with a zero.</p> - </li> - - <li> - <p>In html_code_map[], use a numeric character reference instead - of ' which wasn't standardized before XHTML 1.0.</p> - </li> - - <li> - <p>Fix an invalid free when compiled with - FEATURE_GRACEFUL_TERMINATION and shut down through - http://config.privoxy.org/die</p> - </li> - - <li> - <p>In get_actions(), fix the "temporary" backwards compatibility - hack to accept block actions without reason. It also covered - other actions that should be rejected as invalid. Reported by - Billy Crook.</p> - </li> - </ul> - </li> - - <li> - <p>General improvements:</p> - - <ul> - <li> - <p>Privoxy can (re)compress buffered content before delivering it - to the client. Disabled by default as most users wouldn't benefit - from it.</p> - </li> - - <li> - <p>The +fast-redirects{check-decoded-url} action checks URL - segments separately. If there are other parameters behind the - redirect URL, this makes it unnecessary to cut them off by - additionally using a +redirect{} pcrs command. Initial patch - submitted by Jamie Zawinski in #3429848.</p> - </li> - - <li> - <p>When loading action sections, verify that the referenced - filters exist. Currently missing filters only result in an error - message, but eventually the severity will be upgraded to - fatal.</p> - </li> - - <li> - <p>Allow to bind to multiple separate addresses. Patch set - submitted by Petr Pisar in #3354485.</p> - </li> - - <li> - <p>Set socket_error to errno if connecting fails in - rfc2553_connect_to(). Previously rejected direct connections - could be incorrectly reported as DNS issues if Privoxy was - compiled with IPv6 support.</p> - </li> - - <li> - <p>Adjust url_code_map[] so spaces are replaced with %20 instead - of '+' While '+' can be used by client's submitting form data, - this is not actually what Privoxy is using the lookups for. This - is more of a cosmetic issue and doesn't fix any known - problems.</p> - </li> - - <li> - <p>When compiled without FEATURE_FAST_REDIRECTS, do not silently - ignore +fast-redirect{} directives</p> - </li> - - <li> - <p>Added a workaround for GNU libc's strptime() reporting - negative year values when the parsed year is only specified with - two digits. On affected systems cookies with such a date would - not be turned into session cookies by the +session-cookies-only - action. Reported by Vaeinoe in #3403560</p> - </li> - - <li> - <p>Fixed bind failures with certain GNU libc versions if no - non-loopback IP address has been configured on the system. This - is mainly an issue if the system is using DHCP and Privoxy is - started before the network is completely configured. Reported by - Raphael Marichez in #3349356. Additional insight from Petr - Pisar.</p> - </li> - - <li> - <p>Privoxy log messages now use the ISO 8601 date format - %Y-%m-%d. It's only slightly longer than the old format, but - contains the full date including the year and allows sorting by - date (when grepping in multiple log files) without hassle.</p> - </li> - - <li> - <p>In get_last_url(), do not bother trying to decode URLs that do - not contain at least one '%' sign. It reduces the log noise and a - number of unnecessary memory allocations.</p> - </li> - - <li> - <p>In case of SOCKS5 failures, dump the socks response in the log - message.</p> - </li> - - <li> - <p>Simplify the signal setup in main().</p> - </li> - - <li> - <p>Streamline socks5_connect() slightly.</p> - </li> - - <li> - <p>In socks5_connect(), require a complete socks response from - the server. Previously Privoxy didn't care how much data the - server response contained as long as the first two bytes - contained the expected values. While at it, shrink the buffer - size so Privoxy can't read more than a whole socks response.</p> - </li> - - <li> - <p>In chat(), do not bother to generate a client request in case - of direct CONNECT requests. It will not be used anyway.</p> - </li> - - <li> - <p>Reduce server_last_modified()'s stack size.</p> - </li> - - <li> - <p>Shorten get_http_time() by using strftime().</p> - </li> - - <li> - <p>Constify the known_http_methods pointers in - unknown_method().</p> - </li> - - <li> - <p>Constify the time_formats pointers in parse_header_time().</p> - </li> - - <li> - <p>Constify the formerly_valid_actions pointers in - action_used_to_be_valid().</p> - </li> - - <li> - <p>Introduce a GNUMakefile MAN_PAGE variable that defaults to - privoxy.1. The Debian package uses section 8 for the man page and - this should simplify the patch.</p> - </li> - - <li> - <p>Deduplicate the INADDR_NONE definition for Solaris by moving - it to jbsockets.h</p> - </li> - - <li> - <p>In block_url(), ditch the obsolete workaround for ancient - Netscape versions that supposedly couldn't properly deal with - status code 403.</p> - </li> - - <li> - <p>Remove a useless NULL pointer check in load_trustfile().</p> - </li> - - <li> - <p>Remove two useless NULL pointer checks in - load_one_re_filterfile().</p> - </li> - - <li> - <p>Change url_code_map[] from an array of pointers to an array of - arrays It removes an unnecessary layer of indirection and on - 64bit system reduces the size of the binary a bit.</p> - </li> - - <li> - <p>Fix various typos. Fixes taken from Debian's 29_typos.dpatch - by Roland Rosenfeld.</p> - </li> - - <li> - <p>Add a dok-tidy GNUMakefile target to clean up the messy HTML - generated by the other dok targets.</p> - </li> - - <li> - <p>GNUisms in the GNUMakefile have been removed.</p> - </li> - - <li> - <p>Change the HTTP version in static responses to 1.1</p> - </li> - - <li> - <p>Synced config.sub and config.guess with upstream - 2011-11-11/386c7218162c145f5f9e1ff7f558a3fbb66c37c5.</p> - </li> - - <li> - <p>Add a dedicated function to parse the values of toggles. - Reduces duplicated code in load_config() and provides better - error handling. Invalid or missing toggle values are now a fatal - error instead of being silently ignored.</p> - </li> - - <li> - <p>Terminate HTML lines in static error messages with \n instead - of \r\n.</p> - </li> - - <li> - <p>Simplify cgi_error_unknown() a bit.</p> - </li> - - <li> - <p>In LogPutString(), don't bother looking at pszText when not - actually logging anything.</p> - </li> - - <li> - <p>Change ssplit()'s fourth parameter from int to size_t. Fixes a - clang complaint.</p> - </li> - - <li> - <p>Add a warning that the statistics currently can't be trusted. - Mention Privoxy-Log-Parser's --statistics option as an - alternative for the time being.</p> - </li> - - <li> - <p>In rfc2553_connect_to(), start setting cgi->error_message - on error.</p> - </li> - - <li> - <p>Change the expected status code returned for http://p.p/die - depending on whether or not FEATURE_GRACEFUL_TERMINATION is - available.</p> - </li> - - <li> - <p>In cgi_die(), mark the client connection for closing. If the - client will fetch the style sheet through another connection it - gets the main thread out of the accept() state and should thus - trigger the actual shutdown.</p> - </li> - - <li> - <p>Add a proper CGI message for cgi_die().</p> - </li> - - <li> - <p>Don't enforce a logical line length limit in - read_config_line().</p> - </li> - - <li> - <p>Slightly refactor server_last_modified() to remove useless - gmtime*() calls.</p> - </li> - - <li> - <p>In get_content_type(), also recognize '.jpeg' as JPEG - extension.</p> - </li> - - <li> - <p>Add '.png' to the list of recognized file extensions in - get_content_type().</p> - </li> - - <li> - <p>In block_url(), consistently use the block reason "Request - blocked by Privoxy" In two places the reason was "Request for - blocked URL" which hides the fact that the request got blocked by - Privoxy and isn't necessarily correct as the block may be due to - tags.</p> - </li> - - <li> - <p>In listen_loop(), reload the configuration files after - accepting a new connection instead of before. Previously the - first connection that arrived after a configuration change would - still be handled with the old configuration.</p> - </li> - - <li> - <p>In chat()'s receive-data loop, skip a client socket check if - the socket will be written to right away anyway. This can - increase the transfer speed for unfiltered content on fast - network connections.</p> - </li> - - <li> - <p>The socket timeout is used for SOCKS negotiations as well - which previously couldn't timeout.</p> - </li> - - <li> - <p>Don't keep the client connection alive if any configuration - file changed since the time the connection came in. This is - closer to Privoxy's behaviour before keep-alive support for - client connection has been added and also less confusing in - general.</p> - </li> - - <li> - <p>Treat all Content-Type header values containing the pattern - 'script' as a sign of text. Reported by pribog in #3134970.</p> - </li> - </ul> - </li> - - <li> - <p>Action file improvements:</p> - - <ul> - <li> - <p>Moved the site-specific block pattern section below the one - for the generic patterns so for requests that are matched in - both, the block reason for the domain is shown which is usually - more useful than showing the one for the generic pattern.</p> - </li> - - <li> - <p>Remove -prevent-compression from the fragile alias. It's no - longer used anywhere by default and isn't known to break stuff - anyway.</p> - </li> - - <li> - <p>Add a (disabled) section to block various Facebook tracking - URLs. Reported by Dan Stahlke in #3421764.</p> - </li> - - <li> - <p>Add a (disabled) section to rewrite and redirect - click-tracking URLs used on news.google.com. Reported by Dan - Stahlke in #3421755.</p> - </li> - - <li> - <p>Unblock linuxcounter.net/. Reported by Dan Stahlke in - #3422612.</p> - </li> - - <li> - <p>Block 'www91.intel.com/' which is used by Omniture. Reported - by Adam Piggott in #3167370.</p> - </li> - - <li> - <p>Disable the handle-as-empty-doc-returns-ok option and mark it - as deprecated. Reminded by tceverling in #2790091.</p> - </li> - - <li> - <p>Add ".ivwbox.de/" to the "Cross-site user tracking" section. - Reported by Nettozahler in #3172525.</p> - </li> - - <li> - <p>Unblock and fast-redirect ".awin1.com/.*=http://". Reported by - Adam Piggott in #3170921.</p> - </li> - - <li> - <p>Block "b.collective-media.net/".</p> - </li> - - <li> - <p>Widen the Debian popcon exception to "qa.debian.org/popcon". - Seen in Debian's 05_default_action.dpatch by Roland - Rosenfeld.</p> - </li> - - <li> - <p>Block ".gemius.pl/" which only seems to be used for user - tracking. Reported by johnd16 in #3002731. Additional input from - Lee and movax.</p> - </li> - - <li> - <p>Disable banners-by-size filters for '.thinkgeek.com/'. The - filter only seems to catch pictures of the inventory.</p> - </li> - - <li> - <p>Block requests for 'go.idmnet.bbelements.com/please/showit/'. - Reported by kacperdominik in #3372959.</p> - </li> - - <li> - <p>Unblock adainitiative.org/.</p> - </li> - - <li> - <p>Add a fast-redirects exception for - '.googleusercontent.com/.*=cache'.</p> - </li> - - <li> - <p>Add a fast-redirects exception for - webcache.googleusercontent.com/.</p> - </li> - - <li> - <p>Unblock http://adassier.wordpress.com/ and - http://adassier.files.wordpress.com/.</p> - </li> - </ul> - </li> - - <li> - <p>Filter file improvements:</p> - - <ul> - <li> - <p>Let the yahoo filter hide '.ads'.</p> - </li> - - <li> - <p>Let the msn filter hide overlay ads for Facebook 'likes' in - search results and elements with the id 's_notf_div'. They only - seem to be used to advertise site 'enhancements'.</p> - </li> - - <li> - <p>Let the js-events filter additionally disarm setInterval(). - Suggested by dg1727 in #3423775.</p> - </li> - </ul> - </li> - - <li> - <p>Documentation improvements:</p> - - <ul> - <li> - <p>Clarify the effect of compiling Privoxy with zlib support. - Suggested by dg1727 in #3423782.</p> - </li> - - <li> - <p>Point out that the SourceForge messaging system works like a - black hole and should thus not be used to contact individual - developers.</p> - </li> - - <li> - <p>Mention some of the problems one can experience when not - explicitly configuring an IP addresses as listen address.</p> - </li> - - <li> - <p>Explicitly mention that hostnames can be used instead of IP - addresses for the listen-address, that only the first address - returned will be used and what happens if the address is invalid. - Requested by Calestyo in #3302213.</p> - </li> - </ul> - </li> - - <li> - <p>Log message improvements:</p> - - <ul> - <li> - <p>If only the server connection is kept alive, do not pretend to - wait for a new client request.</p> - </li> - - <li> - <p>Remove a superfluous log message in forget_connection().</p> - </li> - - <li> - <p>In chat(), properly report missing server responses as such - instead of calling them empty.</p> - </li> - - <li> - <p>In forwarded_connect(), fix a log message nobody should ever - see.</p> - </li> - - <li> - <p>Fix a log message in socks5_connect(), a failed write - operation was logged as failed read operation.</p> - </li> - - <li> - <p>Let load_one_actions_file() properly complain about a missing - '{' at the beginning of the file. Simply stating that a line is - invalid isn't particularly helpful.</p> - </li> - - <li> - <p>Do not claim to listen on a socket until Privoxy actually - does. Patch submitted by Petr Pisar #3354485</p> - </li> - - <li> - <p>Prevent a duplicated LOG_LEVEL_CLF message when sending out - the "no-server-data" response.</p> - </li> - - <li> - <p>Also log the client socket when dropping a connection.</p> - </li> - - <li> - <p>Include the destination host in the 'Request ... marked for - blocking. limit-connect{...} doesn't allow CONNECT ...' message - Patch submitted by Saperski in #3296250.</p> - </li> - - <li> - <p>Prevent a duplicated log message if none of the resolved IP - addresses were reachable.</p> - </li> - - <li> - <p>In connect_to(), do not pretend to retry if - forwarded-connect-retries is zero or unset.</p> - </li> - - <li> - <p>When a specified user or group can't be found, put the name in - single-quotes when logging it.</p> - </li> - - <li> - <p>In rfc2553_connect_to(), explain getnameinfo() errors - better.</p> - </li> - - <li> - <p>Remove a useless log message in chat().</p> - </li> - - <li> - <p>When retrying to connect, also log the maximum number of - connection attempts.</p> - </li> - - <li> - <p>Rephrase a log message in compile_dynamic_pcrs_job_list(). - Divide the error code and its meaning with a colon. Call the pcrs - job dynamic and not the filter. Filters may contain dynamic and - non-dynamic pcrs jobs at the same time. Only mention the name of - the filter or tagger, but don't claim it's a filter when it could - be a tagger.</p> - </li> - - <li> - <p>In a fatal error message in load_one_actions_file(), cover - both URL and TAG patterns.</p> - </li> - - <li> - <p>In pcrs_strerror(), properly report unknown positive error - code values as such. Previously they were handled like 0 (no - error).</p> - </li> - - <li> - <p>In compile_dynamic_pcrs_job_list(), also log the actual error - code as pcrs_strerror() doesn't handle all errors reported by - pcre.</p> - </li> - - <li> - <p>Don't bother trying to continue chatting if the client didn't - ask for it. Reduces log noise a bit.</p> - </li> - - <li> - <p>Make two fatal error message in load_one_actions_file() more - descriptive.</p> - </li> - - <li> - <p>In cgi_send_user_manual(), log when rejecting a file name due - to '/' or '..'.</p> - </li> - - <li> - <p>In load_file(), log a message if opening a file failed. The - CGI error message alone isn't too helpful.</p> - </li> - - <li> - <p>In connection_destination_matches(), improve two log messages - to help understand why the destinations don't match.</p> - </li> - - <li> - <p>Rephrase a log message in serve(). Client request arrival - should be differentiated from closed client connections now.</p> - </li> - - <li> - <p>In serve(), log if a client connection isn't reused due to a - configuration file change.</p> - </li> - - <li> - <p>Let mark_server_socket_tainted() always mark the server socket - tainted, just don't talk about it in cases where it has no - effect. It doesn't change Privoxy's behaviour, but makes - understanding the log file easier.</p> - </li> - </ul> - </li> - - <li> - <p>configure:</p> - - <ul> - <li> - <p>Added a --disable-ipv6-support switch for platforms where - support is detected but doesn't actually work.</p> - </li> - - <li> - <p>Do not check for the existence of strerror() and memmove() - twice</p> - </li> - - <li> - <p>Remove a useless test for setpgrp(2). Privoxy doesn't need it - and it can cause problems when cross-compiling.</p> - </li> - - <li> - <p>Rename the --disable-acl-files switch to - --disable-acl-support. Since about 2001, ACL directives are - specified in the standard config file.</p> - </li> - - <li> - <p>Update the URL of the 'Removing outdated PCRE version after - the next stable release' posting. The old URL stopped working - after one of SF's recent site "optimizations". Reported by Han - Liu.</p> - </li> - </ul> - </li> - - <li> - <p>Privoxy-Regression-Test:</p> - - <ul> - <li> - <p>Added --shuffle-tests option to increase the chances of - detection race conditions.</p> - </li> - - <li> - <p>Added a --local-test-file option that allows to use - Privoxy-Regression-Test without Privoxy.</p> - </li> - - <li> - <p>Added tests for missing socks4 and socks4a forwarders.</p> - </li> - - <li> - <p>The --privoxy-address option now works with IPv6 addresses - containing brackets, too.</p> - </li> - - <li> - <p>Perform limited sanity checks for parameters that are supposed - to have numerical values.</p> - </li> - - <li> - <p>Added a --sleep-time option to specify a number of seconds to - sleep between tests, defaults to 0.</p> - </li> - - <li> - <p>Disable the range-requests tagger for tests that break if it's - enabled.</p> - </li> - - <li> - <p>Log messages use the ISO 8601 date format %Y-%m-%d.</p> - </li> - - <li> - <p>Fix spelling in two error messages.</p> - </li> - - <li> - <p>In the --help output, include a list of supported tests and - their default levels.</p> - </li> - - <li> - <p>Adjust the tests to properly deal with FEATURE_TOGGLE being - disabled.</p> - </li> - </ul> - </li> - - <li> - <p>Privoxy-Log-Parser:</p> - - <ul> - <li> - <p>Perform limited sanity checks for command line parameters that - are supposed to have numerical values.</p> - </li> - - <li> - <p>Implement a --unbreak-lines-only option to try to revert MUA - breakage.</p> - </li> - - <li> - <p>Accept and highlight: Added header: Content-Encoding: - deflate</p> - </li> - - <li> - <p>Accept and highlight: Compressed content from 29258 to 8630 - bytes.</p> - </li> - - <li> - <p>Accept and highlight: Client request arrived in time on socket - 21.</p> - </li> - - <li> - <p>Highlight: Didn't receive data in time: a.fsdn.com:443</p> - </li> - - <li> - <p>Accept log messages with ISO 8601 time stamps, too.</p> - </li> - </ul> - </li> - - <li> - <p>uagen:</p> - - <ul> - <li> - <p>Bump generated Firefox version to 8.0.</p> - </li> - - <li> - <p>Only randomize the release date if the new - --randomize-release-date option is enabled. Firefox versions - after 4 use a fixed date string without meaning.</p> - </li> - </ul> - </li> - </ul> - - <div class="SECT2"> - <h2 class="SECT2"><a name="UPGRADERSNOTE" id="UPGRADERSNOTE">3.1. Note - to Upgraders</a></h2> - - <p>A quick list of things to be aware of before upgrading from earlier - versions of <span class="APPLICATION">Privoxy</span>:</p> - - <ul> - <li> - <p>The recommended way to upgrade <span class= - "APPLICATION">Privoxy</span> is to backup your old configuration - files, install the new ones, verify that <span class= - "APPLICATION">Privoxy</span> is working correctly and finally merge - back your changes using <span class="APPLICATION">diff</span> and - maybe <span class="APPLICATION">patch</span>.</p> - - <p>There are a number of new features in each <span class= - "APPLICATION">Privoxy</span> release and most of them have to be - explicitly enabled in the configuration files. Old configuration - files obviously don't do that and due to syntax changes using old - configuration files with a new <span class= - "APPLICATION">Privoxy</span> isn't always possible anyway.</p> - </li> - - <li> - <p>Note that some installers remove earlier versions completely, - including configuration files, therefore you should really save any - important configuration files!</p> - </li> - - <li> - <p>On the other hand, other installers don't overwrite existing - configuration files, thinking you will want to do that - yourself.</p> - </li> - - <li> - <p><tt class="FILENAME">standard.action</tt> has been merged into - the <tt class="FILENAME">default.action</tt> file.</p> - </li> - - <li> - <p>In the default configuration only fatal errors are logged now. - You can change that in the <a href="config.html#DEBUG">debug - section</a> of the configuration file. You may also want to enable - more verbose logging until you verified that the new <span class= - "APPLICATION">Privoxy</span> version is working as expected.</p> - </li> - - <li> - <p>Three other config file settings are now off by default: - <a href="config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a>, - <a href= - "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a>, - and <a href= - "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a>. If you - use or want these, you will need to explicitly enable them, and be - aware of the security issues involved.</p> - </li> - </ul> - </div> - </div> - - <div class="NAVFOOTER"> - <hr class="c1" width="100%"> - - <table summary="Footer navigation table" width="100%" border="0" - cellpadding="0" cellspacing="0"> - <tr> - <td width="33%" align="left" valign="top"><a href="installation.html" - accesskey="P">Prev</a></td> - - <td width="34%" align="center" valign="top"><a href="index.html" - accesskey="H">Home</a></td> - - <td width="33%" align="right" valign="top"><a href="quickstart.html" - accesskey="N">Next</a></td> - </tr> - - <tr> - <td width="33%" align="left" valign="top">Installation</td> - - <td width="34%" align="center" valign="top"> </td> - - <td width="33%" align="right" valign="top">Quickstart to Using - Privoxy</td> - </tr> - </table> - </div> -</body> -</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>What's New in this Release</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REL="HOME" +TITLE="Privoxy 3.0.12 User Manual" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Installation" +HREF="installation.html"><LINK +REL="NEXT" +TITLE="Quickstart to Using Privoxy" +HREF="quickstart.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="../p_doc.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; +charset=ISO-8859-1"> +<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css"> +</head +><BODY +CLASS="SECT1" +BGCOLOR="#EEEEEE" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>Privoxy 3.0.12 User Manual</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="installation.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="quickstart.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="WHATSNEW" +>3. What's New in this Release</A +></H1 +><P +> <SPAN +CLASS="APPLICATION" +>Privoxy 3.0.12</SPAN +> is mainly a bugfix release:</P +><P +> <P +></P +><UL +><LI +><P +> The socket-timeout option now also works on platforms whose + select() implementation modifies the timeout structure. + Previously the timeout was triggered even if the connection + didn't stall. Reported by cyberpatrol. + </P +></LI +><LI +><P +> The Connection: keep-alive code properly deals with files + larger than 2GB. Previously the connection was closed too + early. + </P +></LI +><LI +><P +> The content length for files above 2GB is logged correctly. + </P +></LI +><LI +><P +> The user-manual directive on the show-status page links to + the documentation location specified with the directive, + not to the Privoxy website. + </P +></LI +><LI +><P +> When running in daemon mode, Privoxy doesn't log anything + to the console unless there are errors before the logfile + has been opened. + </P +></LI +><LI +><P +> The show-status page prints warnings about invalid directives + on the same line as the directives themselves. + </P +></LI +><LI +><P +> Fixed several justified (but harmless) compiler warnings, + mostly on 64 bit platforms. + </P +></LI +><LI +><P +> The mingw32 version explicitly requests the default charset + to prevent display problems with some fonts available on more + recent Windows versions. Patch by Burberry. + </P +></LI +><LI +><P +> The mingw32 version uses the Privoxy icon in the alt-tab + windows. Patch by Burberry. + </P +></LI +><LI +><P +> The timestamp and the thread id is omitted in the "Fatal error" + message box on mingw32. + </P +></LI +><LI +><P +> Fixed two related mingw32-only buffer overflows. Triggering + them required control over the configuration file, therefore + this isn't seen as a security issue. + </P +></LI +><LI +><P +> In verbose mode, or if the new option --show-skipped-tests + is used, Privoxy-Regression-Test logs skipped tests and the + skip reason. + </P +></LI +></UL +></P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="UPGRADERSNOTE" +>3.1. Note to Upgraders</A +></H2 +><P +> A quick list of things to be aware of before upgrading from earlier + versions of <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +>:</P +><P +> <P +></P +><UL +><LI +><P +> The recommended way to upgrade <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> is to backup your old + configuration files, install the new ones, verify that <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> + is working correctly and finally merge back your changes using + <SPAN +CLASS="APPLICATION" +>diff</SPAN +> and maybe <SPAN +CLASS="APPLICATION" +>patch</SPAN +>. + </P +><P +> There are a number of new features in each <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> release and + most of them have to be explicitly enabled in the configuration + files. Old configuration files obviously don't do that and due + to syntax changes using old configuration files with a new + <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> isn't always possible anyway. + </P +></LI +><LI +><P +> + Note that some installers remove earlier versions completely, + including configuration files, therefore you should really save + any important configuration files! + </P +></LI +><LI +><P +> + On the other hand, other installers don't overwrite existing configuration + files, thinking you will want to do that yourself. + </P +></LI +><LI +><P +> + <TT +CLASS="FILENAME" +>standard.action</TT +> has been merged into + the <TT +CLASS="FILENAME" +>default.action</TT +> file. + </P +></LI +><LI +><P +> In the default configuration only fatal errors are logged now. + You can change that in the <A +HREF="config.html#DEBUG" +>debug section</A +> + of the configuration file. You may also want to enable more verbose + logging until you verified that the new <SPAN +CLASS="APPLICATION" +>Privoxy</SPAN +> version is working + as expected. + </P +></LI +><LI +><P +> Three other config file settings are now off by default: + <A +HREF="config.html#ENABLE-REMOTE-TOGGLE" +>enable-remote-toggle</A +>, + <A +HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE" +>enable-remote-http-toggle</A +>, + and <A +HREF="config.html#ENABLE-EDIT-ACTIONS" +>enable-edit-actions</A +>. + If you use or want these, you will need to explicitly enable them, and + be aware of the security issues involved. + </P +></LI +></UL +></P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="quickstart.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Installation</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Quickstart to Using Privoxy</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/external/privoxy/encode.c b/external/privoxy/encode.c index ad66c09..d4bb1ce 100644 --- a/external/privoxy/encode.c +++ b/external/privoxy/encode.c @@ -1,4 +1,4 @@ -const char encode_rcs[] = "$Id: encode.c,v 1.24 2011/11/06 11:51:57 fabiankeil Exp $"; +const char encode_rcs[] = "$Id: encode.c,v 1.14 2008/05/21 15:38:13 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/encode.c,v $ @@ -6,14 +6,14 @@ const char encode_rcs[] = "$Id: encode.c,v 1.24 2011/11/06 11:51:57 fabiankeil E * Purpose : Functions to encode and decode URLs, and also to * encode cookies and HTML text. * - * Copyright : Written by and Copyright (C) 2001 the + * Copyright : Written by and Copyright (C) 2001 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -31,8 +31,54 @@ const char encode_rcs[] = "$Id: encode.c,v 1.24 2011/11/06 11:51:57 fabiankeil E * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: encode.c,v $ + * Revision 1.14 2008/05/21 15:38:13 fabiankeil + * Garbage-collect cookie_encode(). + * + * Revision 1.13 2007/08/18 14:34:27 fabiankeil + * Make xtoi() extern so it can be used in pcrs.c. + * + * Revision 1.12 2007/08/04 10:15:51 fabiankeil + * Use strlcpy() instead of strcpy(). + * + * Revision 1.11 2006/12/28 18:25:53 fabiankeil + * Fixed gcc43 compiler warning. + * + * Revision 1.10 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.8 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.7 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.6 2002/03/13 00:27:04 jongfoster + * Killing warnings + * + * Revision 1.5 2002/03/07 03:46:53 oes + * Fixed compiler warnings etc + * + * Revision 1.4 2002/01/22 23:28:07 jongfoster + * Adding convenience function html_encode_and_free_original() + * Making all functions accept NULL paramaters - in this case, they + * simply return NULL. This allows error-checking to be deferred. + * + * Revision 1.3 2001/11/13 00:16:40 jongfoster + * Replacing references to malloc.h with the standard stdlib.h + * (See ANSI or K&R 2nd Ed) + * + * Revision 1.2 2001/05/17 22:52:35 oes + * - Cleaned CRLF's from the sources and related files + * + * Revision 1.1.1.1 2001/05/15 13:58:51 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -47,20 +93,20 @@ const char encode_rcs[] = "$Id: encode.c,v 1.24 2011/11/06 11:51:57 fabiankeil E const char encode_h_rcs[] = ENCODE_H_VERSION;
/* Maps special characters in a URL to their equivalent % codes. */ -static const char const url_code_map[256][4] = { - "", "%01", "%02", "%03", "%04", "%05", "%06", "%07", "%08", "%09", +static const char * const url_code_map[256] = { + NULL, "%01", "%02", "%03", "%04", "%05", "%06", "%07", "%08", "%09", "%0A", "%0B", "%0C", "%0D", "%0E", "%0F", "%10", "%11", "%12", "%13", "%14", "%15", "%16", "%17", "%18", "%19", "%1A", "%1B", "%1C", "%1D", - "%1E", "%1F", "%20", "%21", "%22", "%23", "%24", "%25", "%26", "%27", - "%28", "%29", "", "%2B", "%2C", "", "", "%2F", "", "", - "", "", "", "", "", "", "", "", "%3A", "%3B", - "%3C", "%3D", "%3E", "%3F", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", "", "", - "", "%5B", "%5C", "%5D", "%5E", "", "%60", "", "", "", - "", "", "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", "", "", - "", "", "", "%7B", "%7C", "%7D", "%7E", "%7F", "%80", "%81", + "%1E", "%1F", "+", "%21", "%22", "%23", "%24", "%25", "%26", "%27", + "%28", "%29", NULL, "%2B", "%2C", NULL, NULL, "%2F", NULL, NULL, + NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, "%3A", "%3B", + "%3C", "%3D", "%3E", "%3F", NULL, NULL, NULL, NULL, NULL, NULL, + NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, + NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, + NULL, "%5B", "%5C", "%5D", "%5E", NULL, "%60", NULL, NULL, NULL, + NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, + NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, + NULL, NULL, NULL, "%7B", "%7C", "%7D", "%7E", "%7F", "%80", "%81", "%82", "%83", "%84", "%85", "%86", "%87", "%88", "%89", "%8A", "%8B", "%8C", "%8D", "%8E", "%8F", "%90", "%91", "%92", "%93", "%94", "%95", "%96", "%97", "%98", "%99", "%9A", "%9B", "%9C", "%9D", "%9E", "%9F", @@ -76,12 +122,12 @@ static const char const url_code_map[256][4] = { "%FA", "%FB", "%FC", "%FD", "%FE", "%FF" };
-/* Maps special characters in HTML to their equivalent entities. */ +/* Maps special characters in HTML to their equivalent entites. */ static const char * const html_code_map[256] = { NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, - NULL, NULL, NULL, NULL,""",NULL,NULL,NULL,"&","'", + NULL, NULL, NULL, NULL,""",NULL,NULL,NULL,"&",NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, "<",NULL,">",NULL,NULL, NULL, NULL, NULL, NULL, NULL, @@ -119,7 +165,7 @@ static const char * const html_code_map[256] = { * Parameters : * 1 : s = String to encode. Null-terminated. * - * Returns : Encoded string, newly allocated on the heap. + * Returns : Encoded string, newly allocated on the heap. * Caller is responsible for freeing it with free(). * If s is NULL, or on out-of memory, returns NULL. * @@ -128,7 +174,7 @@ char * html_encode(const char *s) { char * buf; size_t buf_size; - + if (s == NULL) { return NULL; @@ -178,7 +224,7 @@ char * html_encode(const char *s) * Parameters : * 1 : s = String to encode. Null-terminated. * - * Returns : Encoded string, newly allocated on the heap. + * Returns : Encoded string, newly allocated on the heap. * Caller is responsible for freeing it with free(). * If s is NULL, or on out-of memory, returns NULL. * @@ -186,7 +232,7 @@ char * html_encode(const char *s) char * html_encode_and_free_original(char *s) { char * result; - + if (s == NULL) { return NULL; @@ -207,13 +253,10 @@ char * html_encode_and_free_original(char *s) * query string. Replaces special characters with * the appropriate %xx codes. * - * XXX: url_query_encode() would be a more fitting - * name. - * * Parameters : * 1 : s = String to encode. Null-terminated. * - * Returns : Encoded string, newly allocated on the heap. + * Returns : Encoded string, newly allocated on the heap. * Caller is responsible for freeing it with free(). * If s is NULL, or on out-of memory, returns NULL. * @@ -238,8 +281,8 @@ char * url_encode(const char *s) char * p = buf; while( (c = *s++) != '\0') { - const char *replace_with = url_code_map[(unsigned char) c]; - if (*replace_with != '\0') + const char * replace_with = url_code_map[(unsigned char) c]; + if (replace_with != NULL) { const size_t bytes_written = (size_t)(p - buf); assert(bytes_written < buf_size); @@ -278,7 +321,7 @@ static int xdtoi(const int d) { return(d - '0'); } - else if ((d >= 'a') && (d <= 'f')) + else if ((d >= 'a') && (d <= 'f')) { return(d - 'a' + 10); } @@ -308,12 +351,12 @@ static int xdtoi(const int d) *********************************************************************/ int xtoi(const char *s) { - int d1; + int d1, d2;
d1 = xdtoi(*s); if(d1 >= 0) { - int d2 = xdtoi(*(s+1)); + d2 = xdtoi(*(s+1)); if(d2 >= 0) { return (d1 << 4) + d2; @@ -334,7 +377,7 @@ int xtoi(const char *s) * Parameters : * 1 : s = String to decode. Null-terminated. * - * Returns : Decoded string, newly allocated on the heap. + * Returns : Decoded string, newly allocated on the heap. * Caller is responsible for freeing it with free(). * *********************************************************************/ @@ -380,83 +423,6 @@ char *url_decode(const char * s) }
-/********************************************************************* - * - * Function : percent_encode_url - * - * Description : Percent-encodes a string so it no longer contains - * any characters that aren't valid in an URL according - * to RFC 3986. - * - * XXX: Do not confuse with encode_url() - * - * Parameters : - * 1 : s = String to encode. Null-terminated. - * - * Returns : Encoded string, newly allocated on the heap. - * Caller is responsible for freeing it with free(). - * If s is NULL, or on out-of memory, returns NULL. - * - *********************************************************************/ -char *percent_encode_url(const char *s) -{ - static const char allowed_characters[128] = { - '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', - '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', - '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', - '\0', '\0', '\0', '!', '\0', '#', '$', '%', '&', ''', - '(', ')', '*', '+', ',', '-', '.', '/', '0', '1', - '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', - '\0', '=', '\0', '?', '@', 'A', 'B', 'C', 'D', 'E', - 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', - 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', - 'Z', '[', '\0', ']', '\0', '_', '\0', 'a', 'b', 'c', - 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', - 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', - 'x', 'y', 'z', '\0', '\0', '\0', '~', '\0' - }; - char *buf; - size_t buf_size; - - assert(s != NULL); - - /* Each input char can expand to at most 3 chars. */ - buf_size = (strlen(s) * 3) + 1; - buf = (char *)malloc(buf_size); - - if (buf != NULL) - { - char c; - char *p = buf; - while((c = *s++) != '\0') - { - const unsigned int i = (unsigned char)c; - if (i >= sizeof(allowed_characters) || '\0' == allowed_characters[i]) - { - const char *replace_with = url_code_map[i]; - assert(*replace_with != '\0'); - if (*replace_with != '\0') - { - const size_t bytes_written = (size_t)(p - buf); - assert(bytes_written < buf_size); - p += strlcpy(p, replace_with, buf_size - bytes_written); - } - } - else - { - *p++ = c; - } - } - *p = '\0'; - } - - assert(strlen(buf) < buf_size); - - return(buf); - -} - - /* Local Variables: tab-width: 3 diff --git a/external/privoxy/encode.h b/external/privoxy/encode.h index 4d65f6a..728746b 100644 --- a/external/privoxy/encode.h +++ b/external/privoxy/encode.h @@ -1,6 +1,6 @@ #ifndef ENCODE_H_INCLUDED #define ENCODE_H_INCLUDED -#define ENCODE_H_VERSION "$Id: encode.h,v 1.12 2011/11/06 11:44:56 fabiankeil Exp $" +#define ENCODE_H_VERSION "$Id: encode.h,v 1.9 2008/05/21 15:38:13 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/encode.h,v $ @@ -12,10 +12,10 @@ * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -33,8 +33,39 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: encode.h,v $ + * Revision 1.9 2008/05/21 15:38:13 fabiankeil + * Garbage-collect cookie_encode(). + * + * Revision 1.8 2007/08/18 14:34:27 fabiankeil + * Make xtoi() extern so it can be used in pcrs.c. + * + * Revision 1.7 2006/07/18 14:48:45 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.5 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.4 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.3 2002/01/22 23:28:07 jongfoster + * Adding convenience function html_encode_and_free_original() + * Making all functions accept NULL paramaters - in this case, they + * simply return NULL. This allows error-checking to be deferred. + * + * Revision 1.2 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.1.1.1 2001/05/15 13:58:51 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -45,7 +76,6 @@ extern char * url_encode(const char *s); extern char * url_decode(const char *str); extern int xtoi(const char *s); extern char * html_encode_and_free_original(char *s); -extern char * percent_encode_url(const char *s);
/* Revision control strings from this header and associated .c file */ extern const char encode_rcs[]; diff --git a/external/privoxy/errlog.c b/external/privoxy/errlog.c index cfbb4a2..ca12d7f 100644 --- a/external/privoxy/errlog.c +++ b/external/privoxy/errlog.c @@ -1,4 +1,4 @@ -const char errlog_rcs[] = "$Id: errlog.c,v 1.112 2011/09/04 11:10:56 fabiankeil Exp $"; +const char errlog_rcs[] = "$Id: errlog.c,v 1.92 2009/03/20 03:39:31 ler762 Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/errlog.c,v $ @@ -6,14 +6,14 @@ const char errlog_rcs[] = "$Id: errlog.c,v 1.112 2011/09/04 11:10:56 fabiankeil * Purpose : Log errors to a designated destination in an elegant, * printf-like fashion. * - * Copyright : Written by and Copyright (C) 2001-2010 the + * Copyright : Written by and Copyright (C) 2001-2009 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -31,14 +31,418 @@ const char errlog_rcs[] = "$Id: errlog.c,v 1.112 2011/09/04 11:10:56 fabiankeil * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: errlog.c,v $ + * Revision 1.92 2009/03/20 03:39:31 ler762 + * I like having the version logged at startup and the Windows GUI stopped logging + * it after LOG_LEVEL_INFO was removed from + * static int debug = (LOG_LEVEL_FATAL | LOG_LEVEL_ERROR | LOG_LEVEL_INFO); + * + * Revision 1.91 2009/03/18 21:56:30 fabiankeil + * In init_error_log(), suppress the "(Re-)Opening logfile" message if + * we're still logging to stderr. This restores the "silent mode", but + * with LOG_LEVEL_INFO enabled, the show_version() info is written to + * the logfile as intended. + * + * Revision 1.90 2009/03/18 20:43:19 fabiankeil + * Don't enable LOG_LEVEL_INFO by default and don't apply the user's + * debug settings until the logfile has been opened (if there is one). + * Patch submitted by Roland in #2624120. + * + * Revision 1.89 2009/03/07 12:56:12 fabiankeil + * Add log_error() support for unsigned long long (%lld). + * + * Revision 1.88 2009/03/07 11:34:36 fabiankeil + * Omit timestamp and thread id in the mingw32 message box. + * + * Revision 1.87 2009/03/01 18:28:24 fabiankeil + * Help clang understand that we aren't dereferencing + * NULL pointers here. + * + * Revision 1.86 2009/02/09 21:21:15 fabiankeil + * Now that init_log_module() is called earlier, call show_version() + * later on from main() directly so it doesn't get called for --help + * or --version. + * + * Revision 1.85 2009/02/06 17:51:38 fabiankeil + * Be prepared if I break the log module initialization again. + * + * Revision 1.84 2008/12/14 15:46:22 fabiankeil + * Give crunched requests their own log level. + * + * Revision 1.83 2008/12/04 18:14:32 fabiankeil + * Fix some cparser warnings. + * + * Revision 1.82 2008/11/23 16:06:58 fabiankeil + * Update a log message I missed in 1.80. + * + * Revision 1.81 2008/11/23 15:59:27 fabiankeil + * - Update copyright range. + * - Remove stray line breaks in a log message + * nobody is supposed to see anyway. + * + * Revision 1.80 2008/11/23 15:49:49 fabiankeil + * In log_error(), don't surround the thread id with "Privoxy(" and ")". + * + * Revision 1.79 2008/10/20 17:09:25 fabiankeil + * Update init_error_log() description to match reality. + * + * Revision 1.78 2008/09/07 16:59:31 fabiankeil + * Update a comment to reflect that we + * have mutex support on mingw32 now. + * + * Revision 1.77 2008/09/07 12:43:44 fabiankeil + * Move the LogPutString() call in log_error() into the locked + * region so the Windows GUI log is consistent with the logfile. + * + * Revision 1.76 2008/09/07 12:35:05 fabiankeil + * Add mutex lock support for _WIN32. + * + * Revision 1.75 2008/09/04 08:13:58 fabiankeil + * Prepare for critical sections on Windows by adding a + * layer of indirection before the pthread mutex functions. + * + * Revision 1.74 2008/08/06 18:33:36 fabiankeil + * If the "close fd first" workaround doesn't work, + * the fatal error message will be lost, so we better + * explain the consequences while we still can. + * + * Revision 1.73 2008/08/04 19:06:55 fabiankeil + * Add a lame workaround for the "can't open an already open + * logfile on OS/2" problem reported by Maynard in #2028842 + * and describe what a real solution would look like. + * + * Revision 1.72 2008/07/27 12:04:28 fabiankeil + * Fix a comment typo. + * + * Revision 1.71 2008/06/28 17:17:15 fabiankeil + * Remove another stray semicolon. + * + * Revision 1.70 2008/06/28 17:10:29 fabiankeil + * Remove stray semicolon in get_log_timestamp(). + * Reported by Jochen Voss in #2005221. + * + * Revision 1.69 2008/05/30 15:55:25 fabiankeil + * Declare variable "debug" static and complain about its name. + * + * Revision 1.68 2008/04/27 16:50:46 fabiankeil + * Remove an incorrect assertion. The value of debug may change if + * the configuration is reloaded in another thread. While we could + * cache the initial value, the assertion doesn't seem worth it. + * + * Revision 1.67 2008/03/27 18:27:23 fabiankeil + * Remove kill-popups action. + * + * Revision 1.66 2008/01/31 15:38:14 fabiankeil + * - Make the logfp assertion more strict. As of 1.63, the "||" could + * have been an "&&", which means we can use two separate assertions + * and skip on of them on Windows. + * - Break a long commit message line in two. + * + * Revision 1.65 2008/01/31 14:44:33 fabiankeil + * Use (a != b) instead of !(a == b) so the sanity check looks less insane. + * + * Revision 1.64 2008/01/21 18:56:46 david__schmidt + * Swap #def from negative to positive, re-joined it so it didn't + * span an assertion (compilation failure on OS/2) + * + * Revision 1.63 2007/12/15 19:49:32 fabiankeil + * Stop overloading logfile to control the mingw32 log window as well. + * It's no longer necessary now that we disable all debug lines by default + * and at least one user perceived it as a regression (added in 1.55). + * + * Revision 1.62 2007/11/30 15:33:46 fabiankeil + * Unbreak LOG_LEVEL_FATAL. It wasn't fatal with logging disabled + * and on mingw32 fatal log messages didn't end up in the log file. + * + * Revision 1.61 2007/11/04 19:03:01 fabiankeil + * Fix another deadlock Hal spotted and that mysteriously didn't affect FreeBSD. + * + * Revision 1.60 2007/11/03 19:03:31 fabiankeil + * - Prevent the Windows GUI from showing the version two times in a row. + * - Stop using the imperative in the "(Re-)Open logfile" message. + * - Ditch the "Switching to daemon mode" message as the detection + * whether or not we're already in daemon mode doesn't actually work. + * + * Revision 1.59 2007/11/01 12:50:56 fabiankeil + * Here's looking at you, deadlock. + * + * Revision 1.58 2007/10/28 19:04:21 fabiankeil + * Don't mention daemon mode in "Logging disabled" message. Some + * platforms call it differently and it's not really relevant anyway. + * + * Revision 1.57 2007/10/27 13:02:26 fabiankeil + * Relocate daemon-mode-related log messages to make sure + * they aren't shown again in case of configuration reloads. + * + * Revision 1.56 2007/10/14 14:26:56 fabiankeil + * Remove the old log_error() version. + * + * Revision 1.55 2007/10/14 14:12:41 fabiankeil + * When in daemon mode, close stderr after the configuration file has been + * parsed the first time. If logfile isn't set, stop logging. Fixes BR#897436. + * + * Revision 1.54 2007/09/22 16:15:34 fabiankeil + * - Let it compile with pcc. + * - Move our includes below system includes to prevent macro conflicts. + * + * Revision 1.53 2007/08/05 13:53:14 fabiankeil + * #1763173 from Stefan Huehner: declare some more functions + * static and use void instead of empty parameter lists. + * + * Revision 1.52 2007/07/14 07:28:47 fabiankeil + * Add translation function for JB_ERR_FOO codes. + * + * Revision 1.51 2007/05/11 11:51:34 fabiankeil + * Fix a type mismatch warning. + * + * Revision 1.50 2007/04/11 10:55:44 fabiankeil + * Enforce some assertions that could be triggered + * on mingw32 and other systems where we use threads + * but no locks. + * + * Revision 1.49 2007/04/08 16:44:15 fabiankeil + * We need <sys/time.h> for gettimeofday(), not <time.h>. + * + * Revision 1.48 2007/03/31 13:33:28 fabiankeil + * Add alternative log_error() with timestamps + * that contain milliseconds and without using + * strcpy(), strcat() or sprintf(). + * + * Revision 1.47 2006/11/28 15:25:15 fabiankeil + * Only unlink the pidfile if it's actually used. + * + * Revision 1.46 2006/11/13 19:05:51 fabiankeil + * Make pthread mutex locking more generic. Instead of + * checking for OSX and OpenBSD, check for FEATURE_PTHREAD + * and use mutex locking unless there is an _r function + * available. Better safe than sorry. + * + * Fixes "./configure --disable-pthread" and should result + * in less threading-related problems on pthread-using platforms, + * but it still doesn't fix BR#1122404. + * + * Revision 1.45 2006/08/21 11:15:54 david__schmidt + * MS Visual C++ build updates + * + * Revision 1.44 2006/08/18 16:03:16 david__schmidt + * Tweak for OS/2 build happiness. + * + * Revision 1.43 2006/08/03 02:46:41 david__schmidt + * Incorporate Fabian Keil's patch work: + * http://www.fabiankeil.de/sourcecode/privoxy/ + * + * Revision 1.42 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.40.2.4 2005/04/03 20:10:50 david__schmidt + * Thanks to Jindrich Makovicka for a race condition fix for the log + * file. The race condition remains for non-pthread implementations. + * Reference patch #1175720. + * + * Revision 1.40.2.3 2003/03/07 03:41:04 david__schmidt + * Wrapping all *_r functions (the non-_r versions of them) with mutex + * semaphores for OSX. Hopefully this will take care of all of those pesky + * crash reports. + * + * Revision 1.40.2.2 2002/09/28 00:30:57 david__schmidt + * Update error logging to give sane values for thread IDs on Mach kernels. + * It's still a hack, but at least it looks farily normal. We print the + * absolute value of the first 4 bytes of the pthread_t modded with 1000. + * + * Revision 1.40.2.1 2002/09/25 12:47:42 oes + * Make log_error safe against NULL string arguments + * + * Revision 1.40 2002/05/22 01:27:27 david__schmidt + * + * Add os2_socket_strerr mirroring w32_socket_strerr. + * + * Revision 1.39 2002/04/03 17:15:27 gliptak + * zero padding thread ids in log + * + * Revision 1.38 2002/03/31 17:18:59 jongfoster + * Win32 only: Enabling STRICT to fix a VC++ compile warning. + * + * Revision 1.37 2002/03/27 14:32:43 david__schmidt + * More compiler warning message maintenance + * + * Revision 1.36 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.35 2002/03/24 15:23:33 jongfoster + * Name changes + * + * Revision 1.34 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.33 2002/03/13 00:27:04 jongfoster + * Killing warnings + * + * Revision 1.32 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.31 2002/03/06 23:02:57 jongfoster + * Removing tabs + * + * Revision 1.30 2002/03/05 22:43:45 david__schmidt + * - Better error reporting on OS/2 + * - Fix double-slash comment (oops) + * + * Revision 1.29 2002/03/04 23:45:13 jongfoster + * Printing thread ID if using Win32 native threads + * + * Revision 1.28 2002/03/04 17:59:59 oes + * Deleted deletePidFile(), cosmetics + * + * Revision 1.27 2002/03/04 02:08:01 david__schmidt + * Enable web editing of actions file on OS/2 (it had been broken all this time!) + * + * Revision 1.26 2002/01/09 19:05:45 steudten + * Fix big memory leak. + * + * Revision 1.25 2002/01/09 14:32:08 oes + * Added support for gmtime_r and localtime_r. + * + * Revision 1.24 2001/12/30 14:07:32 steudten + * - Add signal handling (unix) + * - Add SIGHUP handler (unix) + * - Add creation of pidfile (unix) + * - Add action 'top' in rc file (RH) + * - Add entry 'SIGNALS' to manpage + * - Add exit message to logfile (unix) + * + * Revision 1.23 2001/11/07 00:02:13 steudten + * Add line number in error output for lineparsing for + * actionsfile and configfile. + * Special handling for CLF added. + * + * Revision 1.22 2001/11/05 23:43:05 steudten + * Add time+date to log files. + * + * Revision 1.21 2001/10/25 03:40:47 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.20 2001/09/16 23:04:34 jongfoster + * Fixing a warning + * + * Revision 1.19 2001/09/13 20:08:06 jongfoster + * Adding support for LOG_LEVEL_CGI + * + * Revision 1.18 2001/09/10 11:27:24 oes + * Declaration of w32_socket_strerr now conditional + * + * Revision 1.17 2001/09/10 10:17:13 oes + * Removed unused variable; Fixed sprintf format + * + * Revision 1.16 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.15 2001/07/29 17:41:10 jongfoster + * Now prints thread ID for each message (pthreads only) + * + * Revision 1.14 2001/07/19 19:03:48 haroon + * - Added case for LOG_LEVEL_POPUPS + * + * Revision 1.13 2001/07/13 13:58:58 oes + * - Added case for LOG_LEVEL_DEANIMATE + * - Removed all #ifdef PCRS + * + * Revision 1.12 2001/06/09 10:55:28 jongfoster + * Changing BUFSIZ ==> BUFFER_SIZE + * + * Revision 1.11 2001/06/01 18:14:49 jongfoster + * Changing the calls to strerr() to check HAVE_STRERR (which is defined + * in config.h if appropriate) rather than the NO_STRERR macro. + * + * Revision 1.10 2001/05/29 11:52:21 oes + * Conditional compilation of w32_socket_error + * + * Revision 1.9 2001/05/28 16:15:17 jongfoster + * Improved reporting of errors under Win32. + * + * Revision 1.8 2001/05/26 17:25:14 jongfoster + * Added support for CLF (Common Log Format) and fixed LOG_LEVEL_LOG + * + * Revision 1.7 2001/05/26 15:21:28 jongfoster + * Activity animation in Win32 GUI now works even if debug==0 + * + * Revision 1.6 2001/05/25 21:55:08 jongfoster + * Now cleans up properly on FATAL (removes taskbar icon etc) + * + * Revision 1.5 2001/05/22 18:46:04 oes + * + * - Enabled filtering banners by size rather than URL + * by adding patterns that replace all standard banner + * sizes with the "Junkbuster" gif to the re_filterfile + * + * - Enabled filtering WebBugs by providing a pattern + * which kills all 1x1 images + * + * - Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * - Added a new interceptor ijb-send-banner, which + * sends back the "Junkbuster" gif. Without imagelist or + * MSIE detection support, or if tinygif = 1, or the + * URL isn't recognized as an imageurl, a lame HTML + * explanation is sent instead. + * + * - Added new feature, which permits blocking remote + * script redirects and firing back a local redirect + * to the browser. + * The feature is conditionally compiled, i.e. it + * can be disabled with --disable-fast-redirects, + * plus it must be activated by a "fast-redirects" + * line in the config file, has its own log level + * and of course wants to be displayed by show-proxy-args + * Note: Boy, all the #ifdefs in 1001 locations and + * all the fumbling with configure.in and acconfig.h + * were *way* more work than the feature itself :-( + * + * - Because a generic redirect template was needed for + * this, tinygif = 3 now uses the same. + * + * - Moved GIFs, and other static HTTP response templates + * to project.h + * + * - Some minor fixes + * + * - Removed some >400 CRs again (Jon, you really worked + * a lot! ;-) + * + * Revision 1.4 2001/05/21 19:32:54 jongfoster + * Added another #ifdef _WIN_CONSOLE + * + * Revision 1.3 2001/05/20 01:11:40 jongfoster + * Added support for LOG_LEVEL_FATAL + * Renamed LOG_LEVEL_FRC to LOG_LEVEL_FORCE, + * and LOG_LEVEL_REF to LOG_LEVEL_RE_FILTER + * + * Revision 1.2 2001/05/17 22:42:01 oes + * - Cleaned CRLF's from the sources and related files + * - Repaired logging for REF and FRC + * + * Revision 1.1.1.1 2001/05/15 13:58:51 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include <stdlib.h> #include <stdio.h> #include <stdarg.h> #include <string.h> -#include <ctype.h>
#include "config.h" #include "miscutil.h" @@ -121,9 +525,9 @@ static inline void unlock_loginit(void) #else /* ! MUTEX_LOCKS_AVAILABLE */ /* * FIXME we need a cross-platform locking mechanism. - * The locking/unlocking functions below should be + * The locking/unlocking functions below should be * fleshed out for non-pthread implementations. - */ + */ static inline void lock_logfile() {} static inline void unlock_logfile() {} static inline void lock_loginit() {} @@ -134,7 +538,7 @@ static inline void unlock_loginit() {} * * Function : fatal_error * - * Description : Displays a fatal error to standard error (or, on + * Description : Displays a fatal error to standard error (or, on * a WIN32 GUI, to a dialog box), and exits Privoxy * with status code 1. * @@ -154,8 +558,8 @@ static void fatal_error(const char *error_message) /* Shouldn't happen but ... */ box_message = error_message; } - MessageBox(g_hwndLogFrame, box_message, "Privoxy Error", - MB_OK | MB_ICONERROR | MB_TASKMODAL | MB_SETFOREGROUND | MB_TOPMOST); + MessageBox(g_hwndLogFrame, box_message, "Privoxy Error", + MB_OK | MB_ICONERROR | MB_TASKMODAL | MB_SETFOREGROUND | MB_TOPMOST);
/* Cleanup - remove taskbar icon etc. */ TermLogWindow(); @@ -232,7 +636,7 @@ void init_log_module(void) * XXX: we should only use the LOG_LEVEL_MINIMUM * until the first time the configuration file has * been parsed. - * + * * Parameters : 1: debug_level = The debug level to set. * * Returns : Nothing. @@ -249,7 +653,7 @@ void set_debug_level(int debug_level) * Function : disable_logging * * Description : Disables logging. - * + * * Parameters : None. * * Returns : Nothing. @@ -317,7 +721,7 @@ void init_error_log(const char *prog_name, const char *logfname) * Currently we reopen it every time the config file * has been reloaded, but actually we only have to * reopen it if the file name changed or if the - * configuration reload was caused by a SIGHUP. + * configuration reloas was caused by a SIGHUP. */ log_error(LOG_LEVEL_INFO, "Failed to reopen logfile: '%s'. " "Retrying after closing the old file descriptor first. If that " @@ -343,21 +747,6 @@ void init_error_log(const char *prog_name, const char *logfname) { fclose(logfp); } -#ifdef unix - if (daemon_mode && (logfp == stderr)) - { - if (dup2(1, 2) == -1) - { - /* - * We only use fatal_error() to clear the pid - * file and to exit. Given that stderr has just - * been closed, the user will not see the error - * message. - */ - fatal_error("Failed to reserve fd 2."); - } - } -#endif logfp = fp; unlock_logfile();
@@ -375,7 +764,7 @@ void init_error_log(const char *prog_name, const char *logfname) * Description : Returns a number that is different for each thread. * * XXX: Should be moved elsewhere (miscutil.c?) - * + * * Parameters : None * * Returns : thread_id @@ -430,7 +819,7 @@ static long get_thread_id(void) static inline size_t get_log_timestamp(char *buffer, size_t buffer_size) { size_t length; - time_t now; + time_t now; struct tm tm_now; struct timeval tv_now; /* XXX: stupid name */ long msecs; @@ -438,22 +827,23 @@ static inline size_t get_log_timestamp(char *buffer, size_t buffer_size)
gettimeofday(&tv_now, NULL); msecs = tv_now.tv_usec / 1000; - now = tv_now.tv_sec; + + time(&now);
#ifdef HAVE_LOCALTIME_R tm_now = *localtime_r(&now, &tm_now); -#elif defined(MUTEX_LOCKS_AVAILABLE) +#elif FEATURE_PTHREAD privoxy_mutex_lock(&localtime_mutex); - tm_now = *localtime(&now); + tm_now = *localtime(&now); privoxy_mutex_unlock(&localtime_mutex); #else - tm_now = *localtime(&now); + tm_now = *localtime(&now); #endif
- length = strftime(buffer, buffer_size, "%Y-%m-%d %H:%M:%S", &tm_now); + length = strftime(buffer, buffer_size, "%b %d %H:%M:%S", &tm_now); if (length > (size_t)0) { - msecs_length = snprintf(buffer+length, buffer_size - length, ".%.3ld", msecs); + msecs_length = snprintf(buffer+length, buffer_size - length, ".%.3ld", msecs); } if (msecs_length > 0) { @@ -488,7 +878,7 @@ static inline size_t get_clf_timestamp(char *buffer, size_t buffer_size) * the %z field in strftime() */ time_t now; - struct tm *tm_now; + struct tm *tm_now; struct tm gmt; #ifdef HAVE_LOCALTIME_R struct tm dummy; @@ -497,10 +887,10 @@ static inline size_t get_clf_timestamp(char *buffer, size_t buffer_size) size_t length; int tz_length = 0;
- time (&now); + time (&now); #ifdef HAVE_GMTIME_R gmt = *gmtime_r(&now, &gmt); -#elif defined(MUTEX_LOCKS_AVAILABLE) +#elif FEATURE_PTHREAD privoxy_mutex_lock(&gmtime_mutex); gmt = *gmtime(&now); privoxy_mutex_unlock(&gmtime_mutex); @@ -509,16 +899,16 @@ static inline size_t get_clf_timestamp(char *buffer, size_t buffer_size) #endif #ifdef HAVE_LOCALTIME_R tm_now = localtime_r(&now, &dummy); -#elif defined(MUTEX_LOCKS_AVAILABLE) +#elif FEATURE_PTHREAD privoxy_mutex_lock(&localtime_mutex); - tm_now = localtime(&now); + tm_now = localtime(&now); privoxy_mutex_unlock(&localtime_mutex); #else - tm_now = localtime(&now); + tm_now = localtime(&now); #endif - days = tm_now->tm_yday - gmt.tm_yday; - hrs = ((days < -1 ? 24 : 1 < days ? -24 : days * 24) + tm_now->tm_hour - gmt.tm_hour); - mins = hrs * 60 + tm_now->tm_min - gmt.tm_min; + days = tm_now->tm_yday - gmt.tm_yday; + hrs = ((days < -1 ? 24 : 1 < days ? -24 : days * 24) + tm_now->tm_hour - gmt.tm_hour); + mins = hrs * 60 + tm_now->tm_min - gmt.tm_min;
length = strftime(buffer, buffer_size, "%d/%b/%Y:%H:%M:%S ", tm_now);
@@ -546,7 +936,7 @@ static inline size_t get_clf_timestamp(char *buffer, size_t buffer_size) * * Description : Translates a numerical loglevel into a string. * - * Parameters : + * Parameters : * 1 : loglevel = LOG_LEVEL_FOO * * Returns : Log level string. @@ -572,12 +962,9 @@ static inline const char *get_log_level_string(int loglevel) case LOG_LEVEL_CONNECT: log_level_string = "Connect"; break; - case LOG_LEVEL_WRITING: + case LOG_LEVEL_LOG: log_level_string = "Writing"; break; - case LOG_LEVEL_RECEIVED: - log_level_string = "Received"; - break; case LOG_LEVEL_HEADER: log_level_string = "Header"; break; @@ -592,9 +979,11 @@ static inline const char *get_log_level_string(int loglevel) log_level_string = "Force"; break; #endif /* def FEATURE_FORCE_LOAD */ +#ifdef FEATURE_FAST_REDIRECTS case LOG_LEVEL_REDIRECTS: log_level_string = "Redirect"; break; +#endif /* def FEATURE_FAST_REDIRECTS */ case LOG_LEVEL_DEANIMATE: log_level_string = "Gif-Deanimate"; break; @@ -682,7 +1071,7 @@ void log_error(int loglevel, const char *fmt, ...) /* protect the whole function because of the static buffer (outbuf) */ lock_logfile();
- if (NULL == outbuf_save) + if (NULL == outbuf_save) { outbuf_save = (char*)zalloc(log_buffer_size + 1); /* +1 for paranoia */ if (NULL == outbuf_save) @@ -767,7 +1156,7 @@ void log_error(int loglevel, const char *fmt, ...) { unsigned long long lluval = va_arg(ap, unsigned long long); snprintf(tempbuf, sizeof(tempbuf), "%llu", lluval); - src++; + ch = *src++; } else { @@ -792,36 +1181,45 @@ void log_error(int loglevel, const char *fmt, ...) break; case 'N': /* - * Non-standard: Print a counted unterminated string, - * replacing unprintable bytes with their hex value. + * Non-standard: Print a counted unterminated string. * Takes 2 parameters: int length, const char * string. */ ival = va_arg(ap, int); - assert(ival >= 0); sval = va_arg(ap, char *); - assert(sval != NULL); - - while ((ival-- > 0) && (length < log_buffer_size - 6)) + if (sval == NULL) { - if (isprint((int)*sval) && (*sval != '\')) + format_string = "[null]"; + } + else if (ival <= 0) + { + if (0 == ival) { - outbuf[length++] = *sval; - outbuf[length] = '\0'; + /* That's ok (but stupid) */ + tempbuf[0] = '\0'; } else { - int ret = snprintf(outbuf + length, - log_buffer_size - length - 2, "\x%.2x", (unsigned char)*sval); - assert(ret == 4); - length += 4; + /* + * That's not ok (and even more stupid) + */ + assert(ival >= 0); + format_string = "[counted string lenght < 0]"; } - sval++; } - /* - * XXX: In case of printable characters at the end of - * the %N string, we're not using the whole buffer. - */ - format_string = (length < log_buffer_size - 6) ? "" : "[too long]"; + else if ((size_t)ival >= sizeof(tempbuf)) + { + /* + * String is too long, copy as much as possible. + * It will be further truncated later. + */ + memcpy(tempbuf, sval, sizeof(tempbuf)-1); + tempbuf[sizeof(tempbuf)-1] = '\0'; + } + else + { + memcpy(tempbuf, sval, (size_t) ival); + tempbuf[ival] = '\0'; + } break; case 'E': /* Non-standard: Print error code from errno */ @@ -840,7 +1238,7 @@ void log_error(int loglevel, const char *fmt, ...) format_string = strerror(ival); } #else /* ifndef _WIN32 */ - ival = errno; + ival = errno; #ifdef HAVE_STRERROR format_string = strerror(ival); #else /* ifndef HAVE_STRERROR */ @@ -860,14 +1258,14 @@ void log_error(int loglevel, const char *fmt, ...) snprintf(tempbuf, sizeof(tempbuf), "Bad format string: "%s"", fmt); loglevel = LOG_LEVEL_FATAL; break; - } + } /* switch( p ) */
assert(length < log_buffer_size); length += strlcpy(outbuf + length, format_string, log_buffer_size - length);
if (length >= log_buffer_size-2) { - static const char warning[] = "... [too long, truncated]"; + static char warning[] = "... [too long, truncated]";
length = log_buffer_size - sizeof(warning) - 1; length += strlcpy(outbuf + length, warning, log_buffer_size - length); @@ -875,7 +1273,7 @@ void log_error(int loglevel, const char *fmt, ...)
break; } - } + } /* for( p ... ) */
/* done with var. args */ va_end(ap); @@ -945,14 +1343,14 @@ void log_error(int loglevel, const char *fmt, ...) * visible to all files that include errlog.h. * * Parameters : - * 1 : jb_error = a valid jb_err code + * 1 : error = a valid jb_err code * * Returns : A string with the jb_err translation * *********************************************************************/ -const char *jb_err_to_string(int jb_error) +const char *jb_err_to_string(int error) { - switch (jb_error) + switch (error) { case JB_ERR_OK: return "Success, no error"; diff --git a/external/privoxy/errlog.h b/external/privoxy/errlog.h index 41150cf..4906331 100644 --- a/external/privoxy/errlog.h +++ b/external/privoxy/errlog.h @@ -1,6 +1,6 @@ #ifndef ERRLOG_H_INCLUDED #define ERRLOG_H_INCLUDED -#define ERRLOG_H_VERSION "$Id: errlog.h,v 1.27 2011/09/04 11:10:56 fabiankeil Exp $" +#define ERRLOG_H_VERSION "$Id: errlog.h,v 1.22 2009/02/09 21:21:15 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/errlog.h,v $ @@ -12,10 +12,10 @@ * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -33,8 +33,134 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: errlog.h,v $ + * Revision 1.22 2009/02/09 21:21:15 fabiankeil + * Now that init_log_module() is called earlier, call show_version() + * later on from main() directly so it doesn't get called for --help + * or --version. + * + * Revision 1.21 2008/12/14 15:46:22 fabiankeil + * Give crunched requests their own log level. + * + * Revision 1.20 2008/03/27 18:27:23 fabiankeil + * Remove kill-popups action. + * + * Revision 1.19 2007/10/14 14:12:41 fabiankeil + * When in daemon mode, close stderr after the configuration file has been + * parsed the first time. If logfile isn't set, stop logging. Fixes BR#897436. + * + * Revision 1.18 2007/07/14 07:28:47 fabiankeil + * Add translation function for JB_ERR_FOO codes. + * + * Revision 1.17 2007/03/31 13:33:28 fabiankeil + * Add alternative log_error() with timestamps + * that contain milliseconds and without using + * strcpy(), strcat() or sprintf(). + * + * Revision 1.16 2006/11/28 15:29:50 fabiankeil + * Define LOG_LEVEL_REDIRECTS independently of + * FEATURE_FAST_REDIRECTS. It is used by redirect{} + * as well. + * + * Revision 1.15 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.13.2.1 2002/08/05 17:57:06 oes + * Cosmetic change + * + * Revision 1.13 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.12 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.11 2002/03/06 23:02:57 jongfoster + * Removing tabs + * + * Revision 1.10 2001/09/13 20:08:06 jongfoster + * Adding support for LOG_LEVEL_CGI + * + * Revision 1.9 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.8 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.7 2001/07/19 19:02:53 haroon + * Added define for LOG_LEVEL_POPUPS + * + * Revision 1.6 2001/07/13 13:59:22 oes + * - Added LOG_LEVEL_DEANIMATE + * - Changed LOG_LEVEL_CLF + * - Removed all #ifdef PCRS + * + * Revision 1.5 2001/05/26 17:25:14 jongfoster + * Added support for CLF (Common Log Format) and fixed LOG_LEVEL_LOG + * + * Revision 1.4 2001/05/25 21:56:06 jongfoster + * Added FIXME comment to (broken) LOG_LEVEL_LOG + * + * Revision 1.3 2001/05/22 18:46:04 oes + * + * - Enabled filtering banners by size rather than URL + * by adding patterns that replace all standard banner + * sizes with the "Junkbuster" gif to the re_filterfile + * + * - Enabled filtering WebBugs by providing a pattern + * which kills all 1x1 images + * + * - Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * - Added a new interceptor ijb-send-banner, which + * sends back the "Junkbuster" gif. Without imagelist or + * MSIE detection support, or if tinygif = 1, or the + * URL isn't recognized as an imageurl, a lame HTML + * explanation is sent instead. + * + * - Added new feature, which permits blocking remote + * script redirects and firing back a local redirect + * to the browser. + * The feature is conditionally compiled, i.e. it + * can be disabled with --disable-fast-redirects, + * plus it must be activated by a "fast-redirects" + * line in the config file, has its own log level + * and of course wants to be displayed by show-proxy-args + * Note: Boy, all the #ifdefs in 1001 locations and + * all the fumbling with configure.in and acconfig.h + * were *way* more work than the feature itself :-( + * + * - Because a generic redirect template was needed for + * this, tinygif = 3 now uses the same. + * + * - Moved GIFs, and other static HTTP response templates + * to project.h + * + * - Some minor fixes + * + * - Removed some >400 CRs again (Jon, you really worked + * a lot! ;-) + * + * Revision 1.2 2001/05/20 01:11:40 jongfoster + * Added support for LOG_LEVEL_FATAL + * Renamed LOG_LEVEL_FRC to LOG_LEVEL_FORCE, + * and LOG_LEVEL_REF to LOG_LEVEL_RE_FILTER + * + * Revision 1.1.1.1 2001/05/15 13:58:51 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -47,7 +173,7 @@ extern "C" { #define LOG_LEVEL_CONNECT 0x0002 #define LOG_LEVEL_IO 0x0004 #define LOG_LEVEL_HEADER 0x0008 -#define LOG_LEVEL_WRITING 0x0010 +#define LOG_LEVEL_LOG 0x0010 #ifdef FEATURE_FORCE_LOAD #define LOG_LEVEL_FORCE 0x0020 #endif /* def FEATURE_FORCE_LOAD */ @@ -57,7 +183,6 @@ extern "C" { #define LOG_LEVEL_CLF 0x0200 /* Common Log File format */ #define LOG_LEVEL_CRUNCH 0x0400 #define LOG_LEVEL_CGI 0x0800 /* CGI / templates */ -#define LOG_LEVEL_RECEIVED 0x8000
/* Following are always on: */ #define LOG_LEVEL_INFO 0x1000 @@ -70,7 +195,7 @@ extern void disable_logging(void); extern void init_log_module(void); extern void show_version(const char *prog_name); extern void log_error(int loglevel, const char *fmt, ...); -extern const char *jb_err_to_string(int jb_error); +extern const char *jb_err_to_string(int error);
/* Revision control strings from this header and associated .c file */ extern const char errlog_rcs[]; diff --git a/external/privoxy/filters.c b/external/privoxy/filters.c index 1b7e5ec..8fa1d4e 100644 --- a/external/privoxy/filters.c +++ b/external/privoxy/filters.c @@ -1,4 +1,4 @@ -const char filters_rcs[] = "$Id: filters.c,v 1.163 2011/12/26 17:03:08 fabiankeil Exp $"; +const char filters_rcs[] = "$Id: filters.c,v 1.113 2009/03/08 14:19:23 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/filters.c,v $ @@ -13,7 +13,7 @@ const char filters_rcs[] = "$Id: filters.c,v 1.163 2011/12/26 17:03:08 fabiankei * `execute_single_pcrs_command', `rewrite_url', * `get_last_url' * - * Copyright : Written by and Copyright (C) 2001-2011 the + * Copyright : Written by and Copyright (C) 2001, 2004-2008 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written @@ -38,8 +38,623 @@ const char filters_rcs[] = "$Id: filters.c,v 1.163 2011/12/26 17:03:08 fabiankei * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: filters.c,v $ + * Revision 1.113 2009/03/08 14:19:23 fabiankeil + * Fix justified (but harmless) compiler warnings + * on platforms where sizeof(int) < sizeof(long). + * + * Revision 1.112 2009/03/01 18:28:23 fabiankeil + * Help clang understand that we aren't dereferencing + * NULL pointers here. + * + * Revision 1.111 2008/12/04 18:13:46 fabiankeil + * Fix a cparser warning. + * + * Revision 1.110 2008/11/10 16:40:25 fabiankeil + * Fix a gcc44 warning. + * + * Revision 1.109 2008/11/08 15:48:41 fabiankeil + * Mention actual values when complaining about + * the chunk size exceeding the buffer size. + * + * Revision 1.108 2008/05/21 15:35:08 fabiankeil + * - Mark csp as immutable for block_acl(). + * - Remove an obsolete complaint about filter_popups(). + * + * Revision 1.107 2008/05/04 17:52:56 fabiankeil + * Adjust parse_http_url() call to new prototype. + * + * Revision 1.106 2008/05/03 16:40:44 fabiankeil + * Change content_filters_enabled()'s parameter from + * csp->action to action so it can be also used in the + * CGI code. Don't bother checking if there are filters + * loaded, as that's somewhat besides the point. + * + * Revision 1.105 2008/03/28 15:13:39 fabiankeil + * Remove inspect-jpegs action. + * + * Revision 1.104 2008/03/27 18:27:24 fabiankeil + * Remove kill-popups action. + * + * Revision 1.103 2008/03/06 16:33:45 fabiankeil + * If limit-connect isn't used, don't limit CONNECT requests to port 443. + * + * Revision 1.102 2008/03/01 14:00:44 fabiankeil + * Let the block action take the reason for the block + * as argument and show it on the "blocked" page. + * + * Revision 1.101 2008/02/23 16:57:12 fabiankeil + * Rename url_actions() to get_url_actions() and let it + * use the standard parameter ordering. + * + * Revision 1.100 2008/02/23 16:33:43 fabiankeil + * Let forward_url() use the standard parameter ordering + * and mark its second parameter immutable. + * + * Revision 1.99 2008/02/03 13:57:58 fabiankeil + * Add SOCKS5 support for forward-override{}. + * + * Revision 1.98 2008/01/04 17:43:45 fabiankeil + * Improve the warning messages that get logged if the action files + * "enable" filters but no filters of that type have been loaded. + * + * Revision 1.97 2007/11/30 15:37:03 fabiankeil + * Use freez instead of free. + * + * Revision 1.96 2007/10/19 16:53:28 fabiankeil + * Add helper function to check if any content filters are enabled. + * + * Revision 1.95 2007/10/17 19:31:20 fabiankeil + * Omitting the zero chunk that ends the chunk transfer encoding seems + * to be the new black. Log the problem and continue filtering anyway. + * + * Revision 1.94 2007/09/29 13:20:20 fabiankeil + * Remove two redundant and one useless log messages. + * + * Revision 1.93 2007/09/29 10:21:16 fabiankeil + * - Move get_filter_function() from jcc.c to filters.c + * so the filter functions can be static. + * - Don't bother filtering body-less responses. + * + * Revision 1.92 2007/09/28 16:38:55 fabiankeil + * - Execute content filters through execute_content_filter(). + * - Add prepare_for_filtering() so filter functions don't have to + * care about de-chunking and decompression. As a side effect this enables + * decompression for gif_deanimate_response() and jpeg_inspect_response(). + * - Change remove_chunked_transfer_coding()'s return type to jb_err. + * Some clowns feel like chunking empty responses in which case + * (size == 0) is valid but previously would be interpreted as error. + * + * Revision 1.91 2007/09/02 15:31:20 fabiankeil + * Move match_portlist() from filter.c to urlmatch.c. + * It's used for url matching, not for filtering. + * + * Revision 1.90 2007/09/02 12:44:17 fabiankeil + * Remove newline at the end of a log_error() message. + * + * Revision 1.89 2007/08/05 13:42:23 fabiankeil + * #1763173 from Stefan Huehner: declare some more functions static. + * + * Revision 1.88 2007/06/01 16:41:11 fabiankeil + * Add forward-override{} to change the forwarding settings through + * action sections. This is mainly interesting to forward different + * clients differently (for example based on User-Agent or request + * origin). + * + * Revision 1.87 2007/04/30 15:53:10 fabiankeil + * Make sure filters with dynamic jobs actually use them. + * + * Revision 1.86 2007/04/30 15:03:28 fabiankeil + * - Introduce dynamic pcrs jobs that can resolve variables. + * - Don't run redirect functions more than once, + * unless they are activated more than once. + * + * Revision 1.85 2007/03/21 12:24:47 fabiankeil + * - Log the content size after decompression in decompress_iob() + * instead of pcrs_filter_response(). + * + * Revision 1.84 2007/03/20 15:16:34 fabiankeil + * Use dedicated header filter actions instead of abusing "filter". + * Replace "filter-client-headers" and "filter-client-headers" + * with "server-header-filter" and "client-header-filter". + * + * Revision 1.83 2007/03/17 15:20:05 fabiankeil + * New config option: enforce-blocks. + * + * Revision 1.82 2007/03/13 11:28:43 fabiankeil + * - Fix port handling in acl_addr() and use a temporary acl spec + * copy so error messages don't contain a truncated version. + * - Log size of iob before and after decompression. + * + * Revision 1.81 2007/03/05 14:40:53 fabiankeil + * - Cosmetical changes for LOG_LEVEL_RE_FILTER messages. + * - Hide the "Go there anyway" link for blocked CONNECT + * requests where going there anyway doesn't work anyway. + * + * Revision 1.80 2007/02/07 10:55:20 fabiankeil + * - Save the reason for generating http_responses. + * - Block (+block) with status code 403 instead of 404. + * - Use a different kludge to remember a failed decompression. + * + * Revision 1.79 2007/01/31 16:21:38 fabiankeil + * Search for Max-Forwards headers case-insensitive, + * don't generate the "501 unsupported" message for invalid + * Max-Forwards values and don't increase negative ones. + * + * Revision 1.78 2007/01/28 13:41:18 fabiankeil + * - Add HEAD support to finish_http_response. + * - Add error favicon to internal HTML error messages. + * + * Revision 1.77 2007/01/12 15:36:44 fabiankeil + * Mark *csp as immutable for is_untrusted_url() + * and is_imageurl(). Closes FR 1237736. + * + * Revision 1.76 2007/01/01 19:36:37 fabiankeil + * Integrate a modified version of Wil Mahan's + * zlib patch (PR #895531). + * + * Revision 1.75 2006/12/29 18:30:46 fabiankeil + * Fixed gcc43 conversion warnings, + * changed sprintf calls to snprintf. + * + * Revision 1.74 2006/12/24 17:37:38 fabiankeil + * Adjust comment in pcrs_filter_response() + * to recent pcrs changes. Hohoho. + * + * Revision 1.73 2006/12/23 16:01:02 fabiankeil + * Don't crash if pcre returns an error code + * that pcrs didn't expect. Fixes BR 1621173. + * + * Revision 1.72 2006/12/22 18:52:53 fabiankeil + * Modified is_untrusted_url to complain in case of + * write errors and to give a reason when adding new + * entries to the trustfile. Closes FR 1097611. + * + * Revision 1.71 2006/12/22 14:24:52 fabiankeil + * Skip empty filter files in pcrs_filter_response, + * but don't ignore the ones that come afterwards. + * Fixes parts of BR 1619208. + * + * Revision 1.70 2006/12/09 13:33:15 fabiankeil + * Added some sanity checks for get_last_url(). + * Fixed possible segfault caused by my last commit. + * + * Revision 1.69 2006/12/08 12:39:13 fabiankeil + * Let get_last_url() catch https URLs as well. + * + * Revision 1.68 2006/12/05 14:45:48 fabiankeil + * Make sure get_last_url() behaves like advertised + * and fast-redirects{} can be combined with redirect{}. + * + * Revision 1.67 2006/11/28 15:19:43 fabiankeil + * Implemented +redirect{s@foo@bar@} to generate + * a redirect based on a rewritten version of the + * original URL. + * + * Revision 1.66 2006/09/23 13:26:38 roro + * Replace TABs by spaces in source code. + * + * Revision 1.65 2006/09/21 12:54:43 fabiankeil + * Fix +redirect{}. Didn't work with -fast-redirects. + * + * Revision 1.64 2006/08/31 10:55:49 fabiankeil + * Block requests for untrusted URLs with status + * code 403 instead of 200. + * + * Revision 1.63 2006/08/31 10:11:28 fabiankeil + * Don't free p which is still in use and will be later + * freed by free_map(). Don't claim the referrer is unknown + * when the client didn't set one. + * + * Revision 1.62 2006/08/14 00:27:47 david__schmidt + * Feature request 595948: Re-Filter logging in single line + * + * Revision 1.61 2006/08/03 02:46:41 david__schmidt + * Incorporate Fabian Keil's patch work:http://www.fabiankeil.de/sourcecode/privoxy/ + * + * Revision 1.60 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.58.2.9 2006/01/29 23:10:56 david__schmidt + * Multiple filter file support + * + * Revision 1.58.2.8 2005/05/07 21:50:55 david__schmidt + * A few memory leaks plugged (mostly on error paths) + * + * Revision 1.58.2.7 2004/10/03 12:53:32 david__schmidt + * Add the ability to check jpeg images for invalid + * lengths of comment blocks. Defensive strategy + * against the exploit: + * Microsoft Security Bulletin MS04-028 + * Buffer Overrun in JPEG Processing (GDI+) Could + * Allow Code Execution (833987) + * Enabled with +inspect-jpegs in actions files. + * + * Revision 1.58.2.6 2003/12/06 22:18:27 gliptak + * Correcting compile problem with FEATURE_IMAGE_BLOCKING + * + * Revision 1.58.2.5 2003/11/11 13:10:31 oes + * Fixed bug #839859: "See why" link URL now gets url-encoded. + * + * Revision 1.58.2.4 2003/02/28 12:52:45 oes + * Fixed a typo + * + * Revision 1.58.2.3 2002/09/25 14:51:51 oes + * Added basic support for OPTIONS and TRACE HTTP methods: + * New function direct_response which handles OPTIONS and + * TRACE requests whose Max-Forwards header field is zero. + * + * Revision 1.58.2.2 2002/08/01 17:18:28 oes + * Fixed BR 537651 / SR 579724 (MSIE image detect improper for IE/Mac) + * + * Revision 1.58.2.1 2002/07/26 15:18:53 oes + * - Bugfix: Executing a filters without jobs no longer results in + * turing off *all* filters. + * - Security fix: Malicious web servers can't cause a seg fault + * through bogus chunk sizes anymore + * + * Revision 1.58 2002/04/24 02:11:17 oes + * Jon's multiple AF patch: url_actions now evaluates rules + * from all AFs. + * + * Revision 1.57 2002/04/08 20:38:34 swa + * fixed JB spelling + * + * Revision 1.56 2002/04/05 15:51:24 oes + * - bugfix: error-pages now get correct request protocol + * - fix for invalid HTML in trust info + * + * Revision 1.55 2002/04/02 16:13:51 oes + * Fix: No "Go there anyway" for SSL + * + * Revision 1.54 2002/04/02 14:55:56 oes + * Bugfix: is_untrusted_url() now depends on FEATURE_TRUST, not FEATURE_COOKIE_JAR + * + * Revision 1.53 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.52 2002/03/24 16:35:57 jongfoster + * Removing logo + * + * Revision 1.51 2002/03/24 15:23:33 jongfoster + * Name changes + * + * Revision 1.50 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.49 2002/03/16 20:29:14 oes + * Cosmetics + * + * Revision 1.48 2002/03/13 20:25:34 oes + * Better logging for content filters + * + * Revision 1.47 2002/03/13 00:30:52 jongfoster + * Killing warnings + * Added option of always sending redirect for imageblock, + * currently disabled with #if 0. + * + * Revision 1.46 2002/03/12 01:42:49 oes + * Introduced modular filters + * + * Revision 1.45 2002/03/08 16:47:50 oes + * Added choice beween GIF and PNG built-in images + * + * Revision 1.44 2002/03/07 03:49:31 oes + * - Fixed compiler warnings etc + * - Changed built-in images from GIF to PNG + * (with regard to Unisys patent issue) + * - Added a 4x4 pattern PNG which is less intrusive + * than the logo but also clearly marks the deleted banners + * + * Revision 1.43 2002/01/22 23:51:59 jongfoster + * Replacing strsav() with the safer string_append(). + * + * Adding missing html_encode() to error message generators. Where encoded + * and unencoded versions of a string were provided, removing the unencoded + * one. + * + * Revision 1.42 2002/01/17 21:00:32 jongfoster + * Moving all our URL and URL pattern parsing code to urlmatch.c. + * + * Using a single, simple url_match(pattern,url) function - rather than + * the 3-line match routine which was repeated all over the place. + * + * Renaming free_url to free_url_spec, since it frees a struct url_spec. + * + * Using parse_http_url() to parse URLs without faking a HTTP + * request line for parse_http_request(). + * + * Revision 1.41 2001/11/13 00:14:07 jongfoster + * Fixing stupid bug now I've figured out what || means. + * (It always returns 0 or 1, not one of it's paramaters.) + * + * Revision 1.40 2001/10/26 17:37:55 oes + * - Re-enabled Netscape 200/404 bug workaround in block_url(): + * - Removed OS/2 special case + * - Made block_url() independant from sed() having been run + * - Made trust_url independant from sed() having been run + * - Made is_imageurl independant from sed() having been run. + * It now checks User-Agent: and Accept: by itself. + * + * + * Revision 1.39 2001/10/25 03:40:48 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.38 2001/10/23 21:32:33 jongfoster + * Adding error-checking to selected functions + * + * Revision 1.37 2001/10/22 15:33:56 david__schmidt + * Special-cased OS/2 out of the Netscape-abort-on-404-in-js problem in + * filters.c. Added a FIXME in front of the offending code. I'll gladly + * put in a better/more robust fix for all parties if one is presented... + * It seems that just returning 200 instead of 404 would pretty much fix + * it for everyone, but I don't know all the history of the problem. + * + * Revision 1.36 2001/10/10 16:44:16 oes + * Added match_portlist function + * + * Revision 1.35 2001/10/07 15:41:23 oes + * Replaced 6 boolean members of csp with one bitmap (csp->flags) + * + * New function remove_chunked_transfer_coding that strips chunked + * transfer coding to plain and is called by pcrs_filter_response + * and gif_deanimate_response if neccessary + * + * Improved handling of zero-change re_filter runs + * + * pcrs_filter_response and gif_deanimate_response now remove + * chunked transfer codeing before processing the body. + * + * Revision 1.34 2001/09/20 15:49:36 steudten + * + * Fix BUG: Change int size to size_t size in pcrs_filter_response(). + * See cgi.c fill_template(). + * + * Revision 1.33 2001/09/16 17:05:14 jongfoster + * Removing unused #include showarg.h + * + * Revision 1.32 2001/09/16 13:21:27 jongfoster + * Changes to use new list functions. + * + * Revision 1.31 2001/09/16 11:38:02 jongfoster + * Splitting fill_template() into 2 functions: + * template_load() loads the file + * template_fill() performs the PCRS regexps. + * This is because the CGI edit interface has a "table row" + * template which is used many times in the page - this + * change means it's only loaded from disk once. + * + * Revision 1.30 2001/09/16 11:00:10 jongfoster + * New function alloc_http_response, for symmetry with free_http_response + * + * Revision 1.29 2001/09/13 23:32:40 jongfoster + * Moving image data to cgi.c rather than cgi.h + * Fixing a GPF under Win32 (and any other OS that protects global + * constants from being written to). + * + * Revision 1.28 2001/09/10 10:18:51 oes + * Silenced compiler warnings + * + * Revision 1.27 2001/08/05 16:06:20 jongfoster + * Modifiying "struct map" so that there are now separate header and + * "map_entry" structures. This means that functions which modify a + * map no longer need to return a pointer to the modified map. + * Also, it no longer reverses the order of the entries (which may be + * important with some advanced template substitutions). + * + * Revision 1.26 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.25 2001/07/26 10:09:46 oes + * Made browser detection a little less naive + * + * Revision 1.24 2001/07/25 17:22:51 oes + * Added workaround for Netscape bug that prevents display of page when loading a component fails. + * + * Revision 1.23 2001/07/23 13:40:12 oes + * Fixed bug that caused document body to be dropped when pcrs joblist was empty. + * + * Revision 1.22 2001/07/18 12:29:34 oes + * - Made gif_deanimate_response respect + * csp->action->string[ACTION_STRING_DEANIMATE] + * - Logging cosmetics + * + * Revision 1.21 2001/07/13 13:59:53 oes + * - Introduced gif_deanimate_response which shares the + * generic content modification interface of pcrs_filter_response + * and acts as a wrapper to deanimate.c:gif_deanimate() + * - Renamed re_process_buffer to pcrs_filter_response + * - pcrs_filter_response now returns NULL on failiure + * - Removed all #ifdef PCRS + * + * Revision 1.20 2001/07/01 17:01:04 oes + * Added comments and missing return statement in is_untrusted_url() + * + * Revision 1.19 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.18 2001/06/29 13:27:38 oes + * - Cleaned up, renamed and reorderd functions + * and improved comments + * + * - block_url: + * - Ported to CGI platform. Now delivers + * http_response or NULL + * - Unified HTML and GIF generation (moved image detection + * and GIF generation here from jcc.c:chat()) + * - Fixed HTTP status to: + * - 403 (Forbidden) for the "blocked" HTML message + * - 200 (OK) for GIF answers + * - 302 (Redirect) for redirect to GIF + * + * - trust_url: + * - Ported to CGI platform. Now delivers + * http_response or NULL + * - Separated detection of untrusted URL into + * (bool)is_untrusted_url + * - Added enforcement of untrusted requests + * + * - Moved redirect_url() from cgi.c to here + * and ported it to the CGI platform + * + * - Removed logentry from cancelled commit + * + * Revision 1.17 2001/06/09 10:55:28 jongfoster + * Changing BUFSIZ ==> BUFFER_SIZE + * + * Revision 1.16 2001/06/07 23:10:26 jongfoster + * Allowing unanchored domain patterns to back off and retry + * if they partially match. Optimized right-anchored patterns. + * Moving ACL and forward files into config file. + * Replacing struct gateway with struct forward_spec + * + * Revision 1.15 2001/06/03 19:12:00 oes + * extracted-CGI relevant stuff + * + * Revision 1.14 2001/06/01 10:30:55 oes + * Added optional left-anchoring to domaincmp + * + * Revision 1.13 2001/05/31 21:21:30 jongfoster + * Permissionsfile / actions file changes: + * - Changed "permission" to "action" throughout + * - changes to file format to allow string parameters + * - Moved helper functions to actions.c + * + * Revision 1.12 2001/05/31 17:35:20 oes + * + * - Enhanced domain part globbing with infix and prefix asterisk + * matching and optional unanchored operation + * + * Revision 1.11 2001/05/29 11:53:23 oes + * "See why" link added to "blocked" page + * + * Revision 1.10 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.9 2001/05/27 22:17:04 oes + * + * - re_process_buffer no longer writes the modified buffer + * to the client, which was very ugly. It now returns the + * buffer, which it is then written by chat. + * + * - content_length now adjusts the Content-Length: header + * for modified documents rather than crunch()ing it. + * (Length info in csp->content_length, which is 0 for + * unmodified documents) + * + * - For this to work, sed() is called twice when filtering. + * + * Revision 1.8 2001/05/26 17:13:28 jongfoster + * Filled in a function comment. + * + * Revision 1.7 2001/05/26 15:26:15 jongfoster + * ACL feature now provides more security by immediately dropping + * connections from untrusted hosts. + * + * Revision 1.6 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.5 2001/05/25 22:34:30 jongfoster + * Hard tabs->Spaces + * + * Revision 1.4 2001/05/22 18:46:04 oes + * + * - Enabled filtering banners by size rather than URL + * by adding patterns that replace all standard banner + * sizes with the "Junkbuster" gif to the re_filterfile + * + * - Enabled filtering WebBugs by providing a pattern + * which kills all 1x1 images + * + * - Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * - Added a new interceptor ijb-send-banner, which + * sends back the "Junkbuster" gif. Without imagelist or + * MSIE detection support, or if tinygif = 1, or the + * URL isn't recognized as an imageurl, a lame HTML + * explanation is sent instead. + * + * - Added new feature, which permits blocking remote + * script redirects and firing back a local redirect + * to the browser. + * The feature is conditionally compiled, i.e. it + * can be disabled with --disable-fast-redirects, + * plus it must be activated by a "fast-redirects" + * line in the config file, has its own log level + * and of course wants to be displayed by show-proxy-args + * Note: Boy, all the #ifdefs in 1001 locations and + * all the fumbling with configure.in and acconfig.h + * were *way* more work than the feature itself :-( + * + * - Because a generic redirect template was needed for + * this, tinygif = 3 now uses the same. + * + * - Moved GIFs, and other static HTTP response templates + * to project.h + * + * - Some minor fixes + * + * - Removed some >400 CRs again (Jon, you really worked + * a lot! ;-) + * + * Revision 1.3 2001/05/20 16:44:47 jongfoster + * Removing last hardcoded Junkbusters.com URLs. + * + * Revision 1.2 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.1.1.1 2001/05/15 13:58:52 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -93,158 +708,10 @@ const char filters_h_rcs[] = FILTERS_H_VERSION; */ #define ijb_isdigit(__X) isdigit((int)(unsigned char)(__X))
-typedef char *(*filter_function_ptr)(); -static filter_function_ptr get_filter_function(const struct client_state *csp); static jb_err remove_chunked_transfer_coding(char *buffer, size_t *size); static jb_err prepare_for_filtering(struct client_state *csp);
#ifdef FEATURE_ACL -#ifdef HAVE_RFC2553 -/********************************************************************* - * - * Function : sockaddr_storage_to_ip - * - * Description : Access internal structure of sockaddr_storage - * - * Parameters : - * 1 : addr = socket address - * 2 : ip = IP address as array of octets in network order - * (it points into addr) - * 3 : len = length of IP address in octets - * 4 : port = port number in network order; - * - * Returns : 0 = no errror; -1 otherwise. - * - *********************************************************************/ -static int sockaddr_storage_to_ip(const struct sockaddr_storage *addr, - uint8_t **ip, unsigned int *len, - in_port_t **port) -{ - if (NULL == addr) - { - return(-1); - } - - switch (addr->ss_family) - { - case AF_INET: - if (NULL != len) - { - *len = 4; - } - if (NULL != ip) - { - *ip = (uint8_t *) - &(((struct sockaddr_in *)addr)->sin_addr.s_addr); - } - if (NULL != port) - { - *port = &((struct sockaddr_in *)addr)->sin_port; - } - break; - - case AF_INET6: - if (NULL != len) - { - *len = 16; - } - if (NULL != ip) - { - *ip = ((struct sockaddr_in6 *)addr)->sin6_addr.s6_addr; - } - if (NULL != port) - { - *port = &((struct sockaddr_in6 *)addr)->sin6_port; - } - break; - - default: - /* Unsupported address family */ - return(-1); - } - - return(0); -} - - -/********************************************************************* - * - * Function : match_sockaddr - * - * Description : Check whether address matches network (IP address and port) - * - * Parameters : - * 1 : network = socket address of subnework - * 2 : netmask = network mask as socket address - * 3 : address = checked socket address against given network - * - * Returns : 0 = doesn't match; 1 = does match - * - *********************************************************************/ -static int match_sockaddr(const struct sockaddr_storage *network, - const struct sockaddr_storage *netmask, - const struct sockaddr_storage *address) -{ - uint8_t *network_addr, *netmask_addr, *address_addr; - unsigned int addr_len; - in_port_t *network_port, *netmask_port, *address_port; - int i; - - if (network->ss_family != netmask->ss_family) - { - /* This should never happen */ - log_error(LOG_LEVEL_ERROR, - "Internal error at %s:%llu: network and netmask differ in family", - __FILE__, __LINE__); - return 0; - } - - sockaddr_storage_to_ip(network, &network_addr, &addr_len, &network_port); - sockaddr_storage_to_ip(netmask, &netmask_addr, NULL, &netmask_port); - sockaddr_storage_to_ip(address, &address_addr, NULL, &address_port); - - /* Check for family */ - if ((network->ss_family == AF_INET) && (address->ss_family == AF_INET6) - && IN6_IS_ADDR_V4MAPPED((struct in6_addr *)address_addr)) - { - /* Map AF_INET6 V4MAPPED address into AF_INET */ - address_addr += 12; - addr_len = 4; - } - else if ((network->ss_family == AF_INET6) && (address->ss_family == AF_INET) - && IN6_IS_ADDR_V4MAPPED((struct in6_addr *)network_addr)) - { - /* Map AF_INET6 V4MAPPED network into AF_INET */ - network_addr += 12; - netmask_addr += 12; - addr_len = 4; - } - else if (network->ss_family != address->ss_family) - { - return 0; - } - - /* XXX: Port check is signaled in netmask */ - if (*netmask_port && *network_port != *address_port) - { - return 0; - } - - /* TODO: Optimize by checking by words insted of octets */ - for (i = 0; (i < addr_len) && netmask_addr[i]; i++) - { - if ((network_addr[i] & netmask_addr[i]) != - (address_addr[i] & netmask_addr[i])) - { - return 0; - } - } - - return 1; -} -#endif /* def HAVE_RFC2553 */ - - /********************************************************************* * * Function : block_acl @@ -274,13 +741,7 @@ int block_acl(const struct access_control_addr *dst, const struct client_state * /* search the list */ while (acl != NULL) { - if ( -#ifdef HAVE_RFC2553 - match_sockaddr(&acl->src->addr, &acl->src->mask, &csp->tcp_addr) -#else - (csp->ip_addr_long & acl->src->mask) == acl->src->addr -#endif - ) + if ((csp->ip_addr_long & acl->src->mask) == acl->src->addr) { if (dst == NULL) { @@ -289,28 +750,9 @@ int block_acl(const struct access_control_addr *dst, const struct client_state * { return(0); } - else - { - return(1); - } } - else if ( -#ifdef HAVE_RFC2553 - /* - * XXX: An undefined acl->dst is full of zeros and should be - * considered a wildcard address. sockaddr_storage_to_ip() - * fails on such destinations because of unknown sa_familly - * (glibc only?). However this test is not portable. - * - * So, we signal the acl->dst is wildcard in wildcard_dst. - */ - acl->wildcard_dst || - match_sockaddr(&acl->dst->addr, &acl->dst->mask, &dst->addr) -#else - ((dst->addr & acl->dst->mask) == acl->dst->addr) - && ((dst->port == acl->dst->port) || (acl->dst->port == 0)) -#endif - ) + else if ( ((dst->addr & acl->dst->mask) == acl->dst->addr) + && ((dst->port == acl->dst->port) || (acl->dst->port == 0))) { if (acl->action == ACL_PERMIT) { @@ -346,24 +788,12 @@ int block_acl(const struct access_control_addr *dst, const struct client_state * int acl_addr(const char *aspec, struct access_control_addr *aca) { int i, masklength; -#ifdef HAVE_RFC2553 - struct addrinfo hints, *result; - uint8_t *mask_data; - in_port_t *mask_port; - unsigned int addr_len; -#else long port; -#endif /* def HAVE_RFC2553 */ char *p; char *acl_spec = NULL;
-#ifdef HAVE_RFC2553 - /* XXX: Depend on ai_family */ - masklength = 128; -#else masklength = 32; port = 0; -#endif
/* * Use a temporary acl spec copy so we can log @@ -387,54 +817,13 @@ int acl_addr(const char *aspec, struct access_control_addr *aca) masklength = atoi(p); }
- if ((masklength < 0) || -#ifdef HAVE_RFC2553 - (masklength > 128) -#else - (masklength > 32) -#endif - ) + if ((masklength < 0) || (masklength > 32)) { freez(acl_spec); return(-1); }
- if ((*acl_spec == '[') && (NULL != (p = strchr(acl_spec, ']')))) - { - *p = '\0'; - memmove(acl_spec, acl_spec + 1, (size_t)(p - acl_spec)); - - if (*++p != ':') - { - p = NULL; - } - } - else - { - p = strchr(acl_spec, ':'); - } - -#ifdef HAVE_RFC2553 - memset(&hints, 0, sizeof(struct addrinfo)); - hints.ai_family = AF_UNSPEC; - hints.ai_socktype = SOCK_STREAM; - - i = getaddrinfo(acl_spec, ((p) ? ++p : NULL), &hints, &result); - - if (i != 0) - { - log_error(LOG_LEVEL_ERROR, "Can not resolve [%s]:%s: %s", - acl_spec, p, gai_strerror(i)); - freez(acl_spec); - return(-1); - } - freez(acl_spec); - - /* TODO: Allow multihomed hostnames */ - memcpy(&(aca->addr), result->ai_addr, result->ai_addrlen); - freeaddrinfo(result); -#else - if (p != NULL) + if ((p = strchr(acl_spec, ':')) != NULL) { char *endptr;
@@ -458,56 +847,8 @@ int acl_addr(const char *aspec, struct access_control_addr *aca) /* XXX: This will be logged as parse error. */ return(-1); } -#endif /* def HAVE_RFC2553 */
/* build the netmask */ -#ifdef HAVE_RFC2553 - /* Clip masklength according to current family. */ - if ((aca->addr.ss_family == AF_INET) && (masklength > 32)) - { - masklength = 32; - } - - aca->mask.ss_family = aca->addr.ss_family; - if (sockaddr_storage_to_ip(&aca->mask, &mask_data, &addr_len, &mask_port)) - { - return(-1); - } - - if (p) - { - /* ACL contains a port number, check ports in the future. */ - *mask_port = 1; - } - - /* - * XXX: This could be optimized to operate on whole words instead - * of octets (128-bit CPU could do it in one iteration). - */ - /* - * Octets after prefix can be omitted because of - * previous initialization to zeros. - */ - for (i = 0; (i < addr_len) && masklength; i++) - { - if (masklength >= 8) - { - mask_data[i] = 0xFF; - masklength -= 8; - } - else - { - /* - * XXX: This assumes MSB of octet is on the left side. - * This should be true for all architectures or solved - * by the link layer. - */ - mask_data[i] = (uint8_t)~((1 << (8 - masklength)) - 1); - masklength = 0; - } - } - -#else aca->mask = 0; for (i=1; i <= masklength ; i++) { @@ -518,7 +859,6 @@ int acl_addr(const char *aspec, struct access_control_addr *aca) * (i.e. save on the network portion of the address). */ aca->addr = aca->addr & aca->mask; -#endif /* def HAVE_RFC2553 */
return(0);
@@ -574,7 +914,7 @@ struct http_response *block_url(struct client_state *csp) } if (csp->action->flags & ACTION_REDIRECT) { - log_error(LOG_LEVEL_ERROR, "redirect{} overruled by block."); + log_error(LOG_LEVEL_ERROR, "redirect{} overruled by block."); } /* * Else, prepare a response @@ -600,6 +940,7 @@ struct http_response *block_url(struct client_state *csp) { log_error(LOG_LEVEL_ERROR, "handle-as-empty-document overruled by handle-as-image."); } +#if 1 /* Two alternative strategies, use this one for now: */
/* and handle accordingly: */ if ((p == NULL) || (0 == strcmpic(p, "pattern"))) @@ -624,6 +965,7 @@ struct http_response *block_url(struct client_state *csp) return cgi_error_memory(); } } + else if (0 == strcmpic(p, "blank")) { rsp->status = strdup("403 Request blocked by Privoxy"); @@ -646,6 +988,7 @@ struct http_response *block_url(struct client_state *csp) return cgi_error_memory(); } } + else { rsp->status = strdup("302 Local Redirect from Privoxy"); @@ -662,13 +1005,35 @@ struct http_response *block_url(struct client_state *csp) } }
+#else /* Following code is disabled for now */ + + /* and handle accordingly: */ + if ((p == NULL) || (0 == strcmpic(p, "pattern"))) + { + p = CGI_PREFIX "send-banner?type=pattern"; + } + else if (0 == strcmpic(p, "blank")) + { + p = CGI_PREFIX "send-banner?type=blank"; + } + rsp->status = strdup("302 Local Redirect from Privoxy"); + if (rsp->status == NULL) + { + free_http_response(rsp); + return cgi_error_memory(); + } + + if (enlist_unique_header(rsp->headers, "Location", p)) + { + free_http_response(rsp); + return cgi_error_memory(); + } +#endif /* Preceeding code is disabled for now */ } - else -#endif /* def FEATURE_IMAGE_BLOCKING */ - if(csp->action->flags & ACTION_HANDLE_AS_EMPTY_DOCUMENT) + else if(csp->action->flags & ACTION_HANDLE_AS_EMPTY_DOCUMENT) { /* - * Send empty document. + * Send empty document. */ new_content_type = csp->action->string[ACTION_STRING_CONTENT_TYPE];
@@ -676,21 +1041,7 @@ struct http_response *block_url(struct client_state *csp) rsp->body = strdup(" "); rsp->content_length = 1;
- if (csp->config->feature_flags & RUNTIME_FEATURE_EMPTY_DOC_RETURNS_OK) - { - /* - * Workaround for firefox bug 492459 - * https://bugzilla.mozilla.org/show_bug.cgi?id=492459 - * Return a 200 OK status for pages blocked with +handle-as-empty-document - * if the "handle-as-empty-doc-returns-ok" runtime config option is set. - */ - rsp->status = strdup("200 Request blocked by Privoxy"); - } - else - { - rsp->status = strdup("403 Request blocked by Privoxy"); - } - + rsp->status = strdup("403 Request blocked by Privoxy"); if (rsp->status == NULL) { free_http_response(rsp); @@ -707,6 +1058,7 @@ struct http_response *block_url(struct client_state *csp) } } else +#endif /* def FEATURE_IMAGE_BLOCKING */
/* * Else, generate an HTML "blocked" message: @@ -714,8 +1066,27 @@ struct http_response *block_url(struct client_state *csp) { jb_err err; struct map * exports; + char *p; + + /* + * Workaround for stupid Netscape bug which prevents + * pages from being displayed if loading a referenced + * JavaScript or style sheet fails. So make it appear + * as if it succeeded. + */ + if ( NULL != (p = get_header_value(csp->headers, "User-Agent:")) + && !strncmpic(p, "mozilla", 7) /* Catch Netscape but */ + && !strstr(p, "Gecko") /* save Mozilla, */ + && !strstr(p, "compatible") /* MSIE */ + && !strstr(p, "Opera")) /* and Opera. */ + { + rsp->status = strdup("200 Request for blocked URL"); + } + else + { + rsp->status = strdup("403 Request for blocked URL"); + }
- rsp->status = strdup("403 Request blocked by Privoxy"); if (rsp->status == NULL) { free_http_response(rsp); @@ -777,7 +1148,7 @@ struct http_response *block_url(struct client_state *csp) return cgi_error_memory(); } } - rsp->crunch_reason = BLOCKED; + rsp->reason = RSP_REASON_BLOCKED;
return finish_http_response(csp, rsp);
@@ -836,7 +1207,7 @@ struct http_response *trust_url(struct client_state *csp) * Export the protocol, host, port, and referrer information */ err = map(exports, "hostport", 1, csp->http->hostport, 1); - if (!err) err = map(exports, "protocol", 1, csp->http->ssl ? "https://" : "http://", 1); + if (!err) err = map(exports, "protocol", 1, csp->http->ssl ? "https://" : "http://", 1); if (!err) err = map(exports, "path", 1, csp->http->path, 1);
if (NULL != (p = get_header_value(csp->headers, "Referer:"))) @@ -937,7 +1308,7 @@ struct http_response *trust_url(struct client_state *csp) free_http_response(rsp); return cgi_error_memory(); } - rsp->crunch_reason = UNTRUSTED; + rsp->reason = RSP_REASON_UNTRUSTED;
return finish_http_response(csp, rsp); } @@ -956,7 +1327,7 @@ struct http_response *trust_url(struct client_state *csp) * 2 : b = The filter list to compile * * Returns : NULL in case of errors, otherwise the - * pcrs job list. + * pcrs job list. * *********************************************************************/ pcrs_job *compile_dynamic_pcrs_job_list(const struct client_state *csp, const struct re_filterfile_spec *b) @@ -983,9 +1354,10 @@ pcrs_job *compile_dynamic_pcrs_job_list(const struct client_state *csp, const st dummy = pcrs_compile_dynamic_command(pattern->str, variables, &error); if (NULL == dummy) { + assert(error < 0); log_error(LOG_LEVEL_ERROR, - "Compiling dynamic pcrs job '%s' for '%s' failed with error code %d: %s", - pattern->str, b->name, error, pcrs_strerror(error)); + "Adding filter job '%s' to dynamic filter %s failed: %s", + pattern->str, b->name, pcrs_strerror(error)); continue; } else @@ -1025,7 +1397,7 @@ pcrs_job *compile_dynamic_pcrs_job_list(const struct client_state *csp, const st * 2 : pcrs_command = pcrs command formatted as string (s@foo@bar@) * * - * Returns : NULL if the pcrs_command didn't change the url, or + * Returns : NULL if the pcrs_command didn't change the url, or * the result of the modification. * *********************************************************************/ @@ -1084,7 +1456,7 @@ char *rewrite_url(char *old_url, const char *pcrs_command) * * Parameters : * 1 : subject = the string to check - * 2 : redirect_mode = +fast-redirect{} mode + * 2 : redirect_mode = +fast-redirect{} mode * * Returns : NULL if no URL was found, or * the last URL found. @@ -1105,79 +1477,23 @@ char *get_last_url(char *subject, const char *redirect_mode) return NULL; }
- if (0 == strcmpic(redirect_mode, "check-decoded-url") && strchr(subject, '%')) + if (0 == strcmpic(redirect_mode, "check-decoded-url")) { - log_error(LOG_LEVEL_REDIRECTS, - "Checking "%s" for encoded redirects.", subject); - - /* - * Check each parameter in the URL separately. - * Sectionize the URL at "?" and "&", - * go backwards through the segments, URL-decode them - * and look for a URL in the decoded result. - * Stop the search after the first match. - */ - char *url_segment = NULL; - /* - * XXX: This estimate is guaranteed to be high enough as we - * let ssplit() ignore empty fields, but also a bit wasteful. - */ - size_t max_segments = strlen(subject) / 2; - char **url_segments = malloc(max_segments * sizeof(char *)); - int segments; - - if (NULL == url_segments) + log_error(LOG_LEVEL_REDIRECTS, "Decoding "%s" if necessary.", subject); + new_url = url_decode(subject); + if (new_url != NULL) { - log_error(LOG_LEVEL_ERROR, "Out of memory while decoding URL: %s", new_url); freez(subject); - return NULL; - } - - segments = ssplit(subject, "?&", url_segments, max_segments, 1, 1); - - while (segments-- > 0) - { - char *dtoken = url_decode(url_segments[segments]); - if (NULL == dtoken) - { - log_error(LOG_LEVEL_ERROR, "Unable to decode "%s".", url_segments[segments]); - continue; - } - url_segment = strstr(dtoken, "http://"); - if (NULL == url_segment) - { - url_segment = strstr(dtoken, "https://"); - } - if (NULL != url_segment) - { - url_segment = strdup(url_segment); - freez(dtoken); - if (url_segment == NULL) - { - log_error(LOG_LEVEL_ERROR, - "Out of memory while searching for redirects."); - return NULL; - } - break; - } - freez(dtoken); + subject = new_url; } - freez(subject); - freez(url_segments); - - if (url_segment == NULL) + else { - return NULL; + log_error(LOG_LEVEL_ERROR, "Unable to decode "%s".", subject); } - subject = url_segment; - } - else - { - /* Look for a URL inside this one, without decoding anything. */ - log_error(LOG_LEVEL_REDIRECTS, - "Checking "%s" for unencoded redirects.", subject); }
+ log_error(LOG_LEVEL_REDIRECTS, "Checking "%s" for redirects.", subject); + /* * Find the last URL encoded in the request */ @@ -1199,7 +1515,7 @@ char *get_last_url(char *subject, const char *redirect_mode) )) { /* - * Return new URL if we found a redirect + * Return new URL if we found a redirect * or if the subject already was a URL. * * The second case makes sure that we can @@ -1305,24 +1621,9 @@ struct http_response *redirect_url(struct client_state *csp) #endif /* def FEATURE_FAST_REDIRECTS */ csp->action->flags &= ~ACTION_REDIRECT;
- /* Did any redirect action trigger? */ + /* Did any redirect action trigger? */ if (new_url) { - if (url_requires_percent_encoding(new_url)) - { - char *encoded_url; - log_error(LOG_LEVEL_REDIRECTS, "Percent-encoding redirect URL: %N", - strlen(new_url), new_url); - encoded_url = percent_encode_url(new_url); - freez(new_url); - if (encoded_url == NULL) - { - return cgi_error_memory(); - } - new_url = encoded_url; - assert(FALSE == url_requires_percent_encoding(new_url)); - } - if (0 == strcmpic(new_url, csp->http->url)) { log_error(LOG_LEVEL_ERROR, @@ -1340,14 +1641,14 @@ struct http_response *redirect_url(struct client_state *csp) return cgi_error_memory(); }
- if (enlist_unique_header(rsp->headers, "Location", new_url) - || (NULL == (rsp->status = strdup("302 Local Redirect from Privoxy")))) + if ( enlist_unique_header(rsp->headers, "Location", new_url) + || (NULL == (rsp->status = strdup("302 Local Redirect from Privoxy"))) ) { freez(new_url); free_http_response(rsp); return cgi_error_memory(); } - rsp->crunch_reason = REDIRECTED; + rsp->reason = RSP_REASON_REDIRECTED; freez(new_url);
return finish_http_response(csp, rsp); @@ -1562,8 +1863,7 @@ int is_untrusted_url(const struct client_state *csp) *********************************************************************/ static char *pcrs_filter_response(struct client_state *csp) { - int hits = 0; - int i; + int hits=0; size_t size, prev_size;
char *old = NULL; @@ -1574,7 +1874,9 @@ static char *pcrs_filter_response(struct client_state *csp) struct re_filterfile_spec *b; struct list_entry *filtername;
- /* + int i, found_filters = 0; + + /* * Sanity first */ if (csp->iob->cur >= csp->iob->eod) @@ -1582,7 +1884,23 @@ static char *pcrs_filter_response(struct client_state *csp) return(NULL); }
- if (filters_available(csp) == FALSE) + /* + * Need to check the set of re_filterfiles... + */ + for (i = 0; i < MAX_AF_FILES; i++) + { + fl = csp->rlist[i]; + if (NULL != fl) + { + if (NULL != fl->f) + { + found_filters = 1; + break; + } + } + } + + if (0 == found_filters) { log_error(LOG_LEVEL_ERROR, "Inconsistent configuration: " "content filtering enabled, but no content filters available."); @@ -1790,11 +2108,43 @@ static char *gif_deanimate_response(struct client_state *csp) * NULL if no content filter is active * *********************************************************************/ -static filter_function_ptr get_filter_function(const struct client_state *csp) +filter_function_ptr get_filter_function(struct client_state *csp) { filter_function_ptr filter_function = NULL;
/* + * Are we enabling text mode by force? + */ + if (csp->action->flags & ACTION_FORCE_TEXT_MODE) + { + /* + * Do we really have to? + */ + if (csp->content_type & CT_TEXT) + { + log_error(LOG_LEVEL_HEADER, "Text mode is already enabled."); + } + else + { + csp->content_type |= CT_TEXT; + log_error(LOG_LEVEL_HEADER, "Text mode enabled by force. Take cover!"); + } + } + + if (!(csp->content_type & CT_DECLARED)) + { + /* + * The server didn't bother to declare a MIME-Type. + * Assume it's text that can be filtered. + * + * This also regulary happens with 304 responses, + * therefore logging anything here would cause + * too much noise. + */ + csp->content_type |= CT_TEXT; + } + + /* * Choose the applying filter function based on * the content type and action settings. */ @@ -1854,15 +2204,13 @@ static jb_err remove_chunked_transfer_coding(char *buffer, size_t *size) return JB_ERR_PARSE; }
- if (chunksize >= *size - newsize) + if ((newsize += chunksize) >= *size) { log_error(LOG_LEVEL_ERROR, - "Chunk size %u exceeds buffered data left. " - "Already digested %u of %u buffered bytes.", - chunksize, (unsigned int)newsize, (unsigned int)*size); + "Chunk size %d exceeds buffer size %d in "chunked" transfer coding", + chunksize, *size); return JB_ERR_PARSE; } - newsize += chunksize; from_p += 2;
memmove(to_p, from_p, (size_t) chunksize); @@ -1875,7 +2223,7 @@ static jb_err remove_chunked_transfer_coding(char *buffer, size_t *size) break; } } - + /* XXX: Should get its own loglevel. */ log_error(LOG_LEVEL_RE_FILTER, "De-chunking successful. Shrunk from %d to %d", *size, newsize);
@@ -1963,23 +2311,20 @@ static jb_err prepare_for_filtering(struct client_state *csp)
/********************************************************************* * - * Function : execute_content_filters + * Function : execute_content_filter * * Description : Executes a given content filter. * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) + * 2 : content_filter = The filter function to execute * * Returns : Pointer to the modified buffer, or * NULL if filtering failed or wasn't necessary. * *********************************************************************/ -char *execute_content_filters(struct client_state *csp) +char *execute_content_filter(struct client_state *csp, filter_function_ptr content_filter) { - filter_function_ptr content_filter; - - assert(content_filters_enabled(csp->action)); - if (0 == csp->iob->eod - csp->iob->cur) { /* @@ -2005,8 +2350,6 @@ char *execute_content_filters(struct client_state *csp) return NULL; }
- content_filter = get_filter_function(csp); - return ((*content_filter)(csp)); }
@@ -2178,9 +2521,18 @@ const static struct forward_spec *get_forward_override_settings(struct client_st if (NULL != socks_proxy) { /* Parse the SOCKS proxy host[:port] */ - fwd->gateway_port = 1080; - parse_forwarder_address(socks_proxy, - &fwd->gateway_host, &fwd->gateway_port); + fwd->gateway_host = strdup(socks_proxy); + + if (NULL != (socks_proxy = strchr(fwd->gateway_host, ':'))) + { + *socks_proxy++ = '\0'; + fwd->gateway_port = (int)strtol(socks_proxy, NULL, 0); + } + + if (fwd->gateway_port <= 0) + { + fwd->gateway_port = 1080; + }
http_parent = vec[2]; } @@ -2196,9 +2548,18 @@ const static struct forward_spec *get_forward_override_settings(struct client_st /* Parse http forwarding settings */ if (strcmp(http_parent, ".") != 0) { - fwd->forward_port = 8000; - parse_forwarder_address(http_parent, - &fwd->forward_host, &fwd->forward_port); + fwd->forward_host = strdup(http_parent); + + if (NULL != (http_parent = strchr(fwd->forward_host, ':'))) + { + *http_parent++ = '\0'; + fwd->forward_port = (int)strtol(http_parent, NULL, 0); + } + + if (fwd->forward_port <= 0) + { + fwd->forward_port = 8000; + } }
assert (NULL != fwd); @@ -2254,7 +2615,7 @@ const struct forward_spec *forward_url(struct client_state *csp,
/********************************************************************* * - * Function : direct_response + * Function : direct_response * * Description : Check if Max-Forwards == 0 for an OPTIONS or TRACE * request and if so, return a HTTP 501 to the client. @@ -2263,7 +2624,7 @@ const struct forward_spec *forward_url(struct client_state *csp, * requests properly. Still, what we do here is rfc- * compliant, whereas ignoring or forwarding are not. * - * Parameters : + * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) * * Returns : http_response if , NULL if nonmatch or handler fail @@ -2279,7 +2640,7 @@ struct http_response *direct_response(struct client_state *csp) { for (p = csp->headers->first; (p != NULL) ; p = p->next) { - if (!strncmpic(p->str, "Max-Forwards:", 13)) + if (!strncmpic("Max-Forwards:", p->str, 13)) { unsigned int max_forwards;
@@ -2303,7 +2664,7 @@ struct http_response *direct_response(struct client_state *csp) { return cgi_error_memory(); } - + if (NULL == (rsp->status = strdup("501 Not Implemented"))) { free_http_response(rsp); @@ -2311,7 +2672,7 @@ struct http_response *direct_response(struct client_state *csp) }
rsp->is_static = 1; - rsp->crunch_reason = UNSUPPORTED; + rsp->reason = RSP_REASON_UNSUPPORTED;
return(finish_http_response(csp, rsp)); } @@ -2324,87 +2685,12 @@ struct http_response *direct_response(struct client_state *csp)
/********************************************************************* * - * Function : content_requires_filtering - * - * Description : Checks whether there are any content filters - * enabled for the current request and if they - * can actually be applied.. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * - * Returns : TRUE for yes, FALSE otherwise - * - *********************************************************************/ -int content_requires_filtering(struct client_state *csp) -{ - if ((csp->content_type & CT_TABOO) - && !(csp->action->flags & ACTION_FORCE_TEXT_MODE)) - { - return FALSE; - } - - /* - * Are we enabling text mode by force? - */ - if (csp->action->flags & ACTION_FORCE_TEXT_MODE) - { - /* - * Do we really have to? - */ - if (csp->content_type & CT_TEXT) - { - log_error(LOG_LEVEL_HEADER, "Text mode is already enabled."); - } - else - { - csp->content_type |= CT_TEXT; - log_error(LOG_LEVEL_HEADER, "Text mode enabled by force. Take cover!"); - } - } - - if (!(csp->content_type & CT_DECLARED)) - { - /* - * The server didn't bother to declare a MIME-Type. - * Assume it's text that can be filtered. - * - * This also regulary happens with 304 responses, - * therefore logging anything here would cause - * too much noise. - */ - csp->content_type |= CT_TEXT; - } - - /* - * Choose the applying filter function based on - * the content type and action settings. - */ - if ((csp->content_type & CT_TEXT) && - (csp->rlist != NULL) && - (!list_is_empty(csp->action->multi[ACTION_MULTI_FILTER]))) - { - return TRUE; - } - else if ((csp->content_type & CT_GIF) && - (csp->action->flags & ACTION_DEANIMATE)) - { - return TRUE; - } - - return FALSE; - -} - - -/********************************************************************* - * * Function : content_filters_enabled * * Description : Checks whether there are any content filters * enabled for the current request. * - * Parameters : + * Parameters : * 1 : action = Action spec to check. * * Returns : TRUE for yes, FALSE otherwise @@ -2416,34 +2702,6 @@ int content_filters_enabled(const struct current_action_spec *action) !list_is_empty(action->multi[ACTION_MULTI_FILTER])); }
- -/********************************************************************* - * - * Function : filters_available - * - * Description : Checks whether there are any filters available. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * - * Returns : TRUE for yes, FALSE otherwise. - * - *********************************************************************/ -int filters_available(const struct client_state *csp) -{ - int i; - for (i = 0; i < MAX_AF_FILES; i++) - { - const struct file_list *fl = csp->rlist[i]; - if ((NULL != fl) && (NULL != fl->f)) - { - return TRUE; - } - } - return FALSE; -} - - /* Local Variables: tab-width: 3 diff --git a/external/privoxy/filters.h b/external/privoxy/filters.h index 0bd2b95..66794e1 100644 --- a/external/privoxy/filters.h +++ b/external/privoxy/filters.h @@ -1,6 +1,6 @@ #ifndef FILTERS_H_INCLUDED #define FILTERS_H_INCLUDED -#define FILTERS_H_VERSION "$Id: filters.h,v 1.43 2011/09/04 11:10:56 fabiankeil Exp $" +#define FILTERS_H_VERSION "$Id: filters.h,v 1.36 2008/05/21 15:35:08 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/filters.h,v $ @@ -12,14 +12,14 @@ * `ij_untrusted_url', `intercept_url', `re_process_buffer', * `show_proxy_args', and `trust_url' * - * Copyright : Written by and Copyright (C) 2001-2010 the + * Copyright : Written by and Copyright (C) 2001, 2004 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -37,8 +37,244 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: filters.h,v $ + * Revision 1.36 2008/05/21 15:35:08 fabiankeil + * - Mark csp as immutable for block_acl(). + * - Remove an obsolete complaint about filter_popups(). + * + * Revision 1.35 2008/05/03 16:40:45 fabiankeil + * Change content_filters_enabled()'s parameter from + * csp->action to action so it can be also used in the + * CGI code. Don't bother checking if there are filters + * loaded, as that's somewhat besides the point. + * + * Revision 1.34 2008/03/02 12:25:25 fabiankeil + * Also use shiny new connect_port_is_forbidden() in jcc.c. + * + * Revision 1.33 2008/02/23 16:57:12 fabiankeil + * Rename url_actions() to get_url_actions() and let it + * use the standard parameter ordering. + * + * Revision 1.32 2008/02/23 16:33:43 fabiankeil + * Let forward_url() use the standard parameter ordering + * and mark its second parameter immutable. + * + * Revision 1.31 2007/10/19 16:53:28 fabiankeil + * Add helper function to check if any content filters are enabled. + * + * Revision 1.30 2007/09/29 10:21:16 fabiankeil + * - Move get_filter_function() from jcc.c to filters.c + * so the filter functions can be static. + * - Don't bother filtering body-less responses. + * + * Revision 1.29 2007/09/28 16:38:55 fabiankeil + * - Execute content filters through execute_content_filter(). + * - Add prepare_for_filtering() so filter functions don't have to + * care about de-chunking and decompression. As a side effect this enables + * decompression for gif_deanimate_response() and jpeg_inspect_response(). + * - Change remove_chunked_transfer_coding()'s return type to jb_err. + * Some clowns feel like chunking empty responses in which case + * (size == 0) is valid but previously would be interpreted as error. + * + * Revision 1.28 2007/09/02 15:31:20 fabiankeil + * Move match_portlist() from filter.c to urlmatch.c. + * It's used for url matching, not for filtering. + * + * Revision 1.27 2007/04/30 15:02:18 fabiankeil + * Introduce dynamic pcrs jobs that can resolve variables. + * + * Revision 1.26 2007/03/13 11:28:43 fabiankeil + * - Fix port handling in acl_addr() and use a temporary acl spec + * copy so error messages don't contain a truncated version. + * - Log size of iob before and after decompression. + * + * Revision 1.25 2007/01/12 15:36:44 fabiankeil + * Mark *csp as immutable for is_untrusted_url() + * and is_imageurl(). Closes FR 1237736. + * + * Revision 1.24 2006/12/29 18:30:46 fabiankeil + * Fixed gcc43 conversion warnings, + * changed sprintf calls to snprintf. + * + * Revision 1.23 2006/11/28 15:19:43 fabiankeil + * Implemented +redirect{s@foo@bar@} to generate + * a redirect based on a rewritten version of the + * original URL. + * + * Revision 1.22 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.20.2.2 2004/10/03 12:53:32 david__schmidt + * Add the ability to check jpeg images for invalid + * lengths of comment blocks. Defensive strategy + * against the exploit: + * Microsoft Security Bulletin MS04-028 + * Buffer Overrun in JPEG Processing (GDI+) Could + * Allow Code Execution (833987) + * Enabled with +inspect-jpegs in actions files. + * + * Revision 1.20.2.1 2002/09/25 14:51:51 oes + * Added basic support for OPTIONS and TRACE HTTP methods: + * New function direct_response which handles OPTIONS and + * TRACE requests whose Max-Forwards header field is zero. + * + * Revision 1.20 2002/04/02 14:56:16 oes + * Bugfix: is_untrusted_url() and trust_url() now depend on FEATURE_TRUST, not FEATURE_COOKIE_JAR + * + * Revision 1.19 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.18 2002/03/25 22:12:45 oes + * Added fix for undefined INADDR_NONE on Solaris by Bart Schelstraete + * + * Revision 1.17 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.16 2002/01/17 21:01:02 jongfoster + * Moving all our URL and URL pattern parsing code to urlmatch.c. + * + * Revision 1.15 2001/10/10 16:44:16 oes + * Added match_portlist function + * + * Revision 1.14 2001/10/07 15:41:40 oes + * Added prototype for remove_chunked_transfer_coding + * + * Revision 1.13 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.12 2001/07/29 19:01:11 jongfoster + * Changed _FILENAME_H to FILENAME_H_INCLUDED. + * Added forward declarations for needed structures. + * + * Revision 1.11 2001/07/13 14:00:18 oes + * - Introduced gif_deanimate_response + * - Renamed re_process_buffer to pcrs_filter_response + * - Removed all #ifdef PCRS + * + * Revision 1.10 2001/06/29 13:29:01 oes + * Cleaned up and updated to reflect the changesin + * filters.c + * + * Revision 1.9 2001/06/07 23:10:53 jongfoster + * Replacing struct gateway with struct forward_spec + * + * Revision 1.8 2001/06/03 19:12:00 oes + * extracted-CGI relevant stuff + * + * Revision 1.7 2001/05/31 21:21:30 jongfoster + * Permissionsfile / actions file changes: + * - Changed "permission" to "action" throughout + * - changes to file format to allow string parameters + * - Moved helper functions to actions.c + * + * Revision 1.6 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.5 2001/05/27 22:17:04 oes + * + * - re_process_buffer no longer writes the modified buffer + * to the client, which was very ugly. It now returns the + * buffer, which it is then written by chat. + * + * - content_length now adjusts the Content-Length: header + * for modified documents rather than crunch()ing it. + * (Length info in csp->content_length, which is 0 for + * unmodified documents) + * + * - For this to work, sed() is called twice when filtering. + * + * Revision 1.4 2001/05/26 15:26:15 jongfoster + * ACL feature now provides more security by immediately dropping + * connections from untrusted hosts. + * + * Revision 1.3 2001/05/22 18:46:04 oes + * + * - Enabled filtering banners by size rather than URL + * by adding patterns that replace all standard banner + * sizes with the "Junkbuster" gif to the re_filterfile + * + * - Enabled filtering WebBugs by providing a pattern + * which kills all 1x1 images + * + * - Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * - Added a new interceptor ijb-send-banner, which + * sends back the "Junkbuster" gif. Without imagelist or + * MSIE detection support, or if tinygif = 1, or the + * URL isn't recognized as an imageurl, a lame HTML + * explanation is sent instead. + * + * - Added new feature, which permits blocking remote + * script redirects and firing back a local redirect + * to the browser. + * The feature is conditionally compiled, i.e. it + * can be disabled with --disable-fast-redirects, + * plus it must be activated by a "fast-redirects" + * line in the config file, has its own log level + * and of course wants to be displayed by show-proxy-args + * Note: Boy, all the #ifdefs in 1001 locations and + * all the fumbling with configure.in and acconfig.h + * were *way* more work than the feature itself :-( + * + * - Because a generic redirect template was needed for + * this, tinygif = 3 now uses the same. + * + * - Moved GIFs, and other static HTTP response templates + * to project.h + * + * - Some minor fixes + * + * - Removed some >400 CRs again (Jon, you really worked + * a lot! ;-) + * + * Revision 1.2 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.1.1.1 2001/05/15 13:58:52 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "project.h"
@@ -89,8 +325,8 @@ extern int connect_port_is_forbidden(const struct client_state *csp); */ extern void get_url_actions(struct client_state *csp, struct http_request *http); -extern void apply_url_actions(struct current_action_spec *action, - struct http_request *http, +extern void apply_url_actions(struct current_action_spec *action, + struct http_request *http, struct url_actions *b); /* * Determining parent proxies @@ -101,23 +337,33 @@ extern const struct forward_spec *forward_url(struct client_state *csp, /* * Content modification */ -extern char *execute_content_filters(struct client_state *csp); + +typedef char *(*filter_function_ptr)(); +extern char *execute_content_filter(struct client_state *csp, filter_function_ptr content_filter); + +extern filter_function_ptr get_filter_function(struct client_state *csp); extern char *execute_single_pcrs_command(char *subject, const char *pcrs_command, int *hits); extern char *rewrite_url(char *old_url, const char *pcrs_command); extern char *get_last_url(char *subject, const char *redirect_mode);
extern pcrs_job *compile_dynamic_pcrs_job_list(const struct client_state *csp, const struct re_filterfile_spec *b);
-extern int content_requires_filtering(struct client_state *csp); extern int content_filters_enabled(const struct current_action_spec *action); -extern int filters_available(const struct client_state *csp);
/* * Handling Max-Forwards: */ extern struct http_response *direct_response(struct client_state *csp);
+ /* + * Solaris fix: + */ +#ifndef INADDR_NONE +#define INADDR_NONE -1 +#endif + +/* * Revision control strings from this header and associated .c file */ extern const char filters_rcs[]; diff --git a/external/privoxy/gateway.c b/external/privoxy/gateway.c index b96fbb2..1e4ffd0 100644 --- a/external/privoxy/gateway.c +++ b/external/privoxy/gateway.c @@ -1,4 +1,4 @@ -const char gateway_rcs[] = "$Id: gateway.c,v 1.83 2011/12/24 15:28:45 fabiankeil Exp $"; +const char gateway_rcs[] = "$Id: gateway.c,v 1.48 2009/02/13 17:20:36 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/gateway.c,v $ @@ -7,7 +7,7 @@ const char gateway_rcs[] = "$Id: gateway.c,v 1.83 2011/12/24 15:28:45 fabiankeil * using a "forwarder" (i.e. HTTP proxy and/or a SOCKS4 * or SOCKS5 proxy). * - * Copyright : Written by and Copyright (C) 2001-2009 the + * Copyright : Written by and Copyright (C) 2001-2009 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written @@ -32,8 +32,217 @@ const char gateway_rcs[] = "$Id: gateway.c,v 1.83 2011/12/24 15:28:45 fabiankeil * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: gateway.c,v $ + * Revision 1.48 2009/02/13 17:20:36 fabiankeil + * Reword keep-alive support warning and only show + * it #if !defined(HAVE_POLL) && !defined(_WIN32). + * + * Revision 1.47 2008/12/24 17:06:19 fabiankeil + * Keep a thread around to timeout alive connections + * even if no new requests are coming in. + * + * Revision 1.46 2008/12/13 11:07:23 fabiankeil + * Remove duplicated debugging checks + * in connection_destination_matches(). + * + * Revision 1.45 2008/12/04 18:17:07 fabiankeil + * Fix some cparser warnings. + * + * Revision 1.44 2008/11/22 11:54:04 fabiankeil + * Move log message around to include the socket number. + * + * Revision 1.43 2008/11/13 09:15:51 fabiankeil + * Make keep_alive_timeout static. + * + * Revision 1.42 2008/11/13 09:08:42 fabiankeil + * Add new config option: keep-alive-timeout. + * + * Revision 1.41 2008/11/08 15:29:58 fabiankeil + * Unify two debug messages. + * + * Revision 1.40 2008/11/08 15:14:05 fabiankeil + * Fix duplicated debugging check. + * + * Revision 1.39 2008/10/25 11:33:01 fabiankeil + * Remove already out-commented line left over from debugging. + * + * Revision 1.38 2008/10/24 17:33:00 fabiankeil + * - Tone the "keep-alive support is experimental" warning + * down a bit as hackish 0-chunk detection has been + * implemented recently. + * - Only show the "ndef HAVE_POLL" warning once on start-up. + * + * Revision 1.37 2008/10/23 17:40:53 fabiankeil + * Fix forget_connection() and mark_connection_unused(), + * which would both under certain circumstances access + * reusable_connection[MAX_REUSABLE_CONNECTIONS]. Oops. + * + * Revision 1.36 2008/10/18 19:49:15 fabiankeil + * - Factor close_unusable_connections() out of + * get_reusable_connection() to make sure we really check + * all the remembered connections, not just the ones before + * the next reusable one. + * - Plug two file descriptor leaks. Internally marking + * connections as closed doesn't cut it. + * + * Revision 1.35 2008/10/17 17:12:01 fabiankeil + * In socket_is_still_usable(), use select() + * and FD_ISSET() if poll() isn't available. + * + * Revision 1.34 2008/10/17 17:07:13 fabiankeil + * Add preliminary timeout support. + * + * Revision 1.33 2008/10/16 16:34:21 fabiankeil + * Fix two gcc44 warnings. + * + * Revision 1.32 2008/10/16 16:27:22 fabiankeil + * Fix compiler warning. + * + * Revision 1.31 2008/10/16 07:31:11 fabiankeil + * - Factor socket_is_still_usable() out of get_reusable_connection(). + * - If poll() isn't available, show a warning and assume the socket + * is still usable. + * + * Revision 1.30 2008/10/13 17:31:03 fabiankeil + * If a remembered connection is no longer usable and + * has been marked closed, don't bother checking if the + * destination matches. + * + * Revision 1.29 2008/10/11 16:59:41 fabiankeil + * Add missing dots for two log messages. + * + * Revision 1.28 2008/10/09 18:21:41 fabiankeil + * Flush work-in-progress changes to keep outgoing connections + * alive where possible. Incomplete and mostly #ifdef'd out. + * + * Revision 1.27 2008/09/27 15:05:51 fabiankeil + * Return only once in forwarded_connect(). + * + * Revision 1.26 2008/08/18 17:42:06 fabiankeil + * Fix typo in macro name. + * + * Revision 1.25 2008/02/07 18:09:46 fabiankeil + * In socks5_connect: + * - make the buffers quite a bit smaller. + * - properly report "socks5 server unreachable" failures. + * - let strncpy() use the whole buffer. Using a length of 0xffu wasn't actually + * wrong, but requires too much thinking as it doesn't depend on the buffer size. + * - log a message if the socks5 server sends more data than expected. + * - add some assertions and comments. + * + * Revision 1.24 2008/02/04 14:56:29 fabiankeil + * - Fix a compiler warning. + * - Stop assuming that htonl(INADDR_NONE) equals INADDR_NONE. + * + * Revision 1.23 2008/02/04 13:11:35 fabiankeil + * Remember the cause of the SOCKS5 error for the CGI message. + * + * Revision 1.22 2008/02/03 13:46:15 fabiankeil + * Add SOCKS5 support. Patch #1862863 by Eric M. Hopper with minor changes. + * + * Revision 1.21 2007/07/28 12:30:03 fabiankeil + * Modified patch from Song Weijia (#1762559) to + * fix socks requests on big-endian platforms. + * + * Revision 1.20 2007/05/14 10:23:48 fabiankeil + * - Use strlcpy() instead of strcpy(). + * - Use the same buffer for socks requests and socks responses. + * - Fix bogus warning about web_server_addr being used uninitialized. + * + * Revision 1.19 2007/01/25 14:09:45 fabiankeil + * - Save errors in socks4_connect() to csp->error_message. + * - Silence some gcc43 warnings, hopefully the right way. + * + * Revision 1.18 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.16 2002/05/12 21:36:29 jongfoster + * Correcting function comments + * + * Revision 1.15 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.14 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.13 2002/03/13 00:29:59 jongfoster + * Killing warnings + * + * Revision 1.12 2002/03/09 20:03:52 jongfoster + * - Making various functions return int rather than size_t. + * (Undoing a recent change). Since size_t is unsigned on + * Windows, functions like read_socket that return -1 on + * error cannot return a size_t. + * + * THIS WAS A MAJOR BUG - it caused frequent, unpredictable + * crashes, and also frequently caused JB to jump to 100% + * CPU and stay there. (Because it thought it had just + * read ((unsigned)-1) == 4Gb of data...) + * + * - The signature of write_socket has changed, it now simply + * returns success=0/failure=nonzero. + * + * - Trying to get rid of a few warnings --with-debug on + * Windows, I've introduced a new type "jb_socket". This is + * used for the socket file descriptors. On Windows, this + * is SOCKET (a typedef for unsigned). Everywhere else, it's + * an int. The error value can't be -1 any more, so it's + * now JB_INVALID_SOCKET (which is -1 on UNIX, and in + * Windows it maps to the #define INVALID_SOCKET.) + * + * - The signature of bind_port has changed. + * + * Revision 1.11 2002/03/08 17:46:04 jongfoster + * Fixing int/size_t warnings + * + * Revision 1.10 2002/03/07 03:50:19 oes + * - Improved handling of failed DNS lookups + * - Fixed compiler warnings + * + * Revision 1.9 2001/10/25 03:40:48 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.8 2001/09/13 20:10:12 jongfoster + * Fixing missing #include under Windows + * + * Revision 1.7 2001/09/12 17:58:26 steudten + * + * add #include <string.h> + * + * Revision 1.6 2001/09/10 10:41:16 oes + * Added #include in.h + * + * Revision 1.5 2001/07/29 18:47:57 jongfoster + * Adding missing #include project.h + * + * Revision 1.4 2001/07/24 12:47:06 oes + * Applied BeOS support update by Eugenia + * + * Revision 1.3 2001/06/09 10:55:28 jongfoster + * Changing BUFSIZ ==> BUFFER_SIZE + * + * Revision 1.2 2001/06/07 23:11:38 jongfoster + * Removing gateways[] list - no longer used. + * Replacing function pointer in struct gateway with a directly + * called function forwarded_connect(), which can do the common + * task of deciding whether to connect to the web server or HTTP + * proxy. + * Replacing struct gateway with struct forward_spec + * Fixing bug with SOCKS4A and HTTP proxy server in combination. + * It was a bug which led to the connection being made to the web + * server rather than the HTTP proxy, and also a buffer overrun. + * + * Revision 1.1.1.1 2001/05/15 13:58:54 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -68,7 +277,7 @@ const char gateway_rcs[] = "$Id: gateway.c,v 1.83 2011/12/24 15:28:45 fabiankeil #include "miscutil.h" #ifdef FEATURE_CONNECTION_KEEP_ALIVE #ifdef HAVE_POLL -#ifdef __GLIBC__ +#ifdef __GLIBC__ #include <sys/poll.h> #else #include <poll.h> @@ -88,24 +297,21 @@ static jb_socket socks5_connect(const struct forward_spec *fwd, int target_port, struct client_state *csp);
-enum { - SOCKS4_REQUEST_GRANTED = 90, - SOCKS4_REQUEST_REJECT = 91, - SOCKS4_REQUEST_IDENT_FAILED = 92, - SOCKS4_REQUEST_IDENT_CONFLICT = 93 -};
-enum { - SOCKS5_REQUEST_GRANTED = 0, - SOCKS5_REQUEST_FAILED = 1, - SOCKS5_REQUEST_DENIED = 2, - SOCKS5_REQUEST_NETWORK_UNREACHABLE = 3, - SOCKS5_REQUEST_HOST_UNREACHABLE = 4, - SOCKS5_REQUEST_CONNECTION_REFUSED = 5, - SOCKS5_REQUEST_TTL_EXPIRED = 6, - SOCKS5_REQUEST_PROTOCOL_ERROR = 7, - SOCKS5_REQUEST_BAD_ADDRESS_TYPE = 8 -}; +#define SOCKS_REQUEST_GRANTED 90 +#define SOCKS_REQUEST_REJECT 91 +#define SOCKS_REQUEST_IDENT_FAILED 92 +#define SOCKS_REQUEST_IDENT_CONFLICT 93 + +#define SOCKS5_REQUEST_GRANTED 0 +#define SOCKS5_REQUEST_FAILED 1 +#define SOCKS5_REQUEST_DENIED 2 +#define SOCKS5_REQUEST_NETWORK_UNREACHABLE 3 +#define SOCKS5_REQUEST_HOST_UNREACHABLE 4 +#define SOCKS5_REQUEST_CONNECTION_REFUSED 5 +#define SOCKS5_REQUEST_TTL_EXPIRED 6 +#define SOCKS5_REQUEST_PROTOCOL_ERROR 7 +#define SOCKS5_REQUEST_BAD_ADDRESS_TYPE 8
/* structure of a socks client operation */ struct socks_op { @@ -128,13 +334,32 @@ struct socks_reply {
static const char socks_userid[] = "anonymous";
-#ifdef FEATURE_CONNECTION_SHARING +#ifdef FEATURE_CONNECTION_KEEP_ALIVE
#define MAX_REUSABLE_CONNECTIONS 100 -static unsigned int keep_alive_timeout = DEFAULT_KEEP_ALIVE_TIMEOUT; +static int keep_alive_timeout = DEFAULT_KEEP_ALIVE_TIMEOUT; + +struct reusable_connection +{ + jb_socket sfd; + int in_use; + char *host; + int port; + time_t timestamp; + + int forwarder_type; + char *gateway_host; + int gateway_port; + char *forward_host; + int forward_port; +};
static struct reusable_connection reusable_connection[MAX_REUSABLE_CONNECTIONS]; -static int mark_connection_unused(const struct reusable_connection *connection); + +static int mark_connection_unused(jb_socket sfd); +static void mark_connection_closed(struct reusable_connection *closed_connection); +static int socket_is_still_usable(jb_socket sfd); +
/********************************************************************* * @@ -172,23 +397,25 @@ extern void initialize_reusable_connections(void) * * Function : remember_connection * - * Description : Remembers a server connection for reuse later on. + * Description : Remembers a connection for reuse later on. * * Parameters : - * 1 : connection = The server connection to remember. + * 1 : sfd = Open socket to remember. + * 2 : http = The destination for the connection. + * 3 : fwd = The forwarder settings used. * * Returns : void * *********************************************************************/ -void remember_connection(const struct reusable_connection *connection) +void remember_connection(jb_socket sfd, const struct http_request *http, + const struct forward_spec *fwd) { unsigned int slot = 0; int free_slot_found = FALSE;
- assert(NULL != connection); - assert(connection->sfd != JB_INVALID_SOCKET); + assert(sfd != JB_INVALID_SOCKET);
- if (mark_connection_unused(connection)) + if (mark_connection_unused(sfd)) { return; } @@ -203,7 +430,7 @@ void remember_connection(const struct reusable_connection *connection) assert(reusable_connection[slot].in_use == 0); log_error(LOG_LEVEL_CONNECT, "Remembering socket %d for %s:%d in slot %d.", - connection->sfd, connection->host, connection->port, slot); + sfd, http->host, http->port, slot); free_slot_found = TRUE; break; } @@ -213,36 +440,34 @@ void remember_connection(const struct reusable_connection *connection) { log_error(LOG_LEVEL_CONNECT, "No free slots found to remembering socket for %s:%d. Last slot %d.", - connection->host, connection->port, slot); + http->host, http->port, slot); privoxy_mutex_unlock(&connection_reuse_mutex); - close_socket(connection->sfd); + close_socket(sfd); return; }
- assert(NULL != connection->host); - reusable_connection[slot].host = strdup(connection->host); + assert(NULL != http->host); + reusable_connection[slot].host = strdup(http->host); if (NULL == reusable_connection[slot].host) { log_error(LOG_LEVEL_FATAL, "Out of memory saving socket."); } - reusable_connection[slot].sfd = connection->sfd; - reusable_connection[slot].port = connection->port; + reusable_connection[slot].sfd = sfd; + reusable_connection[slot].port = http->port; reusable_connection[slot].in_use = 0; - reusable_connection[slot].timestamp = connection->timestamp; - reusable_connection->request_sent = connection->request_sent; - reusable_connection->response_received = connection->response_received; - reusable_connection[slot].keep_alive_timeout = connection->keep_alive_timeout; + reusable_connection[slot].timestamp = time(NULL);
+ assert(NULL != fwd); assert(reusable_connection[slot].gateway_host == NULL); assert(reusable_connection[slot].gateway_port == 0); assert(reusable_connection[slot].forwarder_type == SOCKS_NONE); assert(reusable_connection[slot].forward_host == NULL); assert(reusable_connection[slot].forward_port == 0);
- reusable_connection[slot].forwarder_type = connection->forwarder_type; - if (NULL != connection->gateway_host) + reusable_connection[slot].forwarder_type = fwd->type; + if (NULL != fwd->gateway_host) { - reusable_connection[slot].gateway_host = strdup(connection->gateway_host); + reusable_connection[slot].gateway_host = strdup(fwd->gateway_host); if (NULL == reusable_connection[slot].gateway_host) { log_error(LOG_LEVEL_FATAL, "Out of memory saving gateway_host."); @@ -252,11 +477,11 @@ void remember_connection(const struct reusable_connection *connection) { reusable_connection[slot].gateway_host = NULL; } - reusable_connection[slot].gateway_port = connection->gateway_port; + reusable_connection[slot].gateway_port = fwd->gateway_port;
- if (NULL != connection->forward_host) + if (NULL != fwd->forward_host) { - reusable_connection[slot].forward_host = strdup(connection->forward_host); + reusable_connection[slot].forward_host = strdup(fwd->forward_host); if (NULL == reusable_connection[slot].forward_host) { log_error(LOG_LEVEL_FATAL, "Out of memory saving forward_host."); @@ -266,19 +491,18 @@ void remember_connection(const struct reusable_connection *connection) { reusable_connection[slot].forward_host = NULL; } - reusable_connection[slot].forward_port = connection->forward_port; + reusable_connection[slot].forward_port = fwd->forward_port;
privoxy_mutex_unlock(&connection_reuse_mutex); } -#endif /* def FEATURE_CONNECTION_SHARING */
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE /********************************************************************* * * Function : mark_connection_closed * * Description : Marks a reused connection closed. + * Must be called with connection_reuse_mutex locked. * * Parameters : * 1 : closed_connection = The connection to mark as closed. @@ -286,26 +510,21 @@ void remember_connection(const struct reusable_connection *connection) * Returns : void * *********************************************************************/ -void mark_connection_closed(struct reusable_connection *closed_connection) +static void mark_connection_closed(struct reusable_connection *closed_connection) { closed_connection->in_use = FALSE; closed_connection->sfd = JB_INVALID_SOCKET; freez(closed_connection->host); closed_connection->port = 0; closed_connection->timestamp = 0; - closed_connection->request_sent = 0; - closed_connection->response_received = 0; - closed_connection->keep_alive_timeout = 0; closed_connection->forwarder_type = SOCKS_NONE; freez(closed_connection->gateway_host); closed_connection->gateway_port = 0; freez(closed_connection->forward_host); closed_connection->forward_port = 0; } -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */
-#ifdef FEATURE_CONNECTION_SHARING /********************************************************************* * * Function : forget_connection @@ -338,17 +557,19 @@ void forget_connection(jb_socket sfd) sfd, reusable_connection[slot].host, reusable_connection[slot].port, slot); mark_connection_closed(&reusable_connection[slot]); - break; + privoxy_mutex_unlock(&connection_reuse_mutex); + + return; } }
- privoxy_mutex_unlock(&connection_reuse_mutex); + log_error(LOG_LEVEL_CONNECT, + "Socket %d already forgotten or never remembered.", sfd);
+ privoxy_mutex_unlock(&connection_reuse_mutex); } -#endif /* def FEATURE_CONNECTION_SHARING */
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE /********************************************************************* * * Function : connection_destination_matches @@ -365,9 +586,9 @@ void forget_connection(jb_socket sfd) * Returns : TRUE for yes, FALSE otherwise. * *********************************************************************/ -int connection_destination_matches(const struct reusable_connection *connection, - const struct http_request *http, - const struct forward_spec *fwd) +static int connection_destination_matches(const struct reusable_connection *connection, + const struct http_request *http, + const struct forward_spec *fwd) { if ((connection->forwarder_type != fwd->type) || (connection->gateway_port != fwd->gateway_port) @@ -382,9 +603,7 @@ int connection_destination_matches(const struct reusable_connection *connection, && strcmpic(connection->gateway_host, fwd->gateway_host)) && (connection->gateway_host != fwd->gateway_host)) { - log_error(LOG_LEVEL_CONNECT, - "Gateway mismatch. Previous gateway: %s. Current gateway: %s", - connection->gateway_host, fwd->gateway_host); + log_error(LOG_LEVEL_CONNECT, "Gateway mismatch."); return FALSE; }
@@ -393,19 +612,15 @@ int connection_destination_matches(const struct reusable_connection *connection, && strcmpic(connection->forward_host, fwd->forward_host)) && (connection->forward_host != fwd->forward_host)) { - log_error(LOG_LEVEL_CONNECT, - "Forwarding proxy mismatch. Previous proxy: %s. Current proxy: %s", - connection->forward_host, fwd->forward_host); + log_error(LOG_LEVEL_CONNECT, "Forwarding proxy mismatch."); return FALSE; }
return (!strcmpic(connection->host, http->host));
} -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */
-#ifdef FEATURE_CONNECTION_SHARING /********************************************************************* * * Function : close_unusable_connections @@ -431,23 +646,19 @@ int close_unusable_connections(void) && (JB_INVALID_SOCKET != reusable_connection[slot].sfd)) { time_t time_open = time(NULL) - reusable_connection[slot].timestamp; - time_t latency = (reusable_connection[slot].response_received - - reusable_connection[slot].request_sent) / 2;
- if (reusable_connection[slot].keep_alive_timeout < time_open + latency) + if (keep_alive_timeout < time_open) { log_error(LOG_LEVEL_CONNECT, "The connection to %s:%d in slot %d timed out. " - "Closing socket %d. Timeout is: %d. Assumed latency: %d.", + "Closing socket %d. Timeout is: %d.", reusable_connection[slot].host, reusable_connection[slot].port, slot, - reusable_connection[slot].sfd, - reusable_connection[slot].keep_alive_timeout, - latency); + reusable_connection[slot].sfd, keep_alive_timeout); close_socket(reusable_connection[slot].sfd); mark_connection_closed(&reusable_connection[slot]); } - else if (!socket_is_still_alive(reusable_connection[slot].sfd)) + else if (!socket_is_still_usable(reusable_connection[slot].sfd)) { log_error(LOG_LEVEL_CONNECT, "The connection to %s:%d in slot %d is no longer usable. " @@ -473,6 +684,66 @@ int close_unusable_connections(void)
/********************************************************************* * + * Function : socket_is_still_usable + * + * Description : Decides whether or not an open socket is still usable. + * + * Parameters : + * 1 : sfd = The socket to check. + * + * Returns : TRUE for yes, otherwise FALSE. + * + *********************************************************************/ +static int socket_is_still_usable(jb_socket sfd) +{ +#ifdef HAVE_POLL + int poll_result; + struct pollfd poll_fd[1]; + + memset(poll_fd, 0, sizeof(poll_fd)); + poll_fd[0].fd = sfd; + poll_fd[0].events = POLLIN; + + poll_result = poll(poll_fd, 1, 0); + + if (-1 != poll_result) + { + return !(poll_fd[0].revents & POLLIN); + } + else + { + log_error(LOG_LEVEL_CONNECT, "Polling socket %d failed.", sfd); + return FALSE; + } +#else + fd_set readable_fds; + struct timeval timeout; + int ret; + int socket_is_alive = 0; + + memset(&timeout, '\0', sizeof(timeout)); + FD_ZERO(&readable_fds); + FD_SET(sfd, &readable_fds); + + ret = select((int)sfd+1, &readable_fds, NULL, NULL, &timeout); + if (ret < 0) + { + log_error(LOG_LEVEL_ERROR, "select() failed!: %E"); + } + + /* + * XXX: I'm not sure why !FD_ISSET() works, + * but apparently it does. + */ + socket_is_alive = !FD_ISSET(sfd, &readable_fds); + + return socket_is_alive; +#endif /* def HAVE_POLL */ +} + + +/********************************************************************* + * * Function : get_reusable_connection * * Description : Returns an open socket to a previously remembered @@ -506,13 +777,8 @@ static jb_socket get_reusable_connection(const struct http_request *http, reusable_connection[slot].in_use = TRUE; sfd = reusable_connection[slot].sfd; log_error(LOG_LEVEL_CONNECT, - "Found reusable socket %d for %s:%d in slot %d. " - "Timestamp made %d seconds ago. Timeout: %d. Latency: %d.", - sfd, reusable_connection[slot].host, reusable_connection[slot].port, - slot, time(NULL) - reusable_connection[slot].timestamp, - reusable_connection[slot].keep_alive_timeout, - (int)(reusable_connection[slot].response_received - - reusable_connection[slot].request_sent)); + "Found reusable socket %d for %s:%d in slot %d.", + sfd, reusable_connection[slot].host, reusable_connection[slot].port, slot); break; } } @@ -532,33 +798,33 @@ static jb_socket get_reusable_connection(const struct http_request *http, * Description : Gives a remembered connection free for reuse. * * Parameters : - * 1 : connection = The connection in question. + * 1 : sfd = The socket belonging to the connection in question. * * Returns : TRUE => Socket found and marked as unused. * FALSE => Socket not found. * *********************************************************************/ -static int mark_connection_unused(const struct reusable_connection *connection) +static int mark_connection_unused(jb_socket sfd) { unsigned int slot = 0; int socket_found = FALSE;
- assert(connection->sfd != JB_INVALID_SOCKET); + assert(sfd != JB_INVALID_SOCKET);
privoxy_mutex_lock(&connection_reuse_mutex);
for (slot = 0; slot < SZ(reusable_connection); slot++) { - if (reusable_connection[slot].sfd == connection->sfd) + if (reusable_connection[slot].sfd == sfd) { assert(reusable_connection[slot].in_use); socket_found = TRUE; log_error(LOG_LEVEL_CONNECT, "Marking open socket %d for %s:%d in slot %d as unused.", - connection->sfd, reusable_connection[slot].host, + sfd, reusable_connection[slot].host, reusable_connection[slot].port, slot); reusable_connection[slot].in_use = 0; - reusable_connection[slot].timestamp = connection->timestamp; + reusable_connection[slot].timestamp = time(NULL); break; } } @@ -583,11 +849,11 @@ static int mark_connection_unused(const struct reusable_connection *connection) * Returns : void * *********************************************************************/ -void set_keep_alive_timeout(unsigned int timeout) +void set_keep_alive_timeout(int timeout) { keep_alive_timeout = timeout; } -#endif /* def FEATURE_CONNECTION_SHARING */ +#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */
/********************************************************************* @@ -613,17 +879,13 @@ jb_socket forwarded_connect(const struct forward_spec * fwd, int dest_port; jb_socket sfd = JB_INVALID_SOCKET;
-#ifdef FEATURE_CONNECTION_SHARING - if ((csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_SHARING) - && !(csp->flags & CSP_FLAG_SERVER_SOCKET_TAINTED)) +#ifdef FEATURE_CONNECTION_KEEP_ALIVE + sfd = get_reusable_connection(http, fwd); + if (JB_INVALID_SOCKET != sfd) { - sfd = get_reusable_connection(http, fwd); - if (JB_INVALID_SOCKET != sfd) - { - return sfd; - } + return sfd; } -#endif /* def FEATURE_CONNECTION_SHARING */ +#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */
/* Figure out if we need to connect to the web server or a HTTP proxy. */ if (fwd->forward_host) @@ -655,7 +917,7 @@ jb_socket forwarded_connect(const struct forward_spec * fwd, default: /* Should never get here */ log_error(LOG_LEVEL_FATAL, - "Internal error in forwarded_connect(). Bad proxy type: %d", fwd->type); + "SOCKS4 impossible internal error - bad SOCKS type."); }
if (JB_INVALID_SOCKET != sfd) @@ -698,7 +960,7 @@ static jb_socket socks4_connect(const struct forward_spec * fwd, int target_port, struct client_state *csp) { - unsigned long web_server_addr; + unsigned int web_server_addr; char buf[BUFFER_SIZE]; struct socks_op *c = (struct socks_op *)buf; struct socks_reply *s = (struct socks_reply *)buf; @@ -724,7 +986,7 @@ static jb_socket socks4_connect(const struct forward_spec * fwd, if (err) { log_error(LOG_LEVEL_CONNECT, "socks4_connect: %s", errstr); - csp->error_message = strdup(errstr); + csp->error_message = strdup(errstr); errno = EINVAL; return(JB_INVALID_SOCKET); } @@ -805,8 +1067,12 @@ static jb_socket socks4_connect(const struct forward_spec * fwd,
if (sfd == JB_INVALID_SOCKET) { - /* The error an its reason have already been logged by connect_to() */ - return(JB_INVALID_SOCKET); + /* + * XXX: connect_to should fill in the exact reason. + * Most likely resolving the IP of the forwarder failed. + */ + errstr = "connect_to failed: see logfile for details"; + err = 1; } else if (write_socket(sfd, (char *)c, csiz)) { @@ -815,20 +1081,6 @@ static jb_socket socks4_connect(const struct forward_spec * fwd, err = 1; close_socket(sfd); } - else if (!data_is_available(sfd, csp->config->socket_timeout)) - { - if (socket_is_still_alive(sfd)) - { - errstr = "SOCKS4 negotiation timed out"; - } - else - { - errstr = "SOCKS4 negotiation got aborted by the server"; - } - log_error(LOG_LEVEL_CONNECT, "socks4_connect: %s", errstr); - err = 1; - close_socket(sfd); - } else if (read_socket(sfd, buf, sizeof(buf)) != sizeof(*s)) { errstr = "SOCKS4 negotiation read failed."; @@ -839,24 +1091,24 @@ static jb_socket socks4_connect(const struct forward_spec * fwd,
if (err) { - csp->error_message = strdup(errstr); + csp->error_message = strdup(errstr); return(JB_INVALID_SOCKET); }
switch (s->cd) { - case SOCKS4_REQUEST_GRANTED: + case SOCKS_REQUEST_GRANTED: return(sfd); - case SOCKS4_REQUEST_REJECT: + case SOCKS_REQUEST_REJECT: errstr = "SOCKS request rejected or failed."; errno = EINVAL; break; - case SOCKS4_REQUEST_IDENT_FAILED: + case SOCKS_REQUEST_IDENT_FAILED: errstr = "SOCKS request rejected because " "SOCKS server cannot connect to identd on the client."; errno = EACCES; break; - case SOCKS4_REQUEST_IDENT_CONFLICT: + case SOCKS_REQUEST_IDENT_CONFLICT: errstr = "SOCKS request rejected because " "the client program and identd report " "different user-ids."; @@ -943,7 +1195,7 @@ static jb_socket socks5_connect(const struct forward_spec *fwd, { int err = 0; char cbuf[300]; - char sbuf[10]; + char sbuf[30]; size_t client_pos = 0; int server_size = 0; size_t hostlen = 0; @@ -999,8 +1251,6 @@ static jb_socket socks5_connect(const struct forward_spec *fwd, { errstr = "socks5 server unreachable"; log_error(LOG_LEVEL_CONNECT, "socks5_connect: %s", errstr); - /* Free the generic error message provided by connect_to() */ - freez(csp->error_message); csp->error_message = strdup(errstr); return(JB_INVALID_SOCKET); } @@ -1019,20 +1269,7 @@ static jb_socket socks5_connect(const struct forward_spec *fwd, return(JB_INVALID_SOCKET); }
- if (!data_is_available(sfd, csp->config->socket_timeout)) - { - if (socket_is_still_alive(sfd)) - { - errstr = "SOCKS5 negotiation timed out"; - } - else - { - errstr = "SOCKS5 negotiation got aborted by the server"; - } - err = 1; - } - - if (!err && read_socket(sfd, sbuf, sizeof(sbuf)) != 2) + if (read_socket(sfd, sbuf, sizeof(sbuf)) != 2) { errstr = "SOCKS5 negotiation read failed"; err = 1; @@ -1081,7 +1318,7 @@ static jb_socket socks5_connect(const struct forward_spec *fwd,
if (write_socket(sfd, cbuf, client_pos)) { - errstr = "SOCKS5 negotiation write failed"; + errstr = "SOCKS5 negotiation read failed"; csp->error_message = strdup(errstr); log_error(LOG_LEVEL_CONNECT, "%s", errstr); close_socket(sfd); @@ -1090,33 +1327,44 @@ static jb_socket socks5_connect(const struct forward_spec *fwd, }
server_size = read_socket(sfd, sbuf, sizeof(sbuf)); - if (server_size != sizeof(sbuf)) + if (server_size < 3) { errstr = "SOCKS5 negotiation read failed"; + err = 1; } - else + else if (server_size > 20) { - if (sbuf[0] != '\x05') - { - errstr = "SOCKS5 negotiation protocol version error"; - } - else if (sbuf[2] != '\x00') - { - errstr = "SOCKS5 negotiation protocol error"; - } - else if (sbuf[1] != SOCKS5_REQUEST_GRANTED) - { - errstr = translate_socks5_error(sbuf[1]); - } - else + /* This is somewhat unexpected but doesn't realy matter. */ + log_error(LOG_LEVEL_CONNECT, "socks5_connect: read %d bytes " + "from socks server. Would have accepted up to %d.", + server_size, sizeof(sbuf)); + } + + if (!err && (sbuf[0] != '\x05')) + { + errstr = "SOCKS5 negotiation protocol version error"; + err = 1; + } + + if (!err && (sbuf[2] != '\x00')) + { + errstr = "SOCKS5 negotiation protocol error"; + err = 1; + } + + if (!err) + { + if (sbuf[1] == SOCKS5_REQUEST_GRANTED) { return(sfd); } + errstr = translate_socks5_error(sbuf[1]); + err = 1; }
assert(errstr != NULL); csp->error_message = strdup(errstr); - log_error(LOG_LEVEL_CONNECT, "socks5_connect: %s: %N", errstr, server_size, sbuf); + log_error(LOG_LEVEL_CONNECT, "socks5_connect: %s", errstr); close_socket(sfd); errno = EINVAL;
diff --git a/external/privoxy/gateway.h b/external/privoxy/gateway.h index 4787f82..94115f7 100644 --- a/external/privoxy/gateway.h +++ b/external/privoxy/gateway.h @@ -1,6 +1,6 @@ #ifndef GATEWAY_H_INCLUDED #define GATEWAY_H_INCLUDED -#define GATEWAY_H_VERSION "$Id: gateway.h,v 1.21 2011/09/04 11:10:56 fabiankeil Exp $" +#define GATEWAY_H_VERSION "$Id: gateway.h,v 1.12 2008/12/24 17:06:19 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/gateway.h,v $ @@ -9,14 +9,14 @@ * using a "gateway" (i.e. HTTP proxy and/or SOCKS4 * proxy). Also contains the list of gateway types. * - * Copyright : Written by and Copyright (C) 2001-2009 the + * Copyright : Written by and Copyright (C) 2001 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -34,8 +34,74 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: gateway.h,v $ + * Revision 1.12 2008/12/24 17:06:19 fabiankeil + * Keep a thread around to timeout alive connections + * even if no new requests are coming in. + * + * Revision 1.11 2008/11/13 09:08:42 fabiankeil + * Add new config option: keep-alive-timeout. + * + * Revision 1.10 2008/10/09 18:21:41 fabiankeil + * Flush work-in-progress changes to keep outgoing connections + * alive where possible. Incomplete and mostly #ifdef'd out. + * + * Revision 1.9 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.7 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.6 2002/03/25 22:12:45 oes + * Added fix for undefined INADDR_NONE on Solaris by Bart Schelstraete + * + * Revision 1.5 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.4 2002/03/09 20:03:52 jongfoster + * - Making various functions return int rather than size_t. + * (Undoing a recent change). Since size_t is unsigned on + * Windows, functions like read_socket that return -1 on + * error cannot return a size_t. + * + * THIS WAS A MAJOR BUG - it caused frequent, unpredictable + * crashes, and also frequently caused JB to jump to 100% + * CPU and stay there. (Because it thought it had just + * read ((unsigned)-1) == 4Gb of data...) + * + * - The signature of write_socket has changed, it now simply + * returns success=0/failure=nonzero. + * + * - Trying to get rid of a few warnings --with-debug on + * Windows, I've introduced a new type "jb_socket". This is + * used for the socket file descriptors. On Windows, this + * is SOCKET (a typedef for unsigned). Everywhere else, it's + * an int. The error value can't be -1 any more, so it's + * now JB_INVALID_SOCKET (which is -1 on UNIX, and in + * Windows it maps to the #define INVALID_SOCKET.) + * + * - The signature of bind_port has changed. + * + * Revision 1.3 2001/07/29 18:58:15 jongfoster + * Removing nested #includes, adding forward declarations for needed + * structures, and changing the #define _FILENAME_H to FILENAME_H_INCLUDED. + * + * Revision 1.2 2001/06/07 23:12:14 jongfoster + * Removing gateways[] list - no longer used. + * Replacing function pointer in struct gateway with a directly + * called function forwarded_connect(), which can do the common + * task of deciding whether to connect to the web server or HTTP + * proxy. + * Replacing struct gateway with struct forward_spec + * + * Revision 1.1.1.1 2001/05/15 13:58:54 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -45,9 +111,10 @@ struct forward_spec; struct http_request; struct client_state;
-extern jb_socket forwarded_connect(const struct forward_spec * fwd, - struct http_request *http, +extern jb_socket forwarded_connect(const struct forward_spec * fwd, + struct http_request *http, struct client_state *csp); +#ifdef FEATURE_CONNECTION_KEEP_ALIVE
/* * Default number of seconds after which an @@ -55,20 +122,22 @@ extern jb_socket forwarded_connect(const struct forward_spec * fwd, */ #define DEFAULT_KEEP_ALIVE_TIMEOUT 180
-#ifdef FEATURE_CONNECTION_SHARING -extern void set_keep_alive_timeout(unsigned int timeout); +extern void set_keep_alive_timeout(int timeout); extern void initialize_reusable_connections(void); extern void forget_connection(jb_socket sfd); -extern void remember_connection(const struct reusable_connection *connection); +extern void remember_connection(jb_socket sfd, + const struct http_request *http, + const struct forward_spec *fwd); extern int close_unusable_connections(void); -#endif /* FEATURE_CONNECTION_SHARING */ +#endif /* FEATURE_CONNECTION_KEEP_ALIVE */
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE -extern void mark_connection_closed(struct reusable_connection *closed_connection); -extern int connection_destination_matches(const struct reusable_connection *connection, - const struct http_request *http, - const struct forward_spec *fwd); -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ + +/* + * Solaris fix + */ +#ifndef INADDR_NONE +#define INADDR_NONE -1 +#endif
/* * Revision control strings from this header and associated .c file diff --git a/external/privoxy/icons/off.ico b/external/privoxy/icons/off.ico index 76ef561..cea8778 100644 Binary files a/external/privoxy/icons/off.ico and b/external/privoxy/icons/off.ico differ diff --git a/external/privoxy/icons/privoxy.ico b/external/privoxy/icons/privoxy.ico index 52920ba..4c96d0b 100644 Binary files a/external/privoxy/icons/privoxy.ico and b/external/privoxy/icons/privoxy.ico differ diff --git a/external/privoxy/jbsockets.c b/external/privoxy/jbsockets.c index 95db651..4548ff2 100644 --- a/external/privoxy/jbsockets.c +++ b/external/privoxy/jbsockets.c @@ -1,4 +1,4 @@ -const char jbsockets_rcs[] = "$Id: jbsockets.c,v 1.111 2011/12/10 17:26:30 fabiankeil Exp $"; +const char jbsockets_rcs[] = "$Id: jbsockets.c,v 1.50 2008/12/20 14:53:55 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/jbsockets.c,v $ @@ -8,14 +8,14 @@ const char jbsockets_rcs[] = "$Id: jbsockets.c,v 1.111 2011/12/10 17:26:30 fabia * OS-independent. Contains #ifdefs to make this work * on many platforms. * - * Copyright : Written by and Copyright (C) 2001-2011 the + * Copyright : Written by and Copyright (C) 2001-2007 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -33,8 +33,240 @@ const char jbsockets_rcs[] = "$Id: jbsockets.c,v 1.111 2011/12/10 17:26:30 fabia * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: jbsockets.c,v $ + * Revision 1.50 2008/12/20 14:53:55 fabiankeil + * Add config option socket-timeout to control the time + * Privoxy waits for data to arrive on a socket. Useful + * in case of stale ssh tunnels or when fuzz-testing. + * + * Revision 1.49 2008/11/10 17:03:57 fabiankeil + * Fix a gcc44 warning and remove a now-obsolete cast. + * + * Revision 1.48 2008/09/04 08:13:58 fabiankeil + * Prepare for critical sections on Windows by adding a + * layer of indirection before the pthread mutex functions. + * + * Revision 1.47 2008/03/26 18:07:07 fabiankeil + * Add hostname directive. Closes PR#1918189. + * + * Revision 1.46 2008/03/21 11:13:57 fabiankeil + * Only gather host information if it's actually needed. + * Also move the code out of accept_connection() so it's less likely + * to delay other incoming connections if the host is misconfigured. + * + * Revision 1.45 2007/09/30 16:59:22 fabiankeil + * Set the maximum listen() backlog to 128. Apparently SOMAXCONN is + * neither high enough, nor a hard limit on mingw32. Again for BR#1795281. + * + * Revision 1.44 2007/09/15 13:01:31 fabiankeil + * Increase listen() backlog to SOMAXCONN (or 128) to decrease + * chances of dropped connections under load. Problem reported + * and fix suggested by nobody in BR#1795281. + * + * Revision 1.43 2007/06/01 18:16:36 fabiankeil + * Use the same mutex for gethostbyname() and gethostbyaddr() to prevent + * deadlocks and crashes on OpenBSD and possibly other OS with neither + * gethostbyname_r() nor gethostaddr_r(). Closes BR#1729174. + * Thanks to Ralf Horstmann for report and solution. + * + * Revision 1.42 2007/04/01 17:37:07 fabiankeil + * - Add DNS retries for Solaris and other systems + * whose gethostbyname_r version takes five arguments. + * - Move maximum number of DNS retries into a macro. + * + * Revision 1.41 2006/11/13 19:05:51 fabiankeil + * Make pthread mutex locking more generic. Instead of + * checking for OSX and OpenBSD, check for FEATURE_PTHREAD + * and use mutex locking unless there is an _r function + * available. Better safe than sorry. + * + * Fixes "./configure --disable-pthread" and should result + * in less threading-related problems on pthread-using platforms, + * but it still doesn't fix BR#1122404. + * + * Revision 1.40 2006/09/02 15:36:42 fabiankeil + * Follow the OpenBSD port's lead and protect the resolve + * functions on OpenBSD as well. + * + * Revision 1.39 2006/08/03 02:46:41 david__schmidt + * Incorporate Fabian Keil's patch work:http://www.fabiankeil.de/sourcecode/privoxy/ + * + * Revision 1.38 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.35.2.8 2006/01/21 16:16:08 david__schmidt + * Thanks to Edward Carrel for his patch to modernize OSX'spthreads support. See bug #1409623. + * + * Revision 1.35.2.7 2005/05/07 21:50:55 david__schmidt + * A few memory leaks plugged (mostly on error paths) + * + * Revision 1.35.2.6 2003/12/17 16:34:40 oes + * Cosmetics + * + * Revision 1.35.2.5 2003/04/29 11:32:54 oes + * Don't rely on h_addr being non-NULL after gethostbyname. + * Works around an oddness in Max OSX and closes bug #724796 + * + * Revision 1.35.2.4 2003/04/04 12:40:20 oes + * Made sure the errno set by bind, not close[socket] is used in + * bind_port. Probably fixes bugs #713777, #705562. + * + * Revision 1.35.2.3 2003/03/07 03:41:04 david__schmidt + * Wrapping all *_r functions (the non-_r versions of them) with mutex semaphores for OSX. Hopefully this will take care of all of those pesky crash reports. + * + * Revision 1.35.2.2 2002/11/20 14:37:24 oes + * Fixed Win32 error logging in bind_port. + * Thanks to Oliver Stoeneberg for the hint. + * + * Revision 1.35.2.1 2002/05/26 23:41:27 joergs + * AmigaOS: Fixed wrong type of len in write_socket() + * + * Revision 1.35 2002/04/26 15:50:04 joergs + * AmigaOS: No socklen_t, added AMIGA to the systems using int instead. + * + * Revision 1.34 2002/04/08 20:31:41 swa + * fixed JB spelling + * + * Revision 1.33 2002/04/03 16:02:18 gliptak + * Correcting compile warning with older gcc + * + * Revision 1.32 2002/03/31 17:18:59 jongfoster + * Win32 only: Enabling STRICT to fix a VC++ compile warning. + * + * Revision 1.31 2002/03/29 03:33:13 david__schmidt + * Fix Mac OSX compiler warnings + * + * Revision 1.30 2002/03/27 14:32:43 david__schmidt + * More compiler warning message maintenance + * + * Revision 1.29 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.28 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.27 2002/03/13 00:27:05 jongfoster + * Killing warnings + * + * Revision 1.26 2002/03/11 22:07:02 david__schmidt + * OS/2 port maintenance: + * - Fixed EMX build - it had decayed a little + * - Fixed inexplicable crash during FD_ZERO - must be due to a bad macro. + * substituted a memset for now. + * + * Revision 1.25 2002/03/09 20:03:52 jongfoster + * - Making various functions return int rather than size_t. + * (Undoing a recent change). Since size_t is unsigned on + * Windows, functions like read_socket that return -1 on + * error cannot return a size_t. + * + * THIS WAS A MAJOR BUG - it caused frequent, unpredictable + * crashes, and also frequently caused JB to jump to 100% + * CPU and stay there. (Because it thought it had just + * read ((unsigned)-1) == 4Gb of data...) + * + * - The signature of write_socket has changed, it now simply + * returns success=0/failure=nonzero. + * + * - Trying to get rid of a few warnings --with-debug on + * Windows, I've introduced a new type "jb_socket". This is + * used for the socket file descriptors. On Windows, this + * is SOCKET (a typedef for unsigned). Everywhere else, it's + * an int. The error value can't be -1 any more, so it's + * now JB_INVALID_SOCKET (which is -1 on UNIX, and in + * Windows it maps to the #define INVALID_SOCKET.) + * + * - The signature of bind_port has changed. + * + * Revision 1.24 2002/03/07 03:51:36 oes + * - Improved handling of failed DNS lookups + * - Fixed compiler warnings etc + * + * Revision 1.23 2002/03/05 00:36:01 jongfoster + * Fixing bug 514988 - unable to restart Junkbuster + * + * Revision 1.22 2002/03/04 02:08:02 david__schmidt + * Enable web editing of actions file on OS/2 (it had been broken all this time!) + * + * Revision 1.21 2002/01/09 14:32:33 oes + * Added support for gethostbyname_r and gethostbyaddr_r. + * + * Revision 1.20 2001/11/16 00:48:48 jongfoster + * Enabling duplicate-socket detection for all platforms, not + * just Win32. + * + * Revision 1.19 2001/10/25 03:40:47 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.18 2001/09/21 23:02:02 david__schmidt + * Cleaning up 2 compiler warnings on OS/2. + * + * Revision 1.17 2001/09/13 20:11:46 jongfoster + * Fixing 2 compiler warnings under Win32 + * + * Revision 1.16 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.15 2001/07/29 17:40:43 jongfoster + * Fixed compiler warning by adding a cast + * + * Revision 1.14 2001/07/18 13:47:59 oes + * Eliminated dirty hack for getsockbyname() + * + * Revision 1.13 2001/07/15 13:56:57 jongfoster + * Removing unused local variable. + * + * Revision 1.12 2001/07/01 17:04:11 oes + * Bugfix: accept_connection no longer uses the obsolete hstrerror() function + * + * Revision 1.11 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.10 2001/06/29 13:29:15 oes + * - Added remote (server) host IP to csp->http->host_ip_addr_str + * - Added detection of local socket IP and fqdn + * - Removed logentry from cancelled commit + * + * Revision 1.9 2001/06/07 23:06:09 jongfoster + * The host parameter to connect_to() is now const. + * + * Revision 1.8 2001/06/03 19:12:07 oes + * filled comment + * + * Revision 1.7 2001/05/28 16:14:00 jongfoster + * Fixing bug in LOG_LEVEL_LOG + * + * Revision 1.6 2001/05/26 17:28:32 jongfoster + * Fixed LOG_LEVEL_LOG + * + * Revision 1.5 2001/05/26 15:26:15 jongfoster + * ACL feature now provides more security by immediately dropping + * connections from untrusted hosts. + * + * Revision 1.4 2001/05/26 00:37:42 jongfoster + * Cosmetic indentation correction. + * + * Revision 1.3 2001/05/25 21:57:54 jongfoster + * Now gives a warning under Windows if you try to bind + * it to a port that's already in use. + * + * Revision 1.2 2001/05/17 23:01:01 oes + * - Cleaned CRLF's from the sources and related files + * + * Revision 1.1.1.1 2001/05/15 13:58:54 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -83,30 +315,17 @@ const char jbsockets_rcs[] = "$Id: jbsockets.c,v 1.111 2011/12/10 17:26:30 fabia
#endif
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE -#ifdef HAVE_POLL -#ifdef __GLIBC__ -#include <sys/poll.h> -#else -#include <poll.h> -#endif /* def __GLIBC__ */ -#endif /* HAVE_POLL */ -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - #include "project.h"
-/* For mutex semaphores only */ +#ifdef FEATURE_PTHREAD #include "jcc.h" +/* jcc.h is for mutex semaphores only */ +#endif /* def FEATURE_PTHREAD */
#include "jbsockets.h" #include "filters.h" #include "errlog.h"
-/* Mac OSX doesn't define AI_NUMERICSESRV */ -#ifndef AI_NUMERICSERV -#define AI_NUMERICSERV 0 -#endif - const char jbsockets_h_rcs[] = JBSOCKETS_H_VERSION;
/* @@ -118,11 +337,6 @@ const char jbsockets_h_rcs[] = JBSOCKETS_H_VERSION;
#define MAX_LISTEN_BACKLOG 128
-#ifdef HAVE_RFC2553 -static jb_socket rfc2553_connect_to(const char *host, int portnum, struct client_state *csp); -#else -static jb_socket no_rfc2553_connect_to(const char *host, int portnum, struct client_state *csp); -#endif
/********************************************************************* * @@ -135,6 +349,7 @@ static jb_socket no_rfc2553_connect_to(const char *host, int portnum, struct cli * 1 : host = hostname to connect to * 2 : portnum = port to connent on (XXX: should be unsigned) * 3 : csp = Current client state (buffers, headers, etc...) + * Not modified, only used for source IP and ACL. * * Returns : JB_INVALID_SOCKET => failure, else it is the socket * file descriptor. @@ -142,276 +357,19 @@ static jb_socket no_rfc2553_connect_to(const char *host, int portnum, struct cli *********************************************************************/ jb_socket connect_to(const char *host, int portnum, struct client_state *csp) { - jb_socket fd; - int forwarded_connect_retries = 0; - - do - { - /* - * XXX: The whole errno overloading is ridiculous and should - * be replaced with something sane and thread safe - */ - /* errno = 0;*/ -#ifdef HAVE_RFC2553 - fd = rfc2553_connect_to(host, portnum, csp); -#else - fd = no_rfc2553_connect_to(host, portnum, csp); -#endif - if ((fd != JB_INVALID_SOCKET) || (errno == EINVAL) - || (csp->fwd == NULL) - || ((csp->fwd->forward_host == NULL) && (csp->fwd->type == SOCKS_NONE))) - { - break; - } - forwarded_connect_retries++; - if (csp->config->forwarded_connect_retries != 0) - { - log_error(LOG_LEVEL_ERROR, - "Attempt %d of %d to connect to %s failed. Trying again.", - forwarded_connect_retries, csp->config->forwarded_connect_retries + 1, host); - } - - } while (forwarded_connect_retries < csp->config->forwarded_connect_retries); - - return fd; -} - -#ifdef HAVE_RFC2553 -/* Getaddrinfo implementation */ -static jb_socket rfc2553_connect_to(const char *host, int portnum, struct client_state *csp) -{ - struct addrinfo hints, *result, *rp; - char service[6]; - int retval; - jb_socket fd; - fd_set wfds; - struct timeval timeout; -#if !defined(_WIN32) && !defined(__BEOS__) && !defined(AMIGA) && !defined(__OS2__) - int flags; -#endif - int connect_failed; - /* - * XXX: Initializeing it here is only necessary - * because not all situations are properly - * covered yet. - */ - int socket_error = 0; - -#ifdef FEATURE_ACL - struct access_control_addr dst[1]; -#endif /* def FEATURE_ACL */ - - /* Don't leak memory when retrying. */ - freez(csp->error_message); - freez(csp->http->host_ip_addr_str); - - retval = snprintf(service, sizeof(service), "%d", portnum); - if ((-1 == retval) || (sizeof(service) <= retval)) - { - log_error(LOG_LEVEL_ERROR, - "Port number (%d) ASCII decimal representation doesn't fit into 6 bytes", - portnum); - csp->error_message = strdup("Invalid port number"); - csp->http->host_ip_addr_str = strdup("unknown"); - return(JB_INVALID_SOCKET); - } - - memset((char *)&hints, 0, sizeof(hints)); - hints.ai_family = AF_UNSPEC; - hints.ai_socktype = SOCK_STREAM; - hints.ai_flags = AI_NUMERICSERV; /* avoid service look-up */ -#ifdef AI_ADDRCONFIG - hints.ai_flags |= AI_ADDRCONFIG; -#endif - if ((retval = getaddrinfo(host, service, &hints, &result))) - { - log_error(LOG_LEVEL_INFO, - "Can not resolve %s: %s", host, gai_strerror(retval)); - /* XXX: Should find a better way to propagate this error. */ - errno = EINVAL; - csp->error_message = strdup(gai_strerror(retval)); - csp->http->host_ip_addr_str = strdup("unknown"); - return(JB_INVALID_SOCKET); - } - - csp->http->host_ip_addr_str = malloc(NI_MAXHOST); - if (NULL == csp->http->host_ip_addr_str) - { - freeaddrinfo(result); - log_error(LOG_LEVEL_ERROR, - "Out of memory while getting the server IP address."); - return JB_INVALID_SOCKET; - } - - for (rp = result; rp != NULL; rp = rp->ai_next) - { - -#ifdef FEATURE_ACL - memcpy(&dst->addr, rp->ai_addr, rp->ai_addrlen); - - if (block_acl(dst, csp)) - { -#ifdef __OS2__ - socket_error = errno = SOCEPERM; -#else - socket_error = errno = EPERM; -#endif - continue; - } -#endif /* def FEATURE_ACL */ - - retval = getnameinfo(rp->ai_addr, rp->ai_addrlen, - csp->http->host_ip_addr_str, NI_MAXHOST, NULL, 0, NI_NUMERICHOST); - if (retval) - { - log_error(LOG_LEVEL_ERROR, - "Failed to get the host name from the socket structure: %s", - gai_strerror(retval)); - continue; - } - - fd = socket(rp->ai_family, rp->ai_socktype, rp->ai_protocol); -#ifdef _WIN32 - if (fd == JB_INVALID_SOCKET) -#else - if (fd < 0) -#endif - { - continue; - } - -#ifdef TCP_NODELAY - { /* turn off TCP coalescence */ - int mi = 1; - setsockopt(fd, IPPROTO_TCP, TCP_NODELAY, (char *) &mi, sizeof (int)); - } -#endif /* def TCP_NODELAY */ - -#if !defined(_WIN32) && !defined(__BEOS__) && !defined(AMIGA) && !defined(__OS2__) - if ((flags = fcntl(fd, F_GETFL, 0)) != -1) - { - flags |= O_NDELAY; - fcntl(fd, F_SETFL, flags); - } -#endif /* !defined(_WIN32) && !defined(__BEOS__) && !defined(AMIGA) && !defined(__OS2__) */ - - connect_failed = 0; - while (connect(fd, rp->ai_addr, rp->ai_addrlen) == JB_INVALID_SOCKET) - { -#ifdef __OS2__ - errno = sock_errno(); -#endif /* __OS2__ */ - -#ifdef _WIN32 - if (errno == WSAEINPROGRESS) -#else /* ifndef _WIN32 */ - if (errno == EINPROGRESS) -#endif /* ndef _WIN32 || __OS2__ */ - { - break; - } - - if (errno != EINTR) - { - socket_error = errno; - close_socket(fd); - connect_failed = 1; - break; - } - } - if (connect_failed) - { - continue; - } - -#if !defined(_WIN32) && !defined(__BEOS__) && !defined(AMIGA) && !defined(__OS2__) - if (flags != -1) - { - flags &= ~O_NDELAY; - fcntl(fd, F_SETFL, flags); - } -#endif /* !defined(_WIN32) && !defined(__BEOS__) && !defined(AMIGA) && !defined(__OS2__) */ - - /* wait for connection to complete */ - FD_ZERO(&wfds); - FD_SET(fd, &wfds); - - memset(&timeout, 0, sizeof(timeout)); - timeout.tv_sec = 30; - - /* MS Windows uses int, not SOCKET, for the 1st arg of select(). Weird! */ - if ((select((int)fd + 1, NULL, &wfds, NULL, &timeout) > 0) - && FD_ISSET(fd, &wfds)) - { - socklen_t optlen = sizeof(socket_error); - if (!getsockopt(fd, SOL_SOCKET, SO_ERROR, &socket_error, &optlen)) - { - if (!socket_error) - { - /* Connection established, no need to try other addresses. */ - break; - } - if (rp->ai_next != NULL) - { - /* - * There's another address we can try, so log that this - * one didn't work out. If the last one fails, too, - * it will get logged outside the loop body so we don't - * have to mention it here. - */ - log_error(LOG_LEVEL_CONNECT, "Could not connect to [%s]:%s: %s.", - csp->http->host_ip_addr_str, service, strerror(socket_error)); - } - } - else - { - socket_error = errno; - log_error(LOG_LEVEL_ERROR, "Could not get the state of " - "the connection to [%s]:%s: %s; dropping connection.", - csp->http->host_ip_addr_str, service, strerror(errno)); - } - } - - /* Connection failed, try next address */ - close_socket(fd); - } - - freeaddrinfo(result); - if (!rp) - { - log_error(LOG_LEVEL_CONNECT, "Could not connect to [%s]:%s: %s.", - host, service, strerror(socket_error)); - csp->error_message = strdup(strerror(socket_error)); - return(JB_INVALID_SOCKET); - } - log_error(LOG_LEVEL_CONNECT, "Connected to %s[%s]:%s.", - host, csp->http->host_ip_addr_str, service); - - return(fd); - -} - -#else /* ndef HAVE_RFC2553 */ -/* Pre-getaddrinfo implementation */ - -static jb_socket no_rfc2553_connect_to(const char *host, int portnum, struct client_state *csp) -{ struct sockaddr_in inaddr; jb_socket fd; unsigned int addr; fd_set wfds; struct timeval tv[1]; -#if !defined(_WIN32) && !defined(__BEOS__) && !defined(AMIGA) && !defined(__OS2__) +#if !defined(_WIN32) && !defined(__BEOS__) && !defined(AMIGA) int flags; -#endif +#endif /* !defined(_WIN32) && !defined(__BEOS__) && !defined(AMIGA) */
#ifdef FEATURE_ACL struct access_control_addr dst[1]; #endif /* def FEATURE_ACL */
- /* Don't leak memory when retrying. */ - freez(csp->http->host_ip_addr_str); - memset((char *)&inaddr, 0, sizeof inaddr);
if ((addr = resolve_hostname_to_ip(host)) == INADDR_NONE) @@ -452,11 +410,10 @@ static jb_socket no_rfc2553_connect_to(const char *host, int portnum, struct cli } #endif /* ndef _WIN32 */
- fd = socket(inaddr.sin_family, SOCK_STREAM, 0); #ifdef _WIN32 - if (fd == JB_INVALID_SOCKET) + if ((fd = socket(inaddr.sin_family, SOCK_STREAM, 0)) == JB_INVALID_SOCKET) #else - if (fd < 0) + if ((fd = socket(inaddr.sin_family, SOCK_STREAM, 0)) < 0) #endif { return(JB_INVALID_SOCKET); @@ -481,7 +438,7 @@ static jb_socket no_rfc2553_connect_to(const char *host, int portnum, struct cli { #ifdef _WIN32 if (errno == WSAEINPROGRESS) -#elif __OS2__ +#elif __OS2__ if (sock_errno() == EINPROGRESS) #else /* ifndef _WIN32 */ if (errno == EINPROGRESS) @@ -490,7 +447,7 @@ static jb_socket no_rfc2553_connect_to(const char *host, int portnum, struct cli break; }
-#ifdef __OS2__ +#ifdef __OS2__ if (sock_errno() != EINTR) #else if (errno != EINTR) @@ -516,7 +473,7 @@ static jb_socket no_rfc2553_connect_to(const char *host, int portnum, struct cli tv->tv_sec = 30; tv->tv_usec = 0;
- /* MS Windows uses int, not SOCKET, for the 1st arg of select(). Weird! */ + /* MS Windows uses int, not SOCKET, for the 1st arg of select(). Wierd! */ if (select((int)fd + 1, NULL, &wfds, NULL, tv) <= 0) { close_socket(fd); @@ -525,7 +482,6 @@ static jb_socket no_rfc2553_connect_to(const char *host, int portnum, struct cli return(fd);
} -#endif /* ndef HAVE_RFC2553 */
/********************************************************************* @@ -554,7 +510,12 @@ int write_socket(jb_socket fd, const char *buf, size_t len) return 0; }
- log_error(LOG_LEVEL_WRITING, "to socket %d: %N", fd, len, buf); + if (len < 0) /* constant condition - size_t isn't ever negative */ + { + return 1; + } + + log_error(LOG_LEVEL_LOG, "%N", len, buf);
#if defined(_WIN32) return (send(fd, buf, (int)len, 0) != (int)len); @@ -567,7 +528,7 @@ int write_socket(jb_socket fd, const char *buf, size_t len) */ #define SOCKET_SEND_MAX 65000 { - int send_len, send_rc = 0, i = 0; + int write_len = 0, send_len, send_rc = 0, i = 0; while ((i < len) && (send_rc != -1)) { if ((i + SOCKET_SEND_MAX) > len) @@ -615,27 +576,18 @@ int write_socket(jb_socket fd, const char *buf, size_t len) *********************************************************************/ int read_socket(jb_socket fd, char *buf, int len) { - int ret; - if (len <= 0) { return(0); }
#if defined(_WIN32) - ret = recv(fd, buf, len, 0); + return(recv(fd, buf, len, 0)); #elif defined(__BEOS__) || defined(AMIGA) || defined(__OS2__) - ret = recv(fd, buf, (size_t)len, 0); + return(recv(fd, buf, (size_t)len, 0)); #else - ret = (int)read(fd, buf, (size_t)len); + return(read(fd, buf, (size_t)len)); #endif - - if (ret > 0) - { - log_error(LOG_LEVEL_RECEIVED, "from socket %d: %N", fd, ret, buf); - } - - return ret; }
@@ -655,7 +607,6 @@ int read_socket(jb_socket fd, char *buf, int len) *********************************************************************/ int data_is_available(jb_socket fd, int seconds_to_wait) { - char buf[10]; fd_set rfds; struct timeval timeout; int n; @@ -676,7 +627,7 @@ int data_is_available(jb_socket fd, int seconds_to_wait) /* * XXX: Do we care about the different error conditions? */ - return ((n == 1) && (1 == recv(fd, buf, 1, MSG_PEEK))); + return (n == 1); }
@@ -697,7 +648,7 @@ void close_socket(jb_socket fd) #if defined(_WIN32) || defined(__BEOS__) closesocket(fd); #elif defined(AMIGA) - CloseSocket(fd); + CloseSocket(fd); #elif defined(__OS2__) soclose(fd); #else @@ -726,19 +677,7 @@ void close_socket(jb_socket fd) *********************************************************************/ int bind_port(const char *hostnam, int portnum, jb_socket *pfd) { -#ifdef HAVE_RFC2553 - struct addrinfo hints; - struct addrinfo *result, *rp; - /* - * XXX: portnum should be a string to allow symbolic service - * names in the configuration file and to avoid the following - * int2string. - */ - char servnam[6]; - int retval; -#else struct sockaddr_in inaddr; -#endif /* def HAVE_RFC2553 */ jb_socket fd; #ifndef _WIN32 int one = 1; @@ -746,45 +685,6 @@ int bind_port(const char *hostnam, int portnum, jb_socket *pfd)
*pfd = JB_INVALID_SOCKET;
-#ifdef HAVE_RFC2553 - retval = snprintf(servnam, sizeof(servnam), "%d", portnum); - if ((-1 == retval) || (sizeof(servnam) <= retval)) - { - log_error(LOG_LEVEL_ERROR, - "Port number (%d) ASCII decimal representation doesn't fit into 6 bytes", - portnum); - return -1; - } - - memset(&hints, 0, sizeof(struct addrinfo)); - if (hostnam == NULL) - { - /* - * XXX: This is a hack. The right thing to do - * would be to bind to both AF_INET and AF_INET6. - * This will also fail if there is no AF_INET - * version available. - */ - hints.ai_family = AF_INET; - } - else - { - hints.ai_family = AF_UNSPEC; - } - hints.ai_socktype = SOCK_STREAM; - hints.ai_flags = AI_PASSIVE; - hints.ai_protocol = 0; /* Really any stream protocol or TCP only */ - hints.ai_canonname = NULL; - hints.ai_addr = NULL; - hints.ai_next = NULL; - - if ((retval = getaddrinfo(hostnam, servnam, &hints, &result))) - { - log_error(LOG_LEVEL_ERROR, - "Can not resolve %s: %s", hostnam, gai_strerror(retval)); - return -2; - } -#else memset((char *)&inaddr, '\0', sizeof inaddr);
inaddr.sin_family = AF_INET; @@ -807,15 +707,8 @@ int bind_port(const char *hostnam, int portnum, jb_socket *pfd) inaddr.sin_port = htonl((unsigned long) portnum); } #endif /* ndef _WIN32 */ -#endif /* def HAVE_RFC2553 */
-#ifdef HAVE_RFC2553 - for (rp = result; rp != NULL; rp = rp->ai_next) - { - fd = socket(rp->ai_family, rp->ai_socktype, rp->ai_protocol); -#else fd = socket(AF_INET, SOCK_STREAM, 0); -#endif /* def HAVE_RFC2553 */
#ifdef _WIN32 if (fd == JB_INVALID_SOCKET) @@ -823,11 +716,7 @@ int bind_port(const char *hostnam, int portnum, jb_socket *pfd) if (fd < 0) #endif { -#ifdef HAVE_RFC2553 - continue; -#else return(-1); -#endif }
#ifndef _WIN32 @@ -846,11 +735,7 @@ int bind_port(const char *hostnam, int portnum, jb_socket *pfd) setsockopt(fd, SOL_SOCKET, SO_REUSEADDR, (char *)&one, sizeof(one)); #endif /* ndef _WIN32 */
-#ifdef HAVE_RFC2553 - if (bind(fd, rp->ai_addr, rp->ai_addrlen) < 0) -#else if (bind(fd, (struct sockaddr *)&inaddr, sizeof(inaddr)) < 0) -#endif { #ifdef _WIN32 errno = WSAGetLastError(); @@ -859,41 +744,15 @@ int bind_port(const char *hostnam, int portnum, jb_socket *pfd) if (errno == EADDRINUSE) #endif { -#ifdef HAVE_RFC2553 - freeaddrinfo(result); -#endif close_socket(fd); return(-3); } else { close_socket(fd); -#ifndef HAVE_RFC2553 return(-1); } } -#else - } - } - else - { - /* bind() succeeded, escape from for-loop */ - /* - * XXX: Support multiple listening sockets (e.g. localhost - * resolves to AF_INET and AF_INET6, but only the first address - * is used - */ - break; - } - } - - freeaddrinfo(result); - if (rp == NULL) - { - /* All bind()s failed */ - return(-1); - } -#endif /* ndef HAVE_RFC2553 */
while (listen(fd, MAX_LISTEN_BACKLOG) == -1) { @@ -924,32 +783,23 @@ int bind_port(const char *hostnam, int portnum, jb_socket *pfd) * 1 : afd = File descriptor returned from accept(). * 2 : ip_address = Pointer to return the pointer to * the ip address string. - * 3 : port = Pointer to return the pointer to - * the TCP port string. - * 4 : hostname = Pointer to return the pointer to + * 3 : hostname = Pointer to return the pointer to * the hostname or NULL if the caller * isn't interested in it. * * Returns : void. * *********************************************************************/ -void get_host_information(jb_socket afd, char **ip_address, char **port, - char **hostname) +void get_host_information(jb_socket afd, char **ip_address, char **hostname) { -#ifdef HAVE_RFC2553 - struct sockaddr_storage server; - int retval; -#else struct sockaddr_in server; struct hostent *host = NULL; -#endif /* HAVE_RFC2553 */ #if defined(_WIN32) || defined(__OS2__) || defined(__APPLE_CC__) || defined(AMIGA) /* according to accept_connection() this fixes a warning. */ - int s_length, s_length_provided; + int s_length; #else - socklen_t s_length, s_length_provided; + socklen_t s_length; #endif -#ifndef HAVE_RFC2553 #if defined(HAVE_GETHOSTBYADDR_R_8_ARGS) || defined(HAVE_GETHOSTBYADDR_R_7_ARGS) || defined(HAVE_GETHOSTBYADDR_R_5_ARGS) struct hostent result; #if defined(HAVE_GETHOSTBYADDR_R_5_ARGS) @@ -959,54 +809,18 @@ void get_host_information(jb_socket afd, char **ip_address, char **port, int thd_err; #endif /* def HAVE_GETHOSTBYADDR_R_5_ARGS */ #endif /* def HAVE_GETHOSTBYADDR_R_(8|7|5)_ARGS */ -#endif /* ifndef HAVE_RFC2553 */ - s_length = s_length_provided = sizeof(server); + s_length = sizeof(server);
if (NULL != hostname) { *hostname = NULL; } *ip_address = NULL; - *port = NULL;
if (!getsockname(afd, (struct sockaddr *) &server, &s_length)) { - if (s_length > s_length_provided) - { - log_error(LOG_LEVEL_ERROR, "getsockname() truncated server address"); - return; - } - *port = malloc(NI_MAXSERV); - if (NULL == *port) - { - log_error(LOG_LEVEL_ERROR, - "Out of memory while getting the client's port."); - return; - } -#ifdef HAVE_RFC2553 - *ip_address = malloc(NI_MAXHOST); - if (NULL == *ip_address) - { - log_error(LOG_LEVEL_ERROR, - "Out of memory while getting the client's IP address."); - freez(*port); - return; - } - retval = getnameinfo((struct sockaddr *) &server, s_length, - *ip_address, NI_MAXHOST, *port, NI_MAXSERV, - NI_NUMERICHOST|NI_NUMERICSERV); - if (retval) - { - log_error(LOG_LEVEL_ERROR, - "Unable to print my own IP address: %s", gai_strerror(retval)); - freez(*ip_address); - freez(*port); - return; - } -#else *ip_address = strdup(inet_ntoa(server.sin_addr)); - snprintf(*port, NI_MAXSERV, "%hu", ntohs(server.sin_port)); -#endif /* HAVE_RFC2553 */ + if (NULL == hostname) { /* @@ -1015,24 +829,6 @@ void get_host_information(jb_socket afd, char **ip_address, char **port, */ return; } - -#ifdef HAVE_RFC2553 - *hostname = malloc(NI_MAXHOST); - if (NULL == *hostname) - { - log_error(LOG_LEVEL_ERROR, - "Out of memory while getting the client's hostname."); - return; - } - retval = getnameinfo((struct sockaddr *) &server, s_length, - *hostname, NI_MAXHOST, NULL, 0, NI_NAMEREQD); - if (retval) - { - log_error(LOG_LEVEL_ERROR, - "Unable to resolve my own IP address: %s", gai_strerror(retval)); - freez(*hostname); - } -#else #if defined(HAVE_GETHOSTBYADDR_R_8_ARGS) gethostbyaddr_r((const char *)&server.sin_addr, sizeof(server.sin_addr), AF_INET, @@ -1053,13 +849,13 @@ void get_host_information(jb_socket afd, char **ip_address, char **port, { host = NULL; } -#elif defined(MUTEX_LOCKS_AVAILABLE) +#elif FEATURE_PTHREAD privoxy_mutex_lock(&resolver_mutex); - host = gethostbyaddr((const char *)&server.sin_addr, + host = gethostbyaddr((const char *)&server.sin_addr, sizeof(server.sin_addr), AF_INET); privoxy_mutex_unlock(&resolver_mutex); #else - host = gethostbyaddr((const char *)&server.sin_addr, + host = gethostbyaddr((const char *)&server.sin_addr, sizeof(server.sin_addr), AF_INET); #endif if (host == NULL) @@ -1070,7 +866,6 @@ void get_host_information(jb_socket afd, char **ip_address, char **port, { *hostname = strdup(host->h_name); } -#endif /* else def HAVE_RFC2553 */ }
return; @@ -1081,27 +876,21 @@ void get_host_information(jb_socket afd, char **ip_address, char **port, * * Function : accept_connection * - * Description : Accepts a connection on one of possibly multiple - * sockets. The socket(s) to check must have been - * created using bind_port(). + * Description : Accepts a connection on a socket. Socket must have + * been created using bind_port(). * * Parameters : - * 1 : csp = Client state, cfd, ip_addr_str, and - * ip_addr_long will be set by this routine. - * 2 : fds = File descriptors returned from bind_port + * 1 : csp = Client state, cfd, ip_addr_str, and + * ip_addr_long will be set by this routine. + * 2 : fd = file descriptor returned from bind_port * * Returns : when a connection is accepted, it returns 1 (TRUE). * On an error it returns 0 (FALSE). * *********************************************************************/ -int accept_connection(struct client_state * csp, jb_socket fds[]) +int accept_connection(struct client_state * csp, jb_socket fd) { -#ifdef HAVE_RFC2553 - /* XXX: client is stored directly into csp->tcp_addr */ -#define client (csp->tcp_addr) -#else struct sockaddr_in client; -#endif jb_socket afd; #if defined(_WIN32) || defined(__OS2__) || defined(__APPLE_CC__) || defined(AMIGA) /* Wierdness - fix a warning. */ @@ -1109,69 +898,9 @@ int accept_connection(struct client_state * csp, jb_socket fds[]) #else socklen_t c_length; #endif - int retval; - int i; - int max_selected_socket; - fd_set selected_fds; - jb_socket fd;
c_length = sizeof(client);
- /* - * Wait for a connection on any socket. - * Return immediately if no socket is listening. - * XXX: Why not treat this as fatal error? - */ - FD_ZERO(&selected_fds); - max_selected_socket = 0; - for (i = 0; i < MAX_LISTENING_SOCKETS; i++) - { - if (JB_INVALID_SOCKET != fds[i]) - { - FD_SET(fds[i], &selected_fds); - if (max_selected_socket < fds[i] + 1) - { - max_selected_socket = fds[i] + 1; - } - } - } - if (0 == max_selected_socket) - { - return 0; - } - do - { - retval = select(max_selected_socket, &selected_fds, NULL, NULL, NULL); - } while (retval < 0 && errno == EINTR); - if (retval <= 0) - { - if (0 == retval) - { - log_error(LOG_LEVEL_ERROR, - "Waiting on new client failed because select(2) returned 0." - " This should not happen."); - } - else - { - log_error(LOG_LEVEL_ERROR, - "Waiting on new client failed because of problems in select(2): " - "%s.", strerror(errno)); - } - return 0; - } - for (i = 0; i < MAX_LISTENING_SOCKETS && !FD_ISSET(fds[i], &selected_fds); - i++); - if (i >= MAX_LISTENING_SOCKETS) - { - log_error(LOG_LEVEL_ERROR, - "select(2) reported connected clients (number = %u, " - "descriptor boundary = %u), but none found.", - retval, max_selected_socket); - return 0; - } - fd = fds[i]; - - /* Accept selected connection */ #ifdef _WIN32 afd = accept (fd, (struct sockaddr *) &client, &c_length); if (afd == JB_INVALID_SOCKET) @@ -1181,12 +910,6 @@ int accept_connection(struct client_state * csp, jb_socket fds[]) #else do { -#if defined(FEATURE_ACCEPT_FILTER) && defined(SO_ACCEPTFILTER) - struct accept_filter_arg af_options; - bzero(&af_options, sizeof(af_options)); - strlcpy(af_options.af_name, "httpready", sizeof(af_options.af_name)); - setsockopt(fd, SOL_SOCKET, SO_ACCEPTFILTER, &af_options, sizeof(af_options)); -#endif afd = accept (fd, (struct sockaddr *) &client, &c_length); } while (afd < 1 && errno == EINTR); if (afd < 0) @@ -1196,27 +919,8 @@ int accept_connection(struct client_state * csp, jb_socket fds[]) #endif
csp->cfd = afd; -#ifdef HAVE_RFC2553 - csp->ip_addr_str = malloc(NI_MAXHOST); - if (NULL == csp->ip_addr_str) - { - log_error(LOG_LEVEL_ERROR, - "Out of memory while getting the client's IP address."); - return 0; - } - retval = getnameinfo((struct sockaddr *) &client, c_length, - csp->ip_addr_str, NI_MAXHOST, NULL, 0, NI_NUMERICHOST); - if (!csp->ip_addr_str || retval) - { - log_error(LOG_LEVEL_ERROR, "Can not save csp->ip_addr_str: %s", - (csp->ip_addr_str) ? gai_strerror(retval) : "Insuffcient memory"); - freez(csp->ip_addr_str); - } -#undef client -#else csp->ip_addr_str = strdup(inet_ntoa(client.sin_addr)); csp->ip_addr_long = ntohl(client.sin_addr.s_addr); -#endif /* def HAVE_RFC2553 */
return 1;
@@ -1233,13 +937,14 @@ int accept_connection(struct client_state * csp, jb_socket fds[]) * Parameters : * 1 : host = hostname to resolve * - * Returns : INADDR_NONE => failure, INADDR_ANY or tcp/ip address if successful. + * Returns : INADDR_NONE => failure, INADDR_ANY or tcp/ip address if succesful. * *********************************************************************/ unsigned long resolve_hostname_to_ip(const char *host) { struct sockaddr_in inaddr; struct hostent *hostp; + unsigned int dns_retries = 0; #if defined(HAVE_GETHOSTBYNAME_R_6_ARGS) || defined(HAVE_GETHOSTBYNAME_R_5_ARGS) || defined(HAVE_GETHOSTBYNAME_R_3_ARGS) struct hostent result; #if defined(HAVE_GETHOSTBYNAME_R_6_ARGS) || defined(HAVE_GETHOSTBYNAME_R_5_ARGS) @@ -1259,12 +964,11 @@ unsigned long resolve_hostname_to_ip(const char *host)
if ((inaddr.sin_addr.s_addr = inet_addr(host)) == -1) { - unsigned int dns_retries = 0; #if defined(HAVE_GETHOSTBYNAME_R_6_ARGS) while (gethostbyname_r(host, &result, hbuf, HOSTENT_BUFFER_SIZE, &hostp, &thd_err) && (thd_err == TRY_AGAIN) && (dns_retries++ < MAX_DNS_RETRIES)) - { + { log_error(LOG_LEVEL_ERROR, "Timeout #%u while trying to resolve %s. Trying again.", dns_retries, host); @@ -1273,7 +977,7 @@ unsigned long resolve_hostname_to_ip(const char *host) while (NULL == (hostp = gethostbyname_r(host, &result, hbuf, HOSTENT_BUFFER_SIZE, &thd_err)) && (thd_err == TRY_AGAIN) && (dns_retries++ < MAX_DNS_RETRIES)) - { + { log_error(LOG_LEVEL_ERROR, "Timeout #%u while trying to resolve %s. Trying again.", dns_retries, host); @@ -1291,11 +995,11 @@ unsigned long resolve_hostname_to_ip(const char *host) { hostp = NULL; } -#elif defined(MUTEX_LOCKS_AVAILABLE) +#elif FEATURE_PTHREAD privoxy_mutex_lock(&resolver_mutex); while (NULL == (hostp = gethostbyname(host)) && (h_errno == TRY_AGAIN) && (dns_retries++ < MAX_DNS_RETRIES)) - { + { log_error(LOG_LEVEL_ERROR, "Timeout #%u while trying to resolve %s. Trying again.", dns_retries, host); @@ -1328,7 +1032,7 @@ unsigned long resolve_hostname_to_ip(const char *host) errno = WSAEPROTOTYPE; #else errno = EPROTOTYPE; -#endif +#endif log_error(LOG_LEVEL_ERROR, "hostname %s resolves to unknown address type.", host); return(INADDR_NONE); } @@ -1343,63 +1047,6 @@ unsigned long resolve_hostname_to_ip(const char *host) }
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE -/********************************************************************* - * - * Function : socket_is_still_alive - * - * Description : Figures out whether or not a socket is still alive. - * - * Parameters : - * 1 : sfd = The socket to check. - * - * Returns : TRUE for yes, otherwise FALSE. - * - *********************************************************************/ -int socket_is_still_alive(jb_socket sfd) -{ - char buf[10]; - int no_data_waiting; - -#ifdef HAVE_POLL - int poll_result; - struct pollfd poll_fd[1]; - - memset(poll_fd, 0, sizeof(poll_fd)); - poll_fd[0].fd = sfd; - poll_fd[0].events = POLLIN; - - poll_result = poll(poll_fd, 1, 0); - - if (-1 == poll_result) - { - log_error(LOG_LEVEL_CONNECT, "Polling socket %d failed.", sfd); - return FALSE; - } - no_data_waiting = !(poll_fd[0].revents & POLLIN); -#else - fd_set readable_fds; - struct timeval timeout; - int ret; - - memset(&timeout, '\0', sizeof(timeout)); - FD_ZERO(&readable_fds); - FD_SET(sfd, &readable_fds); - - ret = select((int)sfd+1, &readable_fds, NULL, NULL, &timeout); - if (ret < 0) - { - log_error(LOG_LEVEL_CONNECT, "select() on socket %d failed: %E", sfd); - return FALSE; - } - no_data_waiting = !FD_ISSET(sfd, &readable_fds); -#endif /* def HAVE_POLL */ - - return (no_data_waiting || (1 == recv(sfd, buf, 1, MSG_PEEK))); -} -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - - /* Local Variables: tab-width: 3 diff --git a/external/privoxy/jbsockets.h b/external/privoxy/jbsockets.h index 727bd69..115cb6a 100644 --- a/external/privoxy/jbsockets.h +++ b/external/privoxy/jbsockets.h @@ -1,6 +1,6 @@ #ifndef JBSOCKETS_H_INCLUDED #define JBSOCKETS_H_INCLUDED -#define JBSOCKETS_H_VERSION "$Id: jbsockets.h,v 1.20 2011/09/04 11:10:56 fabiankeil Exp $" +#define JBSOCKETS_H_VERSION "$Id: jbsockets.h,v 1.14 2008/12/20 14:53:55 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/jbsockets.h,v $ @@ -10,14 +10,14 @@ * OS-independent. Contains #ifdefs to make this work * on many platforms. * - * Copyright : Written by and Copyright (C) 2001-2009 the + * Copyright : Written by and Copyright (C) 2001 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -35,8 +35,78 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: jbsockets.h,v $ + * Revision 1.14 2008/12/20 14:53:55 fabiankeil + * Add config option socket-timeout to control the time + * Privoxy waits for data to arrive on a socket. Useful + * in case of stale ssh tunnels or when fuzz-testing. + * + * Revision 1.13 2008/03/21 11:13:59 fabiankeil + * Only gather host information if it's actually needed. + * Also move the code out of accept_connection() so it's less likely + * to delay other incoming connections if the host is misconfigured. + * + * Revision 1.12 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.9.2.1 2002/05/26 23:41:27 joergs + * AmigaOS: Fixed wrong type of len in write_socket() + * + * Revision 1.9 2002/04/08 20:31:41 swa + * fixed JB spelling + * + * Revision 1.8 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.7 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.6 2002/03/13 00:27:05 jongfoster + * Killing warnings + * + * Revision 1.5 2002/03/09 20:03:52 jongfoster + * - Making various functions return int rather than size_t. + * (Undoing a recent change). Since size_t is unsigned on + * Windows, functions like read_socket that return -1 on + * error cannot return a size_t. + * + * THIS WAS A MAJOR BUG - it caused frequent, unpredictable + * crashes, and also frequently caused JB to jump to 100% + * CPU and stay there. (Because it thought it had just + * read ((unsigned)-1) == 4Gb of data...) + * + * - The signature of write_socket has changed, it now simply + * returns success=0/failure=nonzero. + * + * - Trying to get rid of a few warnings --with-debug on + * Windows, I've introduced a new type "jb_socket". This is + * used for the socket file descriptors. On Windows, this + * is SOCKET (a typedef for unsigned). Everywhere else, it's + * an int. The error value can't be -1 any more, so it's + * now JB_INVALID_SOCKET (which is -1 on UNIX, and in + * Windows it maps to the #define INVALID_SOCKET.) + * + * - The signature of bind_port has changed. + * + * Revision 1.4 2002/03/07 03:51:36 oes + * - Improved handling of failed DNS lookups + * - Fixed compiler warnings etc + * + * Revision 1.3 2001/07/29 19:01:11 jongfoster + * Changed _FILENAME_H to FILENAME_H_INCLUDED. + * Added forward declarations for needed structures. + * + * Revision 1.2 2001/06/07 23:06:09 jongfoster + * The host parameter to connect_to() is now const. + * + * Revision 1.1.1.1 2001/05/15 13:58:54 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "project.h"
@@ -57,26 +127,15 @@ extern int data_is_available(jb_socket fd, int seconds_to_wait); extern void close_socket(jb_socket fd);
extern int bind_port(const char *hostnam, int portnum, jb_socket *pfd); -extern int accept_connection(struct client_state * csp, jb_socket fds[]); -extern void get_host_information(jb_socket afd, char **ip_address, char **port, char **hostname); +extern int accept_connection(struct client_state * csp, jb_socket fd); +extern void get_host_information(jb_socket afd, char **ip_address, char **hostname);
extern unsigned long resolve_hostname_to_ip(const char *host);
-extern int socket_is_still_alive(jb_socket sfd); - /* Revision control strings from this header and associated .c file */ extern const char jbsockets_rcs[]; extern const char jbsockets_h_rcs[];
-/* - * Solaris workaround - * XXX: still necessary? - */ -#ifndef INADDR_NONE -#define INADDR_NONE -1 -#endif - - #ifdef __cplusplus } /* extern "C" */ #endif diff --git a/external/privoxy/jcc.c b/external/privoxy/jcc.c index 721d187..1007128 100644 --- a/external/privoxy/jcc.c +++ b/external/privoxy/jcc.c @@ -1,4 +1,4 @@ -const char jcc_rcs[] = "$Id: jcc.c,v 1.375 2011/12/10 17:26:11 fabiankeil Exp $"; +const char jcc_rcs[] = "$Id: jcc.c,v 1.235 2009/03/18 21:01:20 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/jcc.c,v $ @@ -6,7 +6,7 @@ const char jcc_rcs[] = "$Id: jcc.c,v 1.375 2011/12/10 17:26:11 fabiankeil Exp $" * Purpose : Main file. Contains main() method, main loop, and * the main connection-handling function. * - * Copyright : Written by and Copyright (C) 2001-2010 the + * Copyright : Written by and Copyright (C) 2001-2009 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written @@ -31,8 +31,1205 @@ const char jcc_rcs[] = "$Id: jcc.c,v 1.375 2011/12/10 17:26:11 fabiankeil Exp $" * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: jcc.c,v $ + * Revision 1.235 2009/03/18 21:01:20 fabiankeil + * Comment fix. Spotted by Roland. + * + * Revision 1.234 2009/03/18 20:48:42 fabiankeil + * If the --no-daemon option is used, enable LOG_LEVEL_INFO + * before the config file has been parsed (as we always did). + * + * Revision 1.233 2009/03/13 14:10:07 fabiankeil + * Fix some more harmless warnings on amd64. + * + * Revision 1.232 2009/03/08 19:29:16 fabiankeil + * Reinitialize the timeout structure every time before passing + * it to select(). Apparently some implementations mess with it. + * Probably fixes #2669131 reported by cyberpatrol. + * + * Revision 1.231 2009/03/08 14:19:23 fabiankeil + * Fix justified (but harmless) compiler warnings + * on platforms where sizeof(int) < sizeof(long). + * + * Revision 1.230 2009/03/07 13:09:17 fabiankeil + * Change csp->expected_content and_csp->expected_content_length from + * size_t to unsigned long long to reduce the likelihood of integer + * overflows that would let us close the connection prematurely. + * Bug found while investigating #2669131, reported by cyberpatrol. + * + * Revision 1.229 2009/03/07 11:17:01 fabiankeil + * Fix compiler warning. + * + * Revision 1.228 2009/03/06 20:30:13 fabiankeil + * Log unsigned values as such. + * + * Revision 1.227 2009/03/02 19:18:11 fabiankeil + * Streamline parse_http_request()'s prototype. As + * cparser pointed out it doesn't actually use csp. + * + * Revision 1.226 2009/03/01 18:28:24 fabiankeil + * Help clang understand that we aren't dereferencing + * NULL pointers here. + * + * Revision 1.225 2009/02/19 18:09:32 fabiankeil + * Unbreak build without FEATURE_CONNECTION_KEEP_ALIVE. + * Noticed by David. + * + * Revision 1.224 2009/02/14 15:32:04 fabiankeil + * Add the request URL to the timeout message in chat(). + * Suggested by Lee. + * + * Revision 1.223 2009/02/09 21:21:16 fabiankeil + * Now that init_log_module() is called earlier, call show_version() + * later on from main() directly so it doesn't get called for --help + * or --version. + * + * Revision 1.222 2009/02/08 12:56:51 fabiankeil + * Call initialize_mutexes() before init_log_module() again. + * Broken since r220, might be the cause of Lee's #2579448. + * + * Revision 1.221 2009/02/06 18:02:58 fabiankeil + * When dropping privileges, also give up membership in supplementary + * groups. Thanks to Matthias Drochner for reporting the problem, + * providing the initial patch and testing the final version. + * + * Revision 1.220 2009/02/04 18:29:07 fabiankeil + * Initialize the log module before parsing arguments. + * Thanks to Matthias Drochner for the report. + * + * Revision 1.219 2009/01/31 16:08:21 fabiankeil + * Remove redundant error check in receive_client_request(). + * + * Revision 1.218 2009/01/31 12:25:54 fabiankeil + * Flatten indentation in receive_client_request(). + * + * Revision 1.217 2009/01/07 19:50:09 fabiankeil + * - If the socket-timeout has been reached and the client + * hasn't received any data yet, send an explanation before + * closing the connection. + * - In get_request_line(), signal timeouts the right way. + * + * Revision 1.216 2008/12/24 22:13:11 ler762 + * fix GCC 3.4.4 warning + * + * Revision 1.215 2008/12/24 17:06:19 fabiankeil + * Keep a thread around to timeout alive connections + * even if no new requests are coming in. + * + * Revision 1.214 2008/12/20 14:53:55 fabiankeil + * Add config option socket-timeout to control the time + * Privoxy waits for data to arrive on a socket. Useful + * in case of stale ssh tunnels or when fuzz-testing. + * + * Revision 1.213 2008/12/15 18:45:51 fabiankeil + * When logging crunches, log the whole URL, so one can easily + * differentiate between vanilla HTTP and CONNECT requests. + * + * Revision 1.212 2008/12/14 15:46:22 fabiankeil + * Give crunched requests their own log level. + * + * Revision 1.211 2008/12/06 10:05:03 fabiankeil + * Downgrade "Received x bytes while expecting y." message to + * LOG_LEVEL_CONNECT as it doesn't necessarily indicate an error. + * + * Revision 1.210 2008/12/02 22:03:18 fabiankeil + * Don't miscalculate byte_count if we don't get all the + * server headers with one read_socket() call. With keep-alive + * support enabled, this caused delays until the server closed + * the connection. + * + * Revision 1.209 2008/11/27 09:44:04 fabiankeil + * Cosmetics for the last commit: Don't watch out for + * the last chunk if the content isn't chunk-encoded or + * if we already determined the content length previously. + * + * Revision 1.208 2008/11/26 18:24:17 fabiankeil + * Recognize that the server response is complete if the + * last chunk is read together with the server headers. + * Reported by Lee. + * + * Revision 1.207 2008/11/25 17:25:16 fabiankeil + * Don't convert the client-header list to text until we need to. + * + * Revision 1.206 2008/11/23 17:00:11 fabiankeil + * Some more chat() cosmetics. + * + * Revision 1.205 2008/11/16 12:43:49 fabiankeil + * Turn keep-alive support into a runtime feature + * that is disabled by setting keep-alive-timeout + * to a negative value. + * + * Revision 1.204 2008/11/06 19:42:17 fabiankeil + * Fix last-chunk detection hack to also apply + * if buf[] contains nothing but the last-chunk. + * + * Revision 1.203 2008/11/06 18:34:35 fabiankeil + * Factor receive_client_request() and + * parse_client_request() out of chat(). + * + * Revision 1.202 2008/11/02 18:40:34 fabiankeil + * If we received a different amount of data than we expected, + * log a warning and make sure the server socket isn't reused. + * + * Revision 1.201 2008/11/02 16:48:20 fabiankeil + * Revert revision 1.195 and try again. + * + * Revision 1.200 2008/10/26 16:53:18 fabiankeil + * Fix gcc44 warning. + * + * Revision 1.199 2008/10/26 15:36:10 fabiankeil + * Remove two debug messages with LOG_LEVEL_INFO. + * + * Revision 1.198 2008/10/22 15:19:55 fabiankeil + * Once More, With Feeling: if there is no logfile + * because the user didn't specify one, we shouldn't + * call init_error_log() after receiving SIGHUP either. + * + * Revision 1.197 2008/10/20 17:02:40 fabiankeil + * If SIGHUP is received while we aren't running in daemon + * mode, calling init_error_log() would be a mistake. + * + * Revision 1.196 2008/10/16 09:16:41 fabiankeil + * - Fix two gcc44 conversion warnings. + * - Don't bother logging the last five bytes + * of the 0-chunk. + * + * Revision 1.195 2008/10/13 16:04:37 fabiankeil + * Make sure we don't try to reuse tainted server sockets. + * + * Revision 1.194 2008/10/12 18:35:18 fabiankeil + * The last commit was a bit too ambitious, apparently the content + * length adjustment is only necessary if we aren't buffering. + * + * Revision 1.193 2008/10/12 15:57:35 fabiankeil + * Fix content length calculation if we read headers + * and the start of the body at once. Now that we have + * FEATURE_CONNECTION_KEEP_ALIVE, it actually matters. + * + * Revision 1.192 2008/10/11 18:19:14 fabiankeil + * Even more chat() cosmetics. + * + * Revision 1.191 2008/10/11 18:00:14 fabiankeil + * Reformat some comments in chat(). + * + * Revision 1.190 2008/10/11 14:58:00 fabiankeil + * In case of chunk-encoded content, stop reading if + * the buffer looks like it ends with the last chunk. + * + * Revision 1.189 2008/10/11 09:53:00 fabiankeil + * Let server_response_is_complete() deal properly with + * content that is neither buffered nor read all at once. + * + * Revision 1.188 2008/10/09 18:21:41 fabiankeil + * Flush work-in-progress changes to keep outgoing connections + * alive where possible. Incomplete and mostly #ifdef'd out. + * + * Revision 1.187 2008/09/07 12:35:05 fabiankeil + * Add mutex lock support for _WIN32. + * + * Revision 1.186 2008/09/04 08:13:58 fabiankeil + * Prepare for critical sections on Windows by adding a + * layer of indirection before the pthread mutex functions. + * + * Revision 1.185 2008/08/30 12:03:07 fabiankeil + * Remove FEATURE_COOKIE_JAR. + * + * Revision 1.184 2008/08/22 15:34:45 fabiankeil + * - Silence LLVM/Clang complaint. + * - Make received_hup_signal static. + * - Hide definitions for basedir, pidfile and received_hup_signal + * from __EMX__ as they only seem to be used in case of #ifdef unix. + * + * Revision 1.183 2008/08/21 07:09:35 fabiankeil + * Accept Shoutcast responses again. Problem reported + * and fix suggested by Stefan in #2062860. + * + * Revision 1.182 2008/06/27 11:13:56 fabiankeil + * Fix possible NULL-pointer dereference reported + * by din_a4 in #2003937. Pointy hat to me. + * + * Revision 1.181 2008/05/21 15:47:15 fabiankeil + * Streamline sed()'s prototype and declare + * the header parse and add structures static. + * + * Revision 1.180 2008/05/21 15:26:32 fabiankeil + * - Mark csp as immutable for send_crunch_response(). + * - Fix comment spelling. + * + * Revision 1.179 2008/05/20 20:13:32 fabiankeil + * Factor update_server_headers() out of sed(), ditch the + * first_run hack and make server_patterns_light static. + * + * Revision 1.178 2008/05/10 13:23:38 fabiankeil + * Don't provide get_header() with the whole client state + * structure when it only needs access to csp->iob. + * + * Revision 1.177 2008/05/10 11:51:12 fabiankeil + * Make the "read the rest of the headers" loop a bit more readable. + * + * Revision 1.176 2008/05/10 11:37:57 fabiankeil + * - Instead of logging when the IIS5 hack is enabled, log when it fails. + * - Remove useless comment. + * + * Revision 1.175 2008/05/09 18:53:59 fabiankeil + * Fix comment grammar. + * + * Revision 1.174 2008/05/07 18:05:53 fabiankeil + * Remove the pointless buffer in client_protocol_is_unsupported(). + * + * Revision 1.173 2008/05/06 15:09:00 fabiankeil + * Least-effort fix for bug #1821930 (reported by Lee): + * If the response doesn't look like HTTP, + * tell the client and log the problem. + * + * Revision 1.172 2008/04/16 16:38:21 fabiankeil + * Don't pass the whole csp structure to flush_socket() + * when it only needs a file descriptor and a buffer. + * + * Revision 1.171 2008/03/27 18:27:25 fabiankeil + * Remove kill-popups action. + * + * Revision 1.170 2008/03/06 16:33:46 fabiankeil + * If limit-connect isn't used, don't limit CONNECT requests to port 443. + * + * Revision 1.169 2008/03/04 18:30:39 fabiankeil + * Remove the treat-forbidden-connects-like-blocks action. We now + * use the "blocked" page for forbidden CONNECT requests by default. + * + * Revision 1.168 2008/03/02 12:25:25 fabiankeil + * Also use shiny new connect_port_is_forbidden() in jcc.c. + * + * Revision 1.167 2008/02/23 16:57:12 fabiankeil + * Rename url_actions() to get_url_actions() and let it + * use the standard parameter ordering. + * + * Revision 1.166 2008/02/23 16:33:43 fabiankeil + * Let forward_url() use the standard parameter ordering + * and mark its second parameter immutable. + * + * Revision 1.165 2008/02/02 19:36:56 fabiankeil + * Remove the "Listening ... for local connections only" log message. + * Whether or not remote connections are able to reach Privoxy is up + * to the operating system. + * + * Revision 1.164 2007/12/16 18:32:46 fabiankeil + * Prevent the log messages for CONNECT requests to unacceptable + * ports from printing the limit-connect argument as [null] if + * limit-connect hasn't been explicitly enabled. + * + * Revision 1.163 2007/12/13 01:47:11 david__schmidt + * Make sure all console-mode apps get a usage() instance + * + * Revision 1.162 2007/12/06 17:54:57 fabiankeil + * Reword NO_SERVER_DATA_RESPONSE to make it harder + * to misunderstand what the message is all about. + * + * Revision 1.161 2007/12/04 19:44:22 fabiankeil + * Unbreak trustfile which previously didn't work without + * FEATURE_TOGGLE. Fixes BR#1843585, reported by Lee. + * + * Revision 1.160 2007/11/29 18:00:29 fabiankeil + * Plug memory leak. Spotted by Valgrind, triggered by + * Privoxy-Regression-Test feeding proxyfuzz.py. + * + * Revision 1.159 2007/11/24 14:34:09 fabiankeil + * In the HTTP snipplets, refer to the client as client. + * + * Revision 1.158 2007/11/11 16:44:17 fabiankeil + * Emit a log message when activating the MS IIS5 hack. + * + * Revision 1.157 2007/11/03 17:34:49 fabiankeil + * Log the "weak randomization factor" warning only + * once for mingw32 and provide some more details. + * + * Revision 1.156 2007/11/01 18:20:58 fabiankeil + * Initialize log module after initializing mutexes, future + * deadlocks in that code should now work cross-platform. + * + * Revision 1.155 2007/10/23 20:12:45 fabiankeil + * Fix first CSUCCEED line to end in \r\n as required by RFC1945. + * Reported by Bert van Leeuwen in BR#1818808. + * + * Revision 1.154 2007/10/19 17:00:08 fabiankeil + * Downgrade "Flushing header and buffers" message to LOG_LEVEL_INFO. + * + * Revision 1.153 2007/10/14 14:12:41 fabiankeil + * When in daemon mode, close stderr after the configuration file has been + * parsed the first time. If logfile isn't set, stop logging. Fixes BR#897436. + * + * Revision 1.152 2007/10/04 18:03:34 fabiankeil + * - Fix a crash when parsing invalid requests whose first header + * is rejected by get_header(). Regression (re?)introduced + * in r1.143 by yours truly. + * - Move ACTION_VANILLA_WAFER handling into parsers.c's + * client_cookie_adder() to make sure send-vanilla-wafer can be + * controlled through tags (and thus regression-tested). + * + * Revision 1.151 2007/09/29 10:21:16 fabiankeil + * - Move get_filter_function() from jcc.c to filters.c + * so the filter functions can be static. + * - Don't bother filtering body-less responses. + * + * Revision 1.150 2007/09/28 16:39:29 fabiankeil + * Execute content filters through execute_content_filter(). + * + * Revision 1.149 2007/09/04 15:08:48 fabiankeil + * Initialize req to NULL to make sure it's defined if the + * first read_socket() call fails. Reported by icmp30. + * + * Revision 1.148 2007/08/26 16:47:13 fabiankeil + * Add Stephen Gildea's --pre-chroot-nslookup patch [#1276666], + * extensive comments moved to user manual. + * + * Revision 1.147 2007/08/25 14:42:40 fabiankeil + * Don't crash if a broken header filter wiped out the request line. + * + * Revision 1.146 2007/08/20 17:09:32 fabiankeil + * Fix byte_count calculation in case of flushes + * and don't parse the server headers a second time. + * + * Revision 1.145 2007/08/19 13:13:31 fabiankeil + * - If there's a connection problem after we already forwarded + * parts of the original content, just hang up. Fixes BR#1776724. + * - Fix warnings about unused code on mingw32. + * - In case of flushes, calculate the byte count + * less incorrectly (I think). + * + * Revision 1.144 2007/08/11 14:43:22 fabiankeil + * Add some more prototypes for static functions. + * + * Revision 1.143 2007/08/05 13:58:19 fabiankeil + * Comment out request_contains_null_bytes() until it's used again. + * + * Revision 1.142 2007/08/05 13:50:26 fabiankeil + * #1763173 from Stefan Huehner: s@const static@static const@ + * and declare some more functions static. + * + * Revision 1.141 2007/08/04 09:56:23 fabiankeil + * - Log rejected CONNECT requests with LOG_LEVEL_INFO + * and explain why they were rejected in the first place. + * - Fix the LOG_LEVEL_CLF message for crunches of unallowed + * CONNECT requests. The request line was missing. + * - Add two more XXX reminders as we don't have enough already. + * + * Revision 1.140 2007/07/21 11:51:36 fabiankeil + * As Hal noticed, checking dispatch_cgi() as the last cruncher + * looks like a bug if CGI requests are blocked unintentionally, + * so don't do it unless the user enabled the new config option + * "allow-cgi-request-crunching". + * + * Revision 1.139 2007/07/14 07:46:41 fabiankeil + * - Allow to rewrite the request destination behind the client's back. + * - Turn the weird-looking unconditional for loop that + * reads the client request into a conditional while loop. + * Move the stuff that only runs once out of the loop. + * - Move parts of chat(), server_content_type() and the + * necessary stuff to fix BR#1750917 into get_filter_function(). + * + * Revision 1.138 2007/06/03 18:45:18 fabiankeil + * Temporary workaround for BR#1730105. + * + * Revision 1.137 2007/06/01 18:16:36 fabiankeil + * Use the same mutex for gethostbyname() and gethostbyaddr() to prevent + * deadlocks and crashes on OpenBSD and possibly other OS with neither + * gethostbyname_r() nor gethostaddr_r(). Closes BR#1729174. + * Thanks to Ralf Horstmann for report and solution. + * + * Revision 1.136 2007/06/01 16:41:11 fabiankeil + * Add forward-override{} to change the forwarding settings through + * action sections. This is mainly interesting to forward different + * clients differently (for example based on User-Agent or request + * origin). + * + * Revision 1.135 2007/05/24 17:03:50 fabiankeil + * - Let usage() mention the --chroot parameter. + * - Use read_socket() consistently and always leave + * the last buffer byte alone, even in cases where + * null termination (currently) doesn't matter. + * + * Revision 1.134 2007/05/16 14:59:46 fabiankeil + * - Fix config file loading on Unix if no config file is specified. + * Since r1.97 Privoxy would always interpret the last argument as + * config file, even if it's a valid command line option. + * - Abort in case of unrecognized command line options. Closes #1719696. + * - Remove a bunch of unnecessary strcpy() calls (yay for c&p without thinking). + * - Replace the remaining strcpy() and strcat() calls with strlcpy() and strcat(). + * + * Revision 1.133 2007/05/04 11:23:19 fabiankeil + * - Don't rerun crunchers that only depend on the request URL. + * - Don't count redirects and CGI requests as "blocked requests". + * + * Revision 1.132 2007/04/25 15:15:17 fabiankeil + * Support crunching based on tags created by server-header taggers. + * + * Revision 1.131 2007/04/22 13:24:50 fabiankeil + * Make HTTP snippets static (again). Add a Content-Type for those + * with content so the browser doesn't guess it based on the URL. + * + * Revision 1.130 2007/04/19 13:47:34 fabiankeil + * Move crunching and request line rebuilding out of chat(). + * + * Revision 1.129 2007/04/15 16:39:20 fabiankeil + * Introduce tags as alternative way to specify which + * actions apply to a request. At the moment tags can be + * created based on client and server headers. + * + * Revision 1.128 2007/03/25 16:55:54 fabiankeil + * Don't CLF-log CONNECT requests twice. + * + * Revision 1.127 2007/03/20 13:53:17 fabiankeil + * Log the source address for ACL-related connection drops. + * + * Revision 1.126 2007/03/17 15:20:05 fabiankeil + * New config option: enforce-blocks. + * + * Revision 1.125 2007/03/09 14:12:00 fabiankeil + * - Move null byte check into separate function. + * - Don't confuse the client with error pages + * if a CONNECT request was already confirmed. + * + * Revision 1.124 2007/02/23 14:59:54 fabiankeil + * Speed up NULL byte escaping and only log the complete + * NULL byte requests with header debugging enabled. + * + * Revision 1.123 2007/02/21 18:42:10 fabiankeil + * Answer requests that contain NULL bytes with + * a custom response instead of waiting for more + * data until the client eventually hangs up. + * + * Revision 1.122 2007/02/07 11:12:02 fabiankeil + * - Move delivery and logging of crunched responses + * from chat() into send_crunch_response(). + * - Display the reason for generating http_responses. + * - Log the content length for LOG_LEVEL_CLF correctly + * (still incorrect for some fixed responses). + * - Reword an incorrect comment about + * treat-forbidden-connects-like-blocks violating + * the specs. + * - Add some log messages. + * + * Revision 1.121 2007/01/27 10:52:56 fabiankeil + * Move mutex initialization into separate + * function and exit in case of errors. + * + * Revision 1.120 2007/01/26 14:18:42 fabiankeil + * - Start to reduce chat()'s line count and move + * parts of it into separate functions. + * - Add "HTTP/1.1 100 Continue" hack for BR 756734. + * + * Revision 1.119 2007/01/25 14:02:30 fabiankeil + * - Add Proxy-Agent header to HTTP snippets that are + * supposed to reach HTTP clients only. + * - Made a few CONNECT log messages more descriptive. + * - Catch completely empty server responses (as seen + * with Tor's fake ".noconnect" top level domain). + * - Use shiny new "forwarding-failed" template for socks errors. + * + * Revision 1.118 2007/01/07 07:43:43 joergs + * AmigaOS4 support added. + * + * Revision 1.117 2006/12/31 17:56:37 fabiankeil + * Added config option accept-intercepted-requests + * and disabled it by default. + * + * Revision 1.116 2006/12/29 19:08:22 fabiankeil + * Reverted parts of my last commit + * to keep error handling working. + * + * Revision 1.115 2006/12/29 17:38:57 fabiankeil + * Fixed gcc43 conversion warnings. + * + * Revision 1.114 2006/12/27 18:52:02 fabiankeil + * Fix -pedantic ISO C warning about converting + * from function pointer to object pointer. + * + * Revision 1.113 2006/12/26 17:38:50 fabiankeil + * Silence compiler warning I introduced with my last commit. + * + * Revision 1.112 2006/12/26 17:31:41 fabiankeil + * Mutex protect rand() if POSIX threading + * is used, warn the user if that's not possible + * and stop using it on _WIN32 where it could + * cause crashes. + * + * Revision 1.111 2006/12/23 16:15:06 fabiankeil + * Don't prevent core dumps by catching SIGABRT. + * It's rude and makes debugging unreasonable painful. + * + * Revision 1.110 2006/12/13 14:52:53 etresoft + * Fix build failure on MacOS X. Global symbols can be either static or extern, but not both. + * + * Revision 1.109 2006/12/06 19:41:40 fabiankeil + * Privoxy is now able to run as intercepting + * proxy in combination with any packet filter + * that does the port redirection. The destination + * is extracted from the "Host:" header which + * should be available for nearly all requests. + * + * Moved HTTP snipplets into jcc.c. + * Added error message for gopher proxy requests. + * + * Revision 1.108 2006/11/28 15:38:51 fabiankeil + * Only unlink the pidfile if it's actually used. + * + * Change order of interception checks to make + * it possible to block or redirect requests for + * the cgi pages. + * + * Revision 1.107 2006/11/13 19:05:51 fabiankeil + * Make pthread mutex locking more generic. Instead of + * checking for OSX and OpenBSD, check for FEATURE_PTHREAD + * and use mutex locking unless there is an _r function + * available. Better safe than sorry. + * + * Fixes "./configure --disable-pthread" and should result + * in less threading-related problems on pthread-using platforms, + * but it still doesn't fix BR#1122404. + * + * Revision 1.106 2006/11/06 19:58:23 fabiankeil + * Move pthread.h inclusion from jcc.c to jcc.h. + * Fixes build on x86-freebsd1 (FreeBSD 5.4-RELEASE). + * + * Revision 1.105 2006/11/06 14:26:02 fabiankeil + * Don't exit after receiving the second SIGHUP on Solaris. + * + * Fixes BR 1052235, but the same problem may exist on other + * systems. Once 3.0.6 is out we should use sigset() + * where available and see if it breaks anything. + * + * Revision 1.104 2006/09/23 13:26:38 roro + * Replace TABs by spaces in source code. + * + * Revision 1.103 2006/09/21 12:54:43 fabiankeil + * Fix +redirect{}. Didn't work with -fast-redirects. + * + * Revision 1.102 2006/09/06 13:03:04 fabiankeil + * Respond with 400 and a short text message + * if the client tries to use Privoxy as FTP proxy. + * + * Revision 1.101 2006/09/06 09:23:37 fabiankeil + * Make number of retries in case of forwarded-connect problems + * a config file option (forwarded-connect-retries) and use 0 as + * default. + * + * Revision 1.100 2006/09/03 19:42:59 fabiankeil + * Set random(3) seed. + * + * Revision 1.99 2006/09/02 15:36:42 fabiankeil + * Follow the OpenBSD port's lead and protect the resolve + * functions on OpenBSD as well. + * + * Revision 1.98 2006/08/24 11:01:34 fabiankeil + * --user fix. Only use the user as group if no group is specified. + * Solves BR 1492612. Thanks to Spinor S. and David Laight. + * + * Revision 1.97 2006/08/18 15:23:17 david__schmidt + * Windows service (re-)integration + * + * The new args are: + * + * --install[:service_name] + * --uninstall[:service_name] + * --service + * + * They work as follows: + * --install will create a service for you and then terminate. + * By default the service name will be "privoxy" (without the quotes). + * However you can run multiple services if you wish, just by adding + * a colon and then a name (no spaces). + * + * --uninstall follows the exact same rules a --install. + * + * --service is used when the program is executed by the service + * control manager, and in normal circumstances would never be + * used as a command line argument. + * + * Revision 1.96 2006/08/15 20:12:36 david__schmidt + * Windows service integration + * + * Revision 1.95 2006/08/03 02:46:41 david__schmidt + * Incorporate Fabian Keil's patch work: +http://www.fabiankeil.de/sourcecode/privoxy/ + * + * Revision 1.94 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.92.2.16 2005/04/03 20:10:50 david__schmidt + * Thanks to Jindrich Makovicka for a race condition fix for the log + * file. The race condition remains for non-pthread implementations. + * Reference patch #1175720. + * + * Revision 1.92.2.15 2004/10/03 12:53:32 david__schmidt + * Add the ability to check jpeg images for invalid + * lengths of comment blocks. Defensive strategy + * against the exploit: + * Microsoft Security Bulletin MS04-028 + * Buffer Overrun in JPEG Processing (GDI+) Could + * Allow Code Execution (833987) + * Enabled with +inspect-jpegs in actions files. + * + * Revision 1.92.2.14 2003/12/12 12:52:53 oes + * - Fixed usage info for non-unix platforms + * - Fixed small cmdline parsing bug + * + * Revision 1.92.2.13 2003/11/27 19:20:27 oes + * Diagnostics: Now preserve the returncode of pthread_create + * in errno. Closes BR #775721. Thanks to Geoffrey Hausheer. + * + * Revision 1.92.2.12 2003/07/11 11:34:19 oes + * No longer ignore SIGCHLD. Fixes bug #769381 + * + * Revision 1.92.2.11 2003/05/14 12:32:02 oes + * Close jarfile on graceful exit, remove stray line + * + * Revision 1.92.2.10 2003/05/08 15:13:46 oes + * Cosmetics: Killed a warning, a typo and an allocation left at exit + * + * Revision 1.92.2.9 2003/04/03 15:08:42 oes + * No longer rely on non-POSIX.1 extensions of getcwd(). + * Fixes bug #711001 + * + * Revision 1.92.2.8 2003/03/31 13:12:32 oes + * Replaced setenv() by posix-compliant putenv() + * Thanks to Neil McCalden (nmcc AT users.sf.net). + * + * Revision 1.92.2.7 2003/03/17 16:48:59 oes + * Added chroot ability, thanks to patch by Sviatoslav Sviridov + * + * Revision 1.92.2.6 2003/03/11 11:55:00 oes + * Clean-up and extension of improvements for forked mode: + * - Child's return code now consists of flags RC_FLAG_* + * - Reporting toggle to parent now properly #ifdef'ed + * - Children now report blocking to parent. This enables + * statistics in forked mode + * + * Revision 1.92.2.5 2003/03/10 23:45:32 oes + * Fixed bug #700381: Non-Threaded version now capable of being toggled. + * Children now report having been toggled through _exit(17), parents + * watch for that code and toggle themselves if found. + * + * Revision 1.92.2.4 2003/03/07 03:41:04 david__schmidt + * Wrapping all *_r functions (the non-_r versions of them) with + * mutex semaphores for OSX. Hopefully this will take care of all + * of those pesky crash reports. + * + * Revision 1.92.2.3 2003/02/28 12:53:06 oes + * Fixed two mostly harmless mem leaks + * + * Revision 1.92.2.2 2002/11/20 14:37:47 oes + * Fix: Head of global clients list now initialized to NULL + * + * Revision 1.92.2.1 2002/09/25 14:52:24 oes + * Added basic support for OPTIONS and TRACE HTTP methods: + * - New interceptor direct_response() added in chat(). + * - sed() moved to earlier in the process, so that the + * Host: header is evaluated before actions and forwarding + * are decided on. + * + * Revision 1.92 2002/05/08 16:00:46 oes + * Chat's buffer handling: + * - Fixed bug with unchecked out-of-mem conditions + * while reading client request & server headers + * - No longer predict if the buffer limit will be exceeded + * in the next read -- check add_to_iob's new + * return code. If buffer couldn't be extended + * (policy or out-of-mem) while + * - reading from client: abort + * - reading server headers: send error page + * - buffering server body for filter: flush, + * and if that fails: send error page + * + * Revision 1.91 2002/04/08 20:35:58 swa + * fixed JB spelling + * + * Revision 1.90 2002/04/02 14:57:28 oes + * Made sending wafers independent of FEATURE_COOKIE_JAR + * + * Revision 1.89 2002/03/31 17:18:59 jongfoster + * Win32 only: Enabling STRICT to fix a VC++ compile warning. + * + * Revision 1.88 2002/03/27 14:32:43 david__schmidt + * More compiler warning message maintenance + * + * Revision 1.87 2002/03/26 22:29:54 swa + * we have a new homepage! + * + * Revision 1.86 2002/03/25 17:04:55 david__schmidt + * Workaround for closing the jarfile before load_config() comes around again + * + * Revision 1.85 2002/03/24 15:23:33 jongfoster + * Name changes + * + * Revision 1.84 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.83 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.82 2002/03/13 00:27:05 jongfoster + * Killing warnings + * + * Revision 1.81 2002/03/12 01:42:50 oes + * Introduced modular filters + * + * Revision 1.80 2002/03/11 22:07:05 david__schmidt + * OS/2 port maintenance: + * - Fixed EMX build - it had decayed a little + * - Fixed inexplicable crash during FD_ZERO - must be due to a bad macro. + * substituted a memset for now. + * + * Revision 1.79 2002/03/09 20:03:52 jongfoster + * - Making various functions return int rather than size_t. + * (Undoing a recent change). Since size_t is unsigned on + * Windows, functions like read_socket that return -1 on + * error cannot return a size_t. + * + * THIS WAS A MAJOR BUG - it caused frequent, unpredictable + * crashes, and also frequently caused JB to jump to 100% + * CPU and stay there. (Because it thought it had just + * read ((unsigned)-1) == 4Gb of data...) + * + * - The signature of write_socket has changed, it now simply + * returns success=0/failure=nonzero. + * + * - Trying to get rid of a few warnings --with-debug on + * Windows, I've introduced a new type "jb_socket". This is + * used for the socket file descriptors. On Windows, this + * is SOCKET (a typedef for unsigned). Everywhere else, it's + * an int. The error value can't be -1 any more, so it's + * now JB_INVALID_SOCKET (which is -1 on UNIX, and in + * Windows it maps to the #define INVALID_SOCKET.) + * + * - The signature of bind_port has changed. + * + * Revision 1.78 2002/03/08 21:35:04 oes + * Added optional group supplement to --user option. Will now use default group of user if no group given + * + * Revision 1.77 2002/03/07 03:52:06 oes + * - Fixed compiler warnings etc + * - Improved handling of failed DNS lookups + * + * Revision 1.76 2002/03/06 22:54:35 jongfoster + * Automated function-comment nitpicking. + * + * Revision 1.75 2002/03/06 10:02:19 oes + * Fixed stupid bug when --user was not given + * + * Revision 1.74 2002/03/06 00:49:31 jongfoster + * Fixing warning on Windows + * Making #ifdefs that refer to the same variable consistently + * use #ifdef unix rather than mixing #ifdef unix & #ifndef OS2 + * + * Revision 1.73 2002/03/05 23:57:30 hal9 + * Stray character 's' on line 1618 was breaking build. + * + * Revision 1.72 2002/03/05 21:33:45 david__schmidt + * - Re-enable OS/2 building after new parms were added + * - Fix false out of memory report when resolving CGI templates when no IP + * address is available of failed attempt (a la no such domain) + * + * Revision 1.71 2002/03/05 18:13:56 oes + * Added --user option + * + * Revision 1.70 2002/03/05 04:52:42 oes + * Deleted non-errlog debugging code + * + * Revision 1.69 2002/03/04 23:50:00 jongfoster + * Splitting off bind_port() call into bind_port_helper(), with + * improved logging. + * + * Revision 1.68 2002/03/04 20:17:32 oes + * Fixed usage info + * + * Revision 1.67 2002/03/04 18:18:57 oes + * - Removed _DEBUG mode + * - Cleand up cmdline parsing + * - Introduced --no-daemon, --pidfile options + * - Cleaned up signal handling: + * - Terminate cleanly on INT, TERM and ABRT + * - Schedule logfile for re-opening on HUP + * - Ignore CHLD and PIPE + * - Leave the rest with their default handlers + * - Uniform handler registration + * - Added usage() function + * - Played styleguide police + * + * Revision 1.66 2002/03/03 15:06:55 oes + * Re-enabled automatic config reloading + * + * Revision 1.65 2002/03/03 14:49:11 oes + * Fixed CLF logging: Now uses client's original HTTP request + * + * Revision 1.64 2002/03/03 09:18:03 joergs + * Made jumbjuster work on AmigaOS again. + * + * Revision 1.63 2002/03/02 04:14:50 david__schmidt + * Clean up a little CRLF unpleasantness that suddenly appeared + * + * Revision 1.62 2002/02/20 23:17:23 jongfoster + * Detecting some out-of memory conditions and exiting with a log message. + * + * Revision 1.61 2002/01/17 21:01:52 jongfoster + * Moving all our URL and URL pattern parsing code to urlmatch.c. + * + * Revision 1.60 2001/12/30 14:07:32 steudten + * - Add signal handling (unix) + * - Add SIGHUP handler (unix) + * - Add creation of pidfile (unix) + * - Add action 'top' in rc file (RH) + * - Add entry 'SIGNALS' to manpage + * - Add exit message to logfile (unix) + * + * Revision 1.59 2001/12/13 14:07:18 oes + * Fixed Bug: 503 error page now sent OK + * + * Revision 1.58 2001/11/30 23:37:24 jongfoster + * Renaming the Win32 config file to config.txt - this is almost the + * same as the corresponding UNIX name "config" + * + * Revision 1.57 2001/11/16 00:47:43 jongfoster + * Changing the tty-disconnection code to use setsid(). + * + * Revision 1.56 2001/11/13 20:20:54 jongfoster + * Tabs->spaces, fixing a bug with missing {} around an if() + * + * Revision 1.55 2001/11/13 20:14:53 jongfoster + * Patch for FreeBSD setpgrp() as suggested by Alexander Lazic + * + * Revision 1.54 2001/11/07 00:03:14 steudten + * Give reliable return value if an error + * occurs not just 0 with new daemon mode. + * + * Revision 1.53 2001/11/05 21:41:43 steudten + * Add changes to be a real daemon just for unix os. + * (change cwd to /, detach from controlling tty, set + * process group and session leader to the own process. + * Add DBG() Macro. + * Add some fatal-error log message for failed malloc(). + * Add '-d' if compiled with 'configure --with-debug' to + * enable debug output. + * + * Revision 1.52 2001/10/26 20:11:20 jongfoster + * Fixing type mismatch + * + * Revision 1.51 2001/10/26 17:38:28 oes + * Cosmetics + * + * Revision 1.50 2001/10/25 03:40:48 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.49 2001/10/23 21:41:35 jongfoster + * Added call to initialize the (statically-allocated of course) + * "out of memory" CGI response. + * + * Revision 1.48 2001/10/10 19:56:46 jongfoster + * Moving some code that wasn't cookie-related out of an #ifdef + * FEATURE_COOKIE_JAR + * + * Revision 1.47 2001/10/10 16:44:36 oes + * Added CONNECT destination port limitation check + * + * Revision 1.46 2001/10/08 15:17:41 oes + * Re-enabled SSL forwarding + * + * Revision 1.45 2001/10/07 15:42:11 oes + * Replaced 6 boolean members of csp with one bitmap (csp->flags) + * + * Moved downgrading of the HTTP version from parse_http_request to + * chat(), since we can't decide if it is necessary before we have + * determined the actions for the URL. The HTTP command is now + * *always* re-built so the repairs need no longer be special-cased. + * + * filter_popups now gets a csp pointer so it can raise the new + * CSP_FLAG_MODIFIED flag. + * + * Bugfix + * + * Added configurable size limit for the IOB. If the IOB grows so + * large that the next read would exceed the limit, the header + * is generated, and the header & unfiltered buffer are flushed + * to the client. Chat then continues in non-buffering, + * non-filtering body mode. + * + * Revision 1.44 2001/10/02 18:13:57 oes + * Ooops + * + * Revision 1.43 2001/10/02 15:32:13 oes + * Moved generation of hdr + * + * Revision 1.42 2001/09/21 23:02:02 david__schmidt + * Cleaning up 2 compiler warnings on OS/2. + * + * Revision 1.41 2001/09/16 17:05:14 jongfoster + * Removing unused #include showarg.h + * + * Revision 1.40 2001/09/16 15:41:45 jongfoster + * Fixing signed/unsigned comparison warning. + * + * Revision 1.39 2001/09/16 13:21:27 jongfoster + * Changes to use new list functions. + * + * Revision 1.38 2001/09/16 13:01:46 jongfoster + * Removing redundant function call that zeroed zalloc()'d memory. + * + * Revision 1.37 2001/09/10 11:12:24 oes + * Deleted unused variable + * + * Revision 1.36 2001/09/10 10:56:15 oes + * Silenced compiler warnings + * + * Revision 1.35 2001/07/31 14:44:22 oes + * Deleted unused size parameter from filter_popups() + * + * Revision 1.34 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.33 2001/07/29 19:32:00 jongfoster + * Renaming _main() [mingw32 only] to real_main(), for ANSI compliance. + * + * Revision 1.32 2001/07/29 18:47:05 jongfoster + * Adding missing #include "loadcfg.h" + * + * Revision 1.31 2001/07/29 12:17:48 oes + * Applied pthread fix by Paul Lieverse + * + * Revision 1.30 2001/07/25 22:57:13 jongfoster + * __BEOS__ no longer overrides FEATURE_PTHREAD. + * This is because FEATURE_PTHREAD will soon be widely used, so I + * want to keep it simple. + * + * Revision 1.29 2001/07/24 12:47:06 oes + * Applied BeOS support update by Eugenia + * + * Revision 1.28 2001/07/23 13:26:12 oes + * Fixed bug in popup-killing for the first read that caused binary garbage to be sent between headers and body + * + * Revision 1.27 2001/07/19 19:09:47 haroon + * - Added code to take care of the situation where while processing the first + * server response (which includes the server header), after finding the end + * of the headers we were not looking past the end of the headers for + * content modification. I enabled it for filter_popups. + * Someone else should look to see if other similar operations should be + * done to the discarded portion of the buffer. + * + * Note 2001/07/20: No, the other content modification mechanisms will process + * the whole iob later anyway. --oes + * + * Revision 1.26 2001/07/18 12:31:36 oes + * cosmetics + * + * Revision 1.25 2001/07/15 19:43:49 jongfoster + * Supports POSIX threads. + * Also removed some unused #includes. + * + * Revision 1.24 2001/07/13 14:00:40 oes + * - Generic content modification scheme: + * Each feature has its own applicability flag that is set + * from csp->action->flags. + * Replaced the "filtering" int flag , by a function pointer + * "content_filter" to the function that will do the content + * modification. If it is != NULL, the document will be buffered + * and processed through *content_filter, which must set + * csp->content_length and return a modified copy of the body + * or return NULL (on failiure). + * - Changed csp->is_text to the more generic bitmap csp->content_type + * which can currently take the valued CT_TEXT or CT_GIF + * - Reformatting etc + * - Removed all #ifdef PCRS + * + * Revision 1.23 2001/07/02 02:28:25 iwanttokeepanon + * Added "#ifdef ACL_FILES" conditional compilation to line 1291 to exclude + * the `block_acl' call. This prevents a compilation error when the user + * does not wish to use the "ACL" feature. + * + * Revision 1.22 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.21 2001/06/29 13:29:36 oes + * - Cleaned up, improved comments + * - Unified all possible interceptors (CGI, + * block, trust, fast_redirect) in one + * place, with one (CGI) answer generation + * mechansim. Much clearer now. + * - Removed the GIF image generation, which + * is now done in filters.c:block_url() + * - Made error conditions like domain lookup + * failiure or (various) problems while talking + * to the server use cgi.c:error_response() + * instead of generating HTML/HTTP in chat() (yuck!) + * - Removed logentry from cancelled commit + * + * Revision 1.20 2001/06/09 10:55:28 jongfoster + * Changing BUFSIZ ==> BUFFER_SIZE + * + * Revision 1.19 2001/06/07 23:12:52 jongfoster + * Replacing function pointer in struct gateway with a directly + * called function forwarded_connect(). + * Replacing struct gateway with struct forward_spec + * + * Revision 1.18 2001/06/03 19:12:16 oes + * introduced new cgi handling + * + * Revision 1.17 2001/06/01 20:07:23 jongfoster + * Now uses action +image-blocker{} rather than config->tinygif + * + * Revision 1.16 2001/06/01 18:49:17 jongfoster + * Replaced "list_share" with "list" - the tiny memory gain was not + * worth the extra complexity. + * + * Revision 1.15 2001/05/31 21:24:47 jongfoster + * Changed "permission" to "action" throughout. + * Removed DEFAULT_USER_AGENT - it must now be specified manually. + * Moved vanilla wafer check into chat(), since we must now + * decide whether or not to add it based on the URL. + * + * Revision 1.14 2001/05/29 20:14:01 joergs + * AmigaOS bugfix: PCRS needs a lot of stack, stacksize for child threads + * increased. + * + * Revision 1.13 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.12 2001/05/27 22:17:04 oes + * + * - re_process_buffer no longer writes the modified buffer + * to the client, which was very ugly. It now returns the + * buffer, which it is then written by chat. + * + * - content_length now adjusts the Content-Length: header + * for modified documents rather than crunch()ing it. + * (Length info in csp->content_length, which is 0 for + * unmodified documents) + * + * - For this to work, sed() is called twice when filtering. + * + * Revision 1.11 2001/05/26 17:27:53 jongfoster + * Added support for CLF and fixed LOG_LEVEL_LOG. + * Also did CRLF->LF fix of my previous patch. + * + * Revision 1.10 2001/05/26 15:26:15 jongfoster + * ACL feature now provides more security by immediately dropping + * connections from untrusted hosts. + * + * Revision 1.9 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.8 2001/05/25 22:43:18 jongfoster + * Fixing minor memory leak and buffer overflow. + * + * Revision 1.7 2001/05/25 22:34:30 jongfoster + * Hard tabs->Spaces + * + * Revision 1.6 2001/05/23 00:13:58 joergs + * AmigaOS support fixed. + * + * Revision 1.5 2001/05/22 18:46:04 oes + * + * - Enabled filtering banners by size rather than URL + * by adding patterns that replace all standard banner + * sizes with the "Junkbuster" gif to the re_filterfile + * + * - Enabled filtering WebBugs by providing a pattern + * which kills all 1x1 images + * + * - Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * - Added a new interceptor ijb-send-banner, which + * sends back the "Junkbuster" gif. Without imagelist or + * MSIE detection support, or if tinygif = 1, or the + * URL isn't recognized as an imageurl, a lame HTML + * explanation is sent instead. + * + * - Added new feature, which permits blocking remote + * script redirects and firing back a local redirect + * to the browser. + * The feature is conditionally compiled, i.e. it + * can be disabled with --disable-fast-redirects, + * plus it must be activated by a "fast-redirects" + * line in the config file, has its own log level + * and of course wants to be displayed by show-proxy-args + * Note: Boy, all the #ifdefs in 1001 locations and + * all the fumbling with configure.in and acconfig.h + * were *way* more work than the feature itself :-( + * + * - Because a generic redirect template was needed for + * this, tinygif = 3 now uses the same. + * + * - Moved GIFs, and other static HTTP response templates + * to project.h + * + * - Some minor fixes + * + * - Removed some >400 CRs again (Jon, you really worked + * a lot! ;-) + * + * Revision 1.4 2001/05/21 19:34:01 jongfoster + * Made failure to bind() a fatal error. + * + * Revision 1.3 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.2 2001/05/17 22:34:44 oes + * - Added hint on GIF char array generation to jcc.c + * - Cleaned CRLF's from the sources and related files + * - Repaired logging for REF and FRC + * + * Revision 1.1.1.1 2001/05/15 13:58:56 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -119,8 +1316,8 @@ const char jcc_rcs[] = "$Id: jcc.c,v 1.375 2011/12/10 17:26:11 fabiankeil Exp $" const char jcc_h_rcs[] = JCC_H_VERSION; const char project_h_rcs[] = PROJECT_H_VERSION;
-int daemon_mode = 1; -struct client_states clients[1]; +int no_daemon = 0; +struct client_state clients[1]; struct file_list files[1];
#ifdef FEATURE_STATISTICS @@ -151,9 +1348,7 @@ static void serve(struct client_state *csp); static void usage(const char *myname); #endif static void initialize_mutexes(void); -static jb_socket bind_port_helper(const char *haddr, int hport); -static void bind_ports_helper(struct configuration_spec *config, jb_socket sockets[]); -static void close_ports_helper(jb_socket sockets[]); +static jb_socket bind_port_helper(struct configuration_spec *config); static void listen_loop(void);
#ifdef AMIGA @@ -208,65 +1403,78 @@ static int received_hup_signal = 0;
/* HTTP snipplets. */ static const char CSUCCEED[] = - "HTTP/1.1 200 Connection established\r\n" + "HTTP/1.0 200 Connection established\r\n" "Proxy-Agent: Privoxy/" VERSION "\r\n\r\n";
static const char CHEADER[] = - "HTTP/1.1 400 Invalid header received from client\r\n" + "HTTP/1.0 400 Invalid header received from client\r\n" "Proxy-Agent: Privoxy " VERSION "\r\n" "Content-Type: text/plain\r\n" "Connection: close\r\n\r\n" "Invalid header received from client.\r\n";
static const char FTP_RESPONSE[] = - "HTTP/1.1 400 Invalid request received from client\r\n" + "HTTP/1.0 400 Invalid request received from client\r\n" "Content-Type: text/plain\r\n" "Connection: close\r\n\r\n" "Invalid request. Privoxy doesn't support FTP.\r\n";
static const char GOPHER_RESPONSE[] = - "HTTP/1.1 400 Invalid request received from client\r\n" + "HTTP/1.0 400 Invalid request received from client\r\n" "Content-Type: text/plain\r\n" "Connection: close\r\n\r\n" "Invalid request. Privoxy doesn't support gopher.\r\n";
/* XXX: should be a template */ static const char MISSING_DESTINATION_RESPONSE[] = - "HTTP/1.1 400 Bad request received from client\r\n" + "HTTP/1.0 400 Bad request received from client\r\n" "Proxy-Agent: Privoxy " VERSION "\r\n" "Content-Type: text/plain\r\n" "Connection: close\r\n\r\n" "Bad request. Privoxy was unable to extract the destination.\r\n";
/* XXX: should be a template */ +static const char NO_SERVER_DATA_RESPONSE[] = + "HTTP/1.0 502 Server or forwarder response empty\r\n" + "Proxy-Agent: Privoxy " VERSION "\r\n" + "Content-Type: text/plain\r\n" + "Connection: close\r\n\r\n" + "Empty server or forwarder response.\r\n" + "The connection has been closed but Privoxy didn't receive any data.\r\n"; + +/* XXX: should be a template */ static const char INVALID_SERVER_HEADERS_RESPONSE[] = - "HTTP/1.1 502 Server or forwarder response invalid\r\n" + "HTTP/1.0 502 Server or forwarder response invalid\r\n" "Proxy-Agent: Privoxy " VERSION "\r\n" "Content-Type: text/plain\r\n" "Connection: close\r\n\r\n" "Bad response. The server or forwarder response doesn't look like HTTP.\r\n";
+#if 0 /* XXX: should be a template */ -static const char MESSED_UP_REQUEST_RESPONSE[] = - "HTTP/1.1 400 Malformed request after rewriting\r\n" +static const char NULL_BYTE_RESPONSE[] = + "HTTP/1.0 400 Bad request received from client\r\n" "Proxy-Agent: Privoxy " VERSION "\r\n" "Content-Type: text/plain\r\n" "Connection: close\r\n\r\n" - "Bad request. Messed up with header filters.\r\n"; + "Bad request. Null byte(s) before end of request.\r\n"; +#endif
-static const char TOO_MANY_CONNECTIONS_RESPONSE[] = - "HTTP/1.1 503 Too many open connections\r\n" +/* XXX: should be a template */ +static const char MESSED_UP_REQUEST_RESPONSE[] = + "HTTP/1.0 400 Malformed request after rewriting\r\n" "Proxy-Agent: Privoxy " VERSION "\r\n" "Content-Type: text/plain\r\n" "Connection: close\r\n\r\n" - "Maximum number of open connections reached.\r\n"; + "Bad request. Messed up with header filters.\r\n";
-static const char CLIENT_CONNECTION_TIMEOUT_RESPONSE[] = - "HTTP/1.1 504 Connection timeout\r\n" +/* XXX: should be a template */ +static const char CONNECTION_TIMEOUT_RESPONSE[] = + "HTTP/1.0 502 Connection timeout\r\n" "Proxy-Agent: Privoxy " VERSION "\r\n" "Content-Type: text/plain\r\n" "Connection: close\r\n\r\n" - "The connection timed out because the client request didn't arrive in time.\r\n"; + "The connection timed out.\r\n";
/* A function to crunch a response */ typedef struct http_response *(*crunch_func_ptr)(struct client_state *); @@ -317,7 +1525,7 @@ static const struct cruncher crunchers_light[] = { #if !defined(_WIN32) && !defined(__OS2__) && !defined(AMIGA) /********************************************************************* * - * Function : sig_handler + * Function : sig_handler * * Description : Signal handler for different signals. * Exit gracefully on TERM and INT @@ -327,7 +1535,7 @@ static const struct cruncher crunchers_light[] = { * Parameters : * 1 : the_signal = the signal cause this function to call * - * Returns : - + * Returns : - * *********************************************************************/ static void sig_handler(int the_signal) @@ -350,10 +1558,10 @@ static void sig_handler(int the_signal) #if defined(unix) received_hup_signal = 1; #endif - break; + break;
default: - /* + /* * We shouldn't be here, unless we catch signals * in main() that we can't handle here! */ @@ -473,10 +1681,8 @@ static jb_err get_request_destination_elsewhere(struct client_state *csp, struct } else if (JB_ERR_OK == get_destination_from_headers(headers, csp->http)) { -#ifndef FEATURE_EXTENDED_HOST_PATTERNS /* Split the domain we just got for pattern matching */ init_domain_components(csp->http); -#endif
return JB_ERR_OK; } @@ -565,7 +1771,7 @@ static jb_err get_server_headers(struct client_state *csp) log_error(LOG_LEVEL_HEADER, "Continue hack in da house."); continue_hack_in_da_house = 1; } - else if (*header == '\0') + else if (*header == '\0') { /* * If the header is empty, but the Continue hack @@ -617,41 +1823,35 @@ static const char *crunch_reason(const struct http_response *rsp) return "Internal error while searching for crunch reason"; }
- switch (rsp->crunch_reason) + switch (rsp->reason) { - case UNSUPPORTED: + case RSP_REASON_UNSUPPORTED: reason = "Unsupported HTTP feature"; break; - case BLOCKED: + case RSP_REASON_BLOCKED: reason = "Blocked"; break; - case UNTRUSTED: + case RSP_REASON_UNTRUSTED: reason = "Untrusted"; break; - case REDIRECTED: + case RSP_REASON_REDIRECTED: reason = "Redirected"; break; - case CGI_CALL: + case RSP_REASON_CGI_CALL: reason = "CGI Call"; break; - case NO_SUCH_DOMAIN: + case RSP_REASON_NO_SUCH_DOMAIN: reason = "DNS failure"; break; - case FORWARDING_FAILED: + case RSP_REASON_FORWARDING_FAILED: reason = "Forwarding failed"; break; - case CONNECT_FAILED: + case RSP_REASON_CONNECT_FAILED: reason = "Connection failure"; break; - case OUT_OF_MEMORY: + case RSP_REASON_OUT_OF_MEMORY: reason = "Out of memory (may mask other reasons)"; break; - case CONNECTION_TIMEOUT: - reason = "Connection timeout"; - break; - case NO_SERVER_DATA: - reason = "No server data received"; - break; default: reason = "No reason recorded"; break; @@ -686,12 +1886,24 @@ static void send_crunch_response(const struct client_state *csp, struct http_res
if (rsp == NULL) { - log_error(LOG_LEVEL_FATAL, "NULL response in send_crunch_response."); + /* + * Not supposed to happen. If it does + * anyway, treat it as an unknown error. + */ + cgi_error_unknown(csp, rsp, RSP_REASON_INTERNAL_ERROR); + /* return code doesn't matter */ + } + + if (rsp == NULL) + { + /* If rsp is still NULL, we have serious internal problems. */ + log_error(LOG_LEVEL_FATAL, + "NULL response in send_crunch_response and cgi_error_unknown failed as well."); }
/* * Extract the status code from the actual head - * that will be send to the client. It is the only + * that was send to the client. It is the only * way to get it right for all requests, including * the fixed ones for out-of-memory problems. * @@ -704,30 +1916,90 @@ static void send_crunch_response(const struct client_state *csp, struct http_res status_code[2] = rsp->head[11]; status_code[3] = '\0';
- /* Log that the request was crunched and why. */ - log_error(LOG_LEVEL_CRUNCH, "%s: %s", crunch_reason(rsp), http->url); - log_error(LOG_LEVEL_CLF, "%s - - [%T] "%s" %s %u", - csp->ip_addr_str, http->ocmd, status_code, rsp->content_length); - /* Write the answer to the client */ if (write_socket(csp->cfd, rsp->head, rsp->head_length) || write_socket(csp->cfd, rsp->body, rsp->content_length)) { /* There is nothing we can do about it. */ - log_error(LOG_LEVEL_ERROR, - "Couldn't deliver the error message through client socket %d: %E", - csp->cfd); + log_error(LOG_LEVEL_ERROR, "write to: %s failed: %E", csp->http->host); }
+ /* Log that the request was crunched and why. */ + log_error(LOG_LEVEL_CRUNCH, "%s: %s", crunch_reason(rsp), http->url); + log_error(LOG_LEVEL_CLF, "%s - - [%T] "%s" %s %u", + csp->ip_addr_str, http->ocmd, status_code, rsp->content_length); + /* Clean up and return */ if (cgi_error_memory() != rsp) { free_http_response(rsp); - } + } return; }
+#if 0 +/********************************************************************* + * + * Function : request_contains_null_bytes + * + * Description : Checks for NULL bytes in the request and sends + * an error message to the client if any were found. + * + * XXX: currently not used, see comment in chat(). + * + * Parameters : + * 1 : csp = Current client state (buffers, headers, etc...) + * 2 : buf = Data from the client's request to check. + * 3 : len = The data length. + * + * Returns : TRUE if the request contained one or more NULL bytes, or + * FALSE otherwise. + * + *********************************************************************/ +static int request_contains_null_bytes(const struct client_state *csp, char *buf, int len) +{ + size_t c_len; /* Request lenght when treated as C string */ + + c_len = strlen(buf); + + if (c_len < len) + { + /* + * Null byte(s) found. Log the request, + * return an error response and hang up. + */ + size_t tmp_len = c_len; + + do + { + /* + * Replace NULL byte(s) with '°' characters + * so the request can be logged as string. + * XXX: Is there a better replacement character? + */ + buf[tmp_len]='°'; + tmp_len += strlen(buf+tmp_len); + } while (tmp_len < len); + + log_error(LOG_LEVEL_ERROR, "%s's request contains at least one NULL byte " + "(length=%d, strlen=%u).", csp->ip_addr_str, len, c_len); + log_error(LOG_LEVEL_HEADER, + "Offending request data with NULL bytes turned into '°' characters: %s", buf); + + write_socket(csp->cfd, NULL_BYTE_RESPONSE, strlen(NULL_BYTE_RESPONSE)); + + /* XXX: Log correct size */ + log_error(LOG_LEVEL_CLF, "%s - - [%T] "Invalid request" 400 0", csp->ip_addr_str); + + return TRUE; + } + + return FALSE; +} +#endif + + /********************************************************************* * * Function : crunch_response_triggered @@ -751,14 +2023,13 @@ static int crunch_response_triggered(struct client_state *csp, const struct crun /* * If CGI request crunching is disabled, * check the CGI dispatcher out of order to - * prevent unintentional blocks or redirects. + * prevent unintentional blocks or redirects. */ if (!(csp->config->feature_flags & RUNTIME_FEATURE_CGI_CRUNCHING) && (NULL != (rsp = dispatch_cgi(csp)))) { /* Deliver, log and free the interception response. */ send_crunch_response(csp, rsp); - csp->flags |= CSP_FLAG_CRUNCHED; return TRUE; }
@@ -778,7 +2049,6 @@ static int crunch_response_triggered(struct client_state *csp, const struct crun { /* Deliver, log and free the interception response. */ send_crunch_response(csp, rsp); - csp->flags |= CSP_FLAG_CRUNCHED; #ifdef FEATURE_STATISTICS if (c->flags & CF_COUNT_AS_REJECT) { @@ -934,7 +2204,7 @@ static int server_response_is_complete(struct client_state *csp, content_length_known = TRUE; }
- if (csp->http->status == 204 || csp->http->status == 304) + if (csp->http->status == 304) { /* * Expect no body. XXX: incomplete "list" of status codes? @@ -948,7 +2218,6 @@ static int server_response_is_complete(struct client_state *csp, }
-#ifdef FEATURE_CONNECTION_SHARING /********************************************************************* * * Function : wait_for_alive_connections @@ -960,7 +2229,7 @@ static int server_response_is_complete(struct client_state *csp, * Returns : N/A * *********************************************************************/ -static void wait_for_alive_connections(void) +static void wait_for_alive_connections() { int connections_alive = close_unusable_connections();
@@ -976,164 +2245,6 @@ static void wait_for_alive_connections(void) log_error(LOG_LEVEL_CONNECT, "No connections to wait for left.");
} -#endif /* def FEATURE_CONNECTION_SHARING */ - - -/********************************************************************* - * - * Function : save_connection_destination - * - * Description : Remembers a connection for reuse later on. - * - * Parameters : - * 1 : sfd = Open socket to remember. - * 2 : http = The destination for the connection. - * 3 : fwd = The forwarder settings used. - * 3 : server_connection = storage. - * - * Returns : void - * - *********************************************************************/ -void save_connection_destination(jb_socket sfd, - const struct http_request *http, - const struct forward_spec *fwd, - struct reusable_connection *server_connection) -{ - assert(sfd != JB_INVALID_SOCKET); - assert(NULL != http->host); - - server_connection->sfd = sfd; - server_connection->host = strdup(http->host); - if (NULL == server_connection->host) - { - log_error(LOG_LEVEL_FATAL, "Out of memory saving socket."); - } - server_connection->port = http->port; - - assert(NULL != fwd); - assert(server_connection->gateway_host == NULL); - assert(server_connection->gateway_port == 0); - assert(server_connection->forwarder_type == 0); - assert(server_connection->forward_host == NULL); - assert(server_connection->forward_port == 0); - - server_connection->forwarder_type = fwd->type; - if (NULL != fwd->gateway_host) - { - server_connection->gateway_host = strdup(fwd->gateway_host); - if (NULL == server_connection->gateway_host) - { - log_error(LOG_LEVEL_FATAL, "Out of memory saving gateway_host."); - } - } - else - { - server_connection->gateway_host = NULL; - } - server_connection->gateway_port = fwd->gateway_port; - - if (NULL != fwd->forward_host) - { - server_connection->forward_host = strdup(fwd->forward_host); - if (NULL == server_connection->forward_host) - { - log_error(LOG_LEVEL_FATAL, "Out of memory saving forward_host."); - } - } - else - { - server_connection->forward_host = NULL; - } - server_connection->forward_port = fwd->forward_port; -} - - -/********************************************************************* - * - * Function : verify_request_length - * - * Description : Checks if we already got the whole client requests - * and sets CSP_FLAG_CLIENT_REQUEST_COMPLETELY_READ if - * we do. - * - * Data that doesn't belong to the current request is - * thrown away to let the client retry on a clean socket. - * - * XXX: This is a hack until we can deal with multiple - * pipelined requests at the same time. - * - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * - * Returns : void - * - *********************************************************************/ -static void verify_request_length(struct client_state *csp) -{ - unsigned long long buffered_request_bytes = - (unsigned long long)(csp->iob->eod - csp->iob->cur); - - if ((csp->expected_client_content_length != 0) - && (buffered_request_bytes != 0)) - { - if (csp->expected_client_content_length >= buffered_request_bytes) - { - csp->expected_client_content_length -= buffered_request_bytes; - log_error(LOG_LEVEL_CONNECT, "Reduced expected bytes to %llu " - "to account for the %llu ones we already got.", - csp->expected_client_content_length, buffered_request_bytes); - } - else - { - assert(csp->iob->eod > csp->iob->cur + csp->expected_client_content_length); - csp->iob->eod = csp->iob->cur + csp->expected_client_content_length; - log_error(LOG_LEVEL_CONNECT, "Reducing expected bytes to 0. " - "Marking the server socket tainted after throwing %llu bytes away.", - buffered_request_bytes - csp->expected_client_content_length); - csp->expected_client_content_length = 0; - csp->flags |= CSP_FLAG_SERVER_SOCKET_TAINTED; - } - - if (csp->expected_client_content_length == 0) - { - csp->flags |= CSP_FLAG_CLIENT_REQUEST_COMPLETELY_READ; - } - } - - if (!(csp->flags & CSP_FLAG_CLIENT_REQUEST_COMPLETELY_READ) - && ((csp->iob->cur[0] != '\0') || (csp->expected_client_content_length != 0))) - { - csp->flags |= CSP_FLAG_SERVER_SOCKET_TAINTED; - if (strcmpic(csp->http->gpc, "GET") - && strcmpic(csp->http->gpc, "HEAD") - && strcmpic(csp->http->gpc, "TRACE") - && strcmpic(csp->http->gpc, "OPTIONS") - && strcmpic(csp->http->gpc, "DELETE")) - { - /* XXX: this is an incomplete hack */ - csp->flags &= ~CSP_FLAG_CLIENT_REQUEST_COMPLETELY_READ; - log_error(LOG_LEVEL_CONNECT, - "There might be a request body. The connection will not be kept alive."); - } - else - { - /* XXX: and so is this */ - csp->flags |= CSP_FLAG_CLIENT_REQUEST_COMPLETELY_READ; - log_error(LOG_LEVEL_CONNECT, - "Possible pipeline attempt detected. The connection will not " - "be kept alive and we will only serve the first request."); - /* Nuke the pipelined requests from orbit, just to be sure. */ - csp->iob->buf[0] = '\0'; - csp->iob->eod = csp->iob->cur = csp->iob->buf; - } - } - else - { - csp->flags |= CSP_FLAG_CLIENT_REQUEST_COMPLETELY_READ; - log_error(LOG_LEVEL_CONNECT, "Complete client request received."); - } -} #endif /* FEATURE_CONNECTION_KEEP_ALIVE */
@@ -1153,20 +2264,11 @@ static void verify_request_length(struct client_state *csp) *********************************************************************/ static void mark_server_socket_tainted(struct client_state *csp) { - /* - * For consistency we always mark the server socket - * tainted, however, to reduce the log noise we only - * emit a log message if the server socket could have - * actually been reused. - */ - if ((csp->flags & CSP_FLAG_SERVER_CONNECTION_KEEP_ALIVE) - && !(csp->flags |= CSP_FLAG_SERVER_SOCKET_TAINTED)) + if ((csp->flags & CSP_FLAG_SERVER_CONNECTION_KEEP_ALIVE)) { - log_error(LOG_LEVEL_CONNECT, - "Marking the server socket %d tainted.", - csp->server_connection.sfd); + log_error(LOG_LEVEL_CONNECT, "Unsetting keep-alive flag."); + csp->flags &= ~CSP_FLAG_SERVER_CONNECTION_KEEP_ALIVE; } - csp->flags |= CSP_FLAG_SERVER_SOCKET_TAINTED; }
/********************************************************************* @@ -1193,11 +2295,10 @@ static char *get_request_line(struct client_state *csp) { if (!data_is_available(csp->cfd, csp->config->socket_timeout)) { - log_error(LOG_LEVEL_CONNECT, - "Stopped waiting for the request line. Timeout: %d.", - csp->config->socket_timeout); - write_socket(csp->cfd, CLIENT_CONNECTION_TIMEOUT_RESPONSE, - strlen(CLIENT_CONNECTION_TIMEOUT_RESPONSE)); + log_error(LOG_LEVEL_ERROR, + "Stopped waiting for the request line."); + write_socket(csp->cfd, CONNECTION_TIMEOUT_RESPONSE, + strlen(CONNECTION_TIMEOUT_RESPONSE)); return NULL; }
@@ -1230,6 +2331,10 @@ static char *get_request_line(struct client_state *csp) * Description : Read the client's request (more precisely the * client headers) and answer it if necessary. * + * Note that since we're not using select() we could get + * blocked here if a client connected, then didn't say + * anything! + * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) * @@ -1256,7 +2361,6 @@ static jb_err receive_client_request(struct client_state *csp) req = get_request_line(csp); if (req == NULL) { - mark_server_socket_tainted(csp); return JB_ERR_PARSE; } assert(*req != '\0'); @@ -1324,7 +2428,6 @@ static jb_err receive_client_request(struct client_state *csp) { log_error(LOG_LEVEL_ERROR, "Stopped grabbing the client headers."); - destroy_list(headers); return JB_ERR_PARSE; }
@@ -1335,7 +2438,7 @@ static jb_err receive_client_request(struct client_state *csp) destroy_list(headers); return JB_ERR_PARSE; } - + if (add_to_iob(csp, buf, len)) { /* @@ -1350,7 +2453,7 @@ static jb_err receive_client_request(struct client_state *csp) { /* * We were able to read a complete - * header and can finally enlist it. + * header and can finaly enlist it. */ enlist(headers, p); freez(p); @@ -1393,7 +2496,7 @@ static jb_err receive_client_request(struct client_state *csp) get_url_actions(csp, http); }
- /* + /* * Save a copy of the original request for logging */ http->ocmd = strdup(http->cmd); @@ -1435,16 +2538,6 @@ static jb_err parse_client_request(struct client_state *csp) struct http_request *http = csp->http; jb_err err;
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if ((csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE) - && (!strcmpic(csp->http->ver, "HTTP/1.1")) - && (csp->http->ssl == 0)) - { - /* Assume persistence until further notice */ - csp->flags |= CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE; - } -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - err = sed(csp, FILTER_CLIENT_HEADERS); if (JB_ERR_OK != err) { @@ -1473,13 +2566,6 @@ static jb_err parse_client_request(struct client_state *csp) return JB_ERR_PARSE; }
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if (csp->http->ssl == 0) - { - verify_request_length(csp); - } -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - return JB_ERR_OK;
} @@ -1489,16 +2575,11 @@ static jb_err parse_client_request(struct client_state *csp) * * Function : chat * - * Description : Once a connection from the client has been accepted, + * Description : Once a connection to the client has been accepted, * this function is called (via serve()) to handle the - * main business of the communication. This function - * returns after dealing with a single request. It can - * be called multiple times with the same client socket - * if the client is keeping the connection alive. - * - * The decision whether or not a client connection will - * be kept alive is up to the caller which also must - * close the client socket when done. + * main business of the communication. When this + * function returns, the caller must close the client + * socket handle. * * FIXME: chat is nearly thousand lines long. * Ridiculous. @@ -1520,17 +2601,18 @@ static void chat(struct client_state *csp) int server_body; int ms_iis5_hack = 0; unsigned long long byte_count = 0; + int forwarded_connect_retries = 0; + int max_forwarded_connect_retries = csp->config->forwarded_connect_retries; const struct forward_spec *fwd; struct http_request *http; long len = 0; /* for buffer sizes (and negative error codes) */ - int buffer_and_filter_content = 0; + + /* Function that does the content filtering for the current request */ + filter_function_ptr content_filter = NULL;
/* Skeleton for HTTP response, if we should intercept the request */ struct http_response *rsp; struct timeval timeout; -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - int watch_client_socket = 1; -#endif
memset(buf, 0, sizeof(buf));
@@ -1597,8 +2679,8 @@ static void chat(struct client_state *csp) csp->action->string[ACTION_STRING_LIMIT_CONNECT]; assert(NULL != acceptable_connect_ports); log_error(LOG_LEVEL_INFO, "Request from %s marked for blocking. " - "limit-connect{%s} doesn't allow CONNECT requests to %s", - csp->ip_addr_str, acceptable_connect_ports, csp->http->hostport); + "limit-connect{%s} doesn't allow CONNECT requests to port %d.", + csp->ip_addr_str, acceptable_connect_ports, csp->http->port); csp->action->flags |= ACTION_BLOCK; http->ssl = 0; } @@ -1615,8 +2697,12 @@ static void chat(struct client_state *csp) if (crunch_response_triggered(csp, crunchers_all)) { /* - * Yes. The client got the crunch response and we're done here. + * Yes. The client got the crunch response + * and we are done here after cleaning up. */ + /* XXX: why list_remove_all()? */ + list_remove_all(csp->headers); + return; }
@@ -1624,7 +2710,7 @@ static void chat(struct client_state *csp)
if (fwd->forward_host) { - log_error(LOG_LEVEL_CONNECT, "via [%s]:%d to: %s", + log_error(LOG_LEVEL_CONNECT, "via %s:%d to: %s", fwd->forward_host, fwd->forward_port, http->hostport); } else @@ -1634,82 +2720,63 @@ static void chat(struct client_state *csp)
/* here we connect to the server, gateway, or the forwarder */
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if ((csp->server_connection.sfd != JB_INVALID_SOCKET) - && socket_is_still_alive(csp->server_connection.sfd) - && connection_destination_matches(&csp->server_connection, http, fwd)) + while ((csp->sfd = forwarded_connect(fwd, http, csp)) + && (errno == EINVAL) + && (forwarded_connect_retries++ < max_forwarded_connect_retries)) { - log_error(LOG_LEVEL_CONNECT, - "Reusing server socket %u. Opened for %s.", - csp->server_connection.sfd, csp->server_connection.host); + log_error(LOG_LEVEL_ERROR, + "failed request #%u to connect to %s. Trying again.", + forwarded_connect_retries, http->hostport); } - else + + if (csp->sfd == JB_INVALID_SOCKET) { - if (csp->server_connection.sfd != JB_INVALID_SOCKET) + if (fwd->type != SOCKS_NONE) { - log_error(LOG_LEVEL_CONNECT, - "Closing server socket %u. Opened for %s.", - csp->server_connection.sfd, csp->server_connection.host); - close_socket(csp->server_connection.sfd); - mark_connection_closed(&csp->server_connection); + /* Socks error. */ + rsp = error_response(csp, "forwarding-failed", errno); + } + else if (errno == EINVAL) + { + rsp = error_response(csp, "no-such-domain", errno); + } + else + { + rsp = error_response(csp, "connect-failed", errno); + log_error(LOG_LEVEL_CONNECT, "connect to: %s failed: %E", + http->hostport); } -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - - csp->server_connection.sfd = forwarded_connect(fwd, http, csp);
- if (csp->server_connection.sfd == JB_INVALID_SOCKET) + /* Write the answer to the client */ + if (rsp != NULL) { - if (fwd->type != SOCKS_NONE) - { - /* Socks error. */ - rsp = error_response(csp, "forwarding-failed"); - } - else if (errno == EINVAL) - { - rsp = error_response(csp, "no-such-domain"); - } - else - { - rsp = error_response(csp, "connect-failed"); - } + send_crunch_response(csp, rsp); + }
- /* Write the answer to the client */ - if (rsp != NULL) - { - send_crunch_response(csp, rsp); - } + return; + }
- return; - } -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - save_connection_destination(csp->server_connection.sfd, - http, fwd, &csp->server_connection); - csp->server_connection.keep_alive_timeout = - (unsigned)csp->config->keep_alive_timeout; + hdr = list_to_text(csp->headers); + if (hdr == NULL) + { + /* FIXME Should handle error properly */ + log_error(LOG_LEVEL_FATAL, "Out of memory parsing client header"); } -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ + list_remove_all(csp->headers);
if (fwd->forward_host || (http->ssl == 0)) { - hdr = list_to_text(csp->headers); - if (hdr == NULL) - { - /* FIXME Should handle error properly */ - log_error(LOG_LEVEL_FATAL, "Out of memory parsing client header"); - } - list_remove_all(csp->headers); - /* * Write the client's (modified) header to the server * (along with anything else that may be in the buffer) */ - if (write_socket(csp->server_connection.sfd, hdr, strlen(hdr)) - || (flush_socket(csp->server_connection.sfd, csp->iob) < 0)) + if (write_socket(csp->sfd, hdr, strlen(hdr)) + || (flush_socket(csp->sfd, csp->iob) < 0)) { log_error(LOG_LEVEL_CONNECT, "write header to: %s failed: %E", http->hostport);
- rsp = error_response(csp, "connect-failed"); + rsp = error_response(csp, "connect-failed", errno); if (rsp) { send_crunch_response(csp, rsp); @@ -1718,18 +2785,17 @@ static void chat(struct client_state *csp) freez(hdr); return; } - freez(hdr); } else { /* * We're running an SSL tunnel and we're not forwarding, - * so just ditch the client headers, send the "connect succeeded" - * message to the client, flush the rest, and get out of the way. + * so just send the "connect succeeded" message to the + * client, flush the rest, and get out of the way. */ - list_remove_all(csp->headers); if (write_socket(csp->cfd, CSUCCEED, strlen(CSUCCEED))) { + freez(hdr); return; } IOB_RESET(csp); @@ -1737,10 +2803,10 @@ static void chat(struct client_state *csp)
log_error(LOG_LEVEL_CONNECT, "to %s successful", http->hostport);
- csp->server_connection.request_sent = time(NULL); + /* we're finished with the client's header */ + freez(hdr);
- maxfd = (csp->cfd > csp->server_connection.sfd) ? - csp->cfd : csp->server_connection.sfd; + maxfd = (csp->cfd > csp->sfd) ? csp->cfd : csp->sfd;
/* pass data between the client and server * until one or the other shuts down the connection. @@ -1759,18 +2825,8 @@ static void chat(struct client_state *csp) #else FD_ZERO(&rfds); #endif -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if (!watch_client_socket) - { - maxfd = csp->server_connection.sfd; - } - else -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - { - FD_SET(csp->cfd, &rfds); - } - - FD_SET(csp->server_connection.sfd, &rfds); + FD_SET(csp->cfd, &rfds); + FD_SET(csp->sfd, &rfds);
#ifdef FEATURE_CONNECTION_KEEP_ALIVE if ((csp->flags & CSP_FLAG_CHUNKED) @@ -1778,34 +2834,19 @@ static void chat(struct client_state *csp) && ((csp->iob->eod - csp->iob->cur) >= 5) && !memcmp(csp->iob->eod-5, "0\r\n\r\n", 5)) { - /* - * XXX: This check should be obsolete now, - * but let's wait a while to be sure. - */ log_error(LOG_LEVEL_CONNECT, - "Looks like we got the last chunk together with " - "the server headers but didn't detect it earlier. " - "We better stop reading."); + "Looks like we read the last chunk together with " + "the server headers. We better stop reading."); byte_count = (unsigned long long)(csp->iob->eod - csp->iob->cur); csp->expected_content_length = byte_count; csp->flags |= CSP_FLAG_CONTENT_LENGTH_SET; } if (server_body && server_response_is_complete(csp, byte_count)) { - if (csp->expected_content_length == byte_count) - { - log_error(LOG_LEVEL_CONNECT, - "Done reading from server. Content length: %llu as expected. " - "Bytes most recently read: %d.", - byte_count, len); - } - else - { - log_error(LOG_LEVEL_CONNECT, - "Done reading from server. Expected content length: %llu. " - "Actual content length: %llu. Bytes most recently read: %d.", - csp->expected_content_length, byte_count, len); - } + log_error(LOG_LEVEL_CONNECT, + "Done reading from server. Expected content length: %llu. " + "Actual content length: %llu. Most recently received: %d.", + csp->expected_content_length, byte_count, len); len = 0; /* * XXX: should not jump around, @@ -1825,7 +2866,8 @@ static void chat(struct client_state *csp) "Didn't receive data in time: %s", http->url); if ((byte_count == 0) && (http->ssl == 0)) { - send_crunch_response(csp, error_response(csp, "connection-timeout")); + write_socket(csp->cfd, CONNECTION_TIMEOUT_RESPONSE, + strlen(CONNECTION_TIMEOUT_RESPONSE)); } mark_server_socket_tainted(csp); return; @@ -1840,57 +2882,10 @@ static void chat(struct client_state *csp) /* * This is the body of the browser's request, * just read and write it. - * - * XXX: Make sure the client doesn't use pipelining - * behind Privoxy's back. */ if (FD_ISSET(csp->cfd, &rfds)) { - int max_bytes_to_read = sizeof(buf) - 1; - -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if ((csp->flags & CSP_FLAG_CLIENT_REQUEST_COMPLETELY_READ)) - { - if (data_is_available(csp->cfd, 0)) - { - /* - * If the next request is already waiting, we have - * to stop select()ing the client socket. Otherwise - * we would always return right away and get nothing - * else done. - */ - watch_client_socket = 0; - log_error(LOG_LEVEL_CONNECT, - "Stopping to watch the client socket. " - "There's already another request waiting."); - continue; - } - /* - * If the client socket is set, but there's no data - * available on the socket, the client went fishing - * and continuing talking to the server makes no sense. - */ - log_error(LOG_LEVEL_CONNECT, - "The client closed socket %d while " - "the server socket %d is still open.", - csp->cfd, csp->server_connection.sfd); - mark_server_socket_tainted(csp); - break; - } - if (csp->expected_client_content_length != 0) - { - if (csp->expected_client_content_length < (sizeof(buf) - 1)) - { - max_bytes_to_read = (int)csp->expected_client_content_length; - } - log_error(LOG_LEVEL_CONNECT, - "Waiting for up to %d bytes from the client.", - max_bytes_to_read); - } - assert(max_bytes_to_read < sizeof(buf)); -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - - len = read_socket(csp->cfd, buf, max_bytes_to_read); + len = read_socket(csp->cfd, buf, sizeof(buf) - 1);
if (len <= 0) { @@ -1899,25 +2894,7 @@ static void chat(struct client_state *csp) break; /* "game over, man" */ }
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if (csp->expected_client_content_length != 0) - { - assert(len <= max_bytes_to_read); - csp->expected_client_content_length -= (unsigned)len; - log_error(LOG_LEVEL_CONNECT, - "Expected client content length set to %llu " - "after reading %d bytes.", - csp->expected_client_content_length, len); - if (csp->expected_client_content_length == 0) - { - log_error(LOG_LEVEL_CONNECT, - "Done reading from the client."); - csp->flags |= CSP_FLAG_CLIENT_REQUEST_COMPLETELY_READ; - } - } -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - - if (write_socket(csp->server_connection.sfd, buf, (size_t)len)) + if (write_socket(csp->sfd, buf, (size_t)len)) { log_error(LOG_LEVEL_ERROR, "write to: %s failed: %E", http->host); mark_server_socket_tainted(csp); @@ -1931,32 +2908,10 @@ static void chat(struct client_state *csp) * If `hdr' is null, then it's the header otherwise it's the body. * FIXME: Does `hdr' really mean `host'? No. */ - if (FD_ISSET(csp->server_connection.sfd, &rfds)) + if (FD_ISSET(csp->sfd, &rfds)) { -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - /* - * If we are buffering content, we don't want to eat up to - * buffer-limit bytes if the client no longer cares about them. - * If we aren't buffering, however, a dead client socket will be - * noticed pretty much right away anyway, so we can reduce the - * overhead by skipping the check. - */ - if (buffer_and_filter_content && !socket_is_still_alive(csp->cfd)) - { -#ifdef _WIN32 - log_error(LOG_LEVEL_CONNECT, - "The server still wants to talk, but the client may already have hung up on us."); -#else - log_error(LOG_LEVEL_CONNECT, - "The server still wants to talk, but the client hung up on us."); - mark_server_socket_tainted(csp); - return; -#endif /* def _WIN32 */ - } -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - - fflush(NULL); - len = read_socket(csp->server_connection.sfd, buf, sizeof(buf) - 1); + fflush(0); + len = read_socket(csp->sfd, buf, sizeof(buf) - 1);
if (len < 0) { @@ -1987,11 +2942,14 @@ static void chat(struct client_state *csp) mark_server_socket_tainted(csp); return; } - /* - * XXX: Consider handling the cases above the same. - */ - mark_server_socket_tainted(csp); - len = 0; + + rsp = error_response(csp, "connect-failed", errno); + if (rsp) + { + send_crunch_response(csp, rsp); + } + + return; }
#ifdef FEATURE_CONNECTION_KEEP_ALIVE @@ -2045,11 +3003,11 @@ static void chat(struct client_state *csp) * now is the time to apply content modification * and send the result to the client. */ - if (buffer_and_filter_content) + if (content_filter) { - p = execute_content_filters(csp); + p = execute_content_filter(csp, content_filter); /* - * If content filtering fails, use the original + * If the content filter fails, use the original * buffer and length. * (see p != NULL ? p : csp->iob->cur below) */ @@ -2057,20 +3015,6 @@ static void chat(struct client_state *csp) { csp->content_length = (size_t)(csp->iob->eod - csp->iob->cur); } -#ifdef FEATURE_COMPRESSION - else if ((csp->flags & CSP_FLAG_CLIENT_SUPPORTS_DEFLATE) - && (csp->content_length > LOWER_LENGTH_LIMIT_FOR_COMPRESSION)) - { - char *compressed_content = compress_buffer(p, - (size_t *)&csp->content_length, csp->config->compression_level); - if (compressed_content != NULL) - { - freez(p); - p = compressed_content; - csp->flags |= CSP_FLAG_BUFFERED_CONTENT_DEFLATED; - } - } -#endif
if (JB_ERR_OK != update_server_headers(csp)) { @@ -2125,7 +3069,7 @@ static void chat(struct client_state *csp) */ if (server_body || http->ssl) { - if (buffer_and_filter_content) + if (content_filter) { /* * If there is no memory left for buffering the content, or the buffer limit @@ -2143,7 +3087,7 @@ static void chat(struct client_state *csp) hdr = list_to_text(csp->headers); if (hdr == NULL) { - /* + /* * Memory is too tight to even generate the header. * Send our static "Out-of-memory" page. */ @@ -2173,7 +3117,7 @@ static void chat(struct client_state *csp) */ byte_count = (unsigned long long)flushed; freez(hdr); - buffer_and_filter_content = 0; + content_filter = NULL; server_body = 1; } } @@ -2191,6 +3135,7 @@ static void chat(struct client_state *csp) } else { + const char *header_start; /* * We're still looking for the end of the server's header. * Buffer up the data we just read. If that fails, there's @@ -2200,11 +3145,13 @@ static void chat(struct client_state *csp) { log_error(LOG_LEVEL_ERROR, "Out of memory while looking for end of server headers."); rsp = cgi_error_memory(); - send_crunch_response(csp, rsp); + send_crunch_response(csp, rsp); mark_server_socket_tainted(csp); return; }
+ header_start = csp->iob->cur; + /* Convert iob into something sed() can digest */ if (JB_ERR_PARSE == get_server_headers(csp)) { @@ -2215,14 +3162,9 @@ static void chat(struct client_state *csp) * The header is incomplete and there isn't anything * we can do about it. */ - log_error(LOG_LEVEL_ERROR, "Invalid server headers. " - "Applying the MS IIS5 hack didn't help."); - log_error(LOG_LEVEL_CLF, - "%s - - [%T] "%s" 502 0", csp->ip_addr_str, http->cmd); - write_socket(csp->cfd, INVALID_SERVER_HEADERS_RESPONSE, - strlen(INVALID_SERVER_HEADERS_RESPONSE)); - mark_server_socket_tainted(csp); - return; + log_error(LOG_LEVEL_INFO, + "MS IIS5 hack didn't produce valid headers."); + break; } else { @@ -2230,41 +3172,22 @@ static void chat(struct client_state *csp) * Since we have to wait for more from the server before * we can parse the headers we just continue here. */ - log_error(LOG_LEVEL_CONNECT, - "Continuing buffering headers. Bytes most recently read: %d.", - len); + long header_offset = csp->iob->cur - header_start; + assert(csp->iob->cur >= header_start); + byte_count += (unsigned long long)(len - header_offset); + log_error(LOG_LEVEL_CONNECT, "Continuing buffering headers. " + "byte_count: %llu. header_offset: %d. len: %d.", + byte_count, header_offset, len); continue; } } - else - { - /* - * Account for the content bytes we - * might have gotten with the headers. - */ - assert(csp->iob->eod >= csp->iob->cur); - byte_count = (unsigned long long)(csp->iob->eod - csp->iob->cur); - }
/* Did we actually get anything? */ if (NULL == csp->headers->first) { - if ((csp->flags & CSP_FLAG_REUSED_CLIENT_CONNECTION)) - { - log_error(LOG_LEVEL_ERROR, - "No server or forwarder response received on socket %d. " - "Closing client socket %d without sending data.", - csp->server_connection.sfd, csp->cfd); - log_error(LOG_LEVEL_CLF, - "%s - - [%T] "%s" 502 0", csp->ip_addr_str, http->cmd); - } - else - { - log_error(LOG_LEVEL_ERROR, - "No server or forwarder response received on socket %d.", - csp->server_connection.sfd); - send_crunch_response(csp, error_response(csp, "no-server-data")); - } + log_error(LOG_LEVEL_ERROR, "Empty server or forwarder response."); + log_error(LOG_LEVEL_CLF, "%s - - [%T] "%s" 502 0", csp->ip_addr_str, http->cmd); + write_socket(csp->cfd, NO_SERVER_DATA_RESPONSE, strlen(NO_SERVER_DATA_RESPONSE)); free_http_request(http); mark_server_socket_tainted(csp); return; @@ -2310,21 +3233,6 @@ static void chat(struct client_state *csp) log_error(LOG_LEVEL_FATAL, "Out of memory parsing server header"); }
- if ((csp->flags & CSP_FLAG_CHUNKED) - && !(csp->flags & CSP_FLAG_CONTENT_LENGTH_SET) - && ((csp->iob->eod - csp->iob->cur) >= 5) - && !memcmp(csp->iob->eod-5, "0\r\n\r\n", 5)) - { - log_error(LOG_LEVEL_CONNECT, - "Looks like we got the last chunk together with " - "the server headers. We better stop reading."); - byte_count = (unsigned long long)(csp->iob->eod - csp->iob->cur); - csp->expected_content_length = byte_count; - csp->flags |= CSP_FLAG_CONTENT_LENGTH_SET; - } - - csp->server_connection.response_received = time(NULL); - if (crunch_response_triggered(csp, crunchers_light)) { /* @@ -2341,12 +3249,12 @@ static void chat(struct client_state *csp)
if (!http->ssl) /* We talk plaintext */ { - buffer_and_filter_content = content_requires_filtering(csp); + content_filter = get_filter_function(csp); } /* * Only write if we're not buffering for content modification */ - if (!buffer_and_filter_content) + if (!content_filter) { /* * Write the server's (modified) header to @@ -2367,6 +3275,18 @@ static void chat(struct client_state *csp) mark_server_socket_tainted(csp); return; } + + byte_count += (unsigned long long)len; + } + else + { + /* + * XXX: the header lenght should probably + * be calculated by get_server_headers(). + */ + long header_length = csp->iob->cur - header_start; + assert(csp->iob->cur > header_start); + byte_count += (unsigned long long)(len - header_length); }
/* we're finished with the server's header */ @@ -2381,15 +3301,9 @@ static void chat(struct client_state *csp) */ if (ms_iis5_hack) { - log_error(LOG_LEVEL_ERROR, - "Closed server connection detected. " - "Applying the MS IIS5 hack didn't help."); - log_error(LOG_LEVEL_CLF, - "%s - - [%T] "%s" 502 0", csp->ip_addr_str, http->cmd); - write_socket(csp->cfd, INVALID_SERVER_HEADERS_RESPONSE, - strlen(INVALID_SERVER_HEADERS_RESPONSE)); - mark_server_socket_tainted(csp); - return; + log_error(LOG_LEVEL_INFO, + "Closed server connection detected with MS IIS5 hack enabled."); + break; } } continue; @@ -2401,7 +3315,7 @@ static void chat(struct client_state *csp) if (csp->content_length == 0) { /* - * If Privoxy didn't recalculate the Content-Length, + * If Privoxy didn't recalculate the Content-Lenght, * byte_count is still correct. */ csp->content_length = byte_count; @@ -2420,62 +3334,15 @@ static void chat(struct client_state *csp)
log_error(LOG_LEVEL_CLF, "%s - - [%T] "%s" 200 %llu", csp->ip_addr_str, http->ocmd, csp->content_length); - - csp->server_connection.timestamp = time(NULL); }
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE -/********************************************************************* - * - * Function : prepare_csp_for_next_request - * - * Description : Put the csp in a mostly vergin state. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * - * Returns : N/A - * - *********************************************************************/ -static void prepare_csp_for_next_request(struct client_state *csp) -{ - unsigned int toggled_on_flag_set = (0 != (csp->flags & CSP_FLAG_TOGGLED_ON)); - - csp->content_type = 0; - csp->content_length = 0; - csp->expected_content_length = 0; - csp->expected_client_content_length = 0; - list_remove_all(csp->headers); - freez(csp->iob->buf); - memset(csp->iob, 0, sizeof(csp->iob)); - freez(csp->error_message); - free_http_request(csp->http); - destroy_list(csp->headers); - destroy_list(csp->tags); - free_current_action(csp->action); - if (NULL != csp->fwd) - { - unload_forward_spec(csp->fwd); - csp->fwd = NULL; - } - /* XXX: Store per-connection flags someplace else. */ - csp->flags = (CSP_FLAG_ACTIVE | CSP_FLAG_REUSED_CLIENT_CONNECTION); - if (toggled_on_flag_set) - { - csp->flags |= CSP_FLAG_TOGGLED_ON; - } -} -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - - /********************************************************************* * * Function : serve * * Description : This is little more than chat. We only "serve" to - * to close (or remember) any socket that chat may have - * opened. + * to close any socket that chat may have opened. * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) @@ -2489,165 +3356,37 @@ void serve(struct client_state *csp) static void serve(struct client_state *csp) #endif /* def AMIGA */ { -#ifdef FEATURE_CONNECTION_KEEP_ALIVE -#ifdef FEATURE_CONNECTION_SHARING - static int monitor_thread_running = 0; -#endif /* def FEATURE_CONNECTION_SHARING */ - int continue_chatting = 0; + chat(csp); + close_socket(csp->cfd);
- do + if (csp->sfd != JB_INVALID_SOCKET) { - unsigned int latency; - int config_file_change_detected = 0; /* Only used for debugging */ - - chat(csp); - - /* - * If the request has been crunched, - * the calculated latency is zero. - */ - latency = (unsigned)(csp->server_connection.response_received - - csp->server_connection.request_sent) / 2; - - continue_chatting = (csp->config->feature_flags - & RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE) - && !(csp->flags & CSP_FLAG_SERVER_SOCKET_TAINTED) - && ((csp->flags & CSP_FLAG_SERVER_CONNECTION_KEEP_ALIVE) - || (csp->flags & CSP_FLAG_CRUNCHED)) - && (csp->cfd != JB_INVALID_SOCKET) - && ((csp->flags & CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE) - || (csp->config->feature_flags & - RUNTIME_FEATURE_CONNECTION_SHARING)); - - if (continue_chatting && !(csp->flags & CSP_FLAG_CRUNCHED)) - { - continue_chatting = (csp->server_connection.sfd != JB_INVALID_SOCKET) - && socket_is_still_alive(csp->server_connection.sfd); - if (continue_chatting) - { - if (!(csp->flags & CSP_FLAG_SERVER_KEEP_ALIVE_TIMEOUT_SET)) - { - csp->server_connection.keep_alive_timeout = csp->config->default_server_timeout; - log_error(LOG_LEVEL_CONNECT, - "The server didn't specify how long the connection will stay open. " - "Assumed timeout is: %u.", csp->server_connection.keep_alive_timeout); - } - continue_chatting = (latency < csp->server_connection.keep_alive_timeout); - } - } - - if (continue_chatting && any_loaded_file_changed(csp->config->config_file_list)) - { - continue_chatting = 0; - config_file_change_detected = 1; - } +#ifdef FEATURE_CONNECTION_KEEP_ALIVE + static int monitor_thread_running = 0;
- if (continue_chatting) + if ((csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE) + && (csp->flags & CSP_FLAG_SERVER_CONNECTION_KEEP_ALIVE)) { - unsigned int client_timeout = 1; /* XXX: Use something else here? */ - - if (0 != (csp->flags & CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE)) - { - if (csp->server_connection.sfd != JB_INVALID_SOCKET) - { - client_timeout = (unsigned)csp->server_connection.keep_alive_timeout - latency; - log_error(LOG_LEVEL_CONNECT, - "Waiting for the next client request on socket %d. " - "Keeping the server socket %d to %s open.", - csp->cfd, csp->server_connection.sfd, csp->server_connection.host); - } - else - { - log_error(LOG_LEVEL_CONNECT, - "Waiting for the next client request on socket %d. " - "No server socket to keep open.", csp->cfd); - } - } - if ((csp->flags & CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE) - && data_is_available(csp->cfd, (int)client_timeout) - && socket_is_still_alive(csp->cfd)) + remember_connection(csp->sfd, csp->http, forward_url(csp, csp->http)); + privoxy_mutex_lock(&connection_reuse_mutex); + if (!monitor_thread_running) { - log_error(LOG_LEVEL_CONNECT, - "Client request arrived in time on socket %d.", csp->cfd); - prepare_csp_for_next_request(csp); - } - else - { - if (0 != (csp->flags & CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE)) - { - log_error(LOG_LEVEL_CONNECT, - "No additional client request received in time on socket %d.", - csp->cfd); - } -#ifdef FEATURE_CONNECTION_SHARING - if ((csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_SHARING) - && (socket_is_still_alive(csp->server_connection.sfd))) - { - time_t time_open = time(NULL) - csp->server_connection.timestamp; - - if (csp->server_connection.keep_alive_timeout < time_open - (time_t)latency) - { - break; - } - - remember_connection(&csp->server_connection); - csp->server_connection.sfd = JB_INVALID_SOCKET; - close_socket(csp->cfd); - csp->cfd = JB_INVALID_SOCKET; - privoxy_mutex_lock(&connection_reuse_mutex); - if (!monitor_thread_running) - { - monitor_thread_running = 1; - privoxy_mutex_unlock(&connection_reuse_mutex); - wait_for_alive_connections(); - privoxy_mutex_lock(&connection_reuse_mutex); - monitor_thread_running = 0; - } - privoxy_mutex_unlock(&connection_reuse_mutex); - } -#endif /* def FEATURE_CONNECTION_SHARING */ - break; + monitor_thread_running = 1; + privoxy_mutex_unlock(&connection_reuse_mutex); + wait_for_alive_connections(); + privoxy_mutex_lock(&connection_reuse_mutex); + monitor_thread_running = 0; } + privoxy_mutex_unlock(&connection_reuse_mutex); } - else if (csp->server_connection.sfd != JB_INVALID_SOCKET) + else { - log_error(LOG_LEVEL_CONNECT, - "The connection on server socket %d to %s isn't reusable. Closing. " - "Server connection: keep-alive %u, tainted: %u, socket alive %u. " - "Client connection: socket alive: %u. Server timeout: %u. " - "Configuration file change detected: %u", - csp->server_connection.sfd, csp->server_connection.host, - 0 != (csp->flags & CSP_FLAG_SERVER_CONNECTION_KEEP_ALIVE), - 0 != (csp->flags & CSP_FLAG_SERVER_SOCKET_TAINTED), - socket_is_still_alive(csp->server_connection.sfd), - socket_is_still_alive(csp->cfd), - csp->server_connection.keep_alive_timeout, - config_file_change_detected); - } - } while (continue_chatting); - + forget_connection(csp->sfd); + close_socket(csp->sfd); + } #else - chat(csp); + close_socket(csp->sfd); #endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - - if (csp->server_connection.sfd != JB_INVALID_SOCKET) - { -#ifdef FEATURE_CONNECTION_SHARING - if (csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_SHARING) - { - forget_connection(csp->server_connection.sfd); - } -#endif /* def FEATURE_CONNECTION_SHARING */ - close_socket(csp->server_connection.sfd); - } - -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - mark_connection_closed(&csp->server_connection); -#endif - - if (csp->cfd != JB_INVALID_SOCKET) - { - close_socket(csp->cfd); }
csp->flags &= ~CSP_FLAG_ACTIVE; @@ -2847,7 +3586,6 @@ static void initialize_mutexes(void) #ifndef HAVE_RANDOM privoxy_mutex_init(&rand_mutex); #endif /* ndef HAVE_RANDOM */ - #endif /* def MUTEX_LOCKS_AVAILABLE */ }
@@ -2876,9 +3614,9 @@ static void initialize_mutexes(void) * *********************************************************************/ #ifdef __MINGW32__ -int real_main(int argc, char **argv) +int real_main(int argc, const char *argv[]) #else -int main(int argc, char **argv) +int main(int argc, const char *argv[]) #endif { int argc_pos = 0; @@ -2886,6 +3624,7 @@ int main(int argc, char **argv) #ifdef unix struct passwd *pw = NULL; struct group *grp = NULL; + char *p; int do_chroot = 0; char *pre_chroot_nslookup_to_load_resolver = NULL; #endif @@ -2924,7 +3663,7 @@ int main(int argc, char **argv) pName++; exit( (install_service(pName)) ? 0 : 1 ); } - else if (strncmp(argv[argc_pos], "--uninstall", 11) == 0) + else if (strncmp(argv[argc_pos], "--uninstall", + 11) == 0) { const char *pName = argv[argc_pos] + 11; if (*pName == ':') @@ -2959,7 +3698,7 @@ int main(int argc, char **argv) else if (strcmp(argv[argc_pos], "--no-daemon" ) == 0) { set_debug_level(LOG_LEVEL_FATAL | LOG_LEVEL_ERROR | LOG_LEVEL_INFO); - daemon_mode = 0; + no_daemon = 1; }
else if (strcmp(argv[argc_pos], "--pidfile" ) == 0) @@ -2970,39 +3709,23 @@ int main(int argc, char **argv)
else if (strcmp(argv[argc_pos], "--user" ) == 0) { - char *user_arg; - char *group_name; - if (++argc_pos == argc) usage(argv[argc_pos]);
- user_arg = strdup(argv[argc_pos]); - if (NULL == user_arg) - { - log_error(LOG_LEVEL_FATAL, - "Out of memory splitting --user argument '%s'.", argv[argc_pos]); - } - group_name = strchr(user_arg, '.'); - if (NULL != group_name) + if ((NULL != (p = strchr(argv[argc_pos], '.'))) && *(p + 1) != '0') { - /* Nul-terminate the user name */ - *group_name = '\0'; - - /* Skip the former delimiter to actually reach the group name */ - group_name++; - - grp = getgrnam(group_name); - if (NULL == grp) + *p++ = '\0'; + if (NULL == (grp = getgrnam(p))) { - log_error(LOG_LEVEL_FATAL, "Group '%s' not found.", group_name); + log_error(LOG_LEVEL_FATAL, "Group %s not found.", p); } } - pw = getpwnam(user_arg); - if (NULL == pw) + + if (NULL == (pw = getpwnam(argv[argc_pos]))) { - log_error(LOG_LEVEL_FATAL, "User '%s' not found.", user_arg); + log_error(LOG_LEVEL_FATAL, "User %s not found.", argv[argc_pos]); }
- freez(user_arg); + if (p != NULL) *--p = '\0'; }
else if (strcmp(argv[argc_pos], "--pre-chroot-nslookup" ) == 0) @@ -3042,7 +3765,7 @@ int main(int argc, char **argv) { char cwd[BUFFER_SIZE]; char *abs_file; - size_t abs_file_size; + size_t abs_file_size;
/* make config-filename absolute here */ if (NULL == getcwd(cwd, sizeof(cwd))) @@ -3096,11 +3819,12 @@ int main(int argc, char **argv) #if !defined(_WIN32) && !defined(__OS2__) && !defined(AMIGA) { int idx; - const int catched_signals[] = { SIGTERM, SIGINT, SIGHUP }; + const int catched_signals[] = { SIGTERM, SIGINT, SIGHUP, 0 }; + const int ignored_signals[] = { SIGPIPE, 0 };
- for (idx = 0; idx < SZ(catched_signals); idx++) + for (idx = 0; catched_signals[idx] != 0; idx++) { -#ifdef sun /* FIXME: Is it safe to check for HAVE_SIGSET instead? */ +#ifdef sun /* FIXME: Is it safe to check for HAVE_SIGSET instead? */ if (sigset(catched_signals[idx], sig_handler) == SIG_ERR) #else if (signal(catched_signals[idx], sig_handler) == SIG_ERR) @@ -3110,9 +3834,12 @@ int main(int argc, char **argv) } }
- if (signal(SIGPIPE, SIG_IGN) == SIG_ERR) + for (idx = 0; ignored_signals[idx] != 0; idx++) { - log_error(LOG_LEVEL_FATAL, "Can't set ignore-handler for SIGPIPE: %E"); + if (signal(ignored_signals[idx], SIG_IGN) == SIG_ERR) + { + log_error(LOG_LEVEL_FATAL, "Can't set ignore-handler for signal %d: %E", ignored_signals[idx]); + } }
} @@ -3137,10 +3864,14 @@ int main(int argc, char **argv) */ #if defined(unix) { - if (daemon_mode) + pid_t pid = 0; +#if 0 + int fd; +#endif + + if (!no_daemon) { - int fd; - pid_t pid = fork(); + pid = fork();
if ( pid < 0 ) /* error */ { @@ -3164,50 +3895,33 @@ int main(int argc, char **argv) exit( 0 ); } /* child */ - +#if 1 + /* Should be more portable, but not as well tested */ setsid(); - +#else /* !1 */ +#ifdef __FreeBSD__ + setpgrp(0,0); +#else /* ndef __FreeBSD__ */ + setpgrp(); +#endif /* ndef __FreeBSD__ */ + fd = open("/dev/tty", O_RDONLY); + if ( fd ) + { + /* no error check here */ + ioctl( fd, TIOCNOTTY,0 ); + close ( fd ); + } +#endif /* 1 */ /* * stderr (fd 2) will be closed later on, * when the config file has been parsed. */ - close(0); - close(1); - - /* - * Reserve fd 0 and 1 to prevent abort() and friends - * from sending stuff to the clients or servers. - */ - fd = open("/dev/null", O_RDONLY); - if (fd == -1) - { - log_error(LOG_LEVEL_FATAL, "Failed to open /dev/null: %E"); - } - else if (fd != 0) - { - if (dup2(fd, 0) == -1) - { - log_error(LOG_LEVEL_FATAL, "Failed to reserve fd 0: %E"); - } - close(fd); - } - fd = open("/dev/null", O_WRONLY); - if (fd == -1) - { - log_error(LOG_LEVEL_FATAL, "Failed to open /dev/null: %E"); - } - else if (fd != 1) - { - if (dup2(fd, 1) == -1) - { - log_error(LOG_LEVEL_FATAL, "Failed to reserve fd 1: %E"); - } - close(fd); - }
+ close( 0 ); + close( 1 ); chdir("/");
- } /* -END- if (daemon_mode) */ + } /* -END- if (!no_daemon) */
/* * As soon as we have written the PID file, we can switch @@ -3267,7 +3981,7 @@ int main(int argc, char **argv) if (putenv(putenv_dummy) != 0) { log_error(LOG_LEVEL_FATAL, "Cannot putenv(): HOME"); - } + }
snprintf(putenv_dummy, sizeof(putenv_dummy), "USER=%s", pw->pw_name); if (putenv(putenv_dummy) != 0) @@ -3288,7 +4002,7 @@ int main(int argc, char **argv) */ if (bRunAsService) { - /* Yup, so now we must attempt to establish a connection + /* Yup, so now we must attempt to establish a connection * with the service dispatcher. This will only work if this * process was launched by the service control manager to * actually run as a service. If this isn't the case, i've @@ -3330,124 +4044,58 @@ int main(int argc, char **argv) * on failure. * * Parameters : - * 1 : haddr = Host addres to bind to. Use NULL to bind to - * INADDR_ANY. - * 2 : hport = Specifies port to bind to. + * 1 : config = Privoxy configuration. Specifies port + * to bind to. * * Returns : Port that was opened. * *********************************************************************/ -static jb_socket bind_port_helper(const char *haddr, int hport) +static jb_socket bind_port_helper(struct configuration_spec * config) { int result; jb_socket bfd;
- result = bind_port(haddr, hport, &bfd); - - if (result < 0) - { - const char *bind_address = (NULL != haddr) ? haddr : "INADDR_ANY"; - switch(result) - { - case -3: - log_error(LOG_LEVEL_FATAL, - "can't bind to %s:%d: There may be another Privoxy " - "or some other proxy running on port %d", - bind_address, hport, hport); - - case -2: - log_error(LOG_LEVEL_FATAL, - "can't bind to %s:%d: The hostname is not resolvable", - bind_address, hport); - - default: - log_error(LOG_LEVEL_FATAL, "can't bind to %s:%d: %E", - bind_address, hport); - } - - /* shouldn't get here */ - return JB_INVALID_SOCKET; - } - - if (haddr == NULL) + if (config->haddr == NULL) { log_error(LOG_LEVEL_INFO, "Listening on port %d on all IP addresses", - hport); + config->hport); } else { log_error(LOG_LEVEL_INFO, "Listening on port %d on IP address %s", - hport, haddr); + config->hport, config->haddr); }
- return bfd; -} - - -/********************************************************************* - * - * Function : bind_ports_helper - * - * Description : Bind the listen ports. Handles logging, and aborts - * on failure. - * - * Parameters : - * 1 : config = Privoxy configuration. Specifies ports - * to bind to. - * 2 : sockets = Preallocated array of opened sockets - * corresponding to specification in config. - * All non-opened sockets will be set to - * JB_INVALID_SOCKET. - * - * Returns : Nothing. Inspect sockets argument. - * - *********************************************************************/ -static void bind_ports_helper(struct configuration_spec * config, - jb_socket sockets[]) -{ - int i; + result = bind_port(config->haddr, config->hport, &bfd);
- for (i = 0; i < MAX_LISTENING_SOCKETS; i++) + if (result < 0) { - if (config->hport[i]) - { - sockets[i] = bind_port_helper(config->haddr[i], config->hport[i]); - } - else + switch(result) { - sockets[i] = JB_INVALID_SOCKET; + case -3 : + log_error(LOG_LEVEL_FATAL, "can't bind to %s:%d: " + "There may be another Privoxy or some other " + "proxy running on port %d", + (NULL != config->haddr) ? config->haddr : "INADDR_ANY", + config->hport, config->hport); + + case -2 : + log_error(LOG_LEVEL_FATAL, "can't bind to %s:%d: " + "The hostname is not resolvable", + (NULL != config->haddr) ? config->haddr : "INADDR_ANY", config->hport); + + default : + log_error(LOG_LEVEL_FATAL, "can't bind to %s:%d: because %E", + (NULL != config->haddr) ? config->haddr : "INADDR_ANY", config->hport); } - } - config->need_bind = 0; -}
+ /* shouldn't get here */ + return JB_INVALID_SOCKET; + }
-/********************************************************************* - * - * Function : close_ports_helper - * - * Description : Close listenings ports. - * - * Parameters : - * 1 : sockets = Array of opened and non-opened sockets to - * close. All sockets will be set to - * JB_INVALID_SOCKET. - * - * Returns : Nothing. - * - *********************************************************************/ -static void close_ports_helper(jb_socket sockets[]) -{ - int i; + config->need_bind = 0;
- for (i = 0; i < MAX_LISTENING_SOCKETS; i++) - { - if (JB_INVALID_SOCKET != sockets[i]) - { - close_socket(sockets[i]); - } - sockets[i] = JB_INVALID_SOCKET; - } + return bfd; }
@@ -3475,23 +4123,21 @@ void w32_service_listen_loop(void *p) *********************************************************************/ static void listen_loop(void) { - struct client_states *csp_list = NULL; struct client_state *csp = NULL; - jb_socket bfds[MAX_LISTENING_SOCKETS]; - struct configuration_spec *config; - unsigned int active_threads = 0; + jb_socket bfd; + struct configuration_spec * config;
config = load_config();
-#ifdef FEATURE_CONNECTION_SHARING +#ifdef FEATURE_CONNECTION_KEEP_ALIVE /* * XXX: Should be relocated once it no * longer needs to emit log messages. */ initialize_reusable_connections(); -#endif /* def FEATURE_CONNECTION_SHARING */ +#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */
- bind_ports_helper(config, bfds); + bfd = bind_port_helper(config);
#ifdef FEATURE_GRACEFUL_TERMINATION while (!g_terminate) @@ -3509,7 +4155,7 @@ static void listen_loop(void) /* * Free data that was used by died threads */ - active_threads = sweep(); + sweep();
#if defined(unix) /* @@ -3525,47 +4171,22 @@ static void listen_loop(void) } #endif
- csp_list = (struct client_states *)zalloc(sizeof(*csp_list)); - if (NULL == csp_list) + if ( NULL == (csp = (struct client_state *) zalloc(sizeof(*csp))) ) { - log_error(LOG_LEVEL_FATAL, - "malloc(%d) for csp_list failed: %E", sizeof(*csp_list)); - continue; - } - csp = &csp_list->csp; - - log_error(LOG_LEVEL_CONNECT, "Listening for new connections ... "); - - if (!accept_connection(csp, bfds)) - { - log_error(LOG_LEVEL_CONNECT, "accept failed: %E"); - -#ifdef AMIGA - if(!childs) - { - exit(1); - } -#endif - freez(csp_list); + log_error(LOG_LEVEL_FATAL, "malloc(%d) for csp failed: %E", sizeof(*csp)); continue; } - else - { - log_error(LOG_LEVEL_CONNECT, - "accepted connection from %s on socket %d", - csp->ip_addr_str, csp->cfd); - }
csp->flags |= CSP_FLAG_ACTIVE; - csp->server_connection.sfd = JB_INVALID_SOCKET; + csp->sfd = JB_INVALID_SOCKET;
csp->config = config = load_config();
- if (config->need_bind) + if ( config->need_bind ) { /* * Since we were listening to the "old port", we will not see - * a "listen" param change until the next request. So, at + * a "listen" param change until the next IJB request. So, at * least 1 more request must be made for us to find the new * setting. I am simply closing the old socket and binding the * new one. @@ -3576,9 +4197,29 @@ static void listen_loop(void) * that this will hurt people's feelings. */
- close_ports_helper(bfds); + close_socket(bfd);
- bind_ports_helper(config, bfds); + bfd = bind_port_helper(config); + } + + log_error(LOG_LEVEL_CONNECT, "Listening for new connections ... "); + + if (!accept_connection(csp, bfd)) + { + log_error(LOG_LEVEL_CONNECT, "accept failed: %E"); + +#ifdef AMIGA + if(!childs) + { + exit(1); + } +#endif + freez(csp); + continue; + } + else + { + log_error(LOG_LEVEL_CONNECT, "accepted connection from %s", csp->ip_addr_str); }
#ifdef FEATURE_TOGGLE @@ -3597,38 +4238,22 @@ static void listen_loop(void) #ifdef FEATURE_ACL if (block_acl(NULL,csp)) { - log_error(LOG_LEVEL_CONNECT, - "Connection from %s on socket %d dropped due to ACL", csp->ip_addr_str, csp->cfd); + log_error(LOG_LEVEL_CONNECT, "Connection from %s dropped due to ACL", csp->ip_addr_str); close_socket(csp->cfd); - freez(csp->ip_addr_str); - freez(csp_list); + freez(csp); continue; } #endif /* def FEATURE_ACL */
- if ((0 != config->max_client_connections) - && (active_threads >= config->max_client_connections)) - { - log_error(LOG_LEVEL_CONNECT, - "Rejecting connection from %s. Maximum number of connections reached.", - csp->ip_addr_str); - write_socket(csp->cfd, TOO_MANY_CONNECTIONS_RESPONSE, - strlen(TOO_MANY_CONNECTIONS_RESPONSE)); - close_socket(csp->cfd); - freez(csp->ip_addr_str); - freez(csp_list); - continue; - } - /* add it to the list of clients */ - csp_list->next = clients->next; - clients->next = csp_list; + csp->next = clients->next; + clients->next = csp;
if (config->multi_threaded) { int child_id;
-/* this is a switch () statement in the C preprocessor - ugh */ +/* this is a switch () statment in the C preprocessor - ugh */ #undef SELECTED_ONE_OPTION
/* Use Pthreads in preference to native code */ @@ -3684,7 +4309,7 @@ static void listen_loop(void) #if defined(AMIGA) && !defined(SELECTED_ONE_OPTION) #define SELECTED_ONE_OPTION csp->cfd = ReleaseSocket(csp->cfd, -1); - + #ifdef __amigaos4__ child_id = (int)CreateNewProcTags(NP_Entry, (ULONG)server_thread, NP_Output, Output(), @@ -3725,7 +4350,7 @@ static void listen_loop(void)
serve(csp);
- /* + /* * If we've been toggled or we've blocked the request, tell Mom */
@@ -3736,7 +4361,7 @@ static void listen_loop(void) } #endif /* def FEATURE_TOGGLE */
-#ifdef FEATURE_STATISTICS +#ifdef FEATURE_STATISTICS if (csp->flags & CSP_FLAG_REJECTED) { rc |= RC_FLAG_BLOCKED; @@ -3756,7 +4381,7 @@ static void listen_loop(void)
wait( &child_status );
- /* + /* * Evaluate child's return code: If the child has * - been toggled, toggle ourselves * - blocked its request, bump up the stats counter @@ -3775,7 +4400,7 @@ static void listen_loop(void) { urls_rejected++; } -#endif /* def FEATURE_STATISTICS */ +#endif /* def FEATURE_STATISTICS */
#endif /* !defined(_WIN32) && defined(__CYGWIN__) */ close_socket(csp->cfd); @@ -3786,19 +4411,19 @@ static void listen_loop(void) #undef SELECTED_ONE_OPTION /* end of cpp switch () */
- if (child_id < 0) + if (child_id < 0) /* failed */ { - /* - * Spawning the child failed, assume it's because - * there are too many children running already. - * XXX: If you assume ... - */ - log_error(LOG_LEVEL_ERROR, - "Unable to take any additional connections: %E"); - write_socket(csp->cfd, TOO_MANY_CONNECTIONS_RESPONSE, - strlen(TOO_MANY_CONNECTIONS_RESPONSE)); + char buf[BUFFER_SIZE]; + + log_error(LOG_LEVEL_ERROR, "can't fork: %E"); + + snprintf(buf , sizeof(buf), "Privoxy: can't fork: errno = %d", errno); + + write_socket(csp->cfd, buf, strlen(buf)); close_socket(csp->cfd); csp->flags &= ~CSP_FLAG_ACTIVE; + sleep(5); + continue; } } else @@ -3841,6 +4466,7 @@ static void listen_loop(void) #if defined(unix) freez(basedir); #endif + freez(configfile);
#if defined(_WIN32) && !defined(_WIN_CONSOLE) /* Cleanup - remove taskbar icon etc. */ diff --git a/external/privoxy/jcc.h b/external/privoxy/jcc.h index 3e23661..add854c 100644 --- a/external/privoxy/jcc.h +++ b/external/privoxy/jcc.h @@ -1,21 +1,21 @@ #ifndef JCC_H_INCLUDED #define JCC_H_INCLUDED -#define JCC_H_VERSION "$Id: jcc.h,v 1.32 2011/11/06 11:48:23 fabiankeil Exp $" +#define JCC_H_VERSION "$Id: jcc.h,v 1.25 2008/10/09 18:21:41 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/jcc.h,v $ * - * Purpose : Main file. Contains main() method, main loop, and + * Purpose : Main file. Contains main() method, main loop, and * the main connection-handling function. * * Copyright : Written by and Copyright (C) 2001-2006 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -33,8 +33,143 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: jcc.h,v $ + * Revision 1.25 2008/10/09 18:21:41 fabiankeil + * Flush work-in-progress changes to keep outgoing connections + * alive where possible. Incomplete and mostly #ifdef'd out. + * + * Revision 1.24 2008/09/07 12:35:05 fabiankeil + * Add mutex lock support for _WIN32. + * + * Revision 1.23 2008/09/04 08:13:58 fabiankeil + * Prepare for critical sections on Windows by adding a + * layer of indirection before the pthread mutex functions. + * + * Revision 1.22 2007/06/01 18:16:36 fabiankeil + * Use the same mutex for gethostbyname() and gethostbyaddr() to prevent + * deadlocks and crashes on OpenBSD and possibly other OS with neither + * gethostbyname_r() nor gethostaddr_r(). Closes BR#1729174. + * Thanks to Ralf Horstmann for report and solution. + * + * Revision 1.21 2007/04/22 13:18:06 fabiankeil + * Keep the HTTP snippets local. + * + * Revision 1.20 2006/12/26 17:31:41 fabiankeil + * Mutex protect rand() if POSIX threading + * is used, warn the user if that's not possible + * and stop using it on _WIN32 where it could + * cause crashes. + * + * Revision 1.19 2006/12/06 19:41:39 fabiankeil + * Privoxy is now able to run as intercepting + * proxy in combination with any packet filter + * that does the port redirection. The destination + * is extracted from the "Host:" header which + * should be available for nearly all requests. + * + * Moved HTTP snipplets into jcc.c. + * Added error message for gopher proxy requests. + * + * Revision 1.18 2006/11/13 19:05:51 fabiankeil + * Make pthread mutex locking more generic. Instead of + * checking for OSX and OpenBSD, check for FEATURE_PTHREAD + * and use mutex locking unless there is an _r function + * available. Better safe than sorry. + * + * Fixes "./configure --disable-pthread" and should result + * in less threading-related problems on pthread-using platforms, + * but it still doesn't fix BR#1122404. + * + * Revision 1.17 2006/11/06 19:58:23 fabiankeil + * Move pthread.h inclusion from jcc.c to jcc.h. + * Fixes build on x86-freebsd1 (FreeBSD 5.4-RELEASE). + * + * Revision 1.16 2006/09/02 15:36:42 fabiankeil + * Follow the OpenBSD port's lead and protect the resolve + * functions on OpenBSD as well. + * + * Revision 1.15 2006/09/02 10:24:30 fabiankeil + * Include pthread.h for OpenBSD to make Privoxy build again. + * + * Tested shortly on OpenBSD 3.9 without problems, but the OpenBSD + * port has additional patches to use the mutexes OSX_DARWIN needs, + * and it should be investigated if they are still required for + * reliable operation. + * + * Revision 1.14 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.12.2.3 2006/01/21 16:16:08 david__schmidt + * Thanks to Edward Carrel for his patch to modernize OSX'spthreads support. See bug #1409623. + * + * Revision 1.12.2.2 2005/04/03 20:10:50 david__schmidt + * Thanks to Jindrich Makovicka for a race condition fix for the log + * file. The race condition remains for non-pthread implementations. + * Reference patch #1175720. + * + * Revision 1.12.2.1 2003/03/07 03:41:05 david__schmidt + * Wrapping all *_r functions (the non-_r versions of them) with mutex + * semaphores for OSX. Hopefully this will take care of all of those pesky + * crash reports. + * + * Revision 1.12 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.11 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.10 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.9 2002/03/07 03:52:44 oes + * Set logging to tty for --no-daemon mode + * + * Revision 1.8 2002/03/04 18:19:49 oes + * Added extern const char *pidfile + * + * Revision 1.7 2001/11/05 21:41:43 steudten + * Add changes to be a real daemon just for unix os. + * (change cwd to /, detach from controlling tty, set + * process group and session leader to the own process. + * Add DBG() Macro. + * Add some fatal-error log message for failed malloc(). + * Add '-d' if compiled with 'configure --with-debug' to + * enable debug output. + * + * Revision 1.6 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.5 2001/07/29 19:32:00 jongfoster + * Renaming _main() [mingw32 only] to real_main(), for ANSI compliance. + * + * Revision 1.4 2001/07/29 18:58:15 jongfoster + * Removing nested #includes, adding forward declarations for needed + * structures, and changing the #define _FILENAME_H to FILENAME_H_INCLUDED. + * + * Revision 1.3 2001/07/18 12:31:58 oes + * moved #define freez from jcc.h to project.h + * + * Revision 1.2 2001/05/31 21:24:47 jongfoster + * Changed "permission" to "action" throughout. + * Removed DEFAULT_USER_AGENT - it must now be specified manually. + * Moved vanilla wafer check into chat(), since we must now + * decide whether or not to add it based on the URL. + * + * Revision 1.1.1.1 2001/05/15 13:58:56 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -50,13 +185,13 @@ extern int urls_read; extern int urls_rejected; #endif /*def FEATURE_STATISTICS*/
-extern struct client_states clients[1]; +extern struct client_state clients[1]; extern struct file_list files[1];
#ifdef unix extern const char *pidfile; #endif -extern int daemon_mode; +extern int no_daemon;
#ifdef FEATURE_GRACEFUL_TERMINATION extern int g_terminate; @@ -104,9 +239,9 @@ extern privoxy_mutex_t rand_mutex; /* Functions */
#ifdef __MINGW32__ -int real_main(int argc, char **argv); +int real_main(int argc, const char *argv[]); #else -int main(int argc, char **argv); +int main(int argc, const char *argv[]); #endif
/* Revision control strings from this header and associated .c file */ diff --git a/external/privoxy/list.c b/external/privoxy/list.c index 487431a..c158129 100644 --- a/external/privoxy/list.c +++ b/external/privoxy/list.c @@ -1,4 +1,4 @@ -const char list_rcs[] = "$Id: list.c,v 1.25 2011/09/04 11:10:56 fabiankeil Exp $"; +const char list_rcs[] = "$Id: list.c,v 1.20 2007/05/14 16:56:07 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/list.c,v $ @@ -32,8 +32,110 @@ const char list_rcs[] = "$Id: list.c,v 1.25 2011/09/04 11:10:56 fabiankeil Exp $ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: list.c,v $ + * Revision 1.20 2007/05/14 16:56:07 fabiankeil + * - Stop using strcpy(). + * - enlist_unique_header() now behaves as advertised + * and checks for existing headers with the same name + * but ignores the values. + * + * Revision 1.19 2007/04/17 18:14:06 fabiankeil + * Add list_contains_item(). + * + * Revision 1.18 2006/12/28 19:21:23 fabiankeil + * Fixed gcc43 warning and enabled list_is_valid()'s loop + * detection again. It was ineffective since the removal of + * the arbitrary list length limit two years ago. + * + * Revision 1.17 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.15.2.2 2004/05/25 02:04:23 david__schmidt + * Removed the "arbitrary" 1000 filter limit in file.c. See tracker #911950. + * + * Revision 1.15.2.1 2002/11/28 18:14:54 oes + * Added unmap function that removes all items with a given + * name from a map. + * + * Revision 1.15 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.14 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.13 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.12 2001/10/25 03:40:48 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.11 2001/10/23 21:21:03 jongfoster + * New error handling - error codes are now jb_errs, not ints. + * Changed the way map() handles out-of-memory, to dramatically + * reduce the amount of error-checking clutter needed. + * + * Revision 1.10 2001/09/16 17:30:24 jongfoster + * Fixing a compiler warning. + * + * Revision 1.9 2001/09/16 13:20:29 jongfoster + * Rewrite of list library. Now has seperate header and list_entry + * structures. Also added a large sprinking of assert()s to the list + * code. + * + * Revision 1.8 2001/08/07 14:00:20 oes + * Fixed comment + * + * Revision 1.7 2001/08/05 16:06:20 jongfoster + * Modifiying "struct map" so that there are now separate header and + * "map_entry" structures. This means that functions which modify a + * map no longer need to return a pointer to the modified map. + * Also, it no longer reverses the order of the entries (which may be + * important with some advanced template substitutions). + * + * Revision 1.6 2001/07/31 14:44:51 oes + * list_to_text() now appends empty line at end + * + * Revision 1.5 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.4 2001/06/29 13:30:22 oes + * - Added Convenience function enlist_unique_header(), + * which takes the Header name and value as separate + * arguments and thus saves the pain of sprintf()ing + * and determining the Header name length to enlist_unique + * - Improved comments + * - Removed logentry from cancelled commit + * + * Revision 1.3 2001/06/03 19:12:24 oes + * functions for new struct map, extended enlist_unique + * + * Revision 1.2 2001/06/01 18:49:17 jongfoster + * Replaced "list_share" with "list" - the tiny memory gain was not + * worth the extra complexity. + * + * Revision 1.1 2001/05/31 21:11:53 jongfoster + * - Moved linked list support to new "list.c" file. + * Structure definitions are still in project.h, + * function prototypes are now in "list.h". + * - Added support for "struct list_share", which is identical + * to "struct list" except it saves memory by not duplicating + * the strings. Obviously, this only works if there is some + * other way of managing the memory used by the strings. + * (These list_share lists are used for lists which last + * for only 1 request, and where all the list entries are + * just coming directly from entries in the actionsfile.) + * Note that you still need to destroy list_share lists + * properly to free the nodes - it's only the strings + * which are shared. + * + * *********************************************************************/ - +
#include "config.h"
@@ -185,13 +287,13 @@ static int list_is_valid (const struct list *the_list) * Note that the 1000 limit was hit by a real user in tracker 911950; * removing it for now. Real circular references should eventually * be caught by the check above, anyway. - */ + */ /* if (entry > 1000) - { + { return 0; - } - */ + } + */
/* * Check this isn't marked as the last entry, unless of course it's @@ -496,7 +598,7 @@ char *list_to_text(const struct list *the_list) assert(list_is_valid(the_list));
/* - * Calculate the length of the final text. + * Calculate the lenght of the final text. * '2' because of the '\r\n' at the end of * each string and at the end of the text. */ @@ -839,7 +941,7 @@ int list_contains_item(const struct list *the_list, const char *str) if (entry->str == NULL) { /* - * NULL pointers are allowed in some lists. + * NULL pointers are allowed in some lists. * For example for csp->headers in case a * header was removed. */ @@ -921,7 +1023,7 @@ void free_map(struct map *the_map) * * Note: Since all strings will be free()d in free_map() * later, set the copy flags for constants or - * strings that will be independently free()d. + * strings that will be independantly free()d. * * Note2: This function allows NULL parameters - it * returns JB_ERR_MEMORY in that case. @@ -1040,7 +1142,7 @@ jb_err unmap(struct map *the_map, const char *name)
assert(the_map); assert(name); - + last_entry = the_map->first;
for (cur_entry = the_map->first; cur_entry != NULL; cur_entry = cur_entry->next) @@ -1060,13 +1162,13 @@ jb_err unmap(struct map *the_map, const char *name) }
/* - * Update the map's last pointer + * Update the map's last pointer */ if (cur_entry == the_map->last) { the_map->last = last_entry; } - + /* * Free the map_entry */ diff --git a/external/privoxy/list.h b/external/privoxy/list.h index 631145a..b116237 100644 --- a/external/privoxy/list.h +++ b/external/privoxy/list.h @@ -1,6 +1,6 @@ #ifndef LIST_H_INCLUDED #define LIST_H_INCLUDED -#define LIST_H_VERSION "$Id: list.h,v 1.18 2011/09/04 11:10:56 fabiankeil Exp $" +#define LIST_H_VERSION "$Id: list.h,v 1.15 2007/04/17 18:14:06 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/list.h,v $ @@ -13,10 +13,10 @@ * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -34,8 +34,82 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: list.h,v $ + * Revision 1.15 2007/04/17 18:14:06 fabiankeil + * Add list_contains_item(). + * + * Revision 1.14 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.12.2.1 2002/11/28 18:14:54 oes + * Added unmap function that removes all items with a given + * name from a map. + * + * Revision 1.12 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.11 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.10 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.9 2001/10/23 21:21:03 jongfoster + * New error handling - error codes are now jb_errs, not ints. + * Changed the way map() handles out-of-memory, to dramatically + * reduce the amount of error-checking clutter needed. + * + * Revision 1.8 2001/09/16 17:30:24 jongfoster + * Fixing a compiler warning. + * + * Revision 1.7 2001/09/16 13:20:29 jongfoster + * Rewrite of list library. Now has seperate header and list_entry + * structures. Also added a large sprinking of assert()s to the list + * code. + * + * Revision 1.6 2001/08/05 16:06:20 jongfoster + * Modifiying "struct map" so that there are now separate header and + * "map_entry" structures. This means that functions which modify a + * map no longer need to return a pointer to the modified map. + * Also, it no longer reverses the order of the entries (which may be + * important with some advanced template substitutions). + * + * Revision 1.5 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.4 2001/06/29 13:30:37 oes + * - Introduced enlist_unique_header() + * - Removed logentry from cancelled commit + * + * Revision 1.3 2001/06/03 11:03:48 oes + * introduced functions for new list type "map": map(), lookup(), + * free_map(), and extended enlist_unique + * + * Revision 1.2 2001/06/01 18:49:17 jongfoster + * Replaced "list_share" with "list" - the tiny memory gain was not + * worth the extra complexity. + * + * Revision 1.1 2001/05/31 21:11:53 jongfoster + * - Moved linked list support to new "list.c" file. + * Structure definitions are still in project.h, + * function prototypes are now in "list.h". + * - Added support for "struct list_share", which is identical + * to "struct list" except it saves memory by not duplicating + * the strings. Obviously, this only works if there is some + * other way of managing the memory used by the strings. + * (These list_share lists are used for lists which last + * for only 1 request, and where all the list entries are + * just coming directly from entries in the actionsfile.) + * Note that you still need to destroy list_share lists + * properly to free the nodes - it's only the strings + * which are shared. + * + * *********************************************************************/ - +
#include "project.h"
diff --git a/external/privoxy/loadcfg.c b/external/privoxy/loadcfg.c index 2082f17..c2e3bd1 100644 --- a/external/privoxy/loadcfg.c +++ b/external/privoxy/loadcfg.c @@ -1,4 +1,4 @@ -const char loadcfg_rcs[] = "$Id: loadcfg.c,v 1.121 2011/07/30 15:05:23 fabiankeil Exp $"; +const char loadcfg_rcs[] = "$Id: loadcfg.c,v 1.93 2009/03/18 21:46:26 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/loadcfg.c,v $ @@ -33,8 +33,491 @@ const char loadcfg_rcs[] = "$Id: loadcfg.c,v 1.121 2011/07/30 15:05:23 fabiankei * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: loadcfg.c,v $ + * Revision 1.93 2009/03/18 21:46:26 fabiankeil + * Revert the last commit as there's a better way. + * + * Revision 1.92 2009/03/18 20:43:19 fabiankeil + * Don't enable LOG_LEVEL_INFO by default and don't apply the user's + * debug settings until the logfile has been opened (if there is one). + * Patch submitted by Roland in #2624120. + * + * Revision 1.91 2009/03/09 17:29:08 fabiankeil + * As of r1.88, the show-status page can use a single line for + * warnings about ignored directives and the names of the ignored + * directives themselves. Reminded by Lee, finally closes #1856559. + * + * Revision 1.90 2009/03/07 17:58:02 fabiankeil + * Fix two mingw32-only buffer overflows. Note that triggering + * them requires control over the configuration file in which + * case all bets are off anyway. + * + * Revision 1.89 2009/03/01 18:46:33 fabiankeil + * - Help clang understand that we aren't + * dereferencing NULL pointers here. + * - Some style fixes in the modified region. + * + * Revision 1.88 2009/02/28 10:57:10 fabiankeil + * Gimme a break or two. Don't let the show-status page + * link to the website documentation for the user-manual + * directive itself. + * + * Revision 1.87 2009/02/15 07:56:13 fabiankeil + * Increase default socket timeout to 300 seconds. + * + * Revision 1.86 2009/02/08 19:18:57 fabiankeil + * Now that we have the match-all.action file, the other action + * files changed their position in config->actions_file[] back + * to the way it was before standard.action got removed and the + * changes from revision 1.84 have to be reverted. + * + * Revision 1.85 2009/01/22 12:06:26 fabiankeil + * Don't keep connections alive when running single-threaded. + * + * Revision 1.84 2009/01/14 16:14:36 fabiankeil + * Due to the standard.action file removal, the other action + * files changed their position in config->actions_file[]. + * Update mingw32 kludge accordingly. + * + * Revision 1.83 2008/12/20 14:53:55 fabiankeil + * Add config option socket-timeout to control the time + * Privoxy waits for data to arrive on a socket. Useful + * in case of stale ssh tunnels or when fuzz-testing. + * + * Revision 1.82 2008/11/16 12:43:49 fabiankeil + * Turn keep-alive support into a runtime feature + * that is disabled by setting keep-alive-timeout + * to a negative value. + * + * Revision 1.81 2008/11/13 09:08:42 fabiankeil + * Add new config option: keep-alive-timeout. + * + * Revision 1.80 2008/08/31 15:59:03 fabiankeil + * There's no reason to let remote toggling support depend + * on FEATURE_CGI_EDIT_ACTIONS, so make sure it doesn't. + * + * Revision 1.79 2008/08/30 12:03:07 fabiankeil + * Remove FEATURE_COOKIE_JAR. + * + * Revision 1.78 2008/08/02 08:23:22 fabiankeil + * If the enforce-blocks directive is used with FEATURE_FORCE_LOAD + * disabled, log a message that blocks will always be enforced + * instead of complaining about an unrecognized directive. + * Reported by Pietro Leone. + * + * Revision 1.77 2008/05/26 16:13:22 fabiankeil + * Reuse directive_hash and don't hash the same directive twice. + * + * Revision 1.76 2008/05/10 09:03:16 fabiankeil + * - Merge three string_append() calls. + * - Remove useless assertion. + * + * Revision 1.75 2008/03/30 14:52:05 fabiankeil + * Rename load_actions_file() and load_re_filterfile() + * as they load multiple files "now". + * + * Revision 1.74 2008/03/26 18:07:07 fabiankeil + * Add hostname directive. Closes PR#1918189. + * + * Revision 1.73 2008/02/16 16:54:51 fabiankeil + * Fix typo. + * + * Revision 1.72 2008/02/03 13:46:15 fabiankeil + * Add SOCKS5 support. Patch #1862863 by Eric M. Hopper with minor changes. + * + * Revision 1.71 2007/12/23 15:24:56 fabiankeil + * Reword "unrecognized directive" warning, use better + * mark up and add a <br>. Fixes parts of #1856559. + * + * Revision 1.70 2007/12/15 14:24:05 fabiankeil + * Plug memory leak if listen-address only specifies the port. + * + * Revision 1.69 2007/10/27 13:02:27 fabiankeil + * Relocate daemon-mode-related log messages to make sure + * they aren't shown again in case of configuration reloads. + * + * Revision 1.68 2007/10/19 16:32:34 fabiankeil + * Plug memory leak introduced with my last commit. + * + * Revision 1.67 2007/10/14 14:12:41 fabiankeil + * When in daemon mode, close stderr after the configuration file has been + * parsed the first time. If logfile isn't set, stop logging. Fixes BR#897436. + * + * Revision 1.66 2007/08/05 14:02:09 fabiankeil + * #1763173 from Stefan Huehner: declare unload_configfile() static. + * + * Revision 1.65 2007/07/21 11:51:36 fabiankeil + * As Hal noticed, checking dispatch_cgi() as the last cruncher + * looks like a bug if CGI requests are blocked unintentionally, + * so don't do it unless the user enabled the new config option + * "allow-cgi-request-crunching". + * + * Revision 1.64 2007/05/21 10:44:08 fabiankeil + * - Use strlcpy() instead of strcpy(). + * - Stop treating actions files special. Expect a complete file name + * (with or without path) like it's done for the rest of the files. + * Closes FR#588084. + * - Remove an unnecessary temporary memory allocation. + * - Don't log anything to the console when running as + * daemon and no errors occurred. + * + * Revision 1.63 2007/04/09 18:11:36 fabiankeil + * Don't mistake VC++'s _snprintf() for a snprintf() replacement. + * + * Revision 1.62 2007/03/17 15:20:05 fabiankeil + * New config option: enforce-blocks. + * + * Revision 1.61 2007/03/16 16:47:35 fabiankeil + * - Mention other reasons why acl directive loading might have failed. + * - Don't log the acl source if the acl destination is to blame. + * + * Revision 1.60 2007/01/27 13:09:16 fabiankeil + * Add new config option "templdir" to + * change the templates directory. + * + * Revision 1.59 2006/12/31 17:56:38 fabiankeil + * Added config option accept-intercepted-requests + * and disabled it by default. + * + * Revision 1.58 2006/12/31 14:24:29 fabiankeil + * Fix gcc43 compiler warnings. + * + * Revision 1.57 2006/12/21 12:57:48 fabiankeil + * Add config option "split-large-forms" + * to work around the browser bug reported + * in BR #1570678. + * + * Revision 1.56 2006/12/17 17:04:51 fabiankeil + * Move the <br> in the generated HTML for the config + * options from the beginning of the string to its end. + * Keeps the white space in balance. + * + * Revision 1.55 2006/11/28 15:31:52 fabiankeil + * Fix memory leak in case of config file reloads. + * + * Revision 1.54 2006/10/21 16:04:22 fabiankeil + * Modified kludge for win32 to make ming32 menu + * "Options/Edit Filters" (sort of) work again. + * Same limitations as for the action files apply. + * Fixes BR 1567373. + * + * Revision 1.53 2006/09/06 18:45:03 fabiankeil + * Incorporate modified version of Roland Rosenfeld's patch to + * optionally access the user-manual via Privoxy. Closes patch 679075. + * + * Formatting changed to Privoxy style, added call to + * cgi_error_no_template if the requested file doesn't + * exist and modified check whether or not Privoxy itself + * should serve the manual. Should work cross-platform now. + * + * Revision 1.52 2006/09/06 10:43:32 fabiankeil + * Added config option enable-remote-http-toggle + * to specify if Privoxy should recognize special + * headers (currently only X-Filter) to change its + * behaviour. Disabled by default. + * + * Revision 1.51 2006/09/06 09:23:37 fabiankeil + * Make number of retries in case of forwarded-connect problems + * a config file option (forwarded-connect-retries) and use 0 as + * default. + * + * Revision 1.50 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.48.2.7 2006/02/02 17:29:16 david__schmidt + * Don't forget to malloc space for the null terminator... + * + * Revision 1.48.2.6 2006/01/29 23:10:56 david__schmidt + * Multiple filter file support + * + * Revision 1.48.2.5 2003/05/08 15:17:25 oes + * Closed two memory leaks; hopefully the last remaining ones + * (in the main execution paths, anyway). + * + * Revision 1.48.2.4 2003/04/11 12:06:14 oes + * Addressed bug #719435 + * - Extraneous filterfile directives now logged as errors + * - This and unrecnonised directives now really obvious on status page + * + * Revision 1.48.2.3 2003/03/11 11:53:59 oes + * Cosmetic: Renamed cryptic variable + * + * Revision 1.48.2.2 2002/11/12 16:28:20 oes + * Move unrelated variable declaration out of #ifdef FEATURE_ACL; fixes bug #636655 + * + * Revision 1.48.2.1 2002/08/21 17:58:05 oes + * Temp kludge to let user and default action file be edited through win32 GUI (FR 592080) + * + * Revision 1.48 2002/05/14 21:30:38 oes + * savearg now uses own linking code instead of (now special-cased) add_help_link + * + * Revision 1.47 2002/05/12 21:36:29 jongfoster + * Correcting function comments + * + * Revision 1.46 2002/04/26 12:55:14 oes + * - New option "user-manual", defaults to our site + * via project.h #define + * - savearg now embeds option names in help links + * + * Revision 1.45 2002/04/24 02:11:54 oes + * Jon's multiple AF patch: Allow up to MAX_AF_FILES actionsfile options + * + * Revision 1.44 2002/04/08 20:37:13 swa + * fixed JB spelling + * + * Revision 1.43 2002/04/08 20:36:50 swa + * fixed JB spelling + * + * Revision 1.42 2002/04/05 15:50:15 oes + * fix for invalid HTML proxy_args + * + * Revision 1.41 2002/03/31 17:19:00 jongfoster + * Win32 only: Enabling STRICT to fix a VC++ compile warning. + * + * Revision 1.40 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.39 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.38 2002/03/24 13:05:48 jongfoster + * Renaming re_filterfile to filterfile + * + * Revision 1.37 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.36 2002/03/13 00:27:05 jongfoster + * Killing warnings + * + * Revision 1.35 2002/03/07 03:52:44 oes + * Set logging to tty for --no-daemon mode + * + * Revision 1.34 2002/03/06 23:14:35 jongfoster + * Trivial cosmetic changes to make function comments easier to find. + * + * Revision 1.33 2002/03/05 04:52:42 oes + * Deleted non-errlog debugging code + * + * Revision 1.32 2002/03/04 18:24:53 oes + * Re-enabled output of unknown config directive hash + * + * Revision 1.31 2002/03/03 15:07:20 oes + * Re-enabled automatic config reloading + * + * Revision 1.30 2002/01/22 23:31:43 jongfoster + * Replacing strsav() with string_append() + * + * Revision 1.29 2002/01/17 21:02:30 jongfoster + * Moving all our URL and URL pattern parsing code to urlmatch.c. + * + * Renaming free_url to free_url_spec, since it frees a struct url_spec. + * + * Revision 1.28 2001/12/30 14:07:32 steudten + * - Add signal handling (unix) + * - Add SIGHUP handler (unix) + * - Add creation of pidfile (unix) + * - Add action 'top' in rc file (RH) + * - Add entry 'SIGNALS' to manpage + * - Add exit message to logfile (unix) + * + * Revision 1.27 2001/11/07 00:02:13 steudten + * Add line number in error output for lineparsing for + * actionsfile and configfile. + * Special handling for CLF added. + * + * Revision 1.26 2001/11/05 21:41:43 steudten + * Add changes to be a real daemon just for unix os. + * (change cwd to /, detach from controlling tty, set + * process group and session leader to the own process. + * Add DBG() Macro. + * Add some fatal-error log message for failed malloc(). + * Add '-d' if compiled with 'configure --with-debug' to + * enable debug output. + * + * Revision 1.25 2001/10/25 03:40:48 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.24 2001/10/23 21:40:30 jongfoster + * Added support for enable-edit-actions and enable-remote-toggle config + * file options. + * + * Revision 1.23 2001/10/07 15:36:00 oes + * Introduced new config option "buffer-limit" + * + * Revision 1.22 2001/09/22 16:36:59 jongfoster + * Removing unused parameter fs from read_config_line() + * + * Revision 1.21 2001/09/16 17:10:43 jongfoster + * Moving function savearg() here, since it was the only thing left in + * showargs.c. + * + * Revision 1.20 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.19 2001/07/15 17:45:16 jongfoster + * Removing some unused #includes + * + * Revision 1.18 2001/07/13 14:01:14 oes + * - Removed all #ifdef PCRS + * - Removed vim-settings + * + * Revision 1.17 2001/06/29 13:31:03 oes + * - Improved comments + * - Fixed (actionsfile) and sorted hashes + * - Introduced admin_address and proxy-info-url + * as config parameters + * - Renamed config->proxy_args_invocation (which didn't have + * the invocation but the options!) to config->proxy_args + * - Various adaptions + * - Removed logentry from cancelled commit + * + * Revision 1.16 2001/06/09 10:55:28 jongfoster + * Changing BUFSIZ ==> BUFFER_SIZE + * + * Revision 1.15 2001/06/07 23:13:40 jongfoster + * Merging ACL and forward files into config file. + * Cosmetic: Sorting config file options alphabetically. + * Cosmetic: Adding brief syntax comments to config file options. + * + * Revision 1.14 2001/06/07 14:46:25 joergs + * Missing make_path() added for re_filterfile. + * + * Revision 1.13 2001/06/05 22:33:54 jongfoster + * + * Fixed minor memory leak. + * Also now uses make_path to prepend the pathnames. + * + * Revision 1.12 2001/06/05 20:04:09 jongfoster + * Now uses _snprintf() in place of snprintf() under Win32. + * + * Revision 1.11 2001/06/04 18:31:58 swa + * files are now prefixed with either `confdir' or `logdir'. + * `make redhat-dist' replaces both entries confdir and logdir + * with redhat values + * + * Revision 1.10 2001/06/03 19:11:54 oes + * introduced confdir option + * + * Revision 1.9 2001/06/01 20:06:24 jongfoster + * Removed support for "tinygif" option - moved to actions file. + * + * Revision 1.8 2001/05/31 21:27:13 jongfoster + * Removed many options from the config file and into the + * "actions" file: add_forwarded, suppress_vanilla_wafer, + * wafer, add_header, user_agent, referer, from + * Also globally replaced "permission" with "action". + * + * Revision 1.7 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.6 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.5 2001/05/25 22:34:30 jongfoster + * Hard tabs->Spaces + * + * Revision 1.4 2001/05/22 18:46:04 oes + * + * - Enabled filtering banners by size rather than URL + * by adding patterns that replace all standard banner + * sizes with the "Junkbuster" gif to the re_filterfile + * + * - Enabled filtering WebBugs by providing a pattern + * which kills all 1x1 images + * + * - Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * - Added a new interceptor ijb-send-banner, which + * sends back the "Junkbuster" gif. Without imagelist or + * MSIE detection support, or if tinygif = 1, or the + * URL isn't recognized as an imageurl, a lame HTML + * explanation is sent instead. + * + * - Added new feature, which permits blocking remote + * script redirects and firing back a local redirect + * to the browser. + * The feature is conditionally compiled, i.e. it + * can be disabled with --disable-fast-redirects, + * plus it must be activated by a "fast-redirects" + * line in the config file, has its own log level + * and of course wants to be displayed by show-proxy-args + * Note: Boy, all the #ifdefs in 1001 locations and + * all the fumbling with configure.in and acconfig.h + * were *way* more work than the feature itself :-( + * + * - Because a generic redirect template was needed for + * this, tinygif = 3 now uses the same. + * + * - Moved GIFs, and other static HTTP response templates + * to project.h + * + * - Some minor fixes + * + * - Removed some >400 CRs again (Jon, you really worked + * a lot! ;-) + * + * Revision 1.3 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.2 2001/05/17 23:01:01 oes + * - Cleaned CRLF's from the sources and related files + * + * Revision 1.1.1.1 2001/05/15 13:58:58 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -111,7 +594,7 @@ const char *configfile = NULL; * so we will make argc and argv global. */ int Argc = 0; -char * const * Argv = NULL; +const char **Argv = NULL;
static struct file_list *current_configfile = NULL;
@@ -133,14 +616,10 @@ static struct file_list *current_configfile = NULL; #define hash_admin_address 4112573064ul /* "admin-address" */ #define hash_allow_cgi_request_crunching 258915987ul /* "allow-cgi-request-crunching" */ #define hash_buffer_limit 1881726070ul /* "buffer-limit */ -#define hash_compression_level 2464423563ul /* "compression-level" */ #define hash_confdir 1978389ul /* "confdir" */ -#define hash_connection_sharing 1348841265ul /* "connection-sharing" */ #define hash_debug 78263ul /* "debug" */ -#define hash_default_server_timeout 2530089913ul /* "default-server-timeout" */ #define hash_deny_access 1227333715ul /* "deny-access" */ #define hash_enable_edit_actions 2517097536ul /* "enable-edit-actions" */ -#define hash_enable_compression 3943696946ul /* "enable-compression" */ #define hash_enable_remote_toggle 2979744683ul /* "enable-remote-toggle" */ #define hash_enable_remote_http_toggle 110543988ul /* "enable-remote-http-toggle" */ #define hash_enforce_blocks 1862427469ul /* "enforce-blocks" */ @@ -150,13 +629,11 @@ static struct file_list *current_configfile = NULL; #define hash_forward_socks4a 2639958518ul /* "forward-socks4a" */ #define hash_forward_socks5 3963965522ul /* "forward-socks5" */ #define hash_forwarded_connect_retries 101465292ul /* "forwarded-connect-retries" */ -#define hash_handle_as_empty_returns_ok 1444873247ul /* "handle-as-empty-doc-returns-ok" */ #define hash_hostname 10308071ul /* "hostname" */ #define hash_keep_alive_timeout 3878599515ul /* "keep-alive-timeout" */ #define hash_listen_address 1255650842ul /* "listen-address" */ #define hash_logdir 422889ul /* "logdir" */ #define hash_logfile 2114766ul /* "logfile" */ -#define hash_max_client_connections 3595884446ul /* "max-client-connections" */ #define hash_permit_access 3587953268ul /* "permit-access" */ #define hash_proxy_info_url 3903079059ul /* "proxy-info-url" */ #define hash_single_threaded 4250084780ul /* "single-threaded" */ @@ -229,10 +706,7 @@ static void unload_configfile (void * data) freez(config->templdir); freez(config->hostname);
- for (i = 0; i < MAX_LISTENING_SOCKETS; i++) - { - freez(config->haddr[i]); - } + freez(config->haddr); freez(config->logfile);
for (i = 0; i < MAX_AF_FILES; i++) @@ -253,6 +727,11 @@ static void unload_configfile (void * data) list_remove_all(config->trust_info); #endif /* def FEATURE_TRUST */
+ for (i = 0; i < MAX_AF_FILES; i++) + { + freez(config->re_filterfile[i]); + } + freez(config); }
@@ -283,51 +762,6 @@ void unload_current_config_file(void)
/********************************************************************* * - * Function : parse_toggle_value - * - * Description : Parse the value of a directive that can only be - * enabled or disabled. Terminates with a fatal error - * if the value is NULL or something other than 0 or 1. - * - * Parameters : - * 1 : name: The name of the directive. Used for log messages. - * 2 : value: The value to parse - * - * - * Returns : The numerical toggle state - * - *********************************************************************/ -static int parse_toggle_state(const char *name, const char *value) -{ - int toggle_state; - assert(name != NULL); - assert(value != NULL); - - if ((value == NULL) || (*value == '\0')) - { - log_error(LOG_LEVEL_FATAL, "Directive %s used without argument", name); - } - - toggle_state = atoi(value); - - /* - * Also check the length as atoi() doesn't mind - * garbage after a valid integer, but we do. - */ - if (((toggle_state != 0) && (toggle_state != 1)) || (strlen(value) != 1)) - { - log_error(LOG_LEVEL_FATAL, - "Directive %s used with invalid argument '%s'. Use either '0' or '1'.", - name, value); - } - - return toggle_state; - -} - - -/********************************************************************* - * * Function : load_config * * Description : Load the config file and all parameters. @@ -342,7 +776,7 @@ static int parse_toggle_state(const char *name, const char *value) *********************************************************************/ struct configuration_spec * load_config(void) { - char *buf = NULL; + char buf[BUFFER_SIZE]; char *p, *q; FILE *configfp = NULL; struct configuration_spec * config = NULL; @@ -351,6 +785,9 @@ struct configuration_spec * load_config(void) unsigned long linenum = 0; int i; char *logfile = NULL; +#ifdef FEATURE_CONNECTION_KEEP_ALIVE + int keep_alive_timeout = DEFAULT_KEEP_ALIVE_TIMEOUT; +#endif
if (!check_file_changed(current_configfile, configfile, &fs)) { @@ -398,29 +835,15 @@ struct configuration_spec * load_config(void) * Set to defaults */ config->multi_threaded = 1; + config->hport = HADDR_PORT; config->buffer_limit = 4096 * 1024; config->usermanual = strdup(USER_MANUAL_URL); config->proxy_args = strdup(""); config->forwarded_connect_retries = 0; - config->max_client_connections = 0; config->socket_timeout = 300; /* XXX: Should be a macro. */ -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - config->default_server_timeout = 0; - config->keep_alive_timeout = DEFAULT_KEEP_ALIVE_TIMEOUT; - config->feature_flags &= ~RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE; - config->feature_flags &= ~RUNTIME_FEATURE_CONNECTION_SHARING; -#endif config->feature_flags &= ~RUNTIME_FEATURE_CGI_TOGGLE; config->feature_flags &= ~RUNTIME_FEATURE_SPLIT_LARGE_FORMS; config->feature_flags &= ~RUNTIME_FEATURE_ACCEPT_INTERCEPTED_REQUESTS; - config->feature_flags &= ~RUNTIME_FEATURE_EMPTY_DOC_RETURNS_OK; -#ifdef FEATURE_COMPRESSION - config->feature_flags &= ~RUNTIME_FEATURE_COMPRESSION; - /* - * XXX: Run some benchmarks to see if there are better default values. - */ - config->compression_level = 1; -#endif
configfp = fopen(configfile, "r"); if (NULL == configfp) @@ -430,7 +853,7 @@ struct configuration_spec * load_config(void) /* Never get here - LOG_LEVEL_FATAL causes program exit */ }
- while (read_config_line(configfp, &linenum, &buf) != NULL) + while (read_config_line(buf, sizeof(buf), configfp, &linenum) != NULL) { char cmd[BUFFER_SIZE]; char arg[BUFFER_SIZE]; @@ -461,15 +884,11 @@ struct configuration_spec * load_config(void) }
/* Copy the argument into arg */ - if (strlcpy(arg, p, sizeof(arg)) >= sizeof(arg)) - { - log_error(LOG_LEVEL_FATAL, "Config line too long: %s", buf); - } + strlcpy(arg, p, sizeof(arg));
/* Should never happen, but check this anyway */ if (*cmd == '\0') { - freez(buf); continue; }
@@ -510,7 +929,7 @@ struct configuration_spec * load_config(void) * accept-intercepted-requests * *************************************************************************/ case hash_accept_intercepted_requests: - if (parse_toggle_state(cmd, arg) == 1) + if ((*arg != '\0') && (0 != atoi(arg))) { config->feature_flags |= RUNTIME_FEATURE_ACCEPT_INTERCEPTED_REQUESTS; } @@ -532,7 +951,7 @@ struct configuration_spec * load_config(void) * allow-cgi-request-crunching * *************************************************************************/ case hash_allow_cgi_request_crunching: - if (parse_toggle_state(cmd, arg) == 1) + if ((*arg != '\0') && (0 != atoi(arg))) { config->feature_flags |= RUNTIME_FEATURE_CGI_CRUNCHING; } @@ -558,48 +977,6 @@ struct configuration_spec * load_config(void) break;
/* ************************************************************************* - * compression-level 0-9 - * *************************************************************************/ -#ifdef FEATURE_COMPRESSION - case hash_compression_level : - if (*arg != '\0') - { - int compression_level = atoi(arg); - if (-1 <= compression_level && compression_level <= 9) - { - config->compression_level = compression_level;; - } - else - { - log_error(LOG_LEVEL_FATAL, - "Invalid compression-level value: %s", arg); - } - } - else - { - log_error(LOG_LEVEL_FATAL, - "Invalid compression-level directive. Compression value missing"); - } - break; -#endif - -/* ************************************************************************* - * connection-sharing (0|1) - * *************************************************************************/ -#ifdef FEATURE_CONNECTION_SHARING - case hash_connection_sharing : - if (parse_toggle_state(cmd, arg) == 1) - { - config->feature_flags |= RUNTIME_FEATURE_CONNECTION_SHARING; - } - else - { - config->feature_flags &= ~RUNTIME_FEATURE_CONNECTION_SHARING; - } - break; -#endif - -/* ************************************************************************* * debug n * Specifies debug level, multiple values are ORed together. * *************************************************************************/ @@ -608,27 +985,6 @@ struct configuration_spec * load_config(void) break;
/* ************************************************************************* - * default-server-timeout timeout - * *************************************************************************/ -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - case hash_default_server_timeout : - if (*arg != '\0') - { - int timeout = atoi(arg); - if (0 < timeout) - { - config->default_server_timeout = (unsigned int)timeout; - } - else - { - log_error(LOG_LEVEL_FATAL, - "Invalid default-server-timeout value: %s", arg); - } - } - break; -#endif - -/* ************************************************************************* * deny-access source-ip[/significant-bits] [dest-ip[/significant-bits]] * *************************************************************************/ #ifdef FEATURE_ACL @@ -688,12 +1044,6 @@ struct configuration_spec * load_config(void) break; } } -#ifdef HAVE_RFC2553 - else - { - cur_acl->wildcard_dst = 1; - } -#endif /* def HAVE_RFC2553 */
/* * Add it to the list. Note we reverse the list to get the @@ -715,7 +1065,7 @@ struct configuration_spec * load_config(void) * *************************************************************************/ #ifdef FEATURE_CGI_EDIT_ACTIONS case hash_enable_edit_actions: - if (parse_toggle_state(cmd, arg) == 1) + if ((*arg != '\0') && (0 != atoi(arg))) { config->feature_flags |= RUNTIME_FEATURE_CGI_EDIT_ACTIONS; } @@ -727,28 +1077,11 @@ struct configuration_spec * load_config(void) #endif /* def FEATURE_CGI_EDIT_ACTIONS */
/* ************************************************************************* - * enable-compression 0|1 - * *************************************************************************/ -#ifdef FEATURE_COMPRESSION - case hash_enable_compression: - if (parse_toggle_state(cmd, arg) == 1) - { - config->feature_flags |= RUNTIME_FEATURE_COMPRESSION; - } - else - { - config->feature_flags &= ~RUNTIME_FEATURE_COMPRESSION; - } - break; -#endif /* def FEATURE_COMPRESSION */ - - -/* ************************************************************************* * enable-remote-toggle 0|1 * *************************************************************************/ #ifdef FEATURE_TOGGLE case hash_enable_remote_toggle: - if (parse_toggle_state(cmd, arg) == 1) + if ((*arg != '\0') && (0 != atoi(arg))) { config->feature_flags |= RUNTIME_FEATURE_CGI_TOGGLE; } @@ -763,7 +1096,7 @@ struct configuration_spec * load_config(void) * enable-remote-http-toggle 0|1 * *************************************************************************/ case hash_enable_remote_http_toggle: - if (parse_toggle_state(cmd, arg) == 1) + if ((*arg != '\0') && (0 != atoi(arg))) { config->feature_flags |= RUNTIME_FEATURE_HTTP_TOGGLE; } @@ -778,7 +1111,7 @@ struct configuration_spec * load_config(void) * *************************************************************************/ case hash_enforce_blocks: #ifdef FEATURE_FORCE_LOAD - if (parse_toggle_state(cmd, arg) == 1) + if ((*arg != '\0') && (0 != atoi(arg))) { config->feature_flags |= RUNTIME_FEATURE_ENFORCE_BLOCKS; } @@ -858,9 +1191,18 @@ struct configuration_spec * load_config(void)
if (strcmp(p, ".") != 0) { - cur_fwd->forward_port = 8000; - parse_forwarder_address(p, &cur_fwd->forward_host, - &cur_fwd->forward_port); + cur_fwd->forward_host = strdup(p); + + if (NULL != (p = strchr(cur_fwd->forward_host, ':'))) + { + *p++ = '\0'; + cur_fwd->forward_port = atoi(p); + } + + if (cur_fwd->forward_port <= 0) + { + cur_fwd->forward_port = 8000; + } }
/* Add to list. */ @@ -911,12 +1253,19 @@ struct configuration_spec * load_config(void) /* Parse the SOCKS proxy host[:port] */ p = vec[1];
- /* XXX: This check looks like a bug. */ if (strcmp(p, ".") != 0) { - cur_fwd->gateway_port = 1080; - parse_forwarder_address(p, &cur_fwd->gateway_host, - &cur_fwd->gateway_port); + cur_fwd->gateway_host = strdup(p); + + if (NULL != (p = strchr(cur_fwd->gateway_host, ':'))) + { + *p++ = '\0'; + cur_fwd->gateway_port = atoi(p); + } + if (cur_fwd->gateway_port <= 0) + { + cur_fwd->gateway_port = 1080; + } }
/* Parse the parent HTTP proxy host[:port] */ @@ -924,9 +1273,18 @@ struct configuration_spec * load_config(void)
if (strcmp(p, ".") != 0) { - cur_fwd->forward_port = 8000; - parse_forwarder_address(p, &cur_fwd->forward_host, - &cur_fwd->forward_port); + cur_fwd->forward_host = strdup(p); + + if (NULL != (p = strchr(cur_fwd->forward_host, ':'))) + { + *p++ = '\0'; + cur_fwd->forward_port = atoi(p); + } + + if (cur_fwd->forward_port <= 0) + { + cur_fwd->forward_port = 8000; + } }
/* Add to list. */ @@ -985,18 +1343,35 @@ struct configuration_spec * load_config(void) /* Parse the SOCKS proxy host[:port] */ p = vec[1];
- cur_fwd->gateway_port = 1080; - parse_forwarder_address(p, &cur_fwd->gateway_host, - &cur_fwd->gateway_port); + cur_fwd->gateway_host = strdup(p); + + if (NULL != (p = strchr(cur_fwd->gateway_host, ':'))) + { + *p++ = '\0'; + cur_fwd->gateway_port = atoi(p); + } + if (cur_fwd->gateway_port <= 0) + { + cur_fwd->gateway_port = 1080; + }
/* Parse the parent HTTP proxy host[:port] */ p = vec[2];
if (strcmp(p, ".") != 0) { - cur_fwd->forward_port = 8000; - parse_forwarder_address(p, &cur_fwd->forward_host, - &cur_fwd->forward_port); + cur_fwd->forward_host = strdup(p); + + if (NULL != (p = strchr(cur_fwd->forward_host, ':'))) + { + *p++ = '\0'; + cur_fwd->forward_port = atoi(p); + } + + if (cur_fwd->forward_port <= 0) + { + cur_fwd->forward_port = 8000; + } }
/* Add to list. */ @@ -1013,26 +1388,6 @@ struct configuration_spec * load_config(void) break;
/* ************************************************************************* - * handle-as-empty-doc-returns-ok 0|1 - * - * Workaround for firefox hanging on blocked javascript pages. - * Block with the "+handle-as-empty-document" flag and set the - * "handle-as-empty-doc-returns-ok" run-time config flag so that - * Privoxy returns a 200/OK status instead of a 403/Forbidden status - * to the browser for blocked pages. - ***************************************************************************/ - case hash_handle_as_empty_returns_ok: - if (parse_toggle_state(cmd, arg) == 1) - { - config->feature_flags |= RUNTIME_FEATURE_EMPTY_DOC_RETURNS_OK; - } - else - { - config->feature_flags &= ~RUNTIME_FEATURE_EMPTY_DOC_RETURNS_OK; - } - break; - -/* ************************************************************************* * hostname hostname-to-show-on-cgi-pages * *************************************************************************/ case hash_hostname : @@ -1052,10 +1407,10 @@ struct configuration_spec * load_config(void) if (*arg != '\0') { int timeout = atoi(arg); - if (0 < timeout) + if (0 <= timeout) { config->feature_flags |= RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE; - config->keep_alive_timeout = (unsigned int)timeout; + keep_alive_timeout = timeout; } else { @@ -1069,23 +1424,8 @@ struct configuration_spec * load_config(void) * listen-address [ip][:port] * *************************************************************************/ case hash_listen_address : - i = 0; - while ((i < MAX_LISTENING_SOCKETS) && (NULL != config->haddr[i])) - { - i++; - } - - if (i >= MAX_LISTENING_SOCKETS) - { - log_error(LOG_LEVEL_FATAL, "Too many 'listen-address' directives in config file - limit is %d.\n" - "(You can increase this limit by changing MAX_LISTENING_SOCKETS in project.h and recompiling).", - MAX_LISTENING_SOCKETS); - } - config->haddr[i] = strdup(arg); - if (NULL == config->haddr[i]) - { - log_error(LOG_LEVEL_FATAL, "Out of memory while copying listening address"); - } + freez(config->haddr); + config->haddr = strdup(arg); break;
/* ************************************************************************* @@ -1101,7 +1441,7 @@ struct configuration_spec * load_config(void) * In logdir by default * *************************************************************************/ case hash_logfile : - if (daemon_mode) + if (!no_daemon) { logfile = make_path(config->logdir, arg); if (NULL == logfile) @@ -1112,20 +1452,6 @@ struct configuration_spec * load_config(void) break;
/* ************************************************************************* - * max-client-connections number - * *************************************************************************/ - case hash_max_client_connections : - if (*arg != '\0') - { - int max_client_connections = atoi(arg); - if (0 <= max_client_connections) - { - config->max_client_connections = max_client_connections; - } - } - break; - -/* ************************************************************************* * permit-access source-ip[/significant-bits] [dest-ip[/significant-bits]] * *************************************************************************/ #ifdef FEATURE_ACL @@ -1186,12 +1512,6 @@ struct configuration_spec * load_config(void) break; } } -#ifdef HAVE_RFC2553 - else - { - cur_acl->wildcard_dst = 1; - } -#endif /* def HAVE_RFC2553 */
/* * Add it to the list. Note we reverse the list to get the @@ -1246,7 +1566,7 @@ struct configuration_spec * load_config(void) * split-large-cgi-forms * *************************************************************************/ case hash_split_large_cgi_forms : - if (parse_toggle_state(cmd, arg) == 1) + if ((*arg != '\0') && (0 != atoi(arg))) { config->feature_flags |= RUNTIME_FEATURE_SPLIT_LARGE_FORMS; } @@ -1458,7 +1778,7 @@ struct configuration_spec * load_config(void)
/* Save the argument for the show-status page. */ savearg(cmd, arg, config); - freez(buf); + } /* end while ( read_config_line(...) ) */
fclose(configfp); @@ -1467,7 +1787,7 @@ struct configuration_spec * load_config(void)
freez(config->logfile);
- if (daemon_mode) + if (!no_daemon) { if (NULL != logfile) { @@ -1481,21 +1801,11 @@ struct configuration_spec * load_config(void) }
#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if (config->default_server_timeout > config->keep_alive_timeout) - { - log_error(LOG_LEVEL_ERROR, - "Reducing the default-server-timeout from %d to the keep-alive-timeout %d.", - config->default_server_timeout, config->keep_alive_timeout); - config->default_server_timeout = config->keep_alive_timeout; - } -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - -#ifdef FEATURE_CONNECTION_SHARING if (config->feature_flags & RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE) { if (config->multi_threaded) { - set_keep_alive_timeout(config->keep_alive_timeout); + set_keep_alive_timeout(keep_alive_timeout); } else { @@ -1504,35 +1814,27 @@ struct configuration_spec * load_config(void) * if we didn't bother with enforcing the connection timeout, * that might make Tor users sad, even though they shouldn't * enable the single-threaded option anyway. - * - * XXX: We could still use Proxy-Connection: keep-alive. */ config->feature_flags &= ~RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE; log_error(LOG_LEVEL_ERROR, "Config option single-threaded disables connection keep-alive."); } } - else if ((config->feature_flags & RUNTIME_FEATURE_CONNECTION_SHARING)) - { - log_error(LOG_LEVEL_ERROR, "Config option connection-sharing " - "has no effect if keep-alive-timeout isn't set."); - config->feature_flags &= ~RUNTIME_FEATURE_CONNECTION_SHARING; - } -#endif /* def FEATURE_CONNECTION_SHARING */ +#endif
if (NULL == config->proxy_args) { log_error(LOG_LEVEL_FATAL, "Out of memory loading config - insufficient memory for config->proxy_args"); }
- if (config->re_filterfile[0]) + if (config->actions_file[0]) { - add_loader(load_re_filterfiles, config); + add_loader(load_action_files, config); }
- if (config->actions_file[0]) + if (config->re_filterfile[0]) { - add_loader(load_action_files, config); + add_loader(load_re_filterfiles, config); }
#ifdef FEATURE_TRUST @@ -1542,45 +1844,35 @@ struct configuration_spec * load_config(void) } #endif /* def FEATURE_TRUST */
- if ( NULL == config->haddr[0] ) + if ( NULL == config->haddr ) { - config->haddr[0] = strdup( HADDR_DEFAULT ); - if (NULL == config->haddr[0]) - { - log_error(LOG_LEVEL_FATAL, "Out of memory while copying default listening address"); - } + config->haddr = strdup( HADDR_DEFAULT ); }
- for (i = 0; i < MAX_LISTENING_SOCKETS && NULL != config->haddr[i]; i++) + if ( NULL != config->haddr ) { - if ((*config->haddr[i] == '[') - && (NULL != (p = strchr(config->haddr[i], ']'))) - && (p[1] == ':') - && (0 < (config->hport[i] = atoi(p + 2)))) - { - *p = '\0'; - memmove((void *)config->haddr[i], config->haddr[i] + 1, - (size_t)(p - config->haddr[i])); - } - else if (NULL != (p = strchr(config->haddr[i], ':')) - && (0 < (config->hport[i] = atoi(p + 1)))) + if (NULL != (p = strchr(config->haddr, ':'))) { - *p = '\0'; + *p++ = '\0'; + if (*p) + { + config->hport = atoi(p); + } } - else + + if (config->hport <= 0) { - log_error(LOG_LEVEL_FATAL, "invalid bind port spec %s", config->haddr[i]); + *--p = ':'; + log_error(LOG_LEVEL_FATAL, "invalid bind port spec %s", config->haddr); /* Never get here - LOG_LEVEL_FATAL causes program exit */ } - if (*config->haddr[i] == '\0') + if (*config->haddr == '\0') { /* - * Only the port specified. We stored it in config->hport[i] + * Only the port specified. We stored it in config->hport * and don't need its text representation anymore. - * Use config->hport[i] == 0 to iterate listening addresses since - * now. */ - freez(config->haddr[i]); + freez(config->haddr); } }
@@ -1604,9 +1896,8 @@ struct configuration_spec * load_config(void) #if defined(_WIN32) && !defined (_WIN_CONSOLE)
g_default_actions_file = config->actions_file[1]; /* FIXME Hope this is default.action */ - g_user_actions_file = config->actions_file[2]; /* FIXME Hope this is user.action */ - g_default_filterfile = config->re_filterfile[0]; /* FIXME Hope this is default.filter */ - g_user_filterfile = config->re_filterfile[1]; /* FIXME Hope this is user.filter */ + g_user_actions_file = config->actions_file[2]; /* FIXME Hope this is user.action */ + g_re_filterfile = config->re_filterfile[0]; /* FIXME Hope this is default.filter */
#ifdef FEATURE_TRUST g_trustfile = config->trustfile; @@ -1624,35 +1915,31 @@ struct configuration_spec * load_config(void) struct configuration_spec * oldcfg = (struct configuration_spec *) current_configfile->f; /* - * Check if config->haddr[i],hport[i] == oldcfg->haddr[i],hport[i] + * Check if config->haddr,hport == oldcfg->haddr,hport * * The following could be written more compactly as a single, * (unreadably long) if statement. */ config->need_bind = 0; - - for (i = 0; i < MAX_LISTENING_SOCKETS; i++) + if (config->hport != oldcfg->hport) { - if (config->hport[i] != oldcfg->hport[i]) - { - config->need_bind = 1; - } - else if (config->haddr[i] == NULL) - { - if (oldcfg->haddr[i] != NULL) - { - config->need_bind = 1; - } - } - else if (oldcfg->haddr[i] == NULL) - { - config->need_bind = 1; - } - else if (0 != strcmp(config->haddr[i], oldcfg->haddr[i])) + config->need_bind = 1; + } + else if (config->haddr == NULL) + { + if (oldcfg->haddr != NULL) { config->need_bind = 1; } } + else if (oldcfg->haddr == NULL) + { + config->need_bind = 1; + } + else if (0 != strcmp(config->haddr, oldcfg->haddr)) + { + config->need_bind = 1; + }
current_configfile->unloader = unload_configfile; } diff --git a/external/privoxy/loadcfg.h b/external/privoxy/loadcfg.h index 6154bff..80fc184 100644 --- a/external/privoxy/loadcfg.h +++ b/external/privoxy/loadcfg.h @@ -1,12 +1,12 @@ #ifndef LOADCFG_H_INCLUDED #define LOADCFG_H_INCLUDED -#define LOADCFG_H_VERSION "$Id: loadcfg.h,v 1.16 2011/09/04 11:10:56 fabiankeil Exp $" +#define LOADCFG_H_VERSION "$Id: loadcfg.h,v 1.13 2006/07/18 14:48:46 david__schmidt Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/loadcfg.h,v $ * * Purpose : Loads settings from the configuration file into - * global variables. This file contains both the + * global variables. This file contains both the * routine to load the configuration and the global * variables it writes to. * @@ -14,10 +14,10 @@ * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -35,8 +35,119 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: loadcfg.h,v $ + * Revision 1.13 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.11.2.1 2003/03/11 11:53:59 oes + * Cosmetic: Renamed cryptic variable + * + * Revision 1.11 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.10 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.9 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.8 2001/12/30 14:07:32 steudten + * - Add signal handling (unix) + * - Add SIGHUP handler (unix) + * - Add creation of pidfile (unix) + * - Add action 'top' in rc file (RH) + * - Add entry 'SIGNALS' to manpage + * - Add exit message to logfile (unix) + * + * Revision 1.7 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.6 2001/07/29 18:58:15 jongfoster + * Removing nested #includes, adding forward declarations for needed + * structures, and changing the #define _FILENAME_H to FILENAME_H_INCLUDED. + * + * Revision 1.5 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.4 2001/05/22 18:46:04 oes + * + * - Enabled filtering banners by size rather than URL + * by adding patterns that replace all standard banner + * sizes with the "Junkbuster" gif to the re_filterfile + * + * - Enabled filtering WebBugs by providing a pattern + * which kills all 1x1 images + * + * - Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * - Added a new interceptor ijb-send-banner, which + * sends back the "Junkbuster" gif. Without imagelist or + * MSIE detection support, or if tinygif = 1, or the + * URL isn't recognized as an imageurl, a lame HTML + * explanation is sent instead. + * + * - Added new feature, which permits blocking remote + * script redirects and firing back a local redirect + * to the browser. + * The feature is conditionally compiled, i.e. it + * can be disabled with --disable-fast-redirects, + * plus it must be activated by a "fast-redirects" + * line in the config file, has its own log level + * and of course wants to be displayed by show-proxy-args + * Note: Boy, all the #ifdefs in 1001 locations and + * all the fumbling with configure.in and acconfig.h + * were *way* more work than the feature itself :-( + * + * - Because a generic redirect template was needed for + * this, tinygif = 3 now uses the same. + * + * - Moved GIFs, and other static HTTP response templates + * to project.h + * + * - Some minor fixes + * + * - Removed some >400 CRs again (Jon, you really worked + * a lot! ;-) + * + * Revision 1.3 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.2 2001/05/17 23:01:01 oes + * - Cleaned CRLF's from the sources and related files + * + * Revision 1.1.1.1 2001/05/15 13:58:58 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -61,7 +172,7 @@ extern const char *configfile; * we need to have these globally available. */ extern int Argc; -extern char * const * Argv; +extern const char **Argv; extern short int MustReload;
diff --git a/external/privoxy/loaders.c b/external/privoxy/loaders.c index f672e5b..b796634 100644 --- a/external/privoxy/loaders.c +++ b/external/privoxy/loaders.c @@ -1,4 +1,4 @@ -const char loaders_rcs[] = "$Id: loaders.c,v 1.87 2011/11/06 11:53:15 fabiankeil Exp $"; +const char loaders_rcs[] = "$Id: loaders.c,v 1.71 2009/03/04 18:24:47 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/loaders.c,v $ @@ -8,7 +8,7 @@ const char loaders_rcs[] = "$Id: loaders.c,v 1.87 2011/11/06 11:53:15 fabiankeil * the list of active loaders, and to automatically * unload files that are no longer in use. * - * Copyright : Written by and Copyright (C) 2001-2010 the + * Copyright : Written by and Copyright (C) 2001-2009 the * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written @@ -33,8 +33,353 @@ const char loaders_rcs[] = "$Id: loaders.c,v 1.87 2011/11/06 11:53:15 fabiankeil * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: loaders.c,v $ + * Revision 1.71 2009/03/04 18:24:47 fabiankeil + * No need to create empty strings manually, strdup("") FTW. + * + * Revision 1.70 2009/03/01 18:34:24 fabiankeil + * Help clang understand that we aren't dereferencing + * NULL pointers here. + * + * Revision 1.69 2008/09/21 13:36:52 fabiankeil + * If change-x-forwarded-for{add} is used and the client + * sends multiple X-Forwarded-For headers, append the client's + * IP address to each one of them. "Traditionally" we would + * lose all but the last one. + * + * Revision 1.68 2008/09/19 15:26:28 fabiankeil + * Add change-x-forwarded-for{} action to block or add + * X-Forwarded-For headers. Mostly based on code removed + * before 3.0.7. + * + * Revision 1.67 2008/03/30 14:52:08 fabiankeil + * Rename load_actions_file() and load_re_filterfile() + * as they load multiple files "now". + * + * Revision 1.66 2008/03/21 11:16:30 fabiankeil + * Garbage-collect csp->my_ip_addr_str and csp->my_hostname. + * + * Revision 1.65 2007/12/07 18:29:23 fabiankeil + * Remove now-obsolete csp member x_forwarded. + * + * Revision 1.64 2007/06/01 14:12:38 fabiankeil + * Add unload_forward_spec() in preparation for forward-override{}. + * + * Revision 1.63 2007/05/14 10:41:15 fabiankeil + * Ditch the csp member cookie_list[] which isn't used anymore. + * + * Revision 1.62 2007/04/30 15:02:18 fabiankeil + * Introduce dynamic pcrs jobs that can resolve variables. + * + * Revision 1.61 2007/04/15 16:39:21 fabiankeil + * Introduce tags as alternative way to specify which + * actions apply to a request. At the moment tags can be + * created based on client and server headers. + * + * Revision 1.60 2007/03/20 15:16:34 fabiankeil + * Use dedicated header filter actions instead of abusing "filter". + * Replace "filter-client-headers" and "filter-client-headers" + * with "server-header-filter" and "client-header-filter". + * + * Revision 1.59 2007/01/25 13:38:20 fabiankeil + * Freez csp->error_message in sweep(). + * + * Revision 1.58 2006/12/31 14:25:20 fabiankeil + * Fix gcc43 compiler warnings. + * + * Revision 1.57 2006/12/21 12:22:22 fabiankeil + * html_encode filter descriptions. + * + * Have "Ignoring job ..." error messages + * print the filter file name correctly. + * + * Revision 1.56 2006/09/07 10:40:30 fabiankeil + * Turns out trusted referrers above our arbitrary + * limit are downgraded too ordinary trusted URLs. + * Adjusted error message. + * + * Revision 1.55 2006/09/07 10:25:39 fabiankeil + * Fix typo. + * + * Revision 1.54 2006/09/07 10:22:20 fabiankeil + * If too many trusted referrers are used, + * print only one error message instead of logging + * every single trusted referrer above the arbitrary + * limit. + * + * Revision 1.53 2006/08/31 16:25:06 fabiankeil + * Work around a buffer overflow that caused Privoxy to + * segfault if too many trusted referrers were used. Good + * enough for now, but should be replaced with a real + * solution after the next release. + * + * Revision 1.52 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.50.2.8 2006/01/30 15:16:25 david__schmidt + * Remove a little residual debugging info + * + * Revision 1.50.2.7 2006/01/29 23:10:56 david__schmidt + * Multiple filter file support + * + * Revision 1.50.2.6 2003/10/24 10:17:54 oes + * Nit: Allowed tabs as separators in filter headings + * + * Revision 1.50.2.5 2003/05/08 15:19:15 oes + * sweep: Made loop structure of sweep step mirror that of mark step + * + * Revision 1.50.2.4 2003/05/06 15:57:12 oes + * Bugfix: Update last_active pointer in sweep() before + * leaving an active client. Closes bugs #724395, #727882 + * + * Revision 1.50.2.3 2002/11/20 17:12:30 oes + * Ooops, forgot one change. + * + * Revision 1.50.2.2 2002/11/20 14:38:15 oes + * Fixed delayed/incomplete freeing of client resources and + * simplified loop structure in sweep. + * Thanks to Oliver Stoeneberg for the hint. + * + * Revision 1.50.2.1 2002/07/26 15:19:24 oes + * - PCRS jobs now chained in order of appearance. Previous + * reverse chaining was counter-intuitive. + * - Changed loglevel of PCRS job compile errors to + * LOG_LEVEL_ERROR + * + * Revision 1.50 2002/04/24 02:12:16 oes + * Jon's multiple AF patch: Sweep now takes care of all AFs + * + * Revision 1.49 2002/04/19 16:53:25 jongfoster + * Optimize away a function call by using an equivalent macro + * + * Revision 1.48 2002/04/05 00:56:09 gliptak + * Correcting typo to clean up on realloc failure + * + * Revision 1.47 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.46 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.45 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.44 2002/03/16 21:51:00 jongfoster + * Fixing free(NULL). + * + * Revision 1.43 2002/03/16 20:28:34 oes + * Added descriptions to the filters so users will know what they select in the cgi editor + * + * Revision 1.42 2002/03/13 00:27:05 jongfoster + * Killing warnings + * + * Revision 1.41 2002/03/12 01:42:50 oes + * Introduced modular filters + * + * Revision 1.40 2002/03/08 17:46:04 jongfoster + * Fixing int/size_t warnings + * + * Revision 1.39 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.38 2002/03/06 22:54:35 jongfoster + * Automated function-comment nitpicking. + * + * Revision 1.37 2002/03/03 15:07:49 oes + * Re-enabled automatic config reloading + * + * Revision 1.36 2002/01/22 23:46:18 jongfoster + * Moving edit_read_line() and simple_read_line() to loaders.c, and + * extending them to support reading MS-DOS, Mac and UNIX style files + * on all platforms. + * + * Modifying read_config_line() (without changing it's prototype) to + * be a trivial wrapper for edit_read_line(). This means that we have + * one function to read a line and handle comments, which is common + * between the initialization code and the edit interface. + * + * Revision 1.35 2002/01/17 21:03:08 jongfoster + * Moving all our URL and URL pattern parsing code to urlmatch.c. + * + * Renaming free_url to free_url_spec, since it frees a struct url_spec. + * + * Revision 1.34 2001/12/30 14:07:32 steudten + * - Add signal handling (unix) + * - Add SIGHUP handler (unix) + * - Add creation of pidfile (unix) + * - Add action 'top' in rc file (RH) + * - Add entry 'SIGNALS' to manpage + * - Add exit message to logfile (unix) + * + * Revision 1.33 2001/11/13 00:16:38 jongfoster + * Replacing references to malloc.h with the standard stdlib.h + * (See ANSI or K&R 2nd Ed) + * + * Revision 1.32 2001/11/07 00:02:13 steudten + * Add line number in error output for lineparsing for + * actionsfile and configfile. + * Special handling for CLF added. + * + * Revision 1.31 2001/10/26 17:39:01 oes + * Removed csp->referrer + * Moved ijb_isspace and ijb_tolower to project.h + * + * Revision 1.30 2001/10/25 03:40:48 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.29 2001/10/23 21:38:53 jongfoster + * Adding error-checking to create_url_spec() + * + * Revision 1.28 2001/10/07 15:40:39 oes + * Replaced 6 boolean members of csp with one bitmap (csp->flags) + * + * Revision 1.27 2001/09/22 16:36:59 jongfoster + * Removing unused parameter fs from read_config_line() + * + * Revision 1.26 2001/09/22 14:05:22 jongfoster + * Bugfix: Multiple escaped "#" characters in a configuration + * file are now permitted. + * Also removing 3 unused headers. + * + * Revision 1.25 2001/09/13 22:44:03 jongfoster + * Adding {} to an if statement + * + * Revision 1.24 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.23 2001/07/20 15:51:54 oes + * Fixed indentation of prepocessor commands + * + * Revision 1.22 2001/07/20 15:16:17 haroon + * - per Guy's suggestion, added a while loop in sweep() to catch not just + * the last inactive CSP but all other consecutive inactive CSPs after that + * as well + * + * Revision 1.21 2001/07/18 17:26:24 oes + * Changed to conform to new pcrs interface + * + * Revision 1.20 2001/07/17 13:07:01 oes + * Fixed segv when last line in config files + * lacked a terminating (\r)\n + * + * Revision 1.19 2001/07/13 14:01:54 oes + * Removed all #ifdef PCRS + * + * Revision 1.18 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.17 2001/06/29 13:31:51 oes + * Various adaptions + * + * Revision 1.16 2001/06/09 10:55:28 jongfoster + * Changing BUFSIZ ==> BUFFER_SIZE + * + * Revision 1.15 2001/06/07 23:14:14 jongfoster + * Removing ACL and forward file loaders - these + * files have been merged into the config file. + * Cosmetic: Moving unloader funcs next to their + * respective loader funcs + * + * Revision 1.14 2001/06/01 03:27:04 oes + * Fixed line continuation problem + * + * Revision 1.13 2001/05/31 21:28:49 jongfoster + * Removed all permissionsfile code - it's now called the actions + * file, and (almost) all the code is in actions.c + * + * Revision 1.12 2001/05/31 17:32:31 oes + * + * - Enhanced domain part globbing with infix and prefix asterisk + * matching and optional unanchored operation + * + * Revision 1.11 2001/05/29 23:25:24 oes + * + * - load_config_line() and load_permissions_file() now use chomp() + * + * Revision 1.10 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.9 2001/05/26 17:12:07 jongfoster + * Fatal errors loading configuration files now give better error messages. + * + * Revision 1.8 2001/05/26 00:55:20 jongfoster + * Removing duplicated code. load_forwardfile() now uses create_url_spec() + * + * Revision 1.7 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.6 2001/05/23 12:27:33 oes + * + * Fixed ugly indentation of my last changes + * + * Revision 1.5 2001/05/23 10:39:05 oes + * - Added support for escaping the comment character + * in config files by a backslash + * - Added support for line continuation in config + * files + * - Fixed a buffer overflow bug with long config lines + * + * Revision 1.4 2001/05/22 18:56:28 oes + * CRLF -> LF + * + * Revision 1.3 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.2 2001/05/17 23:01:01 oes + * - Cleaned CRLF's from the sources and related files + * + * Revision 1.1.1.1 2001/05/15 13:58:59 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -108,16 +453,14 @@ static struct file_list *current_re_filterfile[MAX_AF_FILES] = { * * Parameters : None * - * Returns : The number of threads that are still active. + * Returns : N/A * *********************************************************************/ -unsigned int sweep(void) +void sweep(void) { struct file_list *fl, *nfl; - struct client_state *csp; - struct client_states *last_active, *client_list; + struct client_state *csp, *last_active; int i; - unsigned int active_threads = 0;
/* clear all of the file's active flags */ for ( fl = files->next; NULL != fl; fl = fl->next ) @@ -126,11 +469,10 @@ unsigned int sweep(void) }
last_active = clients; - client_list = clients->next; + csp = clients->next;
- while (NULL != client_list) + while (NULL != csp) { - csp = &client_list->csp; if (csp->flags & CSP_FLAG_ACTIVE) { /* Mark this client's files as active */ @@ -142,12 +484,12 @@ unsigned int sweep(void) */ csp->config->config_file_list->active = 1;
- /* + /* * Actions files */ for (i = 0; i < MAX_AF_FILES; i++) { - if (csp->actions_list[i]) + if (csp->actions_list[i]) { csp->actions_list[i]->active = 1; } @@ -158,7 +500,7 @@ unsigned int sweep(void) */ for (i = 0; i < MAX_AF_FILES; i++) { - if (csp->rlist[i]) + if (csp->rlist[i]) { csp->rlist[i]->active = 1; } @@ -173,18 +515,17 @@ unsigned int sweep(void) csp->tlist->active = 1; } #endif /* def FEATURE_TRUST */ + + last_active = csp; + csp = csp->next;
- active_threads++; - - last_active = client_list; - client_list = client_list->next; } - else + else /* * This client is not active. Free its resources. */ { - last_active->next = client_list->next; + last_active->next = csp->next;
freez(csp->ip_addr_str); freez(csp->iob->buf); @@ -210,9 +551,9 @@ unsigned int sweep(void) } #endif /* def FEATURE_STATISTICS */
- freez(client_list); - - client_list = last_active->next; + freez(csp); + + csp = last_active->next; } }
@@ -239,8 +580,6 @@ unsigned int sweep(void) } }
- return active_threads; - }
@@ -359,7 +698,7 @@ jb_err simple_read_line(FILE *fp, char **dest, int *newline) p = buf;
/* - * Character codes. If you have a weird compiler and the following are + * Character codes. If you have a wierd compiler and the following are * incorrect, you also need to fix NEWLINE() in loaders.h */ #define CHAR_CR '\r' /* ASCII 13 */ @@ -737,27 +1076,37 @@ jb_err edit_read_line(FILE *fp, * and respects escaping of newline and comment char. * * Parameters : - * 1 : fp = File to read from - * 2 : linenum = linenumber in file - * 3 : buf = Pointer to a pointer to set to the data buffer. + * 1 : buf = Buffer to use. + * 2 : buflen = Size of buffer in bytes. + * 3 : fp = File to read from + * 4 : linenum = linenumber in file * * Returns : NULL on EOF or error * Otherwise, returns buf. * *********************************************************************/ -char *read_config_line(FILE *fp, unsigned long *linenum, char **buf) +char *read_config_line(char *buf, size_t buflen, FILE *fp, unsigned long *linenum) { jb_err err; - err = edit_read_line(fp, NULL, NULL, buf, NULL, linenum); + char *buf2 = NULL; + err = edit_read_line(fp, NULL, NULL, &buf2, NULL, linenum); if (err) { if (err == JB_ERR_MEMORY) { log_error(LOG_LEVEL_FATAL, "Out of memory loading a config file"); } - *buf = NULL; + return NULL; + } + else + { + assert(buf2); + assert(strlen(buf2) + 1U < buflen); + strncpy(buf, buf2, buflen - 1); + free(buf2); + buf[buflen - 1] = '\0'; + return buf; } - return *buf; }
@@ -835,7 +1184,7 @@ int load_trustfile(struct client_state *csp) struct block_spec *b, *bl; struct url_spec **tl;
- char *buf = NULL; + char buf[BUFFER_SIZE], *p, *q; int reject, trusted; struct file_list *fs; unsigned long linenum = 0; @@ -844,7 +1193,10 @@ int load_trustfile(struct client_state *csp) if (!check_file_changed(current_trustfile, csp->config->trustfile, &fs)) { /* No need to load */ - csp->tlist = current_trustfile; + if (csp) + { + csp->tlist = current_trustfile; + } return(0); } if (!fs) @@ -862,11 +1214,10 @@ int load_trustfile(struct client_state *csp) { goto load_trustfile_error; } - log_error(LOG_LEVEL_INFO, "Loading trust file: %s", csp->config->trustfile);
tl = csp->config->trust_list;
- while (read_config_line(fp, &linenum, &buf) != NULL) + while (read_config_line(buf, sizeof(buf), fp, &linenum) != NULL) { trusted = 0; reject = 1; @@ -879,9 +1230,6 @@ int load_trustfile(struct client_state *csp)
if (*buf == '~') { - char *p; - char *q; - reject = 0; p = buf; q = p+1; @@ -894,7 +1242,6 @@ int load_trustfile(struct client_state *csp) /* skip blank lines */ if (*buf == '\0') { - freez(buf); continue; }
@@ -928,10 +1275,9 @@ int load_trustfile(struct client_state *csp) *tl++ = b->url; } } - freez(buf); }
- if(trusted_referrers >= MAX_TRUSTED_REFERRERS) + if(trusted_referrers >= MAX_TRUSTED_REFERRERS) { /* * FIXME: ... after Privoxy 3.0.4 is out. @@ -955,14 +1301,17 @@ int load_trustfile(struct client_state *csp) fs->next = files->next; files->next = fs; current_trustfile = fs; - csp->tlist = fs; + + if (csp) + { + csp->tlist = fs; + }
return(0);
load_trustfile_error: log_error(LOG_LEVEL_FATAL, "can't load trustfile '%s': %E", - csp->config->trustfile); - freez(buf); + csp->config->trustfile); return(-1);
} @@ -1006,7 +1355,7 @@ static void unload_re_filterfile(void *f) * * Function : unload_forward_spec * - * Description : Unload the forward spec settings by freeing all + * Description : Unload the forward spec settings by freeing all * memory referenced by members and the memory for * the spec itself. * @@ -1060,7 +1409,7 @@ void unload_current_re_filterfile(void) * * Function : load_re_filterfiles * - * Description : Loads all the filterfiles. + * Description : Loads all the filterfiles. * Generate a chained list of re_filterfile_spec's from * the "FILTER: " blocks, compiling all their substitutions * into chained lists of pcrs_job structs. @@ -1101,7 +1450,7 @@ int load_re_filterfiles(struct client_state *csp) * * Function : load_one_re_filterfile * - * Description : Load a re_filterfile. + * Description : Load a re_filterfile. * Generate a chained list of re_filterfile_spec's from * the "FILTER: " blocks, compiling all their substitutions * into chained lists of pcrs_job structs. @@ -1119,7 +1468,7 @@ int load_one_re_filterfile(struct client_state *csp, int fileid) struct re_filterfile_spec *new_bl, *bl = NULL; struct file_list *fs;
- char *buf = NULL; + char buf[BUFFER_SIZE]; int error; unsigned long linenum = 0; pcrs_job *dummy, *lastjob = NULL; @@ -1129,7 +1478,10 @@ int load_one_re_filterfile(struct client_state *csp, int fileid) */ if (!check_file_changed(current_re_filterfile[fileid], csp->config->re_filterfile[fileid], &fs)) { - csp->rlist[fileid] = current_re_filterfile[fileid]; + if (csp) + { + csp->rlist[fileid] = current_re_filterfile[fileid]; + } return(0); } if (!fs) @@ -1137,7 +1489,7 @@ int load_one_re_filterfile(struct client_state *csp, int fileid) goto load_re_filterfile_error; }
- /* + /* * Open the file or fail */ if ((fp = fopen(csp->config->re_filterfile[fileid], "r")) == NULL) @@ -1145,12 +1497,10 @@ int load_one_re_filterfile(struct client_state *csp, int fileid) goto load_re_filterfile_error; }
- log_error(LOG_LEVEL_INFO, "Loading filter file: %s", csp->config->re_filterfile[fileid]); - - /* + /* * Read line by line */ - while (read_config_line(fp, &linenum, &buf) != NULL) + while (read_config_line(buf, sizeof(buf), fp, &linenum) != NULL) { int new_filter = NO_NEW_FILTER;
@@ -1215,7 +1565,7 @@ int load_one_re_filterfile(struct client_state *csp, int fileid) }
new_bl->name = strdup(chomp(new_bl->name)); - + /* * If this is the first filter block, chain it * to the file_list rather than its (nonexistant) @@ -1234,13 +1584,12 @@ int load_one_re_filterfile(struct client_state *csp, int fileid)
log_error(LOG_LEVEL_RE_FILTER, "Reading in filter "%s" ("%s")", bl->name, bl->description);
- freez(buf); continue; }
- /* + /* * Else, save the expression, make it a pcrs_job - * and chain it into the current filter's joblist + * and chain it into the current filter's joblist */ if (bl != NULL) { @@ -1266,8 +1615,7 @@ int load_one_re_filterfile(struct client_state *csp, int fileid) bl->dynamic = 1; log_error(LOG_LEVEL_RE_FILTER, "Adding dynamic re_filter job '%s' to filter %s succeeded.", buf, bl->name); - freez(buf); - continue; + continue; } else if (bl->dynamic) { @@ -1278,7 +1626,6 @@ int load_one_re_filterfile(struct client_state *csp, int fileid) */ log_error(LOG_LEVEL_RE_FILTER, "Adding static re_filter job '%s' to dynamic filter %s succeeded.", buf, bl->name); - freez(buf); continue; }
@@ -1286,7 +1633,6 @@ int load_one_re_filterfile(struct client_state *csp, int fileid) { log_error(LOG_LEVEL_ERROR, "Adding re_filter job '%s' to filter %s failed with error %d.", buf, bl->name, error); - freez(buf); continue; } else @@ -1308,12 +1654,11 @@ int load_one_re_filterfile(struct client_state *csp, int fileid) log_error(LOG_LEVEL_ERROR, "Ignoring job %s outside filter block in %s, line %d", buf, csp->config->re_filterfile[fileid], linenum); } - freez(buf); }
fclose(fp);
- /* + /* * Schedule the now-obsolete old data for unloading */ if ( NULL != current_re_filterfile[fileid] ) @@ -1327,7 +1672,11 @@ int load_one_re_filterfile(struct client_state *csp, int fileid) fs->next = files->next; files->next = fs; current_re_filterfile[fileid] = fs; - csp->rlist[fileid] = fs; + + if (csp) + { + csp->rlist[fileid] = fs; + }
return( 0 );
@@ -1359,7 +1708,7 @@ void add_loader(int (*loader)(struct client_state *), { int i;
- for (i = 0; i < NLOADERS; i++) + for (i=0; i < NLOADERS; i++) { if (config->loaders[i] == NULL) { @@ -1393,7 +1742,7 @@ int run_loader(struct client_state *csp) int ret = 0; int i;
- for (i = 0; i < NLOADERS; i++) + for (i=0; i < NLOADERS; i++) { if (csp->config->loaders[i] == NULL) { @@ -1405,66 +1754,6 @@ int run_loader(struct client_state *csp)
}
-/********************************************************************* - * - * Function : file_has_been_modified - * - * Description : Helper function to check if a file has been changed - * - * Parameters : - * 1 : filename = The name of the file to check - * 2 : last_known_modification = The time of the last known - * modification - * - * Returns : TRUE if the file has been changed, - * FALSE otherwise. - * - *********************************************************************/ -static int file_has_been_modified(const char *filename, time_t last_know_modification) -{ - struct stat statbuf[1]; - - if (stat(filename, statbuf) < 0) - { - /* Error, probably file not found which counts as change. */ - return 1; - } - - return (last_know_modification != statbuf->st_mtime); -} - - -/********************************************************************* - * - * Function : any_loaded_file_changed - * - * Description : Helper function to check if any loaded file has been - * changed since the time it has been loaded. - * - * XXX: Should we cache the return value for x seconds? - * - * Parameters : - * 1 : files_to_check = List of files to check - * - * Returns : TRUE if any file has been changed, - * FALSE otherwise. - * - *********************************************************************/ -int any_loaded_file_changed(const struct file_list *files_to_check) -{ - const struct file_list *file_to_check = files_to_check; - - while (file_to_check != NULL) - { - if (file_has_been_modified(file_to_check->filename, file_to_check->lastmodified)) - { - return TRUE; - } - file_to_check = file_to_check->next; - } - return FALSE; -} -
/* Local Variables: diff --git a/external/privoxy/loaders.h b/external/privoxy/loaders.h index ae1b6fe..ded18e3 100644 --- a/external/privoxy/loaders.h +++ b/external/privoxy/loaders.h @@ -1,23 +1,23 @@ #ifndef LOADERS_H_INCLUDED #define LOADERS_H_INCLUDED -#define LOADERS_H_VERSION "$Id: loaders.h,v 1.29 2011/09/04 11:10:56 fabiankeil Exp $" +#define LOADERS_H_VERSION "$Id: loaders.h,v 1.23 2008/03/30 14:52:10 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/loaders.h,v $ * * Purpose : Functions to load and unload the various * configuration files. Also contains code to manage - * the list of active loaders, and to automatically + * the list of active loaders, and to automatically * unload files that are no longer in use. * - * Copyright : Written by and Copyright (C) 2001-2010 the + * Copyright : Written by and Copyright (C) 2001 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -35,8 +35,139 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: loaders.h,v $ + * Revision 1.23 2008/03/30 14:52:10 fabiankeil + * Rename load_actions_file() and load_re_filterfile() + * as they load multiple files "now". + * + * Revision 1.22 2007/06/01 14:12:38 fabiankeil + * Add unload_forward_spec() in preparation for forward-override{}. + * + * Revision 1.21 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.19 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.18 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.17 2002/03/16 23:54:06 jongfoster + * Adding graceful termination feature, to help look for memory leaks. + * If you enable this (which, by design, has to be done by hand + * editing config.h) and then go to http://i.j.b/die, then the program + * will exit cleanly after the *next* request. It should free all the + * memory that was used. + * + * Revision 1.16 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.15 2002/01/22 23:46:18 jongfoster + * Moving edit_read_line() and simple_read_line() to loaders.c, and + * extending them to support reading MS-DOS, Mac and UNIX style files + * on all platforms. + * + * Modifying read_config_line() (without changing it's prototype) to + * be a trivial wrapper for edit_read_line(). This means that we have + * one function to read a line and handle comments, which is common + * between the initialization code and the edit interface. + * + * Revision 1.14 2002/01/17 21:03:08 jongfoster + * Moving all our URL and URL pattern parsing code to urlmatch.c. + * + * Renaming free_url to free_url_spec, since it frees a struct url_spec. + * + * Revision 1.13 2001/12/30 14:07:32 steudten + * - Add signal handling (unix) + * - Add SIGHUP handler (unix) + * - Add creation of pidfile (unix) + * - Add action 'top' in rc file (RH) + * - Add entry 'SIGNALS' to manpage + * - Add exit message to logfile (unix) + * + * Revision 1.12 2001/11/07 00:02:13 steudten + * Add line number in error output for lineparsing for + * actionsfile and configfile. + * Special handling for CLF added. + * + * Revision 1.11 2001/10/23 21:38:53 jongfoster + * Adding error-checking to create_url_spec() + * + * Revision 1.10 2001/09/22 16:36:59 jongfoster + * Removing unused parameter fs from read_config_line() + * + * Revision 1.9 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.8 2001/07/29 18:58:15 jongfoster + * Removing nested #includes, adding forward declarations for needed + * structures, and changing the #define _FILENAME_H to FILENAME_H_INCLUDED. + * + * Revision 1.7 2001/07/13 14:01:54 oes + * Removed all #ifdef PCRS + * + * Revision 1.6 2001/06/07 23:14:38 jongfoster + * Removing ACL and forward file loaders - these files have + * been merged into the config file. + * + * Revision 1.5 2001/05/31 21:28:49 jongfoster + * Removed all permissionsfile code - it's now called the actions + * file, and (almost) all the code is in actions.c + * + * Revision 1.4 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.3 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.2 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.1.1.1 2001/05/15 13:59:00 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -48,8 +179,8 @@ struct file_list; struct configuration_spec; struct url_spec;
-extern unsigned int sweep(void); -extern char *read_config_line(FILE *fp, unsigned long *linenum, char **buf); +extern void sweep(void); +extern char *read_config_line(char *buf, size_t buflen, FILE *fp, unsigned long *linenum); extern int check_file_changed(const struct file_list * current, const char * filename, struct file_list ** newfl); @@ -73,7 +204,7 @@ extern jb_err simple_read_line(FILE *fp, char **dest, int *newline);
/* * Types of newlines that a file may contain, as strings. If you have an - * extremely weird compiler that does not have '\r' == CR == ASCII 13 and + * extremely wierd compiler that does not have '\r' == CR == ASCII 13 and * '\n' == LF == ASCII 10), then fix CHAR_CR and CHAR_LF in loaders.c as * well as these definitions. */ @@ -98,12 +229,10 @@ void unload_current_re_filterfile(void);
void unload_forward_spec(struct forward_spec *fwd);
-extern void add_loader(int (*loader)(struct client_state *), +extern void add_loader(int (*loader)(struct client_state *), struct configuration_spec * config); extern int run_loader(struct client_state *csp);
-extern int any_loaded_file_changed(const struct file_list *files_to_check); - /* Revision control strings from this header and associated .c file */ extern const char loaders_rcs[]; extern const char loaders_h_rcs[]; diff --git a/external/privoxy/match-all.action b/external/privoxy/match-all.action index 826eb39..904d85b 100644 --- a/external/privoxy/match-all.action +++ b/external/privoxy/match-all.action @@ -1,5 +1,5 @@ ############################################################################# -# $Id: match-all.action,v 1.3 2010/03/27 18:48:38 fabiankeil Exp $ +# $Id: match-all.action,v 1.2 2009/02/14 10:41:07 fabiankeil Exp $ # # This file contains the actions that are applied to all requests and # may be overruled later on by other actions files. Less experienced @@ -8,8 +8,6 @@ ############################################################################# { \ +change-x-forwarded-for{block} \ -+client-header-tagger{css-requests} \ -+client-header-tagger{image-requests} \ +hide-from-header{block} \ +set-image-blocker{pattern} \ } diff --git a/external/privoxy/miscutil.c b/external/privoxy/miscutil.c index dc972d6..74aa32e 100644 --- a/external/privoxy/miscutil.c +++ b/external/privoxy/miscutil.c @@ -1,18 +1,19 @@ -const char miscutil_rcs[] = "$Id: miscutil.c,v 1.68 2011/09/04 11:10:56 fabiankeil Exp $"; +const char miscutil_rcs[] = "$Id: miscutil.c,v 1.62 2008/12/04 18:16:41 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/miscutil.c,v $ * - * Purpose : zalloc, hash_string, strcmpic, strncmpic, and - * MinGW32 strdup functions. These are each too small - * to deserve their own file but don't really fit in - * any other file. + * Purpose : zalloc, hash_string, safe_strerror, strcmpic, + * strncmpic, chomp, and MinGW32 strdup + * functions. + * These are each too small to deserve their own file + * but don't really fit in any other file. * - * Copyright : Written by and Copyright (C) 2001-2011 the - * Privoxy team. http://www.privoxy.org/ + * Copyright : Written by and Copyright (C) 2001-2007 + * the SourceForge Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * * The timegm replacement function was taken from GnuPG, @@ -23,7 +24,7 @@ const char miscutil_rcs[] = "$Id: miscutil.c,v 1.68 2011/09/04 11:10:56 fabianke * used under the terms of the GPL or the terms of the * "Frontier Artistic License". * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -41,8 +42,294 @@ const char miscutil_rcs[] = "$Id: miscutil.c,v 1.68 2011/09/04 11:10:56 fabianke * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: miscutil.c,v $ + * Revision 1.62 2008/12/04 18:16:41 fabiankeil + * Fix some cparser warnings. + * + * Revision 1.61 2008/10/18 11:09:23 fabiankeil + * Improve seed used by pick_from_range() on mingw32. + * + * Revision 1.60 2008/09/07 12:35:05 fabiankeil + * Add mutex lock support for _WIN32. + * + * Revision 1.59 2008/09/04 08:13:58 fabiankeil + * Prepare for critical sections on Windows by adding a + * layer of indirection before the pthread mutex functions. + * + * Revision 1.58 2008/04/17 14:53:30 fabiankeil + * Move simplematch() into urlmatch.c as it's only + * used to match (old-school) domain patterns. + * + * Revision 1.57 2008/03/24 15:29:51 fabiankeil + * Pet gcc43. + * + * Revision 1.56 2007/12/01 12:59:05 fabiankeil + * Some sanity checks for pick_from_range(). + * + * Revision 1.55 2007/11/03 17:34:49 fabiankeil + * Log the "weak randomization factor" warning only + * once for mingw32 and provide some more details. + * + * Revision 1.54 2007/09/19 20:28:37 fabiankeil + * If privoxy_strlcpy() is called with a "buffer" size + * of 0, don't touch whatever destination points to. + * + * Revision 1.53 2007/09/09 18:20:20 fabiankeil + * Turn privoxy_strlcpy() into a function and try to work with + * b0rked snprintf() implementations too. Reported by icmp30. + * + * Revision 1.52 2007/08/19 12:32:34 fabiankeil + * Fix a conversion warning. + * + * Revision 1.51 2007/06/17 16:12:22 fabiankeil + * #ifdef _WIN32 the last commit. According to David Shaw, + * one of the gnupg developers, the changes are mingw32-specific. + * + * Revision 1.50 2007/06/10 14:59:59 fabiankeil + * Change replacement timegm() to better match our style, plug a small + * but guaranteed memory leak and fix "time zone breathing" on mingw32. + * + * Revision 1.49 2007/05/11 11:48:15 fabiankeil + * - Delete strsav() which was replaced + * by string_append() years ago. + * - Add a strlcat() look-alike. + * - Use strlcat() and strlcpy() in those parts + * of the code that are run on unixes. + * + * Revision 1.48 2007/04/09 17:48:51 fabiankeil + * Check for HAVE_SNPRINTF instead of __OS2__ + * before including the portable snprintf() code. + * + * Revision 1.47 2007/03/17 11:52:15 fabiankeil + * - Use snprintf instead of sprintf. + * - Mention copyright for the replacement + * functions in the copyright header. + * + * Revision 1.46 2007/01/18 15:03:20 fabiankeil + * Don't include replacement timegm() if + * putenv() or tzset() isn't available. + * + * Revision 1.45 2006/12/26 17:31:41 fabiankeil + * Mutex protect rand() if POSIX threading + * is used, warn the user if that's not possible + * and stop using it on _WIN32 where it could + * cause crashes. + * + * Revision 1.44 2006/11/07 12:46:43 fabiankeil + * Silence compiler warning on NetBSD 3.1. + * + * Revision 1.43 2006/09/23 13:26:38 roro + * Replace TABs by spaces in source code. + * + * Revision 1.42 2006/09/09 14:01:45 fabiankeil + * Integrated Oliver Yeoh's domain pattern fix + * to make sure *x matches xx. Closes Patch 1217393 + * and Bug 1170767. + * + * Revision 1.41 2006/08/18 16:03:17 david__schmidt + * Tweak for OS/2 build happiness. + * + * Revision 1.40 2006/08/17 17:15:10 fabiankeil + * - Back to timegm() using GnuPG's replacement if necessary. + * Using mktime() and localtime() could add a on hour offset if + * the randomize factor was big enough to lead to a summer/wintertime + * switch. + * + * - Removed now-useless Privoxy 3.0.3 compatibility glue. + * + * - Moved randomization code into pick_from_range(). + * + * - Changed parse_header_time definition. + * time_t isn't guaranteed to be signed and + * if it isn't, -1 isn't available as error code. + * Changed some variable types in client_if_modified_since() + * because of the same reason. + * + * Revision 1.39 2006/07/18 14:48:46 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.37.2.4 2003/12/01 14:45:14 oes + * Fixed two more problems with wildcarding in simplematch() + * + * Revision 1.37.2.3 2003/11/20 11:39:24 oes + * Bugfix: The "?" wildcard for domain names had never been implemented. Ooops! + * + * Revision 1.37.2.2 2002/11/12 14:28:18 oes + * Proper backtracking in simplematch; fixes bug #632888 + * + * Revision 1.37.2.1 2002/09/25 12:58:51 oes + * Made strcmpic and strncmpic safe against NULL arguments + * (which are now treated as empty strings). + * + * Revision 1.37 2002/04/26 18:29:43 jongfoster + * Fixing this Visual C++ warning: + * miscutil.c(710) : warning C4090: '=' : different 'const' qualifiers + * + * Revision 1.36 2002/04/26 12:55:38 oes + * New function string_toupper + * + * Revision 1.35 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.34 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.33 2002/03/07 03:46:53 oes + * Fixed compiler warnings etc + * + * Revision 1.32 2002/03/06 23:02:57 jongfoster + * Removing tabs + * + * Revision 1.31 2002/03/05 04:52:42 oes + * Deleted non-errlog debugging code + * + * Revision 1.30 2002/03/04 18:27:42 oes + * - Deleted deletePidFile + * - Made write_pid_file use the --pidfile option value + * (or no PID file, if the option was absent) + * - Played styleguide police + * + * Revision 1.29 2002/03/04 02:08:02 david__schmidt + * Enable web editing of actions file on OS/2 (it had been broken all this time!) + * + * Revision 1.28 2002/03/03 09:18:03 joergs + * Made jumbjuster work on AmigaOS again. + * + * Revision 1.27 2002/01/21 00:52:32 jongfoster + * Adding string_join() + * + * Revision 1.26 2001/12/30 14:07:32 steudten + * - Add signal handling (unix) + * - Add SIGHUP handler (unix) + * - Add creation of pidfile (unix) + * - Add action 'top' in rc file (RH) + * - Add entry 'SIGNALS' to manpage + * - Add exit message to logfile (unix) + * + * Revision 1.25 2001/11/13 00:16:38 jongfoster + * Replacing references to malloc.h with the standard stdlib.h + * (See ANSI or K&R 2nd Ed) + * + * Revision 1.24 2001/11/05 21:41:43 steudten + * Add changes to be a real daemon just for unix os. + * (change cwd to /, detach from controlling tty, set + * process group and session leader to the own process. + * Add DBG() Macro. + * Add some fatal-error log message for failed malloc(). + * Add '-d' if compiled with 'configure --with-debug' to + * enable debug output. + * + * Revision 1.23 2001/10/29 03:48:10 david__schmidt + * OS/2 native needed a snprintf() routine. Added one to miscutil, brackedted + * by and __OS2__ ifdef. + * + * Revision 1.22 2001/10/26 17:39:38 oes + * Moved ijb_isspace and ijb_tolower to project.h + * + * Revision 1.21 2001/10/23 21:27:50 jongfoster + * Standardising error codes in string_append + * make_path() no longer adds '\' if the dir already ends in '\' (this + * is just copying a UNIX-specific fix to the Windows-specific part) + * + * Revision 1.20 2001/10/22 15:33:56 david__schmidt + * Special-cased OS/2 out of the Netscape-abort-on-404-in-js problem in + * filters.c. Added a FIXME in front of the offending code. I'll gladly + * put in a better/more robust fix for all parties if one is presented... + * It seems that just returning 200 instead of 404 would pretty much fix + * it for everyone, but I don't know all the history of the problem. + * + * Revision 1.19 2001/10/14 22:02:57 jongfoster + * New function string_append() which is like strsav(), but running + * out of memory isn't automatically FATAL. + * + * Revision 1.18 2001/09/20 13:33:43 steudten + * + * change long to int as return value in hash_string(). Remember the wraparound + * for int = long = sizeof(4) - thats maybe not what we want. + * + * Revision 1.17 2001/09/13 20:51:29 jongfoster + * Fixing potential problems with characters >=128 in simplematch() + * This was also a compiler warning. + * + * Revision 1.16 2001/09/10 10:56:59 oes + * Silenced compiler warnings + * + * Revision 1.15 2001/07/13 14:02:24 oes + * Removed vim-settings + * + * Revision 1.14 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.13 2001/06/29 13:32:14 oes + * Removed logentry from cancelled commit + * + * Revision 1.12 2001/06/09 10:55:28 jongfoster + * Changing BUFSIZ ==> BUFFER_SIZE + * + * Revision 1.11 2001/06/07 23:09:19 jongfoster + * Cosmetic indentation changes. + * + * Revision 1.10 2001/06/07 14:51:38 joergs + * make_path() no longer adds '/' if the dir already ends in '/'. + * + * Revision 1.9 2001/06/07 14:43:17 swa + * slight mistake in make_path, unix path style is /. + * + * Revision 1.8 2001/06/05 22:32:01 jongfoster + * New function make_path() to splice directory and file names together. + * + * Revision 1.7 2001/06/03 19:12:30 oes + * introduced bindup() + * + * Revision 1.6 2001/06/01 18:14:49 jongfoster + * Changing the calls to strerr() to check HAVE_STRERR (which is defined + * in config.h if appropriate) rather than the NO_STRERR macro. + * + * Revision 1.5 2001/06/01 10:31:51 oes + * Added character class matching to trivimatch; renamed to simplematch + * + * Revision 1.4 2001/05/31 17:32:31 oes + * + * - Enhanced domain part globbing with infix and prefix asterisk + * matching and optional unanchored operation + * + * Revision 1.3 2001/05/29 23:10:09 oes + * + * + * - Introduced chomp() + * - Moved strsav() from showargs to miscutil + * + * Revision 1.2 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.1.1.1 2001/05/15 13:59:00 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -97,19 +384,19 @@ void *zalloc(size_t size) #if defined(unix) /********************************************************************* * - * Function : write_pid_file + * Function : write_pid_file * - * Description : Writes a pid file with the pid of the main process + * Description : Writes a pid file with the pid of the main process * * Parameters : None * - * Returns : N/A + * Returns : N/A * *********************************************************************/ void write_pid_file(void) { FILE *fp; - + /* * If no --pidfile option was given, * we can live without one. @@ -147,7 +434,7 @@ void write_pid_file(void) *********************************************************************/ unsigned int hash_string( const char* s ) { - unsigned int h = 0; + unsigned int h = 0;
for ( ; *s; ++s ) { @@ -159,6 +446,75 @@ unsigned int hash_string( const char* s ) }
+#ifdef __MINGW32__ +/********************************************************************* + * + * Function : strdup + * + * Description : For some reason (which is beyond me), gcc and WIN32 + * don't like strdup. When a "free" is executed on a + * strdup'd ptr, it can at times freez up! So I just + * replaced it and problem was solved. + * + * Parameters : + * 1 : s = string to duplicate + * + * Returns : Pointer to newly malloc'ed copy of the string. + * + *********************************************************************/ +char *strdup( const char *s ) +{ + char * result = (char *)malloc( strlen(s)+1 ); + + if (result != NULL) + { + strcpy( result, s ); + } + + return( result ); +} + +#endif /* def __MINGW32__ */ + + + +/********************************************************************* + * + * Function : safe_strerror + * + * Description : Variant of the library routine strerror() which will + * work on systems without the library routine, and + * which should never return NULL. + * + * Parameters : + * 1 : err = the `errno' of the last operation. + * + * Returns : An "English" string of the last `errno'. Allocated + * with strdup(), so caller frees. May be NULL if the + * system is out of memory. + * + *********************************************************************/ +char *safe_strerror(int err) +{ + char *s = NULL; + char buf[BUFFER_SIZE]; + + +#ifdef HAVE_STRERROR + s = strerror(err); +#endif /* HAVE_STRERROR */ + + if (s == NULL) + { + snprintf(buf, sizeof(buf), "(errno = %d)", err); + s = buf; + } + + return(strdup(s)); + +} + + /********************************************************************* * * Function : strcmpic @@ -194,7 +550,7 @@ int strcmpic(const char *s1, const char *s2) * * Function : strncmpic * - * Description : Case insensitive string comparison (up to n characters) + * Description : Case insensitive string comparison (upto n characters) * * Parameters : * 1 : s1 = string 1 to compare @@ -209,7 +565,7 @@ int strncmpic(const char *s1, const char *s2, size_t n) if (n <= (size_t)0) return(0); if (!s1) s1 = ""; if (!s2) s2 = ""; - + while (*s1 && *s2) { if ( ( *s1 != *s2 ) && ( ijb_tolower(*s1) != ijb_tolower(*s2) ) ) @@ -243,7 +599,7 @@ char *chomp(char *string) { char *p, *q, *r;
- /* + /* * strip trailing whitespace */ p = string + strlen(string); @@ -253,8 +609,8 @@ char *chomp(char *string) } *p = '\0';
- /* - * find end of leading whitespace + /* + * find end of leading whitespace */ q = r = string; while (*q && ijb_isspace(*q)) @@ -282,7 +638,7 @@ char *chomp(char *string) * * Function : string_append * - * Description : Reallocate target_string and append text to it. + * Description : Reallocate target_string and append text to it. * This makes it easier to append to malloc'd strings. * This is similar to the (removed) strsav(), but * running out of memory isn't catastrophic. @@ -427,7 +783,7 @@ jb_err string_join(char **target_string, char *text_to_append) * Parameters : * 1 : string = string to convert * - * Returns : Uppercase copy of string if possible, + * Returns : Uppercase copy of string if possible, * NULL on out-of-memory or if string was NULL. * *********************************************************************/ @@ -440,7 +796,7 @@ char *string_toupper(const char *string) { return NULL; } - + q = string; p = result;
@@ -490,11 +846,11 @@ char *bindup(const char *string, size_t len) * * Function : make_path * - * Description : Takes a directory name and a file name, returns + * Description : Takes a directory name and a file name, returns * the complete path. Handles windows/unix differences. * If the file name is already an absolute path, or if - * the directory name is NULL or empty, it returns - * the filename. + * the directory name is NULL or empty, it returns + * the filename. * * Parameters : * 1 : dir: Name of directory or NULL for none. @@ -503,7 +859,7 @@ char *bindup(const char *string, size_t len) * Returns : "dir/file" (Or on windows, "dir\file"). * It allocates the string on the heap. Caller frees. * Returns NULL in error (i.e. NULL file or out of - * memory) + * memory) * *********************************************************************/ char * make_path(const char * dir, const char * file) @@ -585,7 +941,6 @@ char * make_path(const char * dir, const char * file) strlcpy(path, dir, path_size); }
- assert(NULL != path); #if defined(_WIN32) || defined(__OS2__) if(path[strlen(path)-1] != '\') { @@ -616,7 +971,7 @@ char * make_path(const char * dir, const char * file) * Parameters : * 1 : range: Highest possible number to pick. * - * Returns : Picked number. + * Returns : Picked number. * *********************************************************************/ long int pick_from_range(long int range) @@ -632,7 +987,7 @@ long int pick_from_range(long int range) if (range <= 0) return 0;
#ifdef HAVE_RANDOM - number = random() % range + 1; + number = random() % range + 1; #elif defined(MUTEX_LOCKS_AVAILABLE) privoxy_mutex_lock(&rand_mutex); #ifdef _WIN32 @@ -736,7 +1091,7 @@ size_t privoxy_strlcat(char *destination, const char *source, const size_t size) * Parameters : * 1 : tm: Broken-down time struct. * - * Returns : tm converted into time_t seconds. + * Returns : tm converted into time_t seconds. * *********************************************************************/ time_t timegm(struct tm *tm) @@ -788,7 +1143,7 @@ time_t timegm(struct tm *tm) snprintf.c - a portable implementation of snprintf, including vsnprintf.c, asnprintf, vasnprintf, asprintf, vasprintf - + snprintf is a routine to convert numeric and string arguments to formatted strings. It is similar to sprintf(3) provided in a system's C library, yet it requires an additional argument - the buffer size - @@ -1430,7 +1785,7 @@ int portable_vsnprintf(char *str, size_t str_m, const char *fmt, va_list ap) { } } /* zero padding to specified precision? */ - if (num_of_digits < precision) + if (num_of_digits < precision) number_of_zeros_to_pad = precision - num_of_digits; } /* zero padding to specified minimal field width? */ @@ -1448,7 +1803,7 @@ int portable_vsnprintf(char *str, size_t str_m, const char *fmt, va_list ap) { #if defined(PERL_COMPATIBLE) || defined(LINUX_COMPATIBLE) /* keep the entire format string unchanged */ str_arg = starting_p; str_arg_l = p - starting_p; - /* well, not exactly so for Linux, which does something between, + /* well, not exactly so for Linux, which does something inbetween, * and I don't feel an urge to imitate it: "%+++++hy" -> "%+y" */ #else /* discard the unrecognized conversion, just keep * diff --git a/external/privoxy/miscutil.h b/external/privoxy/miscutil.h index d66ebac..a0498ac 100644 --- a/external/privoxy/miscutil.h +++ b/external/privoxy/miscutil.h @@ -1,23 +1,23 @@ #ifndef MISCUTIL_H_INCLUDED #define MISCUTIL_H_INCLUDED -#define MISCUTIL_H_VERSION "$Id: miscutil.h,v 1.34 2011/09/04 11:10:56 fabiankeil Exp $" +#define MISCUTIL_H_VERSION "$Id: miscutil.h,v 1.30 2008/04/17 14:53:31 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/miscutil.h,v $ * - * Purpose : zalloc, hash_string, strcmpic, strncmpic, and - * MinGW32 strdup functions. These are each too small - * to deserve their own file but don't really fit in - * any other file. + * Purpose : zalloc, hash_string, safe_strerror, strcmpic, + * strncmpic, and MinGW32 strdup functions. These are + * each too small to deserve their own file but don't + * really fit in any other file. * - * Copyright : Written by and Copyright (C) 2001-2011 the + * Copyright : Written by and Copyright (C) 2001-2007 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -35,8 +35,156 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: miscutil.h,v $ + * Revision 1.30 2008/04/17 14:53:31 fabiankeil + * Move simplematch() into urlmatch.c as it's only + * used to match (old-school) domain patterns. + * + * Revision 1.29 2007/09/09 18:20:20 fabiankeil + * Turn privoxy_strlcpy() into a function and try to work with + * b0rked snprintf() implementations too. Reported by icmp30. + * + * Revision 1.28 2007/05/11 11:48:16 fabiankeil + * - Delete strsav() which was replaced + * by string_append() years ago. + * - Add a strlcat() look-alike. + * - Use strlcat() and strlcpy() in those parts + * of the code that are run on unixes. + * + * Revision 1.27 2007/04/09 17:48:51 fabiankeil + * Check for HAVE_SNPRINTF instead of __OS2__ + * before including the portable snprintf() code. + * + * Revision 1.26 2007/04/08 17:04:51 fabiankeil + * Add macro for strlcpy() in case the libc lacks it. + * + * Revision 1.25 2007/01/18 15:03:20 fabiankeil + * Don't include replacement timegm() if + * putenv() or tzset() isn't available. + * + * Revision 1.24 2006/08/17 17:15:10 fabiankeil + * - Back to timegm() using GnuPG's replacement if necessary. + * Using mktime() and localtime() could add a on hour offset if + * the randomize factor was big enough to lead to a summer/wintertime + * switch. + * + * - Removed now-useless Privoxy 3.0.3 compatibility glue. + * + * - Moved randomization code into pick_from_range(). + * + * - Changed parse_header_time definition. + * time_t isn't guaranteed to be signed and + * if it isn't, -1 isn't available as error code. + * Changed some variable types in client_if_modified_since() + * because of the same reason. + * + * Revision 1.23 2006/07/18 14:48:47 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.21 2002/04/26 12:55:38 oes + * New function string_toupper + * + * Revision 1.20 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.19 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.18 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.17 2002/03/04 18:28:32 oes + * Deleted deletePidFile, played syleguide police + * + * Revision 1.16 2002/01/21 00:53:36 jongfoster + * Adding string_join() + * + * Revision 1.15 2001/12/30 14:07:32 steudten + * - Add signal handling (unix) + * - Add SIGHUP handler (unix) + * - Add creation of pidfile (unix) + * - Add action 'top' in rc file (RH) + * - Add entry 'SIGNALS' to manpage + * - Add exit message to logfile (unix) + * + * Revision 1.14 2001/11/05 21:43:48 steudten + * Add global var 'basedir' for unix os. + * + * Revision 1.13 2001/10/29 03:48:10 david__schmidt + * OS/2 native needed a snprintf() routine. Added one to miscutil, brackedted + * by and __OS2__ ifdef. + * + * Revision 1.12 2001/10/23 21:27:50 jongfoster + * Standardising error codes in string_append + * make_path() no longer adds '\' if the dir already ends in '\' (this + * is just copying a UNIX-specific fix to the Windows-specific part) + * + * Revision 1.11 2001/10/14 22:02:57 jongfoster + * New function string_append() which is like strsav(), but running + * out of memory isn't automatically FATAL. + * + * Revision 1.10 2001/09/20 13:34:09 steudten + * + * change long to int for prototype hash_string() + * + * Revision 1.9 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.8 2001/06/29 13:32:14 oes + * Removed logentry from cancelled commit + * + * Revision 1.7 2001/06/05 22:32:01 jongfoster + * New function make_path() to splice directory and file names together. + * + * Revision 1.6 2001/06/03 19:12:30 oes + * introduced bindup() + * + * Revision 1.5 2001/06/01 10:31:51 oes + * Added character class matching to trivimatch; renamed to simplematch + * + * Revision 1.4 2001/05/31 17:32:31 oes + * + * - Enhanced domain part globbing with infix and prefix asterisk + * matching and optional unanchored operation + * + * Revision 1.3 2001/05/29 23:10:09 oes + * + * + * - Introduced chomp() + * - Moved strsav() from showargs to miscutil + * + * Revision 1.2 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.1.1.1 2001/05/15 13:59:00 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "project.h"
@@ -53,6 +201,8 @@ extern void write_pid_file(void);
extern unsigned int hash_string(const char* s);
+extern char *safe_strerror(int err); + extern int strcmpic(const char *s1, const char *s2); extern int strncmpic(const char *s1, const char *s2, size_t n);
@@ -67,6 +217,10 @@ extern char *make_path(const char * dir, const char * file);
long int pick_from_range(long int range);
+#ifdef __MINGW32__ +extern char *strdup(const char *s); +#endif /* def __MINGW32__ */ + #ifndef HAVE_SNPRINTF extern int snprintf(char *, size_t, const char *, /*args*/ ...); #endif /* ndef HAVE_SNPRINTF */ diff --git a/external/privoxy/mkinstalldirs b/external/privoxy/mkinstalldirs old mode 100644 new mode 100755 diff --git a/external/privoxy/parsers.c b/external/privoxy/parsers.c index 0cdee76..021762e 100644 --- a/external/privoxy/parsers.c +++ b/external/privoxy/parsers.c @@ -1,4 +1,4 @@ -const char parsers_rcs[] = "$Id: parsers.c,v 1.237 2011/11/06 11:36:27 fabiankeil Exp $"; +const char parsers_rcs[] = "$Id: parsers.c,v 1.154 2009/03/13 14:10:07 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/parsers.c,v $ @@ -42,8 +42,848 @@ const char parsers_rcs[] = "$Id: parsers.c,v 1.237 2011/11/06 11:36:27 fabiankei * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: parsers.c,v $ + * Revision 1.154 2009/03/13 14:10:07 fabiankeil + * Fix some more harmless warnings on amd64. + * + * Revision 1.153 2009/03/07 13:09:17 fabiankeil + * Change csp->expected_content and_csp->expected_content_length from + * size_t to unsigned long long to reduce the likelihood of integer + * overflows that would let us close the connection prematurely. + * Bug found while investigating #2669131, reported by cyberpatrol. + * + * Revision 1.152 2009/03/01 18:43:48 fabiankeil + * Help clang understand that we aren't dereferencing + * NULL pointers here. + * + * Revision 1.151 2009/02/15 14:46:35 fabiankeil + * Don't let hide-referrer{conditional-*}} pass + * Referer headers without http URLs. + * + * Revision 1.150 2008/12/04 18:12:19 fabiankeil + * Fix some cparser warnings. + * + * Revision 1.149 2008/11/21 18:39:53 fabiankeil + * In case of CONNECT requests there's no point + * in trying to keep the connection alive. + * + * Revision 1.148 2008/11/16 12:43:49 fabiankeil + * Turn keep-alive support into a runtime feature + * that is disabled by setting keep-alive-timeout + * to a negative value. + * + * Revision 1.147 2008/11/04 17:20:31 fabiankeil + * HTTP/1.1 responses without Connection + * header imply keep-alive. Act accordingly. + * + * Revision 1.146 2008/10/12 16:46:35 fabiankeil + * Remove obsolete warning about delayed delivery with chunked + * transfer encoding and FEATURE_CONNECTION_KEEP_ALIVE enabled. + * + * Revision 1.145 2008/10/09 18:21:41 fabiankeil + * Flush work-in-progress changes to keep outgoing connections + * alive where possible. Incomplete and mostly #ifdef'd out. + * + * Revision 1.144 2008/09/21 13:59:33 fabiankeil + * Treat unknown change-x-forwarded-for parameters as fatal errors. + * + * Revision 1.143 2008/09/21 13:36:52 fabiankeil + * If change-x-forwarded-for{add} is used and the client + * sends multiple X-Forwarded-For headers, append the client's + * IP address to each one of them. "Traditionally" we would + * lose all but the last one. + * + * Revision 1.142 2008/09/20 10:04:33 fabiankeil + * Remove hide-forwarded-for-headers action which has + * been obsoleted by change-x-forwarded-for{block}. + * + * Revision 1.141 2008/09/19 15:26:28 fabiankeil + * Add change-x-forwarded-for{} action to block or add + * X-Forwarded-For headers. Mostly based on code removed + * before 3.0.7. + * + * Revision 1.140 2008/09/12 17:51:43 fabiankeil + * - A few style fixes. + * - Remove a pointless cast. + * + * Revision 1.139 2008/09/04 08:13:58 fabiankeil + * Prepare for critical sections on Windows by adding a + * layer of indirection before the pthread mutex functions. + * + * Revision 1.138 2008/08/30 12:03:07 fabiankeil + * Remove FEATURE_COOKIE_JAR. + * + * Revision 1.137 2008/05/30 15:50:08 fabiankeil + * Remove questionable micro-optimizations + * whose usefulness has never been measured. + * + * Revision 1.136 2008/05/26 16:02:24 fabiankeil + * s@Insufficent@Insufficient@ + * + * Revision 1.135 2008/05/21 20:12:10 fabiankeil + * The whole point of strclean() is to modify the + * first parameter, so don't mark it immutable, + * even though the compiler lets us get away with it. + * + * Revision 1.134 2008/05/21 19:27:25 fabiankeil + * As the wafer actions are gone, we can stop including encode.h. + * + * Revision 1.133 2008/05/21 15:50:47 fabiankeil + * Ditch cast from (char **) to (char **). + * + * Revision 1.132 2008/05/21 15:47:14 fabiankeil + * Streamline sed()'s prototype and declare + * the header parse and add structures static. + * + * Revision 1.131 2008/05/20 20:13:30 fabiankeil + * Factor update_server_headers() out of sed(), ditch the + * first_run hack and make server_patterns_light static. + * + * Revision 1.130 2008/05/19 17:18:04 fabiankeil + * Wrap memmove() calls in string_move() + * to document the purpose in one place. + * + * Revision 1.129 2008/05/17 14:02:07 fabiankeil + * Normalize linear header white space. + * + * Revision 1.128 2008/05/16 16:39:03 fabiankeil + * If a header is split across multiple lines, + * merge them to a single line before parsing them. + * + * Revision 1.127 2008/05/10 13:23:38 fabiankeil + * Don't provide get_header() with the whole client state + * structure when it only needs access to csp->iob. + * + * Revision 1.126 2008/05/03 16:40:45 fabiankeil + * Change content_filters_enabled()'s parameter from + * csp->action to action so it can be also used in the + * CGI code. Don't bother checking if there are filters + * loaded, as that's somewhat besides the point. + * + * Revision 1.125 2008/04/17 14:40:49 fabiankeil + * Provide get_http_time() with the buffer size so it doesn't + * have to blindly assume that the buffer is big enough. + * + * Revision 1.124 2008/04/16 16:38:21 fabiankeil + * Don't pass the whole csp structure to flush_socket() + * when it only needs a file descriptor and a buffer. + * + * Revision 1.123 2008/03/29 12:13:46 fabiankeil + * Remove send-wafer and send-vanilla-wafer actions. + * + * Revision 1.122 2008/03/28 15:13:39 fabiankeil + * Remove inspect-jpegs action. + * + * Revision 1.121 2008/01/05 21:37:03 fabiankeil + * Let client_range() also handle Request-Range headers + * which apparently are still supported by many servers. + * + * Revision 1.120 2008/01/04 17:43:45 fabiankeil + * Improve the warning messages that get logged if the action files + * "enable" filters but no filters of that type have been loaded. + * + * Revision 1.119 2007/12/28 18:32:51 fabiankeil + * In server_content_type(): + * - Don't require leading white space when detecting image content types. + * - Change '... not replaced ...' message to sound less crazy if the text + * type actually is 'text/plain'. + * - Mark the 'text/plain == binary data' assumption for removal. + * - Remove a bunch of trailing white space. + * + * Revision 1.118 2007/12/28 16:56:35 fabiankeil + * Minor server_content_disposition() changes: + * - Don't regenerate the header name all lower-case. + * - Some white space fixes. + * - Remove useless log message in case of ENOMEM. + * + * Revision 1.117 2007/12/06 18:11:50 fabiankeil + * Garbage-collect the code to add a X-Forwarded-For + * header as it seems to be mostly used by accident. + * + * Revision 1.116 2007/12/01 13:04:22 fabiankeil + * Fix a crash on mingw32 with some Last Modified times in the future. + * + * Revision 1.115 2007/11/02 16:52:50 fabiankeil + * Remove a "can't happen" error block which, over + * time, mutated into a "guaranteed to happen" block. + * + * Revision 1.114 2007/10/19 16:56:26 fabiankeil + * - Downgrade "Buffer limit reached" message to LOG_LEVEL_INFO. + * - Use shiny new content_filters_enabled() in client_range(). + * + * Revision 1.113 2007/10/10 17:29:57 fabiankeil + * I forgot about Poland. + * + * Revision 1.112 2007/10/09 16:38:40 fabiankeil + * Remove Range and If-Range headers if content filtering is enabled. + * + * Revision 1.111 2007/10/04 18:07:00 fabiankeil + * Move ACTION_VANILLA_WAFER handling from jcc's chat() into + * client_cookie_adder() to make sure send-vanilla-wafer can be + * controlled through tags (and thus regression-tested). + * + * Revision 1.110 2007/09/29 10:42:37 fabiankeil + * - Remove "scanning headers for" log message again. + * - Some more whitespace fixes. + * + * Revision 1.109 2007/09/08 14:25:48 fabiankeil + * Refactor client_referrer() and add conditional-forge parameter. + * + * Revision 1.108 2007/08/28 18:21:03 fabiankeil + * A bunch of whitespace fixes, pointy hat to me. + * + * Revision 1.107 2007/08/28 18:16:32 fabiankeil + * Fix possible memory corruption in server_http, make sure it's not + * executed for ordinary server headers and mark some problems for later. + * + * Revision 1.106 2007/08/18 14:30:32 fabiankeil + * Let content-type-overwrite{} honour force-text-mode again. + * + * Revision 1.105 2007/08/11 14:49:49 fabiankeil + * - Add prototpyes for the header parsers and make them static. + * - Comment out client_accept_encoding_adder() which isn't used right now. + * + * Revision 1.104 2007/07/14 07:38:19 fabiankeil + * Move the ACTION_FORCE_TEXT_MODE check out of + * server_content_type(). Signal other functions + * whether or not a content type has been declared. + * Part of the fix for BR#1750917. + * + * Revision 1.103 2007/06/01 16:31:54 fabiankeil + * Change sed() to return a jb_err in preparation for forward-override{}. + * + * Revision 1.102 2007/05/27 12:39:32 fabiankeil + * Adjust "X-Filter: No" to disable dedicated header filters. + * + * Revision 1.101 2007/05/14 10:16:41 fabiankeil + * Streamline client_cookie_adder(). + * + * Revision 1.100 2007/04/30 15:53:11 fabiankeil + * Make sure filters with dynamic jobs actually use them. + * + * Revision 1.99 2007/04/30 15:06:26 fabiankeil + * - Introduce dynamic pcrs jobs that can resolve variables. + * - Remove unnecessary update_action_bits_for_all_tags() call. + * + * Revision 1.98 2007/04/17 18:32:10 fabiankeil + * - Make tagging based on tags set by earlier taggers + * of the same kind possible. + * - Log whether or not new tags cause action bits updates + * (in which case a matching tag-pattern section exists). + * - Log if the user tries to set a tag that is already set. + * + * Revision 1.97 2007/04/15 16:39:21 fabiankeil + * Introduce tags as alternative way to specify which + * actions apply to a request. At the moment tags can be + * created based on client and server headers. + * + * Revision 1.96 2007/04/12 12:53:58 fabiankeil + * Log a warning if the content is compressed, filtering is + * enabled and Privoxy was compiled without zlib support. + * Closes FR#1673938. + * + * Revision 1.95 2007/03/25 14:26:40 fabiankeil + * - Fix warnings when compiled with glibc. + * - Don't use crumble() for cookie crunching. + * - Move cookie time parsing into parse_header_time(). + * - Let parse_header_time() return a jb_err code + * instead of a pointer that can only be used to + * check for NULL anyway. + * + * Revision 1.94 2007/03/21 12:23:53 fabiankeil + * - Add better protection against malicious gzip headers. + * - Stop logging the first hundred bytes of decompressed content. + * It looks like it's working and there is always debug 16. + * - Log the content size after decompression in decompress_iob() + * instead of pcrs_filter_response(). + * + * Revision 1.93 2007/03/20 15:21:44 fabiankeil + * - Use dedicated header filter actions instead of abusing "filter". + * Replace "filter-client-headers" and "filter-client-headers" + * with "server-header-filter" and "client-header-filter". + * - Remove filter_client_header() and filter_client_header(), + * filter_header() now checks the shiny new + * CSP_FLAG_CLIENT_HEADER_PARSING_DONE flag instead. + * + * Revision 1.92 2007/03/05 13:25:32 fabiankeil + * - Cosmetical changes for LOG_LEVEL_RE_FILTER messages. + * - Handle "Cookie:" and "Connection:" headers a bit smarter + * (don't crunch them just to recreate them later on). + * - Add another non-standard time format for the cookie + * expiration date detection. + * - Fix a valgrind warning. + * + * Revision 1.91 2007/02/24 12:27:32 fabiankeil + * Improve cookie expiration date detection. + * + * Revision 1.90 2007/02/08 19:12:35 fabiankeil + * Don't run server_content_length() the first time + * sed() parses server headers; only adjust the + * Content-Length header if the page was modified. + * + * Revision 1.89 2007/02/07 16:52:11 fabiankeil + * Fix log messages regarding the cookie time format + * (cookie and request URL were mixed up). + * + * Revision 1.88 2007/02/07 11:27:12 fabiankeil + * - Let decompress_iob() + * - not corrupt the content if decompression fails + * early. (the first byte(s) were lost). + * - use pointer arithmetics with defined outcome for + * a change. + * - Use a different kludge to remember a failed decompression. + * + * Revision 1.87 2007/01/31 16:21:38 fabiankeil + * Search for Max-Forwards headers case-insensitive, + * don't generate the "501 unsupported" message for invalid + * Max-Forwards values and don't increase negative ones. + * + * Revision 1.86 2007/01/30 13:05:26 fabiankeil + * - Let server_set_cookie() check the expiration date + * of cookies and don't touch the ones that are already + * expired. Fixes problems with low quality web applications + * as described in BR 932612. + * + * - Adjust comment in client_max_forwards to reality; + * remove invalid Max-Forwards headers. + * + * Revision 1.85 2007/01/26 15:33:46 fabiankeil + * Stop filter_header() from unintentionally removing + * empty header lines that were enlisted by the continue + * hack. + * + * Revision 1.84 2007/01/24 12:56:52 fabiankeil + * - Repeat the request URL before logging any headers. + * Makes reading the log easier in case of simultaneous requests. + * - If there are more than one Content-Type headers in one request, + * use the first one and remove the others. + * - Remove "newval" variable in server_content_type(). + * It's only used once. + * + * Revision 1.83 2007/01/12 15:03:02 fabiankeil + * Correct a cast, check inflateEnd() exit code + * to see if we have to, replace sprintf calls + * with snprintf. + * + * Revision 1.82 2007/01/01 19:36:37 fabiankeil + * Integrate a modified version of Wil Mahan's + * zlib patch (PR #895531). + * + * Revision 1.81 2006/12/31 22:21:33 fabiankeil + * Skip empty filter files in filter_header() + * but don't ignore the ones that come afterwards. + * Fixes BR 1619208, this time for real. + * + * Revision 1.80 2006/12/29 19:08:22 fabiankeil + * Reverted parts of my last commit + * to keep error handling working. + * + * Revision 1.79 2006/12/29 18:04:40 fabiankeil + * Fixed gcc43 conversion warnings. + * + * Revision 1.78 2006/12/26 17:19:20 fabiankeil + * Bringing back the "useless" localtime() call + * I removed in revision 1.67. On some platforms + * it's necessary to prevent time zone offsets. + * + * Revision 1.77 2006/12/07 18:44:26 fabiankeil + * Rebuild request URL in get_destination_from_headers() + * to make sure redirect{pcrs command} works as expected + * for intercepted requests. + * + * Revision 1.76 2006/12/06 19:52:25 fabiankeil + * Added get_destination_from_headers(). + * + * Revision 1.75 2006/11/13 19:05:51 fabiankeil + * Make pthread mutex locking more generic. Instead of + * checking for OSX and OpenBSD, check for FEATURE_PTHREAD + * and use mutex locking unless there is an _r function + * available. Better safe than sorry. + * + * Fixes "./configure --disable-pthread" and should result + * in less threading-related problems on pthread-using platforms, + * but it still doesn't fix BR#1122404. + * + * Revision 1.74 2006/10/02 16:59:12 fabiankeil + * The special header "X-Filter: No" now disables + * header filtering as well. + * + * Revision 1.73 2006/09/23 13:26:38 roro + * Replace TABs by spaces in source code. + * + * Revision 1.72 2006/09/23 12:37:21 fabiankeil + * Don't print a log message every time filter_headers is + * entered or left. It only creates noise without any real + * information. + * + * Revision 1.71 2006/09/21 19:55:17 fabiankeil + * Fix +hide-if-modified-since{-n}. + * + * Revision 1.70 2006/09/08 12:06:34 fabiankeil + * Have hide-if-modified-since interpret the random + * range value as minutes instead of hours. Allows + * more fine-grained configuration. + * + * Revision 1.69 2006/09/06 16:25:51 fabiankeil + * Always have parse_header_time return a pointer + * that actual makes sense, even though we currently + * only need it to detect problems. + * + * Revision 1.68 2006/09/06 10:43:32 fabiankeil + * Added config option enable-remote-http-toggle + * to specify if Privoxy should recognize special + * headers (currently only X-Filter) to change its + * behaviour. Disabled by default. + * + * Revision 1.67 2006/09/04 11:01:26 fabiankeil + * After filtering de-chunked instances, remove + * "Transfer-Encoding" header entirely instead of changing + * it to "Transfer-Encoding: identity", which is invalid. + * Thanks Michael Shields shields@msrl.com. Fixes PR 1318658. + * + * Don't use localtime in parse_header_time. An empty time struct + * is good enough, it gets overwritten by strptime anyway. + * + * Revision 1.66 2006/09/03 19:38:28 fabiankeil + * Use gmtime_r if available, fallback to gmtime with mutex + * protection for MacOSX and use vanilla gmtime for the rest. + * + * Revision 1.65 2006/08/22 10:55:56 fabiankeil + * Changed client_referrer to use the right type (size_t) for + * hostlenght and to shorten the temporary referrer string with + * '\0' instead of adding a useless line break. + * + * Revision 1.64 2006/08/17 17:15:10 fabiankeil + * - Back to timegm() using GnuPG's replacement if necessary. + * Using mktime() and localtime() could add a on hour offset if + * the randomize factor was big enough to lead to a summer/wintertime + * switch. + * + * - Removed now-useless Privoxy 3.0.3 compatibility glue. + * + * - Moved randomization code into pick_from_range(). + * + * - Changed parse_header_time definition. + * time_t isn't guaranteed to be signed and + * if it isn't, -1 isn't available as error code. + * Changed some variable types in client_if_modified_since() + * because of the same reason. + * + * Revision 1.63 2006/08/14 13:18:08 david__schmidt + * OS/2 compilation compatibility fixups + * + * Revision 1.62 2006/08/14 08:58:42 fabiankeil + * Changed include from strptime.c to strptime.h + * + * Revision 1.61 2006/08/14 08:25:19 fabiankeil + * Split filter-headers{} into filter-client-headers{} + * and filter-server-headers{}. + * Added parse_header_time() to share some code. + * Replaced timegm() with mktime(). + * + * Revision 1.60 2006/08/12 03:54:37 david__schmidt + * Windows service integration + * + * Revision 1.59 2006/08/03 02:46:41 david__schmidt + * Incorporate Fabian Keil's patch work:http://www.fabiankeil.de/sourcecode/privoxy/ + * + * Revision 1.58 2006/07/18 14:48:47 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.56.2.10 2006/01/21 16:16:08 david__schmidt + * Thanks to Edward Carrel for his patch to modernize OSX'spthreads support. See bug #1409623. + * + * Revision 1.56.2.9 2004/10/03 12:53:45 david__schmidt + * Add the ability to check jpeg images for invalid + * lengths of comment blocks. Defensive strategy + * against the exploit: + * Microsoft Security Bulletin MS04-028 + * Buffer Overrun in JPEG Processing (GDI+) Could + * Allow Code Execution (833987) + * Enabled with +inspect-jpegs in actions files. + * + * Revision 1.56.2.8 2003/07/11 13:21:25 oes + * Excluded text/plain objects from filtering. This fixes a + * couple of client-crashing, download corruption and + * Privoxy performance issues, whose root cause lies in + * web servers labelling content of unknown type as text/plain. + * + * Revision 1.56.2.7 2003/05/06 12:07:26 oes + * Fixed bug #729900: Suspicious HOST: headers are now killed and regenerated if necessary + * + * Revision 1.56.2.6 2003/04/14 21:28:30 oes + * Completing the previous change + * + * Revision 1.56.2.5 2003/04/14 12:08:16 oes + * Added temporary workaround for bug in PHP < 4.2.3 + * + * Revision 1.56.2.4 2003/03/07 03:41:05 david__schmidt + * Wrapping all *_r functions (the non-_r versions of them) with mutex semaphores for OSX. Hopefully this will take care of all of those pesky crash reports. + * + * Revision 1.56.2.3 2002/11/10 04:20:02 hal9 + * Fix typo: supressed -> suppressed + * + * Revision 1.56.2.2 2002/09/25 14:59:53 oes + * Improved cookie logging + * + * Revision 1.56.2.1 2002/09/25 14:52:45 oes + * Added basic support for OPTIONS and TRACE HTTP methods: + * - New parser function client_max_forwards which decrements + * the Max-Forwards HTTP header field of OPTIONS and TRACE + * requests by one before forwarding + * - New parser function client_host which extracts the host + * and port information from the HTTP header field if the + * request URI was not absolute + * - Don't crumble and re-add the Host: header, but only generate + * and append if missing + * + * Revision 1.56 2002/05/12 15:34:22 jongfoster + * Fixing typo in a comment + * + * Revision 1.55 2002/05/08 16:01:07 oes + * Optimized add_to_iob: + * - Use realloc instead of malloc(), memcpy(), free() + * - Expand to powers of two if possible, to get + * O(log n) reallocs instead of O(n). + * - Moved check for buffer limit here from chat + * - Report failure via returncode + * + * Revision 1.54 2002/04/02 15:03:16 oes + * Tiny code cosmetics + * + * Revision 1.53 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.52 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.51 2002/03/13 00:27:05 jongfoster + * Killing warnings + * + * Revision 1.50 2002/03/12 01:45:35 oes + * More verbose logging + * + * Revision 1.49 2002/03/09 20:03:52 jongfoster + * - Making various functions return int rather than size_t. + * (Undoing a recent change). Since size_t is unsigned on + * Windows, functions like read_socket that return -1 on + * error cannot return a size_t. + * + * THIS WAS A MAJOR BUG - it caused frequent, unpredictable + * crashes, and also frequently caused JB to jump to 100% + * CPU and stay there. (Because it thought it had just + * read ((unsigned)-1) == 4Gb of data...) + * + * - The signature of write_socket has changed, it now simply + * returns success=0/failure=nonzero. + * + * - Trying to get rid of a few warnings --with-debug on + * Windows, I've introduced a new type "jb_socket". This is + * used for the socket file descriptors. On Windows, this + * is SOCKET (a typedef for unsigned). Everywhere else, it's + * an int. The error value can't be -1 any more, so it's + * now JB_INVALID_SOCKET (which is -1 on UNIX, and in + * Windows it maps to the #define INVALID_SOCKET.) + * + * - The signature of bind_port has changed. + * + * Revision 1.48 2002/03/07 03:46:53 oes + * Fixed compiler warnings etc + * + * Revision 1.47 2002/02/20 23:15:13 jongfoster + * Parsing functions now handle out-of-memory gracefully by returning + * an error code. + * + * Revision 1.46 2002/01/17 21:03:47 jongfoster + * Moving all our URL and URL pattern parsing code to urlmatch.c. + * + * Revision 1.45 2002/01/09 14:33:03 oes + * Added support for localtime_r. + * + * Revision 1.44 2001/12/14 01:22:54 steudten + * Remove 'user:pass@' from 'proto://user:pass@host' for the + * new added header 'Host: ..'. (See Req ID 491818) + * + * Revision 1.43 2001/11/23 00:26:38 jongfoster + * Fixing two really stupid errors in my previous commit + * + * Revision 1.42 2001/11/22 21:59:30 jongfoster + * Adding code to handle +no-cookies-keep + * + * Revision 1.41 2001/11/05 23:43:05 steudten + * Add time+date to log files. + * + * Revision 1.40 2001/10/26 20:13:09 jongfoster + * ctype.h is needed in Windows, too. + * + * Revision 1.39 2001/10/26 17:40:04 oes + * Introduced get_header_value() + * Removed http->user_agent, csp->referrer and csp->accept_types + * Removed client_accept() + * + * Revision 1.38 2001/10/25 03:40:48 david__schmidt + * Change in porting tactics: OS/2's EMX porting layer doesn't allow multiple + * threads to call select() simultaneously. So, it's time to do a real, live, + * native OS/2 port. See defines for __EMX__ (the porting layer) vs. __OS2__ + * (native). Both versions will work, but using __OS2__ offers multi-threading. + * + * Revision 1.37 2001/10/23 21:36:02 jongfoster + * Documenting sed()'s error behaviou (doc change only) + * + * Revision 1.36 2001/10/13 12:51:51 joergs + * Removed client_host, (was only required for the old 2.0.2-11 http://noijb. + * force-load), instead crumble Host: and add it (again) in client_host_adder + * (in case we get a HTTP/1.0 request without Host: header and forward it to + * a HTTP/1.1 server/proxy). + * + * Revision 1.35 2001/10/09 22:39:21 jongfoster + * assert.h is also required under Win32, so moving out of #ifndef _WIN32 + * block. + * + * Revision 1.34 2001/10/07 18:50:55 oes + * Added server_content_encoding, renamed server_transfer_encoding + * + * Revision 1.33 2001/10/07 18:04:49 oes + * Changed server_http11 to server_http and its pattern to "HTTP". + * Additional functionality: it now saves the HTTP status into + * csp->http->status and sets CT_TABOO for Status 206 (partial range) + * + * Revision 1.32 2001/10/07 15:43:28 oes + * Removed FEATURE_DENY_GZIP and replaced it with client_accept_encoding, + * client_te and client_accept_encoding_adder, triggered by the new + * +no-compression action. For HTTP/1.1 the Accept-Encoding header is + * changed to allow only identity and chunked, and the TE header is + * crunched. For HTTP/1.0, Accept-Encoding is crunched. + * + * parse_http_request no longer does anything than parsing. The rewriting + * of http->cmd and version mangling are gone. It now also recognizes + * the put and delete methods and saves the url in http->url. Removed + * unused variable. + * + * renamed content_type and content_length to have the server_ prefix + * + * server_content_type now only works if csp->content_type != CT_TABOO + * + * added server_transfer_encoding, which + * - Sets CT_TABOO to prohibit filtering if encoding compresses + * - Raises the CSP_FLAG_CHUNKED flag if Encoding is "chunked" + * - Change from "chunked" to "identity" if body was chunked + * but has been de-chunked for filtering. + * + * added server_content_md5 which crunches any Content-MD5 headers + * if the body was modified. + * + * made server_http11 conditional on +downgrade action + * + * Replaced 6 boolean members of csp with one bitmap (csp->flags) + * + * Revision 1.31 2001/10/05 14:25:02 oes + * Crumble Keep-Alive from Server + * + * Revision 1.30 2001/09/29 12:56:03 joergs + * IJB now changes HTTP/1.1 to HTTP/1.0 in requests and answers. + * + * Revision 1.29 2001/09/24 21:09:24 jongfoster + * Fixing 2 memory leaks that Guy spotted, where the paramater to + * enlist() was not being free()d. + * + * Revision 1.28 2001/09/22 16:32:28 jongfoster + * Removing unused #includes. + * + * Revision 1.27 2001/09/20 15:45:25 steudten + * + * add casting from size_t to int for printf() + * remove local variable shadow s2 + * + * Revision 1.26 2001/09/16 17:05:14 jongfoster + * Removing unused #include showarg.h + * + * Revision 1.25 2001/09/16 13:21:27 jongfoster + * Changes to use new list functions. + * + * Revision 1.24 2001/09/13 23:05:50 jongfoster + * Changing the string paramater to the header parsers a "const". + * + * Revision 1.23 2001/09/12 18:08:19 steudten + * + * In parse_http_request() header rewriting miss the host value, so + * from http://www.mydomain.com the result was just " / " not + * http://www.mydomain.com/ in case we forward. + * + * Revision 1.22 2001/09/10 10:58:53 oes + * Silenced compiler warnings + * + * Revision 1.21 2001/07/31 14:46:00 oes + * - Persistant connections now suppressed + * - sed() no longer appends empty header to csp->headers + * + * Revision 1.20 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.19 2001/07/25 17:21:54 oes + * client_uagent now saves copy of User-Agent: header value + * + * Revision 1.18 2001/07/13 14:02:46 oes + * - Included fix to repair broken HTTP requests that + * don't contain a path, not even '/'. + * - Removed all #ifdef PCRS + * - content_type now always inspected and classified as + * text, gif or other. + * - formatting / comments + * + * Revision 1.17 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.16 2001/06/29 13:32:42 oes + * - Fixed a comment + * - Adapted free_http_request + * - Removed logentry from cancelled commit + * + * Revision 1.15 2001/06/03 19:12:38 oes + * deleted const struct interceptors + * + * Revision 1.14 2001/06/01 18:49:17 jongfoster + * Replaced "list_share" with "list" - the tiny memory gain was not + * worth the extra complexity. + * + * Revision 1.13 2001/05/31 21:30:33 jongfoster + * Removed list code - it's now in list.[ch] + * Renamed "permission" to "action", and changed many features + * to use the actions file rather than the global config. + * + * Revision 1.12 2001/05/31 17:33:13 oes + * + * CRLF -> LF + * + * Revision 1.11 2001/05/29 20:11:19 joergs + * '/ * inside comment' warning removed. + * + * Revision 1.10 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.9 2001/05/28 17:26:33 jongfoster + * Fixing segfault if last header was crunched. + * Fixing Windows build (snprintf() is _snprintf() under Win32, but we + * can use the cross-platform sprintf() instead.) + * + * Revision 1.8 2001/05/27 22:17:04 oes + * + * - re_process_buffer no longer writes the modified buffer + * to the client, which was very ugly. It now returns the + * buffer, which it is then written by chat. + * + * - content_length now adjusts the Content-Length: header + * for modified documents rather than crunch()ing it. + * (Length info in csp->content_length, which is 0 for + * unmodified documents) + * + * - For this to work, sed() is called twice when filtering. + * + * Revision 1.7 2001/05/27 13:19:06 oes + * Patched Joergs solution for the content-length in. + * + * Revision 1.6 2001/05/26 13:39:32 jongfoster + * Only crunches Content-Length header if applying RE filtering. + * Without this fix, Microsoft Windows Update wouldn't work. + * + * Revision 1.5 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.4 2001/05/22 18:46:04 oes + * + * - Enabled filtering banners by size rather than URL + * by adding patterns that replace all standard banner + * sizes with the "Junkbuster" gif to the re_filterfile + * + * - Enabled filtering WebBugs by providing a pattern + * which kills all 1x1 images + * + * - Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * - Added a new interceptor ijb-send-banner, which + * sends back the "Junkbuster" gif. Without imagelist or + * MSIE detection support, or if tinygif = 1, or the + * URL isn't recognized as an imageurl, a lame HTML + * explanation is sent instead. + * + * - Added new feature, which permits blocking remote + * script redirects and firing back a local redirect + * to the browser. + * The feature is conditionally compiled, i.e. it + * can be disabled with --disable-fast-redirects, + * plus it must be activated by a "fast-redirects" + * line in the config file, has its own log level + * and of course wants to be displayed by show-proxy-args + * Note: Boy, all the #ifdefs in 1001 locations and + * all the fumbling with configure.in and acconfig.h + * were *way* more work than the feature itself :-( + * + * - Because a generic redirect template was needed for + * this, tinygif = 3 now uses the same. + * + * - Moved GIFs, and other static HTTP response templates + * to project.h + * + * - Some minor fixes + * + * - Removed some >400 CRs again (Jon, you really worked + * a lot! ;-) + * + * Revision 1.3 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.2 2001/05/17 23:02:36 oes + * - Made referrer option accept 'L' as a substitute for '§' + * + * Revision 1.1.1.1 2001/05/15 13:59:01 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -67,15 +907,6 @@ const char parsers_rcs[] = "$Id: parsers.c,v 1.237 2011/11/06 11:36:27 fabiankei
#ifdef FEATURE_ZLIB #include <zlib.h> - -#define GZIP_IDENTIFIER_1 0x1f -#define GZIP_IDENTIFIER_2 0x8b - -#define GZIP_FLAG_CHECKSUM 0x02 -#define GZIP_FLAG_EXTRA_FIELDS 0x04 -#define GZIP_FLAG_FILE_NAME 0x08 -#define GZIP_FLAG_COMMENT 0x10 -#define GZIP_FLAG_RESERVED_BITS 0xe0 #endif
#if !defined(_WIN32) && !defined(__OS2__) @@ -152,33 +983,22 @@ static jb_err server_http (struct client_state *csp, char **header static jb_err crunch_server_header (struct client_state *csp, char **header); static jb_err server_last_modified (struct client_state *csp, char **header); static jb_err server_content_disposition(struct client_state *csp, char **header); -#ifdef FEATURE_ZLIB -static jb_err server_adjust_content_encoding(struct client_state *csp, char **header); -#endif
#ifdef FEATURE_CONNECTION_KEEP_ALIVE static jb_err server_save_content_length(struct client_state *csp, char **header); -static jb_err server_keep_alive(struct client_state *csp, char **header); -static jb_err server_proxy_connection(struct client_state *csp, char **header); -static jb_err client_keep_alive(struct client_state *csp, char **header); -static jb_err client_save_content_length(struct client_state *csp, char **header); #endif /* def FEATURE_CONNECTION_KEEP_ALIVE */
static jb_err client_host_adder (struct client_state *csp); static jb_err client_xtra_adder (struct client_state *csp); static jb_err client_x_forwarded_for_adder(struct client_state *csp); static jb_err client_connection_header_adder(struct client_state *csp); -static jb_err server_connection_adder(struct client_state *csp); -#ifdef FEATURE_CONNECTION_KEEP_ALIVE -static jb_err server_proxy_connection_adder(struct client_state *csp); -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ +static jb_err server_connection_close_adder(struct client_state *csp);
static jb_err create_forged_referrer(char **header, const char *hostport); static jb_err create_fake_referrer(char **header, const char *fake_referrer); static jb_err handle_conditional_hide_referrer_parameter(char **header, const char *host, const int parameter_conditional_block); -static void create_content_length_header(unsigned long long content_length, - char *header, size_t buffer_length); +static const char *get_appropiate_connection_header(const struct client_state *csp);
/* * List of functions to run on a list of headers. @@ -187,10 +1007,10 @@ struct parsers { /** The header prefix to match */ const char *str; - + /** The length of the prefix to match */ const size_t len; - + /** The function to apply to this line */ const parser_func_ptr parser; }; @@ -206,12 +1026,7 @@ static const struct parsers client_patterns[] = { { "TE:", 3, client_te }, { "Host:", 5, client_host }, { "if-modified-since:", 18, client_if_modified_since }, -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - { "Keep-Alive:", 11, client_keep_alive }, - { "Content-Length:", 15, client_save_content_length }, -#else { "Keep-Alive:", 11, crumble }, -#endif { "connection:", 11, client_connection }, { "proxy-connection:", 17, crumble }, { "max-forwards:", 13, client_max_forwards }, @@ -235,12 +1050,9 @@ static const struct parsers server_patterns[] = { { "Content-Encoding:", 17, server_content_encoding }, #ifdef FEATURE_CONNECTION_KEEP_ALIVE { "Content-Length:", 15, server_save_content_length }, - { "Keep-Alive:", 11, server_keep_alive }, - { "Proxy-Connection:", 17, server_proxy_connection }, -#else - { "Keep-Alive:", 11, crumble }, #endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ { "Transfer-Encoding:", 18, server_transfer_coding }, + { "Keep-Alive:", 11, crumble }, { "content-disposition:", 20, server_content_disposition }, { "Last-Modified:", 14, server_last_modified }, { "*", 0, crunch_server_header }, @@ -252,15 +1064,13 @@ static const add_header_func_ptr add_client_headers[] = { client_host_adder, client_x_forwarded_for_adder, client_xtra_adder, + /* Temporarily disabled: client_accept_encoding_adder, */ client_connection_header_adder, NULL };
static const add_header_func_ptr add_server_headers[] = { - server_connection_adder, -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - server_proxy_connection_adder, -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ + server_connection_close_adder, NULL };
@@ -320,7 +1130,7 @@ long flush_socket(jb_socket fd, struct iob *iob) jb_err add_to_iob(struct client_state *csp, char *buf, long n) { struct iob *iob = csp->iob; - size_t used, offset, need; + size_t used, offset, need, want; char *p;
if (n <= 0) return JB_ERR_OK; @@ -343,13 +1153,8 @@ jb_err add_to_iob(struct client_state *csp, char *buf, long n)
if (need > iob->size) { - size_t want = csp->iob->size ? csp->iob->size : 512; - - while (want <= need) - { - want *= 2; - } - + for (want = csp->iob->size ? csp->iob->size : 512; want <= need;) want *= 2; + if (want <= csp->config->buffer_limit && NULL != (p = (char *)realloc(iob->buf, want))) { iob->size = want; @@ -405,7 +1210,7 @@ jb_err add_to_iob(struct client_state *csp, char *buf, long n) jb_err decompress_iob(struct client_state *csp) { char *buf; /* new, uncompressed buffer */ - char *cur; /* Current iob position (to keep the original + char *cur; /* Current iob position (to keep the original * iob->cur unmodified if we return early) */ size_t bufsize; /* allocated size of the new buffer */ size_t old_size; /* Content size before decompression */ @@ -447,8 +1252,8 @@ jb_err decompress_iob(struct client_state *csp) * Strip off the gzip header. Please see RFC 1952 for more * explanation of the appropriate fields. */ - if (((*cur++ & 0xff) != GZIP_IDENTIFIER_1) - || ((*cur++ & 0xff) != GZIP_IDENTIFIER_2) + if ((*cur++ != (char)0x1f) + || (*cur++ != (char)0x8b) || (*cur++ != Z_DEFLATED)) { log_error(LOG_LEVEL_ERROR, "Invalid gzip header when decompressing"); @@ -457,31 +1262,47 @@ jb_err decompress_iob(struct client_state *csp) else { int flags = *cur++; - if (flags & GZIP_FLAG_RESERVED_BITS) + /* + * XXX: These magic numbers should be replaced + * with macros to give a better idea what they do. + */ + if (flags & 0xe0) { /* The gzip header has reserved bits set; bail out. */ log_error(LOG_LEVEL_ERROR, "Invalid gzip header flags when decompressing"); return JB_ERR_COMPRESS; } - - /* - * Skip mtime (4 bytes), extra flags (1 byte) - * and OS type (1 byte). - */ cur += 6;
/* Skip extra fields if necessary. */ - if (flags & GZIP_FLAG_EXTRA_FIELDS) + if (flags & 0x04) { /* * Skip a given number of bytes, specified * as a 16-bit little-endian value. + */ + /* + * XXX: This code used to be: + * + * csp->iob->cur += *csp->iob->cur++ + (*csp->iob->cur++ << 8); + * + * which I had to change into: * - * XXX: this code is untested and should probably be removed. + * cur += *cur++ + (*cur++ << 8); + * + * at which point gcc43 finally noticed that the value + * of cur is undefined (it depends on which of the + * summands is evaluated first). + * + * I haven't come across a site where this + * code is actually executed yet, but I hope + * it works anyway. */ int skip_bytes; skip_bytes = *cur++; - skip_bytes += *cur++ << 8; + skip_bytes = *cur++ << 8; + + assert(skip_bytes == *csp->iob->cur - 2 + ((*csp->iob->cur - 1) << 8));
/* * The number of bytes to skip should be positive @@ -501,21 +1322,22 @@ jb_err decompress_iob(struct client_state *csp) }
/* Skip the filename if necessary. */ - if (flags & GZIP_FLAG_FILE_NAME) + if (flags & 0x08) { /* A null-terminated string is supposed to follow. */ while (*cur++ && (cur < csp->iob->eod)); + }
/* Skip the comment if necessary. */ - if (flags & GZIP_FLAG_COMMENT) + if (flags & 0x10) { /* A null-terminated string is supposed to follow. */ while (*cur++ && (cur < csp->iob->eod)); }
/* Skip the CRC if necessary. */ - if (flags & GZIP_FLAG_CHECKSUM) + if (flags & 0x02) { cur += 2; } @@ -553,7 +1375,7 @@ jb_err decompress_iob(struct client_state *csp) * * Fortunately, add_to_iob() has thoughtfully null-terminated * the buffer; we can just increment the end pointer to include - * the dummy byte. + * the dummy byte. */ csp->iob->eod++; } @@ -575,7 +1397,7 @@ jb_err decompress_iob(struct client_state *csp) * Passing -MAX_WBITS to inflateInit2 tells the library * that there is no zlib header. */ - if (inflateInit2(&zstr, -MAX_WBITS) != Z_OK) + if (inflateInit2 (&zstr, -MAX_WBITS) != Z_OK) { log_error(LOG_LEVEL_ERROR, "Error initializing decompression"); return JB_ERR_COMPRESS; @@ -595,7 +1417,7 @@ jb_err decompress_iob(struct client_state *csp)
assert(bufsize >= skip_size); memcpy(buf, csp->iob->buf, skip_size); - zstr.avail_out = (uInt)(bufsize - skip_size); + zstr.avail_out = bufsize - skip_size; zstr.next_out = (Bytef *)buf + skip_size;
/* Try to decompress the whole stream in one shot. */ @@ -606,24 +1428,21 @@ jb_err decompress_iob(struct client_state *csp) char *tmpbuf; /* used for realloc'ing the buffer */ size_t oldbufsize = bufsize; /* keep track of the old bufsize */
+ /* + * If zlib wants more data then there's a problem, because + * the complete compressed file should have been buffered. + */ if (0 == zstr.avail_in) { - /* - * If zlib wants more data then there's a problem, because - * the complete compressed file should have been buffered. - */ - log_error(LOG_LEVEL_ERROR, - "Unexpected end of compressed iob. Using what we got so far."); - break; + log_error(LOG_LEVEL_ERROR, "Unexpected end of compressed iob"); + return JB_ERR_COMPRESS; }
/* - * If we reached the buffer limit and still didn't have enough - * memory, just give up. Due to the ceiling enforced by the next - * if block we could actually check for equality here, but as it - * can be easily mistaken for a bug we don't. + * If we tried the limit and still didn't have enough + * memory, just give up. */ - if (bufsize >= csp->config->buffer_limit) + if (bufsize == csp->config->buffer_limit) { log_error(LOG_LEVEL_ERROR, "Buffer limit reached while decompressing iob"); return JB_ERR_MEMORY; @@ -637,7 +1456,7 @@ jb_err decompress_iob(struct client_state *csp) { bufsize = csp->config->buffer_limit; } - + /* Try to allocate the new buffer. */ tmpbuf = realloc(buf, bufsize); if (NULL == tmpbuf) @@ -655,7 +1474,7 @@ jb_err decompress_iob(struct client_state *csp) * buffer, which may be in a location different from * the old one. */ - zstr.avail_out += (uInt)(bufsize - oldbufsize); + zstr.avail_out += bufsize - oldbufsize; zstr.next_out = (Bytef *)tmpbuf + bufsize - zstr.avail_out;
/* @@ -664,6 +1483,7 @@ jb_err decompress_iob(struct client_state *csp) */ assert(zstr.avail_out == tmpbuf + bufsize - (char *)zstr.next_out); assert((char *)zstr.next_out == tmpbuf + ((char *)oldnext_out - buf)); + assert(zstr.avail_out > 0U);
buf = tmpbuf; } @@ -685,15 +1505,11 @@ jb_err decompress_iob(struct client_state *csp) */ }
- if ((status != Z_STREAM_END) && (0 != zstr.avail_in)) + if (status != Z_STREAM_END) { - /* - * We failed to decompress the stream and it's - * not simply because of missing data. - */ + /* We failed to decompress the stream. */ log_error(LOG_LEVEL_ERROR, - "Unexpected error while decompressing to the buffer (iob): %s", - zstr.msg); + "Error in decompressing to the buffer (iob): %s", zstr.msg); return JB_ERR_COMPRESS; }
@@ -709,7 +1525,7 @@ jb_err decompress_iob(struct client_state *csp) csp->iob->cur = csp->iob->buf + skip_size; csp->iob->eod = (char *)zstr.next_out; csp->iob->size = bufsize; - + /* * Make sure the new uncompressed iob obeys some minimal * consistency conditions. @@ -881,7 +1697,7 @@ char *get_header(struct iob *iob) * Header spans multiple lines, append the next one. */ char *continued_header; - + continued_header = get_header_line(iob); if ((continued_header == NULL) || (*continued_header == '\0')) { @@ -1013,7 +1829,7 @@ char *get_header_value(const struct list *header_list, const char *header_name) } }
- /* + /* * Not found */ return NULL; @@ -1025,7 +1841,7 @@ char *get_header_value(const struct list *header_list, const char *header_name) * * Function : scan_headers * - * Description : Scans headers, applies tags and updates action bits. + * Description : Scans headers, applies tags and updates action bits. * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) @@ -1141,7 +1957,7 @@ jb_err update_server_headers(struct client_state *csp) { "Content-Length:", 15, server_adjust_content_length }, { "Transfer-Encoding:", 18, server_transfer_coding }, #ifdef FEATURE_ZLIB - { "Content-Encoding:", 17, server_adjust_content_encoding }, + { "Content-Encoding:", 17, server_content_encoding }, #endif /* def FEATURE_ZLIB */ { NULL, 0, NULL } }; @@ -1167,37 +1983,6 @@ jb_err update_server_headers(struct client_state *csp) } }
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if ((JB_ERR_OK == err) - && (csp->flags & CSP_FLAG_MODIFIED) - && (csp->flags & CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE) - && !(csp->flags & CSP_FLAG_SERVER_CONTENT_LENGTH_SET)) - { - char header[50]; - - create_content_length_header(csp->content_length, header, sizeof(header)); - err = enlist(csp->headers, header); - if (JB_ERR_OK == err) - { - log_error(LOG_LEVEL_HEADER, - "Content modified with no Content-Length header set. " - "Created: %s.", header); - } - } -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - -#ifdef FEATURE_COMPRESSION - if ((JB_ERR_OK == err) - && (csp->flags & CSP_FLAG_BUFFERED_CONTENT_DEFLATED)) - { - err = enlist_unique_header(csp->headers, "Content-Encoding", "deflate"); - if (JB_ERR_OK == err) - { - log_error(LOG_LEVEL_HEADER, "Added header: Content-Encoding: deflate"); - } - } -#endif - return err; }
@@ -1230,6 +2015,7 @@ static jb_err header_tagger(struct client_state *csp, char *header) struct re_filterfile_spec *b; struct list_entry *tag_name;
+ int found_filters = 0; const size_t header_length = strlen(header);
if (csp->flags & CSP_FLAG_CLIENT_HEADER_PARSING_DONE) @@ -1243,7 +2029,21 @@ static jb_err header_tagger(struct client_state *csp, char *header) multi_action_index = ACTION_MULTI_CLIENT_HEADER_TAGGER; }
- if (filters_available(csp) == FALSE) + /* Check if there are any filters */ + for (i = 0; i < MAX_AF_FILES; i++) + { + fl = csp->rlist[i]; + if (NULL != fl) + { + if (NULL != fl->f) + { + found_filters = 1; + break; + } + } + } + + if (0 == found_filters) { log_error(LOG_LEVEL_ERROR, "Inconsistent configuration: " "tagging enabled, but no taggers available."); @@ -1343,7 +2143,7 @@ static jb_err header_tagger(struct client_state *csp, char *header) b->name); continue; } - + if (!list_contains_item(csp->tags, tag)) { if (JB_ERR_OK != enlist(csp->tags, tag)) @@ -1426,7 +2226,7 @@ static jb_err filter_header(struct client_state *csp, char **header) struct re_filterfile_spec *b; struct list_entry *filtername;
- int i; + int i, found_filters = 0; int wanted_filter_type; int multi_action_index;
@@ -1446,7 +2246,23 @@ static jb_err filter_header(struct client_state *csp, char **header) multi_action_index = ACTION_MULTI_CLIENT_HEADER_FILTER; }
- if (filters_available(csp) == FALSE) + /* + * Need to check the set of re_filterfiles... + */ + for (i = 0; i < MAX_AF_FILES; i++) + { + fl = csp->rlist[i]; + if (NULL != fl) + { + if (NULL != fl->f) + { + found_filters = 1; + break; + } + } + } + + if (0 == found_filters) { log_error(LOG_LEVEL_ERROR, "Inconsistent configuration: " "header filtering enabled, but no matching filters available."); @@ -1507,7 +2323,7 @@ static jb_err filter_header(struct client_state *csp, char **header) matches = pcrs_execute(job, *header, size, &newheader, &size); if ( 0 < matches ) { - current_hits += matches; + current_hits += matches; log_error(LOG_LEVEL_HEADER, "Transforming "%s" to "%s"", *header, newheader); freez(*header); *header = newheader; @@ -1530,247 +2346,24 @@ static jb_err filter_header(struct client_state *csp, char **header) } }
- if (b->dynamic) pcrs_free_joblist(joblist); - - log_error(LOG_LEVEL_RE_FILTER, "... produced %d hits (new size %d).", current_hits, size); - hits += current_hits; - } - } - } - } - - /* - * Additionally checking for hits is important because if - * the continue hack is triggered, server headers can - * arrive empty to separate multiple heads from each other. - */ - if ((0 == size) && hits) - { - log_error(LOG_LEVEL_HEADER, "Removing empty header %s", *header); - freez(*header); - } - - return JB_ERR_OK; -} - - -/********************************************************************* - * - * Function : server_connection - * - * Description : Makes sure a proper "Connection:" header is - * set and signals connection_header_adder to - * do nothing. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * 2 : header = On input, pointer to header to modify. - * On output, pointer to the modified header, or NULL - * to remove the header. This function frees the - * original string if necessary. - * - * Returns : JB_ERR_OK on success, or - * JB_ERR_MEMORY on out-of-memory error. - * - *********************************************************************/ -static jb_err server_connection(struct client_state *csp, char **header) -{ - if (!strcmpic(*header, "Connection: keep-alive") -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - && !(csp->flags & CSP_FLAG_SERVER_SOCKET_TAINTED) -#endif - ) - { -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if ((csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE)) - { - csp->flags |= CSP_FLAG_SERVER_CONNECTION_KEEP_ALIVE; - } - - if ((csp->flags & CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE)) - { - log_error(LOG_LEVEL_HEADER, - "Keeping the server header '%s' around.", *header); - } - else -#endif /* FEATURE_CONNECTION_KEEP_ALIVE */ - { - char *old_header = *header; - - *header = strdup("Connection: close"); - if (header == NULL) - { - return JB_ERR_MEMORY; - } - log_error(LOG_LEVEL_HEADER, "Replaced: '%s' with '%s'", old_header, *header); - freez(old_header); - } - } - - /* Signal server_connection_adder() to return early. */ - csp->flags |= CSP_FLAG_SERVER_CONNECTION_HEADER_SET; - - return JB_ERR_OK; -} - - -#ifdef FEATURE_CONNECTION_KEEP_ALIVE -/********************************************************************* - * - * Function : server_keep_alive - * - * Description : Stores the server's keep alive timeout. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * 2 : header = On input, pointer to header to modify. - * On output, pointer to the modified header, or NULL - * to remove the header. This function frees the - * original string if necessary. - * - * Returns : JB_ERR_OK. - * - *********************************************************************/ -static jb_err server_keep_alive(struct client_state *csp, char **header) -{ - unsigned int keep_alive_timeout; - const char *timeout_position = strstr(*header, "timeout="); - - if ((NULL == timeout_position) - || (1 != sscanf(timeout_position, "timeout=%u", &keep_alive_timeout))) - { - log_error(LOG_LEVEL_ERROR, "Couldn't parse: %s", *header); - } - else - { - if (keep_alive_timeout < csp->server_connection.keep_alive_timeout) - { - log_error(LOG_LEVEL_HEADER, - "Reducing keep-alive timeout from %u to %u.", - csp->server_connection.keep_alive_timeout, keep_alive_timeout); - csp->server_connection.keep_alive_timeout = keep_alive_timeout; - } - else - { - /* XXX: Is this log worthy? */ - log_error(LOG_LEVEL_HEADER, - "Server keep-alive timeout is %u. Sticking with %u.", - keep_alive_timeout, csp->server_connection.keep_alive_timeout); - } - csp->flags |= CSP_FLAG_SERVER_KEEP_ALIVE_TIMEOUT_SET; - } - - return JB_ERR_OK; -} - - -/********************************************************************* - * - * Function : server_proxy_connection - * - * Description : Figures out whether or not we should add a - * Proxy-Connection header. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * 2 : header = On input, pointer to header to modify. - * On output, pointer to the modified header, or NULL - * to remove the header. This function frees the - * original string if necessary. - * - * Returns : JB_ERR_OK. - * - *********************************************************************/ -static jb_err server_proxy_connection(struct client_state *csp, char **header) -{ - csp->flags |= CSP_FLAG_SERVER_PROXY_CONNECTION_HEADER_SET; - return JB_ERR_OK; -} - - -/********************************************************************* - * - * Function : client_keep_alive - * - * Description : Stores the client's keep alive timeout. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * 2 : header = On input, pointer to header to modify. - * On output, pointer to the modified header, or NULL - * to remove the header. This function frees the - * original string if necessary. - * - * Returns : JB_ERR_OK. - * - *********************************************************************/ -static jb_err client_keep_alive(struct client_state *csp, char **header) -{ - unsigned int keep_alive_timeout; - const char *timeout_position = strstr(*header, ": "); - - if (!(csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE)) - { - log_error(LOG_LEVEL_HEADER, - "keep-alive support is disabled. Crunching: %s.", *header); - freez(*header); - return JB_ERR_OK; - } - - if ((NULL == timeout_position) - || (1 != sscanf(timeout_position, ": %u", &keep_alive_timeout))) - { - log_error(LOG_LEVEL_ERROR, "Couldn't parse: %s", *header); - } - else - { - if (keep_alive_timeout < csp->config->keep_alive_timeout) - { - log_error(LOG_LEVEL_HEADER, - "Reducing keep-alive timeout from %u to %u.", - csp->config->keep_alive_timeout, keep_alive_timeout); - csp->server_connection.keep_alive_timeout = keep_alive_timeout; - } - else - { - /* XXX: Is this log worthy? */ - log_error(LOG_LEVEL_HEADER, - "Client keep-alive timeout is %u. Sticking with %u.", - keep_alive_timeout, csp->config->keep_alive_timeout); - } - } - - return JB_ERR_OK; -} - - -/********************************************************************* - * - * Function : get_content_length - * - * Description : Gets the content length specified in a - * Content-Length header. - * - * Parameters : - * 1 : header = The Content-Length header. - * 2 : length = Storage to return the value. - * - * Returns : JB_ERR_OK on success, or - * JB_ERR_PARSE if no value is recognized. - * - *********************************************************************/ -static jb_err get_content_length(const char *header, unsigned long long *length) -{ - assert(header[14] == ':'); - -#ifdef _WIN32 - assert(sizeof(unsigned long long) > 4); - if (1 != sscanf(header+14, ": %I64u", length)) -#else - if (1 != sscanf(header+14, ": %llu", length)) -#endif + if (b->dynamic) pcrs_free_joblist(joblist); + + log_error(LOG_LEVEL_RE_FILTER, "... produced %d hits (new size %d).", current_hits, size); + hits += current_hits; + } + } + } + } + + /* + * Additionally checking for hits is important because if + * the continue hack is triggered, server headers can + * arrive empty to separate multiple heads from each other. + */ + if ((0 == size) && hits) { - return JB_ERR_PARSE; + log_error(LOG_LEVEL_HEADER, "Removing empty header %s", *header); + freez(*header); }
return JB_ERR_OK; @@ -1779,9 +2372,11 @@ static jb_err get_content_length(const char *header, unsigned long long *length)
/********************************************************************* * - * Function : client_save_content_length + * Function : server_connection * - * Description : Save the Content-Length sent by the client. + * Description : Makes sure that the value of the Connection: header + * is "close" and signals server_connection_close_adder + * to do nothing. * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) @@ -1794,34 +2389,44 @@ static jb_err get_content_length(const char *header, unsigned long long *length) * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ -static jb_err client_save_content_length(struct client_state *csp, char **header) +static jb_err server_connection(struct client_state *csp, char **header) { - unsigned long long content_length = 0; + char *old_header = *header;
- assert(*(*header+14) == ':'); - - if (JB_ERR_OK != get_content_length(*header, &content_length)) - { - log_error(LOG_LEVEL_ERROR, "Crunching invalid header: %s", *header); - freez(*header); - } - else + /* Do we have a 'Connection: close' header? */ + if (strcmpic(*header, "Connection: close")) { - csp->expected_client_content_length = content_length; +#ifdef FEATURE_CONNECTION_KEEP_ALIVE + if ((csp->config->feature_flags & + RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE) + && !strcmpic(*header, "Connection: keep-alive")) + { + /* Remember to keep the connection alive. */ + csp->flags |= CSP_FLAG_SERVER_CONNECTION_KEEP_ALIVE; + } +#endif /* FEATURE_CONNECTION_KEEP_ALIVE */ + + *header = strdup("Connection: close"); + if (header == NULL) + { + return JB_ERR_MEMORY; + } + log_error(LOG_LEVEL_HEADER, "Replaced: '%s' with '%s'", old_header, *header); + freez(old_header); }
+ /* Signal server_connection_close_adder() to return early. */ + csp->flags |= CSP_FLAG_SERVER_CONNECTION_CLOSE_SET; + return JB_ERR_OK; } -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - -
/********************************************************************* * * Function : client_connection * * Description : Makes sure a proper "Connection:" header is - * set and signals connection_header_adder + * set and signals connection_header_adder * to do nothing. * * Parameters : @@ -1837,63 +2442,14 @@ static jb_err client_save_content_length(struct client_state *csp, char **header *********************************************************************/ static jb_err client_connection(struct client_state *csp, char **header) { - static const char connection_close[] = "Connection: close"; + char *old_header = *header; + const char *wanted_header = get_appropiate_connection_header(csp);
- if (!strcmpic(*header, connection_close)) - { -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if ((csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_SHARING)) - { - if (!strcmpic(csp->http->ver, "HTTP/1.1")) - { - log_error(LOG_LEVEL_HEADER, - "Removing '%s' to imply keep-alive.", *header); - freez(*header); - /* - * While we imply keep-alive to the server, - * we have to remember that the client didn't. - */ - csp->flags &= ~CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE; - } - else - { - char *old_header = *header; - - *header = strdup("Connection: keep-alive"); - if (header == NULL) - { - return JB_ERR_MEMORY; - } - log_error(LOG_LEVEL_HEADER, - "Replaced: '%s' with '%s'", old_header, *header); - freez(old_header); - } - } - else - { - log_error(LOG_LEVEL_HEADER, - "Keeping the client header '%s' around. " - "The connection will not be kept alive.", - *header); - csp->flags &= ~CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE; - } - } - else if ((csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE)) + if (strcmpic(*header, wanted_header)) { - log_error(LOG_LEVEL_HEADER, - "Keeping the client header '%s' around. " - "The server connection will be kept alive if possible.", - *header); - csp->flags |= CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE; -#endif /* def FEATURE_CONNECTION_KEEP_ALIVE */ - } - else - { - char *old_header = *header; - - *header = strdup(connection_close); + *header = strdup(wanted_header); if (header == NULL) - { + { return JB_ERR_MEMORY; } log_error(LOG_LEVEL_HEADER, @@ -1901,7 +2457,7 @@ static jb_err client_connection(struct client_state *csp, char **header) freez(old_header); }
- /* Signal client_connection_adder() to return early. */ + /* Signal client_connection_close_adder() to return early. */ csp->flags |= CSP_FLAG_CLIENT_CONNECTION_HEADER_SET;
return JB_ERR_OK; @@ -1963,7 +2519,7 @@ static jb_err crunch_server_header(struct client_state *csp, char **header) /* Is the current header the lucky one? */ if (strstr(*header, crunch_pattern)) { - log_error(LOG_LEVEL_HEADER, "Crunching server header: %s (contains: %s)", *header, crunch_pattern); + log_error(LOG_LEVEL_HEADER, "Crunching server header: %s (contains: %s)", *header, crunch_pattern); freez(*header); } } @@ -1977,7 +2533,7 @@ static jb_err crunch_server_header(struct client_state *csp, char **header) * Function : server_content_type * * Description : Set the content-type for filterable types (text/.*, - * .*xml.*, .*script.* and image/gif) unless filtering has been + * .*xml.*, javascript and image/gif) unless filtering has been * forbidden (CT_TABOO) while parsing earlier headers. * NOTE: Since text/plain is commonly used by web servers * for files whose correct type is unknown, we don't @@ -2027,7 +2583,7 @@ static jb_err server_content_type(struct client_state *csp, char **header) */ if ((strstr(*header, "text/") && !strstr(*header, "plain")) || strstr(*header, "xml") - || strstr(*header, "script")) + || strstr(*header, "application/x-javascript")) { csp->content_type |= CT_TEXT; } @@ -2043,8 +2599,8 @@ static jb_err server_content_type(struct client_state *csp, char **header) if (csp->action->flags & ACTION_CONTENT_TYPE_OVERWRITE) { /* - * Make sure the user doesn't accidentally - * change the content type of binary documents. + * Make sure the user doesn't accidently + * change the content type of binary documents. */ if ((csp->content_type & CT_TEXT) || (csp->action->flags & ACTION_FORCE_TEXT_MODE)) { @@ -2137,16 +2693,16 @@ static jb_err server_transfer_coding(struct client_state *csp, char **header) * * Function : server_content_encoding * - * Description : Used to check if the content is compressed, and if - * FEATURE_ZLIB is disabled, filtering is disabled as - * well. - * - * If FEATURE_ZLIB is enabled and the compression type - * supported, the content is marked for decompression. + * Description : This function is run twice for each request, + * unless FEATURE_ZLIB and filtering are disabled. * - * XXX: Doesn't properly deal with multiple or with - * unsupported but unknown encodings. - * Is case-sensitive but shouldn't be. + * The first run is used to check if the content + * is compressed, if FEATURE_ZLIB is disabled + * filtering is then disabled as well, if FEATURE_ZLIB + * is enabled the content is marked for decompression. + * + * The second run is used to remove the Content-Encoding + * header if the decompression was successful. * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) @@ -2162,25 +2718,19 @@ static jb_err server_transfer_coding(struct client_state *csp, char **header) static jb_err server_content_encoding(struct client_state *csp, char **header) { #ifdef FEATURE_ZLIB - if (strstr(*header, "sdch")) + if ((csp->flags & CSP_FLAG_MODIFIED) + && (csp->content_type & (CT_GZIP | CT_DEFLATE))) { /* - * Shared Dictionary Compression over HTTP isn't supported, - * filtering it anyway is pretty much guaranteed to mess up - * the encoding. - */ - csp->content_type |= CT_TABOO; - - /* - * Log a warning if the user expects the content to be filtered. + * We successfully decompressed the content, + * and have to clean the header now, so the + * client no longer expects compressed data.. + * + * XXX: There is a difference between cleaning + * and removing it completely. */ - if ((csp->rlist != NULL) && - (!list_is_empty(csp->action->multi[ACTION_MULTI_FILTER]))) - { - log_error(LOG_LEVEL_INFO, - "SDCH-compressed content detected, content filtering disabled. " - "Consider suppressing SDCH offers made by the client."); - } + log_error(LOG_LEVEL_HEADER, "Crunching: %s", *header); + freez(*header); } else if (strstr(*header, "gzip")) { @@ -2201,16 +2751,7 @@ static jb_err server_content_encoding(struct client_state *csp, char **header) csp->content_type |= CT_TABOO; } #else /* !defined(FEATURE_ZLIB) */ - /* - * XXX: Using a black list here isn't the right approach. - * - * In case of SDCH, building with zlib support isn't - * going to help. - */ - if (strstr(*header, "gzip") || - strstr(*header, "compress") || - strstr(*header, "deflate") || - strstr(*header, "sdch")) + if (strstr(*header, "gzip") || strstr(*header, "compress") || strstr(*header, "deflate")) { /* * Body is compressed, turn off pcrs and gif filtering. @@ -2236,49 +2777,6 @@ static jb_err server_content_encoding(struct client_state *csp, char **header) }
-#ifdef FEATURE_ZLIB -/********************************************************************* - * - * Function : server_adjust_content_encoding - * - * Description : Remove the Content-Encoding header if the - * decompression was successful and the content - * has been modifed. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * 2 : header = On input, pointer to header to modify. - * On output, pointer to the modified header, or NULL - * to remove the header. This function frees the - * original string if necessary. - * - * Returns : JB_ERR_OK on success, or - * JB_ERR_MEMORY on out-of-memory error. - * - *********************************************************************/ -static jb_err server_adjust_content_encoding(struct client_state *csp, char **header) -{ - if ((csp->flags & CSP_FLAG_MODIFIED) - && (csp->content_type & (CT_GZIP | CT_DEFLATE))) - { - /* - * We successfully decompressed the content, - * and have to clean the header now, so the - * client no longer expects compressed data. - * - * XXX: There is a difference between cleaning - * and removing it completely. - */ - log_error(LOG_LEVEL_HEADER, "Crunching: %s", *header); - freez(*header); - } - - return JB_ERR_OK; - -} -#endif /* defined(FEATURE_ZLIB) */ - - /********************************************************************* * * Function : server_adjust_content_length @@ -2299,19 +2797,22 @@ static jb_err server_adjust_content_encoding(struct client_state *csp, char **he *********************************************************************/ static jb_err server_adjust_content_length(struct client_state *csp, char **header) { + const size_t max_header_length = 80; + /* Regenerate header if the content was modified. */ if (csp->flags & CSP_FLAG_MODIFIED) { - const size_t header_length = 50; freez(*header); - *header = malloc(header_length); + *header = (char *) zalloc(max_header_length); if (*header == NULL) { return JB_ERR_MEMORY; } - create_content_length_header(csp->content_length, *header, header_length); - log_error(LOG_LEVEL_HEADER, - "Adjusted Content-Length to %llu", csp->content_length); + + snprintf(*header, max_header_length, "Content-Length: %d", + (int)csp->content_length); + log_error(LOG_LEVEL_HEADER, "Adjusted Content-Length to %d", + (int)csp->content_length); }
return JB_ERR_OK; @@ -2342,7 +2843,7 @@ static jb_err server_save_content_length(struct client_state *csp, char **header
assert(*(*header+14) == ':');
- if (JB_ERR_OK != get_content_length(*header, &content_length)) + if (1 != sscanf(*header+14, ": %llu", &content_length)) { log_error(LOG_LEVEL_ERROR, "Crunching invalid header: %s", *header); freez(*header); @@ -2350,7 +2851,6 @@ static jb_err server_save_content_length(struct client_state *csp, char **header else { csp->expected_content_length = content_length; - csp->flags |= CSP_FLAG_SERVER_CONTENT_LENGTH_SET; csp->flags |= CSP_FLAG_CONTENT_LENGTH_SET; }
@@ -2432,7 +2932,7 @@ static jb_err server_content_disposition(struct client_state *csp, char **header return JB_ERR_OK; } else - { + { /* * Replacing Content-Disposition header */ @@ -2472,9 +2972,17 @@ static jb_err server_content_disposition(struct client_state *csp, char **header static jb_err server_last_modified(struct client_state *csp, char **header) { const char *newval; - time_t last_modified; - char newheader[50]; + char buf[BUFFER_SIZE];
+ char newheader[50]; +#ifdef HAVE_GMTIME_R + struct tm gmt; +#endif + struct tm *timeptr = NULL; + time_t now, last_modified; + long int rtime; + long int days, hours, minutes, seconds; + /* * Are we messing with the Last-Modified header? */ @@ -2496,19 +3004,18 @@ static jb_err server_last_modified(struct client_state *csp, char **header) return JB_ERR_OK; } else if (0 == strcmpic(newval, "reset-to-request-time")) - { + { /* * Setting Last-Modified Header to now. */ - char buf[30]; get_http_time(0, buf, sizeof(buf)); freez(*header); *header = strdup("Last-Modified: "); - string_append(header, buf); + string_append(header, buf);
if (*header == NULL) { - log_error(LOG_LEVEL_HEADER, "Insufficient memory. Last-Modified header got lost, boohoo."); + log_error(LOG_LEVEL_HEADER, "Insufficient memory. Last-Modified header got lost, boohoo."); } else { @@ -2520,7 +3027,16 @@ static jb_err server_last_modified(struct client_state *csp, char **header) const char *header_time = *header + sizeof("Last-Modified:");
log_error(LOG_LEVEL_HEADER, "Randomizing: %s", *header); - + now = time(NULL); +#ifdef HAVE_GMTIME_R + timeptr = gmtime_r(&now, &gmt); +#elif FEATURE_PTHREAD + privoxy_mutex_lock(&gmtime_mutex); + timeptr = gmtime(&now); + privoxy_mutex_unlock(&gmtime_mutex); +#else + timeptr = gmtime(&now); +#endif if (JB_ERR_OK != parse_header_time(header_time, &last_modified)) { log_error(LOG_LEVEL_HEADER, "Couldn't parse: %s in %s (crunching!)", header_time, *header); @@ -2528,49 +3044,30 @@ static jb_err server_last_modified(struct client_state *csp, char **header) } else { - time_t now; - struct tm *timeptr = NULL; - long int rtime; -#ifdef HAVE_GMTIME_R - struct tm gmt; -#endif - now = time(NULL); rtime = (long int)difftime(now, last_modified); if (rtime) { - long int days, hours, minutes, seconds; - const int negative_delta = (rtime < 0); + int negative = 0;
- if (negative_delta) + if (rtime < 0) { - rtime *= -1; + rtime *= -1; + negative = 1; log_error(LOG_LEVEL_HEADER, "Server time in the future."); } rtime = pick_from_range(rtime); - if (negative_delta) - { - rtime *= -1; - } + if (negative) rtime *= -1; last_modified += rtime; #ifdef HAVE_GMTIME_R timeptr = gmtime_r(&last_modified, &gmt); -#elif defined(MUTEX_LOCKS_AVAILABLE) +#elif FEATURE_PTHREAD privoxy_mutex_lock(&gmtime_mutex); timeptr = gmtime(&last_modified); privoxy_mutex_unlock(&gmtime_mutex); #else timeptr = gmtime(&last_modified); #endif - if ((NULL == timeptr) || !strftime(newheader, - sizeof(newheader), "%a, %d %b %Y %H:%M:%S GMT", timeptr)) - { - log_error(LOG_LEVEL_ERROR, - "Randomizing '%s' failed. Crunching the header without replacement.", - *header); - freez(*header); - return JB_ERR_OK; - } - + strftime(newheader, sizeof(newheader), "%a, %d %b %Y %H:%M:%S GMT", timeptr); freez(*header); *header = strdup("Last-Modified: "); string_append(header, newheader); @@ -2578,7 +3075,7 @@ static jb_err server_last_modified(struct client_state *csp, char **header) if (*header == NULL) { log_error(LOG_LEVEL_ERROR, "Insufficient memory, header crunched without replacement."); - return JB_ERR_MEMORY; + return JB_ERR_MEMORY; }
days = rtime / (3600 * 24); @@ -2623,17 +3120,25 @@ static jb_err server_last_modified(struct client_state *csp, char **header) *********************************************************************/ static jb_err client_accept_encoding(struct client_state *csp, char **header) { -#ifdef FEATURE_COMPRESSION - if ((csp->config->feature_flags & RUNTIME_FEATURE_COMPRESSION) - && strstr(*header, "deflate")) - { - csp->flags |= CSP_FLAG_CLIENT_SUPPORTS_DEFLATE; - } -#endif if ((csp->action->flags & ACTION_NO_COMPRESSION) != 0) { log_error(LOG_LEVEL_HEADER, "Suppressed offer to compress content"); + freez(*header); + + /* Temporarily disable the correct behaviour to + * work around a PHP bug. + * + * if (!strcmpic(csp->http->ver, "HTTP/1.1")) + * { + * *header = strdup("Accept-Encoding: identity;q=1.0, *;q=0"); + * if (*header == NULL) + * { + * return JB_ERR_MEMORY; + * } + * } + * + */ }
return JB_ERR_OK; @@ -2694,7 +3199,7 @@ static jb_err client_referrer(struct client_state *csp, char **header) /* booleans for parameters we have to check multiple times */ int parameter_conditional_block; int parameter_conditional_forge; - + #ifdef FEATURE_FORCE_LOAD /* * Since the referrer can include the prefix even @@ -2792,18 +3297,18 @@ static jb_err client_accept_language(struct client_state *csp, char **header) return JB_ERR_OK; } else - { + { /* * Replacing Accept-Language header */ freez(*header); *header = strdup("Accept-Language: "); - string_append(header, newval); + string_append(header, newval);
if (*header == NULL) { log_error(LOG_LEVEL_ERROR, - "Insufficient memory. Accept-Language header crunched without replacement."); + "Insufficient memory. Accept-Language header crunched without replacement."); } else { @@ -2844,7 +3349,7 @@ static jb_err crunch_client_header(struct client_state *csp, char **header) /* Is the current header the lucky one? */ if (strstr(*header, crunch_pattern)) { - log_error(LOG_LEVEL_HEADER, "Crunching client header: %s (contains: %s)", *header, crunch_pattern); + log_error(LOG_LEVEL_HEADER, "Crunching client header: %s (contains: %s)", *header, crunch_pattern); freez(*header); } } @@ -3149,10 +3654,10 @@ static jb_err client_host(struct client_state *csp, char **header) return JB_ERR_OK; }
- if (!csp->http->hostport || (*csp->http->hostport == '*') || + if (!csp->http->hostport || (*csp->http->hostport == '*') || *csp->http->hostport == ' ' || *csp->http->hostport == '\0') { - + if (NULL == (p = strdup((*header)+6))) { return JB_ERR_MEMORY; @@ -3215,13 +3720,16 @@ static jb_err client_if_modified_since(struct client_state *csp, char **header) struct tm gmt; #endif struct tm *timeptr = NULL; - time_t tm = 0; + time_t tm = 0; const char *newval; + long int rtime; + long int hours, minutes, seconds; + int negative = 0; char * endptr; - + if ( 0 == strcmpic(*header, "If-Modified-Since: Wed, 08 Jun 1955 12:00:00 GMT")) { - /* + /* * The client got an error message because of a temporary problem, * the problem is gone and the client now tries to revalidate our * error message on the real server. The revalidation would always @@ -3251,17 +3759,15 @@ static jb_err client_if_modified_since(struct client_state *csp, char **header) } else { - long int hours, minutes, seconds; - long int rtime = strtol(newval, &endptr, 0); - const int negative_range = (rtime < 0); - + rtime = strtol(newval, &endptr, 0); if (rtime) { log_error(LOG_LEVEL_HEADER, "Randomizing: %s (random range: %d minut%s)", *header, rtime, (rtime == 1 || rtime == -1) ? "e": "es"); - if (negative_range) + if (rtime < 0) { - rtime *= -1; + rtime *= -1; + negative = 1; } rtime *= 60; rtime = pick_from_range(rtime); @@ -3271,25 +3777,17 @@ static jb_err client_if_modified_since(struct client_state *csp, char **header) log_error(LOG_LEVEL_ERROR, "Random range is 0. Assuming time transformation test.", *header); } - tm += rtime * (negative_range ? -1 : 1); + tm += rtime * (negative ? -1 : 1); #ifdef HAVE_GMTIME_R timeptr = gmtime_r(&tm, &gmt); -#elif defined(MUTEX_LOCKS_AVAILABLE) +#elif FEATURE_PTHREAD privoxy_mutex_lock(&gmtime_mutex); timeptr = gmtime(&tm); privoxy_mutex_unlock(&gmtime_mutex); #else timeptr = gmtime(&tm); #endif - if ((NULL == timeptr) || !strftime(newheader, - sizeof(newheader), "%a, %d %b %Y %H:%M:%S GMT", timeptr)) - { - log_error(LOG_LEVEL_ERROR, - "Randomizing '%s' failed. Crunching the header without replacement.", - *header); - freez(*header); - return JB_ERR_OK; - } + strftime(newheader, sizeof(newheader), "%a, %d %b %Y %H:%M:%S GMT", timeptr);
freez(*header); *header = strdup("If-Modified-Since: "); @@ -3298,7 +3796,7 @@ static jb_err client_if_modified_since(struct client_state *csp, char **header) if (*header == NULL) { log_error(LOG_LEVEL_HEADER, "Insufficient memory, header crunched without replacement."); - return JB_ERR_MEMORY; + return JB_ERR_MEMORY; }
hours = rtime / 3600; @@ -3307,7 +3805,7 @@ static jb_err client_if_modified_since(struct client_state *csp, char **header)
log_error(LOG_LEVEL_HEADER, "Randomized: %s (%s %d hou%s %d minut%s %d second%s", - *header, (negative_range) ? "subtracted" : "added", hours, + *header, (negative) ? "subtracted" : "added", hours, (hours == 1) ? "r" : "rs", minutes, (minutes == 1) ? "e" : "es", seconds, (seconds == 1) ? ")" : "s)"); } @@ -3338,7 +3836,7 @@ static jb_err client_if_modified_since(struct client_state *csp, char **header) static jb_err client_if_none_match(struct client_state *csp, char **header) { if (csp->action->flags & ACTION_CRUNCH_IF_NONE_MATCH) - { + { log_error(LOG_LEVEL_HEADER, "Crunching %s", *header); freez(*header); } @@ -3380,7 +3878,7 @@ jb_err client_x_filter(struct client_state *csp, char **header) "force-text-mode overruled the client's request to fetch without filtering!"); } else - { + { csp->content_type = CT_TABOO; /* XXX: This hack shouldn't be necessary */ csp->flags |= CSP_FLAG_NO_FILTERING; log_error(LOG_LEVEL_HEADER, "Accepted the client's request to fetch without filtering."); @@ -3389,7 +3887,7 @@ jb_err client_x_filter(struct client_state *csp, char **header) freez(*header); } } - return JB_ERR_OK; + return JB_ERR_OK; }
@@ -3423,7 +3921,7 @@ static jb_err client_range(struct client_state *csp, char **header) freez(*header); }
- return JB_ERR_OK; + return JB_ERR_OK; }
/* the following functions add headers directly to the header list */ @@ -3480,6 +3978,36 @@ static jb_err client_host_adder(struct client_state *csp) }
+#if 0 +/********************************************************************* + * + * Function : client_accept_encoding_adder + * + * Description : Add an Accept-Encoding header to the client's request + * that disables compression if the action applies, and + * the header is not already there. Called from `sed'. + * Note: For HTTP/1.0, the absence of the header is enough. + * + * Parameters : + * 1 : csp = Current client state (buffers, headers, etc...) + * + * Returns : JB_ERR_OK on success, or + * JB_ERR_MEMORY on out-of-memory error. + * + *********************************************************************/ +static jb_err client_accept_encoding_adder(struct client_state *csp) +{ + if ( ((csp->action->flags & ACTION_NO_COMPRESSION) != 0) + && (!strcmpic(csp->http->ver, "HTTP/1.1")) ) + { + return enlist_unique(csp->headers, "Accept-Encoding: identity;q=1.0, *;q=0", 16); + } + + return JB_ERR_OK; +} +#endif + + /********************************************************************* * * Function : client_xtra_adder @@ -3562,11 +4090,14 @@ static jb_err client_x_forwarded_for_adder(struct client_state *csp)
/********************************************************************* * - * Function : server_connection_adder + * Function : server_connection_close_adder * - * Description : Adds an appropriate "Connection:" header to csp->headers + * Description : "Temporary" fix for the needed but missing HTTP/1.1 + * support. Adds a "Connection: close" header to csp->headers * unless the header was already present. Called from `sed'. * + * FIXME: This whole function shouldn't be neccessary! + * * Parameters : * 1 : csp = Current client state (buffers, headers, etc...) * @@ -3574,14 +4105,13 @@ static jb_err client_x_forwarded_for_adder(struct client_state *csp) * JB_ERR_MEMORY on out-of-memory error. * *********************************************************************/ -static jb_err server_connection_adder(struct client_state *csp) +static jb_err server_connection_close_adder(struct client_state *csp) { const unsigned int flags = csp->flags; const char *response_status_line = csp->headers->first->str; - static const char connection_close[] = "Connection: close";
if ((flags & CSP_FLAG_CLIENT_HEADER_PARSING_DONE) - && (flags & CSP_FLAG_SERVER_CONNECTION_HEADER_SET)) + && (flags & CSP_FLAG_SERVER_CONNECTION_CLOSE_SET)) { return JB_ERR_OK; } @@ -3592,56 +4122,17 @@ static jb_err server_connection_adder(struct client_state *csp) if ((csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE) && (NULL != response_status_line) - && !strncmpic(response_status_line, "HTTP/1.1", 8) -#ifdef FEATURE_CONNECTION_KEEP_ALIVE - && !(csp->flags & CSP_FLAG_SERVER_SOCKET_TAINTED) -#endif - ) + && !strncmpic(response_status_line, "HTTP/1.1", 8)) { log_error(LOG_LEVEL_HEADER, "A HTTP/1.1 response " "without Connection header implies keep-alive."); csp->flags |= CSP_FLAG_SERVER_CONNECTION_KEEP_ALIVE; - return JB_ERR_OK; }
- log_error(LOG_LEVEL_HEADER, "Adding: %s", connection_close); - - return enlist(csp->headers, connection_close); -} - - -#ifdef FEATURE_CONNECTION_KEEP_ALIVE -/********************************************************************* - * - * Function : server_proxy_connection_adder - * - * Description : Adds a "Proxy-Connection: keep-alive" header to - * csp->headers if the client asked for keep-alive. - * XXX: We should reuse existent ones. - * - * Parameters : - * 1 : csp = Current client state (buffers, headers, etc...) - * - * Returns : JB_ERR_OK on success, or - * JB_ERR_MEMORY on out-of-memory error. - * - *********************************************************************/ -static jb_err server_proxy_connection_adder(struct client_state *csp) -{ - static const char proxy_connection_header[] = "Proxy-Connection: keep-alive"; - jb_err err = JB_ERR_OK; - - if ((csp->flags & CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE) - && !(csp->flags & CSP_FLAG_SERVER_SOCKET_TAINTED) - && !(csp->flags & CSP_FLAG_SERVER_PROXY_CONNECTION_HEADER_SET)) - { - log_error(LOG_LEVEL_HEADER, "Adding: %s", proxy_connection_header); - err = enlist(csp->headers, proxy_connection_header); - } + log_error(LOG_LEVEL_HEADER, "Adding: Connection: close");
- return err; + return enlist(csp->headers, "Connection: close"); } -#endif /* FEATURE_CONNECTION_KEEP_ALIVE */
/********************************************************************* @@ -3660,27 +4151,18 @@ static jb_err server_proxy_connection_adder(struct client_state *csp) *********************************************************************/ static jb_err client_connection_header_adder(struct client_state *csp) { - static const char connection_close[] = "Connection: close"; - - if (!(csp->flags & CSP_FLAG_CLIENT_HEADER_PARSING_DONE) - && (csp->flags & CSP_FLAG_CLIENT_CONNECTION_HEADER_SET)) - { - return JB_ERR_OK; - } + const unsigned int flags = csp->flags; + const char *wanted_header = get_appropiate_connection_header(csp);
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE - if ((csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE) - && (csp->http->ssl == 0) - && !strcmpic(csp->http->ver, "HTTP/1.1")) + if (!(flags & CSP_FLAG_CLIENT_HEADER_PARSING_DONE) + && (flags & CSP_FLAG_CLIENT_CONNECTION_HEADER_SET)) { - csp->flags |= CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE; return JB_ERR_OK; } -#endif /* FEATURE_CONNECTION_KEEP_ALIVE */
- log_error(LOG_LEVEL_HEADER, "Adding: %s", connection_close); + log_error(LOG_LEVEL_HEADER, "Adding: %s", wanted_header);
- return enlist(csp->headers, connection_close); + return enlist(csp->headers, wanted_header); }
@@ -3741,7 +4223,8 @@ static jb_err server_http(struct client_state *csp, char **header) * Function : server_set_cookie * * Description : Handle the server "cookie" header properly. - * Crunch, accept or rewrite it to a session cookie. + * Log cookie to the jar file. Then "crunch", + * accept or rewrite it to a session cookie. * Called from `sed'. * * TODO: Allow the user to specify a new expiration @@ -3762,7 +4245,7 @@ static jb_err server_http(struct client_state *csp, char **header) static jb_err server_set_cookie(struct client_state *csp, char **header) { time_t now; - time_t cookie_time; + time_t cookie_time;
time(&now);
@@ -3819,17 +4302,6 @@ static jb_err server_set_cookie(struct client_state *csp, char **header) { char *expiration_date = cur_tag + 8; /* Skip "[Ee]xpires=" */
- if ((expiration_date[0] == '"') - && (expiration_date[1] != '\0')) - { - /* - * Skip quotation mark. RFC 2109 10.1.2 seems to hint - * that the expiration date isn't supposed to be quoted, - * but some servers do it anyway. - */ - expiration_date++; - } - /* Did we detect the date properly? */ if (JB_ERR_OK != parse_header_time(expiration_date, &cookie_time)) { @@ -3929,7 +4401,7 @@ static jb_err server_set_cookie(struct client_state *csp, char **header) * * Function : strclean * - * Description : In-Situ-Eliminate all occurrences of substring in + * Description : In-Situ-Eliminate all occurances of substring in * string * * Parameters : @@ -3972,7 +4444,7 @@ int strclean(char *string, const char *substring) * to get the numerical respresentation. * * Parameters : - * 1 : header_time = HTTP header time as string. + * 1 : header_time = HTTP header time as string. * 2 : result = storage for header_time in seconds * * Returns : JB_ERR_OK if the time format was recognized, or @@ -3982,49 +4454,34 @@ int strclean(char *string, const char *substring) static jb_err parse_header_time(const char *header_time, time_t *result) { struct tm gmt; + /* - * Checking for two-digit years first in an - * attempt to work around GNU libc's strptime() - * reporting negative year values when using %Y. + * Zero out gmt to prevent time zone offsets. + * + * While this is only necessary on some platforms + * (mingw32 for example), I don't know how to + * detect these automatically and doing it everywhere + * shouldn't hurt. */ - static const char * const time_formats[] = { - /* Tue, 02-Jun-37 20:00:00 */ - "%a, %d-%b-%y %H:%M:%S", - /* Tue, 02 Jun 2037 20:00:00 */ - "%a, %d %b %Y %H:%M:%S", - /* Tue, 02-Jun-2037 20:00:00 */ - "%a, %d-%b-%Y %H:%M:%S", - /* Tuesday, 02-Jun-2037 20:00:00 */ - "%A, %d-%b-%Y %H:%M:%S", - /* Tuesday Jun 02 20:00:00 2037 */ - "%A %b %d %H:%M:%S %Y" - }; - unsigned int i; - - for (i = 0; i < SZ(time_formats); i++) + memset(&gmt, 0, sizeof(gmt)); + + /* Tue, 02 Jun 2037 20:00:00 */ + if ((NULL == strptime(header_time, "%a, %d %b %Y %H:%M:%S", &gmt)) + /* Tue, 02-Jun-2037 20:00:00 */ + && (NULL == strptime(header_time, "%a, %d-%b-%Y %H:%M:%S", &gmt)) + /* Tue, 02-Jun-37 20:00:00 */ + && (NULL == strptime(header_time, "%a, %d-%b-%y %H:%M:%S", &gmt)) + /* Tuesday, 02-Jun-2037 20:00:00 */ + && (NULL == strptime(header_time, "%A, %d-%b-%Y %H:%M:%S", &gmt)) + /* Tuesday Jun 02 20:00:00 2037 */ + && (NULL == strptime(header_time, "%A %b %d %H:%M:%S %Y", &gmt))) { - /* - * Zero out gmt to prevent time zone offsets. - * Documented to be required for GNU libc. - */ - memset(&gmt, 0, sizeof(gmt)); - - if (NULL != strptime(header_time, time_formats[i], &gmt)) - { - /* Sanity check for GNU libc. */ - if (gmt.tm_year < 0) - { - log_error(LOG_LEVEL_HEADER, - "Failed to parse '%s' using '%s'. Moving on.", - header_time, time_formats[i]); - continue; - } - *result = timegm(&gmt); - return JB_ERR_OK; - } + return JB_ERR_PARSE; }
- return JB_ERR_PARSE; + *result = timegm(&gmt); + + return JB_ERR_OK;
}
@@ -4043,7 +4500,7 @@ static jb_err parse_header_time(const char *header_time, time_t *result) * Parameters : * 1 : headers = List of headers (one of them hopefully being * the "Host:" header) - * 2 : http = storage for the result (host, port and hostport). + * 2 : http = storage for the result (host, port and hostport). * * Returns : JB_ERR_MEMORY in case of memory problems, * JB_ERR_PARSE if the host header couldn't be found, @@ -4064,8 +4521,7 @@ jb_err get_destination_from_headers(const struct list *headers, struct http_requ return JB_ERR_PARSE; }
- p = strdup(host); - if (NULL == p) + if (NULL == (p = strdup((host)))) { log_error(LOG_LEVEL_ERROR, "Out of memory while parsing "Host:" header"); return JB_ERR_MEMORY; @@ -4118,7 +4574,7 @@ jb_err get_destination_from_headers(const struct list *headers, struct http_requ * * Description : Helper for client_referrer to forge a referer as * 'http://%5Bhostname:port/' to fool stupid - * checks for in-site links + * checks for in-site links * * Parameters : * 1 : header = Pointer to header pointer @@ -4209,7 +4665,7 @@ static jb_err handle_conditional_hide_referrer_parameter(char **header, const char *host, const int parameter_conditional_block) { char *referer = strdup(*header); - const size_t hostlength = strlen(host); + const size_t hostlenght = strlen(host); const char *referer_url = NULL;
if (NULL == referer) @@ -4219,14 +4675,14 @@ static jb_err handle_conditional_hide_referrer_parameter(char **header, }
/* referer begins with 'Referer: http[s]://' */ - if ((hostlength+17) < strlen(referer)) + if ((hostlenght+17) < strlen(referer)) { /* * Shorten referer to make sure the referer is blocked * if www.example.org/www.example.com-shall-see-the-referer/ * links to www.example.com/ */ - referer[hostlength+17] = '\0'; + referer[hostlenght+17] = '\0'; } referer_url = strstr(referer, "http://"); if ((NULL == referer_url) || (NULL == strstr(referer_url, host))) @@ -4253,25 +4709,30 @@ static jb_err handle_conditional_hide_referrer_parameter(char **header,
/********************************************************************* * - * Function : create_content_length_header + * Function : get_appropiate_connection_header * - * Description : Creates a Content-Length header. + * Description : Returns an appropiate Connection header + * depending on whether or not we try to keep + * the connection to the server alive. * * Parameters : - * 1 : content_length = The content length to be used in the header. - * 2 : header = Allocated space to safe the header. - * 3 : buffer_length = The length of the allocated space. + * 1 : csp = Current client state (buffers, headers, etc...) * - * Returns : void + * Returns : Pointer to statically allocated header buffer. * *********************************************************************/ -static void create_content_length_header(unsigned long long content_length, - char *header, size_t buffer_length) +static const char *get_appropiate_connection_header(const struct client_state *csp) { - snprintf(header, buffer_length, "Content-Length: %llu", content_length); -} - + static const char connection_keep_alive[] = "Connection: keep-alive"; + static const char connection_close[] = "Connection: close";
+ if ((csp->config->feature_flags & RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE) + && (csp->http->ssl == 0)) + { + return connection_keep_alive; + } + return connection_close; +} /* Local Variables: tab-width: 3 diff --git a/external/privoxy/parsers.h b/external/privoxy/parsers.h index a864c02..cf70be4 100644 --- a/external/privoxy/parsers.h +++ b/external/privoxy/parsers.h @@ -1,6 +1,6 @@ #ifndef PARSERS_H_INCLUDED #define PARSERS_H_INCLUDED -#define PARSERS_H_VERSION "$Id: parsers.h,v 1.51 2011/09/04 11:10:56 fabiankeil Exp $" +#define PARSERS_H_VERSION "$Id: parsers.h,v 1.49 2009/03/13 14:10:07 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/parsers.h,v $ @@ -20,10 +20,10 @@ * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -41,8 +41,246 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: parsers.h,v $ + * Revision 1.49 2009/03/13 14:10:07 fabiankeil + * Fix some more harmless warnings on amd64. + * + * Revision 1.48 2008/05/30 15:57:23 fabiankeil + * Remove now-useless reference to debug. + * + * Revision 1.47 2008/05/21 20:12:11 fabiankeil + * The whole point of strclean() is to modify the + * first parameter, so don't mark it immutable, + * even though the compiler lets us get away with it. + * + * Revision 1.46 2008/05/21 15:47:14 fabiankeil + * Streamline sed()'s prototype and declare + * the header parse and add structures static. + * + * Revision 1.45 2008/05/20 20:13:30 fabiankeil + * Factor update_server_headers() out of sed(), ditch the + * first_run hack and make server_patterns_light static. + * + * Revision 1.44 2008/05/20 16:05:09 fabiankeil + * Move parsers structure definition from project.h to parsers.h. + * + * Revision 1.43 2008/05/10 13:23:38 fabiankeil + * Don't provide get_header() with the whole client state + * structure when it only needs access to csp->iob. + * + * Revision 1.42 2008/04/17 14:40:49 fabiankeil + * Provide get_http_time() with the buffer size so it doesn't + * have to blindly assume that the buffer is big enough. + * + * Revision 1.41 2008/04/16 16:38:21 fabiankeil + * Don't pass the whole csp structure to flush_socket() + * when it only needs a file descriptor and a buffer. + * + * Revision 1.40 2007/08/11 14:47:26 fabiankeil + * Remove the prototypes for functions that are only + * used in parsers.c and thus should be static. + * + * Revision 1.39 2007/06/01 16:31:55 fabiankeil + * Change sed() to return a jb_err in preparation for forward-override{}. + * + * Revision 1.38 2007/03/25 14:27:11 fabiankeil + * Let parse_header_time() return a jb_err code + * instead of a pointer that can only be used to + * check for NULL anyway. + * + * Revision 1.37 2007/03/20 15:22:17 fabiankeil + * - Remove filter_client_header() and filter_client_header(), + * filter_header() now checks the shiny new + * CSP_FLAG_CLIENT_HEADER_PARSING_DONE flag instead. + * + * Revision 1.36 2007/03/05 13:25:32 fabiankeil + * - Cosmetical changes for LOG_LEVEL_RE_FILTER messages. + * - Handle "Cookie:" and "Connection:" headers a bit smarter + * (don't crunch them just to recreate them later on). + * - Add another non-standard time format for the cookie + * expiration date detection. + * - Fix a valgrind warning. + * + * Revision 1.35 2007/01/01 19:36:37 fabiankeil + * Integrate a modified version of Wil Mahan's + * zlib patch (PR #895531). + * + * Revision 1.34 2006/12/29 19:08:22 fabiankeil + * Reverted parts of my last commit + * to keep error handling working. + * + * Revision 1.33 2006/12/29 18:04:40 fabiankeil + * Fixed gcc43 conversion warnings. + * + * Revision 1.32 2006/12/06 19:14:23 fabiankeil + * Added prototype for get_destination_from_headers(). + * + * Revision 1.31 2006/08/17 17:15:10 fabiankeil + * - Back to timegm() using GnuPG's replacement if necessary. + * Using mktime() and localtime() could add a on hour offset if + * the randomize factor was big enough to lead to a summer/wintertime + * switch. + * + * - Removed now-useless Privoxy 3.0.3 compatibility glue. + * + * - Moved randomization code into pick_from_range(). + * + * - Changed parse_header_time definition. + * time_t isn't guaranteed to be signed and + * if it isn't, -1 isn't available as error code. + * Changed some variable types in client_if_modified_since() + * because of the same reason. + * + * Revision 1.30 2006/08/14 08:25:19 fabiankeil + * Split filter-headers{} into filter-client-headers{} + * and filter-server-headers{}. + * Added parse_header_time() to share some code. + * Replaced timegm() with mktime(). + * + * Revision 1.29 2006/08/03 02:46:41 david__schmidt + * Incorporate Fabian Keil's patch work:http://www.fabiankeil.de/sourcecode/privoxy/ + * + * Revision 1.28 2006/07/18 14:48:47 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.26.2.1 2002/09/25 14:52:46 oes + * Added basic support for OPTIONS and TRACE HTTP methods: + * - New parser function client_max_forwards which decrements + * the Max-Forwards HTTP header field of OPTIONS and TRACE + * requests by one before forwarding + * - New parser function client_host which extracts the host + * and port information from the HTTP header field if the + * request URI was not absolute + * - Don't crumble and re-add the Host: header, but only generate + * and append if missing + * + * Revision 1.26 2002/05/08 15:59:53 oes + * Changed add_to_iob signature (now returns jb_err) + * + * Revision 1.25 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.24 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.23 2002/03/13 00:27:05 jongfoster + * Killing warnings + * + * Revision 1.22 2002/03/09 20:03:52 jongfoster + * - Making various functions return int rather than size_t. + * (Undoing a recent change). Since size_t is unsigned on + * Windows, functions like read_socket that return -1 on + * error cannot return a size_t. + * + * THIS WAS A MAJOR BUG - it caused frequent, unpredictable + * crashes, and also frequently caused JB to jump to 100% + * CPU and stay there. (Because it thought it had just + * read ((unsigned)-1) == 4Gb of data...) + * + * - The signature of write_socket has changed, it now simply + * returns success=0/failure=nonzero. + * + * - Trying to get rid of a few warnings --with-debug on + * Windows, I've introduced a new type "jb_socket". This is + * used for the socket file descriptors. On Windows, this + * is SOCKET (a typedef for unsigned). Everywhere else, it's + * an int. The error value can't be -1 any more, so it's + * now JB_INVALID_SOCKET (which is -1 on UNIX, and in + * Windows it maps to the #define INVALID_SOCKET.) + * + * - The signature of bind_port has changed. + * + * Revision 1.21 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.20 2002/02/20 23:15:13 jongfoster + * Parsing functions now handle out-of-memory gracefully by returning + * an error code. + * + * Revision 1.19 2002/01/17 21:03:47 jongfoster + * Moving all our URL and URL pattern parsing code to urlmatch.c. + * + * Revision 1.18 2001/10/26 17:40:23 oes + * Introduced get_header_value() + * Removed client_accept() + * + * Revision 1.17 2001/10/13 12:47:32 joergs + * Removed client_host, added client_host_adder + * + * Revision 1.16 2001/10/07 18:50:16 oes + * Added server_content_encoding, renamed server_transfer_encoding + * + * Revision 1.15 2001/10/07 18:01:55 oes + * Changed server_http11 to server_http + * + * Revision 1.14 2001/10/07 15:45:48 oes + * added client_accept_encoding, client_te, client_accept_encoding_adder + * + * renamed content_type and content_length + * + * fixed client_host and strclean prototypes + * + * Revision 1.13 2001/09/29 12:56:03 joergs + * IJB now changes HTTP/1.1 to HTTP/1.0 in requests and answers. + * + * Revision 1.12 2001/09/13 23:05:50 jongfoster + * Changing the string paramater to the header parsers a "const". + * + * Revision 1.11 2001/07/31 14:46:53 oes + * Added prototype for connection_close_adder + * + * Revision 1.10 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.9 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.8 2001/07/13 14:01:54 oes + * Removed all #ifdef PCRS + * + * Revision 1.7 2001/06/29 13:32:14 oes + * Removed logentry from cancelled commit + * + * Revision 1.6 2001/06/03 19:12:38 oes + * deleted const struct interceptors + * + * Revision 1.5 2001/05/31 21:30:33 jongfoster + * Removed list code - it's now in list.[ch] + * Renamed "permission" to "action", and changed many features + * to use the actions file rather than the global config. + * + * Revision 1.4 2001/05/27 13:19:06 oes + * Patched Joergs solution for the content-length in. + * + * Revision 1.3 2001/05/26 13:39:32 jongfoster + * Only crunches Content-Length header if applying RE filtering. + * Without this fix, Microsoft Windows Update wouldn't work. + * + * Revision 1.2 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.1.1.1 2001/05/15 13:59:01 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "project.h"
diff --git a/external/privoxy/pcrs.c b/external/privoxy/pcrs.c index e42dd4c..1946ca7 100644 --- a/external/privoxy/pcrs.c +++ b/external/privoxy/pcrs.c @@ -1,4 +1,4 @@ -const char pcrs_rcs[] = "$Id: pcrs.c,v 1.38 2011/09/04 11:10:56 fabiankeil Exp $"; +const char pcrs_rcs[] = "$Id: pcrs.c,v 1.29 2007/09/22 16:17:19 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/pcrs.c,v $ @@ -16,7 +16,7 @@ const char pcrs_rcs[] = "$Id: pcrs.c,v 1.38 2011/09/04 11:10:56 fabiankeil Exp $ * * Copyright (C) 2006, 2007 Fabian Keil fk@fabiankeil.de * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU Lesser * General Public License (LGPL), version 2.1, which should * be included in this distribution (see LICENSE.txt), with @@ -35,8 +35,156 @@ const char pcrs_rcs[] = "$Id: pcrs.c,v 1.38 2011/09/04 11:10:56 fabiankeil Exp $ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: pcrs.c,v $ + * Revision 1.29 2007/09/22 16:17:19 fabiankeil + * Move our includes below system includes to prevent macro conflicts. + * + * Revision 1.28 2007/08/18 14:37:27 fabiankeil + * Ditch hex_to_byte() in favour of xtoi(). + * + * Revision 1.27 2007/08/05 13:47:04 fabiankeil + * #1763173 from Stefan Huehner: s@const static@static const@. + * + * Revision 1.26 2007/07/01 13:29:54 fabiankeil + * Add limited hex notation support for the PCRS + * substitution text ('\x7e' = '~'). Closes #1627140. + * + * Revision 1.25 2007/04/30 15:02:18 fabiankeil + * Introduce dynamic pcrs jobs that can resolve variables. + * + * Revision 1.24 2007/01/05 15:46:12 fabiankeil + * Don't use strlen() to calculate the length of + * the pcrs substitutes. They don't have to be valid C + * strings and getting their length wrong can result in + * user-controlled memory corruption. + * + * Thanks to Felix Gröbert for reporting the problem + * and providing the fix [#1627140]. + * + * Revision 1.23 2006/12/29 17:53:05 fabiankeil + * Fixed gcc43 conversion warnings. + * + * Revision 1.22 2006/12/24 17:34:20 fabiankeil + * Add pcrs_strerror() message for PCRE_ERROR_MATCHLIMIT + * and give a hint why an error code might be unknown. + * + * Catch NULL subjects early in pcrs_execute(). + * + * Revision 1.21 2006/07/18 14:48:47 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.19.2.4 2005/05/07 21:50:55 david__schmidt + * A few memory leaks plugged (mostly on error paths) + * + * Revision 1.19.2.3 2003/12/04 12:32:45 oes + * Append a trailing nullbyte to result to facilitate string processing + * + * Revision 1.19.2.2 2002/10/08 16:22:28 oes + * Bugfix: Need to check validity of backreferences explicitly, + * because when max_matches are reached and matches is expanded, + * realloc() does not zero the memory. Fixes Bug # 606227 + * + * Revision 1.19.2.1 2002/08/10 11:23:40 oes + * Include prce.h via project.h, where the appropriate + * source will have been selected + * + * Revision 1.19 2002/03/08 14:47:48 oes + * Cosmetics + * + * Revision 1.18 2002/03/08 14:17:14 oes + * Fixing -Wconversion warnings + * + * Revision 1.17 2002/03/08 13:45:48 oes + * Hiding internal functions + * + * Revision 1.16 2001/11/30 21:32:14 jongfoster + * Fixing signed/unsigned comparison (Andreas please check this!) + * One tab->space + * + * Revision 1.15 2001/09/20 16:11:06 steudten + * + * Add casting for some string functions. + * + * Revision 1.14 2001/09/09 21:41:57 oes + * Fixing yet another silly bug + * + * Revision 1.13 2001/09/06 14:05:59 oes + * Fixed silly bug + * + * Revision 1.12 2001/08/18 11:35:00 oes + * - Introduced pcrs_strerror() + * - made some NULL arguments non-fatal + * - added support for \n \r \e \b \t \f \a \0 in substitute + * - made quoting adhere to standard rules + * - added warning for bad backrefs + * - added pcrs_execute_list() + * - fixed comments + * - bugfix & cosmetics + * + * Revision 1.11 2001/08/15 15:32:03 oes + * - Added support for Perl's special variables $+, $' and $` + * - Improved the substitute parser + * - Replaced the hard limit for the maximum number of matches + * by dynamic reallocation + * + * Revision 1.10 2001/08/05 13:13:11 jongfoster + * Making parameters "const" where possible. + * + * Revision 1.9 2001/07/18 17:27:00 oes + * Changed interface; Cosmetics + * + * Revision 1.8 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.7 2001/06/29 13:33:04 oes + * - Cleaned up, renamed and reordered functions, + * improved comments + * - Removed my_strsep + * - Replaced globalflag with a general flags int + * that holds PCRS_GLOBAL, PCRS_SUCCESS, and PCRS_TRIVIAL + * - Introduced trivial option that will prevent pcrs + * from honouring backreferences in the substitute, + * which is useful for large substitutes that are + * red in from somewhere and saves the pain of escaping + * the backrefs + * - Introduced convenience function pcrs_free_joblist() + * - Split pcrs_make_job() into pcrs_compile(), which still + * takes a complete s/// comand as argument and parses it, + * and a new function pcrs_make_job, which takes the + * three separate components. This should make for a + * much friendlier frontend. + * - Removed create_pcrs_job() which was useless + * - Fixed a bug in pcrs_execute + * - Success flag is now handled by pcrs instead of user + * + * Revision 1.6 2001/06/03 19:12:45 oes + * added FIXME + * + * Revision 1.5 2001/05/29 09:50:24 jongfoster + * (Fixed one int -> size_t) + * + * Revision 1.4 2001/05/25 14:12:40 oes + * Fixed bug: Empty substitutes now detected + * + * Revision 1.3 2001/05/25 11:03:55 oes + * Added sanity check for NULL jobs to pcrs_exec_substitution + * + * Revision 1.2 2001/05/22 18:46:04 oes + * + * Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * Revision 1.1.1.1 2001/05/15 13:59:02 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include <string.h> #include <ctype.h> @@ -71,7 +219,7 @@ static int is_hex_sequence(const char *sequence); * Function : pcrs_strerror * * Description : Return a string describing a given error code. - * + * * Parameters : * 1 : error = the error code * @@ -80,7 +228,7 @@ static int is_hex_sequence(const char *sequence); *********************************************************************/ const char *pcrs_strerror(const int error) { - if (error != 0) + if (error < 0) { switch (error) { @@ -94,7 +242,7 @@ const char *pcrs_strerror(const int error) case PCRE_ERROR_UNKNOWN_NODE: return "(pcre:) Bad node in pattern";
/* Can't happen / not passed: */ - case PCRE_ERROR_NOSUBSTRING: return "(pcre:) Fire in power supply"; + case PCRE_ERROR_NOSUBSTRING: return "(pcre:) Fire in power supply"; case PCRE_ERROR_NOMATCH: return "(pcre:) Water in power supply";
#ifdef PCRE_ERROR_MATCHLIMIT @@ -113,7 +261,7 @@ const char *pcrs_strerror(const int error) case PCRS_WARN_TRUNCATION: return "(pcrs:) At least one variable was too big and has been truncated before compilation";
- /* + /* * XXX: With the exception of PCRE_ERROR_MATCHLIMIT we * only catch PCRE errors that can happen with our internal * version. If Privoxy is linked against a newer @@ -139,12 +287,12 @@ const char *pcrs_strerror(const int error) * 'T' (trivial) options but pcrs needs them, the corresponding * flags are set if 'g'or 'T' is encountered. * Note: The 'T' and 'U' options do not conform to Perl. - * + * * Parameters : * 1 : optstring = string with options in perl syntax * 2 : flags = see description * - * Returns : option integer suitable for pcre + * Returns : option integer suitable for pcre * *********************************************************************/ static int pcrs_parse_perl_options(const char *optstring, int *flags) @@ -236,7 +384,7 @@ static pcrs_substitute *pcrs_compile_replacement(const char *replacement, int tr return NULL; } memset(text, '\0', length + 1); - +
/* * In trivial mode, just copy the substitute text @@ -305,7 +453,7 @@ static pcrs_substitute *pcrs_compile_replacement(const char *replacement, int tr assert(ascii_value < 256); text[k++] = (char)ascii_value; i += 4; - } + } else { quoted = 1; @@ -337,7 +485,7 @@ static pcrs_substitute *pcrs_compile_replacement(const char *replacement, int tr /* Symbolic backreferences: */ else if (NULL != (symbol = strchr(symbols, replacement[i + 1]))) { - + if (symbol - symbols == 2) /* $+ */ { r->backref[l] = capturecount; @@ -348,7 +496,7 @@ static pcrs_substitute *pcrs_compile_replacement(const char *replacement, int tr } else /* $' or $` */ { - r->backref[l] = (int)(PCRS_MAX_SUBMATCHES + 1 - (symbol - symbols)); + r->backref[l] = PCRS_MAX_SUBMATCHES + 1 - (symbol - symbols); } i += 2; } @@ -368,10 +516,10 @@ static pcrs_substitute *pcrs_compile_replacement(const char *replacement, int tr else { *errptr = PCRS_WARN_BADREF; - } + } continue; } - + plainchar: /* Plain chars are copied */ text[k++] = replacement[i++]; @@ -397,13 +545,13 @@ plainchar: * Function : pcrs_free_job * * Description : Frees the memory used by a pcrs_job struct and its - * dependent structures. + * dependant structures. * * Parameters : * 1 : job = pointer to the pcrs_job structure to be freed * * Returns : a pointer to the next job, if there was any, or - * NULL otherwise. + * NULL otherwise. * *********************************************************************/ pcrs_job *pcrs_free_job(pcrs_job *job) @@ -458,7 +606,7 @@ void pcrs_free_joblist(pcrs_job *joblist) * * Function : pcrs_compile_command * - * Description : Parses a string with a Perl-style s/// command, + * Description : Parses a string with a Perl-style s/// command, * calls pcrs_compile, and returns a corresponding * pcrs_job, or NULL if parsing or compiling the job * fails. @@ -478,11 +626,11 @@ pcrs_job *pcrs_compile_command(const char *command, int *errptr) int i, k, l, quoted = FALSE; size_t limit; char delimiter; - char *tokens[4]; + char *tokens[4]; pcrs_job *newjob; - - k = l = 0; - + + i = k = l = 0; + /* * Tokenize the perl command */ @@ -501,7 +649,7 @@ pcrs_job *pcrs_compile_command(const char *command, int *errptr)
for (i = 0; i <= (int)limit; i++) { - + if (command[i] == delimiter && !quoted) { if (l == 3) @@ -513,7 +661,7 @@ pcrs_job *pcrs_compile_command(const char *command, int *errptr) tokens[++l] = tokens[0] + k; continue; } - + else if (command[i] == '\' && !quoted) { quoted = TRUE; @@ -535,11 +683,11 @@ pcrs_job *pcrs_compile_command(const char *command, int *errptr) free(tokens[0]); return NULL; } - + newjob = pcrs_compile(tokens[1], tokens[2], tokens[3], errptr); free(tokens[0]); return newjob; - + }
@@ -571,14 +719,14 @@ pcrs_job *pcrs_compile(const char *pattern, const char *substitute, const char *
*errptr = 0;
- /* + /* * Handle NULL arguments */ if (pattern == NULL) pattern = ""; if (substitute == NULL) substitute = "";
- /* + /* * Get and init memory */ if (NULL == (newjob = (pcrs_job *)malloc(sizeof(pcrs_job)))) @@ -618,10 +766,10 @@ pcrs_job *pcrs_compile(const char *pattern, const char *substitute, const char * pcrs_free_job(newjob); return NULL; } +
- - /* - * Determine the number of capturing subpatterns. + /* + * Determine the number of capturing subpatterns. * This is needed for handling $+ in the substitute. */ if (0 > (*errptr = pcre_fullinfo(newjob->pattern, newjob->hints, PCRE_INFO_CAPTURECOUNT, &capturecount))) @@ -629,7 +777,7 @@ pcrs_job *pcrs_compile(const char *pattern, const char *substitute, const char * pcrs_free_job(newjob); return NULL; } - +
/* * Compile the substitute @@ -639,7 +787,7 @@ pcrs_job *pcrs_compile(const char *pattern, const char *substitute, const char * pcrs_free_job(newjob); return NULL; } - + return newjob;
} @@ -654,7 +802,7 @@ pcrs_job *pcrs_compile(const char *pattern, const char *substitute, const char * * the joblist to the subject. * The subject itself is left untouched, memory for the result * is malloc()ed and it is the caller's responsibility to free - * the result when it's no longer needed. + * the result when it's no longer needed. * * Note: For convenient string handling, a null byte is * appended to the result. It does not count towards the @@ -664,8 +812,8 @@ pcrs_job *pcrs_compile(const char *pattern, const char *substitute, const char * * Parameters : * 1 : joblist = the chained list of pcrs_jobs to be executed * 2 : subject = the subject string - * 3 : subject_length = the subject's length - * 4 : result = char** for returning the result + * 3 : subject_length = the subject's length + * 4 : result = char** for returning the result * 5 : result_length = size_t* for returning the result's length * * Returns : On success, the number of substitutions that were made. @@ -679,10 +827,10 @@ int pcrs_execute_list(pcrs_job *joblist, char *subject, size_t subject_length, c pcrs_job *job; char *old, *new = NULL; int hits, total_hits; - + old = subject; *result_length = subject_length; - total_hits = 0; + hits = total_hits = 0;
for (job = joblist; job != NULL; job = job->next) { @@ -724,8 +872,8 @@ int pcrs_execute_list(pcrs_job *joblist, char *subject, size_t subject_length, c * Parameters : * 1 : job = the pcrs_job to be executed * 2 : subject = the subject (== original) string - * 3 : subject_length = the subject's length - * 4 : result = char** for returning the result + * 3 : subject_length = the subject's length + * 4 : result = char** for returning the result * 5 : result_length = size_t* for returning the result's length * * Returns : On success, the number of substitutions that were made. @@ -746,9 +894,9 @@ int pcrs_execute(pcrs_job *job, const char *subject, size_t subject_length, char pcrs_match *matches, *dummy; char *result_offset;
- offset = i = 0; + offset = i = k = 0;
- /* + /* * Sanity check & memory allocation */ if (job == NULL || job->pattern == NULL || job->substitute == NULL || NULL == subject) @@ -781,13 +929,13 @@ int pcrs_execute(pcrs_job *job, const char *subject, size_t subject_length, char matches[i].submatch_offset[k] = offsets[2 * k];
/* Note: Non-found optional submatches have length -1-(-1)==0 */ - matches[i].submatch_length[k] = (size_t)(offsets[2 * k + 1] - offsets[2 * k]); + matches[i].submatch_length[k] = (size_t)(offsets[2 * k + 1] - offsets[2 * k]);
/* reserve mem for each submatch as often as it is ref'd */ newsize += matches[i].submatch_length[k] * (size_t)job->substitute->backref_count[k]; } /* plus replacement text size minus match text size */ - newsize += job->substitute->length - matches[i].submatch_length[0]; + newsize += job->substitute->length - matches[i].submatch_length[0];
/* chunk before match */ matches[i].submatch_offset[PCRS_MAX_SUBMATCHES] = 0; @@ -829,12 +977,12 @@ int pcrs_execute(pcrs_job *job, const char *subject, size_t subject_length, char if (submatches < PCRE_ERROR_NOMATCH) { free(matches); - return submatches; + return submatches; } matches_found = i;
- /* + /* * Get memory for the result (must be freed by caller!) * and append terminating null byte. */ @@ -849,7 +997,7 @@ int pcrs_execute(pcrs_job *job, const char *subject, size_t subject_length, char }
- /* + /* * Replace */ offset = 0; @@ -858,7 +1006,7 @@ int pcrs_execute(pcrs_job *job, const char *subject, size_t subject_length, char for (i = 0; i < matches_found; i++) { /* copy the chunk preceding the match */ - memcpy(result_offset, subject + offset, (size_t)(matches[i].submatch_offset[0] - offset)); + memcpy(result_offset, subject + offset, (size_t)(matches[i].submatch_offset[0] - offset)); result_offset += matches[i].submatch_offset[0] - offset;
/* For every segment of the substitute.. */ @@ -988,7 +1136,7 @@ int pcrs_job_is_dynamic (char *job) * Parameters : * 1 : string = The string to search in * - * Returns : A safe delimiter if one was found, otherwise '\0'. + * Returns : A safe delimiter if one was found, otherwise '\0'. * *********************************************************************/ char pcrs_get_delimiter(const char *string) @@ -1021,11 +1169,11 @@ char pcrs_get_delimiter(const char *string) * * Parameters : * 1 : subject = the subject (== original) string - * 2 : pcrs_command = the pcrs command as string (s@foo@bar@) - * 3 : hits = int* for returning the number of modifications + * 2 : pcrs_command = the pcrs command as string (s@foo@bar@) + * 3 : hits = int* for returning the number of modifications * * Returns : NULL in case of errors, otherwise the - * result of the pcrs command. + * result of the pcrs command. * *********************************************************************/ char *pcrs_execute_single_command(const char *subject, const char *pcrs_command, int *hits) @@ -1064,12 +1212,13 @@ static const char warning[] = "... [too long, truncated]"; * values of the variables and compiles it. * * Parameters : - * 1 : pcrs_command = The dynamic pcrs command to compile - * 2 : v = NULL terminated array of variables and their values. - * 3 : error = pcrs error code + * 1 : csp = Current client state (buffers, headers, etc...) + * 2 : pcrs_command = The dynamic pcrs command to compile + * 3 : v = NULL terminated array of variables and their values. + * 4 : error = pcrs error code * * Returns : NULL in case of hard errors, otherwise the - * compiled pcrs job. + * compiled pcrs job. * *********************************************************************/ pcrs_job *pcrs_compile_dynamic_command(char *pcrs_command, const struct pcrs_variable v[], int *error) diff --git a/external/privoxy/pcrs.h b/external/privoxy/pcrs.h index 36b89c0..b8939c0 100644 --- a/external/privoxy/pcrs.h +++ b/external/privoxy/pcrs.h @@ -9,10 +9,81 @@ * * Copyright : see pcrs.c * + * Revisions : + * $Log: pcrs.h,v $ + * Revision 1.16 2007/04/30 15:02:19 fabiankeil + * Introduce dynamic pcrs jobs that can resolve variables. + * + * Revision 1.15 2007/01/05 15:46:12 fabiankeil + * Don't use strlen() to calculate the length of + * the pcrs substitutes. They don't have to be valid C + * strings and getting their length wrong can result in + * user-controlled memory corruption. + * + * Thanks to Felix Gröbert for reporting the problem + * and providing the fix [#1627140]. + * + * Revision 1.14 2006/12/24 17:27:37 fabiankeil + * Increase pcrs error code offset to prevent overlaps + * with pcre versions newer than our own. + * + * Revision 1.13 2006/07/18 14:48:47 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.11 2002/03/08 14:18:23 oes + * Fixing -Wconversion warnings + * + * Revision 1.10 2002/03/08 13:44:48 oes + * Hiding internal functions, preventing double inclusion of pcre.h + * + * Revision 1.9 2001/08/18 11:35:29 oes + * - Introduced pcrs_strerror() + * - added pcrs_execute_list() + * + * Revision 1.8 2001/08/15 15:32:50 oes + * Replaced the hard limit for the maximum number of matches + * by dynamic reallocation + * + * Revision 1.7 2001/08/05 13:13:11 jongfoster + * Making parameters "const" where possible. + * + * Revision 1.6 2001/07/29 18:52:06 jongfoster + * Renaming _PCRS_H, and adding "extern C {}" + * + * Revision 1.5 2001/07/18 17:27:00 oes + * Changed interface; Cosmetics + * + * Revision 1.4 2001/06/29 13:33:19 oes + * - Cleaned up, commented and adapted to reflect the + * changes in pcrs.c + * - Introduced the PCRS_* flags + * + * Revision 1.3 2001/06/09 10:58:57 jongfoster + * Removing a single unused #define which referenced BUFSIZ + * + * Revision 1.2 2001/05/25 11:03:55 oes + * Added sanity check for NULL jobs to pcrs_exec_substitution + * + * Revision 1.1.1.1 2001/05/15 13:59:02 oes + * Initial import of version 2.9.3 source tree + * + * Revision 1.4 2001/05/11 01:57:02 rodney + * Added new file header standard w/RCS control tags. + * + * revision 1.3 2001/05/08 02:38:13 rodney + * Changed C++ "//" style comment to C style comments. + * + * revision 1.2 2001/04/30 02:39:24 rodney + * Made this pcrs.h file conditionally included. + * + * revision 1.1 2001/04/16 21:10:38 rodney + * Initial checkin + * *********************************************************************/
-#define PCRS_H_VERSION "$Id: pcrs.h,v 1.17 2009/05/16 13:27:20 fabiankeil Exp $" - +#define PCRS_H_VERSION "$Id: pcrs.h,v 1.16 2007/04/30 15:02:19 fabiankeil Exp $" +
#ifndef _PCRE_H #include <pcre.h> diff --git a/external/privoxy/privoxy-generic.init b/external/privoxy/privoxy-generic.init index ac51234..53b4127 100755 --- a/external/privoxy/privoxy-generic.init +++ b/external/privoxy/privoxy-generic.init @@ -36,6 +36,57 @@ # has notable differences from bash. By design, this script does not try to do # too much, so as to be as cross-platform as possible. # +# +# Revisions : +# $Log: privoxy-generic.init,v $ +# Revision 1.8 2007/06/09 12:35:54 fabiankeil +# Add /usr/xpg4/bin to the PATH to make sure the POSIX +# version of id is used on Solaris. Closes BR#1733788. +# Thanks to Brent Chivers for report and fix. +# +# Revision 1.7 2006/10/14 14:12:22 fabiankeil +# Print warnings if the user tries to run Privoxy as root +# or if the script is run without root privileges; +# only use "--user" if run with root privileges and +# don't depend on $USER being set to root. Fixes BR 779781. +# +# Apparently $USER isn't set on all systems, +# but it also didn't work if the user only +# increased her privileges with su or sudo, +# but still had her real uid in $USER. +# +# Thanks to Florian Effenberger for reporting. +# +# Revision 1.6 2006/07/18 14:48:47 david__schmidt +# Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +# with what was really the latest development (the v_3_0_branch branch) +# +# Revision 1.5.2.1 2002/10/17 17:04:22 hal9 +# Add from main trunk. Will be needed for make install. +# +# Revision 1.5 2002/10/17 17:01:29 hal9 +# Set paths to match the defaults for a root install. Force remove PIDFILE on +# stop. +# +# Revision 1.4 2002/09/11 01:15:02 hal9 +# Fix typo in variable. Now tested on Solaris and Linux, with defaults. +# +# Revision 1.3 2002/09/11 01:09:14 hal9 +# Better handling of pidfile, and process owner. +# +# Revision 1.2 2002/09/08 20:27:58 hal9 +# -Rewrote script config section. +# -Added comments to script. +# -Tried to add logic to use a --user privoxy, if available. +# -Minor script changes due to 'echo -n' does not work on a true +# /bin/sh system. +# +# Revision 1.1 2002/09/06 00:20:26 hal9 +# Creating a generic init script, meant to be used on platforms where don't have +# a custom init script. +# +# Revision 1.0 2002/09/05 17:14:32 hal9 +# #######################################################################
# Is this needed by Solaris? diff --git a/external/privoxy/privoxy.1 b/external/privoxy/privoxy.1 index f64cb9a..dca772a 100644 --- a/external/privoxy/privoxy.1 +++ b/external/privoxy/privoxy.1 @@ -3,7 +3,7 @@ ." http://shell.ipoline.com/~elmert/comp/docbook2X/ ." Please send any bug reports, improvements, comments, patches, ." etc. to Steve Cheng steve@ggi-project.org. -.TH "PRIVOXY" "1" "26 Dezember 2011" "Privoxy 3.0.19" "" +.TH "PRIVOXY" "1" "21 March 2009" "Privoxy 3.0.12" "" .SH NAME privoxy - Privacy Enhancing Proxy .SH SYNOPSIS @@ -45,7 +45,7 @@ that user's home directory, i.e. make the kernel pretend to the \fBPrivoxy\fR process that the directory tree starts there. If set up carefully, this can limit the impact of possible vulnerabilities in \fBPrivoxy\fR to the files contained in -that hierarchy. +that hierarchy. .TP \fB--pre-chroot-nslookup \fIhostname\fB\fR Initialize the resolver library using \fIhostname\fR @@ -55,7 +55,7 @@ that must be copied into the chroot tree. If the \fIconfigfile\fR is not specified on the command line, \fBPrivoxy\fR will look for a file named \fIconfig\fR in the current directory. If no -\fIconfigfile\fR is found, \fBPrivoxy\fR will +\fIconfigfile\fR is found, \fBPrivoxy\fR will fail to start. .SH "DESCRIPTION" .PP @@ -65,17 +65,7 @@ access, and removing ads and other obnoxious Internet junk. Privoxy has a flexible configuration and can be customized to suit individual needs and tastes. It has application for both stand-alone systems and multi-user networks. .PP -Privoxy is Free Software and licensed under the GNU GPLv2. -.PP -Privoxy is an associated project of Software in the Public Interest (SPI). -.PP -Helping hands and donations are welcome: -.TP 0.2i -(bu -http://www.privoxy.org/faq/general.html#PARTICIPATE -.TP 0.2i -(bu -http://www.privoxy.org/faq/general.html#DONATE +Privoxy is Free Software and licensed under the GPL2. .SH "INSTALLATION AND USAGE" .PP Browsers can either be individually configured to use @@ -84,19 +74,19 @@ or \fBPrivoxy\fR can be combined with a packet filter to build an intercepting proxy (see \fIconfig\fR). The default setting is for localhost, on port 8118 (configurable in the main config file). To set the -HTTP proxy in Firefox, go through: \fBTools\fR; +HTTP proxy in Firefox, go through: \fBTools\fR; \fBOptions\fR; \fBGeneral\fR; \fBConnection Settings\fR; -\fBManual Proxy Configuration\fR. +\fBManual Proxy Configuration\fR. .PP -For Internet Explorer, go through: \fBTools\fR; +For Internet Explorer, go through: \fBTools\fR; \fBInternet Properties\fR; \fBConnections\fR; -\fBLAN Settings\fR. +\fBLAN Settings\fR. .PP The Secure (SSL) Proxy should also be set to the same values, otherwise https: URLs will not be proxied. Note: \fBPrivoxy\fR can only proxy HTTP and HTTPS traffic. Do not try it with FTP or other protocols. -HTTPS presents some limitations, and not all features will work with HTTPS +HTTPS presents some limitations, and not all features will work with HTTPS connections. .PP For other browsers, check the documentation. @@ -105,23 +95,23 @@ For other browsers, check the documentation. \fBPrivoxy\fR can be configured with the various configuration files. The default configuration files are: \fIconfig\fR, \fIdefault.filter\fR, \fIdefault.action\fR and -\fIdefault.action\fR. \fIuser.action\fR should +\fIdefault.action\fR. \fIuser.action\fR should be used for locally defined exceptions to the default rules in \fImatch-all.action\fR and \fIdefault.action\fR, and \fIuser.filter\fR for locally defined filters. These are well commented. On Unix and Unix-like systems, these are located in -\fI/etc/privoxy/\fR by default. +\fI/etc/privoxy/\fR by default. .PP -\fBPrivoxy\fR uses the concept of \fBactions\fR +\fBPrivoxy\fR uses the concept of \fBactions\fR in order to manipulate the data stream between the browser and remote sites. -There are various actions available with specific functions for such things +There are various actions available with specific functions for such things as blocking web sites, managing cookies, etc. These actions can be invoked -individually or combined, and used against individual URLs, or groups of URLs +individually or combined, and used against individual URLs, or groups of URLs that can be defined using wildcards and regular expressions. The result is that the user has greatly enhanced control and freedom. .PP The actions list (ad blocks, etc) can also be configured with your -web browser at http://config.privoxy.org/ +web browser at http://config.privoxy.org/ (assuming the configuration allows it). \fBPrivoxy's\fR configuration parameters can also be viewed at the same page. In addition, \fBPrivoxy\fR can be toggled on/off. @@ -133,6 +123,7 @@ features and notes on upgrading. .SH "FILES"
.nf + \fI/usr/sbin/privoxy\fR \fI/etc/privoxy/config\fR \fI/etc/privoxy/match-all.action\fR @@ -152,11 +143,11 @@ documentation directory. .PP \fBPrivoxy\fR terminates on the \fBSIGINT\fR, \fBSIGTERM\fR and \fBSIGABRT\fR signals. Log -rotation scripts may cause a re-opening of the logfile by sending a +rotation scripts may cause a re-opening of the logfile by sending a \fBSIGHUP\fR to \fBPrivoxy\fR. Note that unlike other daemons, \fBPrivoxy\fR does not need to be made aware of config file changes by \fBSIGHUP\fR -- it will detect them -automatically. +automatically. .SH "NOTES" .PP Please see the \fIUser Manual\fR on how to contact the @@ -167,17 +158,17 @@ Other references and sites of interest to \fBPrivoxy\fR users: .PP
-http://www.privoxy.org/, -the \fBPrivoxy\fR Home page. +http://www.privoxy.org/, +the \fBPrivoxy\fR Home page.
-http://www.privoxy.org/faq/, -the \fBPrivoxy\fR FAQ. +http://www.privoxy.org/faq/, +the \fBPrivoxy\fR FAQ.
-http://www.privoxy.org/developer-manual/, -the \fBPrivoxy\fR developer manual. +http://www.privoxy.org/developer-manual/, +the \fBPrivoxy\fR developer manual.
-https://sourceforge.net/projects/ijbswa/, -the Project Page for \fBPrivoxy\fR on +https://sourceforge.net/projects/ijbswa/, +the Project Page for \fBPrivoxy\fR on SourceForge.
http://config.privoxy.org/, @@ -185,7 +176,7 @@ the web-based user interface. \fBPrivoxy\fR must be running for this to work. Shortcut: http://p.p/
https://sourceforge.net/tracker/?group_id=11118&atid=460288, to submit ``misses'' and other -configuration related suggestions to the developers. +configuration related suggestions to the developers. .SH "DEVELOPMENT TEAM"
.nf @@ -193,13 +184,16 @@ configuration related suggestions to the developers. David Schmidt, developer
Hal Burgiss + Mark Miller + Gerry Murphy Lee Rian Roland Rosenfeld + J[:o]rg Strohmayer .fi .SH "COPYRIGHT AND LICENSE" .SS "COPYRIGHT" .PP -Copyright (C) 2001-2011 by Privoxy Developers ijbswa-developers@lists.sourceforge.net +Copyright (C) 2001-2009 by Privoxy Developers ijbswa-developers@lists.sourceforge.net .PP Some source code is based on code Copyright (C) 1997 by Anonymous Coders and Junkbusters, Inc. and licensed under the \fIGNU General Public @@ -207,7 +201,7 @@ License\fR. .SS "LICENSE" .PP \fBPrivoxy\fR is free software; you can -redistribute it and/or modify it under the terms of the +redistribute it and/or modify it under the terms of the \fIGNU General Public License\fR, version 2, as published by the Free Software Foundation. .PP diff --git a/external/privoxy/project.h b/external/privoxy/project.h index 8623748..300d9d6 100644 --- a/external/privoxy/project.h +++ b/external/privoxy/project.h @@ -1,7 +1,7 @@ #ifndef PROJECT_H_INCLUDED #define PROJECT_H_INCLUDED /** Version string. */ -#define PROJECT_H_VERSION "$Id: project.h,v 1.171 2011/09/04 11:10:56 fabiankeil Exp $" +#define PROJECT_H_VERSION "$Id: project.h,v 1.129 2009/03/08 14:12:51 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/project.h,v $ @@ -10,7 +10,7 @@ * project. Does not define any variables or functions * (though it does declare some macros). * - * Copyright : Written by and Copyright (C) 2001-2010 the + * Copyright : Written by and Copyright (C) 2001-2009 the * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written @@ -35,8 +35,672 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: project.h,v $ + * Revision 1.129 2009/03/08 14:12:51 fabiankeil + * All the CSP_FLAG_FOO bit masks should be unsigned ints. + * + * Revision 1.128 2009/03/07 13:09:17 fabiankeil + * Change csp->expected_content and_csp->expected_content_length from + * size_t to unsigned long long to reduce the likelihood of integer + * overflows that would let us close the connection prematurely. + * Bug found while investigating #2669131, reported by cyberpatrol. + * + * Revision 1.127 2008/12/20 14:53:55 fabiankeil + * Add config option socket-timeout to control the time + * Privoxy waits for data to arrive on a socket. Useful + * in case of stale ssh tunnels or when fuzz-testing. + * + * Revision 1.126 2008/12/14 17:02:54 fabiankeil + * Fix a cparser warning. + * + * Revision 1.125 2008/11/20 08:22:28 fabiankeil + * Remove an obsolete comment. + * + * Revision 1.124 2008/11/16 12:43:49 fabiankeil + * Turn keep-alive support into a runtime feature + * that is disabled by setting keep-alive-timeout + * to a negative value. + * + * Revision 1.123 2008/11/10 16:55:59 fabiankeil + * Fix a gcc44 warning (in filters.c). + * + * Revision 1.122 2008/10/16 07:11:34 fabiankeil + * Fix a bunch of gcc44 conversion warnings. + * + * Revision 1.121 2008/10/09 18:21:41 fabiankeil + * Flush work-in-progress changes to keep outgoing connections + * alive where possible. Incomplete and mostly #ifdef'd out. + * + * Revision 1.120 2008/09/21 13:36:52 fabiankeil + * If change-x-forwarded-for{add} is used and the client + * sends multiple X-Forwarded-For headers, append the client's + * IP address to each one of them. "Traditionally" we would + * lose all but the last one. + * + * Revision 1.119 2008/09/20 10:04:33 fabiankeil + * Remove hide-forwarded-for-headers action which has + * been obsoleted by change-x-forwarded-for{block}. + * + * Revision 1.118 2008/09/19 15:26:29 fabiankeil + * Add change-x-forwarded-for{} action to block or add + * X-Forwarded-For headers. Mostly based on code removed + * before 3.0.7. + * + * Revision 1.117 2008/08/30 12:03:07 fabiankeil + * Remove FEATURE_COOKIE_JAR. + * + * Revision 1.116 2008/05/20 16:05:02 fabiankeil + * Move parsers structure definition from project.h to parsers.h. + * + * Revision 1.115 2008/05/19 16:57:20 fabiankeil + * Declare all members of the parsers structure immutable. + * + * Revision 1.114 2008/04/11 16:35:39 fabiankeil + * Oops, I forgot to shorten the URL_SPEC_INITIALIZER in my last commit. + * + * Revision 1.113 2008/04/10 14:41:04 fabiankeil + * Ditch url_spec's path member now that it's no longer used. + * + * Revision 1.112 2008/04/06 15:18:34 fabiankeil + * Oh well, rename the --enable-pcre-host-patterns option to + * --enable-extended-host-patterns as it's not really PCRE syntax. + * + * Revision 1.111 2008/04/06 14:54:26 fabiankeil + * Use PCRE syntax in host patterns when configured + * with --enable-pcre-host-patterns. + * + * Revision 1.110 2008/03/29 12:13:46 fabiankeil + * Remove send-wafer and send-vanilla-wafer actions. + * + * Revision 1.109 2008/03/28 15:13:41 fabiankeil + * Remove inspect-jpegs action. + * + * Revision 1.108 2008/03/27 18:27:36 fabiankeil + * Remove kill-popups action. + * + * Revision 1.107 2008/03/26 18:07:08 fabiankeil + * Add hostname directive. Closes PR#1918189. + * + * Revision 1.106 2008/03/24 11:21:03 fabiankeil + * Share the action settings for multiple patterns in the same + * section so we waste less memory for gigantic block lists + * (and load them slightly faster). Reported by Franz Schwartau. + * + * Revision 1.105 2008/03/21 11:16:27 fabiankeil + * Garbage-collect csp->my_ip_addr_str and csp->my_hostname. + * + * Revision 1.104 2008/03/04 18:30:40 fabiankeil + * Remove the treat-forbidden-connects-like-blocks action. We now + * use the "blocked" page for forbidden CONNECT requests by default. + * + * Revision 1.103 2008/03/01 14:00:45 fabiankeil + * Let the block action take the reason for the block + * as argument and show it on the "blocked" page. + * + * Revision 1.102 2008/02/03 13:46:14 fabiankeil + * Add SOCKS5 support. Patch #1862863 by Eric M. Hopper with minor changes. + * + * Revision 1.101 2007/12/07 18:29:23 fabiankeil + * Remove now-obsolete csp member x_forwarded. + * + * Revision 1.100 2007/09/02 13:42:11 fabiankeil + * - Allow port lists in url patterns. + * - Ditch unused url_spec member pathlen. + * + * Revision 1.99 2007/07/21 11:51:36 fabiankeil + * As Hal noticed, checking dispatch_cgi() as the last cruncher + * looks like a bug if CGI requests are blocked unintentionally, + * so don't do it unless the user enabled the new config option + * "allow-cgi-request-crunching". + * + * Revision 1.98 2007/07/14 07:31:26 fabiankeil + * Add new csp->content_type flag (CT_DECLARED). + * + * Revision 1.97 2007/05/27 12:38:08 fabiankeil + * - Remove some left-overs from the switch to dedicated header filters. + * - Adjust "X-Filter: No" to disable dedicated header filters. + * - Prepare for forward-override{} + * + * Revision 1.96 2007/05/14 10:41:15 fabiankeil + * Ditch the csp member cookie_list[] which isn't used anymore. + * + * Revision 1.95 2007/04/30 15:02:19 fabiankeil + * Introduce dynamic pcrs jobs that can resolve variables. + * + * Revision 1.94 2007/04/15 16:39:21 fabiankeil + * Introduce tags as alternative way to specify which + * actions apply to a request. At the moment tags can be + * created based on client and server headers. + * + * Revision 1.93 2007/03/20 15:16:34 fabiankeil + * Use dedicated header filter actions instead of abusing "filter". + * Replace "filter-client-headers" and "filter-client-headers" + * with "server-header-filter" and "client-header-filter". + * + * Revision 1.92 2007/03/17 15:20:05 fabiankeil + * New config option: enforce-blocks. + * + * Revision 1.91 2007/03/05 13:28:03 fabiankeil + * Add some CSP_FLAGs for the header parsers. + * + * Revision 1.90 2007/02/07 10:36:16 fabiankeil + * Add new http_response member to save + * the reason why the response was generated. + * + * Revision 1.89 2007/01/27 13:09:16 fabiankeil + * Add new config option "templdir" to + * change the templates directory. + * + * Revision 1.88 2007/01/25 13:36:59 fabiankeil + * Add csp->error_message for failure reasons + * that should be embedded into the CGI pages. + * + * Revision 1.87 2007/01/01 19:36:37 fabiankeil + * Integrate a modified version of Wil Mahan's + * zlib patch (PR #895531). + * + * Revision 1.86 2006/12/31 17:56:37 fabiankeil + * Added config option accept-intercepted-requests + * and disabled it by default. + * + * Revision 1.85 2006/12/31 15:03:31 fabiankeil + * Fix gcc43 compiler warnings and a comment. + * + * Revision 1.84 2006/12/21 12:57:48 fabiankeil + * Add config option "split-large-forms" + * to work around the browser bug reported + * in BR #1570678. + * + * Revision 1.83 2006/12/06 19:26:29 fabiankeil + * Moved HTTP snipplets into jcc.c. They aren't + * used anywhere else. + * + * Revision 1.82 2006/09/20 15:50:31 fabiankeil + * Doubled size of HOSTENT_BUFFER_SIZE to mask + * problems with gethostbyname_r and some + * /etc/hosts configurations. Only a workaround + * until we get the real fix ready. + * Thanks Félix Rauch for reporting. + * + * Increased value of MAX_TRUSTED_REFERRERS from 64 to 512. + * + * Revision 1.81 2006/09/06 13:03:04 fabiankeil + * Respond with 400 and a short text message + * if the client tries to use Privoxy as FTP proxy. + * + * Revision 1.80 2006/09/06 10:43:32 fabiankeil + * Added config option enable-remote-http-toggle + * to specify if Privoxy should recognize special + * headers (currently only X-Filter) to change its + * behaviour. Disabled by default. + * + * Revision 1.79 2006/09/06 09:23:37 fabiankeil + * Make number of retries in case of forwarded-connect problems + * a config file option (forwarded-connect-retries) and use 0 as + * default. + * + * Revision 1.78 2006/08/31 16:25:06 fabiankeil + * Work around a buffer overflow that caused Privoxy to + * segfault if too many trusted referrers were used. Good + * enough for now, but should be replaced with a real + * solution after the next release. + * + * Revision 1.77 2006/08/21 12:50:51 david__schmidt + * Formatting cleanup + * + * Revision 1.76 2006/08/14 08:25:19 fabiankeil + * Split filter-headers{} into filter-client-headers{} + * and filter-server-headers{}. + * Added parse_header_time() to share some code. + * Replaced timegm() with mktime(). + * + * Revision 1.75 2006/08/03 02:46:41 david__schmidt + * Incorporate Fabian Keil's patch work: * http://www.fabiankeil.de/sourcecode/privoxy/ + * + * Revision 1.74 2006/07/18 14:48:47 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.72.2.7 2006/01/29 23:10:56 david__schmidt + * Multiple filter file support + * + * Revision 1.72.2.6 2004/10/03 12:53:46 david__schmidt + * Add the ability to check jpeg images for invalid + * lengths of comment blocks. Defensive strategy + * against the exploit: + * Microsoft Security Bulletin MS04-028 + * Buffer Overrun in JPEG Processing (GDI+) Could + * Allow Code Execution (833987) + * Enabled with +inspect-jpegs in actions files. + * + * Revision 1.72.2.5 2004/01/30 15:29:29 oes + * Updated the copyright note + * + * Revision 1.72.2.4 2004/01/13 16:12:14 oes + * Fixed double slash in USER_MANUAL_URL. Closes BR #867088. + * + * Revision 1.72.2.3 2003/03/11 11:54:37 oes + * Introduced RC_FLAG_* flags for use in child process return code + * + * Revision 1.72.2.2 2002/11/28 18:15:44 oes + * Added flag to each cgi_dispatcher that allows or denies + * external linking and removed const qualifier from + * struct list_entry.str. + * + * Revision 1.72.2.1 2002/08/10 11:25:18 oes + * - Include config.h for access to config data + * - Include <pcre*.h> depending on where they are + * + * Revision 1.72 2002/05/14 21:35:49 oes + * Split HELP_LINK_PREFIX into ACTIONS_HELP_PREFIX and CONFIG_HELP_PREFIX + * because of split in user-manual + * + * Revision 1.71 2002/05/12 21:39:36 jongfoster + * - Adding Doxygen-style comments to structures and #defines. + * + * Revision 1.70 2002/05/12 16:05:50 jongfoster + * Fixing ACTION_MASK_ALL to be unsigned long rather than + * just unsigned int. I don't know if anyone is porting + * Privoxy to 16-bit platforms, but if so, +limit-connect + * wouldn't have worked because of this bug. + * + * Revision 1.69 2002/05/08 16:00:16 oes + * Added size member to struct iob, so it can + * be alloced larger than needed. + * + * Revision 1.68 2002/04/26 12:56:00 oes + * Killed REDIRECT_URL, added USER_MANUAL_URL and HELP_LINK_PREFIX + * + * Revision 1.67 2002/04/24 02:12:43 oes + * - Jon's multiple AF patch: + * - Make csp->actions_list an array + * - #define MAX_AF_FILES + * - Moved CGI_PARAM_LEN_MAX (500) here + * + * Revision 1.66 2002/04/15 19:06:43 jongfoster + * Typos + * + * Revision 1.65 2002/04/04 00:36:36 gliptak + * always use pcre for matching + * + * Revision 1.64 2002/04/03 22:28:03 gliptak + * Removed references to gnu_regex + * + * Revision 1.63 2002/03/31 17:19:00 jongfoster + * Win32 only: Enabling STRICT to fix a VC++ compile warning. + * + * Revision 1.62 2002/03/26 22:48:49 swa + * new homepage url + * + * Revision 1.61 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.60 2002/03/24 15:52:17 jongfoster + * Changing CGI URL prefixes for new name + * + * Revision 1.59 2002/03/24 15:23:33 jongfoster + * Name changes + * + * Revision 1.58 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.57 2002/03/16 20:28:34 oes + * Added descriptions to the filters so users will know what they select in the cgi editor + * + * Revision 1.56 2002/03/13 20:27:30 oes + * Fixing bug with CT_TABOO + * + * Revision 1.55 2002/03/12 01:42:50 oes + * Introduced modular filters + * + * Revision 1.54 2002/03/09 20:03:52 jongfoster + * - Making various functions return int rather than size_t. + * (Undoing a recent change). Since size_t is unsigned on + * Windows, functions like read_socket that return -1 on + * error cannot return a size_t. + * + * THIS WAS A MAJOR BUG - it caused frequent, unpredictable + * crashes, and also frequently caused JB to jump to 100% + * CPU and stay there. (Because it thought it had just + * read ((unsigned)-1) == 4Gb of data...) + * + * - The signature of write_socket has changed, it now simply + * returns success=0/failure=nonzero. + * + * - Trying to get rid of a few warnings --with-debug on + * Windows, I've introduced a new type "jb_socket". This is + * used for the socket file descriptors. On Windows, this + * is SOCKET (a typedef for unsigned). Everywhere else, it's + * an int. The error value can't be -1 any more, so it's + * now JB_INVALID_SOCKET (which is -1 on UNIX, and in + * Windows it maps to the #define INVALID_SOCKET.) + * + * - The signature of bind_port has changed. + * + * Revision 1.53 2002/03/08 16:48:55 oes + * Added FEATURE_NO_GIFS and BUILTIN_IMAGE_MIMETYPE + * + * Revision 1.52 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.51 2002/03/05 04:52:42 oes + * Deleted non-errlog debugging code + * + * Revision 1.50 2002/03/04 19:32:07 oes + * Changed default port to 8118 + * + * Revision 1.49 2002/03/04 18:28:55 oes + * Deleted PID_FILE_NAME + * + * Revision 1.48 2002/03/03 14:50:40 oes + * Fixed CLF logging: Added ocmd member for client's request to struct http_request + * + * Revision 1.47 2002/02/20 23:15:13 jongfoster + * Parsing functions now handle out-of-memory gracefully by returning + * an error code. + * + * Revision 1.46 2002/01/17 21:06:09 jongfoster + * Now #defining the URLs of the config interface + * + * Minor changes to struct http_request and struct url_spec due to + * standardizing that struct http_request is used to represent a URL, and + * struct url_spec is used to represent a URL pattern. (Before, URLs were + * represented as seperate variables and a partially-filled-in url_spec). + * + * Revision 1.45 2002/01/09 14:33:27 oes + * Added HOSTENT_BUFFER_SIZE + * + * Revision 1.44 2001/12/30 14:07:32 steudten + * - Add signal handling (unix) + * - Add SIGHUP handler (unix) + * - Add creation of pidfile (unix) + * - Add action 'top' in rc file (RH) + * - Add entry 'SIGNALS' to manpage + * - Add exit message to logfile (unix) + * + * Revision 1.43 2001/11/22 21:57:51 jongfoster + * Making action_spec->flags into an unsigned long rather than just an + * unsigned int. + * Adding ACTION_NO_COOKIE_KEEP + * + * Revision 1.42 2001/11/05 21:42:41 steudten + * Include DBG() macro. + * + * Revision 1.41 2001/10/28 19:12:06 jongfoster + * Adding ijb_toupper() + * + * Revision 1.40 2001/10/26 17:40:47 oes + * Moved ijb_isspace and ijb_tolower to project.h + * Removed http->user_agent, csp->referrer and csp->accept_types + * + * Revision 1.39 2001/10/25 03:45:02 david__schmidt + * Adding a (void*) cast to freez() because Visual Age C++ won't expand the + * macro when called with a cast; so moving the cast to the macro def'n + * seems to both eliminate compiler warnings (on darwin and OS/2, anyway) and + * doesn't make macro expansion complain. Hope this works for everyone else + * too... + * + * Revision 1.38 2001/10/23 21:19:04 jongfoster + * New error-handling support: jb_err type and JB_ERR_xxx constants + * CGI functions now return a jb_err, and their parameters map is const. + * Support for RUNTIME_FEATUREs to enable/disable config editor + * Adding a few comments + * + * Revision 1.37 2001/10/14 22:14:01 jongfoster + * Removing name_length field from struct cgi_dispatcher, as this is + * now calculated at runtime from the "name" field. + * + * Revision 1.36 2001/10/10 16:45:15 oes + * Added LIMIT_CONNECT action and string + * Fixed HTTP message line termination + * Added CFORBIDDEN HTTP message + * + * Revision 1.35 2001/10/07 18:06:43 oes + * Added status member to struct http_request + * + * Revision 1.34 2001/10/07 15:45:25 oes + * Added url member to struct http_request and commented all + * members + * + * Added CT_TABOO + * + * Added ACTION_DOWNGRADE and ACTION_NO_COMPRESSION + * + * Replaced struct client_state members rejected, + * force, active and toggled_on with "flags" bitmap. + * + * Added CSP_FLAG_MODIFIED and CSP_FLAG_CHUNKED + * + * Added buffer_limit to struct configuration_spec + * + * Revision 1.33 2001/09/20 13:30:08 steudten + * + * Make freez() more secure in case of: if (exp) { free(z) ; a=*z } + * Last case will set z to NULL in free(z) and thats bad.. + * + * Revision 1.32 2001/09/16 23:02:51 jongfoster + * Fixing warning + * + * Revision 1.31 2001/09/16 13:20:29 jongfoster + * Rewrite of list library. Now has seperate header and list_entry + * structures. Also added a large sprinking of assert()s to the list + * code. + * + * Revision 1.30 2001/09/13 23:52:00 jongfoster + * Support for both static and dynamically generated CGI pages + * + * Revision 1.29 2001/09/13 23:29:43 jongfoster + * Defining FORWARD_SPEC_INITIALIZER + * + * Revision 1.28 2001/09/13 23:05:50 jongfoster + * Changing the string paramater to the header parsers a "const". + * + * Revision 1.27 2001/08/05 16:06:20 jongfoster + * Modifiying "struct map" so that there are now separate header and + * "map_entry" structures. This means that functions which modify a + * map no longer need to return a pointer to the modified map. + * Also, it no longer reverses the order of the entries (which may be + * important with some advanced template substitutions). + * + * Revision 1.26 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.25 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.24 2001/07/25 17:20:27 oes + * Introduced http->user_agent + * + * Revision 1.23 2001/07/18 12:32:23 oes + * - Added ACTION_STRING_DEANIMATE + * - moved #define freez from jcc.h to project.h + * + * Revision 1.22 2001/07/15 17:51:41 jongfoster + * Renaming #define STATIC to STATIC_PCRE + * + * Revision 1.21 2001/07/13 14:03:19 oes + * - Reorganized regex header inclusion and #defines to + * comply to the scheme in configure.in + * - Added csp->content_type and its CT_* keys + * - Added ACTION_DEANIMATE + * - Removed all #ifdef PCRS + * + * Revision 1.20 2001/06/29 21:45:41 oes + * Indentation, CRLF->LF, Tab-> Space + * + * Revision 1.19 2001/06/29 13:33:36 oes + * - Improved comments + * - Introduced http_request.host_ip_addr_str + * - Introduced http_response.head_length + * - Introduced config.my_ip_addr_str, config.my_hostname, + * config.admin_address and config.proxy_info_url + * - Removed config.proxy_args_header and config.proxy_args_trailer, + * renamed config.proxy_args_invocation to config.proxy_args + * - Removed HTML snipplets and GIFs + * - Removed logentry from cancelled commit + * + * Revision 1.18 2001/06/09 10:57:39 jongfoster + * Adding definition of BUFFER_SIZE. + * Changing struct cgi_dispatcher to use "const" strings. + * + * Revision 1.17 2001/06/07 23:15:09 jongfoster + * Merging ACL and forward files into config file. + * Moving struct gateway members into struct forward_spec + * Removing config->proxy_args_gateways + * Cosmetic: Adding a few comments + * + * Revision 1.16 2001/06/04 18:31:58 swa + * files are now prefixed with either `confdir' or `logdir'. + * `make redhat-dist' replaces both entries confdir and logdir + * with redhat values + * + * Revision 1.15 2001/06/04 11:28:53 swa + * redirect did not work due to missing / + * + * Revision 1.14 2001/06/03 11:03:48 oes + * Added struct map, + * added struct http_response, + * changed struct interceptors to struct cgi_dispatcher, + * moved HTML stuff to cgi.h + * + * Revision 1.13 2001/06/01 20:05:36 jongfoster + * Support for +image-blocker{}: added ACTION_IMAGE_BLOCKER + * constant, and removed csp->tinygif. + * + * Revision 1.12 2001/06/01 18:49:17 jongfoster + * Replaced "list_share" with "list" - the tiny memory gain was not + * worth the extra complexity. + * + * Revision 1.11 2001/06/01 10:32:47 oes + * Added constants for anchoring selection bitmap + * + * Revision 1.10 2001/05/31 21:33:53 jongfoster + * Changes for new actions file, replacing permissionsfile + * and parts of the config file. Also added support for + * list_shared. + * + * Revision 1.9 2001/05/31 17:32:31 oes + * + * - Enhanced domain part globbing with infix and prefix asterisk + * matching and optional unanchored operation + * + * Revision 1.8 2001/05/29 20:09:15 joergs + * HTTP_REDIRECT_TEMPLATE fixed. + * + * Revision 1.7 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/actionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.6 2001/05/27 22:17:04 oes + * + * - re_process_buffer no longer writes the modified buffer + * to the client, which was very ugly. It now returns the + * buffer, which it is then written by chat. + * + * - content_length now adjusts the Content-Length: header + * for modified documents rather than crunch()ing it. + * (Length info in csp->content_length, which is 0 for + * unmodified documents) + * + * - For this to work, sed() is called twice when filtering. + * + * Revision 1.5 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.4 2001/05/22 18:46:04 oes + * + * - Enabled filtering banners by size rather than URL + * by adding patterns that replace all standard banner + * sizes with the "Junkbuster" gif to the re_filterfile + * + * - Enabled filtering WebBugs by providing a pattern + * which kills all 1x1 images + * + * - Added support for PCRE_UNGREEDY behaviour to pcrs, + * which is selected by the (nonstandard and therefore + * capital) letter 'U' in the option string. + * It causes the quantifiers to be ungreedy by default. + * Appending a ? turns back to greedy (!). + * + * - Added a new interceptor ijb-send-banner, which + * sends back the "Junkbuster" gif. Without imagelist or + * MSIE detection support, or if tinygif = 1, or the + * URL isn't recognized as an imageurl, a lame HTML + * explanation is sent instead. + * + * - Added new feature, which permits blocking remote + * script redirects and firing back a local redirect + * to the browser. + * The feature is conditionally compiled, i.e. it + * can be disabled with --disable-fast-redirects, + * plus it must be activated by a "fast-redirects" + * line in the config file, has its own log level + * and of course wants to be displayed by show-proxy-args + * Note: Boy, all the #ifdefs in 1001 locations and + * all the fumbling with configure.in and acconfig.h + * were *way* more work than the feature itself :-( + * + * - Because a generic redirect template was needed for + * this, tinygif = 3 now uses the same. + * + * - Moved GIFs, and other static HTTP response templates + * to project.h + * + * - Some minor fixes + * + * - Removed some >400 CRs again (Jon, you really worked + * a lot! ;-) + * + * Revision 1.3 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "actionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.2 2001/05/17 23:01:01 oes + * - Cleaned CRLF's from the sources and related files + * + * Revision 1.1.1.1 2001/05/15 13:59:03 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
/* Declare struct FILE for vars and funcs. */ #include <stdio.h> @@ -46,20 +710,6 @@ /* Needed for pcre choice */ #include "config.h"
-/* Need for struct sockaddr_storage */ -#ifdef HAVE_RFC2553 -# ifndef _WIN32 -# include <netdb.h> -# include <sys/socket.h> -# else -# include <stdint.h> -# include <winsock2.h> -# include <ws2tcpip.h> - typedef unsigned short in_port_t; -# endif -#endif - - /* * Include appropriate regular expression libraries. * Note that pcrs and pcre (native) are needed for cgi @@ -148,7 +798,7 @@ typedef int jb_err; #define JB_ERR_CGI_PARAMS 2 /**< Missing or corrupt CGI parameters */ #define JB_ERR_FILE 3 /**< Error opening, reading or writing a file */ #define JB_ERR_PARSE 4 /**< Error parsing file */ -#define JB_ERR_MODIFIED 5 /**< File has been modified outside of the +#define JB_ERR_MODIFIED 5 /**< File has been modified outside of the CGI actions editor. */ #define JB_ERR_COMPRESS 6 /**< Error on decompression */
@@ -173,7 +823,7 @@ typedef int jb_err; */ #define ijb_toupper(__X) toupper((int)(unsigned char)(__X)) #define ijb_tolower(__X) tolower((int)(unsigned char)(__X)) -#define ijb_isspace(__X) isspace((int)(unsigned char)(__X)) +#define ijb_isspace(__X) isspace((int)(unsigned char)(__X))
/** * Use for statically allocated buffers if you have no other choice. @@ -191,7 +841,7 @@ typedef int jb_err; * Buffer size for capturing struct hostent data in the * gethostby(name|addr)_r library calls. Since we don't * loop over gethostbyname_r, the buffer must be sufficient - * to accommodate multiple IN A RRs, as used in DNS round robin + * to accomodate multiple IN A RRs, as used in DNS round robin * load balancing. W3C's wwwlib uses 1K, so that should be * good enough for us, too. */ @@ -211,10 +861,16 @@ typedef int jb_err; #define FOREVER 1
/** - * Default TCP/IP address to listen on, as a string. - * Set to "127.0.0.1:8118". + * Default IP address to listen on, as a string. + * Set to "127.0.0.1". */ -#define HADDR_DEFAULT "127.0.0.1:8118" +#define HADDR_DEFAULT "127.0.0.1" + +/** + * Default port to listen on, as a number. + * Set to 8118. + */ +#define HADDR_PORT 8118
/* Forward def for struct client_state */ @@ -233,7 +889,7 @@ struct list_entry * your own code. */ char *str; - + /** Next entry in the linked list, or NULL if no more. */ struct list_entry *next; }; @@ -304,11 +960,9 @@ struct http_request char *host_ip_addr_str; /**< String with dotted decimal representation of host's IP. NULL before connect_to() */
-#ifndef FEATURE_EXTENDED_HOST_PATTERNS char *dbuffer; /**< Buffer with '\0'-delimited domain name. */ char **dvec; /**< List of pointers to the strings in dbuffer. */ int dcount; /**< How many parts to this domain? (length of dvec) */ -#endif /* ndef FEATURE_EXTENDED_HOST_PATTERNS */ };
/** @@ -316,36 +970,31 @@ struct http_request * the requested resource. Mostly ordered the way they are checked * for in chat(). */ -enum crunch_reason -{ - UNSUPPORTED, - BLOCKED, - UNTRUSTED, - REDIRECTED, - CGI_CALL, - NO_SUCH_DOMAIN, - FORWARDING_FAILED, - CONNECT_FAILED, - OUT_OF_MEMORY, - INTERNAL_ERROR, - CONNECTION_TIMEOUT, - NO_SERVER_DATA -}; +#define RSP_REASON_UNSUPPORTED 1 +#define RSP_REASON_BLOCKED 2 +#define RSP_REASON_UNTRUSTED 3 +#define RSP_REASON_REDIRECTED 4 +#define RSP_REASON_CGI_CALL 5 +#define RSP_REASON_NO_SUCH_DOMAIN 6 +#define RSP_REASON_FORWARDING_FAILED 7 +#define RSP_REASON_CONNECT_FAILED 8 +#define RSP_REASON_OUT_OF_MEMORY 9 +#define RSP_REASON_INTERNAL_ERROR 10
/** * Response generated by CGI, blocker, or error handler */ struct http_response { - enum crunch_reason crunch_reason; /**< Why the response was generated in the first place. */ - char *status; /**< HTTP status (string). */ - struct list headers[1]; /**< List of header lines. */ - char *head; /**< Formatted http response head. */ - size_t head_length; /**< Length of http response head. */ - char *body; /**< HTTP document body. */ - size_t content_length; /**< Length of body, REQUIRED if binary body. */ - int is_static; /**< Nonzero if the content will never change and - should be cached by the browser (e.g. images). */ + char *status; /**< HTTP status (string). */ + struct list headers[1]; /**< List of header lines. */ + char *head; /**< Formatted http response head. */ + size_t head_length; /**< Length of http response head. */ + char *body; /**< HTTP document body. */ + size_t content_length; /**< Length of body, REQUIRED if binary body. */ + int is_static; /**< Nonzero if the content will never change and + should be cached by the browser (e.g. images). */ + int reason; /**< Why the response was generated in the first place. */ };
/** @@ -503,7 +1152,7 @@ struct iob #define ACTION_FORCE_TEXT_MODE 0x00400000UL /** Action bitmap: Enable text mode by force */ #define ACTION_CRUNCH_IF_NONE_MATCH 0x00800000UL -/** Action bitmap: Enable content-disposition crunching */ +/** Action bitmap: Enable content-dispostion crunching */ #define ACTION_HIDE_CONTENT_DISPOSITION 0x01000000UL /** Action bitmap: Replace or block Last-Modified header */ #define ACTION_OVERWRITE_LAST_MODIFIED 0x02000000UL @@ -531,7 +1180,7 @@ struct iob #define ACTION_STRING_LANGUAGE 8 /** Action string index: Replacement for the "Content-Type:" header*/ #define ACTION_STRING_CONTENT_TYPE 9 -/** Action string index: Replacement for the "content-disposition:" header*/ +/** Action string index: Replacement for the "content-dispostion:" header*/ #define ACTION_STRING_CONTENT_DISPOSITION 10 /** Action string index: Replacement for the "If-Modified-Since:" header*/ #define ACTION_STRING_IF_MODIFIED_SINCE 11 @@ -643,39 +1292,9 @@ struct url_actions
/* - * Structure to hold the server socket and the information - * required to make sure we only reuse the connection if - * the host and forwarding settings are the same. - */ -struct reusable_connection -{ - jb_socket sfd; - int in_use; - time_t timestamp; /* XXX: rename? */ - - time_t request_sent; - time_t response_received; - - /* - * Number of seconds after which this - * connection will no longer be reused. - */ - unsigned int keep_alive_timeout; - - char *host; - int port; - int forwarder_type; - char *gateway_host; - int gateway_port; - char *forward_host; - int forward_port; -}; - - -/* * Flags for use in csp->flags */ - + /** * Flag for csp->flags: Set if this client is processing data. * Cleared when the thread associated with this structure dies. @@ -710,21 +1329,16 @@ struct reusable_connection #define CSP_FLAG_TOGGLED_ON 0x20U
/** - * Flag for csp->flags: Set if we answered the request ourselve. - */ -#define CSP_FLAG_CRUNCHED 0x40U - -/** * Flag for csp->flags: Set if an acceptable Connection header - * has already been set by the client. + * is already set. */ #define CSP_FLAG_CLIENT_CONNECTION_HEADER_SET 0x00000040U
/** - * Flag for csp->flags: Set if an acceptable Connection header - * has already been set by the server. + * Flag for csp->flags: Set if adding the 'Connection: close' header + * for the server isn't necessary. */ -#define CSP_FLAG_SERVER_CONNECTION_HEADER_SET 0x00000080U +#define CSP_FLAG_SERVER_CONNECTION_CLOSE_SET 0x00000080U
/** * Flag for csp->flags: Signals header parsers whether they @@ -762,65 +1376,9 @@ struct reusable_connection * Flag for csp->flags: Set if the server specified the * content length. */ -#define CSP_FLAG_SERVER_CONTENT_LENGTH_SET 0x00002000U - -/** - * Flag for csp->flags: Set if we know the content length, - * either because the server set it, or we figured it out - * on our own. - */ -#define CSP_FLAG_CONTENT_LENGTH_SET 0x00004000U - -/** - * Flag for csp->flags: Set if the client wants to keep - * the connection alive. - */ -#define CSP_FLAG_CLIENT_CONNECTION_KEEP_ALIVE 0x00008000U - -/** - * Flag for csp->flags: Set if we think we got the whole - * client request and shouldn't read any additional data - * coming from the client until the current request has - * been dealt with. - */ -#define CSP_FLAG_CLIENT_REQUEST_COMPLETELY_READ 0x00010000U - -/** - * Flag for csp->flags: Set if the server promised us to - * keep the connection open for a known number of seconds. - */ -#define CSP_FLAG_SERVER_KEEP_ALIVE_TIMEOUT_SET 0x00020000U - +#define CSP_FLAG_CONTENT_LENGTH_SET 0x00002000U #endif /* def FEATURE_CONNECTION_KEEP_ALIVE */
-/** - * Flag for csp->flags: Set if we think we can't reuse - * the server socket. - */ -#define CSP_FLAG_SERVER_SOCKET_TAINTED 0x00040000U - -/** - * Flag for csp->flags: Set if the Proxy-Connection header - * is among the server headers. - */ -#define CSP_FLAG_SERVER_PROXY_CONNECTION_HEADER_SET 0x00080000U - -/** - * Flag for csp->flags: Set if the client reused its connection. - */ -#define CSP_FLAG_REUSED_CLIENT_CONNECTION 0x00100000U - -/** - * Flag for csp->flags: Set if the supports deflate compression. - */ -#define CSP_FLAG_CLIENT_SUPPORTS_DEFLATE 0x00200000U - -/** - * Flag for csp->flags: Set if the content has been deflated by Privoxy - */ -#define CSP_FLAG_BUFFERED_CONTENT_DEFLATED 0x00400000U - - /* * Flags for use in return codes of child processes */ @@ -844,12 +1402,6 @@ struct reusable_connection #define MAX_AF_FILES 10
/** - * Maximum number of sockets to listen to. This limit is arbitrary - it's just used - * to size an array. - */ -#define MAX_LISTENING_SOCKETS 10 - -/** * The state of a Privoxy processing thread. */ struct client_state @@ -863,8 +1415,8 @@ struct client_state /** socket to talk to client (web browser) */ jb_socket cfd;
- /** current connection to the server (may go through a proxy) */ - struct reusable_connection server_connection; + /** socket to talk to server (web server or proxy) */ + jb_socket sfd;
/** Multi-purpose flag container, see CSP_FLAG_* above */ unsigned int flags; @@ -872,15 +1424,9 @@ struct client_state /** Client PC's IP address, as reported by the accept() function. As a string. */ char *ip_addr_str; -#ifdef HAVE_RFC2553 - /** Client PC's TCP address, as reported by the accept() function. - As a sockaddr. */ - struct sockaddr_storage tcp_addr; -#else /** Client PC's IP address, as reported by the accept() function. As a number. */ unsigned long ip_addr_long; -#endif /* def HAVE_RFC2553 */
/** The URL that was requested */ struct http_request http[1]; @@ -914,17 +1460,11 @@ struct client_state unsigned long long content_length;
#ifdef FEATURE_CONNECTION_KEEP_ALIVE - /* XXX: is this the right location? */ - /** Expected length of content after which we * should stop reading from the server socket. */ + /* XXX: is this the right location? */ unsigned long long expected_content_length; - - /** Expected length of content after which we - * should stop reading from the client socket. - */ - unsigned long long expected_client_content_length; #endif /* def FEATURE_CONNECTION_KEEP_ALIVE */
#ifdef FEATURE_TRUST @@ -939,18 +1479,12 @@ struct client_state * or NULL. Currently only used for socks errors. */ char *error_message; -};
-/** - * List of client states so the main thread can keep - * track of them and garbage collect their resources. - */ -struct client_states -{ - struct client_states *next; - struct client_state csp; + /** Next thread in linked list. Only read or modify from the main thread! */ + struct client_state *next; };
+ /** * A function to add a header */ @@ -1012,7 +1546,7 @@ struct file_list * Read-only once the structure has been created. */ time_t lastmodified; - + /** * The full filename. */ @@ -1048,16 +1582,12 @@ struct block_spec
#endif /* def FEATURE_TRUST */
-enum forwarder_type { - /**< Don't use a SOCKS server */ - SOCKS_NONE = 0, - /**< original SOCKS 4 protocol */ - SOCKS_4 = 40, - /**< SOCKS 4A, DNS resolution is done by the SOCKS server */ - SOCKS_4A = 41, - /**< SOCKS 5 with hostnames, DNS resolution is done by the SOCKS server */ - SOCKS_5 = 50, -}; + +#define SOCKS_NONE 0 /**< Don't use a SOCKS server */ +#define SOCKS_4 40 /**< original SOCKS 4 protocol */ +#define SOCKS_4A 41 /**< as modified for hosts w/o external DNS */ +#define SOCKS_5 50 /**< as modified for hosts w/o external DNS */ +
/** * How to forward a connection to a parent proxy. @@ -1068,7 +1598,7 @@ struct forward_spec struct url_spec url[1];
/** Connection type. Must be SOCKS_NONE, SOCKS_4, SOCKS_4A or SOCKS_5. */ - enum forwarder_type type; + int type;
/** SOCKS server hostname. Only valid if "type" is SOCKS_4 or SOCKS_4A. */ char *gateway_host; @@ -1093,14 +1623,12 @@ struct forward_spec #define FORWARD_SPEC_INITIALIZER { { URL_SPEC_INITIALIZER }, 0, NULL, 0, NULL, 0, NULL }
/* Supported filter types */ -enum filter_type -{ - FT_CONTENT_FILTER = 0, - FT_CLIENT_HEADER_FILTER = 1, - FT_SERVER_HEADER_FILTER = 2, - FT_CLIENT_HEADER_TAGGER = 3, - FT_SERVER_HEADER_TAGGER = 4, -}; +#define FT_CONTENT_FILTER 0 +#define FT_CLIENT_HEADER_FILTER 1 +#define FT_SERVER_HEADER_FILTER 2 +#define FT_CLIENT_HEADER_TAGGER 3 +#define FT_SERVER_HEADER_TAGGER 4 + #define MAX_FILTER_TYPES 5
/** @@ -1115,7 +1643,7 @@ struct re_filterfile_spec char *description; /**< Description from FILTER: statement in re_filterfile. */ struct list patterns[1]; /**< The patterns from the re_filterfile. */ pcrs_job *joblist; /**< The resulting compiled pcrs_jobs. */ - enum filter_type type; /**< Filter type (content, client-header, server-header). */ + int type; /**< Filter type (content, client-header, server-header). */ int dynamic; /**< Set to one if the pattern might contain variables and has to be recompiled for every request. */ struct re_filterfile_spec *next; /**< The pointer for chaining. */ @@ -1132,14 +1660,9 @@ struct re_filterfile_spec */ struct access_control_addr { -#ifdef HAVE_RFC2553 - struct sockaddr_storage addr; /* <The TCP address in network order. */ - struct sockaddr_storage mask; /* <The TCP mask in network order. */ -#else unsigned long addr; /**< The IP address as an integer. */ unsigned long mask; /**< The network mask as an integer. */ unsigned long port; /**< The port number. */ -#endif /* HAVE_RFC2553 */ };
/** @@ -1151,9 +1674,6 @@ struct access_control_list { struct access_control_addr src[1]; /**< Client IP address */ struct access_control_addr dst[1]; /**< Website or parent proxy IP address */ -#ifdef HAVE_RFC2553 - int wildcard_dst; /** < dst address is wildcard */ -#endif
short action; /**< ACL_PERMIT or ACL_DENY */ struct access_control_list *next; /**< The next entry in the ACL. */ @@ -1190,15 +1710,6 @@ struct access_control_list /** configuration_spec::feature_flags: Try to keep the connection to the server alive. */ #define RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE 128U
-/** configuration_spec::feature_flags: Share outgoing connections between different client connections. */ -#define RUNTIME_FEATURE_CONNECTION_SHARING 256U - -/** configuration_spec::feature_flags: Pages blocked with +handle-as-empty-doc get a return status of 200 OK. */ -#define RUNTIME_FEATURE_EMPTY_DOC_RETURNS_OK 512U - -/** configuration_spec::feature_flags: Buffered content is sent compressed if the client supports it. */ -#define RUNTIME_FEATURE_COMPRESSION 1024U - /** * Data loaded from the configuration file. * @@ -1208,7 +1719,7 @@ struct configuration_spec { /** What to log */ int debug; - + /** Nonzero to enable multithreading. */ int multi_threaded;
@@ -1220,12 +1731,6 @@ struct configuration_spec * - RUNTIME_FEATURE_CGI_TOGGLE * - RUNTIME_FEATURE_HTTP_TOGGLE * - RUNTIME_FEATURE_SPLIT_LARGE_FORMS - * - RUNTIME_FEATURE_ACCEPT_INTERCEPTED_REQUESTS - * - RUNTIME_FEATURE_ENFORCE_BLOCKS - * - RUNTIME_FEATURE_CGI_CRUNCHING - * - RUNTIME_FEATURE_CONNECTION_KEEP_ALIVE - * - RUNTIME_FEATURE_CONNECTION_SHARING - * - RUNTIME_FEATURE_EMPTY_DOC_RETURNS_OK */ unsigned feature_flags;
@@ -1265,11 +1770,11 @@ struct configuration_spec /** The hostname to show on CGI pages, or NULL to use the real one. */ const char *hostname;
- /** IP addresses to bind to. Defaults to HADDR_DEFAULT == 127.0.0.1. */ - const char *haddr[MAX_LISTENING_SOCKETS]; + /** IP address to bind to. Defaults to HADDR_DEFAULT == 127.0.0.1. */ + const char *haddr;
- /** Ports to bind to. Defaults to HADDR_PORT == 8118. */ - int hport[MAX_LISTENING_SOCKETS]; + /** Port to bind to. Defaults to HADDR_PORT == 8118. */ + int hport;
/** Size limit for IOB */ size_t buffer_limit; @@ -1298,26 +1803,11 @@ struct configuration_spec struct forward_spec *forward;
/** Number of retries in case a forwarded connection attempt fails */ - int forwarded_connect_retries; - - /** Maximum number of client connections. */ - int max_client_connections; + int forwarded_connect_retries;
/* Timeout when waiting on sockets for data to become available. */ int socket_timeout;
-#ifdef FEATURE_CONNECTION_KEEP_ALIVE - /* Maximum number of seconds after which an open connection will no longer be reused. */ - unsigned int keep_alive_timeout; - - /* Assumed server-side keep alive timeout if none is specified. */ - unsigned int default_server_timeout; -#endif - -#ifdef FEATURE_COMPRESSION - int compression_level; -#endif - /** All options from the config file, HTML-formatted. */ char *proxy_args;
@@ -1347,7 +1837,7 @@ struct configuration_spec #endif /* def FEATURE_NO_GIFS */
-/* +/* * Hardwired URLs */
diff --git a/external/privoxy/regression-tests.action b/external/privoxy/regression-tests.action index 649432b..bf12a31 100644 --- a/external/privoxy/regression-tests.action +++ b/external/privoxy/regression-tests.action @@ -1,5 +1,5 @@ ############################################################################# -# $Id: regression-tests.action,v 1.42 2011/11/06 11:46:58 fabiankeil Exp $ +# $Id: regression-tests.action,v 1.22 2009/02/22 15:07:58 fabiankeil Exp $ ############################################################################# # # This is a configuration file for Privoxy-Regression-Test @@ -10,7 +10,7 @@ # ############################################################################# # -# Copyright (c) 2007-2011 Fabian Keil fk@fabiankeil.de +# Copyright (c) 2007-2009 Fabian Keil fk@fabiankeil.de # # Permission to use, copy, modify, and distribute this software for any # purpose with or without fee is hereby granted, provided that the above @@ -26,26 +26,15 @@ # #############################################################################
-# While the syntax used is understood by Privoxy 3.0.14 and later, -# some of the +fast-redirects{} tests require at least 3.0.18 to work. {{settings}} -for-privoxy-version=3.0.18 +for-privoxy-version=3.0.11
# Some dependencies Privoxy-Regression-Test should know about: # # Level 9 needs = config line user-manual\s+(.?.?/|[A-Za-z]:) # Level 12 needs = config line enable-edit-actions\s+1 # Level 13 needs = feature status FEATURE_CONNECTION_KEEP_ALIVE Yes -# Level 13 needs = config line keep-alive-timeout\s+[1-9]+ # Level 14 needs = feature status FEATURE_CONNECTION_KEEP_ALIVE No -# Level 15 needs = config line connection-sharing\s+0 -# Level 16 needs = feature status FEATURE_CONNECTION_KEEP_ALIVE Yes -# Level 16 needs = config line connection-sharing\s+1 -# Level 17 needs = feature status FEATURE_PTHREAD Yes -# Level 18 needs = feature status FEATURE_GRACEFUL_TERMINATION No -# Level 19 needs = feature status FEATURE_GRACEFUL_TERMINATION Yes -# Level 20 needs = feature status FEATURE_TOGGLE Yes -# Level 21 needs = feature status FEATURE_TOGGLE No
####################################################### # Enable taggers to activate the tests on demand @@ -85,11 +74,11 @@ TAG:^hide-accept-language{block}$ # 2) conditional-forge # 3) forge # 4) block -# 5) a parameter that looks like a valid fake referrer +# 5) a parameter that looks like a valid fake referrer # 6) a parameter that looks like an invalid fake referrer #######################################################
-# Set Header = Referer: http://www.example.org/foo +# Set Header = Referer: http://www.example.org/foo # Expect Header = REMOVAL # # Set Header = Referer: http://p.p/foo @@ -109,7 +98,7 @@ TAG:^hide-accept-language{block}$ {+hide-referrer{conditional-block}} TAG:^hide-referrer{conditional-block}$
-# Set Header = Referer: http://www.example.org/foo +# Set Header = Referer: http://www.example.org/foo # Expect Header = Referer: http://p.p/ # # Set Header = Referer: http://p.p/foo @@ -129,17 +118,17 @@ TAG:^hide-referrer{conditional-block}$ {+hide-referrer{conditional-forge}} TAG:^hide-referrer{conditional-forge}$
-# Set Header = Referer: http://www.example.org/foo +# Set Header = Referer: http://www.example.org/foo # Expect Header = Referer: http://p.p/ {+hide-referrer{forge}} TAG:^hide-referrer{forge}$
-# Set Header = Referer: http://www.example.org/foo +# Set Header = Referer: http://www.example.org/foo # Expect Header = REMOVAL {+hide-referrer{block}} TAG:^hide-referrer{block}$
-# Set Header = Referer: http://www.example.org/foo +# Set Header = Referer: http://www.example.org/foo # Expect Header = Referer: invalid {+hide-referrer{invalid}} TAG:^hide-referrer{invalid}$ @@ -261,16 +250,6 @@ TAG:^hide-if-modified-since{block}$ # Expect Header = REMOVAL # Set Header = If-Modified-Since: Thu, 04 Oct 2007 09:56:35 GMT # Expect Header = SOME CHANGE -# Set Header = If-Modified-Since: Thu, 1 Jan 1970 00:00:00 GMT -# Expect Header = SOME CHANGE -# Level = 17 -# Set Header = If-Modified-Since: Thu, 1 Jan 123456789 00:00:00 GMT -# Expect Header = REMOVAL -# Set Header = If-Modified-Since: Mon, 1 Jan 2525 00:00:00 GMT -# Expect Header = SOME CHANGE -# Level = 17 -# Set Header = If-Modified-Since: Thu, 1 Jan 1970 02:00:00 GMT -# Expect Header = SOME CHANGE
{+hide-if-modified-since{-60} -crunch-if-none-match} TAG:^hide-if-modified-since{-60}$ @@ -279,8 +258,6 @@ TAG:^hide-if-modified-since{-60}$ # Expect Header = REMOVAL # Set Header = If-Modified-Since: Thu, 04 Oct 2007 09:56:35 GMT # Expect Header = SOME CHANGE -# Set Header = If-Modified-Since: Wed, 31 Dec 1969 23:59:59 GMT -# Expect Header = SOME CHANGE
{+hide-if-modified-since{+60} -crunch-if-none-match} TAG:^hide-if-modified-since{+60}$ @@ -435,7 +412,6 @@ TAG:^prevent-compression$ # Set Header = Request-Range: bytes=1234-5678 # Expect Header = REMOVAL {\ - -client-header-tagger{range-requests} \ +deanimate-gifs{last} \ -filter \ } @@ -448,7 +424,6 @@ TAG:^deanimate-gifs{last}$ # Set Header = Request-Range: bytes=1234-5678 # Expect Header = REMOVAL {\ - -client-header-tagger{range-requests} \ -deanimate-gifs \ +filter{banners-by-size} \ } @@ -461,17 +436,19 @@ TAG:^filter{banners-by-size}$ # Set Header = Request-Range: bytes=1234-5678 # Expect Header = NO CHANGE {\ - -client-header-tagger{range-requests} \ -deanimate-gifs \ -filter \ } TAG:^no-content-filter$
+# Set Header = Connection: close +# Expect Header = Connection: keep-alive +# Level = 13 # Set Header = Connection: keep-alive # Expect Header = NO CHANGE # Level = 13 # Set Header = Connection: -# Expect Header = REMOVAL +# Expect Header = Connection: keep-alive # Level = 13 {} TAG:^Connection: keep-alive$ @@ -485,21 +462,6 @@ TAG:^Connection: keep-alive$ {} TAG:^Connection: close$
-# Set Header = Connection: close -# Expect Header = NO CHANGE -# Level = 15 -{} -TAG:^connection-sharing disabled$ - -# Set Header = Connection: close -# Expect Header = REMOVAL -# Level = 16 -# Set Header = Connection: keep-alive -# Expect Header = NO CHANGE -# Level = 16 -{} -TAG:^connection-sharing enabled$ - # XXX: Removing a header by not specifying a value is # an inherited curl feature and could be viewed as a # bug as far as Privoxy-Regression-Test is concerned. @@ -514,15 +476,9 @@ TAG:^No Host header$ {} TAG:^Host header other than the target host$
-# Set Header = Keep-Alive: 20 -# Expect Header = NO CHANGE -# Level = 13 -{} -TAG:^Pass Keep-Alive header$ - -# Set Header = Keep-Alive: 20 +# XXX: check the RFC to use a real value +# Set Header = Keep-Alive: Yes # Expect Header = REMOVAL -# Level = 14 {} TAG:^Keep-Alive header removal$
@@ -565,12 +521,9 @@ TAG:^Max-Forwards header without TRACE method$ ################################################################
# Fetch Test = http://p.p/ +# Will fail if compiled with FEATURE_GRACEFUL_TERMINATION # Fetch Test = http://p.p/die # Expect Status Code = 404 -# Level = 18 -# Fetch Test = http://p.p/die -# Expect Status Code = 200 -# Level = 19 # Fetch Test = http://p.p/show-status # Fetch Test = http://config.privoxy.org/show-status?file=actions&index=0 # Fetch Test = http://config.privoxy.org/show-status?file=filter&index=0 @@ -595,12 +548,7 @@ TAG:^Max-Forwards header without TRACE method$ # Fetch Test = http://p.p/show-url-info?url=FTp:%2F%2Fwww.privoxy.org%2F # Fetch Test = http://p.p/show-url-info?url= # Fetch Test = http://p.p/show-url-info?url=%2F -# Depends on FEATURE_TOGGLE # Fetch Test = http://p.p/toggle -# Level = 20 -# Fetch Test = http://p.p/toggle -# Expect Status Code = 404 -# Level = 21 # Fetch Test = http://p.p/edit-actions # Fetch Test = http://p.p/eaa # Fetch Test = http://p.p/eau @@ -702,6 +650,8 @@ TAG:^Max-Forwards header without TRACE method$ # Level = 9 # Fetch Test = http://p.p/user-manual/templates.html # Level = 9 +# Fetch Test = http://p.p/user-manual/upgradersnote.html +# Level = 9 # Fetch Test = http://p.p/user-manual/whatsnew.html # Level = 9
@@ -760,20 +710,10 @@ p.p:3,22,79-81/ {+forward-override{forward-socks5 127.0.0.1:12345 .}} oh-dear-this-hostname-is-so-very-long-that-it-can-not-possibly-be-forwarded-through-socks5-as-a-result-we-therefore-expect-privoxy-to-return-an-error-response-instead-of-forwarding-the-request-because-as-already-mentioned-this-host-is-really-very-long.example/
-# Fetch Test = http://oh-dear-this-hostname-is-short-enough-but-there-is-no-socks5-server-l... +# Fetch Test = http://oh-dear-this-hostname-is-short-enough-but-there-is-no-socks-server-li... # Expect Status Code = 503 {+forward-override{forward-socks5 127.0.0.1:12345 .}} -oh-dear-this-hostname-is-short-enough-but-there-is-no-socks5-server-listening.example - -# Fetch Test = http://oh-dear-this-hostname-is-short-enough-but-there-is-no-socks4-server-l... -# Expect Status Code = 503 -{+forward-override{forward-socks4 127.0.0.1:12345 .}} -oh-dear-this-hostname-is-short-enough-but-there-is-no-socks4-server-listening.example - -# Fetch Test = http://oh-dear-this-hostname-is-short-enough-but-there-is-no-socks4a-server-... -# Expect Status Code = 503 -{+forward-override{forward-socks4a 127.0.0.1:12345 .}} -oh-dear-this-hostname-is-short-enough-but-there-is-no-socks4a-server-listening.example +oh-dear-this-hostname-is-short-enough-but-there-is-no-socks-server-listening.example
# This one currently triggers the same error condition as the # test above (socks5 server unreachable), but once Privoxy @@ -812,11 +752,6 @@ www.blocked-request.example/blocked-request-with-no-reason-specified # Blocked URL = http://domain-pattern-test.example.org/ domain-pattern-test.example.
-{+block{Hostname patterns without trailing dots cover hostnames with trailing dots as well.}} -# Blocked URL = http://trailing-dot.example.org./ -# Blocked URL = http://trailing-dot.example.org./foo -trailing-dot.example.org - # Just in case there is no white-space fuzzer in the house ... # # Set Header = X-LWS-Test: no superfluous white space here @@ -845,47 +780,3 @@ trailing-dot.example.org # Expect Header = X-LWS-Test: "This is quoted" this is not "this is " but " this again is not {} TAG:^LWS Tests$ - -{+fast-redirects{check-decoded-url}} -# Redirected URL = http://redirect.example.net/blafasel&url=http://redirected1.example.net/ -# Redirect Destination = http://redirected1.example.net/ -# Redirected URL = http://redirect.example.net/blafasel&url=http%3A%2F%2Fredirected2.exampl... -# Redirect Destination = http://redirected2.example.net/ -# Redirected URL = http://redirect.example.net/blafasel&url=http%3A%2F%2Fredirected3.exampl... -# Redirect Destination = http://redirected3.example.net/ -# Redirected URL = http://redirect.example.net/blafasel&url=http%3A%2F%2Fredirected4.exampl... -# Redirect Destination = http://redirected4.example.net/%C2%B6meter=part-of-the-redirected-url -# Redirected URL = http://redirect.example.net/blafasel&url1=http%3A%2F%2Fredirected5.examp... -# Redirect Destination = http://redirected5.example.net/%C2%B6meter2=part-of-the-redirected-url2 -# Redirected URL = http://redirect.example.net/blafasel&url1=http%3A%2F%2Fredirected6.examp... -# Redirect Destination = http://redirected6.example.net/%C2%B6meter2=part-of-the-redirected-url2 -# Redirected URL = http://redirect.example.net/blafasel?x=http%3A%2F%2Fredirected7.example.net%... -# Redirect Destination = http://redirected7.example.net/%C2%B6meter1=part-of-the-redirected-url1 -# Redirected URL = http://redirect.example.net/blafasel?x=http%3A%2F%2Fredirected8.example.net%... -# Redirect Destination = http://redirected8.example.net/%C2%B6meter1=part-of-the-redirected-url1 -# Redirected URL = http://redirect.example.net/blafasel?a?b?c?d?e?f?g?h?i?j?k?l?m?n?o?p?q?r?s&a... -# Redirect Destination = http://redirected8.example.net/%C2%B6meter1=part-of-the-redirected-url1 -# Redirected URL = http://redirect.example.net/blafasel???????????????????????????????=http%3A%... -# Redirect Destination = http://redirected8.example.net/%C2%B6meter1=part-of-the-redirected-url1 -# Redirected URL = http://redirect.example.net/blafasel&&&&&&&&... -# Redirect Destination = http://redirected8.example.net/%C2%B6meter1=part-of-the-redirected-url1 -redirect.example.net/ -# Redirected URL = http://redirect.example.net/blafaselhttp://redirect1.example.net/http://redi... -# Redirect Destination = http://redirect2.example.net/ -# Redirected URL = http://redirect.example.net/blafasel%3A%2F%2Fredirect1.example.net/http://re... -# Redirect Destination = http://redirect2.example.net/ -# Redirected URL = http://redirect.example.net/blafaselhttp://redirect1.example.net/http%3A%2F%... -# Redirect Destination = http://redirect2.example.net/ -# These tests verify that Privoxy behaves as intended, -# given that the encoded redirect URLs are invalid, -# there are no correct redirect URLs. -# Redirected URL = http://redirect.example.net/%%%%%%%%%%%%%%%%%%%%%%blafaselhttp://redirect1.e... -# Redirect Destination = http://redirect2.example.net/%%%%%%%%%%%%%% -# Redirected URL = http://redirect.example.net/%%%%%%%%%%%%%%%%%%%%%%blafaselhttp://redirect1.e... -# Redirect Destination = http://redirect2.example.net/%1%2%%3%4%5%6%7%8%9%0%0%% - -{+fast-redirects{simple-check}} -# Redirected URL = http://redirect2.example.net/blafasel?x=http://redirected.example.net/%C2%B6... -# Redirect Destination = http://redirected.example.net/%C2%B6meter1=part-of-the-redirected-url1%C2%B6... -redirect2.example.net/ - diff --git a/external/privoxy/ssplit.c b/external/privoxy/ssplit.c index ad5caf4..d916286 100644 --- a/external/privoxy/ssplit.c +++ b/external/privoxy/ssplit.c @@ -1,4 +1,4 @@ -const char ssplit_rcs[] = "$Id: ssplit.c,v 1.12 2011/09/04 11:10:56 fabiankeil Exp $"; +const char ssplit_rcs[] = "$Id: ssplit.c,v 1.9 2007/11/03 14:35:45 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/ssplit.c,v $ @@ -9,10 +9,10 @@ const char ssplit_rcs[] = "$Id: ssplit.c,v 1.12 2011/09/04 11:10:56 fabiankeil E * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -30,8 +30,39 @@ const char ssplit_rcs[] = "$Id: ssplit.c,v 1.12 2011/09/04 11:10:56 fabiankeil E * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: ssplit.c,v $ + * Revision 1.9 2007/11/03 14:35:45 fabiankeil + * Fix spelling in Purpose line. Patch submitted by Simon Ruderich. + * + * Revision 1.8 2006/07/18 14:48:47 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.6 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.5 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.4 2001/11/13 00:16:38 jongfoster + * Replacing references to malloc.h with the standard stdlib.h + * (See ANSI or K&R 2nd Ed) + * + * Revision 1.3 2001/05/29 08:54:25 jongfoster + * Rewrote the innards of ssplit() to be easier to understand, + * faster, and to use less memory. Didn't change the interface + * except to give the parameters meaningful names. + * + * Revision 1.2 2001/05/17 23:01:01 oes + * - Cleaned CRLF's from the sources and related files + * + * Revision 1.1.1.1 2001/05/15 13:59:04 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -63,18 +94,18 @@ const char ssplit_h_rcs[] = SSPLIT_H_VERSION; * 3 : vec[] = results vector (aka. array) [out] * 4 : vec_len = number of usable slots in the vector (aka. array size) * 5 : dont_save_empty_fields = zero if consecutive delimiters - * give a null output field(s), nonzero if they are just + * give a null output field(s), nonzero if they are just * to be considered as single delimeter * 6 : ignore_leading = nonzero to ignore leading field * separators. * - * Returns : -1 => Error: vec_len is too small to hold all the + * Returns : -1 => Error: vec_len is too small to hold all the * data, or str == NULL. * >=0 => the number of fields put in `vec'. * On error, vec and str may still have been overwritten. * *********************************************************************/ -int ssplit(char *str, const char *delim, char *vec[], size_t vec_len, +int ssplit(char *str, const char *delim, char *vec[], int vec_len, int dont_save_empty_fields, int ignore_leading) { unsigned char is_delim[256]; @@ -122,7 +153,7 @@ int ssplit(char *str, const char *delim, char *vec[], size_t vec_len, || (is_delim[(unsigned)(unsigned char)*str] == 0) ) { /* - * We want empty fields, or the first character in this + * We want empty fields, or the first character in this * field is not a delimiter or the end of string. * So save it. */ @@ -130,24 +161,24 @@ int ssplit(char *str, const char *delim, char *vec[], size_t vec_len, { return(-1); /* overflow */ } - vec[vec_count++] = (char *) str; + vec[vec_count++] = (char *) str; }
while ((char_type = is_delim[(unsigned)(unsigned char)*str]) != 2) { - if (char_type == 1) + if (char_type == 1) { /* the char is a separator */
/* null terminate the substring */ - *str++ = '\0'; + *str++ = '\0';
/* Check if we want to save this field */ if ( (!dont_save_empty_fields) || (is_delim[(unsigned)(unsigned char)*str] == 0) ) { /* - * We want empty fields, or the first character in this + * We want empty fields, or the first character in this * field is not a delimiter or the end of string. * So save it. */ @@ -155,7 +186,7 @@ int ssplit(char *str, const char *delim, char *vec[], size_t vec_len, { return(-1); /* overflow */ } - vec[vec_count++] = (char *) str; + vec[vec_count++] = (char *) str; } } else diff --git a/external/privoxy/ssplit.h b/external/privoxy/ssplit.h index 04bb288..3e9b991 100644 --- a/external/privoxy/ssplit.h +++ b/external/privoxy/ssplit.h @@ -1,6 +1,6 @@ #ifndef SSPLIT_H_INCLUDED #define SSPLIT_H_INCLUDED -#define SSPLIT_H_VERSION "$Id: ssplit.h,v 1.10 2011/09/04 11:10:56 fabiankeil Exp $" +#define SSPLIT_H_VERSION "$Id: ssplit.h,v 1.7 2006/07/18 14:48:47 david__schmidt Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/ssplit.h,v $ @@ -11,10 +11,10 @@ * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -32,14 +32,39 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: ssplit.h,v $ + * Revision 1.7 2006/07/18 14:48:47 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.5 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.4 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.3 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.2 2001/05/29 08:54:25 jongfoster + * Rewrote the innards of ssplit() to be easier to understand, + * faster, and to use less memory. Didn't change the interface + * except to give the parameters meaningful names. + * + * Revision 1.1.1.1 2001/05/15 13:59:04 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { #endif
-extern int ssplit(char *str, const char *delim, char *vec[], size_t vec_len, +extern int ssplit(char *str, const char *delim, char *vec[], int vec_len, int dont_save_empty_fields, int ignore_leading);
/* Revision control strings from this header and associated .c file */ diff --git a/external/privoxy/templates/blocked b/external/privoxy/templates/blocked index 3da06f2..3ebc22e 100644 --- a/external/privoxy/templates/blocked +++ b/external/privoxy/templates/blocked @@ -13,7 +13,7 @@ # # Template files are written in plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -28,7 +28,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -82,7 +82,7 @@ # force-support: # Privoxy has been compiled with support for forced loading # of blocked content. In that case, the symbol "force-prefix" is -# avaiable, which translates to the FORCE_PREFIX +# avaiable, which translates to the FORCE_PREFIX # <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> @@ -107,20 +107,20 @@ minWidth = 650; minHeight = 330;
- /* + /* * Navigator, Mozilla, Opera */ - if (window.innerWidth - && (window.innerWidth >= minWidth) + if (window.innerWidth + && (window.innerWidth >= minWidth) && (window.innerHeight >= minHeight)) { return false; } - - /* + + /* * MSIE */ - else if (document.body && document.body.clientWidth + else if (document.body && document.body.clientWidth && (document.body.clientWidth >= minWidth) && (document.body.clientHeight >= minHeight)) { diff --git a/external/privoxy/templates/cgi-error-404 b/external/privoxy/templates/cgi-error-404 index 4e010c0..c12b564 100644 --- a/external/privoxy/templates/cgi-error-404 +++ b/external/privoxy/templates/cgi-error-404 @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -84,7 +84,7 @@ <tr> <td class="status"> 404 - </td> + </td> <td class="title" style="width: 100%">
#include mod-title @@ -142,7 +142,7 @@ </td> </tr> <!-- if-have-help-info-end@ --> - + </table>
</body> diff --git a/external/privoxy/templates/cgi-error-bad-param b/external/privoxy/templates/cgi-error-bad-param index f8e95a9..a1e3f05 100644 --- a/external/privoxy/templates/cgi-error-bad-param +++ b/external/privoxy/templates/cgi-error-bad-param @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -149,7 +149,7 @@ </td> </tr> <!-- if-have-help-info-end@ --> - + </table>
</body> diff --git a/external/privoxy/templates/cgi-error-disabled b/external/privoxy/templates/cgi-error-disabled index b95de2c..9faffc6 100644 --- a/external/privoxy/templates/cgi-error-disabled +++ b/external/privoxy/templates/cgi-error-disabled @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -162,7 +162,7 @@ </td> </tr> <!-- if-have-help-info-end@ --> - + </table>
</body> diff --git a/external/privoxy/templates/cgi-error-file b/external/privoxy/templates/cgi-error-file index 0d801fe..09bf2cb 100644 --- a/external/privoxy/templates/cgi-error-file +++ b/external/privoxy/templates/cgi-error-file @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # diff --git a/external/privoxy/templates/cgi-error-file-read-only b/external/privoxy/templates/cgi-error-file-read-only index 8137200..bfce277 100644 --- a/external/privoxy/templates/cgi-error-file-read-only +++ b/external/privoxy/templates/cgi-error-file-read-only @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # diff --git a/external/privoxy/templates/cgi-error-modified b/external/privoxy/templates/cgi-error-modified index 4c38626..3b04b4b 100644 --- a/external/privoxy/templates/cgi-error-modified +++ b/external/privoxy/templates/cgi-error-modified @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -109,7 +109,7 @@ <p>Possible causes:</p> <ul> <li>If you got here using your browser's "back" button, then - that is deliberately disabled for this page. Please + that is deliberately disabled for this page. Please navigate around the configuration editor using the links provided.</li> <li>Perhaps you've got more than one browser window open, and @@ -117,7 +117,7 @@ only have one editor window open at a time. Your other edit window should continue to function.</li> <li>You may have modified the file some other way - perhaps by - editing it with a text editor. Simply go back in to the + editing it with a text editor. Simply go back in to the configuration interface using the links below.</li> </ul> <p>You can go back into the edit interface using the menu below, @@ -150,7 +150,7 @@ </td> </tr> <!-- if-have-help-info-end@ --> - + </table>
</body> diff --git a/external/privoxy/templates/cgi-error-parse b/external/privoxy/templates/cgi-error-parse index 7a07bf2..695131c 100644 --- a/external/privoxy/templates/cgi-error-parse +++ b/external/privoxy/templates/cgi-error-parse @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -110,7 +110,7 @@ editor. If you managed to take a valid file and break it this badly using the web-based editor, please file a bug report!</p> <p>When you've fixed the problem, you can go back into the edit - interface using the menu below, or by clicking <a + interface using the menu below, or by clicking <a href="edit-actions-list?f=@f@">here</a>. </p> </td> @@ -169,7 +169,7 @@ </td> </tr> <!-- if-have-help-info-end@ --> - + </table>
</body> diff --git a/external/privoxy/templates/cgi-style.css b/external/privoxy/templates/cgi-style.css index 8673485..b66c580 100644 --- a/external/privoxy/templates/cgi-style.css +++ b/external/privoxy/templates/cgi-style.css @@ -10,7 +10,7 @@ # Original Author: Copyright (C) 2001 Jonathan Foster # http://www.jon-foster.co.uk/ # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -28,12 +28,34 @@ # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # +# Revisions : +# $Log: cgi-style.css,v $ +# Revision 1.12 2007/12/11 21:20:53 fabiankeil +# Make strong warnings red too. +# +# Revision 1.11 2007/12/08 14:29:06 fabiankeil +# Use CSS to let the URL and pattern input fields scale with +# the browser width and try to prevent vertical scroll bars +# if the width is less than 80 characters. Closes #1843596, +# thanks to Gerry Murphy and Lee. +# +# Revision 1.10 2007/01/22 13:12:43 fabiankeil +# White space cosmetics for #include. +# +# Revision 1.9 2006/12/17 17:50:55 fabiankeil +# Add white space workaround for tables +# in show-status CGI page. +# +# Revision 1.8 2002/05/12 15:53:41 jongfoster +# Adding standard comment header with license and CVS log. +# +# ##############################################################################
/* * CSS for Privoxy CGI and script output * - * $Id: cgi-style.css,v 1.14 2011/09/04 11:09:40 fabiankeil Exp $ + * $Id: cgi-style.css,v 1.12 2007/12/11 21:20:53 fabiankeil Exp $ */
/* @@ -146,6 +168,6 @@ em.warning, strong.warning { color: #ff0000 } /* * Let the URL and pattern input fields scale with the browser * width and try to prevent vertical scroll bars if the width - * is less than 80 characters. + * is less than 80 characters. */ input.url, input.pattern { width: 95%; } diff --git a/external/privoxy/templates/connect-failed b/external/privoxy/templates/connect-failed index 96b312e..3607552 100644 --- a/external/privoxy/templates/connect-failed +++ b/external/privoxy/templates/connect-failed @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -94,7 +94,7 @@ <tr> <td class="status"> 503 - </td> + </td> <td class="title" style="width: 100%">
#include mod-title diff --git a/external/privoxy/templates/default b/external/privoxy/templates/default index a4bb7d0..065aedc 100644 --- a/external/privoxy/templates/default +++ b/external/privoxy/templates/default @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -124,7 +124,7 @@ </td> </tr> <!-- if-have-help-info-end@ --> - + </table>
</body> diff --git a/external/privoxy/templates/edit-actions-add-url-form b/external/privoxy/templates/edit-actions-add-url-form index d1d9256..32ee64f 100644 --- a/external/privoxy/templates/edit-actions-add-url-form +++ b/external/privoxy/templates/edit-actions-add-url-form @@ -11,7 +11,7 @@ # Original Author: Copyright (C) 2001 Jonathan Foster # http://www.jon-foster.co.uk/ # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -29,6 +29,75 @@ # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # +# Revisions : +# $Log: edit-actions-add-url-form,v $ +# Revision 1.18 2007/12/08 14:36:43 fabiankeil +# - Use the shiny new CSS "pattern" class. +# - s@URL Pattern@URL or TAG Pattern@ +# +# Revision 1.17 2007/01/23 16:03:16 fabiankeil +# - Add favicon links. +# - Remove useless W3C validator links. +# +# Revision 1.16 2006/07/18 14:49:13 david__schmidt +# Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +# with what was really the latest development (the v_3_0_branch branch) +# +# Revision 1.14.2.2 2002/08/23 02:22:53 hal9 +# Fix a perl brain fart with <li> in comments. +# +# Revision 1.14 2002/05/21 19:10:30 oes +# - Added jump target and button style to "cancel" link +# - Fixed title +# +# Revision 1.13 2002/04/10 13:32:53 oes +# Made templates modular +# +# Revision 1.12 2002/04/08 17:08:14 oes +# Cosmetic: make status in title lowercase +# +# Revision 1.11 2002/04/05 16:01:33 oes +# Correct HTML, external Stylesheets, eye candy, some fixes +# +# Revision 1.10 2002/03/26 22:29:56 swa +# we have a new homepage! +# +# Revision 1.9 2002/03/24 15:23:33 jongfoster +# Name changes +# +# Revision 1.8 2002/03/24 11:01:06 swa +# name change +# +# Revision 1.7 2002/03/23 16:18:15 swa +# renamed every reference to the old name with foobar. +# fixed "application foobar application" tag, fixed +# "the foobar" with "foobar". left junkbuster in cvs +# comments and remarks to history untouched. should +# make final rename easier. +# +# Revision 1.6 2002/03/16 15:22:19 jongfoster +# Moving 'alpha' warning to the end of the page +# +# Revision 1.5 2002/03/03 10:29:12 swa +# point users to the right feedback forms, +# not necessarily the developer list. +# +# Revision 1.4 2002/01/23 00:26:45 jongfoster +# Reducing length of URLs +# Where encoded and unencoded versions of a string existed, removing +# the unencoded one. +# +# Revision 1.3 2002/01/17 21:33:00 jongfoster +# Replacing all references to the URL of the config interface +# with @default-cgi@ +# +# Revision 1.2 2002/01/17 21:21:03 jongfoster +# DOS->Unix line endings +# +# Revision 1.1 2001/11/13 00:58:18 jongfoster +# New version of actions file editor templates +# +# ############################################################################## # # Standard support: diff --git a/external/privoxy/templates/edit-actions-for-url b/external/privoxy/templates/edit-actions-for-url index 3999b85..fd673af 100644 --- a/external/privoxy/templates/edit-actions-for-url +++ b/external/privoxy/templates/edit-actions-for-url @@ -4,7 +4,7 @@ # # Purpose : Template used to edit the actions associated with a # particular section in an actions file. -# +# # # Copyright : Written by and Copyright (C) 2001-2008 the SourceForge # Privoxy team. http://www.privoxy.org/ @@ -12,7 +12,7 @@ # Original Author: Copyright (C) 2001 Jonathan Foster # http://www.jon-foster.co.uk/ # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -30,8 +30,242 @@ # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # +# Revisions : +# $Log: edit-actions-for-url,v $ +# Revision 1.56 2008/09/20 10:04:33 fabiankeil +# Remove hide-forwarded-for-headers action which has +# been obsoleted by change-x-forwarded-for{block}. +# +# Revision 1.55 2008/09/19 15:26:29 fabiankeil +# Add change-x-forwarded-for{} action to block or add +# X-Forwarded-For headers. Mostly based on code removed +# before 3.0.7. +# +# Revision 1.54 2008/03/29 12:14:27 fabiankeil +# Remove send-wafer and send-vanilla-wafer actions. +# +# Revision 1.53 2008/03/28 15:13:45 fabiankeil +# Remove inspect-jpegs action. +# +# Revision 1.52 2008/03/15 14:52:36 fabiankeil +# Add CGI editor support for the "disable all filters of this type" +# directives "-client-header-filter", "-server-header-filter", +# "-client-header-tagger" and "-server-header-tagger". +# +# Revision 1.51 2008/03/07 16:46:49 fabiankeil +# Reword limit-connect{} entry. +# +# Revision 1.50 2008/03/04 18:30:44 fabiankeil +# Remove the treat-forbidden-connects-like-blocks action. We now +# use the "blocked" page for forbidden CONNECT requests by default. +# +# Revision 1.49 2008/03/01 14:00:47 fabiankeil +# Let the block action take the reason for the block +# as argument and show it on the "blocked" page. +# +# Revision 1.48 2007/12/11 21:18:55 fabiankeil +# Make forward-override accessible through the CGI editor. +# +# Revision 1.47 2007/12/06 18:21:55 fabiankeil +# Update hide-forwarded-for-headers description. +# +# Revision 1.46 2007/11/10 15:06:10 fabiankeil +# - Add support for +hide-referrer{conditional-forge}. +# - Minor rewordings. +# +# Revision 1.45 2007/05/24 13:38:45 fabiankeil +# Two minor fixes. +# +# Revision 1.44 2007/04/15 16:39:21 fabiankeil +# Introduce tags as alternative way to specify which +# actions apply to a request. At the moment tags can be +# created based on client and server headers. +# +# Revision 1.43 2007/03/29 11:40:34 fabiankeil +# Divide @filter-params@ into @client-header-filter-params@ +# @content-filter-params@ and @server-header-filter-params@. +# +# Revision 1.42 2007/03/20 15:40:00 fabiankeil +# Adjust to new world order with dedicated header-filter actions. +# +# Revision 1.41 2007/01/23 16:03:16 fabiankeil +# - Add favicon links. +# - Remove useless W3C validator links. +# +# Revision 1.40 2006/12/21 13:01:03 fabiankeil +# Prepare for "split-large-forms". +# +# Mention that redirect{} now also understands +# a single pcrs job as argument. +# +# Add some table summaries and remove useless validator link. +# +# Revision 1.39 2006/10/04 17:37:54 fabiankeil +# JavaScript fix for bug report #1570678. +# +# Revision 1.38 2006/09/08 12:06:35 fabiankeil +# Have hide-if-modified-since interpret the random +# range value as minutes instead of hours. Allows +# more fine-grained configuration. +# +# Revision 1.37 2006/09/05 18:20:14 fabiankeil +# Sorted alphabetically, fixed spelling mistakes +# and shortened some descriptions. +# +# Revision 1.36 2006/08/14 08:29:17 fabiankeil +# Split filter-headers{} into filter-client-headers{} +# and filter-server-headers{}. +# +# Revision 1.35 2006/08/03 02:46:42 david__schmidt +# Incorporate Fabian Keil's patch work:http://www.fabiankeil.de/sourcecode/privoxy/ +# +# Revision 1.34 2006/07/18 14:49:13 david__schmidt +# Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +# with what was really the latest development (the v_3_0_branch branch) +# +# Revision 1.29.2.5 2004/10/05 03:17:26 david__schmidt +# Typo: inspect_jpegs, not inspect-jpegs in form +# +# Revision 1.29.2.4 2004/10/03 12:53:46 david__schmidt +# Add the ability to check jpeg images for invalid +# lengths of comment blocks. Defensive strategy +# against the exploit: +# Microsoft Security Bulletin MS04-028 +# Buffer Overrun in JPEG Processing (GDI+) Could +# Allow Code Execution (833987) +# Enabled with +inspect-jpegs in actions files. +# +# Revision 1.29.2.3 2002/08/23 02:22:53 hal9 +# Fix a perl brain fart with <li> in comments. +# +# Revision 1.29.2.1 2002/08/02 12:51:42 oes +# Added top submit button; Consistency with docs: Change default name for action from hide-referer to hide-referrer +# +# Revision 1.29 2002/05/21 19:10:57 oes +# Fixed JavaScript error +# +# Revision 1.28 2002/05/14 21:36:38 oes +# - Renamed prevent-(setting/reading)-cookies to +# crunch-(incoming/outgoing)-cookies +# - Renamed helplink export to actions-help-prefix +# - Restored alphabetical order of actions +# +# Revision 1.27 2002/04/26 22:55:26 jongfoster +# Removing the alternating colors because they've been wrong +# since the actions renames, they're high maintenance, they +# don't look particularly good, and now there are gaps between +# the table cells we don't need them. +# +# Revision 1.26 2002/04/26 21:55:17 jongfoster +# Cosmetic change: Making the +filter UI look the same as +# the other actions. +# +# Revision 1.25 2002/04/26 21:37:50 jongfoster +# Fixing all(?) the substitutions that were broken in the +# recent actions rename. +# +# Revision 1.24 2002/04/26 18:24:28 jongfoster +# Fixing typos in help hyperlinks +# +# Revision 1.23 2002/04/26 12:57:02 oes +# Actions renamed, alphabetically sorted, comments fixed, and names linked to help +# +# Revision 1.22 2002/04/10 13:32:53 oes +# Made templates modular +# +# Revision 1.21 2002/04/08 17:05:18 oes +# Inline a style exception +# +# Revision 1.20 2002/04/05 16:01:30 oes +# Correct HTML, external Stylesheets, eye candy, some fixes +# +# Revision 1.19 2002/03/26 22:29:56 swa +# we have a new homepage! +# +# Revision 1.18 2002/03/24 16:32:08 jongfoster +# Removing logo option +# +# Revision 1.17 2002/03/24 15:23:33 jongfoster +# Name changes +# +# Revision 1.16 2002/03/24 11:01:06 swa +# name change +# +# Revision 1.15 2002/03/23 16:18:15 swa +# renamed every reference to the old name with foobar. +# fixed "application foobar application" tag, fixed +# "the foobar" with "foobar". left junkbuster in cvs +# comments and remarks to history untouched. should +# make final rename easier. +# +# Revision 1.14 2002/03/16 15:22:19 jongfoster +# Moving 'alpha' warning to the end of the page +# +# Revision 1.13 2002/03/16 14:28:38 jongfoster +# First version of modular filters support +# +# Revision 1.12 2002/03/12 01:42:50 oes +# Introduced modular filters +# +# Revision 1.11 2002/03/08 18:19:14 jongfoster +# Adding +image-blocker{pattern} option to edit interface +# +# Revision 1.10 2002/03/03 10:29:12 swa +# point users to the right feedback forms, +# not necessarily the developer list. +# +# Revision 1.9 2002/01/23 00:26:45 jongfoster +# Reducing length of URLs +# Where encoded and unencoded versions of a string existed, removing +# the unencoded one. +# +# Revision 1.8 2002/01/17 21:33:00 jongfoster +# Replacing all references to the URL of the config interface +# with @default-cgi@ +# +# Revision 1.7 2002/01/17 21:21:03 jongfoster +# DOS->Unix line endings +# +# Revision 1.6 2001/11/22 21:58:41 jongfoster +# Adding action +no-cookies-keep +# +# Revision 1.5 2001/11/13 21:12:17 jongfoster +# Added support for the following actions: +# +downgrade, +limit-connect, +no-compression +# +# Revision 1.4 2001/11/13 00:58:18 jongfoster +# New version of actions file editor templates +# +# ############################################################################## # +# Browser support for the JavaScript on this page: +# MS Internet Explorer 5.5 - Tested, Yes +# Netscape 6.0 - Tested, Yes +# Netscape 4.75 - Tested, NO +# Opera 5.12 - Tested, NO +# MS Internet Explorer 4+ - Untested, Yes +# MS IE 3.x, NS3.x - Untested, NO +# Mozilla >=0.6 - Untested, Yes +# +# All browsers should work, you just might not get the pretty DHTML effects. +# +# The effects that only work under the browsers marked "Yes" above are: +# - Text edit boxes that won't have any effect are disabled. +# - Table rows containing additional settings are hidden if the feature in +# question is disabled. +# +# There are major kludges to get around these problems with NS4, but they +# screw up the HTML too much for other browsers. If anyone wants to try, +# here's some descriptions of the kludges: +# http://www.webreference.com/js/tips/991114.html +# http://www.webreference.com/dhtml/column12/outDisplay.html +# +# If you're favorite browser isn't listed, please test and add it. +# +# +############################################################################# +# # Standard support: # # This file currently produces valid HTML 4.01 Strict. @@ -39,7 +273,7 @@ # If you change it, please save the generated page from your web browser # and then upload it to http://validator.w3.org/ for checking. # -############################################################################## +############################################################################# # # Available variables include: # @@ -62,7 +296,7 @@ # image-blocker-param-custom # # -############################################################################## +############################################################################# <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html>
@@ -351,7 +585,7 @@ function show_limit_connect_opts(tf) id="change_x_forwarded_for_mode_block" @change-x-forwarded-for-param-block@><label for="change_x_forwarded_for_mode_block">Block the header.</label><br> <input type="radio" name="change_x_forwarded_for_mode" value="add" - id="change_x_forwarded_for_mode_add" @change-x-forwarded-for-param-add@><label + id="change_x_forwarded_for_mode_add" @change-x-forwarded-for-param-add@><label for="change_x_forwarded_for_mode_add">Add the header.</label><br> </tr> <tr class="bg1" align="left" valign="top"> @@ -390,7 +624,7 @@ function show_limit_connect_opts(tf) <td class="noc1" align="center" valign="middle"><input type="radio" name="content_type_overwrite" value="X" @content-type-overwrite-x@ ></td> - <td class="action"><a href="@user-manual@@actions-help-prefix@CONTENT-TYPE-OVERWRITE">content-type-overwrite</a></td> + <td class="action"><a href="@user-manual@@actions-help-prefix@CONTENT_TYPE_OVERWRITE">content-type-overwrite</a></td> <td>Replace Content-Type header. By default it only applies to text documents, but if you know what you're doing you can enable force-text-mode to modify binary content types as well.</td> @@ -436,7 +670,7 @@ function show_limit_connect_opts(tf) <td class="noc1" align="center" valign="middle"><input type="radio" name="crunch_if_none_match" value="X" @crunch-if-none-match-x@ ></td> - <td class="action"><a href="@user-manual@@actions-help-prefix@CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a></td> + <td class="action"><a href="@user-manual@@actions-help-prefix@CRUNCH_IF_NONE_MATCH">crunch-if-none-match</a></td> <td>Remove If-None-Match header. Useful for filter testing and to make sure the header can't be used to track your visits.</td> </tr> @@ -511,7 +745,7 @@ function show_limit_connect_opts(tf) <td>Use the <input type="radio" name="deanimate_gifs_mode" value="first" id="deanimate_first" @deanimate-gifs-param-first@><label for="deanimate_first">first frame</label> <input - type="radio" name="deanimate_gifs_mode" value="last" + type="radio" name="deanimate_gifs_mode" value="last" id="deanimate_last" @deanimate-gifs-param-last@><label for="deanimate_last">last frame</label></td> </tr> @@ -550,7 +784,7 @@ function show_limit_connect_opts(tf) value="simple-check" id="fast_redirects_simple_check" @fast-redirects-param-simple-check@><label for="fast_redirects_simple_check">Simple check.</label> <br> - <input type="radio" name="fast_redirects_mode" value="check-decoded-url" + <input type="radio" name="fast_redirects_mode" value="check-decoded-url" id="fast_redirects_check_decoded_url" @fast-redirects-param-check-decoded-url@><label for="fast_redirects_check_decoded_url">Decode URL before checking.</label></td> </tr> @@ -623,7 +857,7 @@ function show_limit_connect_opts(tf) <td class="noc1" align="center" valign="middle"><input type="radio" name="force_text_mode" value="X" @force-text-mode-x@ ></td> - <td class="action"><a href="@user-manual@@actions-help-prefix@FORCE-TEXT-MODE">force-text-mode</a></td> + <td class="action"><a href="@user-manual@@actions-help-prefix@FORCE_TEXT_MODE">force-text-mode</a></td> <td> Enable filtering on documents whose Content-Type wasn't recognized as text. Do think twice, nothing is alright. @@ -652,7 +886,7 @@ function show_limit_connect_opts(tf) <td> </td> <td> Overriding forward directive:<br> - <input type="text" name="forward_override_param" + <input type="text" name="forward_override_param" id="forward_override_param" size="40" value="@forward-override-param@"><br> </td> @@ -667,7 +901,7 @@ function show_limit_connect_opts(tf) <td class="noc1" align="center" valign="middle"><input type="radio" name="handle_as_empty_document" value="X" @handle-as-empty-document-x@ ></td> - <td class="action"><a href="@user-manual@@actions-help-prefix@HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></td> + <td class="action"><a href="@user-manual@@actions-help-prefix@HANDLE_AS_EMPTY_DOCUMENT">handle-as-empty-document</a></td> <td> Block with an <em>empty</em> document instead of an Image or HTML message. The <em>empty</em> document contains only a space and can safely be parsed @@ -718,7 +952,7 @@ function show_limit_connect_opts(tf) onclick="hide_accept_language_param_disable(false)" @hide-accept-language-param-custom@ id="hide_accept_language_mode_set"><label for="hide_accept_language_mode_set">Fake these language settings:</label><br> - <input type="text" name="hide_accept_language_param" + <input type="text" name="hide_accept_language_param" id="hide_accept_language_param" size="40" value="@hide-accept-language-param@"><br> </td> @@ -752,7 +986,7 @@ function show_limit_connect_opts(tf) onclick="hide_content_disposition_param_disable(false)" @hide-content-disposition-param-custom@ id="hide_content_disposition_mode_set"><label for="hide_content_disposition_mode_set">Overwrite content-dispostion header with:</label><br> - <input type="text" name="hide_content_disposition_param" + <input type="text" name="hide_content_disposition_param" id="hide_content_disposition_param" size="40" value="@hide-content-disposition-param@"><br> </td> @@ -780,7 +1014,7 @@ function show_limit_connect_opts(tf) onclick="hide_from_header_param_disable(true);" @hide-from-header-param-block@ id="hide_from_header_mode_block"><label for="hide_from_header_mode_block">Remove completely</label><br> - <input type="radio" name="hide_from_header_mode" value="CUSTOM" + <input type="radio" name="hide_from_header_mode" value="CUSTOM" onclick="hide_from_header_param_disable(false);" @hide-from-header-param-custom@ id="hide_from_header_mode_set"><label for="hide_from_header_mode_set">Fake e-mail address:</label><br> @@ -798,7 +1032,7 @@ function show_limit_connect_opts(tf) <td class="noc1" align="center" valign="middle"><input type="radio" name="hide_if_modified_since" value="X" @hide-if-modified-since-x@ ></td> - <td class="action"><a href="@user-manual@@actions-help-prefix@HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a></td> + <td class="action"><a href="@user-manual@@actions-help-prefix@HIDE_IF_MODIFIED_SINCE">hide-if-modified-since</a></td> <td>Remove or randomize the If-Modified-Since header.</td> </tr> <tr class="bg1" align="left" valign="top" id="hide_if-modifed-since_opts"> @@ -815,7 +1049,7 @@ function show_limit_connect_opts(tf) onclick="hide_if_modified_since_param_disable(true)" @hide-if-modified-since-param-custom@ id="hide_if_modified_since_mode_set"><label for="hide_if_modified_since_mode_set">Add random amount of seconds in the range of</label> - <input type="text" name="hide_if_modified_since_param" + <input type="text" name="hide_if_modified_since_param" id="hide_if_modified_since_param" size="4" value="@hide-if-modified-since-param@"> minute(s). To appreciate this option a small amount of paranoia is required, @@ -879,7 +1113,7 @@ function show_limit_connect_opts(tf) onclick="hide_referrer_param_disable(false)" @hide-referrer-param-custom@ id="hide_referrer_mode_set"><label for="hide_referrer_mode_set">Fake as this web address:</label><br> - <input type="text" name="hide_referrer_param" + <input type="text" name="hide_referrer_param" id="hide_referrer_param" size="40" value="@hide-referrer-param@"><br> <input type="radio" name="hide_referrer_mode" value="conditional-block" @@ -950,7 +1184,7 @@ function show_limit_connect_opts(tf) <td class="noc1" align="center" valign="middle"><input type="radio" name="overwrite_last_modified" value="X" @overwrite-last-modified-x@ ></td> - <td class="action"><a href="@user-manual@@actions-help-prefix@OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></td> + <td class="action"><a href="@user-manual@@actions-help-prefix@OVERWRITE_LAST_MODIFIED">overwrite-last-modified</a></td> <td>Remove or randomize the Last-Modified header.</td> </tr> <tr class="bg1" align="left" valign="top" id="overwrite_last_modified_opts"> @@ -1058,7 +1292,7 @@ function show_limit_connect_opts(tf) ("per-session") ones, which only last until you close your web browser. This will allow you to use sites that require cookies, but sites will not be able to track you across sessions. For this to - be useful, you should disable + be useful, you should disable <a href="@user-manual@@actions-help-prefix@CRUNCH-OUTGOING-COOKIES"><b>crunch-outgoing-cookies</b></a> and <a href="@user-manual@@actions-help-prefix@CRUNCH-INCOMING-COOKIES"><b>crunch-incoming-cookies</b></a>.</td> </tr> @@ -1089,7 +1323,7 @@ function show_limit_connect_opts(tf) alt="pattern">)</label><br> <input type="radio" name="set_image_blocker_mode" value="blank" onclick="set_image_blocker_param_disable(true)" - id="set_image_blocker_mode_blank" @set-image-blocker-param-blank@><label + id="set_image_blocker_mode_blank" @set-image-blocker-param-blank@><label for="set_image_blocker_mode_blank">Send a 1x1 transparent GIF</label><br> <input type="radio" name="set_image_blocker_mode" value="CUSTOM" onclick="set_image_blocker_param_disable(false)" diff --git a/external/privoxy/templates/edit-actions-for-url-filter b/external/privoxy/templates/edit-actions-for-url-filter index a2e3ef0..d4dad90 100644 --- a/external/privoxy/templates/edit-actions-for-url-filter +++ b/external/privoxy/templates/edit-actions-for-url-filter @@ -4,17 +4,27 @@ # # Purpose : Template that is included from most of Privoxy's CGI pages # to show the user how to get help or report problems. -# +# # # Copyright : Written by and Copyright (C) 2002-2007 members of # the SourceForge Privoxy team. http://www.privoxy.org/ # -# This template is free software; you can redistribute it +# This template is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at # your option) any later version. # +# Revisions : +# $Log: edit-actions-for-url-filter,v $ +# Revision 1.8 2007/03/29 11:40:34 fabiankeil +# Divide @filter-params@ into @client-header-filter-params@ +# @content-filter-params@ and @server-header-filter-params@. +# +# Revision 1.7 2007/03/20 15:40:00 fabiankeil +# Adjust to new world order with dedicated header-filter actions. +# +# ##############################################################################
<tr class="bg1" align="left" valign="top"> diff --git a/external/privoxy/templates/edit-actions-list b/external/privoxy/templates/edit-actions-list index 0fab069..85ec9b5 100644 --- a/external/privoxy/templates/edit-actions-list +++ b/external/privoxy/templates/edit-actions-list @@ -3,15 +3,15 @@ # File : $Source: /cvsroot/ijbswa/current/templates/edit-actions-list,v $ # # Purpose : Template used to edit the actions file. +# # -# -# Copyright : Written by and Copyright (C) 2001-2009 the +# Copyright : Written by and Copyright (C) 2001-2007 the SourceForge # Privoxy team. http://www.privoxy.org/ # # Original Author: Copyright (C) 2001 Jonathan Foster # http://www.jon-foster.co.uk/ # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -29,6 +29,139 @@ # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # +# Revisions : +# $Log: edit-actions-list,v $ +# Revision 1.34 2007/05/21 10:54:46 fabiankeil +# - Use strlcpy() instead of strcpy(). +# - Stop treating actions files special. Expect a complete file name +# (with or without path) like it's done for the rest of the files. +# Closes FR#588084. +# - Don't rerun sed() in cgi_show_request(). +# +# Revision 1.33 2007/04/08 13:21:06 fabiankeil +# Reference action files in CGI URLs by id instead +# of using the first part of the file name. +# Fixes BR 1694250 and BR 1590556. +# +# Revision 1.32 2007/01/23 16:03:16 fabiankeil +# - Add favicon links. +# - Remove useless W3C validator links. +# +# Revision 1.31 2006/09/10 14:39:24 hal9 +# Fix typo + minor change. +# +# Revision 1.30 2006/09/09 01:12:15 hal9 +# Soften actions files update interval. +# +# Revision 1.29 2006/07/18 14:49:13 david__schmidt +# Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +# with what was really the latest development (the v_3_0_branch branch) +# +# Revision 1.26.2.4 2003/12/17 16:35:17 oes +# Work around new & silly MSIE behaviour where the request resulting from +# changing window.location.href doesn't reveal the referrer anymore +# +# Revision 1.26.2.3 2002/09/25 15:34:09 oes +# - Work around JS problem in NS 2.0 (no joke) +# - Make JS string edit popup remove the pattern +# if edited to empty; make JS add popup do nothing +# if pattern empty. +# +# Revision 1.26.2.2 2002/08/23 02:22:53 hal9 +# Fix a perl brain fart with <li> in comments. +# +# Revision 1.26 2002/05/23 23:37:25 oes +# Nit +# +# Revision 1.25 2002/05/21 21:02:52 oes +# Added more help links +# +# Revision 1.24 2002/05/21 19:11:40 oes +# - Added client-side JavaScript versions of edit and add URL forms +# - Moved jump targets to before container table cell +# - Let earu determine the jump target when removing URLs via JS +# - Fixed broken help link +# +# Revision 1.23 2002/05/12 15:53:10 jongfoster +# Restoring CVS log information accidentally removed in +# my previous commit. +# +# Revision 1.22 2002/05/12 15:45:33 jongfoster +# Applying [Patch 552094] New templates for edit-actions-list +# This cleans up the templates by: +# - Removing the (confusing) alternating color scheme. +# - Making everything left-justified. +# +# Revision 1.21 2002/05/03 22:58:15 jongfoster +# Fixing link target in all URLs section +# +# Revision 1.20 2002/04/26 12:57:18 oes +# - Central "button" link style in cgi-style.css +# - Help links now dynamic +# +# Revision 1.19 2002/04/24 02:19:16 oes +# - Show name of actions file being edited +# - Show context sensitive help +# - Add buttons for easy changing of defaults +# - Cosmetics and clarifications +# +# Revision 1.18 2002/04/18 19:21:09 jongfoster +# Added code to detect "conventional" action files, that start +# with a set of actions for all URLs (the pattern "/"). +# These are special-cased in the "edit-actions-list" CGI, so +# that a special UI can be written for them. +# +# Revision 1.17 2002/04/10 13:32:53 oes +# Made templates modular +# +# Revision 1.16 2002/04/08 17:08:14 oes +# Cosmetic: make status in title lowercase +# +# Revision 1.15 2002/04/05 16:01:32 oes +# Correct HTML, external Stylesheets, eye candy, some fixes +# +# Revision 1.14 2002/03/26 22:29:56 swa +# we have a new homepage! +# +# Revision 1.13 2002/03/24 15:23:33 jongfoster +# Name changes +# +# Revision 1.12 2002/03/24 11:01:06 swa +# name change +# +# Revision 1.11 2002/03/23 16:18:15 swa +# renamed every reference to the old name with foobar. +# fixed "application foobar application" tag, fixed +# "the foobar" with "foobar". left junkbuster in cvs +# comments and remarks to history untouched. should +# make final rename easier. +# +# Revision 1.10 2002/03/16 15:22:19 jongfoster +# Moving 'alpha' warning to the end of the page +# +# Revision 1.9 2002/03/05 00:24:51 jongfoster +# Patch to always edit the current actions file. +# +# Revision 1.8 2002/03/03 10:29:12 swa +# point users to the right feedback forms, +# not necessarily the developer list. +# +# Revision 1.7 2002/01/23 00:26:45 jongfoster +# Reducing length of URLs +# Where encoded and unencoded versions of a string existed, removing +# the unencoded one. +# +# Revision 1.6 2002/01/17 21:33:00 jongfoster +# Replacing all references to the URL of the config interface +# with @default-cgi@ +# +# Revision 1.5 2002/01/17 21:21:05 jongfoster +# DOS->Unix line endings +# +# Revision 1.4 2001/11/13 00:58:18 jongfoster +# New version of actions file editor templates +# +# ############################################################################## # # Browser support for the CSS on this page: @@ -136,7 +269,7 @@ function e_p(link,pattern,curtext) if ((newtext=window.prompt("Edit the pattern to your needs:", unescape(curtext))) != null) { if (newtext != "") - { link.href="edit-actions-url?f=@f@&v=@v@&p="+pattern+"&u="+encodeURIComponent(newtext); } + { link.href="edit-actions-url?f=@f@&v=@v@&p="+pattern+"&u="+escape(newtext); } else { link.href="edit-actions-remove-url?f=@f@&v=@v@&p="+pattern; } return true; @@ -148,7 +281,7 @@ function a_p(link,section) { if (((newtext=window.prompt("Enter the new pattern:", "")) != null ) && (newtext != "")) { - link.href="edit-actions-add-url?f=@f@&v=@v@&s="+section+"&u="+encodeURIComponent(newtext); + link.href="edit-actions-add-url?f=@f@&v=@v@&s="+section+"&u="+escape(newtext); return true; } return false; @@ -183,7 +316,7 @@ function a_p(link,section) <td class="info"> <h2>What is all this?</h2> <p> - If you haven't already done so, it is <b>strongly recommended</b> that you at + If you haven't already done so, it is <b>strongly recommended</b> that you at least skim <a href="@user-manual@@actions-help-prefix@ACTIONS-FILE">the chapter on actions files</a> in the <a href="@user-manual@">User Manual</a> before making any changes. You will also find a comprehensive list of @@ -201,7 +334,7 @@ function a_p(link,section) <!-- @if-default-action-then@ --> <p> This is the default action file. Updates for it are available from - <a href="http://www.privoxy.org/">Privoxy.org</a> from time to time. + <a href="http://www.privoxy.org/">Privoxy.org</a> from time to time. It is therefore <b>not recommended</b> that you add your private rules here, since they will be lost if you install an update in the future. Put your rules in a separate actions file, like <tt>user.action</tt> instead. diff --git a/external/privoxy/templates/edit-actions-list-button b/external/privoxy/templates/edit-actions-list-button index c009f60..fd0e8b9 100644 --- a/external/privoxy/templates/edit-actions-list-button +++ b/external/privoxy/templates/edit-actions-list-button @@ -3,7 +3,7 @@ # File : $Source: /cvsroot/ijbswa/current/templates/edit-actions-list-button,v $ # # Purpose : Template which forms part of edit-actions-list -# +# # # Copyright : Written by and Copyright (C) 2001 the SourceForge # Privoxy team. http://www.privoxy.org/ @@ -11,7 +11,7 @@ # Original Author: Copyright (C) 2001 Jonathan Foster # http://www.jon-foster.co.uk/ # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -29,5 +29,21 @@ # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # +# Revisions : +# $Log: edit-actions-list-button,v $ +# Revision 1.3 2002/05/12 15:53:10 jongfoster +# Restoring CVS log information accidentally removed in +# my previous commit. +# +# Revision 1.2 2002/05/12 15:45:33 jongfoster +# Applying [Patch 552094] New templates for edit-actions-list +# This cleans up the templates by: +# - Removing the (confusing) alternating color scheme. +# - Making everything left-justified. +# +# Revision 1.1 2002/05/03 23:00:38 jongfoster +# Support for templates for "standard actions" buttons. +# See bug #549871 +# ############################################################################# <a href="eas?f=@f@&v=@v@&s=@all-urls-s@&p=@button-name@#l@all-urls-s@">Set to @button-name@</a> diff --git a/external/privoxy/templates/edit-actions-list-section b/external/privoxy/templates/edit-actions-list-section index 40e30cb..c8578ad 100644 --- a/external/privoxy/templates/edit-actions-list-section +++ b/external/privoxy/templates/edit-actions-list-section @@ -3,7 +3,7 @@ # File : $Source: /cvsroot/ijbswa/current/templates/edit-actions-list-section,v $ # # Purpose : Template which forms part of edit-actions-list -# +# # # Copyright : Written by and Copyright (C) 2001 the SourceForge # Privoxy team. http://www.privoxy.org/ @@ -11,7 +11,7 @@ # Original Author: Copyright (C) 2001 Jonathan Foster # http://www.jon-foster.co.uk/ # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -29,6 +29,64 @@ # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # +# Revisions : +# $Log: edit-actions-list-section,v $ +# Revision 1.16 2006/07/18 14:49:13 david__schmidt +# Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +# with what was really the latest development (the v_3_0_branch branch) +# +# Revision 1.15.2.1 2003/12/17 16:35:17 oes +# Work around new & silly MSIE behaviour where the request resulting from +# changing window.location.href doesn't reveal the referrer anymore +# +# Revision 1.15 2002/05/21 21:02:52 oes +# Added more help links +# +# Revision 1.14 2002/05/21 19:12:43 oes +# - Added client-side JavaScript versions of edit and add URL forms +# - Moved jump targets to before container table cell +# +# Revision 1.13 2002/05/12 15:45:33 jongfoster +# Applying [Patch 552094] New templates for edit-actions-list +# This cleans up the templates by: +# - Removing the (confusing) alternating color scheme. +# - Making everything left-justified. +# +# Revision 1.12 2002/04/26 12:58:11 oes +# Central "button" link style in cgi-style.css +# +# Revision 1.11 2002/04/24 02:14:03 oes +# Changed shortcuts, Cosmetics +# +# Revision 1.10 2002/04/17 21:27:26 jongfoster +# Adding #linenumber to the URLs which affect blocks, to make +# editing in long files easier. +# +# Revision 1.9 2002/04/17 15:51:47 oes +# Args! Restoring CVS history +# +# Revision 1.8 2002/04/17 15:04:16 oes +# Adapted to style change +# +# Revision 1.7 2002/03/26 22:29:56 swa +# we have a new homepage! +# +# Revision 1.6 2002/03/24 11:01:06 swa +# name change +# +# Revision 1.5 2002/01/23 00:26:45 jongfoster +# Reducing length of URLs +# Where encoded and unencoded versions of a string existed, removing +# the unencoded one. +# +# Revision 1.4 2002/01/17 21:33:00 jongfoster +# Replacing all references to the URL of the config interface +# with @default-cgi@ +# +# Revision 1.3 2001/11/13 00:58:18 jongfoster +# New version of actions file editor templates +# +# ############################################################################# # # Available variables include: diff --git a/external/privoxy/templates/edit-actions-list-url b/external/privoxy/templates/edit-actions-list-url index ba026b5..08c1ea4 100644 --- a/external/privoxy/templates/edit-actions-list-url +++ b/external/privoxy/templates/edit-actions-list-url @@ -3,7 +3,7 @@ # File : $Source: /cvsroot/ijbswa/current/templates/edit-actions-list-url,v $ # # Purpose : Template which forms part of edit-actions-list -# +# # # Copyright : Written by and Copyright (C) 2001 the SourceForge # Privoxy team. http://www.privoxy.org/ @@ -11,7 +11,7 @@ # Original Author: Copyright (C) 2001 Jonathan Foster # http://www.jon-foster.co.uk/ # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -29,6 +29,47 @@ # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # +# Revisions : +# $Log: edit-actions-list-url,v $ +# Revision 1.11 2006/07/18 14:49:14 david__schmidt +# Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +# with what was really the latest development (the v_3_0_branch branch) +# +# Revision 1.10.2.1 2003/12/17 16:35:17 oes +# Work around new & silly MSIE behaviour where the request resulting from +# changing window.location.href doesn't reveal the referrer anymore +# +# Revision 1.10 2002/05/21 19:13:14 oes +# Added client-side JavaScript versions of edit and add URL forms +# +# Revision 1.9 2002/05/12 15:45:33 jongfoster +# Applying [Patch 552094] New templates for edit-actions-list +# This cleans up the templates by: +# - Removing the (confusing) alternating color scheme. +# - Making everything left-justified. +# +# Revision 1.8 2002/04/26 12:58:11 oes +# Central "button" link style in cgi-style.css +# +# Revision 1.7 2002/03/26 22:29:56 swa +# we have a new homepage! +# +# Revision 1.6 2002/03/24 11:01:06 swa +# name change +# +# Revision 1.5 2002/01/23 00:26:45 jongfoster +# Reducing length of URLs +# Where encoded and unencoded versions of a string existed, removing +# the unencoded one. +# +# Revision 1.4 2002/01/17 21:33:00 jongfoster +# Replacing all references to the URL of the config interface +# with @default-cgi@ +# +# Revision 1.3 2001/11/13 00:58:18 jongfoster +# New version of actions file editor templates +# +# ############################################################################# # # Available variables include: diff --git a/external/privoxy/templates/edit-actions-remove-url-form b/external/privoxy/templates/edit-actions-remove-url-form index f653a06..17b9b22 100644 --- a/external/privoxy/templates/edit-actions-remove-url-form +++ b/external/privoxy/templates/edit-actions-remove-url-form @@ -5,7 +5,7 @@ # Purpose : Template used to confirm removal of a particular URL # pattern from an actions file. Only used on browsers that # don't support JavaScript. -# +# # # Copyright : Written by and Copyright (C) 2001 the SourceForge # Privoxy team. http://www.privoxy.org/ @@ -13,7 +13,7 @@ # Original Author: Copyright (C) 2001 Jonathan Foster # http://www.jon-foster.co.uk/ # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -31,6 +31,70 @@ # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # +# Revisions : +# $Log: edit-actions-remove-url-form,v $ +# Revision 1.17 2007/01/23 16:03:16 fabiankeil +# - Add favicon links. +# - Remove useless W3C validator links. +# +# Revision 1.16 2006/07/18 14:49:14 david__schmidt +# Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +# with what was really the latest development (the v_3_0_branch branch) +# +# Revision 1.14.2.2 2002/08/23 02:22:53 hal9 +# Fix a perl brain fart with <li> in comments. +# +# Revision 1.14 2002/05/21 19:13:49 oes +# Added button style and jumptargets to "add" and "cancel" links +# +# Revision 1.13 2002/04/10 13:32:53 oes +# Made templates modular +# +# Revision 1.12 2002/04/08 17:08:14 oes +# Cosmetic: make status in title lowercase +# +# Revision 1.11 2002/04/05 16:01:30 oes +# Correct HTML, external Stylesheets, eye candy, some fixes +# +# Revision 1.10 2002/03/26 22:29:56 swa +# we have a new homepage! +# +# Revision 1.9 2002/03/24 15:23:33 jongfoster +# Name changes +# +# Revision 1.8 2002/03/24 11:01:06 swa +# name change +# +# Revision 1.7 2002/03/23 16:18:15 swa +# renamed every reference to the old name with foobar. +# fixed "application foobar application" tag, fixed +# "the foobar" with "foobar". left junkbuster in cvs +# comments and remarks to history untouched. should +# make final rename easier. +# +# Revision 1.6 2002/03/16 15:22:19 jongfoster +# Moving 'alpha' warning to the end of the page +# +# Revision 1.5 2002/03/03 10:29:12 swa +# point users to the right feedback forms, +# not necessarily the developer list. +# +# Revision 1.4 2002/01/23 00:26:45 jongfoster +# Reducing length of URLs +# Where encoded and unencoded versions of a string existed, removing +# the unencoded one. +# +# Revision 1.3 2002/01/17 21:33:00 jongfoster +# Replacing all references to the URL of the config interface +# with @default-cgi@ +# +# Revision 1.2 2002/01/17 21:21:05 jongfoster +# DOS->Unix line endings +# +# Revision 1.1 2001/11/13 00:58:18 jongfoster +# New version of actions file editor templates +# +# ############################################################################## # # Standard support: diff --git a/external/privoxy/templates/edit-actions-url-form b/external/privoxy/templates/edit-actions-url-form index c94492d..0b91035 100644 --- a/external/privoxy/templates/edit-actions-url-form +++ b/external/privoxy/templates/edit-actions-url-form @@ -11,7 +11,7 @@ # Original Author: Copyright (C) 2001 Jonathan Foster # http://www.jon-foster.co.uk/ # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -29,6 +29,75 @@ # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # +# Revisions : +# $Log: edit-actions-url-form,v $ +# Revision 1.18 2007/12/08 14:38:55 fabiankeil +# - Use the shiny new CSS "pattern" class. +# - s@URL Pattern@URL or TAG Pattern@ +# - Use the standard favicon as this ain't no error page. +# +# Revision 1.17 2007/01/23 16:03:16 fabiankeil +# - Add favicon links. +# - Remove useless W3C validator links. +# +# Revision 1.16 2006/07/18 14:49:14 david__schmidt +# Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) +# with what was really the latest development (the v_3_0_branch branch) +# +# Revision 1.14.2.2 2002/08/23 02:22:53 hal9 +# Fix a perl brain fart with <li> in comments. +# +# Revision 1.14 2002/05/21 19:14:10 oes +# Added button style and jumptarget "cancel" link +# +# Revision 1.13 2002/04/10 13:32:53 oes +# Made templates modular +# +# Revision 1.12 2002/04/08 17:08:14 oes +# Cosmetic: make status in title lowercase +# +# Revision 1.11 2002/04/05 16:01:32 oes +# Correct HTML, external Stylesheets, eye candy, some fixes +# +# Revision 1.10 2002/03/26 22:29:56 swa +# we have a new homepage! +# +# Revision 1.9 2002/03/24 15:23:33 jongfoster +# Name changes +# +# Revision 1.8 2002/03/24 11:01:06 swa +# name change +# +# Revision 1.7 2002/03/23 16:18:15 swa +# renamed every reference to the old name with foobar. +# fixed "application foobar application" tag, fixed +# "the foobar" with "foobar". left junkbuster in cvs +# comments and remarks to history untouched. should +# make final rename easier. +# +# Revision 1.6 2002/03/16 15:22:19 jongfoster +# Moving 'alpha' warning to the end of the page +# +# Revision 1.5 2002/03/03 10:29:13 swa +# point users to the right feedback forms, +# not necessarily the developer list. +# +# Revision 1.4 2002/01/23 00:26:45 jongfoster +# Reducing length of URLs +# Where encoded and unencoded versions of a string existed, removing +# the unencoded one. +# +# Revision 1.3 2002/01/17 21:33:00 jongfoster +# Replacing all references to the URL of the config interface +# with @default-cgi@ +# +# Revision 1.2 2002/01/17 21:21:05 jongfoster +# DOS->Unix line endings +# +# Revision 1.1 2001/11/13 00:58:18 jongfoster +# New version of actions file editor templates +# +# ############################################################################## # # Standard support: diff --git a/external/privoxy/templates/forwarding-failed b/external/privoxy/templates/forwarding-failed index d555470..fca5c8c 100644 --- a/external/privoxy/templates/forwarding-failed +++ b/external/privoxy/templates/forwarding-failed @@ -8,7 +8,7 @@ # # Template files are written in plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -99,7 +99,7 @@ <tr> <td class="status"> 503 - </td> + </td> <td class="title" style="width: 100%">
#include mod-title diff --git a/external/privoxy/templates/mod-local-help b/external/privoxy/templates/mod-local-help index 60b0737..21d6596 100644 --- a/external/privoxy/templates/mod-local-help +++ b/external/privoxy/templates/mod-local-help @@ -1,11 +1,11 @@ <h2>Local Privoxy support:</h2>
<!-- @if-have-proxy-info-start --> - <p>You can consult the <a href="@proxy-info-url@">online documentation</a> for more information about this Privoxy installation.</p> + <p>You can consult the <a href="@proxy-info-url@">online documentation</a> for more information about this Privoxy installation.</p> <!-- if-have-proxy-info-end@ -->
<!-- @if-have-adminaddr-info-start --> - <p>Address e-mail questions about this Privoxy installation to + <p>Address e-mail questions about this service to <a href="mailto:@admin-address@"><code>@admin-address@</code></a>, who will be glad to help you. </p> diff --git a/external/privoxy/templates/mod-support-and-service b/external/privoxy/templates/mod-support-and-service index fde47b1..9868761 100644 --- a/external/privoxy/templates/mod-support-and-service +++ b/external/privoxy/templates/mod-support-and-service @@ -4,17 +4,30 @@ # # Purpose : Template that is included from most of Privoxy's CGI pages # to show the user how to get help or report problems. +# # +# Copyright : Written by and Copyright (C) 2002-2007 members of +# the SourceForge Privoxy team. http://www.privoxy.org/ # -# Copyright : Written by and Copyright (C) 2002-2009 members of -# the Privoxy team. http://www.privoxy.org/ -# -# This template is free software; you can redistribute it +# This template is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at # your option) any later version. # +# Revisions : +# $Log: mod-support-and-service,v $ +# Revision 1.11 2008/01/02 18:06:58 fabiankeil +# Instead of linking to the "Contacting the developers ..." section +# in the FAQ, use the one from the User Manual. The latter can be +# delivered by Privoxy and thus possibly loads faster. +# +# Revision 1.10 2007/03/17 11:31:36 fabiankeil +# - Add revision log and copyright header. +# - Reword instructions and link to the FAQ +# in an attempt to reduce the number of +# incomplete reports. +# ############################################################################## <h2>Support and Service:</h2> <p> @@ -46,8 +59,3 @@ to make sure your request contains all the information we need. </li> </ul> - <p> - If you want to support the Privoxy Team, please have a look at the FAQ to learn how to - <a href="http://www.privoxy.org/faq/general.html#PARTICIPATE">participate</a> - or to <a href="http://www.privoxy.org/faq/general.html#DONATE">donate</a>. - </p> diff --git a/external/privoxy/templates/no-such-domain b/external/privoxy/templates/no-such-domain index cae2c73..08cf5da 100644 --- a/external/privoxy/templates/no-such-domain +++ b/external/privoxy/templates/no-such-domain @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -96,7 +96,7 @@ <tr> <td class="status"> 404 - </td> + </td> <td class="title" style="width: 100%">
#include mod-title @@ -151,7 +151,7 @@ </td> </tr> <!-- if-have-help-info-end@ --> - + </table>
</body> diff --git a/external/privoxy/templates/show-request b/external/privoxy/templates/show-request index be8536a..30a2529 100644 --- a/external/privoxy/templates/show-request +++ b/external/privoxy/templates/show-request @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -111,7 +111,7 @@ <p> Here you see the original headers that your client sent when requesting this page, along with the headers that Privoxy would have sent to the remote server if this request hadn't been - intercepted. + intercepted. </p>
<h3>Original Client Request:</h3> diff --git a/external/privoxy/templates/show-status b/external/privoxy/templates/show-status index ece4d11..f71e2de 100644 --- a/external/privoxy/templates/show-status +++ b/external/privoxy/templates/show-status @@ -7,7 +7,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -22,7 +22,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -47,7 +47,7 @@ # # redirect-url: # The URL to a script that will redirect to the Privoxy -# documentation for a given item +# documentation for a given item # invocation: # The command line with which Privoxy was invoked # options: @@ -60,7 +60,7 @@ # A HTML-formatted list of all conditional #defines used when # Privoxy was compiled # -# +# # CONDITIONAL SYMBOLS FOR THIS TEMPLATE AND THEIR DEPANDANT SYMBOLS: # ------------------------------------------------------------------ # @@ -200,17 +200,11 @@ <!-- @if-have-stats-start --> @requests-blocked@ out of @requests-received@ requests have been blocked, which equals a block rate of @percent-blocked@%. - </p> - <p> - <strong>Note that the statistics currently don't work properly for - reused connections where only the last request gets counted. - You may want to look into Privoxy-Log-Parser's --statistics option, - which doesn't have this limitation.</strong> <!-- if-have-stats-end@ --> <!-- @if-have-no-stats-start --> There haven't been any requests so far. <!-- if-have-no-stats-end@ --> - </p> + </p> </td> </tr> <!-- if-statistics-end@ --> @@ -219,15 +213,9 @@ <td class="box"> <h2>Conditional #defines:</h2> <table summary="The state of some ./configure options and what they do." border="1" style="margin-left: 10px"> - <tr> + <tr> <th>#define</th> <th>Enabled?</th> <th>Effects when enabled</th> </tr> - - <tr> - <td><code>FEATURE_ACCEPT_FILTER</code></td> - <td>@if-FEATURE_ACCEPT_FILTER-then@ Yes @else-not-FEATURE_ACCEPT_FILTER@ No @endif-FEATURE_ACCEPT_FILTER@</td> - <td>Support for FreeBSD's accf_http(9) which is also available on some other BSDs.</td> - </tr> <tr> <td><code>FEATURE_ACL</code></td> <td>@if-FEATURE_ACL-then@ Yes @else-not-FEATURE_ACL@ No @endif-FEATURE_ACL@</td> @@ -242,29 +230,14 @@ editor@if-FEATURE_CGI_EDIT_ACTIONS-then@</a>@else-not-FEATURE_CGI_EDIT_ACTIONS@@endif-FEATURE_CGI_EDIT_ACTIONS@.</td> </tr> <tr> - <td><code>FEATURE_COMPRESSION</code></td> - <td>@if-FEATURE_COMPRESSION-then@ Yes @else-not-FEATURE_COMPRESSION@ No @endif-FEATURE_COMPRESSION@</td> - <td> - Allows to compress buffered content before sending it to the client, assuming the client supports it. - </td> - </tr> - <tr> <td><code>FEATURE_CONNECTION_KEEP_ALIVE</code></td> <td>@if-FEATURE_CONNECTION_KEEP_ALIVE-then@ Yes @else-not-FEATURE_CONNECTION_KEEP_ALIVE@ No @endif-FEATURE_CONNECTION_KEEP_ALIVE@</td> <td> - Allows to send multiple request through the same connections if the server supports it. + Allows to reuse outgoing connections if the server supports it. Requires the keep-alive-timeout config directive to be set. </td> </tr> <tr> - <td><code>FEATURE_CONNECTION_SHARING</code></td> - <td>@if-FEATURE_CONNECTION_SHARING-then@ Yes @else-not-FEATURE_CONNECTION_SHARING@ No @endif-FEATURE_CONNECTION_SHARING@</td> - <td> - Allows to share outgoing connections between incoming connections. - Requires the connection-sharing config directive to be set. - </td> - </tr> - <tr> <td><code>FEATURE_FAST_REDIRECTS</code></td> <td>@if-FEATURE_FAST_REDIRECTS-then@ Yes @else-not-FEATURE_FAST_REDIRECTS@ No @endif-FEATURE_FAST_REDIRECTS@</td> <td>Allows the +fast-redirects action, to bypass redirect and logging scripts.</td> @@ -286,18 +259,10 @@ <td>Allows the +handle-as-image action, to send <q>blocked</q> images instead of HTML.</td> </tr> <tr> - <td><code>FEATURE_IPV6_SUPPORT</code></td> - <td>@if-FEATURE_IPV6_SUPPORT-then@ Yes @else-not-FEATURE_IPV6_SUPPORT@ No @endif-FEATURE_IPV6_SUPPORT@</td> - <td> - Allows IPv6 addresses in incoming requests, when resolving domains to - IP addresses and in the configuration files. - </td> - </tr> - <tr> <td><code>FEATURE_IMAGE_DETECT_MSIE</code></td> <td>@if-FEATURE_IMAGE_DETECT_MSIE-then@ Yes @else-not-FEATURE_IMAGE_DETECT_MSIE@ No @endif-FEATURE_IMAGE_DETECT_MSIE@</td> <td>Enables automatic detection of image and HTML requests from - Microsoft Internet Explorer users, overriding the setting of + Microsoft Internet Explorer users, overriding the setting of +image in the actions file.</td> </tr> <tr> @@ -334,10 +299,8 @@ <tr> <td><code>STATIC_PCRE</code></td> <td>@if-STATIC_PCRE-then@ Yes @else-not-STATIC_PCRE@ No @endif-STATIC_PCRE@</td> - <td>Use the supplied statically-linked PCRE library. This is set automatically - by <code>./configure</code> if you do not have the libpcre installed. - Dynamically linking to an external libpcre is recommended as the internal - one is outdated and lacks various features and bug-fixes you may be interested in.</td> + <td>Use the supplied statically-linked PCRE library. This is set automatically + by <code>./configure</code> if you do not have the libpcre installed.</td> </tr> <tr> <td><code>STATIC_PCRS</code></td> diff --git a/external/privoxy/templates/show-status-file b/external/privoxy/templates/show-status-file index ec03b36..4fa9333 100644 --- a/external/privoxy/templates/show-status-file +++ b/external/privoxy/templates/show-status-file @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -54,7 +54,7 @@ # filepath # The complete filename of the file being shown # -# +# # CONDITIONAL SYMBOLS FOR THIS TEMPLATE AND THEIR DEPANDANT SYMBOLS: # ------------------------------------------------------------------ # @@ -114,7 +114,7 @@ <pre>@contents@</pre> </td> </tr> - + <tr> <td class="box"> <h2>More Privoxy:</h2> diff --git a/external/privoxy/templates/show-url-info b/external/privoxy/templates/show-url-info index ff97c18..a5013f5 100644 --- a/external/privoxy/templates/show-url-info +++ b/external/privoxy/templates/show-url-info @@ -7,7 +7,7 @@ # Copyright : Written by and Copyright (C) 2001-2007 the SourceForge # Privoxy team. http://www.privoxy.org/ # -# This program is free software; you can redistribute it +# This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at @@ -25,13 +25,61 @@ # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # +# Revisions : +# $Log: show-url-info,v $ +# Revision 1.29 2009/01/01 17:36:41 ler762 +# remove non-standard <nobr> tags +# +# Revision 1.28 2009/01/01 14:51:21 ler762 +# keep the input field and 'go' button on the same line. +# +# Revision 1.27 2008/05/26 17:30:58 fabiankeil +# Provide an OpenSearch Description to access the +# show-url-info page through "search engine plugins". +# +# Revision 1.26 2008/05/05 10:03:06 fabiankeil +# If the provided URL isn't valid, don't show the +# cgi-editor-is-disabled and filters-might-be-ineffective +# sections. +# +# Revision 1.25 2008/04/26 10:34:18 fabiankeil +# If zlib support is unavailable and there are content filters active +# but the prevent-compression action is disabled, include a warning +# on the show-url-info page that compression might prevent filtering. +# +# Revision 1.24 2008/02/10 17:26:52 fabiankeil +# Reduce superfluous white space by not marking +# up the final results list as paragraph. +# +# Revision 1.23 2008/02/01 06:04:31 fabiankeil +# If edit buttons on the show-url-info CGI page are hidden, explain why. +# +# Revision 1.22 2007/12/08 14:29:06 fabiankeil +# Use CSS to let the URL and pattern input fields scale with +# the browser width and try to prevent vertical scroll bars +# if the width is less than 80 characters. Closes #1843596, +# thanks to Gerry Murphy and Lee. +# +# Revision 1.21 2007/11/15 19:11:11 fabiankeil +# Reword HTTPS URL information. +# +# Revision 1.20 2007/07/21 12:19:50 fabiankeil +# If show-url-info is called with an URL that Privoxy +# would reject as invalid, don't show unresolved forwarding +# variables, "final matches" or claim the site's secure. +# +# Revision 1.19 2007/02/10 16:55:22 fabiankeil +# - Show forwarding settings on the show-url-info page +# - Fix some HTML syntax errors. +# +# ######################################################################### # USING HTML TEMPLATES: # --------------------- # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -46,7 +94,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -249,12 +297,12 @@
<tr> <td class="box"> - <h2>Look up the actions for a + <h2>Look up the actions for a <!-- @if-url-given-start -->new<!-- if-url-given-end@ --> URL:</h2> <form method="GET" action="@default-cgi@show-url-info"> <p> - <input type="text" name="url" size="80" value="@url@" class="url"> + <input type="text" name="url" size="80" value="@url@" class="url"> <input type="submit" value="Go"> </p> </form> diff --git a/external/privoxy/templates/show-version b/external/privoxy/templates/show-version index 65efb5a..9bdbbba 100644 --- a/external/privoxy/templates/show-version +++ b/external/privoxy/templates/show-version @@ -7,7 +7,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -22,7 +22,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -48,7 +48,7 @@ # # redirect-url: # The URL to a script that will redirect to the Privoxy -# documentation for a given item +# documentation for a given item # invocation: # The command line with whitch Privoxy was invoked # options: @@ -61,7 +61,7 @@ # A HTML-formatted list of all conditional #defines used when # Privoxy was compiled # -# +# # CONDITIONAL SYMBOLS FOR THIS TEMPLATE AND THEIR DEPANDANT SYMBOLS: # ------------------------------------------------------------------ # @@ -120,8 +120,8 @@ <td class="box"> <h2>Source code versions:</h2> <p><i>(Note: This information is only relevant if you checked out Privoxy from CVS - and compiled it yourself. If you downloaded a binary, .exe, RPM, or a .tgz file, - then when you ask for support just mention the version number <b>@version@</b> + and compiled it yourself. If you downloaded a binary, .exe, RPM, or a .tgz file, + then when you ask for support just mention the version number <b>@version@</b> and the type of download you got.)</i> </p> <pre>@sourceversions@</pre> @@ -139,7 +139,7 @@ <td class="info">
#include mod-support-and-service - + </td> </tr>
diff --git a/external/privoxy/templates/toggle b/external/privoxy/templates/toggle index fa8ea6d..3d63eb1 100644 --- a/external/privoxy/templates/toggle +++ b/external/privoxy/templates/toggle @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -117,7 +117,7 @@ <td class="box"> <h2>Bookmarklets</h2> <p>Here are some bookmarklets to allow you to easily access a - "mini" version of this page. They are known to work with MS + "mini" version of this page. They are known to work with MS Internet Explorer, Netscape and Mozilla, but should work equally well in other browsers which support JavaScript. They are designed to run directly from your bookmarks - <b>not</b> by clicking the @@ -172,7 +172,7 @@ </td> </tr> <!-- if-have-help-info-end@ --> - + </table>
</body> diff --git a/external/privoxy/templates/toggle-mini b/external/privoxy/templates/toggle-mini index de9ad42..3b5d5c9 100644 --- a/external/privoxy/templates/toggle-mini +++ b/external/privoxy/templates/toggle-mini @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -81,7 +81,7 @@
<body> <p class="whiteframed"> - <a href="@default-cgi@" target="_blank">Privoxy</a> is + <a href="@default-cgi@" target="_blank">Privoxy</a> is <b>@if-enabled-display-then@enabled@else-not-enabled-display@disabled@endif-enabled-display@</b>. <br><a href="@default-cgi@toggle?mini=y&set=@if-enabled-display-then@disable@else-not-enabled-display@enable@endif-enabled-display@" >@if-enabled-display-then@[Disable]@else-not-enabled-display@[Enable]@endif-enabled-display@</a> | diff --git a/external/privoxy/templates/untrusted b/external/privoxy/templates/untrusted index 7bde7c5..bd4015a 100644 --- a/external/privoxy/templates/untrusted +++ b/external/privoxy/templates/untrusted @@ -8,7 +8,7 @@ # # Template files are written win plain HTML, with a few # additions: -# +# # - Lines that start with a '#' character like this one # are ignored # @@ -23,7 +23,7 @@ # strings @if-<name>start and if-<name>-end@. The strings # should be placed in HTML comments (<!-- -->), so the # html structure won't be messed when the magic happens. -# +# # USABLE SYMBOLS IN THIS TEMPLATE: # -------------------------------- # @@ -78,7 +78,7 @@ # force-support: # Privoxy has been compiled with support for forced loading # of blocked content. In that case, the symbol "force-prefix" is -# avaiable, which translates to the FORCE_PREFIX +# avaiable, which translates to the FORCE_PREFIX # have-trust-info: # There were URLs with info on the trust policy defined in the config # file. In this case the list of URLs is available through the @@ -107,9 +107,9 @@ UNTRUSTED </td> <td class="title" style="width: 100%"> - + #include mod-title - + </td> </tr>
@@ -184,7 +184,7 @@ </td> </tr> <!-- if-have-help-info-end@ --> - + </table>
</body> diff --git a/external/privoxy/tools/privoxy-log-parser.pl b/external/privoxy/tools/privoxy-log-parser.pl index 027c562..29839a4 100755 --- a/external/privoxy/tools/privoxy-log-parser.pl +++ b/external/privoxy/tools/privoxy-log-parser.pl @@ -8,7 +8,7 @@ # # http://www.fabiankeil.de/sourcecode/privoxy-log-parser/ # -# $Id: privoxy-log-parser.pl,v 1.124 2011/11/13 16:54:10 fabiankeil Exp $ +# $Id: privoxy-log-parser.pl,v 1.23 2009/03/14 15:31:58 fabiankeil Exp $ # # TODO: # - LOG_LEVEL_CGI, LOG_LEVEL_ERROR, LOG_LEVEL_WRITE content highlighting @@ -23,9 +23,8 @@ # - Handle incomplete input without Perl warning about undefined variables. # - Use generic highlighting function that takes a regex and the # hash key as input. -# - Add --compress and --decompress options. # -# Copyright (c) 2007-2010 Fabian Keil fk@fabiankeil.de +# Copyright (c) 2007-2009 Fabian Keil fk@fabiankeil.de # # Permission to use, copy, modify, and distribute this software for any # purpose with or without fee is hereby granted, provided that the above @@ -45,7 +44,7 @@ use warnings; use Getopt::Long;
use constant { - PRIVOXY_LOG_PARSER_VERSION => '0.7', + PRIVOXY_LOG_PARSER_VERSION => '0.5', # Feel free to mess with these ... DEFAULT_BACKGROUND => 'black', # Choose registered colour (like 'black') DEFAULT_TEXT_COLOUR => 'white', # Choose registered colour (like 'black') @@ -57,13 +56,10 @@ use constant { CLI_OPTION_NO_EMBEDDED_CSS => 0, CLI_OPTION_NO_MSECS => 0, CLI_OPTION_NO_SYNTAX_HIGHLIGHTING => 0, - CLI_OPTION_SHORTEN_THREAD_IDS => 0, + CLI_OPTION_ERROR_LOG_FILE => '/var/log/privoxy-log.log', CLI_OPTION_SHOW_INEFFECTIVE_FILTERS => 0, CLI_OPTION_ACCEPT_UNKNOWN_MESSAGES => 0, - CLI_OPTION_STATISTICS => 0, - CLI_OPTION_UNBREAK_LINES_ONLY => 0, - CLI_OPTION_URL_STATISTICS_THRESHOLD => 0, - CLI_OPTION_HOST_STATISTICS_THRESHOLD => 0, + CLI_OPTION_STATISTIC => 0,
SUPPRESS_SUCCEEDED_FILTER_ADDITIONS => 1, SHOW_SCAN_INTRO => 0, @@ -84,45 +80,22 @@ use constant { PUNISH_MISSING_HIGHLIGHT_KNOWLEDGE_WITH_DEATH => 1,
LOG_UNPARSED_LINES_TO_EXTRA_FILE => 0, - ERROR_LOG_FILE => '/var/log/privoxy-log-parser',
# You better leave these alone unless you know what you're doing. COLOUR_RESET => "\033[0;0m", ESCAPE => "\033[", };
-# For performance reasons, these are global. - -my $t; -my %req; # request data from previous lines -my %h; -my %thread_colours; -my @all_colours; -my @time_colours; -my $thread_colour_index = 0; -my $header_colour_index = 0; -my $time_colour_index = 0; -my %header_colours; -my $no_special_header_highlighting; -my %reason_colours; -my %h_colours; -my $header_highlight_regex = ''; - -my $html_output_mode; -my $no_msecs_mode; # XXX: should probably be removed -my $shorten_thread_ids; -my $line_end; - sub prepare_our_stuff () {
# Syntax Higlight hash - @all_colours = ( + our @all_colours = ( 'red', 'green', 'brown', 'blue', 'purple', 'cyan', 'light_gray', 'light_red', 'light_green', 'yellow', 'light_blue', 'pink', 'light_cyan', 'white' );
- %h = ( + our %h = ( # LOG_LEVEL Info => 'blue', Header => 'green', @@ -138,7 +111,6 @@ sub prepare_our_stuff () { 'Gif-Deanimate' => 'blue', Force => 'red', Writing => 'light_green', - Received => 'yellow', # ---------------------- URL => 'yellow', path => 'brown', @@ -179,13 +151,12 @@ sub prepare_our_stuff () { 'action-bits-update' => 'light_red', 'configuration-line' => 'red', 'content-type' => 'yellow', - 'HOST' => HEADER_DEFAULT_COLOUR, );
- %h_colours = %h; + our %h_colours = %h;
# Header colours need their own hash so the keys can be accessed properly - %header_colours = ( + our %header_colours = ( # Prefilled with headers that should not appear with default header colours Cookie => 'light_red', 'Set-Cookie' => 'light_red', @@ -194,11 +165,11 @@ sub prepare_our_stuff () { );
# Crunch reasons need their own hash as well - %reason_colours = ( + our %reason_colours = ( 'Unsupported HTTP feature' => 'light_red', Blocked => 'light_red', Untrusted => 'light_red', - Redirected => 'green', + Redirected => 'green', 'CGI Call' => 'white', 'DNS failure' => 'red', 'Forwarding failed' => 'light_red', @@ -207,7 +178,7 @@ sub prepare_our_stuff () { 'No reason recorded' => 'light_red', );
- @time_colours = ('white', 'light_gray'); + our @time_colours = ('white', 'light_gray');
# Translate highlight strings into highlight code prepare_highlight_hash(%header_colours); @@ -216,8 +187,6 @@ sub prepare_our_stuff () { prepare_colour_array(@all_colours); prepare_colour_array(@time_colours); init_css_colours(); - - init_stats(); }
sub paint_it ($) { @@ -232,13 +201,13 @@ sub paint_it ($) { return "" if cli_option_is_set('no-syntax-highlighting');
my %light = ( - black => 0, - red => 0, - green => 0, - brown => 0, - blue => 0, - purple => 0, - cyan => 0, + black => 0, + red => 0, + green => 0, + brown => 0, + blue => 0, + purple => 0, + cyan => 0, light_gray => 0, gray => 0, dark_gray => 1, @@ -252,13 +221,13 @@ sub paint_it ($) { );
my %text = ( - black => 30, - red => 31, - green => 32, - brown => 33, - blue => 34, - purple => 35, - cyan => 36, + black => 30, + red => 31, + green => 32, + brown => 33, + blue => 34, + purple => 35, + cyan => 36, gray => 37, light_gray => 37, dark_gray => 30, @@ -281,9 +250,9 @@ sub paint_it ($) { $colour_code .= ";"; $colour_code .= $light{$colour} ? "1" : "2"; $colour_code .= ";"; - $colour_code .= $bg_code; + $colour_code .= $bg_code; $colour_code .= "m"; - debug_message $colour . " is '" . $colour_code . $colour . $default . "'" if DEBUG_PAINT_IT; + debug_message $colour . " is '" . $colour_code . $colour . $default . "'" if DEBUG_PAINT_IT;
} elsif ($colour =~ /reset/) {
@@ -291,7 +260,7 @@ sub paint_it ($) {
} else {
- die "What's $colour supposed to mean?\n"; + die "What's $colour supposed to mean?\n"; }
return $colour_code; @@ -335,13 +304,13 @@ sub get_html_title () { sub init_css_colours() {
our %css_colours = ( - black => "000", - red => "F00", - green => "0F0", - brown => "C90", - blue => "0F0", - purple => "F06", # XXX: wrong - cyan => "F09", # XXX: wrong + black => "000", + red => "F00", + green => "0F0", + brown => "C90", + blue => "0F0", + purple => "F06", # XXX: wrong + cyan => "F09", # XXX: wrong light_gray => "999", gray => "333", dark_gray => "222", @@ -360,34 +329,38 @@ sub get_css_colour ($) { our %css_colours; my $colour = shift;
- die "What's $colour supposed to mean?\n" unless defined($css_colours{$colour}); + die "What's $colour supposed to mean?\n" unless defined($css_colours{$colour});
return '#' . $css_colours{$colour}; }
sub get_css_line ($) {
+ our %h_colours; + my $class = shift; my $css_line;
$css_line .= '.' . lc($class) . ' {'; # XXX: lc() shouldn't be necessary - die "What's $class supposed to mean?\n" unless defined($h_colours{$class}); + die "What's $class supposed to mean?\n" unless defined($h_colours{$class}); $css_line .= 'color:' . get_css_colour($h_colours{$class}) . ';'; $css_line .= 'background-color:' . get_css_colour(DEFAULT_BACKGROUND) . ';'; - $css_line .= '}' . "\n"; + $css_line .= '}' . "\n";
return $css_line; }
sub get_css_line_for_colour ($) {
+ our %h_colours; + my $colour = shift; my $css_line;
$css_line .= '.' . lc($colour) . ' {'; # XXX: lc() shouldn't be necessary $css_line .= 'color:' . get_css_colour($colour) . ';'; $css_line .= 'background-color:' . get_css_colour(DEFAULT_BACKGROUND) . ';'; - $css_line .= '}' . "\n"; + $css_line .= '}' . "\n";
return $css_line; } @@ -397,16 +370,17 @@ sub get_missing_css_lines () {
my $css_line;
- $css_line .= '.' . 'default' . ' {'; + $css_line .= '.' . 'default' . ' {'; # XXX: lc() shouldn't be necessary $css_line .= 'color:' . HEADER_DEFAULT_COLOUR . ';'; $css_line .= 'background-color:' . get_css_colour(DEFAULT_BACKGROUND) . ';'; - $css_line .= '}' . "\n"; + $css_line .= '}' . "\n";
return $css_line; }
sub get_css () {
+ our %h_colours; our %css_colours; #XXX: Wrong solution
my $css = ''; @@ -414,8 +388,8 @@ sub get_css () { $css .= '.privoxy-log {'; $css .= 'color:' . get_css_colour(DEFAULT_TEXT_COLOUR) . ';'; $css .= 'background-color:' . get_css_colour(DEFAULT_BACKGROUND) . ';'; - $css .= '}' . "\n"; - + $css .= '}' . "\n"; + foreach my $key (keys %h_colours) {
next if ($h_colours{$key} =~ m/reset/); #XXX: Wrong solution. @@ -465,7 +439,12 @@ sub print_outro () { }
sub get_line_end () { - return cli_option_is_set('html-output') ? "<br>\n" : "\n"; + + my $line_end = "\n"; + + $line_end = '<br>' . $line_end if cli_option_is_set('html-output'); + + return $line_end; }
sub get_colour_html_markup ($) { @@ -506,17 +485,17 @@ sub set_background ($){ my $colour = shift; our $bg_code; my %backgrounds = ( - black => "40", - red => "41", - green => "42", - brown => "43", - blue => "44", - magenta => "45", + black => "40", + red => "41", + green => "42", + brown => "43", + blue => "44", + magenta => "45", cyan => "46", - white => "47", - default => "49", + white => "47", + default => "49", ); - + if (defined($backgrounds{$colour})) { $bg_code = $backgrounds{$colour}; } else { @@ -531,20 +510,36 @@ sub get_background (){ sub prepare_highlight_hash ($) { my $ref = shift;
- foreach my $key (keys %$ref) { - $$ref{$key} = $html_output_mode ? - get_semantic_html_markup($key) : - paint_it($$ref{$key}); - } + if (!cli_option_is_set('html-output')) { + + foreach my $key (keys %$ref) { + $$ref{$key} = paint_it($$ref{$key}); + } + + } else { + + foreach my $key (keys %$ref) { + $$ref{$key} = get_semantic_html_markup($key); + } + + } }
sub prepare_colour_array ($) { my $ref = shift;
- foreach my $i (0 ... @$ref - 1) { - $$ref[$i] = $html_output_mode ? - get_colour_html_markup($$ref[$i]) : - paint_it($$ref[$i]); + if (!cli_option_is_set('html-output')) { + + foreach my $i (0 ... @$ref - 1) { + $$ref[$i] = paint_it($$ref[$i]); + } + + } else { + + foreach my $i (0 ... @$ref - 1) { + $$ref[$i] = get_colour_html_markup($$ref[$i]); + } + } }
@@ -553,6 +548,9 @@ sub found_unknown_content ($) { my $unknown = shift; my $message;
+ our %req; + our $t; + return if cli_option_is_set('accept-unknown-messages');
return if ($unknown =~ /[too long, truncated]$/); @@ -572,25 +570,27 @@ sub log_parse_error ($) { my $message = shift;
if (LOG_UNPARSED_LINES_TO_EXTRA_FILE) { - open(my $errorlog_fd, ">>" . ERROR_LOG_FILE) || die "Writing " . ERROR_LOG_FILE . " failed"; - print $errorlog_fd $message; - close($errorlog_fd); + open(ERRORLOG, ">>" . ERROR_LOG_FILE) || die "Writing " . ERROR_LOG_FILE . " failed"; + print ERRORLOG $message; + close(ERRORLOG); } }
sub debug_message (@) { my @message = @_; + our %h;
print $h{'debug'} . "@message" . $h{'Standard'} . "\n"; }
################################################################################ -# highlighter functions that aren't loglevel-specific +# highlighter functions that aren't loglevel-specific ################################################################################
sub h ($) {
# Get highlight marker + our %h; my $highlight = shift; # XXX: Stupid name; my $result = ''; my $message; @@ -606,20 +606,23 @@ sub h ($) { log_parser_error($message); die "Unworthy highlighter function" if PUNISH_MISSING_HIGHLIGHT_KNOWLEDGE_WITH_DEATH; } - + return $result; }
sub highlight_known_headers ($) {
my $content = shift; + our %header_colours; + our %h; + my $headers = join ('|', keys %header_colours);
debug_message("Searching $content for things to highlight.") if DEBUG_HEADER_HIGHLIGHTING;
- if ($content =~ m/(?<=\s)($header_highlight_regex):/) { + if ($content =~ m/(?<=\s)($headers):/) { my $header = $1; $content =~ s@(?<=[\s|'])($header)(?=:)@$header_colours{$header}$1$h{'Standard'}@ig; - debug_message("Highlighted '$header' in '$content'") if DEBUG_HEADER_HIGHLIGHTING; + debug_message("Highlighted $content") if DEBUG_HEADER_HIGHLIGHTING; }
return $content; @@ -639,6 +642,7 @@ sub highlight_request_line ($) {
my $rl = shift; my ($method, $url, $http_version); + our %h;
#GET http://images.sourceforge.net/sfx/icon_warning.gif HTTP/1.1 if ($rl =~ m/Invalid request/) { @@ -720,10 +724,11 @@ sub highlight_matched_url ($$) {
sub highlight_matched_host ($$) {
- my ($result, $regex) = @_; # XXX: result ist stupid name; + my $result = shift; # XXX: Stupid name; + my $regex = shift;
if ($result =~ m@(.*?)($regex)(.*)@) { - $result = $1 . $h{host} . $2 . $h{Standard} . $3; + $result = $1 . h('host') . $2 . h('Standard') . $3; }
return $result; @@ -731,6 +736,7 @@ sub highlight_matched_host ($$) {
sub highlight_matched_pattern ($$$) {
+ our %h; my $result = shift; # XXX: Stupid name; my $key = shift; my $regex = shift; @@ -760,7 +766,7 @@ sub highlight_url ($) {
my $url = shift;
- if ($html_output_mode) { + if (cli_option_is_set('html-output')) {
$url = '<a href="' . $url . '">' . $url . '</a>';
@@ -773,96 +779,96 @@ sub highlight_url ($) { return $url; }
-sub update_header_highlight_regex ($) { - - my $header = shift; - my $headers = join ('|', keys %header_colours); - - $header_highlight_regex = qr/$headers/; - print "Registering '$header'\n" if DEBUG_HEADER_HIGHLIGHTING; -} - ################################################################################ # loglevel-specific highlighter functions ################################################################################
sub handle_loglevel_header ($) {
- my $c = shift; - - if ($c =~ /^scan:/) { - - if ($c =~ m/^scan: ([^: ]+):/) { - - # Register new headers - # scan: Accept: image/png,image/*;q=0.8,*/*;q=0.5 - my $header = $1; - if (!defined($header_colours{$header}) and $header =~ /^[\d\w-]*$/) { - debug_message "Registering previously unknown header $1" if DEBUG_HEADER_REGISTERING; + my $content = shift; + my $c = $content; + our $t; + our %req; + our %h; + our %header_colours; + our @all_colours; + our $header_colour_index; + our $no_special_header_highlighting; + + # Register new headers + # scan: Accept: image/png,image/*;q=0.8,*/*;q=0.5 + if ($c =~ m/^scan: ((?>[^:]+)):/) { + my $header = $1; + if (!defined($header_colours{$header}) and $header =~ /^[\d\w-]*$/) { + debug_message "Registering previously unknown header $1" if DEBUG_HEADER_REGISTERING;
- if (REGISTER_HEADERS_WITH_THE_SAME_COLOUR) { - $header_colours{$header} = $header_colours{'Default'}; - } else { - $header_colours{$header} = $all_colours[$header_colour_index % @all_colours]; - $header_colour_index++; - } - update_header_highlight_regex($header); + if (REGISTER_HEADERS_WITH_THE_SAME_COLOUR) { + $header_colours{$header} = $header_colours{'Default'}; + } else { + $header_colours{$header} = $all_colours[$header_colour_index % @all_colours]; + $header_colour_index++; } + } + }
- } elsif ($c =~ m/^(scan: )(\w+ .+ HTTP/\d.\d)/) { + if ($c =~ m/^scan: ((\w*) (.*) (HTTP/\d.\d))/) {
- # scan: GET http://p.p/ HTTP/1.1 - $c = $1 . highlight_request_line($2); + # Client request line + # Save for statistics (XXX: Not implemented yet) + $req{$t}{'method'} = $2; + $req{$t}{'destination'} = $3; + $req{$t}{'http-version'} = $4;
- } elsif ($c =~ m/^(scan: )((?:HTTP/\d.\d|ICY) (\d+) (.*))/) { + $content = highlight_request_line($1);
- # scan: HTTP/1.1 200 OK + } elsif ($c =~ m/^(scan: )((?:HTTP/\d.\d|ICY) (\d+) (.*))/) { + + # Server response line $req{$t}{'response_line'} = $2; $req{$t}{'status_code'} = $3; $req{$t}{'status_message'} = $4; - $c = $1 . highlight_response_line($req{$t}{'response_line'}); - } + $content = $1 . highlight_response_line($req{$t}{'response_line'});
} elsif ($c =~ m/^Crunching (?:server|client) header: .* (contains: ([^)]*))/) {
# Crunching server header: Set-Cookie: trac_form_token=d5308c34e16d15e9e301a456; (contains: Cookie:) - $c =~ s@(?<=contains: )($1)@$h{'crunch-pattern'}$1$h{'Standard'}@; - $c =~ s@(Crunching)@$h{$1}$1$h{'Standard'}@; + $content =~ s@(?<=contains: )($1)@$h{'crunch-pattern'}$1$h{'Standard'}@; + $content =~ s@(Crunching)@$h{$1}$1$h{'Standard'}@;
} elsif ($c =~ m/^New host is: ([^\s]*)./) {
- # New host is: trac.vidalia-project.net. Crunching Referer: http://www.vidalia-project.net/! - $c = highlight_matched_host($c, '(?<=New host is: )[^\s]+(?=.)'); - $c = highlight_matched_url($c, '(?<=Crunching Referer: )[^\s!]+'); + # New host is: trac.vidalia-project.net. Crunching Referer: http://www.vidalia-project.net/ + $c = highlight_matched_host($c, '(?<=New host is: )[^\s]+'); + $content = highlight_matched_url($c, '(?<=Crunching Referer: )[^\s]+');
} elsif ($c =~ m/^Text mode enabled by force. (Take cover)!/) {
# Text mode enabled by force. Take cover! - $c =~ s@($1)@$h{'warning'}$1$h{'Standard'}@; + $content =~ s@($1)@$h{'warning'}$1$h{'Standard'}@;
} elsif ($c =~ m/^(New HTTP Request-Line: )(.*)/) {
# New HTTP Request-Line: GET http://www.privoxy.org/ HTTP/1.1 - $c = $1 . highlight_request_line($2); + $content = $1 . highlight_request_line($2);
} elsif ($c =~ m/^Adjust(ed)? Content-Length to \d+/) {
# Adjusted Content-Length to 2132 # Adjust Content-Length to 33533 - $c =~ s@(?<=Content-Length to )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c = highlight_known_headers($c); + $content =~ s@(?<=Content-Length to )(\d+)@$h{'Number'}$1$h{'Standard'}@; + $content = highlight_known_headers($content);
} elsif ($c =~ m/^Destination extracted from "Host:" header. New request URL:/) {
# Destination extracted from "Host:" header. New request URL: http://www.cccmz.de/~ridcully/blog/ - $c = highlight_matched_url($c, '(?<=New request URL: ).*'); + $content = highlight_matched_url($content, '(?<=New request URL: ).*');
} elsif ($c =~ m/^Couldn't parse:/) {
# XXX: These should probable be logged with LOG_LEVEL_ERROR # Couldn't parse: If-Modified-Since: Wed, 21 Mar 2007 16:34:50 GMT (crunching!) # Couldn't parse: at, 24 Mar 2007 13:46:21 GMT in If-Modified-Since: Sat, 24 Mar 2007 13:46:21 GMT (crunching!) - $c =~ s@^(Couldn't parse)@$h{'error'}$1$h{'Standard'}@; + $content =~ s@^(Couldn't parse)@$h{'error'}$1$h{'Standard'}@;
} elsif ($c =~ /^Tagger '([^']*)' added tag '([^']*)'/ or $c =~ m/^Adding tag '([^']*)' created by header tagger '([^']*)'/) { @@ -873,9 +879,9 @@ sub handle_loglevel_header ($) {
# XXX: Save tag and tagger
- $c =~ s@(?<=^Tagger ')([^']*)@$h{'tagger'}$1$h{'Standard'}@; - $c =~ s@(?<=added tag ')([^']*)@$h{'tag'}$1$h{'Standard'}@; - $c =~ s@(?<=Action bits )(updated)@$h{'action-bits-update'}$1$h{'Standard'}@; + $content =~ s@(?<=^Tagger ')([^']*)@$h{'tagger'}$1$h{'Standard'}@; + $content =~ s@(?<=added tag ')([^']*)@$h{'tag'}$1$h{'Standard'}@; + $content =~ s@(?<=Action bits )(updated)@$h{'action-bits-update'}$1$h{'Standard'}@; $no_special_header_highlighting = 1;
} elsif ($c =~ /^Tagger '([^']*)' didn['']t add tag '([^']*)'/) { @@ -883,8 +889,8 @@ sub handle_loglevel_header ($) { # Tagger 'revalidation' didn't add tag 'REVALIDATION-REQUEST'. Tag already present # XXX: Save tag and tagger
- $c =~ s@(?<=^Tagger ')([^']*)@$h{'tag'}$1$h{'Standard'}@; - $c =~ s@(?<=didn['']t add tag ')([^']*)@$h{'tagger'}$1$h{'Standard'}@; + $content =~ s@(?<=^Tagger ')([^']*)@$h{'tag'}$1$h{'Standard'}@; + $content =~ s@(?<=didn['']t add tag ')([^']*)@$h{'tagger'}$1$h{'Standard'}@;
} elsif ($c =~ m/^(?:scan:|Randomiz|addh:|Adding:|Removing:|Referer:|Modified:|Accept-Language header|[Cc]ookie)/ or $c =~ m/^(Text mode is already enabled|Denied request with NULL byte|Replaced:|add-unique:)/ @@ -906,14 +912,6 @@ sub handle_loglevel_header ($) { or $c =~ m/^Converting tab to space in / or $c =~ m/A HTTP/1.1 response without/ or $c =~ m/Disabled filter mode on behalf of the client/ - or $c =~ m/Keeping the (?:server|client) header / - or $c =~ m/Content modified with no Content-Length header set/ - or $c =~ m/^Appended client IP address to/ - or $c =~ m/^Removing 'Connection: close' to imply keep-alive./ - or $c =~ m/^keep-alive support is disabled/ - or $c =~ m/^Continue hack in da house/ - or $c =~ m/^Merged multiple header lines to:/ - or $c =~ m/^Added header: / ) { # XXX: Some of these may need highlighting @@ -952,16 +950,6 @@ sub handle_loglevel_header ($) { # this again is not' # A HTTP/1.1 response without Connection header implies keep-alive. # Disabled filter mode on behalf of the client. - # Keeping the server header 'Connection: keep-alive' around. - # Keeping the client header 'Connection: close' around. The connection will not be kept alive. - # Keeping the client header 'Connection: keep-alive' around. The connection will be kept alive if possible. - # Content modified with no Content-Length header set. Creating a fake one for adjustment later on. - # Appended client IP address to X-Forwarded-For: 10.0.0.2, 10.0.0.1 - # Removing 'Connection: close' to imply keep-alive. - # keep-alive support is disabled. Crunching: Keep-Alive: 300. - # Continue hack in da house. - # Merged multiple header lines to: 'X-FORWARDED-PROTO: http X-HOST: 127.0.0.1' - # Added header: Content-Encoding: deflate
} elsif ($c =~ m/^scanning headers for:/) {
@@ -971,21 +959,21 @@ sub handle_loglevel_header ($) { # crunched User-Agent! # Crunching: Content-Encoding: gzip
- $c =~ s@(Crunching|crunched)@$h{$1}$1$h{'Standard'}@; + $content =~ s@(Crunching|crunched)@$h{$1}$1$h{'Standard'}@;
} elsif ($c =~ m/^Offending request data with NULL bytes turned into '°' characters:/) { - + # Offending request data with NULL bytes turned into '°' characters: °°n°°(°°°
- $c = h('warning') . $c . h('Standard'); - + $content = h('warning') . $content . h('Standard'); + } elsif ($c =~ m/^(Transforming ")(.*?)(" to ")(.*?)(")/) {
# Transforming "Proxy-Authenticate: Basic realm="Correos Proxy Server"" to\ # "Proxy-Authenticate: Basic realm="Correos Proxy Server""
- $c =~ s@(?<=^Transforming ")(.*)(?=" to)@$h{'Header'}$1$h{'Standard'}@; - $c =~ s@(?<=to ")(.*)(?=")@$h{'Header'}$1$h{'Standard'}@; + $content =~ s@(?<=^Transforming ")(.*)(?=" to)@$h{'Header'}$1$h{'Standard'}@; + $content =~ s@(?<=to ")(.*)(?=")@$h{'Header'}$1$h{'Standard'}@;
} elsif ($c =~ m/^Removing empty header/) {
@@ -997,40 +985,19 @@ sub handle_loglevel_header ($) { # Content-Type: application/octet-stream not replaced. It doesn't look like text.\ # Enable force-text-mode if you know what you're doing. # XXX: Could highlight more here. - $c =~ s@(?<=^Content-Type: )(.*)(?= not replaced)@$h{'content-type'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^(Server|Client) keep-alive timeout is/) { - - # Server keep-alive timeout is 5. Sticking with 10. - # Client keep-alive timeout is 20. Sticking with 10. - - $c =~ s@(?<=timeout is )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=Sticking with )(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^Reducing keep-alive timeout/) { - - # Reducing keep-alive timeout from 60 to 10. - - $c =~ s@(?<= from )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<= to )(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^Killed all-caps Host header line: HOST:/) { - - # Killed all-caps Host header line: HOST: bestproxydb.com - $c = highlight_matched_host($c, '(?<=HOST: )[^\s]+'); - $c = highlight_matched_pattern($c, 'HOST', 'HOST'); + $content =~ s@(?<=^Content-Type: )(.*)(?= not replaced)@$h{'content-type'}$1$h{'Standard'}@;
} else {
- found_unknown_content($c); + found_unknown_content($content); }
- # Highlight headers + # Highlight headers unless ($c =~ m/^Transforming/) { - $c = highlight_known_headers($c) unless $no_special_header_highlighting; + $content = highlight_known_headers($content) unless $no_special_header_highlighting; }
- return $c; + return $content; }
sub handle_loglevel_re_filter ($) { @@ -1038,39 +1005,14 @@ sub handle_loglevel_re_filter ($) { my $content = shift; my $c = $content; my $key; - - if ($c =~ m/^(?:re_)?filtering ([^\s]+) (size (\d+)) with (?:filter )?'?([^\s]+?)'? produced (\d+) hits (new size (\d+))/) { - - # XXX: only the second version gets highlighted properly. - # re_filtering www.lfk.de/favicon.ico (size 209) with filter untrackable-hulk produced 0 hits (new size 209). - # filtering aci.blogg.de/ (size 37988) with 'blogg.de' produced 3 hits (new size 38057) - $req{$t}{'content_source'} = $1; - $req{$t}{'content_size'} = $2; - $req{$t}{'content_filter'} = $3; - $req{$t}{'content_hits'} = $4; - $req{$t}{'new_content_size'} = $5; - $req{$t}{'content_size_change'} = $req{$t}{'new_content_size'} - $req{$t}{'content_size'}; - #return '' if ($req{$t}{'content_hits'} == 0 && !cli_option_is_set('show-ineffective-filters')); - if ($req{$t}{'content_hits'} == 0 and - not (cli_option_is_set('show-ineffective-filters') - or ($req{$t}{'content_filter'} =~ m/^privoxy-filter-test$/))) { - return ''; - } - - $c =~ s@(?<=(size )(\d+))(?= with)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=(new size )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=produced )(\d+)(?= hits)@$h{'Number'}$1$h{'Standard'}@; - - $c =~ s@([^\s]+?)('? produced)@$h{'filter'}$1$h{'Standard'}$2@; - $c = highlight_matched_host($c, '(?<=filtering )[^\s]+'); - - $c =~ s@.$@ @; - $c .= "(" . $h{'Number'}; - $c .= "+" if ($req{$t}{'content_size_change'} >= 0); - $c .= $req{$t}{'content_size_change'} . $h{'Standard'} . ")"; - $content = $c; - - } elsif ($c =~ /.{3}$/ + our $t; + our %req; + our %h; + our %header_colours; + our @all_colours; + our $header_colour_index; + + if ($c =~ /.{3}$/ and $c =~ m/^(?:re_)?filtering '?(.*?)'? (size (\d*)) with (?:filter )?'?([^\s]*?)'? ?.{3}$/) {
# Used by Privoxy 3.0.5 and 3.0.6: @@ -1086,7 +1028,7 @@ sub handle_loglevel_re_filter ($) { $req{$t}{'header_filter_name'} =~ m/^privoxy-filter-test$/) { return ''; } - $content =~ s@(?<=(size )(\d+)@$h{'Number'}$1$h{'Standard'}@; + $content =~ s@(?<=(size )(\d+)@$h{'Number'}$1$h{'Standard'}@; $content =~ s@($req{$t}{'header_filter_name'})@$h{'filter'}$1$h{'Standard'}@;
} elsif ($c =~ m/^ ?... ?produced (\d*) hits (new size (\d*))./) { @@ -1104,7 +1046,7 @@ sub handle_loglevel_re_filter ($) { if ($req{$t}{'header_filter_hits'} == 0 and not (defined($req{$t}{'header_filter_name'}) and $req{$t}{'header_filter_name'} =~ m/^privoxy-filter-test$/)) { - return ''; + return ''; } # Reformat including information from the intro $c = "'" . h('filter') . $req{$t}{'header_filter_name'} . h('Standard') . "'"; @@ -1129,7 +1071,7 @@ sub handle_loglevel_re_filter ($) { }
# Highlight from last line (XXX: What?) - # $c =~ s@(?<=produced )(\d+)@$h{'Number'}$1$h{'Standard'}@; + # $c =~ s@(?<=produced )(\d+)@$h{'Number'}$1$h{'Standard'}@; # $c =~ s@($req{$t}{'header_filter_name'})@$h{'filter'}$1$h{'Standard'}@;
} else { @@ -1148,6 +1090,37 @@ sub handle_loglevel_re_filter ($) {
$content =~ s@(?<=$1 )([^\s]*)@$h{'filter'}$1$h{'Standard'}@;
+ } elsif ($c =~ m/^(?:re_)?filtering ([^\s]+) (size (\d+)) with (?:filter )?'?([^\s]+?)'? produced (\d+) hits (new size (\d+))/) { + + # XXX: only the second version gets highlighted properly. + # re_filtering www.lfk.de/favicon.ico (size 209) with filter untrackable-hulk produced 0 hits (new size 209). + # filtering aci.blogg.de/ (size 37988) with 'blogg.de' produced 3 hits (new size 38057) + $req{$t}{'content_source'} = $1; + $req{$t}{'content_size'} = $2; + $req{$t}{'content_filter'} = $3; + $req{$t}{'content_hits'} = $4; + $req{$t}{'new_content_size'} = $5; + $req{$t}{'content_size_change'} = $req{$t}{'new_content_size'} - $req{$t}{'content_size'}; + #return '' if ($req{$t}{'content_hits'} == 0 && !cli_option_is_set('show-ineffective-filters')); + if ($req{$t}{'content_hits'} == 0 and + not (cli_option_is_set('show-ineffective-filters') + or ($req{$t}{'content_filter'} =~ m/^privoxy-filter-test$/))) { + return ''; + } + + $c =~ s@(?<=(size )(\d+))(?= with)@$h{'Number'}$1$h{'Standard'}@; + $c =~ s@(?<=(new size )(\d+)@$h{'Number'}$1$h{'Standard'}@; + $c =~ s@(?<=produced )(\d+)(?= hits)@$h{'Number'}$1$h{'Standard'}@; + + $c =~ s@([^\s]+?)('? produced)@$h{'filter'}$1$h{'Standard'}$2@; + $c = highlight_matched_host($c, '(?<=filtering )[^\s]+'); + + $c =~ s@.$@ @; + $c .= "(" . $h{'Number'}; + $c .= "+" if ($req{$t}{'content_size_change'} >= 0); + $c .= $req{$t}{'content_size_change'} . $h{'Standard'} . ")"; + $content = $c; + } elsif ($c =~ m/^De-chunking successful. Shrunk from (\d+) to (\d+)/) {
$req{$t}{'chunked-size'} = $1; @@ -1195,13 +1168,6 @@ sub handle_loglevel_re_filter ($) { # Adding dynamic re_filter job s@^(?:\w*)\s+.*\s+HTTP/\d.\d\s*@IP-ADDRESS: $origin@D\ # to filter client-ip-address succeeded.
- } elsif ($c =~ m/^Compressed content from /) { - - # Compressed content from 29258 to 8630 bytes. Compression level: 3 - $content =~ s@(?<=from )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $content =~ s@(?<=to )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $content =~ s@(?<=level: )(\d+)@$h{'Number'}$1$h{'Standard'}@; - } elsif ($c =~ m/^Reading in filter/) {
return '' unless SHOW_FILTER_READIN_IN; @@ -1218,6 +1184,9 @@ sub handle_loglevel_re_filter ($) { sub handle_loglevel_redirect ($) {
my $c = shift; + our $t; + our %req; + our %h;
if ($c =~ m/^Decoding "([^""]*)"/) {
@@ -1235,11 +1204,13 @@ sub handle_loglevel_redirect ($) { $c = highlight_matched_path($c, '(?<=Checking ")[^"]*'); $c =~ s@"@@g;
- } elsif ($c =~ m/^pcrs command "([^""]*)" changed /) { + } elsif ($c =~ m/^pcrs command "([^""]*)" changed "([^""]*)" to "([^""]*)" ((\d+) hits?)/) {
- # pcrs command "s@&from=rss@@" changed \ - # "http://it.slashdot.org/article.pl?sid=07/03/02/1657247&from=rss%22%5C + # pcrs command "s@&from=rss@@" changed "http://it.slashdot.org/article.pl?sid=07/03/02/1657247&from=rss%22%5C # to "http://it.slashdot.org/article.pl?sid=07/03/02/1657247" (1 hit). + + my ($pcrs_command, $url_before, $url_after, $hits) = ($1, $2, $3, $4); # XXX: save these? + $c =~ s@(?<=pcrs command )"([^""]*)"@$h{'filter'}$1$h{'Standard'}@; $c = highlight_matched_url($c, '(?<=changed ")[^""]*'); $c =~ s@(?<=changed )"([^""]*)"@$1@; # Remove quotes @@ -1247,13 +1218,6 @@ sub handle_loglevel_redirect ($) { $c =~ s@(?<=to )"([^""]*)"@$1@; # Remove quotes $c =~ s@(\d+)(?= hits?)@$h{'hits'}$1$h{'Standard'}@;
- } elsif ($c =~ m/^pcrs command "([^""]*)" didn't change/) { - - # pcrs command "s@^http://(%5B%5E.%5D+?)/?$@http://www.bing.com/search?q=$1@" didn't \ - # change "http://www.example.org/". - $c =~ s@(?<=pcrs command )"([^""]*)"@$h{'filter'}$1$h{'Standard'}@; - $c = highlight_matched_url($c, '(?<=change ")[^""]*'); - } elsif ($c =~ m/(^New URL is: )(.*)/) {
# New URL is: http://it.slashdot.org/article.pl?sid=07/03/04/1511210 @@ -1267,11 +1231,6 @@ sub handle_loglevel_redirect ($) { # XXX: assume the same? $c = highlight_matched_url($c, '(?<=assuming that ")[^"]*');
- } elsif ($c =~ m/^Percent-encoding redirect/) { - - # Percent-encoding redirect URL: http://www.example.org/%5Cx02 - $c = highlight_matched_url($c, '(?<=redirect URL: ).*'); - } else {
found_unknown_content($c); @@ -1284,6 +1243,9 @@ sub handle_loglevel_redirect ($) { sub handle_loglevel_gif_deanimate ($) {
my $content = shift; + our $t; + our %req; + our %h;
if ($content =~ m/Success! GIF shrunk from (\d+) bytes to (\d+)./) {
@@ -1303,7 +1265,7 @@ sub handle_loglevel_gif_deanimate ($) { } elsif ($content =~ m/^failed! (gif parsing)/) {
# failed! (gif parsing) - # XXX: Replace this error message with something less stupid + # XXX: Replace this error message with something less stupid $content =~ s@(failed!)@$h{'error'}$1$h{'Standard'}@;
} elsif ($content =~ m/^Need to de-chunk first/) { @@ -1314,7 +1276,7 @@ sub handle_loglevel_gif_deanimate ($) { } elsif ($content =~ m/^(?:No GIF header found|failed while parsing)/) {
# No GIF header found (XXX: Did I ever commit this?) - # failed while parsing 195 134747048 (XXX: never committed) + # failed while parsing 195 134747048 (XXX: never commited)
# Ignore these for now
@@ -1330,6 +1292,10 @@ sub handle_loglevel_gif_deanimate ($) { sub handle_loglevel_request ($) {
my $content = shift; + our $t; + our %req; + our %h; + our %reason_colours;
if ($content =~ m/crunch! /) {
@@ -1358,13 +1324,15 @@ sub handle_loglevel_request ($) { found_unknown_content($content);
} - + return $content; }
sub handle_loglevel_crunch ($) {
my $content = shift; + our %h; + our %reason_colours;
# Highlight crunch reason foreach my $reason (keys %reason_colours) { @@ -1389,6 +1357,9 @@ sub handle_loglevel_crunch ($) { sub handle_loglevel_connect ($) {
my $c = shift; + our $t; + our %req; + our %h;
if ($c =~ m/^via [^\s]+ to: [^\s]+/) {
@@ -1405,10 +1376,9 @@ sub handle_loglevel_connect ($) {
$c =~ s@(?<=failed: )(.*)@$h{'error'}$1$h{'Standard'}@;
- } elsif ($c =~ m/^to ([^\s]*)( successful)?$/) { + } elsif ($c =~ m/^to ([^\s]*) successful$/) {
# Connect: to www.nzherald.co.nz successful - # Connect: to archiv.radiotux.de
return '' if SUPPRESS_SUCCESSFUL_CONNECTIONS; $c = highlight_matched_host($c, '(?<=to )[^\s]+'); @@ -1470,7 +1440,7 @@ sub handle_loglevel_connect ($) { $c = highlight_matched_host($c, '(?<=from )[^\s]+'); # XXX: not an URL
} elsif ($c =~ m/^socks5_connect:/) { - + $c =~ s@(?<=socks5_connect: )(.*)@$h{'error'}$1$h{'Standard'}@;
} elsif ($c =~ m/^Created new connection to/) { @@ -1479,18 +1449,12 @@ sub handle_loglevel_connect ($) { $c = highlight_matched_host($c, '(?<=connection to )[^\s]+'); $c =~ s@(?<=on socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
- } elsif ($c =~ m/^Found reusable socket/) { + } elsif ($c =~ m/^^Found reusable socket/) {
# Found reusable socket 9 for www.privoxy.org:80 in slot 0. - # 3.0.15 and later: - # Found reusable socket 8 for www.privoxy.org:80 in slot 2.\ - # Timestamp made 0 seconds ago. Timeout: 1. Latency: 0. $c =~ s@(?<=Found reusable socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; $c = highlight_matched_host($c, '(?<=for )[^\s]+'); $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=made )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=Timeout: )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=Latency: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
} elsif ($c =~ m/^Marking open socket/) {
@@ -1508,7 +1472,6 @@ sub handle_loglevel_connect ($) {
# Remembering socket 13 for www.privoxy.org:80 in slot 0. # Forgetting socket 38 for www.privoxy.org:80 in slot 5. - $c =~ s@(?<=socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; $c = highlight_matched_host($c, '(?<=for )[^\s]+'); $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@; @@ -1521,22 +1484,13 @@ sub handle_loglevel_connect ($) { } elsif ($c =~ m/^The connection to/) {
# The connection to www.privoxy.org:80 in slot 6 timed out. Closing socket 19. Timeout is: 61. - # 3.0.15 and later: - # The connection to 1.bp.blogspot.com:80 in slot 0 timed out. Closing socket 5.\ - # Timeout is: 1. Assumed latency: 4. # The connection to 10.0.0.1:80 in slot 0 is no longer usable. Closing socket 4. $c = highlight_matched_host($c, '(?<=connection to )[^\s]+'); $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@; $c =~ s@(?<=Closing socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; $c =~ s@(?<=Timeout is: )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=Assumed latency: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
- } elsif ($c =~ m/^Stopped waiting for the request line./) { - - # Stopped waiting for the request line. Timeout: 121. - $c =~ s@(?<=Timeout: )(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^Waiting for \d/) { + } elsif ($c =~ m/^Waiting for/) {
# Waiting for 1 connections to timeout. $c =~ s@(?<=^Waiting for )(\d+)@$h{'Number'}$1$h{'Standard'}@; @@ -1550,14 +1504,9 @@ sub handle_loglevel_connect ($) {
# Done reading from server. Expected content length: 24892. \ # Actual content length: 24892. Most recently received: 4412. - # 3.0.15 and later: - # Done reading from server. Expected content length: 24892. \ - # Actual content length: 24892. Bytes most recently read: 4412. - # Done reading from server. Content length: 6018 as expected. \ - # Bytes most recently read: 294. - $c =~ s@(?<=ontent length: )(\d+)@$h{'Number'}$1$h{'Standard'}@g; + $c =~ s@(?<=Expected content length: )(\d+)@$h{'Number'}$1$h{'Standard'}@; + $c =~ s@(?<=Actual content length: )(\d+)@$h{'Number'}$1$h{'Standard'}@; $c =~ s@(?<=received: )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=read: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
} elsif ($c =~ m/^Continuing buffering headers/) {
@@ -1565,9 +1514,6 @@ sub handle_loglevel_connect ($) { $c =~ s@(?<=byte_count: )(\d+)@$h{'Number'}$1$h{'Standard'}@; $c =~ s@(?<=header_offset: )(\d+)@$h{'Number'}$1$h{'Standard'}@; $c =~ s@(?<=len: )(\d+)@$h{'Number'}$1$h{'Standard'}@; - # 3.0.15 and later: - # Continuing buffering headers. Bytes most recently read: %d. - $c =~ s@(?<=read: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
} elsif ($c =~ m/^Received \d+ bytes while/) {
@@ -1575,126 +1521,27 @@ sub handle_loglevel_connect ($) { $c =~ s@(?<=Received )(\d+)@$h{'Number'}$1$h{'Standard'}@; $c =~ s@(?<=expecting )(\d+)@$h{'Number'}$1$h{'Standard'}@;
- } elsif ($c =~ m/^(Rejecting c|C)onnection from/) { + } elsif ($c =~ m/^Connection from/) {
# Connection from 81.163.28.218 dropped due to ACL - # Rejecting connection from 178.63.152.227. Maximum number of connections reached. - $c =~ s@(?<=onnection from )((?:\d+.?){3}\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^(?:Reusing|Closing) server socket \d./ or - $c =~ m/^No additional client request/) { - - # Reusing server socket 4. Opened for 10.0.0.1. - # Closing server socket 2. Opened for 10.0.0.1. - # No additional client request received in time. \ - # Closing server socket 4, initially opened for 10.0.0.1. - # No additional client request received in time on socket 29. - - $c =~ s@(?<= socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c = highlight_matched_host($c, '(?<=for )[^\s]+(?=.$)'); - - } elsif ($c =~ m/^Connected to /) { - - # Connected to tor-jail[10.0.0.2]:9050. - - $c = highlight_matched_host($c, '(?<=[)[^]]+'); - $c = highlight_matched_host($c, '(?<=Connected to )[^[\s]+'); - $c =~ s@(?<=]:)(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^Could not connect to /) { - - # Could not connect to [10.0.0.1]:80. - - $c = highlight_matched_host($c, '(?<=[)[^]]+'); - $c =~ s@(?<=]:)(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^Waiting for the next client request/ or - $c =~ m/^The connection on server socket/ or - $c =~ m/^Client request arrived in time /) { - - # Waiting for the next client request on socket 3. Keeping the server \ - # socket 12 to a.fsdn.com open. - # The connection on server socket 6 to upload.wikimedia.org isn't reusable. Closing. - # Used by Privoxy 3.0.18 and later: - # Client request arrived in time on socket 21. - # Used by earlier version: - # Client request arrived in time or the client closed the connection on socket 12. - - $c =~ s@(?<=on socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c = highlight_matched_host($c, '(?<=to )[^\s]+'); - - } elsif ($c =~ m/^Marking the server socket/) { - - # Marking the server socket 7 tainted. - - $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^Reduced expected bytes to /) { - - # Reduced expected bytes to 0 to account for the 1542 ones we already got. - $c =~ s@(?<=bytes to )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=for the )(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^The client closed socket /) { - - # The client closed socket 2 while the server socket 4 is still open. - $c =~ s@(?<=closed socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^Expected client content length set /) { - - # Expected client content length set to 667325411 after reading 4999 bytes. - $c =~ s@(?<=set to )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=reading )(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^Reducing expected bytes to /) { - - # Reducing expected bytes to 0. Marking the server socket tainted after throwing 4 bytes away. - $c =~ s@(?<=bytes to )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=after throwing )(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^Waiting for up to /) { - - # Waiting for up to 4999 bytes from the client. - $c =~ s@(?<=up to )(\d+)@$h{'Number'}$1$h{'Standard'}@; + $c =~ s@(?<=^Connection from )((?:\d+.?){4})@$h{'Number'}$1$h{'Standard'}@;
- } elsif ($c =~ m/^Looks like we / or + } elsif ($c =~ m/^Looks like we rea/ or $c =~ m/^Unsetting keep-alive flag/ or - $c =~ m/^No connections to wait/ or - $c =~ m/^Complete client request received/ or - $c =~ m/^Possible pipeline attempt detected./ or - $c =~ m/^POST request detected. The connection will not be kept alive./ or - $c =~ m/^The server still wants to talk, but the client hung up on us./ or - $c =~ m/^The server didn't specify how long the connection will stay open/ or - $c =~ m/^There might be a request body. The connection will not be kept alive/ or - $c =~ m/^Stopping to watch the client socket. There's already another request waiting./ or - $c =~ m/^Done reading from the client.$/) { + $c =~ m/^No connections to wait/) {
# Looks like we reached the end of the last chunk. We better stop reading. # Looks like we read the end of the last chunk together with the server \ # headers. We better stop reading. - # Looks like we got the last chunk together with the server headers. \ - # We better stop reading. # Unsetting keep-alive flag. # No connections to wait for left. - # Client request arrived in time or the client closed the connection. - # Complete client request received - # Possible pipeline attempt detected. The connection will not be \ - # kept alive and we will only serve the first request. - # POST request detected. The connection will not be kept alive. - # The server still wants to talk, but the client hung up on us. - # The server didn't specify how long the connection will stay open. Assume it's only a second. - # There might be a request body. The connection will not be kept alive. - # Stopping to watch the client socket. There's already another request waiting. - # Done reading from the client.
} else {
found_unknown_content($c);
} - + return $c; }
@@ -1702,7 +1549,10 @@ sub handle_loglevel_connect ($) { sub handle_loglevel_info ($) {
my $c = shift; - + our $t; + our %req; + our %h; + if ($c =~ m/^Rewrite detected:/) {
# Rewrite detected: GET http://10.0.0.2:88/blah.txt HTTP/1.1 @@ -1710,15 +1560,12 @@ sub handle_loglevel_info ($) {
} elsif ($c =~ m/^Decompress(ing deflated|ion didn)/ or $c =~ m/^Compressed content detected/ or - $c =~ m/^SDCH-compressed content detected/ or $c =~ m/^Tagger/ ) { # Decompressing deflated iob: 117 # Decompression didn't result in any content. # Compressed content detected, content filtering disabled. Consider recompiling Privoxy\ # with zlib support or enable the prevent-compression action. - # SDCH-compressed content detected, content filtering disabled.\ - # Consider suppressing SDCH offers made by the client. # Tagger 'complete-url' created empty tag. Ignored.
# Ignored for now @@ -1729,19 +1576,13 @@ sub handle_loglevel_info ($) { # Reloading configuration file '/usr/local/etc/privoxy/config' $c =~ s@(?<=loading configuration file ')([^']*)@$h{'file'}$1$h{'Standard'}@;
- } elsif ($c =~ m/^Loading (actions|filter) file: /) { - - # Loading actions file: /usr/local/etc/privoxy/default.action - # Loading filter file: /usr/local/etc/privoxy/default.filter - $c =~ s@(?<= file: )(.*)$@$h{'file'}$1$h{'Standard'}@; - } elsif ($c =~ m/^exiting by signal/) { - + # exiting by signal 15 .. bye $c =~ s@(?<=exiting by signal )(\d+)@$h{'signal'}$1$h{'Standard'}@;
} elsif ($c =~ m/^Privoxy version/) { - + # Privoxy version 3.0.7 $c =~ s@(?<=^Privoxy version )(\d+.\d+.\d+)$@$h{'version'}$1$h{'Standard'}@;
@@ -1765,15 +1606,12 @@ sub handle_loglevel_info ($) {
# Request from 10.0.0.1 denied. limit-connect{,} doesn't allow CONNECT requests to port 443. # Request from 10.0.0.1 marked for blocking. limit-connect{,} doesn't allow CONNECT requests to port 443. - # 3.0.18 and later: - # Request from 10.0.0.1 marked for blocking. limit-connect{0} doesn't allow CONNECT requests to www.example.org:443 # Malformed server response detected. Downgrading to HTTP/1.0 impossible.
$c =~ s@(?<=Request from )([^\s]*)@$h{'ip-address'}$1$h{'Standard'}@; $c =~ s@(denied|blocking)@$h{'warning'}$1$h{'Standard'}@; $c =~ s@(CONNECT)@$h{'method'}$1$h{'Standard'}@; $c =~ s@(?<=to port )(\d+)@$h{'port'}$1$h{'Standard'}@; - $c =~ s@(?<=to )([^\s]+)@$h{'request_'}$1$h{'Standard'}@;
} elsif ($c =~ m/^Status code/) {
@@ -1791,17 +1629,11 @@ sub handle_loglevel_info ($) { $c =~ s@(?<=Needed: )(\d+)@$h{'Number'}$1$h{'Standard'}@; $c =~ s@(?<=Limit: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
- } elsif ($c =~ m/^File modification detected: /) { - - # File modification detected: /usr/local/etc/privoxy/user-agent.action - $c =~ s@(?<= detected: )(.*)$@$h{'file'}$1$h{'Standard'}@; - } elsif ($c =~ m/^No logfile configured/ or $c =~ m/^Malformerd HTTP headers detected and MS IIS5 hack enabled/ or $c =~ m/^Invalid "chunked" transfer/ or $c =~ m/^Support for/ or - $c =~ m/^Flushing header and buffers/ or - $c =~ m/^Can not resolve/ + $c =~ m/^Flushing header and buffers/ ) {
# No logfile configured. Please enable it before reporting any problems. @@ -1812,7 +1644,6 @@ sub handle_loglevel_info ($) { # Support for 'Connection: keep-alive' is experimental, incomplete and\ # known not to work properly in some situations. # Flushing header and buffers. Stepping back from filtering. - # Can not resolve doesnotexist: hostname nor servname provided, or not known
} else {
@@ -1826,13 +1657,16 @@ sub handle_loglevel_info ($) { sub handle_loglevel_cgi ($) {
my $c = shift; + our $t; + our %req; + our %h;
if ($c =~ m/^Granting access to/) { - + #Granting access to http://config.privoxy.org/send-stylesheet, referrer http://p.p/ is trustworthy.
} elsif ($c =~ m/^Substituting: s(.)/) { - + # Substituting: s/@else-not-FEATURE_ZLIB@.*@endif-FEATURE_ZLIB@//sigTU # XXX: prone to span several lines
@@ -1848,15 +1682,18 @@ sub handle_loglevel_cgi ($) { sub handle_loglevel_force ($) {
my $c = shift; + our $t; + our %req; + our %h;
if ($c =~ m/^Ignored force prefix in request:/) { - + # Ignored force prefix in request: "GET http://10.0.0.1/PRIVOXY-FORCE/block HTTP/1.1" $c =~ s@^(Ignored)@$h{'ignored'}$1$h{'Standard'}@; $c = highlight_matched_request_line($c, '(?<=request: ")[^"]*');
} elsif ($c =~ m/^Enforcing request:/) { - + # Enforcing request: "GET http://10.0.0.1/block HTTP/1.1". $c = highlight_matched_request_line($c, '(?<=request: ")[^"]*');
@@ -1869,248 +1706,10 @@ sub handle_loglevel_force ($) { return $c; }
-sub handle_loglevel_error ($) { - - my $c = shift; - - if ($c =~ m/^(?:Empty|No) server or forwarder response received on socket \d+./) { - - # Empty server or forwarder response received on socket 4. - # Empty server or forwarder response received on socket 3. \ - # Closing client socket 15 without sending data. - # Used by Privoxy 3.0.18 and later: - # No server or forwarder response received on socket 8. \ - # Closing client socket 10 without sending data. - - $c =~ s@(?<=on socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; - $c =~ s@(?<=client socket )(\d+)@$h{'Number'}$1$h{'Standard'}@; - - } elsif ($c =~ m/^Didn't receive data in time:/) { - - # Didn't receive data in time: a.fsdn.com:443 - $c =~ s@(?<=in time: )(.*)@$h{'destination'}$1$h{'Standard'}@; - } - - # XXX: There are probably more messages that deserve highlighting. - - return $c; -} - - sub handle_loglevel_ignore ($) { return shift; }
-sub gather_loglevel_request_stats ($$) { - my $c = shift; - my $thread = shift; - our %stats; - - $stats{requests}++; -} - -sub gather_loglevel_crunch_stats ($$) { - my $c = shift; - my $thread = shift; - our %stats; - - $stats{requests}++; - $stats{crunches}++; - - if ($c =~ m/^Redirected:/) { - # Redirected: http://www.example.org/http://p.p/ - $stats{'fast-redirections'}++; - - } elsif ($c =~ m/^Blocked:/) { - # Blocked: blogger.googleusercontent.com:443 - $stats{'blocked'}++; - } -} - - -sub gather_loglevel_error_stats ($$) { - - my $c = shift; - my $thread = shift; - our %stats; - our %thread_data; - - if ($c =~ m/^Empty server or forwarder response received on socket \d+./) { - - # Empty server or forwarder response received on socket 4. - $stats{'empty-responses'}++; - if ($thread_data{$thread}{'new_connection'}) { - $stats{'empty-responses-on-new-connections'}++; - } else { - $stats{'empty-responses-on-reused-connections'}++; - } - } -} - -sub gather_loglevel_connect_stats ($$) { - - my ($c, $thread) = @_; - our %thread_data; - our %stats; - - if ($c =~ m/^via ([^\s]+) to: [^\s]+/) { - - # Connect: via 10.0.0.1:8123 to: www.example.org.noconnect - $thread_data{$thread}{'forwarder'} = $1; # XXX: is this missue? - - } elsif ($c =~ m/^to ([^\s]*)$/) { - - # Connect: to lists.sourceforge.net:443 - - $thread_data{$thread}{'forwarder'} = 'direct connection'; - - } elsif ($c =~ m/^Created new connection to/) { - - # Created new connection to www.privoxy.org:80 on socket 11. - - $thread_data{$thread}{'new_connection'} = 1; - - } elsif ($c =~ m/^Reusing server socket \d./ or - $c =~ m/^Found reusable socket/) { - - # Reusing server socket 4. Opened for 10.0.0.1. - # Found reusable socket 9 for www.privoxy.org:80 in slot 0. - - $thread_data{$thread}{'new_connection'} = 0; - $stats{'reused-connections'}++; - } -} - -sub gather_loglevel_header_stats ($$) { - - my ($c, $thread) = @_; - our %stats; - - if ($c =~ m/^A HTTP/1.1 response without/ or - $c =~ m/^Keeping the server header 'Connection: keep-alive' around./) - { - # A HTTP/1.1 response without Connection header implies keep-alive. - # Keeping the server header 'Connection: keep-alive' around. - $stats{'server-keep-alive'}++; - - } elsif ($c =~ m/^scan: ((\w+) (.+) (HTTP/\d.\d))/) { - - # scan: HTTP/1.1 200 OK - $stats{'method'}{$2}++; - $stats{'ressource'}{$3}++; - $stats{'http-version'}{$4}++; - - } elsif ($c =~ m/^scan: Host: ([^\s]+)/) { - - # scan: Host: p.p - $stats{'hosts'}{$1}++; - } -} - -sub init_stats () { - our %stats = ( - requests => 0, - crunches => 0, - 'server-keep-alive' => 0, - 'reused-connections' => 0, - 'empty-responses' => 0, - 'empty-responses-on-new-connections' => 0, - 'empty-responses-on-reused-connections' => 0, - 'fast-redirections' => 0, - 'blocked' => 0, - 'reused-connections' => 0, - 'server-keep-alive' => 0, - ); -} - -sub get_percentage ($$) { - my $big = shift; - my $small = shift; - return "NaN" if ($big eq 0); - return sprintf("%.2f%%", $small / $big * 100); -} - -sub print_stats () { - - our %stats; - our %cli_options; - my $new_connections = $stats{requests} - $stats{crunches} - $stats{'reused-connections'}; - my $outgoing_requests = $stats{requests} - $stats{crunches}; - - if ($stats{requests} eq 0) { - print "No requests yet.\n"; - return; - } - - print "Client requests total: " . $stats{requests} . "\n"; - print "Crunches: " . $stats{crunches} . " (" . - get_percentage($stats{requests}, $stats{crunches}) . ")\n"; - print "Blocks: " . $stats{'blocked'} . " (" . - get_percentage($stats{requests}, $stats{'blocked'}) . ")\n"; - print "Fast redirections: " . $stats{'fast-redirections'} . " (" . - get_percentage($stats{requests}, $stats{'fast-redirections'}) . ")\n"; - print "Outgoing requests: " . $outgoing_requests . " (" . - get_percentage($stats{requests}, $outgoing_requests) . ")\n"; - print "Server keep-alive offers: " . $stats{'server-keep-alive'} . " (" . - get_percentage($stats{requests}, $stats{'server-keep-alive'}) . ")\n"; - print "New outgoing connections: " . $new_connections . " (" . - get_percentage($stats{requests}, $new_connections) . ")\n"; - print "Reused connections: " . $stats{'reused-connections'} . " (" . - get_percentage($stats{requests}, $stats{'reused-connections'}) . - "; server offers accepted: " . - get_percentage($stats{'server-keep-alive'}, $stats{'reused-connections'}) . ")\n"; - print "Empty responses: " . $stats{'empty-responses'} . " (" . - get_percentage($stats{requests}, $stats{'empty-responses'}) . ")\n"; - print "Empty responses on new connections: " - . $stats{'empty-responses-on-new-connections'} . " (" . - get_percentage($stats{requests}, $stats{'empty-responses-on-new-connections'}) - . ")\n"; - print "Empty responses on reused connections: " . - $stats{'empty-responses-on-reused-connections'} . " (" . - get_percentage($stats{requests}, $stats{'empty-responses-on-reused-connections'}) . - ")\n"; - - if ($stats{method} eq 0) { - print "No response lines parsed yet yet.\n"; - return; - } - print "Method distribution:\n"; - foreach my $method (sort {$stats{'method'}{$b} <=> $stats{'method'}{$a}} keys %{$stats{'method'}}) { - printf "%8d : %-8s\n", $stats{'method'}{$method}, $method; - } - print "Client HTTP versions:\n"; - foreach my $http_version (sort {$stats{'http-version'}{$b} <=> $stats{'http-version'}{$a}} keys %{$stats{'http-version'}}) { - printf "%d : %s\n", $stats{'http-version'}{$http_version}, $http_version; - } - - if ($cli_options{'url-statistics-threshold'} == 0) { - print "URL statistics are disabled. Increase --url-statistics-threshold to enable them.\n"; - } else { - print "Requested URLs:\n"; - foreach my $ressource (sort {$stats{'ressource'}{$b} <=> $stats{'ressource'}{$a}} keys %{$stats{'ressource'}}) { - if ($stats{'ressource'}{$ressource} < $cli_options{'url-statistics-threshold'}) { - print "Skipped statistics for URLs below the treshold.\n"; - last; - } - printf "%d : %s\n", $stats{'ressource'}{$ressource}, $ressource; - } - } - - if ($cli_options{'host-statistics-threshold'} == 0) { - print "Host statistics are disabled. Increase --host-statistics-threshold to enable them.\n"; - } else { - print "Requested Hosts:\n"; - foreach my $host (sort {$stats{'hosts'}{$b} <=> $stats{'hosts'}{$a}} keys %{$stats{'hosts'}}) { - if ($stats{'hosts'}{$host} < $cli_options{'host-statistics-threshold'}) { - print "Skipped statistics for Hosts below the treshold.\n"; - last; - } - printf "%d : %s\n", $stats{'hosts'}{$host}, $host; - } - } -} - - ################################################################################ # Functions that actually print stuff ################################################################################ @@ -2118,6 +1717,7 @@ sub print_stats () { sub print_clf_message () {
our ($ip, $timestamp, $request_line, $status_code, $size); + our %h; my $output = '';
return if DEBUG_SUPPRESS_LOG_MESSAGES; @@ -2132,91 +1732,109 @@ sub print_clf_message () { $output .= $h{'Status'} . $status_code . $h{'Standard'}; $output .= " "; $output .= $h{'Number'} . $size . $h{'Standard'}; - $output .= $line_end; + $output .= get_line_end();
print $output; }
sub print_non_clf_message ($) {
+ our %req; + our %thread_colours; + our %h; + our $t; + our $time_colour_index; + our @time_colours; + my $output; my $content = shift; - my $msec_string = "." . $req{$t}{'msecs'} unless $no_msecs_mode; - my $line_start = $html_output_mode ? '' : $h{"Standard"}; + my ($day, $time_stamp, $msecs, $thread, $log_level) + = ($req{$t}{'day'}, $req{$t}{'time-stamp'}, $req{$t}{'msecs'}, $t, $req{$t}{'log-level'} );
return if DEBUG_SUPPRESS_LOG_MESSAGES;
- print $line_start - . $time_colours[$time_colour_index % 2] - . $req{$t}{'time-stamp'} - . $msec_string - . $h{Standard} . " " - . $thread_colours{$t} - . $t - . $h{Standard} - . " " - . $h{$req{$t}{'log-level'}} - . $req{$t}{'log-level'} - . $h{Standard} - . ": " - . $content - . $line_end; -} - -sub shorten_thread_id ($) { - - my $thread_id = shift; + $output .= $h{"Standard"} unless cli_option_is_set('html-output'); + # $output .= "$day "; + $output .= $time_colours[$time_colour_index % 2];
- our %short_thread_ids; - our $max_threadid; - - unless (defined $short_thread_ids{$thread_id}) { - $short_thread_ids{$thread_id} = sprintf "%.3d", $max_threadid++; - } + $output .= $time_stamp; + $output .= ".$msecs" unless cli_option_is_set('no-msecs'); + $output .= $h{"Standard"}; + $output .= " "; + $output .= $thread_colours{$thread} if (defined($thread_colours{$thread})); + $output .= $thread; + $output .= $h{"Standard"} . " "; + $output .= $h{$log_level} if (defined($h{$log_level})); + $output .= $log_level; + $output .= $h{"Standard"} . ": "; + $output .= "$content"; + $output .= get_line_end();
- return $short_thread_ids{$thread_id} + print $output; }
sub parse_loop () {
+ our $t; + our %req; # request data from previous lines + our %h; + our %thread_colours; + our @all_colours; + our @time_colours; + our $thread_colour_index = 0; + our $header_colour_index = 0; + our $time_colour_index = 0; + my ($day, $time_stamp, $thread, $log_level, $content, $c, $msecs); my $last_msecs = 0; my $last_thread = 0; my $last_timestamp = 0; + my $output; my $filters_that_did_nothing; my $key; my $time_colour; + our $no_special_header_highlighting; $time_colour = paint_it('white'); + my %log_level_count;
my %log_level_handlers = ( - 'Re-Filter' => &handle_loglevel_re_filter, - 'Header' => &handle_loglevel_header, - 'Connect' => &handle_loglevel_connect, - 'Redirect' => &handle_loglevel_redirect, - 'Request' => &handle_loglevel_request, - 'Crunch' => &handle_loglevel_crunch, - 'Gif-Deanimate' => &handle_loglevel_gif_deanimate, - 'Info' => &handle_loglevel_info, - 'CGI' => &handle_loglevel_cgi, - 'Force' => &handle_loglevel_force, - 'Error' => &handle_loglevel_error, - 'Fatal error' => &handle_loglevel_ignore, - 'Writing' => &handle_loglevel_ignore, - 'Received' => &handle_loglevel_ignore, - 'Unknown log level' => &handle_loglevel_ignore, + 'Re-Filter' => &handle_loglevel_re_filter, + 'Header' => &handle_loglevel_header, + 'Connect' => &handle_loglevel_connect, + 'Redirect' => &handle_loglevel_redirect, + 'Request' => &handle_loglevel_request, + 'Crunch' => &handle_loglevel_crunch, + 'Gif-Deanimate' => &handle_loglevel_gif_deanimate, + 'Info' => &handle_loglevel_info, + 'CGI' => &handle_loglevel_cgi, + 'Force' => &handle_loglevel_force, + 'Error' => &handle_loglevel_ignore, + 'Fatal error' => &handle_loglevel_ignore, + 'Writing' => &handle_loglevel_ignore, );
while (<>) { + + $output = '';
- if (m/^(\d{4}-\d{2}-\d{2}|\w{3} \d{2}) (\d\d:\d\d:\d\d).?(\d+)? (?:Privoxy()?([^)\s]*)[)]? ([\w -]*): (.*?)\r?$/) { - $thread = $t = ($shorten_thread_ids) ? shorten_thread_id($4) : $4; - $req{$t}{'day'} = $day = $1; - $req{$t}{'time-stamp'} = $time_stamp = $2; - $req{$t}{'msecs'} = $msecs = $3 ? $3 : 0; # Only the cool kids have micro second resolution; - $req{$t}{'log-level'} = $log_level = $5; - $req{$t}{'content'} = $content = $c = $6; + if (m/^(\w{3} \d{2}) (\d\d:\d\d:\d\d).?(\d+)? (?:Privoxy()?([^)\s]*)[)]? ([\w -]*): (.*)$/) { + # XXX: Put in req hash? + $day = $1; + $time_stamp = $2; + $msecs = $3 ? $3 : 0; # Only the cool kids have micro second resolution + $log_level = $5; + $content = $c = $6; + $thread = $t = $4; + + $req{$t}{'day'} = $day; + $req{$t}{'time-stamp'} = $time_stamp; + $req{$t}{'msecs'} = $msecs; # Only the cool kids have micro second resolution; + $req{$t}{'log-level'} = $log_level; + $req{$t}{'content'} = $content; $req{$t}{'log-message'} = $_; $no_special_header_highlighting = 0;
+ $log_level_count{$log_level}++; + if (defined($log_level_handlers{$log_level})) {
$content = $log_level_handlers{$log_level}($content); @@ -2224,11 +1842,12 @@ sub parse_loop () { } else {
die "No handler found for log level "$log_level"\n"; + }
- # Highlight Truncations - if (length($_) > 4000) { - $content =~ s@(too long, truncated)]$@$h{'Truncation'}$1$h{'Standard'}]@g; + # Highlight Truncations + if (m/... [(too long, truncated)/) { + $content =~ s@($1)@$h{'Truncation'}$1$h{'Standard'}@g; }
next unless $content; @@ -2240,19 +1859,19 @@ sub parse_loop () { }
# Switch timestamp colour if timestamps differ - if (($msecs ne $last_msecs) || ($time_stamp ne $last_timestamp)) { + if ($msecs != $last_msecs || !($time_stamp =~ m/$last_timestamp/)) { debug_message("Tick tack!") if DEBUG_TICKS; - $time_colour = $time_colours[$time_colour_index % 2]; - $time_colour_index++; - $last_msecs = $msecs; - $last_timestamp = $time_stamp; + $time_colour = $time_colours[$time_colour_index % 2]; + $time_colour_index++ }
+ $last_msecs = $msecs; $last_thread = $thread; + $last_timestamp = $time_stamp;
print_non_clf_message($content);
- } elsif (m/^((?:\d+.\d+.\d+.\d+|[:\d]+)) - - [(.*)] "(.*)" (\d+) (\d+)/) { + } elsif (m/^(\d+.\d+.\d+.\d+) - - [(.*)] "(.*)" (\d+) (\d+)/) {
# LOG_LEVEL_CLF lines look like this # 61.152.239.32 - - [04/Mar/2007:18:28:23 +0100] "GET \ @@ -2261,7 +1880,7 @@ sub parse_loop () { our ($ip, $timestamp, $request_line, $status_code, $size) = ($1, $2, $3, $4, $5);
print_clf_message(); - + } else {
# Some Privoxy log messages span more than one line, @@ -2273,83 +1892,19 @@ sub parse_loop () { } } } -}
-sub stats_loop () { - - my ($day, $time_stamp, $msecs, $thread, $log_level, $content); - my %log_level_handlers = ( - 'Re-Filter' => &handle_loglevel_ignore, - 'Header' => &gather_loglevel_header_stats, - 'Connect' => &gather_loglevel_connect_stats, - 'Redirect' => &handle_loglevel_ignore, - 'Request' => &gather_loglevel_request_stats, - 'Crunch' => &gather_loglevel_crunch_stats, - 'Gif-Deanimate' => &handle_loglevel_ignore, - 'Info' => &handle_loglevel_ignore, - 'CGI' => &handle_loglevel_ignore, - 'Force' => &handle_loglevel_ignore, - 'Error' => &gather_loglevel_error_stats, - 'Fatal error' => &handle_loglevel_ignore, - 'Writing' => &handle_loglevel_ignore, - 'Received' => &handle_loglevel_ignore, - 'Unknown log level' => &handle_loglevel_ignore - ); - - while (<>) { - if (m/^(\d{4}-\d{2}-\d{2}|\w{3} \d{2}) (\d\d:\d\d:\d\d).?(\d+)? (?:Privoxy()?([^)\s]*)[)]? ([\w -]*): (.*?)\r?$/) { - $day = $1; - $time_stamp = $2; - $msecs = $3 ? $3 : 0; - $thread = $4; - $log_level = $5; - $content = $6; - - if (defined($log_level_handlers{$log_level})) { - - $content = $log_level_handlers{$log_level}($content, $thread); - - } else { - - die "No handler found for log level "$log_level"\n"; - - } + if (cli_option_is_set('statistic')) { + foreach (keys %log_level_count) { + print $_ . ": " . $log_level_count{$_} . " "; } } - - print_stats(); - -} - -sub unbreak_lines_only_loop() { - my $log_messages_reached = 0; - while (<>) { - chomp; - - # Log level other than LOG_LEVEL_CLF? - if (m/^(\d{4}-\d{2}-\d{2}|\w{3} \d{2}) (\d\d:\d\d:\d\d).?(\d+)? (?:Privoxy()?([^)\s]*)[)]? ([\w -]*): (.*?)\r?$/ or - # LOG_LEVEL_CLF? - m/^((?:\d+.\d+.\d+.\d+)) - - [(.*)] "(.*)" (\d+) (\d+)/) { - $log_messages_reached = 1; - print "\n"; - - } else { - # Wrapped message - $_ = "\n". $_ if /^(?:\d+.\d+.\d+.\d+)/; - $_ = " " . $_; - } - s@<BR>$@@; - print; - print "\n" unless $log_messages_reached; - } - print "\n"; }
sub VersionMessage { my $version_message;
$version_message .= 'Privoxy-Log-Parser ' . PRIVOXY_LOG_PARSER_VERSION . "\n"; - $version_message .= 'Copyright (C) 2007-2010 Fabian Keil fk@fabiankeil.de' . "\n"; + $version_message .= 'Copyright (C) 2007-2009 Fabian Keil fk@fabiankeil.de' . "\n"; $version_message .= 'http://www.fabiankeil.de/sourcecode/privoxy-log-parser/' . "\n";
print $version_message; @@ -2363,14 +1918,10 @@ sub get_cli_options () { 'no-syntax-highlighting' => CLI_OPTION_NO_SYNTAX_HIGHLIGHTING, 'no-embedded-css' => CLI_OPTION_NO_EMBEDDED_CSS, 'no-msecs' => CLI_OPTION_NO_MSECS, - 'shorten-thread-ids' => CLI_OPTION_SHORTEN_THREAD_IDS, 'show-ineffective-filters' => CLI_OPTION_SHOW_INEFFECTIVE_FILTERS, 'accept-unknown-messages' => CLI_OPTION_ACCEPT_UNKNOWN_MESSAGES, - 'statistics' => CLI_OPTION_STATISTICS, - 'url-statistics-threshold' => CLI_OPTION_URL_STATISTICS_THRESHOLD, - 'unbreak-lines-only' => CLI_OPTION_UNBREAK_LINES_ONLY, - 'host-statistics-threshold'=> CLI_OPTION_HOST_STATISTICS_THRESHOLD, - ); + 'statistic' => CLI_OPTION_STATISTIC, + );
GetOptions ( 'html-output' => $cli_options{'html-output'}, @@ -2378,50 +1929,14 @@ sub get_cli_options () { 'no-syntax-highlighting' => $cli_options{'no-syntax-highlighting'}, 'no-embedded-css' => $cli_options{'no-embedded-css'}, 'no-msecs' => $cli_options{'no-msecs'}, - 'shorten-thread-ids' => $cli_options{'shorten-thread-ids'}, 'show-ineffective-filters' => $cli_options{'show-ineffective-filters'}, 'accept-unknown-messages' => $cli_options{'accept-unknown-messages'}, - 'statistics' => $cli_options{'statistics'}, - 'unbreak-lines-only' => $cli_options{'unbreak-lines-only'}, - 'url-statistics-threshold=i'=> $cli_options{'url-statistics-threshold'}, - 'host-statistics-threshold=i'=> $cli_options{'host-statistics-threshold'}, - 'version' => sub { VersionMessage && exit(0) }, - 'help' => &help, - ) or exit(1); - - $html_output_mode = cli_option_is_set('html-output'); - $no_msecs_mode = cli_option_is_set('no-msecs'); - $shorten_thread_ids = cli_option_is_set('shorten-thread-ids'); - $line_end = get_line_end(); + 'statistic' => $cli_options{'statistic'}, + 'version' => sub { VersionMessage && exit(0) } + ); }
-sub help () {
- our %cli_options; - - VersionMessage(); - - print << " EOF" - -Options and their default values if they have any: - [--accept-unknown-messages] - [--host-statistics-threshold $cli_options{'host-statistics-threshold'}] - [--html-output] - [--no-embedded-css] - [--no-msecs] - [--no-syntax-highlighting] - [--shorten-thread-ids] - [--show-ineffective-filters] - [--statistics] - [--unbreak-lines-only] - [--url-statistics-threshold $cli_options{'url-statistics-threshold'}] - [--title $cli_options{'title'}] - [--version] -see "perldoc $0" for more information - EOF - ; - exit(0); -}
################################################################################ # main @@ -2434,14 +1949,7 @@ sub main () {
print_intro();
- # XXX: should explicitly reject incompatible argument combinations - if (cli_option_is_set('unbreak-lines-only')) { - unbreak_lines_only_loop(); - } elsif (cli_option_is_set('statistics')) { - stats_loop(); - } else { - parse_loop(); - } + parse_loop();
print_outro(); } @@ -2455,9 +1963,8 @@ B<privoxy-log-parser> - A parser and syntax-highlighter for Privoxy log messages =head1 SYNOPSIS
B<privoxy-log-parser> [B<--accept-unknown-messages>] [B<--html-output>] -[B<--no-msecs>] [B<--no-syntax-higlighting>] [B<--statistics>] -[B<--shorten-thread-ids>] [B<--show-ineffective-filters>] -[B<--url-statistics-threshold>] [B<--version>] +[B<--no-msecs>] [B<--no-syntax-higlighting>] [B<--show-ineffective-filters>] +[B<--version>]
=head1 DESCRIPTION
@@ -2472,7 +1979,7 @@ B<privoxy-log-parser> reads Privoxy log messages and - (in some cases) calculates additional information, like the compression ratio or how a filter affected the content size. - + With B<privoxy-log-parser> you should be able to increase Privoxy's log level without getting confused by the resulting amount of output. For example for "debug 64" B<privoxy-log-parser> will (by default) only show messages that @@ -2484,14 +1991,10 @@ will hide the "filter foo caused 0 hits" message. [B<--accept-unknown-messages>] Don't print warnings in case of unknown messages, just don't highlight them.
-[B<--host-statistics-threshold>] Only show the request count for a host -if it's above or equal to the given threshold. If the threshold is 0, host -statistics are disabled. - [B<--html-output>] Use HTML and CSS for the syntax highlighting. If this option is omitted, ANSI escape sequences are used unless B<--no-syntax-highlighting> is active. This option is only intended to make embedding log excerpts in web pages easier. -It does not escape any input! +It does not excape any input!
[B<--no-msecs>] Don't expect milisecond resolution
@@ -2500,28 +2003,9 @@ the filtered output is piped into less in which case the ANSI control codes don't work, or if the terminal itself doesn't support the control codes.
-[B<--shorten-thread-ids>] Shorten the thread ids to a three-digit decimal number. -Note that the mapping from thread ids to shortened ids is created at run-time -and thus varies with the input. - [B<--show-ineffective-filters>] Don't suppress log lines for filters that didn't modify the content.
-[B<--statistics>] Gather various statistics instead of syntax highlighting -log messages. This is an experimental feature, if the results look wrong -they very well might be. Also note that the results are pretty much guaranteed -to be incorrect if Privoxy and Privoxy-Log-Parser aren't in sync. - -[B<--unbreak-lines-only>] Tries to fix lines that got messed up by a broken or -interestingly configured mail client and thus are no longer recognized properly. -Only fixes some breakage, but may be good enough or at least better than nothing. -Doesn't do anything else, so you probably want to pipe the output into -B<privoxy-log-parser> again. - -[B<--url-statistics-threshold>] Only show the request count for a ressource -if it's above or equal to the given threshold. If the threshold is 0, URL -statistics are disabled. - [B<--version>] Print version and exit.
=head1 EXAMPLES diff --git a/external/privoxy/tools/privoxy-regression-test.pl b/external/privoxy/tools/privoxy-regression-test.pl index 347583a..c7269b7 100755 --- a/external/privoxy/tools/privoxy-regression-test.pl +++ b/external/privoxy/tools/privoxy-regression-test.pl @@ -7,7 +7,7 @@ # A regression test "framework" for Privoxy. For documentation see: # perldoc privoxy-regression-test.pl # -# $Id: privoxy-regression-test.pl,v 1.81 2011/10/30 16:22:29 fabiankeil Exp $ +# $Id: privoxy-regression-test.pl,v 1.34 2009/02/27 18:35:22 fabiankeil Exp $ # # Wish list: # @@ -19,7 +19,7 @@ # - Document magic Expect Header values # - Internal fuzz support? # -# Copyright (c) 2007-2011 Fabian Keil fk@fabiankeil.de +# Copyright (c) 2007-2009 Fabian Keil fk@fabiankeil.de # # Permission to use, copy, modify, and distribute this software for any # purpose with or without fee is hereby granted, provided that the above @@ -40,7 +40,7 @@ use strict; use Getopt::Long;
use constant { - PRT_VERSION => 'Privoxy-Regression-Test 0.5', + PRT_VERSION => 'Privoxy-Regression-Test 0.3',
CURL => 'curl',
@@ -52,7 +52,6 @@ use constant { # XXX: why limit at all? CLI_MAX_LEVEL => 100, CLI_FORKS => 0, - CLI_SLEEP_TIME => 0,
PRIVOXY_CGI_URL => 'http://p.p/', FELLATIO_URL => 'http://127.0.0.1:8080/', @@ -70,12 +69,13 @@ use constant {
# Internal use, don't modify # Available debug bits: - LL_SOFT_ERROR => 1, + LL_ERROR => 1, LL_VERBOSE_FAILURE => 2, LL_PAGE_FETCHING => 4, LL_FILE_LOADING => 8, LL_VERBOSE_SUCCESS => 16, LL_STATUS => 32, + LL_SOFT_ERROR => 64,
CLIENT_HEADER_TEST => 1, SERVER_HEADER_TEST => 2, @@ -84,16 +84,19 @@ use constant { STICKY_ACTIONS_TEST => 5, TRUSTED_CGI_REQUEST => 6, BLOCK_TEST => 7, - REDIRECT_TEST =>108, };
sub init_our_variables () {
our $leading_log_time = LEADING_LOG_TIME; our $leading_log_date = LEADING_LOG_DATE; + our $privoxy_cgi_url = PRIVOXY_CGI_URL; + our $verbose_test_description = VERBOSE_TEST_DESCRIPTION; + our $log_level = get_default_log_level(); + }
sub get_default_log_level () { @@ -106,8 +109,9 @@ sub get_default_log_level () { $log_level |= LL_VERBOSE_SUCCESS if DEBUG_LEVEL_VERBOSE_SUCCESS; $log_level |= LL_STATUS if DEBUG_LEVEL_STATUS;
- # This one is supposed to be always on. + # These are intended to be always on. $log_level |= LL_SOFT_ERROR; + $log_level |= LL_ERROR;
return $log_level; } @@ -136,173 +140,18 @@ sub parse_tag ($) {
sub check_for_forbidden_characters ($) {
- my $string = shift; - my $allowed = '[-=\dA-Za-z~{}:./();\t ,+@"_%?&*^]'; + my $tag = shift; # XXX: also used to check values though. + my $allowed = '[-=\dA-Za-z~{}:./();\s,+@"_%?&*^]';
- unless ($string =~ m/^$allowed*$/o) { - my $forbidden = $string; + unless ($tag =~ m/^$allowed*$/) { + my $forbidden = $tag; $forbidden =~ s@^$allowed*(.).*@$1@;
- log_and_die("'" . $string . "' contains character '" . $forbidden. "' which is unacceptable."); - } -} - -sub load_regression_tests() { - if (cli_option_is_set('local-test-file')) { - load_regression_tests_from_file(get_cli_option('local-test-file')); - } else { - load_regression_tests_through_privoxy(); + l(LL_ERROR, "'" . $tag . "' contains character '" . $forbidden. "' which is unacceptable."); } }
-# XXX: Contains a lot of code duplicated from load_action_files() -# that should be factored out. -sub load_regression_tests_from_file ($) { - my $action_file = shift; - - # initialized here - our %actions; - our @regression_tests; - - my $si = 0; # Section index - my $ri = -1; # Regression test index - my $count = 0; - - my $ignored = 0; - - my $sticky_actions = undef; - - l(LL_STATUS, "Gathering regression tests from local file " . $action_file); - - open(my $ACTION_FILE, "<", $action_file) - or log_and_die("Failed to open $action_file: $!"); - - while (<$ACTION_FILE>) { - - my $no_checks = 0; - chomp; - my ($token, $value) = tokenize($_); - - next unless defined $token; - - # Load regression tests - - if (token_starts_new_test($token)) { - - # Beginning of new regression test. - $ri++; - $count++; - enlist_new_test(@regression_tests, $token, $value, $si, $ri, $count); - $no_checks = 1; # Already validated by enlist_new_test(). - } - - if ($token =~ /level\s+(\d+)/i) { - - my $level = $1; - register_dependency($level, $value); - } - - if ($token eq 'sticky actions') { - - # Will be used by each following Sticky URL. - $sticky_actions = $value; - if ($sticky_actions =~ /{[^}]*\s/) { - log_and_die("'Sticky Actions' with whitespace inside the " . - "action parameters are currently unsupported."); - } - } - - if ($si == -1 || $ri == -1) { - # No beginning of a test detected yet, - # so we don't care about any other test - # attributes. - next; - } - - if ($token eq 'expect header') { - - l(LL_FILE_LOADING, "Detected expectation: " . $value); - $regression_tests[$si][$ri]{'expect-header'} = $value; - - } elsif ($token eq 'tag') { - - next if ($ri == -1); - - my $tag = parse_tag($value); - - # We already checked in parse_tag() after filtering - $no_checks = 1; - - l(LL_FILE_LOADING, "Detected TAG: " . $tag); - - # Save tag for all tests in this section - do { - $regression_tests[$si][$ri]{'tag'} = $tag; - } while ($ri-- > 0); - - $si++; - $ri = -1; - - } elsif ($token eq 'ignore' && $value =~ /Yes/i) { - - l(LL_FILE_LOADING, "Ignoring section: " . test_content_as_string($regression_tests[$si][$ri])); - $regression_tests[$si][$ri]{'ignore'} = 1; - $ignored++; - - } elsif ($token eq 'expect status code') { - - l(LL_FILE_LOADING, "Expecting status code: " . $value); - $regression_tests[$si][$ri]{'expected-status-code'} = $value; - - } elsif ($token eq 'level') { # XXX: stupid name - - $value =~ s@(\d+).*@$1@; - l(LL_FILE_LOADING, "Level: " . $value); - $regression_tests[$si][$ri]{'level'} = $value; - - } elsif ($token eq 'method') { - - l(LL_FILE_LOADING, "Method: " . $value); - $regression_tests[$si][$ri]{'method'} = $value; - - } elsif ($token eq 'redirect destination') { - - l(LL_FILE_LOADING, "Redirect destination: " . $value); - $regression_tests[$si][$ri]{'redirect destination'} = $value; - - } elsif ($token eq 'url') { - - if (defined $sticky_actions) { - die "WTF? Attempted to overwrite Sticky Actions" - if defined ($regression_tests[$si][$ri]{'sticky-actions'}); - - l(LL_FILE_LOADING, "Sticky actions: " . $sticky_actions); - $regression_tests[$si][$ri]{'sticky-actions'} = $sticky_actions; - } else { - log_and_die("Sticky URL without Sticky Actions: $value"); - } - - } else { - - # We don't use it, so we don't need - $no_checks = 1; - l(LL_STATUS, "Enabling no_checks for $token") unless $no_checks; - } - - # XXX: Necessary? - unless ($no_checks) { - check_for_forbidden_characters($value); - check_for_forbidden_characters($token); - } - } - - l(LL_FILE_LOADING, "Done loading " . $count . " regression tests." - . " Of which " . $ignored. " will be ignored)\n"); - -} - - -sub load_regression_tests_through_privoxy () { +sub load_regressions_tests () {
our $privoxy_cgi_url; our @privoxy_config; @@ -317,10 +166,6 @@ sub load_regression_tests_through_privoxy () {
l(LL_STATUS, "Asking Privoxy for the number of action files available ...");
- # Dear Privoxy, please reload the config file if necessary ... - get_cgi_page_or_else($curl_url); - - # ... so we get the latest one here. foreach (@{get_cgi_page_or_else($curl_url)}) {
chomp; @@ -355,7 +200,7 @@ sub token_starts_new_test ($) { my $token = shift; my @new_test_directives = ('set header', 'fetch test', 'trusted cgi request', 'request header', 'method test', - 'blocked url', 'url', 'redirected url'); + 'blocked url', 'url');
foreach my $new_test_directive (@new_test_directives) { return 1 if $new_test_directive eq $token; @@ -373,12 +218,12 @@ sub tokenize ($) { s@\s*$@@;
# Reverse HTML-encoding - # XXX: Seriously incomplete. + # XXX: Seriously imcomplete. s@"@"@g; s@&@&@g;
# Tokenize - if (/^#\s*([^=:#]*?)\s*[=]\s*([^#]+)(?:#.*)?$/) { + if (/^#\s*([^=:]*?)\s*[=]\s*(.+?)\s*$/) {
$token = $1; $value = $2; @@ -399,59 +244,45 @@ sub enlist_new_test ($$$$$$) {
my ($regression_tests, $token, $value, $si, $ri, $number) = @_; my $type; - my $executor;
if ($token eq 'set header') {
l(LL_FILE_LOADING, "Header to set: " . $value); $type = CLIENT_HEADER_TEST; - $executor = &execute_client_header_regression_test;
} elsif ($token eq 'request header') {
l(LL_FILE_LOADING, "Header to request: " . $value); $type = SERVER_HEADER_TEST; - $executor = &execute_server_header_regression_test; $$regression_tests[$si][$ri]{'expected-status-code'} = 200;
} elsif ($token eq 'trusted cgi request') {
l(LL_FILE_LOADING, "CGI URL to test in a dumb way: " . $value); $type = TRUSTED_CGI_REQUEST; - $executor = &execute_dumb_fetch_test; $$regression_tests[$si][$ri]{'expected-status-code'} = 200;
} elsif ($token eq 'fetch test') {
l(LL_FILE_LOADING, "URL to test in a dumb way: " . $value); $type = DUMB_FETCH_TEST; - $executor = &execute_dumb_fetch_test; $$regression_tests[$si][$ri]{'expected-status-code'} = 200;
} elsif ($token eq 'method test') {
l(LL_FILE_LOADING, "Method to test: " . $value); $type = METHOD_TEST; - $executor = &execute_method_test; $$regression_tests[$si][$ri]{'expected-status-code'} = 200;
} elsif ($token eq 'blocked url') {
l(LL_FILE_LOADING, "URL to block-test: " . $value); - $executor = &execute_block_test; $type = BLOCK_TEST;
} elsif ($token eq 'url') {
l(LL_FILE_LOADING, "Sticky URL to test: " . $value); $type = STICKY_ACTIONS_TEST; - $executor = &execute_sticky_actions_test; - - } elsif ($token eq 'redirected url') { - - l(LL_FILE_LOADING, "Redirected URL to test: " . $value); - $type = REDIRECT_TEST; - $executor = &execute_redirect_test;
} else {
@@ -460,7 +291,6 @@ sub enlist_new_test ($$$$$$) {
$$regression_tests[$si][$ri]{'type'} = $type; $$regression_tests[$si][$ri]{'level'} = $type; - $$regression_tests[$si][$ri]{'executor'} = $executor;
check_for_forbidden_characters($value);
@@ -474,8 +304,6 @@ sub enlist_new_test ($$$$$$) { "Regression test " . $number . " (section:" . $si . "):"); }
-# XXX: Shares a lot of code with load_regression_tests_from_file() -# that should be factored out. sub load_action_files ($) {
# initialized here @@ -496,7 +324,7 @@ sub load_action_files ($) {
for my $file_number (0 .. @actionfiles - 1) {
- my $curl_url = quote($actionfiles[$file_number]); + my $curl_url = ' "' . $actionfiles[$file_number] . '"'; my $actionfile = undef; my $sticky_actions = undef;
@@ -525,7 +353,6 @@ sub load_action_files ($) { $ri++; $count++; enlist_new_test(@regression_tests, $token, $value, $si, $ri, $count); - $no_checks = 1; # Already validated by enlist_new_test(). }
if ($token =~ /level\s+(\d+)/i) { @@ -539,8 +366,9 @@ sub load_action_files ($) { # Will be used by each following Sticky URL. $sticky_actions = $value; if ($sticky_actions =~ /{[^}]*\s/) { - log_and_die("'Sticky Actions' with whitespace inside the " . - "action parameters are currently unsupported."); + l(LL_ERROR, + "'Sticky Actions' with whitespace inside the " . + "action parameters are currently unsupported."); } }
@@ -597,11 +425,6 @@ sub load_action_files ($) { l(LL_FILE_LOADING, "Method: " . $value); $regression_tests[$si][$ri]{'method'} = $value;
- } elsif ($token eq 'redirect destination') { - - l(LL_FILE_LOADING, "Redirect destination: " . $value); - $regression_tests[$si][$ri]{'redirect destination'} = $value; - } elsif ($token eq 'url') {
if (defined $sticky_actions) { @@ -611,21 +434,17 @@ sub load_action_files ($) { l(LL_FILE_LOADING, "Sticky actions: " . $sticky_actions); $regression_tests[$si][$ri]{'sticky-actions'} = $sticky_actions; } else { - log_and_die("Sticky URL without Sticky Actions: $value"); + l(LL_ERROR, "Sticky URL without Sticky Actions: $value"); }
} else {
# We don't use it, so we don't need $no_checks = 1; - l(LL_STATUS, "Enabling no_checks for $token") unless $no_checks; - } - - # XXX: Necessary? - unless ($no_checks) { - check_for_forbidden_characters($value); - check_for_forbidden_characters($token); } + # XXX: Neccessary? + check_for_forbidden_characters($value) unless $no_checks; + check_for_forbidden_characters($token); } }
@@ -639,16 +458,6 @@ sub load_action_files ($) { # ############################################################################
-# Fisher Yates shuffle from Perl's "How do I shuffle an array randomly?" FAQ -sub fisher_yates_shuffle ($) { - my $deck = shift; - my $i = @$deck; - while ($i--) { - my $j = int rand($i+1); - @$deck[$i,$j] = @$deck[$j,$i]; - } -} - sub execute_regression_tests () {
our @regression_tests; @@ -672,51 +481,47 @@ sub execute_regression_tests () { my $failures; my $skipped = 0;
- if (cli_option_is_set('shuffle-tests')) { - - # Shuffle both the test sections and - # the tests they contain. - # - # XXX: With the current data layout, shuffling tests - # from different sections isn't possible. - # Is this worth changing the layout? - fisher_yates_shuffle(@regression_tests); - for (my $s = 0; $s < @regression_tests; $s++) { - fisher_yates_shuffle($regression_tests[$s]); - } - } - - for (my $s = 0; $s < @regression_tests; $s++) { + for my $s (0 .. @regression_tests - 1) {
my $r = 0;
while (defined $regression_tests[$s][$r]) {
- unless (cli_option_is_set('shuffle-tests')) { - die "Section id mismatch" if ($s != $regression_tests[$s][$r]{'section-id'}); - die "Regression test id mismatch" if ($r != $regression_tests[$s][$r]{'regression-test-id'}); - } - die "Internal error. Test executor missing." - unless defined $regression_tests[$s][$r]{executor}; + die "Section id mismatch" if ($s != $regression_tests[$s][$r]{'section-id'}); + die "Regression test id mismatch" if ($r != $regression_tests[$s][$r]{'regression-test-id'});
my $number = $regression_tests[$s][$r]{'number'}; - my $skip_reason = get_skip_reason($regression_tests[$s][$r]); + my $skip_reason = undef; + + if ($regression_tests[$s][$r]{'ignore'}) { + + $skip_reason = "Ignore flag is set"; + + } elsif (cli_option_is_set('test-number') + and get_cli_option('test-number') != $number) { + + $skip_reason = "Only executing test " . get_cli_option('test-number'); + + } else { + + $skip_reason = level_is_unacceptable($regression_tests[$s][$r]{'level'}); + }
if (defined $skip_reason) {
my $message = "Skipping test " . $number . ": " . $skip_reason . "."; - log_message($message) if (cli_option_is_set('show-skipped-tests')); + log_message($message) if (cli_option_is_set('verbose') or + cli_option_is_set('show-skipped-tests')); $skipped++;
} else {
- my $result = $regression_tests[$s][$r]{executor}($regression_tests[$s][$r]); + my $result = execute_regression_test($regression_tests[$s][$r]);
log_result($regression_tests[$s][$r], $result, $tests);
$successes += $result; $tests++; - sleep(get_cli_option('sleep-time')) if (cli_option_is_set('sleep-time')); } $r++; } @@ -730,6 +535,7 @@ sub execute_regression_tests () { $all_tests += $tests; $all_failures += $failures; $all_successes += $successes; + }
if (get_cli_option('loops') > 1) { @@ -738,27 +544,6 @@ sub execute_regression_tests () { } }
-sub get_skip_reason ($) { - my $test = shift; - my $skip_reason = undef; - - if ($test->{'ignore'}) { - - $skip_reason = "Ignore flag is set"; - - } elsif (cli_option_is_set('test-number') and - get_cli_option('test-number') != $test->{'number'}) { - - $skip_reason = "Only executing test " . get_cli_option('test-number'); - - } else { - - $skip_reason = level_is_unacceptable($test->{'level'}); - } - - return $skip_reason; -} - sub level_is_unacceptable ($) { my $level = shift; my $min_level = get_cli_option('min-level'); @@ -774,11 +559,11 @@ sub level_is_unacceptable ($) {
} elsif ($level < $min_level) {
- $reason = "Level too low (" . $level . " < " . $min_level . ")"; + $reason = "Level to low (" . $level . " < " . $min_level . ")";
} elsif ($level > $max_level) {
- $reason = "Level too high (" . $level . " > " . $max_level . ")"; + $reason = "Level to high (" . $level . " > " . $max_level . ")";
} else {
@@ -804,16 +589,11 @@ sub dependency_unsatisfied ($) {
foreach (@privoxy_config) {
- if (/$dependency/) { - $dependency_problem = undef; - last; - } + $dependency_problem = undef if (/$dependency/); + last; # XXX: this looks ... interesting. }
- } - - if (defined ($dependencies{$level}{'feature status'}) - and not defined $dependency_problem) { + } elsif (defined ($dependencies{$level}{'feature status'})) {
my $dependency = $dependencies{$level}{'feature status'}; my ($feature, $status) = $dependency =~ /([^\s]*)\s+(Yes|No)/; @@ -843,96 +623,90 @@ sub register_dependency ($$) {
$dependencies{$level}{'feature status'} = $1;
- } else { - - log_and_die("Didn't recognize dependency: $dependency."); } }
-sub execute_method_test ($) { +# XXX: somewhat misleading name +sub execute_regression_test ($) {
- my $test = shift; - my $buffer_ref; - my $status_code; - my $method = $test->{'data'}; + my $test_ref = shift; + my %test = %{$test_ref}; + my $result = 0;
- my $curl_parameters = ''; - my $expected_status_code = $test->{'expected-status-code'}; + if ($test{'type'} == CLIENT_HEADER_TEST) {
- $curl_parameters .= '--request ' . $method . ' '; - # Don't complain about the 'missing' body - $curl_parameters .= '--head ' if ($method =~ /^HEAD$/i); + $result = execute_client_header_regression_test($test_ref);
- $curl_parameters .= PRIVOXY_CGI_URL; + } elsif ($test{'type'} == SERVER_HEADER_TEST) {
- $buffer_ref = get_page_with_curl($curl_parameters); - $status_code = get_status_code($buffer_ref); + $result = execute_server_header_regression_test($test_ref);
- return check_status_code_result($status_code, $expected_status_code); + } elsif ($test{'type'} == DUMB_FETCH_TEST + or $test{'type'} == TRUSTED_CGI_REQUEST) { + + $result = execute_dumb_fetch_test($test_ref); + + } elsif ($test{'type'} == METHOD_TEST) { + + $result = execute_method_test($test_ref); + + } elsif ($test{'type'} == BLOCK_TEST) { + + $result = execute_block_test($test_ref); + + } elsif ($test{'type'} == STICKY_ACTIONS_TEST) { + + $result = execute_sticky_actions_test($test_ref); + + } else { + + die "Unsupported test type detected: " . $test{'type'}; + } + + return $result; }
-sub execute_redirect_test ($) { +sub execute_method_test ($) {
- my $test = shift; + my $test_ref = shift; + my %test = %{$test_ref}; my $buffer_ref; my $status_code; + my $method = $test{'data'};
my $curl_parameters = ''; - my $url = $test->{'data'}; - my $redirect_destination; - my $expected_redirect_destination = $test->{'redirect destination'}; - - # XXX: Check if a redirect actually applies before doing the request. - # otherwise the test may hit a real server in failure cases. + my $expected_status_code = $test{'expected-status-code'};
- $curl_parameters .= '--head '; + $curl_parameters .= '--request ' . $method . ' '; + # Don't complain about the 'missing' body + $curl_parameters .= '--head ' if ($method =~ /^HEAD$/i);
- $curl_parameters .= quote($url); + $curl_parameters .= PRIVOXY_CGI_URL;
$buffer_ref = get_page_with_curl($curl_parameters); $status_code = get_status_code($buffer_ref);
- if ($status_code ne "302") { - l(LL_VERBOSE_FAILURE, - "Ooops. Expected redirect to: '" . $expected_redirect_destination - . "' but got a response with status code: " . $status_code); - return 0; - } - foreach (@{$buffer_ref}) { - if (/^Location: (.*)\r\n/) { - $redirect_destination = $1; - last; - } - } - - my $success = ($redirect_destination eq $expected_redirect_destination); - - unless ($success) { - l(LL_VERBOSE_FAILURE, - "Ooops. Expected redirect to: '" . $expected_redirect_destination - . "' but the redirect leads to: '" . $redirect_destination. "'"); - } - - return $success; + return check_status_code_result($status_code, $expected_status_code); }
sub execute_dumb_fetch_test ($) {
- my $test = shift; + my $test_ref = shift; + my %test = %{$test_ref}; my $buffer_ref; my $status_code;
my $curl_parameters = ''; - my $expected_status_code = $test->{'expected-status-code'}; + my $expected_status_code = $test{'expected-status-code'};
- if (defined $test->{method}) { - $curl_parameters .= '--request ' . quote($test->{method}) . ' '; + if (defined $test{method}) { + $curl_parameters .= '--request ' . $test{method} . ' '; } - if ($test->{type} == TRUSTED_CGI_REQUEST) { - $curl_parameters .= '--referer ' . quote(PRIVOXY_CGI_URL) . ' '; + if ($test{type} == TRUSTED_CGI_REQUEST) { + $curl_parameters .= '--referer ' . PRIVOXY_CGI_URL . ' '; }
- $curl_parameters .= quote($test->{'data'}); + $curl_parameters .= $test{'data'};
$buffer_ref = get_page_with_curl($curl_parameters); $status_code = get_status_code($buffer_ref); @@ -959,18 +733,15 @@ sub execute_sticky_actions_test ($) { my $final_results = get_final_results($url);
foreach my $sticky_action (@sticky_actions) { - if (defined $final_results->{$sticky_action}) { # Exact match $verified_actions++; - - } elsif ($sticky_action =~ /-.*{/) { - + }elsif ($sticky_action =~ /-.*{/ and + not defined $final_results->{$sticky_action}) { # Disabled multi actions aren't explicitly listed as # disabled and thus have to be checked by verifying # that they aren't enabled. $verified_actions++; - } else { l(LL_VERBOSE_FAILURE, "Ooops. '$sticky_action' is not among the final results."); @@ -1004,10 +775,7 @@ sub get_final_results ($) { next unless ($final_results_reached); last if (m@</td>@);
- # Privoxy versions before 3.0.16 add a space - # between action name and parameters, therefore - # the " ?". - if (m@<br>([-+])<a.*>([^>]*)</a>(?: ?({.*}))?@) { + if (m@<br>([-+])<a.*>([^>]*)</a>(?: ({.*}))?@) { my $action = $1.$2; my $parameter = $3;
@@ -1059,28 +827,28 @@ sub check_status_code_result ($$) {
sub execute_client_header_regression_test ($) {
- my $test = shift; + my $test_ref = shift; my $buffer_ref; my $header;
- $buffer_ref = get_show_request_with_curl($test); + $buffer_ref = get_show_request_with_curl($test_ref);
- $header = get_header($buffer_ref, $test); + $header = get_header($buffer_ref, $test_ref);
- return check_header_result($test, $header); + return check_header_result($test_ref, $header); }
sub execute_server_header_regression_test ($) {
- my $test = shift; + my $test_ref = shift; my $buffer_ref; my $header;
- $buffer_ref = get_head_with_curl($test); + $buffer_ref = get_head_with_curl($test_ref);
- $header = get_server_header($buffer_ref, $test); + $header = get_server_header($buffer_ref, $test_ref);
- return check_header_result($test, $header); + return check_header_result($test_ref, $header); }
sub interpret_result ($) { @@ -1090,51 +858,65 @@ sub interpret_result ($) {
sub check_header_result ($$) {
- my $test = shift; + my $test_ref = shift; my $header = shift;
- my $expect_header = $test->{'expect-header'}; + my %test = %{$test_ref}; + my $expect_header = $test{'expect-header'}; my $success = 0;
if ($expect_header eq 'NO CHANGE') {
- $success = (defined($header) and $header eq $test->{'data'}); + if (defined($header) and $header eq $test{'data'}) { + + $success = 1; + + } else {
- unless ($success) { $header = "REMOVAL" unless defined $header; l(LL_VERBOSE_FAILURE, - "Ooops. Got: '" . $header . "' while expecting: '" . $expect_header . "'"); + "Ooops. Got: " . $header . " while expecting: " . $expect_header); }
} elsif ($expect_header eq 'REMOVAL') {
- # XXX: Use more reliable check here and make sure - # the header has a different name. - $success = not (defined($header) and $header eq $test->{'data'}); + if (defined($header) and $header eq $test{'data'}) {
- unless ($success) { l(LL_VERBOSE_FAILURE, - "Ooops. Expected removal but: '" . $header . "' is still there."); + "Ooops. Expected removal but: " . $header . " is still there."); + + } else { + + # XXX: Use more reliable check here and make sure + # the header has a different name. + $success = 1; }
} elsif ($expect_header eq 'SOME CHANGE') {
- $success = (defined($header) and $header ne $test->{'data'}); + if (defined($header) and not $header eq $test{'data'}) { + + $success = 1; + + } else {
- unless ($success) { $header = "REMOVAL" unless defined $header; l(LL_VERBOSE_FAILURE, - "Ooops. Got: '" . $header . "' while expecting: SOME CHANGE"); + "Ooops. Got: " . $header . " while expecting: SOME CHANGE"); }
+ } else {
- $success = (defined($header) and $header eq $expect_header); + if (defined($header) and $header eq $expect_header) { + + $success = 1;
- unless ($success) { - $header = "No matching header" unless defined $header; # XXX: No header detected to be precise + } else { + + $header = "'No matching header'" unless defined $header; # XXX: No header detected to be precise l(LL_VERBOSE_FAILURE, - "Ooops. Got: '" . $header . "' while expecting: '" . $expect_header . "'"); + "Ooops. Got: " . $header . " while expecting: " . $expect_header); } } return $success; @@ -1154,11 +936,12 @@ sub get_header ($$) { our $filtered_request = '';
my $buffer_ref = shift; - my $test = shift; + my $test_ref = shift;
+ my %test = %{$test_ref}; my @buffer = @{$buffer_ref};
- my $expect_header = $test->{'expect-header'}; + my $expect_header = $test{'expect-header'};
die "get_header called with no expect header" unless defined $expect_header;
@@ -1171,9 +954,10 @@ sub get_header ($$) {
if ($expect_header eq 'REMOVAL' or $expect_header eq 'NO CHANGE' - or $expect_header eq 'SOME CHANGE') { + or $expect_header eq 'SOME CHANGE') { + + $expect_header = $test{'data'};
- $expect_header = $test->{'data'}; }
$header_to_get = get_header_name($expect_header); @@ -1212,23 +996,24 @@ sub get_header ($$) { sub get_server_header ($$) {
my $buffer_ref = shift; - my $test = shift; + my $test_ref = shift;
+ my %test = %{$test_ref}; my @buffer = @{$buffer_ref};
- my $expect_header = $test->{'expect-header'}; + my $expect_header = $test{'expect-header'}; my $header; my $header_to_get;
# XXX: Should be caught before starting to test. - log_and_die("No expect header for test " . $test->{'number'}) + l(LL_ERROR, "No expect header for test " . $test{'number'}) unless defined $expect_header;
if ($expect_header eq 'REMOVAL' or $expect_header eq 'NO CHANGE' or $expect_header eq 'SOME CHANGE') {
- $expect_header = $test->{'data'}; + $expect_header = $test{'data'}; }
$header_to_get = get_header_name($expect_header); @@ -1262,7 +1047,7 @@ sub get_status_code ($) {
return '123' if cli_option_is_set('fuzzer-feeding'); chomp; - log_and_die('Unexpected buffer line: "' . $_ . '"'); + l(LL_ERROR, 'Unexpected buffer line: "' . $_ . '"'); } } } @@ -1274,21 +1059,22 @@ sub get_test_keys () { # XXX: incomplete sub test_content_as_string ($) {
- my $test = shift; + my $test_ref = shift; + my %test = %{$test_ref};
my $s = "\n\t";
foreach my $key (get_test_keys()) { - $test->{$key} = 'Not set' unless (defined $test->{$key}); + $test{$key} = 'Not set' unless (defined $test{$key}); }
- $s .= 'Tag: ' . $test->{'tag'}; + $s .= 'Tag: ' . $test{'tag'}; $s .= "\n\t"; - $s .= 'Set header: ' . $test->{'data'}; # XXX: adjust for other test types + $s .= 'Set header: ' . $test{'data'}; # XXX: adjust for other test types $s .= "\n\t"; - $s .= 'Expected header: ' . $test->{'expect-header'}; + $s .= 'Expected header: ' . $test{'expect-header'}; $s .= "\n\t"; - $s .= 'Ignore: ' . $test->{'ignore'}; + $s .= 'Ignore: ' . $test{'ignore'};
return $s; } @@ -1313,6 +1099,11 @@ sub fuzz_header($) { # ############################################################################
+sub check_for_curl () { + my $curl = CURL; + l(LL_ERROR, "No curl found.") unless (`which $curl`); +} + sub get_cgi_page_or_else ($) {
my $cgi_url = shift; @@ -1332,7 +1123,7 @@ sub get_cgi_page_or_else ($) {
} else {
- log_and_die($log_message); + l(LL_ERROR, $log_message); } }
@@ -1343,17 +1134,18 @@ sub get_cgi_page_or_else ($) { sub get_show_request_with_curl ($) {
our $privoxy_cgi_url; - my $test = shift; + my $test_ref = shift; + my %test = %{$test_ref};
my $curl_parameters = ' '; - my $header = $test->{'data'}; + my $header = $test{'data'};
if (cli_option_is_set('header-fuzzing')) { $header = fuzz_header($header); }
# Enable the action to test - $curl_parameters .= '-H 'X-Privoxy-Control: ' . $test->{'tag'} . '' '; + $curl_parameters .= '-H 'X-Privoxy-Control: ' . $test{'tag'} . '' '; # The header to filter $curl_parameters .= '-H '' . $header . '' ';
@@ -1367,14 +1159,15 @@ sub get_show_request_with_curl ($) { sub get_head_with_curl ($) {
our $fellatio_url = FELLATIO_URL; - my $test = shift; + my $test_ref = shift; + my %test = %{$test_ref};
my $curl_parameters = ' ';
# Enable the action to test - $curl_parameters .= '-H 'X-Privoxy-Control: ' . $test->{'tag'} . '' '; + $curl_parameters .= '-H 'X-Privoxy-Control: ' . $test{'tag'} . '' '; # The header to filter - $curl_parameters .= '-H 'X-Gimme-Head-With: ' . $test->{'data'} . '' '; + $curl_parameters .= '-H 'X-Gimme-Head-With: ' . $test{'data'} . '' '; $curl_parameters .= '--head ';
$curl_parameters .= ' '; @@ -1393,9 +1186,8 @@ sub get_page_with_curl ($) { my $retries_left = get_cli_option('retries') + 1; my $failure_reason;
- if (defined $proxy) { - $curl_line .= ' --proxy ' . quote($proxy); - } + $curl_line .= ' --proxy ' . $proxy if (defined $proxy); + # We want to see the HTTP status code $curl_line .= " --include "; # Let Privoxy emit two log messages less. @@ -1420,7 +1212,6 @@ sub get_page_with_curl ($) { @buffer = `$curl_line`;
if ($?) { - log_and_die("Executing '$curl_line' failed.") unless @buffer; $failure_reason = array_as_string(@buffer); chomp $failure_reason; l(LL_SOFT_ERROR, "Fetch failure: '" . $failure_reason . $! ."'"); @@ -1428,8 +1219,9 @@ sub get_page_with_curl ($) { } while ($? && --$retries_left);
unless ($retries_left) { - log_and_die("Running curl failed " . get_cli_option('retries') . - " times in a row. Last error: '" . $failure_reason . "'."); + l(LL_ERROR, + "Running curl failed " . get_cli_option('retries') . + " times in a row. Last error: '" . $failure_reason . "'."); }
return @buffer; @@ -1454,8 +1246,8 @@ sub array_as_string ($) { }
sub show_test ($) { - my $test = shift; - log_message('Test is:' . test_content_as_string($test)); + my $test_ref = shift; + log_message('Test is:' . test_content_as_string($test_ref)); }
# Conditional log @@ -1464,14 +1256,17 @@ sub l ($$) { my $this_level = shift; my $message = shift;
- log_message($message) if ($log_level & $this_level); -} + return unless ($log_level & $this_level);
-sub log_and_die ($) { - my $message = shift; + if (LL_ERROR & $this_level) { + $message = 'Oh noes. ' . $message . ' Fatal error. Exiting.'; + } + + log_message($message);
- log_message('Oh noes. ' . $message . ' Fatal error. Exiting.'); - exit; + if (LL_ERROR & $this_level) { + exit; + } }
sub log_message ($) { @@ -1491,7 +1286,7 @@ sub log_message ($) { if ($leading_log_date) { $year += 1900; $mon += 1; - $time_stamp = sprintf("%i-%.2i-%.2i", $year, $mon, $mday); + $time_stamp = sprintf("%i/%.2i/%.2i", $year, $mon, $mday); }
if ($leading_log_time) { @@ -1510,82 +1305,76 @@ sub log_result ($$) { our $verbose_test_description; our $filtered_request;
- my $test = shift; + my $test_ref = shift; my $result = shift; my $number = shift;
+ my %test = %{$test_ref}; my $message = '';
$message .= interpret_result($result); $message .= " for test "; $message .= $number; $message .= '/'; - $message .= $test->{'number'}; + $message .= $test{'number'}; $message .= '/'; - $message .= $test->{'section-id'}; + $message .= $test{'section-id'}; $message .= '/'; - $message .= $test->{'regression-test-id'}; + $message .= $test{'regression-test-id'}; $message .= '.';
if ($verbose_test_description) {
- if ($test->{'type'} == CLIENT_HEADER_TEST) { + if ($test{'type'} == CLIENT_HEADER_TEST) {
$message .= ' Header '; - $message .= quote($test->{'data'}); + $message .= quote($test{'data'}); $message .= ' and tag '; - $message .= quote($test->{'tag'}); + $message .= quote($test{'tag'});
- } elsif ($test->{'type'} == SERVER_HEADER_TEST) { + } elsif ($test{'type'} == SERVER_HEADER_TEST) {
$message .= ' Request Header '; - $message .= quote($test->{'data'}); + $message .= quote($test{'data'}); $message .= ' and tag '; - $message .= quote($test->{'tag'}); + $message .= quote($test{'tag'});
- } elsif ($test->{'type'} == DUMB_FETCH_TEST) { + } elsif ($test{'type'} == DUMB_FETCH_TEST) {
$message .= ' URL '; - $message .= quote($test->{'data'}); + $message .= quote($test{'data'}); $message .= ' and expected status code '; - $message .= quote($test->{'expected-status-code'}); + $message .= quote($test{'expected-status-code'});
- } elsif ($test->{'type'} == TRUSTED_CGI_REQUEST) { + } elsif ($test{'type'} == TRUSTED_CGI_REQUEST) {
$message .= ' CGI URL '; - $message .= quote($test->{'data'}); + $message .= quote($test{'data'}); $message .= ' and expected status code '; - $message .= quote($test->{'expected-status-code'}); + $message .= quote($test{'expected-status-code'});
- } elsif ($test->{'type'} == METHOD_TEST) { + } elsif ($test{'type'} == METHOD_TEST) {
$message .= ' HTTP method '; - $message .= quote($test->{'data'}); + $message .= quote($test{'data'}); $message .= ' and expected status code '; - $message .= quote($test->{'expected-status-code'}); + $message .= quote($test{'expected-status-code'});
- } elsif ($test->{'type'} == BLOCK_TEST) { + } elsif ($test{'type'} == BLOCK_TEST) {
$message .= ' Supposedly-blocked URL: '; - $message .= quote($test->{'data'}); + $message .= quote($test{'data'});
- } elsif ($test->{'type'} == STICKY_ACTIONS_TEST) { + } elsif ($test{'type'} == STICKY_ACTIONS_TEST) {
$message .= ' Sticky Actions: '; - $message .= quote($test->{'sticky-actions'}); + $message .= quote($test{'sticky-actions'}); $message .= ' and URL: '; - $message .= quote($test->{'data'}); - - } elsif ($test->{'type'} == REDIRECT_TEST) { - - $message .= ' Redirected URL: '; - $message .= quote($test->{'data'}); - $message .= ' and redirect destination: '; - $message .= quote($test->{'redirect destination'}); + $message .= quote($test{'data'});
} else {
- die "Incomplete support for test type " . $test->{'type'} . " detected."; + die "Incomplete support for test type " . $test{'type'} . " detected."; } }
@@ -1598,25 +1387,7 @@ sub quote ($) { }
sub print_version () { - printf PRT_VERSION . "\n" . 'Copyright (C) 2007-2011 Fabian Keil fk@fabiankeil.de' . "\n"; -} - -sub list_test_types () { - my %test_types = ( - 'Client header test' => CLIENT_HEADER_TEST, - 'Server header test' => 2, - 'Dumb fetch test' => 3, - 'Method test' => 4, - 'Sticky action test' => 5, - 'Trusted CGI test' => 6, - 'Block test' => 7, - 'Redirect test' => 108, - ); - - print "\nThe supported test types and their default levels are:\n"; - foreach my $test_type (sort { $test_types{$a} <=> $test_types{$b} } keys %test_types) { - printf " %-20s -> %3.d\n", $test_type, $test_types{$test_type}; - } + printf PRT_VERSION . "\n" . 'Copyright (C) 2007-2009 Fabian Keil fk@fabiankeil.de' . "\n"; }
sub help () { @@ -1635,7 +1406,6 @@ Options and their default values if they have any: [--help] [--header-fuzzing] [--level] - [--local-test-file] [--loops $cli_options{'loops'}] [--max-level $cli_options{'max-level'}] [--max-time $cli_options{'max-time'}] @@ -1643,22 +1413,12 @@ Options and their default values if they have any: [--privoxy-address] [--retries $cli_options{'retries'}] [--show-skipped-tests] - [--shuffle-tests] - [--sleep-time $cli_options{'sleep-time'}] [--test-number] [--verbose] [--version] +see "perldoc $0" for more information EOF ; - - list_test_types(); - - print << " EOF" - -Try "perldoc $0" for more information - EOF - ; - exit(0); }
@@ -1673,7 +1433,6 @@ sub init_cli_options () { $cli_options{'max-level'} = CLI_MAX_LEVEL; $cli_options{'max-time'} = CLI_MAX_TIME; $cli_options{'min-level'} = CLI_MIN_LEVEL; - $cli_options{'sleep-time'}= CLI_SLEEP_TIME; $cli_options{'retries'} = CLI_RETRIES; }
@@ -1685,27 +1444,24 @@ sub parse_cli_options () { init_cli_options();
GetOptions ( - 'debug=i' => $cli_options{'debug'}, - 'forks=i' => $cli_options{'forks'}, + 'debug=s' => $cli_options{'debug'}, + 'forks=s' => $cli_options{'forks'}, 'fuzzer-address=s' => $cli_options{'fuzzer-address'}, 'fuzzer-feeding' => $cli_options{'fuzzer-feeding'}, 'header-fuzzing' => $cli_options{'header-fuzzing'}, - 'help' => &help, - 'level=i' => $cli_options{'level'}, - 'local-test-file=s' => $cli_options{'local-test-file'}, - 'loops=i' => $cli_options{'loops'}, - 'max-level=i' => $cli_options{'max-level'}, - 'max-time=i' => $cli_options{'max-time'}, - 'min-level=i' => $cli_options{'min-level'}, + 'help' => sub {help}, + 'level=s' => $cli_options{'level'}, + 'loops=s' => $cli_options{'loops'}, + 'max-level=s' => $cli_options{'max-level'}, + 'max-time=s' => $cli_options{'max-time'}, + 'min-level=s' => $cli_options{'min-level'}, 'privoxy-address=s' => $cli_options{'privoxy-address'}, - 'retries=i' => $cli_options{'retries'}, - 'shuffle-tests' => $cli_options{'shuffle-tests'}, + 'retries=s' => $cli_options{'retries'}, 'show-skipped-tests' => $cli_options{'show-skipped-tests'}, - 'sleep-time=i' => $cli_options{'sleep-time'}, - 'test-number=i' => $cli_options{'test-number'}, + 'test-number=s' => $cli_options{'test-number'}, 'verbose' => $cli_options{'verbose'}, 'version' => sub {print_version && exit(0)} - ) or exit(1); + ); $log_level |= $cli_options{'debug'}; }
@@ -1741,13 +1497,14 @@ sub init_proxy_settings($) { if (cli_option_is_set('privoxy-address')) { $proxy .= get_cli_option('privoxy-address'); } + } }
sub start_forks($) { my $forks = shift;
- log_and_die("Invalid --fork value: " . $forks . ".") if ($forks < 0); + l(LL_ERROR, "Invalid --fork value: " . $forks . ".") if ($forks < 0);
foreach my $fork (1 .. $forks) { log_message("Starting fork $fork"); @@ -1762,8 +1519,9 @@ sub main () {
init_our_variables(); parse_cli_options(); + check_for_curl(); init_proxy_settings('vanilla-proxy'); - load_regression_tests(); + load_regressions_tests(); init_proxy_settings('fuzz-proxy'); start_forks(get_cli_option('forks')) if cli_option_is_set('forks'); execute_regression_tests(); @@ -1779,10 +1537,10 @@ B<privoxy-regression-test> - A regression test "framework" for Privoxy.
B<privoxy-regression-test> [B<--debug bitmask>] [B<--forks> forks] [B<--fuzzer-feeding>] [B<--fuzzer-feeding>] [B<--help>] [B<--level level>] -[B<--local-test-file testfile>] [B<--loops count>] [B<--max-level max-level>] -[B<--max-time max-time>] [B<--min-level min-level>] B<--privoxy-address proxy-address> +[B<--loops count>] [B<--max-level max-level>] [B<--max-time max-time>] +[B<--min-level min-level>] B<--privoxy-address proxy-address> [B<--retries retries>] [B<--test-number test-number>] -[B<--show-skipped-tests>] [B<--sleep-time> seconds] [B<--verbose>] +[B<--show-skipped-tests>] [B<--verbose>] [B<--version>]
=head1 DESCRIPTION @@ -1866,11 +1624,6 @@ To verify that a specific set of actions is applied to an URL, use: The sticky actions will be checked for all URLs below it until the next sticky actions directive.
-To verify that requests for a URL get redirected, use: - - # Redirected URL = http://www.example.com/redirect-me - # Redirect Destination = http://www.example.org/redirected - =head1 TEST LEVELS
All tests have test levels to let the user @@ -1878,15 +1631,9 @@ control which ones to execute (see I<OPTIONS> below). Test levels are either set with the B<Level> directive, or implicitly through the test type.
-Redirect tests default to level 108, block tests to level 7, -fetch tests to level 6, "Sticky Actions" tests default to -level 5, tests for trusted CGI requests to level 3 and -client-header-action tests to level 1. - -The current redirect test level is above the default -max-level value as failed tests will result in outgoing -connections. Use the B<--max-level> option to run them -as well. +Block tests default to level 7, fetch tests to level 6, +"Sticky Actions" tests default to level 5, tests for trusted CGI +requests to level 3 and client-header-action tests to level 1.
=head1 OPTIONS
@@ -1915,12 +1662,6 @@ headers in a way that should not affect the test result.
B<--level level> Only execute tests with the specified B<level>.
-B<--local-test-file test-file> Do not get the tests -through Privoxy's web interface, but use a single local -file. Not recommended for testing Privoxy, but can be useful -to "misappropriate" Privoxy-Regression-Test to test other -stuff, like webserver configurations. - B<--loop count> Loop through the regression tests B<count> times. Useful to feed a fuzzer, or when doing stress tests with several Privoxy-Regression-Test instances running at the same @@ -1950,16 +1691,7 @@ number.
B<--show-skipped-tests> Log skipped tests even if verbose mode is off.
-B<--shuffle-tests> Shuffle test sections and their tests before -executing them. When combined with B<--forks>, this can increase -the chances of detecting race conditions. Of course some problems -are easier to detect without this option. - -B<--sleep-time seconds> Wait B<seconds> between tests. Useful when -debugging issues with systems that don't log with millisecond precision. - -B<--verbose> Log successful tests as well. By default only -the failures are logged. +B<--verbose> Log succesful and skipped tests.
B<--version> Print version and exit.
diff --git a/external/privoxy/tools/url-pattern-translator.pl b/external/privoxy/tools/url-pattern-translator.pl index 0f084f4..a575333 100755 --- a/external/privoxy/tools/url-pattern-translator.pl +++ b/external/privoxy/tools/url-pattern-translator.pl @@ -18,7 +18,7 @@ # Only convert your files once, or, as RoboCop used to say, # there will be... trouble. # -# $Id: url-pattern-translator.pl,v 1.4 2009/06/21 18:15:24 fabiankeil Exp $ +# $Id: url-pattern-translator.pl,v 1.3 2009/01/13 17:01:04 fabiankeil Exp $ # # Copyright (c) 2008 Fabian Keil fk@fabiankeil.de # @@ -63,7 +63,7 @@ sub convert_host_pattern ($) { }
# Match-all syntax has changed ... - $hp =~ s@*@[^.]*@g; + $hp =~ s@*@.*@g;
# Extended host patterns are right-anchored by default $hp =~ s@.$@(..*)?@; diff --git a/external/privoxy/urlmatch.c b/external/privoxy/urlmatch.c index 79f00f4..47b607c 100644 --- a/external/privoxy/urlmatch.c +++ b/external/privoxy/urlmatch.c @@ -1,4 +1,4 @@ -const char urlmatch_rcs[] = "$Id: urlmatch.c,v 1.65 2011/11/06 11:41:34 fabiankeil Exp $"; +const char urlmatch_rcs[] = "$Id: urlmatch.c,v 1.47 2009/03/02 19:18:10 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/urlmatch.c,v $ @@ -6,7 +6,7 @@ const char urlmatch_rcs[] = "$Id: urlmatch.c,v 1.65 2011/11/06 11:41:34 fabianke * Purpose : Declares functions to match URLs against URL * patterns. * - * Copyright : Written by and Copyright (C) 2001-2011 + * Copyright : Written by and Copyright (C) 2001-2009 * the Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written @@ -31,8 +31,228 @@ const char urlmatch_rcs[] = "$Id: urlmatch.c,v 1.65 2011/11/06 11:41:34 fabianke * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: urlmatch.c,v $ + * Revision 1.47 2009/03/02 19:18:10 fabiankeil + * Streamline parse_http_request()'s prototype. As + * cparser pointed out it doesn't actually use csp. + * + * Revision 1.46 2009/02/11 19:31:32 fabiankeil + * Reject request lines that end with neither HTTP/1.0 nor HTTP/1.1. + * + * Revision 1.45 2008/06/21 21:19:18 fabiankeil + * Silence bogus compiler warning. + * + * Revision 1.44 2008/05/04 16:18:32 fabiankeil + * Provide parse_http_url() with a third parameter to specify + * whether or not URLs without protocol are acceptable. + * + * Revision 1.43 2008/05/04 13:30:55 fabiankeil + * Streamline parse_http_url()'s prototype. + * + * Revision 1.42 2008/05/04 13:24:16 fabiankeil + * If the method isn't CONNECT, reject URLs without protocol. + * + * Revision 1.41 2008/05/02 09:51:34 fabiankeil + * In parse_http_url(), don't muck around with values + * that are none of its business: require an initialized + * http structure and never unset http->ssl. + * + * Revision 1.40 2008/04/23 16:12:28 fabiankeil + * Free with freez(). + * + * Revision 1.39 2008/04/22 16:27:42 fabiankeil + * In parse_http_request(), remove a pointless + * temporary variable and free the buffer earlier. + * + * Revision 1.38 2008/04/18 05:17:18 fabiankeil + * Mark simplematch()'s parameters as immutable. + * + * Revision 1.37 2008/04/17 14:53:29 fabiankeil + * Move simplematch() into urlmatch.c as it's only + * used to match (old-school) domain patterns. + * + * Revision 1.36 2008/04/14 18:19:48 fabiankeil + * Remove now-pointless cast in create_url_spec(). + * + * Revision 1.35 2008/04/14 18:11:21 fabiankeil + * The compiler might not notice it, but the buffer passed to + * create_url_spec() is modified later on and thus shouldn't + * be declared immutable. + * + * Revision 1.34 2008/04/13 13:32:07 fabiankeil + * Factor URL pattern compilation out of create_url_spec(). + * + * Revision 1.33 2008/04/12 14:03:13 fabiankeil + * Remove an obvious comment and improve another one. + * + * Revision 1.32 2008/04/12 12:38:06 fabiankeil + * Factor out duplicated code to compile host, path and tag patterns. + * + * Revision 1.31 2008/04/10 14:41:04 fabiankeil + * Ditch url_spec's path member now that it's no longer used. + * + * Revision 1.30 2008/04/10 04:24:24 fabiankeil + * Stop duplicating the plain text representation of the path regex + * (and keeping the copy around). Once the regex is compiled it's no + * longer useful. + * + * Revision 1.29 2008/04/10 04:17:56 fabiankeil + * In url_match(), check the right member for NULL when determining + * whether there's a path regex to execute. Looking for a plain-text + * representation works as well, but it looks "interesting" and that + * member will be removed soonish anyway. + * + * Revision 1.28 2008/04/08 16:07:39 fabiankeil + * Make it harder to mistake url_match()'s + * second parameter for an url_spec. + * + * Revision 1.27 2008/04/08 15:44:33 fabiankeil + * Save a bit of memory (and a few cpu cycles) by not bothering to + * compile slash-only path regexes that don't affect the result. + * + * Revision 1.26 2008/04/07 16:57:18 fabiankeil + * - Use free_url_spec() more consistently. + * - Let it reset url->dcount just in case. + * + * Revision 1.25 2008/04/06 15:18:38 fabiankeil + * Oh well, rename the --enable-pcre-host-patterns option to + * --enable-extended-host-patterns as it's not really PCRE syntax. + * + * Revision 1.24 2008/04/06 14:54:26 fabiankeil + * Use PCRE syntax in host patterns when configured + * with --enable-pcre-host-patterns. + * + * Revision 1.23 2008/04/05 12:19:20 fabiankeil + * Factor compile_host_pattern() out of create_url_spec(). + * + * Revision 1.22 2008/03/30 15:02:32 fabiankeil + * SZitify unknown_method(). + * + * Revision 1.21 2007/12/24 16:34:23 fabiankeil + * Band-aid (and micro-optimization) that makes it less likely to run out of + * stack space with overly-complex path patterns. Probably masks the problem + * reported by Lee in #1856679. Hohoho. + * + * Revision 1.20 2007/09/02 15:31:20 fabiankeil + * Move match_portlist() from filter.c to urlmatch.c. + * It's used for url matching, not for filtering. + * + * Revision 1.19 2007/09/02 13:42:11 fabiankeil + * - Allow port lists in url patterns. + * - Ditch unused url_spec member pathlen. + * + * Revision 1.18 2007/07/30 16:42:21 fabiankeil + * Move the method check into unknown_method() + * and loop through the known methods instead + * of using a screen-long OR chain. + * + * Revision 1.17 2007/04/15 16:39:21 fabiankeil + * Introduce tags as alternative way to specify which + * actions apply to a request. At the moment tags can be + * created based on client and server headers. + * + * Revision 1.16 2007/02/13 13:59:24 fabiankeil + * Remove redundant log message. + * + * Revision 1.15 2007/01/28 16:11:23 fabiankeil + * Accept WebDAV methods for subversion + * in parse_http_request(). Closes FR 1581425. + * + * Revision 1.14 2007/01/06 14:23:56 fabiankeil + * Fix gcc43 warnings. Mark *csp as immutable + * for parse_http_url() and url_match(). + * Replace a sprintf call with snprintf. + * + * Revision 1.13 2006/12/06 19:50:54 fabiankeil + * parse_http_url() now handles intercepted + * HTTP request lines as well. Moved parts + * of parse_http_url()'s code into + * init_domain_components() so that it can + * be reused in chat(). + * + * Revision 1.12 2006/07/18 14:48:47 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.10.2.7 2003/05/17 15:57:24 oes + * - parse_http_url now checks memory allocation failure for + * duplication of "*" URL and rejects "*something" URLs + * Closes bug #736344 + * - Added a comment to what might look like a bug in + * create_url_spec (see !bug #736931) + * - Comment cosmetics + * + * Revision 1.10.2.6 2003/05/07 12:39:48 oes + * Fix typo: Default port for https URLs is 443, not 143. + * Thanks to Scott Tregear for spotting this one. + * + * Revision 1.10.2.5 2003/02/28 13:09:29 oes + * Fixed a rare double free condition as per Bug #694713 + * + * Revision 1.10.2.4 2003/02/28 12:57:44 oes + * Moved freeing of http request structure to its owner + * as per Dan Price's observations in Bug #694713 + * + * Revision 1.10.2.3 2002/11/12 16:50:40 oes + * Fixed memory leak in parse_http_request() reported by Oliver Stoeneberg. Fixes bug #637073 + * + * Revision 1.10.2.2 2002/09/25 14:53:15 oes + * Added basic support for OPTIONS and TRACE HTTP methods: + * parse_http_url now recognizes the "*" URI as well as + * the OPTIONS and TRACE method keywords. + * + * Revision 1.10.2.1 2002/06/06 19:06:44 jongfoster + * Adding support for proprietary Microsoft WebDAV extensions + * + * Revision 1.10 2002/05/12 21:40:37 jongfoster + * - Removing some unused code + * + * Revision 1.9 2002/04/04 00:36:36 gliptak + * always use pcre for matching + * + * Revision 1.8 2002/04/03 23:32:47 jongfoster + * Fixing memory leak on error + * + * Revision 1.7 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.6 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.5 2002/03/13 00:27:05 jongfoster + * Killing warnings + * + * Revision 1.4 2002/03/07 03:46:17 oes + * Fixed compiler warnings + * + * Revision 1.3 2002/03/03 14:51:11 oes + * Fixed CLF logging: Added ocmd member for client's request to struct http_request + * + * Revision 1.2 2002/01/21 00:14:09 jongfoster + * Correcting comment style + * Fixing an uninitialized memory bug in create_url_spec() + * + * Revision 1.1 2002/01/17 20:53:46 jongfoster + * Moving all our URL and URL pattern parsing code to the same file - it + * was scattered around in filters.c, loaders.c and parsers.c. + * + * Providing a single, simple url_match(pattern,url) function - rather than + * the 3-line match routine which was repeated all over the place. + * + * Renaming free_url to free_url_spec, since it frees a struct url_spec. + * + * Providing parse_http_url() so that URLs can be parsed without faking a + * HTTP request line for parse_http_request() or repeating the parsing + * code (both of which were techniques that were actually in use). + * + * Standardizing that struct http_request is used to represent a URL, and + * struct url_spec is used to represent a URL pattern. (Before, URLs were + * represented as seperate variables and a partially-filled-in url_spec). + * + * *********************************************************************/ - +
#include "config.h"
@@ -58,13 +278,7 @@ const char urlmatch_rcs[] = "$Id: urlmatch.c,v 1.65 2011/11/06 11:41:34 fabianke
const char urlmatch_h_rcs[] = URLMATCH_H_VERSION;
-enum regex_anchoring -{ - NO_ANCHORING, - LEFT_ANCHORED, - RIGHT_ANCHORED, - RIGHT_ANCHORED_HOST -}; +enum regex_anchoring {NO_ANCHORING, LEFT_ANCHORED, RIGHT_ANCHORED}; static jb_err compile_host_pattern(struct url_spec *url, const char *host_pattern);
/********************************************************************* @@ -92,15 +306,12 @@ void free_http_request(struct http_request *http) freez(http->path); freez(http->ver); freez(http->host_ip_addr_str); -#ifndef FEATURE_EXTENDED_HOST_PATTERNS freez(http->dbuffer); freez(http->dvec); http->dcount = 0; -#endif }
-#ifndef FEATURE_EXTENDED_HOST_PATTERNS /********************************************************************* * * Function : init_domain_components @@ -164,54 +375,6 @@ jb_err init_domain_components(struct http_request *http)
return JB_ERR_OK; } -#endif /* ndef FEATURE_EXTENDED_HOST_PATTERNS */ - - -/********************************************************************* - * - * Function : url_requires_percent_encoding - * - * Description : Checks if an URL contains invalid characters - * according to RFC 3986 that should be percent-encoded. - * Does not verify whether or not the passed string - * actually is a valid URL. - * - * Parameters : - * 1 : url = URL to check - * - * Returns : True in case of valid URLs, false otherwise - * - *********************************************************************/ -int url_requires_percent_encoding(const char *url) -{ - static const char allowed_characters[128] = { - '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', - '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', - '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0', - '\0', '\0', '\0', '!', '\0', '#', '$', '%', '&', ''', - '(', ')', '*', '+', ',', '-', '.', '/', '0', '1', - '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', - '\0', '=', '\0', '?', '@', 'A', 'B', 'C', 'D', 'E', - 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', - 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', - 'Z', '[', '\0', ']', '\0', '_', '\0', 'a', 'b', 'c', - 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', - 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', - 'x', 'y', 'z', '\0', '\0', '\0', '~', '\0' - }; - - while (*url != '\0') - { - const unsigned int i = (unsigned char)*url++; - if (i >= sizeof(allowed_characters) || '\0' == allowed_characters[i]) - { - return TRUE; - } - } - - return FALSE; - -}
/********************************************************************* @@ -250,11 +413,11 @@ jb_err parse_http_url(const char *url, struct http_request *http, int require_pr
/* * Check for * URI. If found, we're done. - */ + */ if (*http->url == '*') { if ( NULL == (http->path = strdup("*")) - || NULL == (http->hostport = strdup("")) ) + || NULL == (http->hostport = strdup("")) ) { return JB_ERR_MEMORY; } @@ -377,40 +540,8 @@ jb_err parse_http_url(const char *url, struct http_request *http, int require_pr host = buf; }
- /* Move after hostname before port number */ - if (*host == '[') - { - /* Numeric IPv6 address delimited by brackets */ - host++; - port = strchr(host, ']'); - - if (port == NULL) - { - /* Missing closing bracket */ - freez(buf); - return JB_ERR_PARSE; - } - - *port++ = '\0'; - - if (*port == '\0') - { - port = NULL; - } - else if (*port != ':') - { - /* Garbage after closing bracket */ - freez(buf); - return JB_ERR_PARSE; - } - } - else - { - /* Plain non-escaped hostname */ - port = strchr(host, ':'); - } - /* check if url contains port */ + port = strchr(host, ':'); if (port != NULL) { /* Contains port */ @@ -434,12 +565,10 @@ jb_err parse_http_url(const char *url, struct http_request *http, int require_pr } }
-#ifdef FEATURE_EXTENDED_HOST_PATTERNS - return JB_ERR_OK; -#else - /* Split domain name so we can compare it against wildcards */ + /* + * Split domain name so we can compare it against wildcards + */ return init_domain_components(http); -#endif /* def FEATURE_EXTENDED_HOST_PATTERNS */
}
@@ -458,7 +587,7 @@ jb_err parse_http_url(const char *url, struct http_request *http, int require_pr *********************************************************************/ static int unknown_method(const char *method) { - static const char * const known_http_methods[] = { + static const char *known_http_methods[] = { /* Basic HTTP request type */ "GET", "HEAD", "POST", "PUT", "DELETE", "OPTIONS", "TRACE", "CONNECT", /* webDAV extensions (RFC2518) */ @@ -467,14 +596,14 @@ static int unknown_method(const char *method) * Microsoft webDAV extension for Exchange 2000. See: * http://lists.w3.org/Archives/Public/w3c-dist-auth/2002JanMar/0001.html * http://msdn.microsoft.com/library/en-us/wss/wss/_webdav_methods.asp - */ + */ "BCOPY", "BMOVE", "BDELETE", "BPROPFIND", "BPROPPATCH", /* * Another Microsoft webDAV extension for Exchange 2000. See: * http://systems.cs.colorado.edu/grunwald/MobileComputing/Papers/draft-cohen-g... * http://lists.w3.org/Archives/Public/w3c-dist-auth/2002JanMar/0001.html * http://msdn.microsoft.com/library/en-us/wss/wss/_webdav_methods.asp - */ + */ "SUBSCRIBE", "UNSUBSCRIBE", "NOTIFY", "POLL", /* * Yet another WebDAV extension, this time for @@ -599,10 +728,9 @@ jb_err parse_http_request(const char *req, struct http_request *http) * * Parameters : * 1 : pattern = The pattern to compile. - * 2 : anchoring = How the regex should be modified - * before compilation. Can be either - * one of NO_ANCHORING, LEFT_ANCHORED, - * RIGHT_ANCHORED or RIGHT_ANCHORED_HOST. + * 2 : anchoring = How the regex should be anchored. + * Can be either one of NO_ANCHORING, + * LEFT_ANCHORED or RIGHT_ANCHORED. * 3 : url = In case of failures, the spec member is * logged and the structure freed. * 4 : regex = Where the compiled regex should be stored. @@ -636,9 +764,6 @@ static jb_err compile_pattern(const char *pattern, enum regex_anchoring anchorin case RIGHT_ANCHORED: fmt = "%s$"; break; - case RIGHT_ANCHORED_HOST: - fmt = "%s\.?$"; - break; case LEFT_ANCHORED: fmt = "^%s"; break; @@ -719,33 +844,7 @@ static jb_err compile_url_pattern(struct url_spec *url, char *buf) *p = '\0'; }
- /* - * IPv6 numeric hostnames can contain colons, thus we need - * to delimit the hostname before the real port separator. - * As brackets are already used in the hostname pattern, - * we use angle brackets ('<', '>') instead. - */ - if ((buf[0] == '<') && (NULL != (p = strchr(buf + 1, '>')))) - { - *p++ = '\0'; - buf++; - - if (*p == '\0') - { - /* IPv6 address without port number */ - p = NULL; - } - else if (*p != ':') - { - /* Garbage after address delimiter */ - return JB_ERR_PARSE; - } - } - else - { - p = strchr(buf, ':'); - } - + p = strchr(buf, ':'); if (NULL != p) { *p++ = '\0'; @@ -788,7 +887,7 @@ static jb_err compile_url_pattern(struct url_spec *url, char *buf) *********************************************************************/ static jb_err compile_host_pattern(struct url_spec *url, const char *host_pattern) { - return compile_pattern(host_pattern, RIGHT_ANCHORED_HOST, url, &url->host_regex); + return compile_pattern(host_pattern, RIGHT_ANCHORED, url, &url->host_regex); }
#else @@ -826,7 +925,7 @@ static jb_err compile_host_pattern(struct url_spec *url, const char *host_patter url->unanchored |= ANCHOR_LEFT; }
- /* + /* * Split domain into components */ url->dbuffer = strdup(host_pattern); @@ -836,7 +935,7 @@ static jb_err compile_host_pattern(struct url_spec *url, const char *host_patter return JB_ERR_MEMORY; }
- /* + /* * Map to lower case */ for (p = url->dbuffer; *p ; p++) @@ -844,7 +943,7 @@ static jb_err compile_host_pattern(struct url_spec *url, const char *host_patter *p = (char)tolower((int)(unsigned char)*p); }
- /* + /* * Split the domain name into components */ url->dcount = ssplit(url->dbuffer, ".", v, SZ(v), 1, 1); @@ -856,11 +955,11 @@ static jb_err compile_host_pattern(struct url_spec *url, const char *host_patter } else if (url->dcount != 0) { - /* + /* * Save a copy of the pointers in dvec */ size = (size_t)url->dcount * sizeof(*url->dvec); - + url->dvec = (char **)malloc(size); if (NULL == url->dvec) { @@ -899,13 +998,13 @@ static int simplematch(const char *pattern, const char *text) { const unsigned char *pat = (const unsigned char *)pattern; const unsigned char *txt = (const unsigned char *)text; - const unsigned char *fallback = pat; + const unsigned char *fallback = pat; int wildcard = 0; - + unsigned char lastchar = 'a'; unsigned i; unsigned char charmap[32]; - + while (*txt) {
@@ -923,15 +1022,15 @@ static int simplematch(const char *pattern, const char *text) }
/* '*' in the pattern? */ - if (*pat == '*') + if (*pat == '*') { - + /* The pattern ends afterwards? Speed up the return. */ if (*++pat == '\0') { return 0; } - + /* Else, set wildcard mode and remember position after '*' */ wildcard = 1; fallback = pat; @@ -945,7 +1044,7 @@ static int simplematch(const char *pattern, const char *text) while (*++pat != ']') { if (!*pat) - { + { return 1; } else if (*pat == '-') @@ -957,7 +1056,7 @@ static int simplematch(const char *pattern, const char *text) for (i = lastchar; i <= *pat; i++) { charmap[i / 8] |= (unsigned char)(1 << (i % 8)); - } + } } else { @@ -968,21 +1067,21 @@ static int simplematch(const char *pattern, const char *text) } /* -END- if Character range specification */
- /* - * Char match, or char range match? + /* + * Char match, or char range match? */ if ( (*pat == *txt) || (*pat == '?') || ((*pat == ']') && (charmap[*txt / 8] & (1 << (*txt % 8)))) ) { - /* - * Success: Go ahead + /* + * Sucess: Go ahead */ pat++; } else if (!wildcard) { - /* + /* * No match && no wildcard: No luck */ return 1; @@ -1174,15 +1273,15 @@ jb_err create_url_spec(struct url_spec *url, char *buf) return JB_ERR_MEMORY; }
- /* Is it a tag pattern? */ - if (0 == strncmpic(url->spec, "TAG:", 4)) + /* Is it tag pattern? */ + if (0 == strncmpic("TAG:", url->spec, 4)) { /* The pattern starts with the first character after "TAG:" */ const char *tag_pattern = buf + 4; return compile_pattern(tag_pattern, NO_ANCHORING, url, &url->tag_regex); }
- /* If it isn't a tag pattern it must be an URL pattern. */ + /* If it isn't a tag pattern it must be a URL pattern. */ return compile_url_pattern(url, buf); }
@@ -1232,70 +1331,6 @@ void free_url_spec(struct url_spec *url)
/********************************************************************* * - * Function : port_matches - * - * Description : Compares a port against a port list. - * - * Parameters : - * 1 : port = The port to check. - * 2 : port_list = The list of port to compare with. - * - * Returns : TRUE for yes, FALSE otherwise. - * - *********************************************************************/ -static int port_matches(const int port, const char *port_list) -{ - return ((NULL == port_list) || match_portlist(port_list, port)); -} - - -/********************************************************************* - * - * Function : host_matches - * - * Description : Compares a host against a host pattern. - * - * Parameters : - * 1 : url = The URL to match - * 2 : pattern = The URL pattern - * - * Returns : TRUE for yes, FALSE otherwise. - * - *********************************************************************/ -static int host_matches(const struct http_request *http, - const struct url_spec *pattern) -{ -#ifdef FEATURE_EXTENDED_HOST_PATTERNS - return ((NULL == pattern->host_regex) - || (0 == regexec(pattern->host_regex, http->host, 0, NULL, 0))); -#else - return ((NULL == pattern->dbuffer) || (0 == domain_match(pattern, http))); -#endif -} - - -/********************************************************************* - * - * Function : path_matches - * - * Description : Compares a path against a path pattern. - * - * Parameters : - * 1 : path = The path to match - * 2 : pattern = The URL pattern - * - * Returns : TRUE for yes, FALSE otherwise. - * - *********************************************************************/ -static int path_matches(const char *path, const struct url_spec *pattern) -{ - return ((NULL == pattern->preg) - || (0 == regexec(pattern->preg, path, 0, NULL, 0))); -} - - -/********************************************************************* - * * Function : url_match * * Description : Compare a URL against a URL pattern. @@ -1310,14 +1345,22 @@ static int path_matches(const char *path, const struct url_spec *pattern) int url_match(const struct url_spec *pattern, const struct http_request *http) { + /* XXX: these should probably be functions. */ +#define PORT_MATCHES ((NULL == pattern->port_list) || match_portlist(pattern->port_list, http->port)) +#ifdef FEATURE_EXTENDED_HOST_PATTERNS +#define DOMAIN_MATCHES ((NULL == pattern->host_regex) || (0 == regexec(pattern->host_regex, http->host, 0, NULL, 0))) +#else +#define DOMAIN_MATCHES ((NULL == pattern->dbuffer) || (0 == domain_match(pattern, http))) +#endif +#define PATH_MATCHES ((NULL == pattern->preg) || (0 == regexec(pattern->preg, http->path, 0, NULL, 0))) + if (pattern->tag_regex != NULL) { /* It's a tag pattern and shouldn't be matched against URLs */ return 0; - } + }
- return (port_matches(http->port, pattern->port_list) - && host_matches(http, pattern) && path_matches(http->path, pattern)); + return (PORT_MATCHES && DOMAIN_MATCHES && PATH_MATCHES);
}
@@ -1341,7 +1384,7 @@ int match_portlist(const char *portlist, int port) { char *min, *max, *next, *portlist_copy;
- min = portlist_copy = strdup(portlist); + min = next = portlist_copy = strdup(portlist);
/* * Zero-terminate first item and remember offset for next @@ -1354,7 +1397,7 @@ int match_portlist(const char *portlist, int port) /* * Loop through all items, checking for match */ - while (NULL != min) + while(min) { if (NULL == (max = strchr(min, (int) '-'))) { @@ -1402,59 +1445,6 @@ int match_portlist(const char *portlist, int port) }
-/********************************************************************* - * - * Function : parse_forwarder_address - * - * Description : Parse out the host and port from a forwarder address. - * - * Parameters : - * 1 : address = The forwarder address to parse. - * 2 : hostname = Used to return the hostname. NULL on error. - * 3 : port = Used to return the port. Untouched if no port - * is specified. - * - * Returns : JB_ERR_OK on success - * JB_ERR_MEMORY on out of memory - * JB_ERR_PARSE on malformed address. - * - *********************************************************************/ -jb_err parse_forwarder_address(char *address, char **hostname, int *port) -{ - char *p = address; - - if ((*address == '[') && (NULL == strchr(address, ']'))) - { - /* XXX: Should do some more validity checks here. */ - return JB_ERR_PARSE; - } - - *hostname = strdup(address); - if (NULL == *hostname) - { - return JB_ERR_MEMORY; - } - - if ((**hostname == '[') && (NULL != (p = strchr(*hostname, ']')))) - { - *p++ = '\0'; - memmove(*hostname, (*hostname + 1), (size_t)(p - *hostname)); - if (*p == ':') - { - *port = (int)strtol(++p, NULL, 0); - } - } - else if (NULL != (p = strchr(*hostname, ':'))) - { - *p++ = '\0'; - *port = (int)strtol(p, NULL, 0); - } - - return JB_ERR_OK; - -} - - /* Local Variables: tab-width: 3 diff --git a/external/privoxy/urlmatch.h b/external/privoxy/urlmatch.h index 0cf22f2..db5c60b 100644 --- a/external/privoxy/urlmatch.h +++ b/external/privoxy/urlmatch.h @@ -1,6 +1,6 @@ #ifndef URLMATCH_H_INCLUDED #define URLMATCH_H_INCLUDED -#define URLMATCH_H_VERSION "$Id: urlmatch.h,v 1.18 2011/11/06 11:41:05 fabiankeil Exp $" +#define URLMATCH_H_VERSION "$Id: urlmatch.h,v 1.13 2009/03/02 19:18:11 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/urlmatch.h,v $ @@ -8,14 +8,14 @@ * Purpose : Declares functions to match URLs against URL * patterns. * - * Copyright : Written by and Copyright (C) 2001-2002, 2006 the + * Copyright : Written by and Copyright (C) 2001-2002, 2006 the SourceForge * Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -33,8 +33,69 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: urlmatch.h,v $ + * Revision 1.13 2009/03/02 19:18:11 fabiankeil + * Streamline parse_http_request()'s prototype. As + * cparser pointed out it doesn't actually use csp. + * + * Revision 1.12 2008/05/04 16:18:32 fabiankeil + * Provide parse_http_url() with a third parameter to specify + * whether or not URLs without protocol are acceptable. + * + * Revision 1.11 2008/05/04 13:30:55 fabiankeil + * Streamline parse_http_url()'s prototype. + * + * Revision 1.10 2008/04/14 18:11:21 fabiankeil + * The compiler might not notice it, but the buffer passed to + * create_url_spec() is modified later on and thus shouldn't + * be declared immutable. + * + * Revision 1.9 2008/04/08 16:07:39 fabiankeil + * Make it harder to mistake url_match()'s + * second parameter for an url_spec. + * + * Revision 1.8 2007/09/02 15:31:20 fabiankeil + * Move match_portlist() from filter.c to urlmatch.c. + * It's used for url matching, not for filtering. + * + * Revision 1.7 2007/01/06 14:24:38 fabiankeil + * Mark *csp as immutable for parse_http_url() + * and url_match(). + * + * Revision 1.6 2006/12/06 19:12:43 fabiankeil + * Added prototype for init_domain_components(). + * + * Revision 1.5 2006/07/18 14:48:47 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.3 2002/03/26 22:29:55 swa + * we have a new homepage! + * + * Revision 1.2 2002/03/24 13:25:43 swa + * name change related issues + * + * Revision 1.1 2002/01/17 20:53:46 jongfoster + * Moving all our URL and URL pattern parsing code to the same file - it + * was scattered around in filters.c, loaders.c and parsers.c. + * + * Providing a single, simple url_match(pattern,url) function - rather than + * the 3-line match routine which was repeated all over the place. + * + * Renaming free_url to free_url_spec, since it frees a struct url_spec. + * + * Providing parse_http_url() so that URLs can be parsed without faking a + * HTTP request line for parse_http_request() or repeating the parsing + * code (both of which were techniques that were actually in use). + * + * Standardizing that struct http_request is used to represent a URL, and + * struct url_spec is used to represent a URL pattern. (Before, URLs were + * represented as seperate variables and a partially-filled-in url_spec). + * + * *********************************************************************/ - +
#include "project.h"
@@ -43,15 +104,11 @@ extern "C" { #endif
extern void free_http_request(struct http_request *http); -#ifndef FEATURE_EXTENDED_HOST_PATTERNS extern jb_err init_domain_components(struct http_request *http); -#endif extern jb_err parse_http_request(const char *req, struct http_request *http); extern jb_err parse_http_url(const char *url, struct http_request *http, int require_protocol); -extern int url_requires_percent_encoding(const char *url); - #define REQUIRE_PROTOCOL 1
extern int url_match(const struct url_spec *pattern, @@ -60,7 +117,6 @@ extern int url_match(const struct url_spec *pattern, extern jb_err create_url_spec(struct url_spec *url, char *buf); extern void free_url_spec(struct url_spec *url); extern int match_portlist(const char *portlist, int port); -extern jb_err parse_forwarder_address(char *address, char **hostname, int *port);
/* Revision control strings from this header and associated .c file */ diff --git a/external/privoxy/user.action b/external/privoxy/user.action index 2a990b1..7b18dd9 100644 --- a/external/privoxy/user.action +++ b/external/privoxy/user.action @@ -2,7 +2,7 @@ # # File : $Source: /cvsroot/ijbswa/current/user.action,v $ # -# $Id: user.action,v 1.13 2011/11/06 11:36:01 fabiankeil Exp $ +# $Id: user.action,v 1.9 2008/03/27 18:27:37 fabiankeil Exp $ # # Purpose : User-maintained actions file, see # http://www.privoxy.org/user-manual/actions-file.html @@ -166,32 +166,4 @@ www.example.com/nasty-ads/sponsor.gif { +set-image-blocker{blank} } #/
-# Enable the following section (not the regression-test directives) -# to rewrite and redirect click-tracking URLs on news.google.com. -# Disabling JavaScript should work as well and probably works more reliably. -# -# Redirected URL = http://news.google.com/news/url?ct2=us%2F0_0_s_1_1_a&sa=t&usg=AFQjCN... -# Redirect Destination = http://online.wsj.com/article/SB10001424052970204485304576640791304008536.ht... -# Ignore = Yes -# -#{+fast-redirects{check-decoded-url}} -#news.google.com/news/url.*&url=http.*& - -# Enable the following section (not the regression-test directives) -# to block various Facebook "like" and similar tracking URLs. At the -# time this section was added it was reported to not break Facebook -# itself but this may have changed by the time you read this. This URL -# list is probably incomplete and if you don't have an account anyway, -# you may prefer to block the whole domain. -# -# Blocked URL = http://www.facebook.com/plugins/likebox.php?href=http%3A%2F%2Ffacebook.com%2... -# Ignore = Yes -# Blocked URL = http://www.facebook.com/plugins/activity.php?site=arstechnica.com&width=... -# Ignore = Yes -# Blocked URL = http://www.facebook.com/plugins/fan.php?api_key=368513495882&connections... -# Ignore = Yes -# Blocked URL = http://www.facebook.com/plugins/like.php?api_key=368513495882&channel_ur... -# Ignore = Yes -# -#{+block{Facebook "like" and similar tracking URLs.}} -#www.facebook.com/(extern|plugins)/(login_status|like(box)?|activity|fan).php +## set vi:nowrap tw=72 diff --git a/external/privoxy/utils/changelog2doc.pl b/external/privoxy/utils/changelog2doc.pl index 4e6196c..a12cb32 100755 --- a/external/privoxy/utils/changelog2doc.pl +++ b/external/privoxy/utils/changelog2doc.pl @@ -1,27 +1,11 @@ #!/usr/bin/perl
-########################################################################## -# -# $Id: changelog2doc.pl,v 1.8 2011/11/13 17:00:54 fabiankeil Exp $ -# +# $Id: changelog2doc.pl,v 1.2 2008/09/26 16:49:09 fabiankeil Exp $ +# $Source: /cvsroot/ijbswa/current/utils/changelog2doc.pl,v $ + # Filter to parse the ChangeLog and translate the changes for # the most recent version into something that looks like markup # for the documentation but still needs fine-tuning. -# -# Copyright (c) 2008, 2010 Fabian Keil fk@fabiankeil.de -# -# Permission to use, copy, modify, and distribute this software for any -# purpose with or without fee is hereby granted, provided that the above -# copyright notice and this permission notice appear in all copies. -# -# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES -# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF -# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR -# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES -# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN -# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF -# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -##########################################################################
use strict; use warnings; @@ -41,80 +25,37 @@ sub read_entries() { next unless $section_reached; next if /^\s*$/;
- if (/^(\s*)-/) { - my $indentation = length($1); - if ($i > 1 and $entries[$i]{indentation} > $indentation) { - $entries[$i]{last_list_item} = 1; - } + if (/^-/) { $i++; - $entries[$i]{description} = ''; - $entries[$i]{indentation} = $indentation; - } - if (/:\s*$/) { - $entries[$i]{list_header} = 1; + $entries[$i] = ''; } + s@^-?\s*@@;
- s@^\s*-?\s*@@; - - $entries[$i]{description} .= $_; - } - if ($entries[$i]{indentation} != 0) { - $entries[$i]{last_list_item} = 1; + $entries[$i] .= $_; } print "Parsed " . @entries . " entries.\n"; }
-sub create_listitem_markup($) { - my $entry = shift; - my $description = $entry->{description}; - my $markup = ''; - my $default_lws = ' '; - my $lws = $default_lws x ($entry->{indentation} ? 2 : 1); - - chomp $description; - - $description =~ s@\n@\n ${lws}@g; - - $markup .= $lws . "<listitem>\n" . - $lws . " <para>\n"; - - $markup .= $lws . " " . $description . "\n"; - - if (defined $entry->{list_header}) { - $markup .= $lws . " <itemizedlist>\n"; - - } else { - if (defined $entry->{last_list_item}) { - $markup .= $lws . " </para>\n"; - $markup .= $lws . " </listitem>\n"; - $markup .= $lws . "</itemizedlist>\n"; - $lws = $default_lws; - } - $markup .= $lws . " </para>\n" . - $lws . "</listitem>\n"; - } - - return $markup; -} - -sub wrap_in_para_itemlist_markup($) { - my $content = shift; - my $markup = "<para>\n" . - " <itemizedlist>\n" . - " $content" . - " </itemizedlist>\n" . - "</para>\n"; - return $markup; -} - sub generate_markup() { my $markup = '';
+ $markup .= "<para>\n" . + " <itemizedlist>\n"; + foreach my $entry (@entries) { - $markup .= create_listitem_markup(%{$entry}); + chomp $entry; + $entry =~ s@\n@\n @g; + $markup .= " <listitem>\n" . + " <para>\n" . + " " . $entry . "\n" . + " </para>\n" . + " </listitem>\n" + ; } + $markup .= " </itemizedlist>\n" . + "</para>\n";
- print wrap_in_para_itemlist_markup($markup); + print $markup; }
sub main () { diff --git a/external/privoxy/w32.rc b/external/privoxy/w32.rc index ec7ff26..93b518a 100644 --- a/external/privoxy/w32.rc +++ b/external/privoxy/w32.rc @@ -4,7 +4,7 @@ * * Purpose : Windows GUI resource script. * - * Copyright : Written by and Copyright (C) 2001-2009 members of + * Copyright : Written by and Copyright (C) 2001-2002 members of * the Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written @@ -29,6 +29,128 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: w32.rc,v $ + * Revision 1.22 2009/01/01 15:09:23 ler762 + * Change the Windows taskbar icon when privoxy is toggled off. + * + * Revision 1.21 2008/11/02 14:37:47 ler762 + * commit the part of the patches I've been using that were written by torford and gjmurphy + * [ 1824315 ] Minor code cleanup + * [ 1781135 ] Patch - Add clear log, select all, and Accelerators for w32 + * http://sourceforge.net/tracker/?func=detail&atid=311118&aid=1781135&... + * The full patch adds control keys A(select all), C(copy) and D(delete all) to the + * Privoxy log window menu. Select all and copy work for me without the patch + * (albeit without showing the accelerator keys on the menu), so the only part of the + * patch I've been using for the last year or so has been the ctrl-d to delete + * everything in the Privoxy log window. + * + * Revision 1.20 2006/08/18 02:06:25 david__schmidt + * Making icon go back to blue when idle. + * See: bug #967648. + * + * Revision 1.19 2006/07/18 14:48:48 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.17.2.1 2002/08/21 17:58:40 oes + * - Reorder of Win32 menu + * - "Show Privoxy Window" now a toggle + * - Temp kludge to let user and default action file be edited through win32 GUI (FR 592080) + * + * Revision 1.17 2002/03/31 17:19:00 jongfoster + * Win32 only: Enabling STRICT to fix a VC++ compile warning. + * + * Revision 1.16 2002/03/26 22:57:44 jongfoster + * Web server name should begin www. + * + * Revision 1.15 2002/03/24 14:29:25 jongfoster + * Renaming icon file + * + * Revision 1.14 2002/03/24 12:07:36 jongfoster + * Consistern name for filters file + * + * Revision 1.13 2002/03/24 12:03:47 jongfoster + * Name change + * + * Revision 1.12 2001/07/30 22:16:07 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.11 2001/07/21 17:53:41 jongfoster + * Adding version information block. + * + * Revision 1.10 2001/07/19 19:14:19 haroon + * - Removed all #ifdef PCRS. The .rc file extension had eluded Andreas. + * + * Revision 1.9 2001/06/07 23:08:54 jongfoster + * Forward and ACL edit options removed. + * Config edit option renamed from "&Junkbuster" to "&Configuration". + * + * Revision 1.8 2001/05/31 21:37:11 jongfoster + * GUI changes to rename "permissions file" to "actions file". + * + * Revision 1.7 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.6 2001/05/26 14:15:18 jongfoster + * Cosmetic fix: // -> block comment + * + * Revision 1.5 2001/05/26 13:24:31 jongfoster + * New #define, WIN_GUI_EDIT, enables the (embryonic) Win32 GUI editor. + * This #define cannot be set from ./configure - there's no point, it + * doesn't work yet. See feature request # 425722 + * (I missed this file in my original checkin) + * + * Revision 1.4 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.3 2001/05/25 22:33:40 jongfoster + * CRLF->LF + * + * Revision 1.2 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.1.1.1 2001/05/15 13:59:07 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/
#include "config.h" @@ -61,14 +183,14 @@ * remains consistent on all systems. */ IDI_MAINICON ICON DISCARDABLE "icons/privoxy.ico" -IDI_ANIMATED1 ICON DISCARDABLE "icons/radar-01.ico" -IDI_ANIMATED2 ICON DISCARDABLE "icons/radar-02.ico" -IDI_ANIMATED3 ICON DISCARDABLE "icons/radar-03.ico" -IDI_ANIMATED4 ICON DISCARDABLE "icons/radar-04.ico" -IDI_ANIMATED5 ICON DISCARDABLE "icons/radar-05.ico" -IDI_ANIMATED6 ICON DISCARDABLE "icons/radar-06.ico" -IDI_ANIMATED7 ICON DISCARDABLE "icons/radar-07.ico" -IDI_ANIMATED8 ICON DISCARDABLE "icons/radar-08.ico" +IDI_ANIMATED1 ICON DISCARDABLE "icons/ico00001.ico" +IDI_ANIMATED2 ICON DISCARDABLE "icons/ico00002.ico" +IDI_ANIMATED3 ICON DISCARDABLE "icons/ico00003.ico" +IDI_ANIMATED4 ICON DISCARDABLE "icons/ico00004.ico" +IDI_ANIMATED5 ICON DISCARDABLE "icons/ico00005.ico" +IDI_ANIMATED6 ICON DISCARDABLE "icons/ico00006.ico" +IDI_ANIMATED7 ICON DISCARDABLE "icons/ico00007.ico" +IDI_ANIMATED8 ICON DISCARDABLE "icons/ico00008.ico" IDI_IDLE ICON DISCARDABLE "icons/privoxy.ico" IDI_OFF ICON DISCARDABLE "icons/off.ico"
@@ -141,8 +263,7 @@ BEGIN MENUITEM "&Main Configuration", ID_TOOLS_EDITCONFIG MENUITEM "&Default Actions", ID_TOOLS_EDITDEFAULTACTIONS MENUITEM "&User Actions", ID_TOOLS_EDITUSERACTIONS - MENUITEM "Default &Filters", ID_TOOLS_EDITDEFAULTFILTERS - MENUITEM "U&ser Filters", ID_TOOLS_EDITUSERFILTERS + MENUITEM "&Filters", ID_TOOLS_EDITFILTERS #ifdef FEATURE_TRUST MENUITEM "&Trust list", ID_TOOLS_EDITTRUST #endif /* def FEATURE_TRUST */ @@ -183,8 +304,7 @@ BEGIN MENUITEM "Edit Main &Configuration", ID_TOOLS_EDITCONFIG MENUITEM "Edit &Default Actions", ID_TOOLS_EDITDEFAULTACTIONS MENUITEM "Edit &User Actions", ID_TOOLS_EDITUSERACTIONS - MENUITEM "Edit Default &Filters", ID_TOOLS_EDITDEFAULTFILTERS - MENUITEM "Edit U&ser Filters", ID_TOOLS_EDITUSERFILTERS + MENUITEM "Edit &Filters", ID_TOOLS_EDITFILTERS #ifdef FEATURE_TRUST MENUITEM "Edit &Trust list", ID_TOOLS_EDITTRUST #endif /* def FEATURE_TRUST */ diff --git a/external/privoxy/w32log.c b/external/privoxy/w32log.c index 76f8cdc..e5df8b0 100644 --- a/external/privoxy/w32log.c +++ b/external/privoxy/w32log.c @@ -1,4 +1,4 @@ -const char w32log_rcs[] = "$Id: w32log.c,v 1.40 2011/09/04 11:10:56 fabiankeil Exp $"; +const char w32log_rcs[] = "$Id: w32log.c,v 1.33 2009/03/09 19:02:09 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/w32log.c,v $ @@ -12,7 +12,7 @@ const char w32log_rcs[] = "$Id: w32log.c,v 1.40 2011/09/04 11:10:56 fabiankeil E * Written by and Copyright (C) 1999 Adam Lock * locka@iol.ie * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -30,8 +30,183 @@ const char w32log_rcs[] = "$Id: w32log.c,v 1.40 2011/09/04 11:10:56 fabiankeil E * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: w32log.c,v $ + * Revision 1.33 2009/03/09 19:02:09 fabiankeil + * Request the default charset in LogPutStringNoMatch(). + * Submitted by Burberry in #2674342 as fix for #2662382. + * + * Revision 1.32 2009/03/09 18:32:48 fabiankeil + * Use the Privoxy icon in the alt+tab window. + * Patch submitted by Burberry in #2674342. + * + * Revision 1.31 2009/03/07 17:58:02 fabiankeil + * Fix two mingw32-only buffer overflows. Note that triggering + * them requires control over the configuration file in which + * case all bets are off anyway. + * + * Revision 1.30 2009/01/01 15:09:23 ler762 + * Change the Windows taskbar icon when privoxy is toggled off. + * + * Revision 1.29 2008/12/20 15:27:40 ler762 + * The crunch log message format changed, so update the strings to highlight + * in the log window. + * + * Revision 1.28 2008/11/02 14:37:47 ler762 + * commit the part of the patches I've been using that were written by torford and gjmurphy + * [ 1824315 ] Minor code cleanup + * [ 1781135 ] Patch - Add clear log, select all, and Accelerators for w32 + * http://sourceforge.net/tracker/?func=detail&atid=311118&aid=1781135&... + * The full patch adds control keys A(select all), C(copy) and D(delete all) to the + * Privoxy log window menu. Select all and copy work for me without the patch + * (albeit without showing the accelerator keys on the menu), so the only part of the + * patch I've been using for the last year or so has been the ctrl-d to delete + * everything in the Privoxy log window. + * + * Revision 1.27 2006/07/18 14:48:48 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.25.2.5 2003/04/04 12:48:51 oes + * Fixed bug #711865: + * - Made tray menu correctly reflect initial window visibility state + * - Hopefully fixed problem where log window contents wasn't visible + * until vertical scroll bar was clicked. Thanks to Guy for the fix! + * + * Revision 1.25.2.4 2003/03/11 11:53:59 oes + * Cosmetic: Renamed cryptic variable + * + * Revision 1.25.2.3 2002/11/20 14:39:05 oes + * Fixed compiler warning + * + * Revision 1.25.2.2 2002/09/25 15:23:10 oes + * Uncheck the "Show Privoxy Window" taskbar menu item when window gets minimized. Fixes bug #606804 + * + * Revision 1.25.2.1 2002/08/21 17:59:05 oes + * - "Show Privoxy Window" now a toggle + * - Temp kludge to let user and default action file be edited through win32 GUI (FR 592080) + * + * Revision 1.25 2002/04/04 00:36:36 gliptak + * always use pcre for matching + * + * Revision 1.24 2002/03/31 17:19:00 jongfoster + * Win32 only: Enabling STRICT to fix a VC++ compile warning. + * + * Revision 1.23 2002/03/26 22:57:10 jongfoster + * Web server name should begin www. + * + * Revision 1.22 2002/03/24 12:48:23 jongfoster + * Fixing doc links + * + * Revision 1.21 2002/03/24 12:07:35 jongfoster + * Consistern name for filters file + * + * Revision 1.20 2002/03/24 12:03:47 jongfoster + * Name change + * + * Revision 1.19 2002/01/17 21:04:17 jongfoster + * Replacing hard references to the URL of the config interface + * with #defines from project.h + * + * Revision 1.18 2001/11/30 23:37:24 jongfoster + * Renaming the Win32 config file to config.txt - this is almost the + * same as the corresponding UNIX name "config" + * + * Revision 1.17 2001/11/16 00:46:31 jongfoster + * Fixing compiler warnings + * + * Revision 1.16 2001/08/01 19:58:12 jongfoster + * Fixing documentation filenames in help menu, and making status + * option work without needing the "Junkbuster Status.URL" file. + * + * Revision 1.15 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.14 2001/07/29 18:47:05 jongfoster + * Adding missing #include "loadcfg.h" + * + * Revision 1.13 2001/07/19 19:15:14 haroon + * - Added a FIXME for EditFile but didn't fix :-) + * + * Revision 1.12 2001/07/13 14:04:59 oes + * Removed all #ifdef PCRS + * + * Revision 1.11 2001/06/07 23:08:12 jongfoster + * Forward and ACL edit options removed. + * + * Revision 1.10 2001/05/31 21:37:11 jongfoster + * GUI changes to rename "permissions file" to "actions file". + * + * Revision 1.9 2001/05/31 17:33:13 oes + * + * CRLF -> LF + * + * Revision 1.8 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.7 2001/05/26 01:26:34 jongfoster + * New #define, WIN_GUI_EDIT, enables the (embryonic) Win32 GUI editor. + * This #define cannot be set from ./configure - there's no point, it + * doesn't work yet. See feature request # 425722 + * + * Revision 1.6 2001/05/26 00:31:30 jongfoster + * Fixing compiler warning about comparing signed/unsigned. + * + * Revision 1.5 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.4 2001/05/22 18:56:28 oes + * CRLF -> LF + * + * Revision 1.3 2001/05/20 15:07:54 jongfoster + * File is now ignored if _WIN_CONSOLE is defined. + * + * Revision 1.2 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.1.1.1 2001/05/15 13:59:07 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -135,8 +310,7 @@ int g_nFontSize = DEFAULT_LOG_FONT_SIZE;
const char * g_default_actions_file = NULL; const char * g_user_actions_file = NULL; -const char * g_default_filterfile = NULL; -const char * g_user_filterfile = NULL; +const char * g_re_filterfile = NULL; #ifdef FEATURE_TRUST const char * g_trustfile = NULL; #endif /* def FEATURE_TRUST */ @@ -168,11 +342,6 @@ static struct _Pattern { "Crunch: Forwarding failed", STYLE_HIGHLIGHT }, { "Crunch: Connection failure", STYLE_HIGHLIGHT }, { "Crunch: Out of memory", STYLE_HIGHLIGHT }, - { "Connect: Found reusable socket", STYLE_HIGHLIGHT }, - { "Connect: Reusing server socket", STYLE_HIGHLIGHT }, - { "Connect: Created new connection to", STYLE_HIGHLIGHT }, - { "hung up on us", STYLE_HIGHLIGHT }, - { "Crunching Referer:", STYLE_HIGHLIGHT }, /* what are all the possible error strings?? */ { "Error:", STYLE_HIGHLIGHT }, /* http headers */ @@ -352,6 +521,67 @@ void LogDestroyPatternMatchingBuffers(void)
/********************************************************************* * + * Function : LogGetURLUnderCursor + * + * Description : Returns the URL from under the cursor (remember to free it!). + * + * Parameters : None + * + * Returns : NULL or a pointer to an URL string. + * + *********************************************************************/ +char *LogGetURLUnderCursor(void) +{ + char *szResult = NULL; + regex_t re; + POINT ptCursor; + POINTL ptl; + DWORD nPos; + DWORD nWordStart = 0; + DWORD nWordEnd = 0; + + regcomp(&re, RE_URL, REG_ICASE); + + /* Get the position of the cursor over the text window */ + GetCursorPos(&ptCursor); + ScreenToClient(g_hwndLogBox, &ptCursor); + ptl.x = ptCursor.x; + ptl.y = ptCursor.y; + + /* Search backwards and fowards to obtain the word that is highlighted */ + nPos = LOWORD(SendMessage(g_hwndLogBox, EM_CHARFROMPOS, 0, (LPARAM) &ptl)); + nWordStart = SendMessage(g_hwndLogBox, EM_FINDWORDBREAK, WB_LEFT, nPos); + nWordEnd = SendMessage(g_hwndLogBox, EM_FINDWORDBREAK, WB_RIGHTBREAK, nPos); + + /* Compare the string to the pattern */ + if (nWordEnd > nWordStart) + { + TEXTRANGE range; + regmatch_t match; + + range.chrg.cpMin = nWordStart; + range.chrg.cpMax = nWordEnd; + range.lpstrText = (LPSTR)zalloc(nWordEnd - nWordStart + 1); + SendMessage(g_hwndLogBox, EM_GETTEXTRANGE, 0, (LPARAM) &range); + + if (regexec(&re, range.lpstrText, 1, &match, 0) == 0) + { + szResult = range.lpstrText; + } + else + { + free(range.lpstrText); + } + + regfree(&re); + } + return szResult; + +} + + +/********************************************************************* + * * Function : LogPutString * * Description : Inserts text into the logging window. This is really @@ -370,12 +600,12 @@ int LogPutString(const char *pszText) int i; int result = 0;
- if (!g_bLogMessages) + if (pszText == NULL || strlen(pszText) == 0) { return 1; }
- if (pszText == NULL || strlen(pszText) == 0) + if (!g_bLogMessages) { return 1; } @@ -598,13 +828,13 @@ void LogClipBuffer(void) range.cpMin = SendMessage (g_hwndLogBox, WM_GETTEXTLENGTH, 0, 0); range.cpMax = -1; SendMessage(g_hwndLogBox, EM_EXSETSEL, 0, (LPARAM) &range); - + /* restore vertical ScrollBar stuff (messed up by AUTOVSCROLL) */ SendMessage (g_hwndLogBox, EM_SCROLL, SB_LINEDOWN, 0); - + }
-} +}
/********************************************************************* @@ -806,7 +1036,7 @@ void ShowLogWindow(BOOL bShow) { SetForegroundWindow(g_hwndLogFrame); SetWindowPos(g_hwndLogFrame, HWND_TOP, 0, 0, 0, 0, SWP_SHOWWINDOW | SWP_NOSIZE | SWP_NOMOVE); - + } else if (g_bShowOnTaskBar) { @@ -971,12 +1201,8 @@ void OnLogCommand(int nCommand) EditFile(g_user_actions_file); break;
- case ID_TOOLS_EDITDEFAULTFILTERS: - EditFile(g_default_filterfile); - break; - - case ID_TOOLS_EDITUSERFILTERS: - EditFile(g_user_filterfile); + case ID_TOOLS_EDITFILTERS: + EditFile(g_re_filterfile); break;
#ifdef FEATURE_TRUST @@ -1031,8 +1257,7 @@ void OnLogInitMenu(HMENU hmenu) /* Only enable editors if there is a file to edit */ EnableMenuItem(hmenu, ID_TOOLS_EDITDEFAULTACTIONS, MF_BYCOMMAND | (g_default_actions_file ? MF_ENABLED : MF_GRAYED)); EnableMenuItem(hmenu, ID_TOOLS_EDITUSERACTIONS, MF_BYCOMMAND | (g_user_actions_file ? MF_ENABLED : MF_GRAYED)); - EnableMenuItem(hmenu, ID_TOOLS_EDITDEFAULTFILTERS, MF_BYCOMMAND | (g_default_filterfile ? MF_ENABLED : MF_GRAYED)); - EnableMenuItem(hmenu, ID_TOOLS_EDITUSERFILTERS, MF_BYCOMMAND | (g_user_filterfile ? MF_ENABLED : MF_GRAYED)); + EnableMenuItem(hmenu, ID_TOOLS_EDITFILTERS, MF_BYCOMMAND | (g_re_filterfile ? MF_ENABLED : MF_GRAYED)); #ifdef FEATURE_TRUST EnableMenuItem(hmenu, ID_TOOLS_EDITTRUST, MF_BYCOMMAND | (g_trustfile ? MF_ENABLED : MF_GRAYED)); #endif /* def FEATURE_TRUST */ diff --git a/external/privoxy/w32log.h b/external/privoxy/w32log.h index c8e0371..fff13ad 100644 --- a/external/privoxy/w32log.h +++ b/external/privoxy/w32log.h @@ -1,6 +1,6 @@ #ifndef W32LOG_H_INCLUDED #define W32LOG_H_INCLUDED -#define W32LOG_H_VERSION "$Id: w32log.h,v 1.16 2011/09/04 11:10:56 fabiankeil Exp $" +#define W32LOG_H_VERSION "$Id: w32log.h,v 1.13 2009/03/07 17:58:02 fabiankeil Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/w32log.h,v $ @@ -14,7 +14,7 @@ * Written by and Copyright (C) 1999 Adam Lock * locka@iol.ie * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -32,8 +32,84 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: w32log.h,v $ + * Revision 1.13 2009/03/07 17:58:02 fabiankeil + * Fix two mingw32-only buffer overflows. Note that triggering + * them requires control over the configuration file in which + * case all bets are off anyway. + * + * Revision 1.12 2006/07/18 14:48:48 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.10.2.2 2002/11/20 14:39:05 oes + * Fixed compiler warning + * + * Revision 1.10.2.1 2002/08/21 17:58:05 oes + * Temp kludge to let user and default action file be edited through win32 GUI (FR 592080) + * + * Revision 1.10 2002/03/26 22:57:10 jongfoster + * Web server name should begin www. + * + * Revision 1.9 2002/03/24 12:03:47 jongfoster + * Name change + * + * Revision 1.8 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.7 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.6 2001/07/13 14:04:59 oes + * Removed all #ifdef PCRS + * + * Revision 1.5 2001/06/07 23:08:12 jongfoster + * Forward and ACL edit options removed. + * + * Revision 1.4 2001/05/31 21:37:11 jongfoster + * GUI changes to rename "permissions file" to "actions file". + * + * Revision 1.3 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.2 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.1.1.1 2001/05/15 13:59:07 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -73,8 +149,7 @@ extern int g_nFontSize;
extern const char * g_default_actions_file; extern const char * g_user_actions_file; -extern const char * g_default_filterfile; -extern const char * g_user_filterfile; +extern const char * g_re_filterfile; #ifdef FEATURE_TRUST extern const char * g_trustfile; #endif /* def FEATURE_TRUST */ diff --git a/external/privoxy/w32res.h b/external/privoxy/w32res.h index a0e5087..ecee2c3 100644 --- a/external/privoxy/w32res.h +++ b/external/privoxy/w32res.h @@ -1,6 +1,6 @@ #ifndef W32RES_H_INCLUDED #define W32RES_H_INCLUDED -#define W32RES_H_VERSION "$Id: w32res.h,v 1.20 2011/09/04 11:10:56 fabiankeil Exp $" +#define W32RES_H_VERSION "$Id: w32res.h,v 1.17 2009/01/01 15:09:23 ler762 Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/w32res.h,v $ @@ -11,10 +11,10 @@ * the Privoxy team. http://www.privoxy.org/ * * Based on the Internet Junkbuster originally written - * by and Copyright (C) 1997 Anonymous Coders and + * by and Copyright (C) 1997 Anonymous Coders and * Junkbusters Corporation. http://www.junkbusters.com * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -32,6 +32,110 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: w32res.h,v $ + * Revision 1.17 2009/01/01 15:09:23 ler762 + * Change the Windows taskbar icon when privoxy is toggled off. + * + * Revision 1.16 2008/11/02 14:37:47 ler762 + * commit the part of the patches I've been using that were written by torford and gjmurphy + * [ 1824315 ] Minor code cleanup + * [ 1781135 ] Patch - Add clear log, select all, and Accelerators for w32 + * http://sourceforge.net/tracker/?func=detail&atid=311118&aid=1781135&... + * The full patch adds control keys A(select all), C(copy) and D(delete all) to the + * Privoxy log window menu. Select all and copy work for me without the patch + * (albeit without showing the accelerator keys on the menu), so the only part of the + * patch I've been using for the last year or so has been the ctrl-d to delete + * everything in the Privoxy log window. + * + * Revision 1.15 2006/07/18 14:48:48 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.13.2.1 2002/08/21 17:59:06 oes + * - "Show Privoxy Window" now a toggle + * - Temp kludge to let user and default action file be edited through win32 GUI (FR 592080) + * + * Revision 1.13 2002/03/26 22:57:10 jongfoster + * Web server name should begin www. + * + * Revision 1.12 2002/03/24 12:07:36 jongfoster + * Consistern name for filters file + * + * Revision 1.11 2002/03/24 12:03:47 jongfoster + * Name change + * + * Revision 1.10 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.9 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.8 2001/07/13 14:04:59 oes + * Removed all #ifdef PCRS + * + * Revision 1.7 2001/06/07 23:08:12 jongfoster + * Forward and ACL edit options removed. + * + * Revision 1.6 2001/05/31 21:37:11 jongfoster + * GUI changes to rename "permissions file" to "actions file". + * + * Revision 1.5 2001/05/29 09:50:24 jongfoster + * Unified blocklist/imagelist/permissionslist. + * File format is still under discussion, but the internal changes + * are (mostly) done. + * + * Also modified interceptor behaviour: + * - We now intercept all URLs beginning with one of the following + * prefixes (and *only* these prefixes): + * * http://i.j.b/ + * * http://ijbswa.sf.net/config/ + * * http://ijbswa.sourceforge.net/config/ + * - New interceptors "home page" - go to http://i.j.b/ to see it. + * - Internal changes so that intercepted and fast redirect pages + * are not replaced with an image. + * - Interceptors now have the option to send a binary page direct + * to the client. (i.e. ijb-send-banner uses this) + * - Implemented show-url-info interceptor. (Which is why I needed + * the above interceptors changes - a typical URL is + * "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". + * The previous mechanism would not have intercepted that, and + * if it had been intercepted then it then it would have replaced + * it with an image.) + * + * Revision 1.4 2001/05/26 01:26:34 jongfoster + * New #define, WIN_GUI_EDIT, enables the (embryonic) Win32 GUI editor. + * This #define cannot be set from ./configure - there's no point, it + * doesn't work yet. See feature request # 425722 + * + * Revision 1.3 2001/05/26 00:28:36 jongfoster + * Automatic reloading of config file. + * Removed obsolete SIGHUP support (Unix) and Reload menu option (Win32). + * Most of the global variables have been moved to a new + * struct configuration_spec, accessed through csp->config->globalname + * Most of the globals remaining are used by the Win32 GUI. + * + * Revision 1.2 2001/05/20 01:21:20 jongfoster + * Version 2.9.4 checkin. + * - Merged popupfile and cookiefile, and added control over PCRS + * filtering, in new "permissionsfile". + * - Implemented LOG_LEVEL_FATAL, so that if there is a configuration + * file error you now get a message box (in the Win32 GUI) rather + * than the program exiting with no explanation. + * - Made killpopup use the PCRS MIME-type checking and HTTP-header + * skipping. + * - Removed tabs from "config" + * - Moved duplicated url parsing code in "loaders.c" to a new funcition. + * - Bumped up version number. + * + * Revision 1.1.1.1 2001/05/15 13:59:08 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/
#define IDR_TRAYMENU 101 @@ -72,11 +176,10 @@ #define ID_TOOLS_EDITCONFIG 5000 #define ID_TOOLS_EDITDEFAULTACTIONS 5001 #define ID_TOOLS_EDITUSERACTIONS 5002 -#define ID_TOOLS_EDITDEFAULTFILTERS 5003 -#define ID_TOOLS_EDITUSERFILTERS 5004 +#define ID_TOOLS_EDITFILTERS 5003
#ifdef FEATURE_TRUST -#define ID_TOOLS_EDITTRUST 5005 +#define ID_TOOLS_EDITTRUST 5004 #endif /* def FEATURE_TRUST */
#define ID_EDIT_COPY 30000 diff --git a/external/privoxy/w32svrapi.c b/external/privoxy/w32svrapi.c index 987cfb5..aed1232 100644 --- a/external/privoxy/w32svrapi.c +++ b/external/privoxy/w32svrapi.c @@ -1,4 +1,4 @@ -const char w32_svrapi_rcs[] = "$Id: w32svrapi.c,v 1.5 2011/09/04 11:10:56 fabiankeil Exp $"; +const char w32_svrapi_rcs[] = "$Id: w32svrapi.c,v 1.2 2006/09/20 03:15:43 david__schmidt Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/w32svrapi.c,v $ @@ -26,7 +26,7 @@ const char w32_svrapi_rcs[] = "$Id: w32svrapi.c,v 1.5 2011/09/04 11:10:56 fabian * some very helpful feedback and suggestions during the * development of this code. * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -44,8 +44,19 @@ const char w32_svrapi_rcs[] = "$Id: w32svrapi.c,v 1.5 2011/09/04 11:10:56 fabian * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: w32svrapi.c,v $ + * Revision 1.2 2006/09/20 03:15:43 david__schmidt + * Clean up a variable type declaration which just + * happened to work... + * + * Revision 1.1 2006/08/12 03:54:37 david__schmidt + * Windows service integration + * + * + * *********************************************************************/ - +
#include "config.h"
@@ -119,7 +130,7 @@ static BOOL HasServiceControlManager() return FALSE; }
- /* Try and connect to the SCM. If it fails check and see if the error + /* Try and connect to the SCM. If it fails check and see if the error * code is ERROR_CALL_NOT_IMPLEMENTED, which means: * "This function is not supported on this system." */ @@ -165,12 +176,12 @@ BOOL CanSystemSupportServices() * The Service functions are defined in <winsvc.h> which is where * the declarations used in this file are taken from * - *********************************************************************/ + *********************************************************************/
/********************************************************************* * Open a connection to the service control manager - *********************************************************************/ + *********************************************************************/ SC_HANDLE w32_open_sc_manager( LPCTSTR lpMachineName, /* computer name */ LPCTSTR lpDatabaseName, /* SCM database name */ @@ -205,7 +216,7 @@ SC_HANDLE w32_open_sc_manager( */ FreeLibrary(hDll); SetLastError(dwLastErr); - + return hScm;
} /* -END- w32_open_sc_manager */ @@ -253,7 +264,7 @@ BOOL w32_close_service_handle(
/********************************************************************* * Open a service - *********************************************************************/ + *********************************************************************/ SC_HANDLE w32_open_service( SC_HANDLE hSCManager, /* handle to SCM database */ LPCTSTR lpServiceName, /* service name */ @@ -288,7 +299,7 @@ SC_HANDLE w32_open_service( */ FreeLibrary(hDll); SetLastError(dwLastErr); - + return hSrv;
} /* -END- w32_open_service */ @@ -351,7 +362,7 @@ SC_HANDLE w32_create_service( */ FreeLibrary(hDll); SetLastError(dwLastErr); - + return hSrv;
} /* -END- w32_create_service */ @@ -563,12 +574,12 @@ static void display_win32_msg(BOOL bIsError, char *msg) #else if (bIsError) { - MessageBox(NULL, msg, "Privoxy Error", + MessageBox(NULL, msg, "Privoxy Error", MB_OK | MB_ICONERROR | MB_TASKMODAL | MB_SETFOREGROUND | MB_TOPMOST); } else { - MessageBox(NULL, msg, "Privoxy Information", + MessageBox(NULL, msg, "Privoxy Information", MB_OK | MB_ICONINFORMATION | MB_TASKMODAL | MB_SETFOREGROUND | MB_TOPMOST); } #endif @@ -628,9 +639,9 @@ BOOL install_service(const char *service_name) * We'll temporarily use szDisplayName as a second buffer. *********************************************************************/ GetModuleFileName(NULL, szDisplayName, MAX_PATH); - sprintf(szModule, ""%s" --service", szDisplayName); - + sprintf(szModule, ""%s" --service", szDisplayName);
+ /********************************************************************* * Get the display name for the service *********************************************************************/ @@ -640,7 +651,7 @@ BOOL install_service(const char *service_name) /********************************************************************* * Create the service *********************************************************************/ - hService = w32_create_service(hSCM, + hService = w32_create_service(hSCM, service_name, /* the internal service name */ szDisplayName, /* the display name */ SERVICE_ALL_ACCESS, /* get full access during creation */ @@ -763,7 +774,7 @@ static void WINAPI privoxy_w32_service_start(DWORD dw, LPSTR* pszArgs) { int child_id;
- /* Arg zero is always the service name, and we need to + /* Arg zero is always the service name, and we need to * know it when we call RegisterServiceCtrlHandler. */ strcpy(szThisServiceName, pszArgs[0]); @@ -915,7 +926,7 @@ static void WINAPI privoxy_w32_service_handler(DWORD dwOpcode) * even after the process had disappeared. * * It seems that if we call exit in the ServiceMain thread, it causes - * the SCM to not receive the status we sent in the line above. The + * the SCM to not recieve the status we sent in the line above. The * simple fix was to create a new thread to actually call exit for us * whilst this thread continues and returns to its caller. */ diff --git a/external/privoxy/w32svrapi.h b/external/privoxy/w32svrapi.h index f4e1ddd..48a6d8d 100644 --- a/external/privoxy/w32svrapi.h +++ b/external/privoxy/w32svrapi.h @@ -1,6 +1,6 @@ #ifndef W32_SVRAPI_H_INCLUDED #define W32_SVRAPI_H_INCLUDED -#define W32_SVRAPI_H_VERSION "$Id: w32svrapi.h,v 1.3 2011/09/04 11:10:56 fabiankeil Exp $" +#define W32_SVRAPI_H_VERSION "$Id: w32svrapi.h,v 1.1 2006/08/12 03:54:37 david__schmidt Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/w32svrapi.h,v $ @@ -29,7 +29,7 @@ * development of this code. * * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -47,8 +47,15 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: w32svrapi.h,v $ + * Revision 1.1 2006/08/12 03:54:37 david__schmidt + * Windows service integration + * + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -136,4 +143,4 @@ extern BOOL w32_set_service_status( #endif
#endif /* ndef W32_SVRAPI_H_INCLUDED */ - + diff --git a/external/privoxy/w32taskbar.c b/external/privoxy/w32taskbar.c index 451d5e5..079e45e 100644 --- a/external/privoxy/w32taskbar.c +++ b/external/privoxy/w32taskbar.c @@ -1,4 +1,4 @@ -const char w32taskbar_rcs[] = "$Id: w32taskbar.c,v 1.12 2011/09/04 11:10:56 fabiankeil Exp $"; +const char w32taskbar_rcs[] = "$Id: w32taskbar.c,v 1.10 2006/09/23 13:26:38 roro Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/w32taskbar.c,v $ @@ -12,7 +12,7 @@ const char w32taskbar_rcs[] = "$Id: w32taskbar.c,v 1.12 2011/09/04 11:10:56 fabi * Written by and Copyright (C) 1999 Adam Lock * locka@iol.ie * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -30,8 +30,46 @@ const char w32taskbar_rcs[] = "$Id: w32taskbar.c,v 1.12 2011/09/04 11:10:56 fabi * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: w32taskbar.c,v $ + * Revision 1.10 2006/09/23 13:26:38 roro + * Replace TABs by spaces in source code. + * + * Revision 1.9 2006/07/18 14:48:48 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.7.2.2 2003/03/19 21:27:42 gliptak + * Corrected compilation error/typo + * + * Revision 1.7.2.1 2002/11/20 14:39:32 oes + * Applied patch by Mattes Dolak which adds re-creation of the win32 taskbar + * icon on reception of the "TaskbarCreated" window message. + * + * Revision 1.7 2002/03/31 17:19:00 jongfoster + * Win32 only: Enabling STRICT to fix a VC++ compile warning. + * + * Revision 1.6 2002/03/26 22:57:10 jongfoster + * Web server name should begin www. + * + * Revision 1.5 2002/03/24 12:03:47 jongfoster + * Name change + * + * Revision 1.4 2001/11/16 00:46:31 jongfoster + * Fixing compiler warnings + * + * Revision 1.3 2001/05/22 18:56:28 oes + * CRLF -> LF + * + * Revision 1.2 2001/05/20 15:07:54 jongfoster + * File is now ignored if _WIN_CONSOLE is defined. + * + * Revision 1.1.1.1 2001/05/15 13:59:08 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
diff --git a/external/privoxy/w32taskbar.h b/external/privoxy/w32taskbar.h index 911f96e..7ea7588 100644 --- a/external/privoxy/w32taskbar.h +++ b/external/privoxy/w32taskbar.h @@ -1,6 +1,6 @@ #ifndef W32TASKBAR_H_INCLUDED #define W32TASKBAR_H_INCLUDED -#define W32TASKBAR_H_VERSION "$Id: w32taskbar.h,v 1.8 2011/09/04 11:10:56 fabiankeil Exp $" +#define W32TASKBAR_H_VERSION "$Id: w32taskbar.h,v 1.6 2006/07/18 14:48:48 david__schmidt Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/w32taskbar.h,v $ @@ -14,7 +14,7 @@ * Written by and Copyright (C) 1999 Adam Lock * locka@iol.ie * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -32,8 +32,28 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: w32taskbar.h,v $ + * Revision 1.6 2006/07/18 14:48:48 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.4 2002/03/26 22:57:10 jongfoster + * Web server name should begin www. + * + * Revision 1.3 2002/03/24 12:03:47 jongfoster + * Name change + * + * Revision 1.2 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.1.1.1 2001/05/15 13:59:08 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { diff --git a/external/privoxy/win32.c b/external/privoxy/win32.c index a7216d5..3aedd53 100644 --- a/external/privoxy/win32.c +++ b/external/privoxy/win32.c @@ -1,4 +1,4 @@ -const char win32_rcs[] = "$Id: win32.c,v 1.18 2011/09/04 11:10:56 fabiankeil Exp $"; +const char win32_rcs[] = "$Id: win32.c,v 1.15 2009/02/09 19:16:35 fabiankeil Exp $"; /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/win32.c,v $ @@ -11,7 +11,7 @@ const char win32_rcs[] = "$Id: win32.c,v 1.18 2011/09/04 11:10:56 fabiankeil Exp * Written by and Copyright (C) 1999 Adam Lock * locka@iol.ie * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -29,8 +29,61 @@ const char win32_rcs[] = "$Id: win32.c,v 1.18 2011/09/04 11:10:56 fabiankeil Exp * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: win32.c,v $ + * Revision 1.15 2009/02/09 19:16:35 fabiankeil + * Bump copyright year in win32_blurb[]. + * + * Revision 1.14 2008/03/02 18:15:41 fabiankeil + * Update copyright year in win32_blurb[]. + * + * Revision 1.13 2007/01/31 16:25:24 fabiankeil + * Update copyright range for the About message. + * + * Revision 1.12 2006/08/12 03:54:37 david__schmidt + * Windows service integration + * + * Revision 1.11 2006/07/18 14:48:48 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.9.2.2 2002/08/27 18:03:40 oes + * Fixed stupid typo + * + * Revision 1.9.2.1 2002/08/21 17:59:27 oes + * Sync win32_blurb[] with our standard blurb + * + * Revision 1.9 2002/03/31 17:19:00 jongfoster + * Win32 only: Enabling STRICT to fix a VC++ compile warning. + * + * Revision 1.8 2002/03/26 22:57:10 jongfoster + * Web server name should begin www. + * + * Revision 1.7 2002/03/24 12:03:47 jongfoster + * Name change + * + * Revision 1.6 2002/03/16 21:53:28 jongfoster + * VC++ Heap debug option + * + * Revision 1.5 2002/03/04 23:47:30 jongfoster + * - Rewritten, simpler command-line pre-parser + * - not using raise(SIGINT) any more + * + * Revision 1.4 2001/11/30 21:29:33 jongfoster + * Fixing a warning + * + * Revision 1.3 2001/11/16 00:46:31 jongfoster + * Fixing compiler warnings + * + * Revision 1.2 2001/07/29 19:32:00 jongfoster + * Renaming _main() [mingw32 only] to real_main(), for ANSI compliance. + * + * Revision 1.1.1.1 2001/05/15 13:59:08 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#include "config.h"
@@ -68,16 +121,16 @@ const char win32_h_rcs[] = WIN32_H_VERSION; */ const char win32_blurb[] = "Privoxy version " VERSION " for Windows\n" -"Copyright (C) 2000-2010 the Privoxy Team (" HOME_PAGE_URL ")\n" +"Copyright (C) 2000-2009 the Privoxy Team (" HOME_PAGE_URL ")\n" "Based on the Internet Junkbuster by Junkbusters Corp.\n" "This is free software; it may be used and copied under the\n" -"GNU General Public License, version 2: http://www.gnu.org/licenses/old-licenses/gpl-2.0.html%5Cn" +"GNU General Public License: http://www.gnu.org/copyleft/gpl.html .\n" "This program comes with ABSOLUTELY NO WARRANTY OF ANY KIND.\n";
#ifdef _WIN_CONSOLE
/** - * Hide the console. If set, the program will disconnect from the + * Hide the console. If set, the program will disconnect from the * console and run in the background. This allows the command-prompt * window to close. */ @@ -246,8 +299,8 @@ void InitWin32(void) if (WSAStartup(wVersionRequested, &wsaData) != 0) { #ifndef _WIN_CONSOLE - MessageBox(NULL, "Cannot initialize WinSock library", "Privoxy Error", - MB_OK | MB_ICONERROR | MB_TASKMODAL | MB_SETFOREGROUND | MB_TOPMOST); + MessageBox(NULL, "Cannot initialize WinSock library", "Privoxy Error", + MB_OK | MB_ICONERROR | MB_TASKMODAL | MB_SETFOREGROUND | MB_TOPMOST); #endif exit(1); } diff --git a/external/privoxy/win32.h b/external/privoxy/win32.h index 5140175..1b4e814 100644 --- a/external/privoxy/win32.h +++ b/external/privoxy/win32.h @@ -1,6 +1,6 @@ #ifndef WIN32_H_INCLUDED #define WIN32_H_INCLUDED -#define WIN32_H_VERSION "$Id: win32.h,v 1.9 2011/09/04 11:10:56 fabiankeil Exp $" +#define WIN32_H_VERSION "$Id: win32.h,v 1.7 2006/07/18 14:48:48 david__schmidt Exp $" /********************************************************************* * * File : $Source: /cvsroot/ijbswa/current/win32.h,v $ @@ -13,7 +13,7 @@ * Written by and Copyright (C) 1999 Adam Lock * locka@iol.ie * - * This program is free software; you can redistribute it + * This program is free software; you can redistribute it * and/or modify it under the terms of the GNU General * Public License as published by the Free Software * Foundation; either version 2 of the License, or (at @@ -31,8 +31,34 @@ * or write to the Free Software Foundation, Inc., 59 * Temple Place - Suite 330, Boston, MA 02111-1307, USA. * + * Revisions : + * $Log: win32.h,v $ + * Revision 1.7 2006/07/18 14:48:48 david__schmidt + * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) + * with what was really the latest development (the v_3_0_branch branch) + * + * Revision 1.5 2002/03/26 22:57:10 jongfoster + * Web server name should begin www. + * + * Revision 1.4 2002/03/24 12:03:47 jongfoster + * Name change + * + * Revision 1.3 2001/07/30 22:08:36 jongfoster + * Tidying up #defines: + * - All feature #defines are now of the form FEATURE_xxx + * - Permanently turned off WIN_GUI_EDIT + * - Permanently turned on WEBDAV and SPLIT_PROXY_ARGS + * + * Revision 1.2 2001/07/29 18:43:08 jongfoster + * Changing #ifdef _FILENAME_H to FILENAME_H_INCLUDED, to conform to + * ANSI C rules. + * + * Revision 1.1.1.1 2001/05/15 13:59:08 oes + * Initial import of version 2.9.3 source tree + * + * *********************************************************************/ - +
#ifdef __cplusplus extern "C" { @@ -60,7 +86,7 @@ extern const char win32_h_rcs[]; #endif
#endif /* ndef WIN32_H_INCLUDED */ - + /* Local Variables: tab-width: 3