X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fsource%2Fprivoxy-man-page.sgml;h=3cd29fe1c09719bbcb22dd5210d823579f65a062;hp=97c4c42a95c5156f5968910dd46c10663e142f19;hb=f4107f65b676b63a199fe4230e58695757f9f199;hpb=d12c46e2ec2bfc06ef6f5b0e710d21b1211088ec diff --git a/doc/source/privoxy-man-page.sgml b/doc/source/privoxy-man-page.sgml index 97c4c42a..3cd29fe1 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.7 2006/09/01 15:10:45 hal9 Exp $ + $Id: privoxy-man-page.sgml,v 2.17 2008/01/19 15:03:05 hal9 Exp $ - Copyright (C) 2001-2006 Privoxy Developers + Copyright (C) 2001-2008 Privoxy Developers http://www.privoxy.org/ See LICENSE. ======================================================================== @@ -42,10 +42,10 @@ - - - - + + + + @@ -53,7 +53,7 @@ - 2006-08-24 + 2007-04-12 privoxy @@ -77,6 +77,7 @@ pidfile user[.group] + hostname configfile @@ -159,6 +160,16 @@ + + --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. + + + @@ -183,10 +194,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; + 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 Netscape and Mozilla, go through: Edit; Preferences; Advanced; Proxies; Manual Proxy Configuration; View. @@ -229,19 +243,29 @@ and Unix-like systems, these are located in /etc/privoxy/ by default. - - See the User Manual for a detailed - explanation of installation, general usage, all configuration options, new - features and notes on upgrading. + + Privoxy uses the concept of actions + 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/. + 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. + + See the User Manual for a detailed + explanation of installation, general usage, all configuration options, new + features and notes on upgrading. + @@ -256,101 +280,62 @@ # Define a few useful custom aliases for later use {{alias}} - # Useful aliases + # Useful aliases that combine more than one action +crunch-cookies = +crunch-incoming-cookies +crunch-outgoing-cookies -crunch-cookies = -crunch-incoming-cookies -crunch-outgoing-cookies - +imageblock = +block +handle-as-image + +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 + -hide-referer -prevent-cookies ## Turn some actions on ################################ ## NOTE: Actions are off by default, unless explictily turned on ## otherwise with the '+' operator. { \ --add-header \ --block \ --content-type-overwrite \ --crunch-client-header \ --crunch-if-none-match \ --crunch-outgoing-cookies \ --crunch-incoming-cookies \ --crunch-server-header \ +deanimate-gifs{last} \ --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-client-headers \ --filter-server-headers \ --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{forge} \ --hide-user-agent \ --inspect-jpegs \ --kill-popups \ --limit-connect \ --overwrite-last-modified \ --redirect \ -+prevent-compression \ --send-vanilla-wafer \ --send-wafer \ ++hide-referrer{conditional-block} \ +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. - {+imageblock} + { +block-as-image } .ad.doubleclick.net .a[0-9].yimg.com/(?:(?!/i/).)*$ ad.*.doubleclick.net - # Block any URLs that match these patterns - {+block} - ad*. - .*ads. - banner?. - /.*count(er)?\.(pl|cgi|exe|dll|asp|php[34]?) - .hitbox.com - # Make exceptions for these harmless ones that would be # caught by our +block patterns just above. - {-block} + { -block } adsl. + adobe. advice. .*downloads. - + # uploads or downloads + /.*loads @@ -367,15 +352,20 @@ # Set personal exceptions to the policies in default.action ####### - # Sites where we want persistant cookies, so allow *all* cookies - {-crunch-cookies -session-cookies-only} + # Sites where we want persistent cookies, so allow *all* cookies + { -crunch-cookies -session-cookies-only } .redhat.com .sun.com .msdn.microsoft.com - # This site breaks easily. - {-block -fast-redirects} + # 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