X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fsource%2Fprivoxy-man-page.sgml;h=f0469f00035df542c2d53a38aa15ec47db7f6281;hp=afb2465c9b46265efa486b77f00f236afc3f9c81;hb=34f3be4bf4673eeb8101bcceb5c32a56d1501439;hpb=e2769736f06af596874affd365ab8278dd34e46d diff --git a/doc/source/privoxy-man-page.sgml b/doc/source/privoxy-man-page.sgml index afb2465c..f0469f00 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.5 2006/07/18 14:48:51 david__schmidt Exp $ + $Id: privoxy-man-page.sgml,v 2.26 2009/02/15 15:19:35 fabiankeil Exp $ - Copyright (C) 2001, 2002 Privoxy Developers + Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ See LICENSE. ======================================================================== @@ -42,10 +42,10 @@ - - - - + + + + @@ -53,7 +53,7 @@ - 2006-08-24 + 2009-02-15 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; @@ -207,6 +220,8 @@ The Secure (SSL) Proxy should also be set to the same values, otherwise https: URLs will not be proxied. Note: Privoxy 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. @@ -220,29 +235,37 @@ 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 - /etc/privoxy/ by default. On Windows, OS/2 and AmigaOS, - these files are in the same directory as the Privoxy - executable. + 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. - - See the user-manual for a complete - explanation of general usage, configuration options, new features and notes for - 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. + @@ -257,76 +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 ################################ - { \ - -add-header \ - -block \ - -content-type-overwrite \ - -crunch-if-none-match \ - +crunch-incoming-cookies \ - +crunch-outgoing-cookies \ - +crunch-server-header {no-cache} \ - +deanimate-gifs{last} \ - -downgrade-http-version \ - -fast-redirects \ - -force-text-mode \ - -filter{html-annoyances} \ - -filter{js-annoyances} \ - +filter{content-cookies} \ - +filter{webbugs} \ - -filter{banners-by-size} \ - -handle-as-empty-document \ - +hide-accept-language{en-ca} \ - +hide-content-disposition {block} \ - +hide-forwarded-for-headers \ - +hide-from-header{block} \ - +hide-if-modified-since {-1} \ - +hide-referrer{forge} \ - -hide-user-agent \ - -handle-as-image \ - -inspect-jpegs \ - -kill-popups \ - +set-image-blocker{pattern} \ - -limit-connect \ - +overwrite-last-modified {randomize} \ - +prevent-compression \ - +session-cookies-only \ - +treat-forbidden-connects-like-blocks \ - -crunch-cookies \ - } - / # '/' Matches *all* URL patterns + ## 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. - {+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 @@ -343,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. @@ -371,8 +385,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 @@ -383,7 +397,7 @@ Various other files should be included, but may vary depending on platform - and build configuration. More documentation should be included in the local + and build configuration. Additional documentation should be included in the local documentation directory.