<HTML
><HEAD
><TITLE
->Privoxy User Manual</TITLE
+>Privoxy 3.1.1 User Manual</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="NEXT"
TITLE="Introduction"
><H1
CLASS="TITLE"
><A
-NAME="AEN2"
->Privoxy User Manual</A
-></H1
-><DIV
-CLASS="AUTHORGROUP"
-><A
-NAME="AEN5"
-></A
-><H3
-CLASS="AUTHOR"
-><A
-NAME="AEN6"
-></A
-></H3
-><DIV
-CLASS="AFFILIATION"
-><SPAN
-CLASS="ORGNAME"
->By: Privoxy Developers<BR></SPAN
-></DIV
-></DIV
+NAME="AEN2">Privoxy 3.1.1 User Manual</H1
><P
CLASS="PUBDATE"
->$Id: user-manual.sgml,v 1.99 2002/04/28 16:59:05 swa Exp $<BR></P
+> <SUB
+> <A
+HREF="copyright.html"
+>Copyright</A
+> © 2001, 2002 by
+ <A
+HREF="http://www.privoxy.org/"
+TARGET="_top"
+>Privoxy Developers</A
+>
+ </SUB
+><BR></P
+><P
+CLASS="PUBDATE"
+>$Id: user-manual.sgml,v 2.2 2002/09/05 05:45:30 hal9 Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
><A
-NAME="AEN9"
-></A
-><P
+NAME="AEN9"><P
></P
><P
-> The user manual gives users information on how to install, configure and use
- <A
+> The <I
+CLASS="CITETITLE"
+>User Manual</I
+> gives users information on how to
+ install, configure and use <A
HREF="http://www.privoxy.org/"
TARGET="_top"
><SPAN
>Privoxy</SPAN
></A
>.
- </P
+ </P
><P
> <SPAN
CLASS="APPLICATION"
Junkbuster</SPAN
> (tm).</P
><P
-> You can find the latest version of the user manual at <A
+> You can find the latest version of the <I
+CLASS="CITETITLE"
+>User Manual</I
+> at <A
HREF="http://www.privoxy.org/user-manual/"
TARGET="_top"
>http://www.privoxy.org/user-manual/</A
>.
Please see the <A
HREF="contact.html"
-TARGET="_top"
>Contact section</A
> on how to
contact the developers.
- </P
+ </P
><P
></P
></DIV
>Table of Contents</B
></DT
><DT
-><A
-HREF="index.html#INTRO"
-></A
-></DT
-><DT
>1. <A
HREF="introduction.html"
>Introduction</A
></DL
></DD
><DT
->3. <A
+>2. <A
HREF="installation.html"
>Installation</A
></DT
><DD
><DL
><DT
->3.1. <A
+>2.1. <A
+HREF="installation.html#INSTALLATION-PACKAGES"
+>Binary Packages</A
+></DT
+><DD
+><DL
+><DT
+>2.1.1. <A
HREF="installation.html#INSTALLATION-PACK-RPM"
->Red Hat and SuSE RPMs</A
+>Red Hat, SuSE and Conectiva RPMs</A
></DT
><DT
->3.2. <A
+>2.1.2. <A
HREF="installation.html#INSTALLATION-DEB"
>Debian</A
></DT
><DT
->3.3. <A
+>2.1.3. <A
HREF="installation.html#INSTALLATION-PACK-WIN"
>Windows</A
></DT
><DT
->3.4. <A
+>2.1.4. <A
HREF="installation.html#INSTALLATION-PACK-BINTGZ"
>Solaris, NetBSD, FreeBSD, HP-UX</A
></DT
><DT
->3.5. <A
+>2.1.5. <A
HREF="installation.html#INSTALLATION-OS2"
>OS/2</A
></DT
><DT
->3.6. <A
+>2.1.6. <A
HREF="installation.html#INSTALLATION-MAC"
->Max OSX</A
+>Mac OSX</A
></DT
><DT
->3.7. <A
+>2.1.7. <A
HREF="installation.html#INSTALLATION-AMIGA"
>AmigaOS</A
></DT
+><DT
+>2.1.8. <A
+HREF="installation.html#INSTALLATTION-GENTOO"
+>Gentoo</A
+></DT
></DL
></DD
><DT
->4. <A
+>2.2. <A
+HREF="installation.html#INSTALLATION-SOURCE"
+>Building from Source</A
+></DT
+><DT
+>2.3. <A
+HREF="installation.html#INSTALLATION-KEEPUPDATED"
+>Keeping your Installation Up-to-Date</A
+></DT
+></DL
+></DD
+><DT
+>3. <A
HREF="upgradersnote.html"
>Note to Upgraders</A
></DT
><DT
->5. <A
+>4. <A
HREF="quickstart.html"
>Quickstart to Using <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
></A
></DT
+><DD
+><DL
><DT
->6. <A
+>4.1. <A
+HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
+>Quickstart to Ad Blocking</A
+></DT
+></DL
+></DD
+><DT
+>5. <A
HREF="startup.html"
>Starting <SPAN
CLASS="APPLICATION"
><DD
><DL
><DT
->6.1. <A
-HREF="startup.html#START-REDHATDEBIAN"
->RedHat and Debian</A
+>5.1. <A
+HREF="startup.html#START-REDHAT"
+>Red Hat and Conectiva</A
></DT
><DT
->6.2. <A
+>5.2. <A
+HREF="startup.html#START-DEBIAN"
+>Debian</A
+></DT
+><DT
+>5.3. <A
HREF="startup.html#START-SUSE"
>SuSE</A
></DT
><DT
->6.3. <A
+>5.4. <A
HREF="startup.html#START-WINDOWS"
>Windows</A
></DT
><DT
->6.4. <A
+>5.5. <A
HREF="startup.html#START-UNICES"
>Solaris, NetBSD, FreeBSD, HP-UX and others</A
></DT
><DT
->6.5. <A
+>5.6. <A
HREF="startup.html#START-OS2"
>OS/2</A
></DT
><DT
->6.6. <A
+>5.7. <A
HREF="startup.html#START-MACOSX"
->MAX OSX</A
+>Mac OSX</A
></DT
><DT
->6.7. <A
+>5.8. <A
HREF="startup.html#START-AMIGAOS"
>AmigaOS</A
></DT
><DT
->6.8. <A
+>5.9. <A
+HREF="startup.html#START-GENTOO"
+>Gentoo</A
+></DT
+><DT
+>5.10. <A
HREF="startup.html#CMDOPTIONS"
>Command Line Options</A
></DT
></DL
></DD
><DT
->7. <A
+>6. <A
HREF="configuration.html"
><SPAN
CLASS="APPLICATION"
><DD
><DL
><DT
->7.1. <A
-HREF="configuration.html#AEN305"
+>6.1. <A
+HREF="configuration.html#AEN582"
>Controlling <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> with Your Web Browser</A
></DT
><DT
->7.2. <A
+>6.2. <A
HREF="configuration.html#CONFOVERVIEW"
>Configuration Files Overview</A
></DT
></DL
></DD
><DT
->8. <A
+>7. <A
HREF="config.html"
>The Main Configuration File</A
></DT
><DD
><DL
><DT
->8.1. <A
+>7.1. <A
HREF="config.html#CONF-LOG-LOC"
>Configuration and Log File Locations</A
></DT
><DD
><DL
><DT
->8.1.1. <A
+>7.1.1. <A
HREF="config.html#CONFDIR"
>confdir</A
></DT
><DT
->8.1.2. <A
+>7.1.2. <A
HREF="config.html#LOGDIR"
>logdir</A
></DT
><DT
->8.1.3. <A
+>7.1.3. <A
HREF="config.html#ACTIONSFILE"
>actionsfile</A
></DT
><DT
->8.1.4. <A
+>7.1.4. <A
HREF="config.html#FILTERFILE"
>filterfile</A
></DT
><DT
->8.1.5. <A
+>7.1.5. <A
HREF="config.html#LOGFILE"
>logfile</A
></DT
><DT
->8.1.6. <A
+>7.1.6. <A
HREF="config.html#JARFILE"
>jarfile</A
></DT
><DT
->8.1.7. <A
+>7.1.7. <A
HREF="config.html#TRUSTFILE"
>trustfile</A
></DT
-><DT
->8.1.8. <A
-HREF="config.html#USER-MANUAL"
->user-manual</A
-></DT
></DL
></DD
><DT
->8.2. <A
+>7.2. <A
HREF="config.html#LOCAL-SET-UP"
>Local Set-up Documentation</A
></DT
><DD
><DL
><DT
->8.2.1. <A
+>7.2.1. <A
+HREF="config.html#USER-MANUAL"
+>user-manual</A
+></DT
+><DT
+>7.2.2. <A
HREF="config.html#TRUST-INFO-URL"
>trust-info-url</A
></DT
><DT
->8.2.2. <A
+>7.2.3. <A
HREF="config.html#ADMIN-ADDRESS"
>admin-address</A
></DT
><DT
->8.2.3. <A
+>7.2.4. <A
HREF="config.html#PROXY-INFO-URL"
>proxy-info-url</A
></DT
></DL
></DD
><DT
->8.3. <A
+>7.3. <A
HREF="config.html#DEBUGGING"
>Debugging</A
></DT
><DD
><DL
><DT
->8.3.1. <A
+>7.3.1. <A
HREF="config.html#DEBUG"
>debug</A
></DT
><DT
->8.3.2. <A
+>7.3.2. <A
HREF="config.html#SINGLE-THREADED"
>single-threaded</A
></DT
></DL
></DD
><DT
->8.4. <A
+>7.4. <A
HREF="config.html#ACCESS-CONTROL"
>Access Control and Security</A
></DT
><DD
><DL
><DT
->8.4.1. <A
+>7.4.1. <A
HREF="config.html#LISTEN-ADDRESS"
>listen-address</A
></DT
><DT
->8.4.2. <A
+>7.4.2. <A
HREF="config.html#TOGGLE"
>toggle</A
></DT
><DT
->8.4.3. <A
+>7.4.3. <A
HREF="config.html#ENABLE-REMOTE-TOGGLE"
>enable-remote-toggle</A
></DT
><DT
->8.4.4. <A
+>7.4.4. <A
HREF="config.html#ENABLE-EDIT-ACTIONS"
>enable-edit-actions</A
></DT
><DT
->8.4.5. <A
+>7.4.5. <A
HREF="config.html#ACLS"
>ACLs: permit-access and deny-access</A
></DT
><DT
->8.4.6. <A
+>7.4.6. <A
HREF="config.html#BUFFER-LIMIT"
>buffer-limit</A
></DT
></DL
></DD
><DT
->8.5. <A
+>7.5. <A
HREF="config.html#FORWARDING"
>Forwarding</A
></DT
><DD
><DL
><DT
->8.5.1. <A
+>7.5.1. <A
HREF="config.html#FORWARD"
>forward</A
></DT
><DT
->8.5.2. <A
+>7.5.2. <A
HREF="config.html#SOCKS"
>forward-socks4 and forward-socks4a</A
></DT
><DT
->8.5.3. <A
+>7.5.3. <A
HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
>Advanced Forwarding Examples</A
></DT
></DL
></DD
><DT
->8.6. <A
+>7.6. <A
HREF="config.html#WINDOWS-GUI"
>Windows GUI Options</A
></DT
></DL
></DD
><DT
->9. <A
+>8. <A
HREF="actions-file.html"
>Actions Files</A
></DT
><DD
><DL
><DT
->9.1. <A
-HREF="actions-file.html#AEN1299"
+>8.1. <A
+HREF="actions-file.html#AEN1645"
>Finding the Right Mix</A
></DT
><DT
->9.2. <A
-HREF="actions-file.html#AEN1306"
+>8.2. <A
+HREF="actions-file.html#AEN1652"
>How to Edit</A
></DT
><DT
->9.3. <A
-HREF="actions-file.html#AEN1312"
+>8.3. <A
+HREF="actions-file.html#ACTIONS-APPLY"
>How Actions are Applied to URLs</A
></DT
><DT
->9.4. <A
-HREF="actions-file.html#AEN1326"
+>8.4. <A
+HREF="actions-file.html#AF-PATTERNS"
>Patterns</A
></DT
><DD
><DL
><DT
->9.4.1. <A
-HREF="actions-file.html#AEN1366"
+>8.4.1. <A
+HREF="actions-file.html#AEN1716"
>The Domain Pattern</A
></DT
><DT
->9.4.2. <A
-HREF="actions-file.html#AEN1428"
+>8.4.2. <A
+HREF="actions-file.html#AEN1778"
>The Path Pattern</A
></DT
></DL
></DD
><DT
->9.5. <A
+>8.5. <A
HREF="actions-file.html#ACTIONS"
>Actions</A
></DT
><DD
><DL
><DT
->9.5.1. <A
+>8.5.1. <A
HREF="actions-file.html#ADD-HEADER"
-><I
-CLASS="EMPHASIS"
->+add-header</I
-></A
+>add-header</A
></DT
><DT
->9.5.2. <A
+>8.5.2. <A
HREF="actions-file.html#BLOCK"
-><I
-CLASS="EMPHASIS"
->+block</I
-></A
+>block</A
+></DT
+><DT
+>8.5.3. <A
+HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
+>crunch-incoming-cookies</A
+></DT
+><DT
+>8.5.4. <A
+HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
+>crunch-outgoing-cookies</A
></DT
><DT
->9.5.3. <A
+>8.5.5. <A
HREF="actions-file.html#DEANIMATE-GIFS"
-><I
-CLASS="EMPHASIS"
->+deanimate-gifs</I
-></A
+>deanimate-gifs</A
></DT
><DT
->9.5.4. <A
+>8.5.6. <A
HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
-><I
-CLASS="EMPHASIS"
->+downgrade-http-version</I
-></A
+>downgrade-http-version</A
></DT
><DT
->9.5.5. <A
+>8.5.7. <A
HREF="actions-file.html#FAST-REDIRECTS"
-><I
-CLASS="EMPHASIS"
->+fast-redirects</I
-></A
+>fast-redirects</A
></DT
><DT
->9.5.6. <A
+>8.5.8. <A
HREF="actions-file.html#FILTER"
-><I
-CLASS="EMPHASIS"
->+filter</I
-></A
+>filter</A
></DT
><DT
->9.5.7. <A
+>8.5.9. <A
+HREF="actions-file.html#HANDLE-AS-IMAGE"
+>handle-as-image</A
+></DT
+><DT
+>8.5.10. <A
HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
-><I
-CLASS="EMPHASIS"
->+hide-forwarded-for-headers</I
-></A
+>hide-forwarded-for-headers</A
></DT
><DT
->9.5.8. <A
+>8.5.11. <A
HREF="actions-file.html#HIDE-FROM-HEADER"
-><I
-CLASS="EMPHASIS"
->+hide-from-header</I
-></A
+>hide-from-header</A
></DT
><DT
->9.5.9. <A
-HREF="actions-file.html#HIDE-REFERER"
-><I
-CLASS="EMPHASIS"
->+hide-referer</I
-></A
+>8.5.12. <A
+HREF="actions-file.html#HIDE-REFERRER"
+>hide-referrer</A
></DT
><DT
->9.5.10. <A
+>8.5.13. <A
HREF="actions-file.html#HIDE-USER-AGENT"
-><I
-CLASS="EMPHASIS"
->+hide-user-agent</I
-></A
+>hide-user-agent</A
></DT
><DT
->9.5.11. <A
-HREF="actions-file.html#HANDLE-AS-IMAGE"
-><I
-CLASS="EMPHASIS"
->+handle-as-image</I
+>8.5.14. <A
+HREF="actions-file.html#KILL-POPUPS"
+>kill-popups<A
+NAME="KILL-POPUP"
></A
-></DT
-><DT
->9.5.12. <A
-HREF="actions-file.html#SET-IMAGE-BLOCKER"
-><I
-CLASS="EMPHASIS"
->+set-image-blocker</I
></A
></DT
><DT
->9.5.13. <A
+>8.5.15. <A
HREF="actions-file.html#LIMIT-CONNECT"
-><I
-CLASS="EMPHASIS"
->+limit-connect</I
-></A
+>limit-connect</A
></DT
><DT
->9.5.14. <A
+>8.5.16. <A
HREF="actions-file.html#PREVENT-COMPRESSION"
-><I
-CLASS="EMPHASIS"
->+prevent-compression</I
-></A
+>prevent-compression</A
></DT
><DT
->9.5.15. <A
-HREF="actions-file.html#SESSION-COOKIES-ONLY"
-><I
-CLASS="EMPHASIS"
->+session-cookies-only</I
-></A
+>8.5.17. <A
+HREF="actions-file.html#SEND-VANILLA-WAFER"
+>send-vanilla-wafer</A
></DT
><DT
->9.5.16. <A
-HREF="actions-file.html#PREVENT-READING-COOKIES"
-><I
-CLASS="EMPHASIS"
->+prevent-reading-cookies</I
-></A
+>8.5.18. <A
+HREF="actions-file.html#SEND-WAFER"
+>send-wafer</A
></DT
><DT
->9.5.17. <A
-HREF="actions-file.html#PREVENT-SETTING-COOKIES"
-><I
-CLASS="EMPHASIS"
->+prevent-setting-cookies</I
-></A
+>8.5.19. <A
+HREF="actions-file.html#SESSION-COOKIES-ONLY"
+>session-cookies-only</A
></DT
><DT
->9.5.18. <A
-HREF="actions-file.html#KILL-POPUP"
-><I
-CLASS="EMPHASIS"
->+kill-popups<A
-NAME="KILL-POPUPS"
-></A
-></I
-></A
+>8.5.20. <A
+HREF="actions-file.html#SET-IMAGE-BLOCKER"
+>set-image-blocker</A
></DT
><DT
->9.5.19. <A
-HREF="actions-file.html#SEND-VANILLA-WAFER"
-><I
-CLASS="EMPHASIS"
->+send-vanilla-wafer</I
-></A
+>8.5.21. <A
+HREF="actions-file.html#AEN2706"
+>Summary</A
></DT
+></DL
+></DD
><DT
->9.5.20. <A
-HREF="actions-file.html#SEND-WAFER"
-><I
-CLASS="EMPHASIS"
->+send-wafer</I
-></A
+>8.6. <A
+HREF="actions-file.html#ALIASES"
+>Aliases</A
></DT
><DT
->9.5.21. <A
-HREF="actions-file.html#AEN2196"
->Summary</A
+>8.7. <A
+HREF="actions-file.html#ACT-EXAMPLES"
+>Actions Files Tutorial</A
></DT
+><DD
+><DL
><DT
->9.5.22. <A
-HREF="actions-file.html#ACT-EXAMPLES"
->Sample Actions Files</A
+>8.7.1. <A
+HREF="actions-file.html#AEN2758"
+>default.action</A
></DT
-></DL
-></DD
><DT
->9.6. <A
-HREF="actions-file.html#ALIASES"
->Aliases</A
+>8.7.2. <A
+HREF="actions-file.html#AEN2915"
+>user.action</A
></DT
></DL
></DD
+></DL
+></DD
><DT
->10. <A
+>9. <A
HREF="filter-file.html"
>The Filter File</A
></DT
><DD
><DL
><DT
->10.1. <A
-HREF="filter-file.html#AEN2339"
->The <I
-CLASS="EMPHASIS"
->+filter</I
-> Action</A
+>9.1. <A
+HREF="filter-file.html#AEN3018"
+>Filter File Tutorial</A
></DT
></DL
></DD
><DT
->11. <A
+>10. <A
HREF="templates.html"
>Templates</A
></DT
><DT
->12. <A
+>11. <A
HREF="contact.html"
>Contacting the Developers, Bug Reporting and Feature
Requests</A
><DD
><DL
><DT
->12.1. <A
+>11.1. <A
HREF="contact.html#CONTACT-SUPPORT"
>Get Support</A
></DT
><DT
->12.2. <A
+>11.2. <A
HREF="contact.html#CONTACT-BUGS"
->Report bugs</A
+>Report Bugs</A
></DT
><DT
->12.3. <A
+>11.3. <A
HREF="contact.html#CONTACT-FEATURE"
->Request new features</A
+>Request New Features</A
></DT
><DT
->12.4. <A
+>11.4. <A
HREF="contact.html#CONTACT-ADS"
->Report ads or other filter problems</A
+>Report Ads or Other Actions-Related Problems</A
></DT
><DT
->12.5. <A
+>11.5. <A
HREF="contact.html#CONTACT-OTHER"
>Other</A
></DT
></DL
></DD
><DT
->13. <A
+>12. <A
HREF="copyright.html"
->Copyright and History</A
+><SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> Copyright, License and History</A
></DT
><DD
><DL
><DT
->13.1. <A
-HREF="copyright.html#AEN2400"
->Copyright</A
+>12.1. <A
+HREF="copyright.html#AEN3220"
+>License</A
></DT
><DT
->13.2. <A
+>12.2. <A
HREF="copyright.html#HISTORY"
>History</A
></DT
+><DT
+>12.3. <A
+HREF="copyright.html#AUTHORS"
+>Authors</A
+></DT
></DL
></DD
><DT
->14. <A
+>13. <A
HREF="seealso.html"
>See Also</A
></DT
><DT
->15. <A
+>14. <A
HREF="appendix.html"
>Appendix</A
></DT
><DD
><DL
><DT
->15.1. <A
+>14.1. <A
HREF="appendix.html#REGEX"
>Regular Expressions</A
></DT
><DT
->15.2. <A
-HREF="appendix.html#AEN2625"
+>14.2. <A
+HREF="appendix.html#AEN3474"
><SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><DD
><DL
><DT
->15.2.1. <A
+>14.2.1. <A
HREF="appendix.html#BOOKMARKLETS"
>Bookmarklets</A
></DT
></DL
></DD
><DT
->15.3. <A
+>14.3. <A
HREF="appendix.html#CHAIN"
>Chain of Events</A
></DT
><DT
->15.4. <A
+>14.4. <A
HREF="appendix.html#ACTIONSANAT"
>Anatomy of an Action</A
></DT
></DD
></DL
></DIV
-><DIV
-CLASS="SECT1"
-><H1
-CLASS="SECT1"
-><A
-NAME="INTRO"
-></A
-></H1
-><P
-> </P
-></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
VALIGN="top"
><A
HREF="introduction.html"
+ACCESSKEY="N"
>Next</A
></TD
></TR