X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fsource%2Fprivoxy-man-page.sgml;h=cef70c145a5d742c29cfa96d3cdba9b93a95e9ce;hp=db95a76a4224dcd605e34e7430c127383fae86f5;hb=b93f35c60fa190ec3ae30879632be6269c4de2b3;hpb=f9888d9c1d0b5b4e082718508532ddaf2ba8759c diff --git a/doc/source/privoxy-man-page.sgml b/doc/source/privoxy-man-page.sgml index db95a76a..cef70c14 100644 --- a/doc/source/privoxy-man-page.sgml +++ b/doc/source/privoxy-man-page.sgml @@ -5,9 +5,9 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: privoxy-man-page.sgml,v 2.12 2006/11/14 01:57:47 hal9 Exp $ + $Id: privoxy-man-page.sgml,v 2.29 2009/02/19 02:20:22 hal9 Exp $ - Copyright (C) 2001-2007 Privoxy Developers http://www.privoxy.org/ + Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE. ======================================================================== @@ -42,18 +42,19 @@ - - - - + + + + + ]> - 2007-04-12 + 2009-02-15 privoxy @@ -77,6 +78,7 @@ pidfile user[.group] + hostname configfile @@ -159,12 +161,22 @@ + + --pre-chroot-nslookup hostname + + + Initialize the resolver library using hostname + before chroot'ing. On some systems this reduces the number of files + that must be copied into the chroot tree. + + + If the configfile is not specified on the command line, Privoxy will look for a file named - config in the current directory . If no + config in the current directory. If no configfile is found, Privoxy will fail to start. @@ -183,16 +195,13 @@ Installation and Usage - Browsers must be individually configured to use Privoxy as - a HTTP proxy. 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: Edit; - Preferences; Advanced; - Proxies; Manual Proxy Configuration; - View. - - - For Firefox, go through: Tools; + Browsers can either be individually configured to use + Privoxy as a HTTP proxy (recommended), + or Privoxy can be combined with a packet + filter to build an intercepting proxy + (see config). The default setting is for + localhost, on port 8118 (configurable in the main config file). To set the + HTTP proxy in Firefox, go through: Tools; Options; General; Connection Settings; Manual Proxy Configuration. @@ -221,12 +230,12 @@ Privoxy can be configured with the various configuration files. The default configuration files are: config, - default.filter, and + default.filter, default.action and default.action. user.action should - be used for locally defined exceptions to the default rules of - default.action, and user.filter 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 + match-all.action and default.action, + and user.filter for locally defined filters. These are + well commented. On Unix and Unix-like systems, these are located in /etc/privoxy/ by default. @@ -240,7 +249,8 @@ 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). Privoxy's configuration parameters can also be viewed at the same page. In addition, Privoxy can be toggled on/off. This is an internal page, and does not require Internet access. @@ -254,164 +264,6 @@ - -Sample Configuration - - A brief example of what a simple default.action - configuration might look like: - - - - # 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 -kill-popups - - ## Turn some actions on ################################ - ## NOTE: Actions are off by default, unless explictily turned on - ## otherwise with the '+' operator. - -{ \ --add-header \ --block \ --client-header-filter{hide-tor-exit-notation} \ --content-type-overwrite \ --crunch-client-header \ --crunch-if-none-match \ --crunch-outgoing-cookies \ --crunch-incoming-cookies \ --crunch-server-header \ --deanimate-gifs \ --downgrade-http-version \ --fast-redirects \ --filter{js-annoyances} \ --filter{js-events} \ --filter{html-annoyances} \ --filter{content-cookies} \ --filter{refresh-tags} \ --filter{unsolicited-popups} \ --filter{all-popups} \ --filter{img-reorder} \ --filter{banners-by-size} \ --filter{banners-by-link} \ --filter{webbugs} \ --filter{tiny-textforms} \ --filter{jumping-windows} \ --filter{frameset-borders} \ --filter{demoronizer} \ --filter{shockwave-flash} \ --filter{quicktime-kioskmode} \ --filter{fun} \ --filter{crude-parental} \ --filter{ie-exploits} \ --filter{site-specifics} \ --filter{google} \ --filter{yahoo} \ --filter{msn} \ --filter{blogspot} \ --filter{no-ping} \ --force-text-mode \ --handle-as-empty-document \ --handle-as-image \ --hide-accept-language \ --hide-content-disposition \ --hide-if-modified-since \ -+hide-forwarded-for-headers \ -+hide-from-header{block} \ --hide-referrer \ --hide-user-agent \ --inspect-jpegs \ --kill-popups \ --limit-connect \ --overwrite-last-modified \ --prevent-compression \ --redirect \ --send-vanilla-wafer \ --send-wafer \ --server-header-filter{xml-to-html} \ --server-header-filter{html-to-xml} \ --session-cookies-only \ -+set-image-blocker{pattern} \ --treat-forbidden-connects-like-blocks \ -} -/ # '/' 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 - - - - Then for a user.action, we would put local, - narrowly defined exceptions: - - - - # 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 breaks 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 - - - - - See the comments in the configuration files themselves, or the - User Manual - for full explanations of the above syntax, and other Privoxy - configuration options. - - - - Files @@ -419,8 +271,8 @@ /usr/sbin/privoxy /etc/privoxy/config + /etc/privoxy/match-all.action /etc/privoxy/default.action - /etc/privoxy/standard.action /etc/privoxy/user.action /etc/privoxy/default.filter /etc/privoxy/user.filter