X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=privoxy.1;h=dca772a57abf31579c24932f785e20bcafb0291e;hp=302ded9efe43cb5b28ccf3b32e81cee643f8a0df;hb=d10c062399534f3619e2cf10d7c768037596333b;hpb=d08efb68329798242aa848d30b50fc58254b1aaf diff --git a/privoxy.1 b/privoxy.1 index 302ded9e..dca772a5 100644 --- a/privoxy.1 +++ b/privoxy.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "PRIVOXY" "1" "15 January 2009" "Privoxy 3.0.11 UNRELEASED" "" +.TH "PRIVOXY" "1" "21 March 2009" "Privoxy 3.0.12" "" .SH NAME privoxy \- Privacy Enhancing Proxy .SH SYNOPSIS @@ -54,22 +54,18 @@ that must be copied into the chroot tree. .PP 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 +\fIconfig\fR in the current directory. If no \fIconfigfile\fR is found, \fBPrivoxy\fR will fail to start. .SH "DESCRIPTION" .PP -Privoxy is a non-caching -web proxy -with advanced filtering capabilities for enhancing privacy, -modifying web page data, managing HTTP -cookies, -controlling access, and removing ads, banners, pop-ups and other obnoxious -Internet junk. Privoxy has a flexible configuration and can be -customized to suit individual needs and tastes. Privoxy has application for -both stand-alone systems and multi-user networks. +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. .PP -Privoxy is based on Internet Junkbuster (tm). +Privoxy is Free Software and licensed under the GPL2. .SH "INSTALLATION AND USAGE" .PP Browsers can either be individually configured to use @@ -78,12 +74,7 @@ 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 Netscape and Mozilla, go through: \fBEdit\fR; -\fBPreferences\fR; \fBAdvanced\fR; -\fBProxies\fR; \fBManual Proxy Configuration\fR; -\fBView\fR. -.PP -For Firefox, go through: \fBTools\fR; +HTTP proxy in Firefox, go through: \fBTools\fR; \fBOptions\fR; \fBGeneral\fR; \fBConnection Settings\fR; \fBManual Proxy Configuration\fR. @@ -103,12 +94,12 @@ For other browsers, check the documentation. .PP \fBPrivoxy\fR can be configured with the various configuration files. The default configuration files are: \fIconfig\fR, -\fIdefault.filter\fR, and +\fIdefault.filter\fR, \fIdefault.action\fR and \fIdefault.action\fR. \fIuser.action\fR should -be used for locally defined exceptions to the default rules of -\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 +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. .PP \fBPrivoxy\fR uses the concept of \fBactions\fR @@ -129,111 +120,13 @@ This is an internal page, and does not require Internet access. See the \fIUser Manual\fR for a detailed explanation of installation, general usage, all configuration options, new features and notes on upgrading. -.SH "SAMPLE CONFIGURATION" -.PP -A brief example of what a simple \fIdefault.action\fR -configuration might look like: - -.nf - # Define a few useful custom aliases for later use - {{alias}} - - # Useful aliases that combine more than one action - +crunch-cookies = +crunch-incoming-cookies +crunch-outgoing-cookies - \-crunch-cookies = \-crunch-incoming-cookies \-crunch-outgoing-cookies - +block-as-image = +block +handle-as-image - - # Fragile sites should have the minimum changes - fragile = \-block \-deanimate-gifs \-fast-redirects \-filter \\ - \-hide-referer \-prevent-cookies - - ## Turn some actions on ################################ - ## NOTE: Actions are off by default, unless explictily turned on - ## otherwise with the '+' operator. - -{ \\ -+change-x-forwarded-for{block} \\ -+deanimate-gifs{last} \\ -+filter{refresh-tags} \\ -+filter{img-reorder} \\ -+filter{banners-by-size} \\ -+filter{webbugs} \\ -+filter{jumping-windows} \\ -+filter{ie-exploits} \\ -+hide-from-header{block} \\ -+hide-referrer{conditional-block} \\ -+session-cookies-only \\ -+set-image-blocker{pattern} \\ -} -/ # '/' Match *all* URL patterns - - - # Block all URLs that match these patterns - { +block } - ad. - ad[sv]. - .*ads. - banner?. - /.*count(er)?\\.(pl|cgi|exe|dll|asp|php[34]?) - .hitbox.com - media./.*(ads|banner) - - # Block, and treat these URL patterns as if they were 'images'. - # We would expect these to be ads. - { +block-as-image } - .ad.doubleclick.net - .a[0-9].yimg.com/(?:(?!/i/).)*$ - ad.*.doubleclick.net - - # Make exceptions for these harmless ones that would be - # caught by our +block patterns just above. - { \-block } - adsl. - adobe. - advice. - .*downloads. - # uploads or downloads - /.*loads -.fi -.PP -Then for a \fIuser.action\fR, we would put local, -narrowly defined exceptions: - -.nf - # Re-define aliases as needed here - {{alias}} - - # Useful aliases - \-crunch-cookies = \-crunch-incoming-cookies \-crunch-outgoing-cookies - - # Set personal exceptions to the policies in default.action ####### - - # Sites where we want persistent cookies, so allow *all* cookies - { \-crunch-cookies \-session-cookies-only } - .redhat.com - .sun.com - .msdn.microsoft.com - - # These sites break easily. Use our "fragile" alias here. - { fragile } - .forbes.com - mybank.example.com - - # Replace example.com's style sheet with one of my choosing - { +redirect{http://localhost/css-replacements/example.com.css} } - .example.com/stylesheet.css -.fi -.PP -See the comments in the configuration files themselves, or the -\fIUser Manual\fR -for full explanations of the above syntax, and other \fBPrivoxy\fR -configuration options. .SH "FILES" .nf \fI/usr/sbin/privoxy\fR \fI/etc/privoxy/config\fR + \fI/etc/privoxy/match-all.action\fR \fI/etc/privoxy/default.action\fR \fI/etc/privoxy/user.action\fR \fI/etc/privoxy/default.filter\fR @@ -257,9 +150,6 @@ config file changes by \fBSIGHUP\fR -- it will detect them automatically. .SH "NOTES" .PP -This is a UNRELEASED version of \fBPrivoxy\fR. Not -all features are well tested. -.PP Please see the \fIUser Manual\fR on how to contact the developers, for feature requests, reporting problems, and other questions. .SH "SEE ALSO" @@ -274,7 +164,10 @@ the \fBPrivoxy\fR Home page. http://www.privoxy.org/faq/, the \fBPrivoxy\fR FAQ. -http://sourceforge.net/projects/ijbswa/, +http://www.privoxy.org/developer-manual/, +the \fBPrivoxy\fR developer manual. + +https://sourceforge.net/projects/ijbswa/, the Project Page for \fBPrivoxy\fR on SourceForge. @@ -284,36 +177,12 @@ 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. - -http://www.junkbusters.com/ht/en/cookies.html, -an explanation how cookies are used to track web users. - -http://www.junkbusters.com/ijb.html, -the original Internet Junkbuster. - -http://privacy.net/, a useful site -to check what information about you is leaked while you browse the web. - -http://www.squid-cache.org/, a popular -caching proxy, which is often used together with \fBPrivoxy\fR. - -http://www.pps.jussieu.fr/~jch/software/polipo/, -\fBPolipo\fR is a caching proxy with advanced features -like pipelining, multiplexing and caching of partial instances. In many setups -it can be used as \fBSquid\fR replacement. - -https://www.torproject.org/, -\fBTor\fR can help anonymize web browsing, -web publishing, instant messaging, IRC, SSH, and other applications. - -http://www.privoxy.org/developer-manual/, -the \fBPrivoxy\fR developer manual. .SH "DEVELOPMENT TEAM" .nf Fabian Keil, lead developer David Schmidt, developer - + Hal Burgiss Mark Miller Gerry Murphy