X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fsource%2Fprivoxy-man-page.sgml;h=ad87a2201430e8538ebff3d63c13618245c97c83;hb=f1e040bf5515bc8c762c1c83243fe461afbc4bed;hp=445a7159e737b2edc0cafcdbd56ae080eda58322;hpb=03e14880e78a4d03caa7fb4c809e48dbaef04a37;p=privoxy.git diff --git a/doc/source/privoxy-man-page.sgml b/doc/source/privoxy-man-page.sgml index 445a7159..ad87a220 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.6 2006/08/26 02:37:27 hal9 Exp $ + $Id: privoxy-man-page.sgml,v 2.16 2008/01/17 01:49:51 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,15 +77,10 @@ pidfile user[.group] + hostname configfile -  (UNIX) - - privoxy.exe - configfile -  (Windows) - @@ -165,13 +160,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 (except on Win32 where - it will try config.txt). If no + config in the current directory . If no configfile is found, Privoxy will fail to start. @@ -190,14 +194,23 @@ 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. + + For Firefox, go through: Tools; + Options; General; + Connection Settings; + Manual Proxy Configuration. + For Internet Explorer, go through: Tools; Internet Properties; Connections; @@ -228,23 +241,31 @@ 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. On Windows, OS/2 and AmigaOS, - these files are in the same directory as the Privoxy - executable. + /etc/privoxy/ by default. - - See the user-manual for a complete - 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. + @@ -259,10 +280,10 @@ # 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 \ @@ -273,87 +294,48 @@ ## 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 @@ -370,22 +352,27 @@ # 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 See the comments in the configuration files themselves, or the - user-manual - for explanations of the above syntax, and other Privoxy + User Manual + for full explanations of the above syntax, and other Privoxy configuration options.