X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;f=doc%2Fsource%2Fprivoxy-man-page.sgml;h=7ff1524f601f4d1db8ad33c671112248a4bbd94b;hb=529fc42bcdedec21eb6fe8171bcabb319772e95e;hp=ffa9fd471e43706b5b02b6d6d6d6d25862e9416f;hpb=3926884a0bfbdf10d62077af0cc3c5fde3eb85c9;p=privoxy.git diff --git a/doc/source/privoxy-man-page.sgml b/doc/source/privoxy-man-page.sgml index ffa9fd47..7ff1524f 100644 --- a/doc/source/privoxy-man-page.sgml +++ b/doc/source/privoxy-man-page.sgml @@ -5,14 +5,10 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: privoxy-man-page.sgml,v 1.9 2002/04/25 14:45:25 hal9 Exp $ + $Id: privoxy-man-page.sgml,v 2.33 2009/10/10 05:48:55 fabiankeil Exp $ - Written by and Copyright (C) 2001 the SourceForge - Privoxy team. http://www.privoxy.org/ - - Based on the Internet Junkbuster originally written - by and Copyright (C) 1997 Anonymous Coders and - Junkbusters Corporation. http://www.junkbusters.com + Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/ + See LICENSE. ======================================================================== NOTE: Please read developer-manual/documentation.html before touching @@ -44,24 +40,28 @@ + - - + + + + ]> - 2002-04-11 + 2009-02-15 - privoxy 1 - Privoxy &p-version; + + Privoxy &p-version; + @@ -77,15 +77,11 @@ pidfile user[.group] + + hostname configfile - (UNIX) - - privoxy.exe - configfile - (Windows) - @@ -131,7 +127,7 @@ On startup, write the process ID to pidfile. Delete the pidfile on exit. - Failiure to create or delete the pidfile + Failure to create or delete the pidfile is non-fatal. If no --pidfile option is given, no PID file will be used. @@ -152,13 +148,35 @@ + + --chroot + + + Before changing to the user ID given in the --user option, chroot to + that user's home directory, i.e. make the kernel pretend to the + Privoxy process that the directory tree starts + there. If set up carefully, this can limit the impact of possible + vulnerabilities in Privoxy to the files contained in + that hierarchy. + + + + + --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. @@ -177,13 +195,16 @@ 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. + 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. For Internet Explorer, go through: Tools; @@ -192,8 +213,12 @@ The Secure (SSL) Proxy should also be set to the same values, otherwise - https: URLs will not be proxied. + 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. + For other browsers, check the documentation. @@ -205,142 +230,52 @@ 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 These are all 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. - - The name and number of configuration files has changed from previous - versions, and is subject to change as development progresses. In fact, the - configuration itself is changed and much more sophisticated. See the - user-manual for a - brief explanation of all configuration options. + + 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://ijbswa.sourceforge.net/config. + 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. + This is an internal page, and does not require Internet access. - - - - -Sample Configuration - A brief example of what a simple default.action - configuration might look like: + See the User Manual for a detailed + explanation of installation, general usage, all configuration options, new + features and notes on upgrading. - - - # Define a few useful custom aliases for later use - {{alias}} - - # Useful aliases - +prevent-cookies = +prevent-setting-cookies +prevent-reading-cookies - -prevent-cookies = -prevent-setting-cookies -prevent-reading-cookies - +imageblock = +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 ################################ - { \ - -add-header \ - -block \ - +deanimate-gifs{last} \ - -downgrade-http-version \ - -fast-redirects \ - +filter{html-annoyances} \ - +filter{js-annoyances} \ - +filter{content-cookies} \ - +filter{webbugs} \ - +filter{banners-by-size} \ - +hide-forwarded-for-headers \ - +hide-from-header{block} \ - +hide-referrer{forge} \ - -hide-user-agent \ - -handle-as-image \ - +set-image-blocker{pattern} \ - -limit-connect \ - +prevent-compression \ - +session-cookies-only \ - +prevent-reading-cookies \ - +prevent-setting-cookies \ - -kill-popups \ - } - / # Match all URLs - - # Block, and treat these URL patterns as if they were 'images'. - {+imageblock} - .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]?) - /(?:.*/)?(publicite|werbung|rekla(ma|me|am)|maino(kset|nta|s)?)/ - .hitbox.com - - # Make exceptions for these harmless ones that would be - # caught by +block above. - {-block} - adsl. - advice. - .*downloads. - - - - - Then for a user.action, we would put local, - narrowly defined exceptions: - - - - # Set personal exceptions to the policies in default.action ####### - - # Sites where we want persistant cookies - {-prevent-reading-cookies -prevent-setting-cookies -session-cookies-only} - .redhat.com - .sun.com - .msdn.microsoft.com - - {-block -fast-redirects} - .forbes.com - - - - - See the comments in the configuration files themselves, or the - user-manual - for explanations of the above syntax, and other Privoxy - configuration options. - - + Files /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 /etc/privoxy/trust /etc/privoxy/templates/* /var/log/privoxy/logfile @@ -348,8 +283,8 @@ Various other files should be included, but may vary depending on platform - and build configuration. More documentation should be included in the local - documentation directory, though is not complete at this time. + and build configuration. Additional documentation should be included in the local + documentation directory. @@ -374,12 +309,12 @@ Notes - This is a &p-status; version of Privoxy. Not + This is a &p-status; version of Privoxy. Not all features are well tested. ]]> - Please see the user-manual on how to contact the - developers for feature requests, reporting problems, and other questions. + Please see the User Manual on how to contact the + developers, for feature requests, reporting problems, and other questions. @@ -400,9 +335,18 @@ Copyright and License + +Copyright ©right; + + +License + + &license; + +