Rebuild for 3.0.9 beta.
[privoxy.git] / doc / webserver / man-page / privoxy-man-page.html
index bed7a12..7bdb75e 100644 (file)
@@ -1,8 +1,9 @@
 
-<HTML><HEAD><TITLE>Manpage of PRIVOXY</TITLE>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<HTML><HEAD><TITLE>Man page of PRIVOXY</TITLE>
 <LINK REL="STYLESHEET" TYPE="text/css" HREF="../p_doc.css"></HEAD><BODY>
 <H1>PRIVOXY</H1>
-Section:  (1)<BR>Updated: 21 September 2006<BR><A HREF="#index">Index</A>
+Section:  (1)<BR>Updated: 18 June 2008<BR><A HREF="#index">Index</A>
 <HR>
 
 <A NAME="lbAB">&nbsp;</A>
@@ -13,7 +14,7 @@ privoxy - Privacy Enhancing Proxy
 <H2>SYNOPSIS</H2>
 
 <P>
-<B>privoxy</B> [<B>--help</B> ] [<B>--version</B> ] [<B>--no-daemon</B> ] [<B>--pidfile </B><I>pidfile</I><B></B> ] [<B>--user </B><I>user[.group]</I><B></B> ] [<B>--chroot</B> ] [<B></B><I>configfile</I><B></B> ]
+<B>privoxy</B> [<B>--help</B> ] [<B>--version</B> ] [<B>--no-daemon</B> ] [<B>--pidfile </B><I>pidfile</I><B></B> ] [<B>--user </B><I>user[.group]</I><B></B> ] [<B>--chroot</B> ] [<B>--pre-chroot-nslookup </B><I>hostname</I><B></B> ] [<B></B><I>configfile</I><B></B> ]
 <P>
 <A NAME="lbAD">&nbsp;</A>
 <H2>OPTIONS</H2>
@@ -49,6 +50,10 @@ that user's home directory, i.e. make the kernel pretend to the
 there. If set up carefully, this can limit the impact of possible
 vulnerabilities in <B>Privoxy</B> to the files contained in
 that hierarchy. 
+<DT><B>--pre-chroot-nslookup </B><I>hostname</I><B></B><DD>
+Initialize the resolver library using <I>hostname</I>
+before chroot'ing. On some systems this reduces the number of files
+that must be copied into the chroot tree.
 </DL>
 <P>
 
@@ -62,13 +67,13 @@ fail to start.
 
 <P>
 
-Privoxy is a 
+Privoxy is a non-caching
 web proxy
-with advanced filtering capabilities for protecting
-privacy, modifying web page data, managing 
+with advanced filtering capabilities for enhancing privacy,
+modifying web page data, managing HTTP
 cookies, 
 controlling access, and removing ads, banners, pop-ups and other obnoxious
-Internet junk. Privoxy has a very flexible configuration and can be
+Internet junk. Privoxy has a flexible configuration and can be
 customized to suit individual needs and tastes. Privoxy has application for
 both stand-alone systems and multi-user networks.
 <P>
@@ -79,10 +84,13 @@ Privoxy is based on Internet Junkbuster (tm).
 
 <P>
 
-Browsers must be individually configured to use <B>Privoxy</B> 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:  <B>Edit</B>;
+Browsers can either be individually configured to use
+<B>Privoxy</B> as a HTTP proxy (recommended),
+or <B>Privoxy</B> can be combined with a packet
+filter to build an intercepting proxy
+(see <I>config</I>).  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:  <B>Edit</B>;
 <B>Preferences</B>;  <B>Advanced</B>;
 <B>Proxies</B>;  <B>Manual Proxy Configuration</B>;
 <B>View</B>. 
@@ -133,7 +141,8 @@ that the user has greatly enhanced control and freedom.
 <P>
 
 The actions list (ad blocks, etc) can also be configured with your
-web browser at <A HREF="http://config.privoxy.org/">http://config.privoxy.org/.</A>
+web browser at <A HREF="http://config.privoxy.org/">http://config.privoxy.org/</A> 
+(assuming the configuration allows it).
 <B>Privoxy's</B> configuration parameters  can also  be viewed at
 the same page. In addition, <B>Privoxy</B> can be toggled on/off.
 This is an internal page, and does not require Internet access.
@@ -161,94 +170,55 @@ configuration might look like:
 
  # 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, 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
-
  # Block all URLs that match these patterns
  { +block }
-  ad*.
+  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
 </PRE>
 
 <P>
@@ -271,14 +241,14 @@ narrowly defined exceptions:
   .sun.com
   .msdn.microsoft.com
  
- # These sites breaks easily. Use our &quot;fragile&quot; alias here.
+ # These sites break easily. Use our &quot;fragile&quot; alias here.
  { fragile }
   .forbes.com
   mybank.example.com
 
  # Replace example.com's style sheet with one of my choosing
  { +redirect{<A HREF="http://localhost/css-replacements/example.com.css}">http://localhost/css-replacements/example.com.css}</A> }
-  example.com/stylesheet.css
+  .example.com/stylesheet.css
 </PRE>
 
 <P>
@@ -327,7 +297,7 @@ automatically.
 
 <P>
 
-This is a BETA version of <B>Privoxy</B>. Not 
+This is a beta version of <B>Privoxy</B>. Not 
 all features are well tested.
 <P>
 
@@ -369,9 +339,14 @@ the original Internet Junkbuster.
 <A HREF="http://privacy.net/">http://privacy.net/,</A> a useful site
 to check what information about you is leaked while you browse the web.
 <P>
-<A HREF="http://www.squid-cache.org/">http://www.squid-cache.org/,</A> a very popular
+<A HREF="http://www.squid-cache.org/">http://www.squid-cache.org/,</A> a popular
 caching proxy, which is often used together with <B>Privoxy</B>.
 <P>
+<A HREF="http://www.pps.jussieu.fr/~jch/software/polipo/">http://www.pps.jussieu.fr/~jch/software/polipo/,</A>
+<B>Polipo</B> is a caching proxy with advanced features
+like pipelining, multiplexing and caching of partial instances. In many setups
+it can be used as <B>Squid</B> replacement.
+<P>
 <A HREF="http://tor.eff.org/">http://tor.eff.org/,</A> 
 <B>Tor</B> can help anonymize web browsing, 
 web publishing, instant messaging, IRC, SSH, and other applications.
@@ -383,13 +358,14 @@ the <B>Privoxy</B> developer manual.
 
 <P>
 <PRE>
- Fabian Keil, developer
+ Fabian Keil, lead developer
  David Schmidt, developer
  
  Hal Burgiss
- Ian Cummings
- F&#233;lix Rauch
+ Mark Miller
+ Gerry Murphy
  Roland Rosenfeld
+ Jörg Strohmayer
 </PRE>
 
 <A NAME="lbAN">&nbsp;</A>
@@ -400,7 +376,7 @@ the <B>Privoxy</B> developer manual.
 
 <P>
 
-Copyright (C) 2001 - 2006 by Privoxy Developers &lt;<A HREF="mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</A>&gt;
+Copyright (C) 2001-2008 by Privoxy Developers &lt;<A HREF="mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</A>&gt;
 <P>
 
 Some source code is based on code Copyright (C) 1997 by Anonymous Coders
@@ -413,19 +389,16 @@ License</I>.
 
 <B>Privoxy</B> is free software; you can
 redistribute it and/or modify it under the terms of the 
-<I>GNU General Public
-License</I>, version 2, as published by the Free Software Foundation.
+<I>GNU General Public License</I>, version 2,
+as published by the Free Software Foundation.
 <P>
 
 This program is distributed in the hope that it will be useful, but WITHOUT
 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-FITNESS FOR A PARTICULAR PURPOSE.  See the 
-<I>GNU General Public License</I> for
-more details, which is available from the Free Software Foundation, Inc, 
-51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+FITNESS FOR A PARTICULAR PURPOSE.  See the  <I>GNU General Public License</I> for details.
 <P>
 
-You should have received a copy of the  <I>GNU General Public License</I>
+You should have received a copy of the <I>GNU GPL</I>
 along with this program; if not, write to the  Free Software
 Foundation, Inc. 51 Franklin Street, Fifth Floor
 Boston, MA 02110-1301
@@ -457,6 +430,6 @@ USA
 This document was created by
 man2html,
 using the manual pages.<BR>
-Time: 01:21:32 GMT, September 22, 2006
+Time: 01:33:00 GMT, June 19, 2008
 </BODY>
 </HTML>