-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
->Privoxy 3.0.3 User Manual</TITLE
+>Privoxy 3.0.9 User Manual</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="NEXT"
TITLE="Introduction"
HREF="introduction.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
-HREF="../p_doc.css"></HEAD
+HREF="../p_doc.css"><META
+HTTP-EQUIV="Content-Type"
+CONTENT="text/html;
+charset=ISO-8859-1">
+<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
+</head
><BODY
CLASS="ARTICLE"
BGCOLOR="#EEEEEE"
CLASS="TITLE"
><A
NAME="AEN2"
->Privoxy 3.0.3 User Manual</A
+>Privoxy 3.0.9 User Manual</A
></H1
><P
CLASS="PUBDATE"
> <A
HREF="copyright.html"
>Copyright</A
-> © 2001 - 2004 by
+> © 2001 - 2008 by
<A
HREF="http://www.privoxy.org/"
TARGET="_top"
><BR></P
><P
CLASS="PUBDATE"
->$Id: index.html,v 1.18.2.11 2004/01/31 00:05:44 oes Exp $<BR></P
+>$Id: user-manual.sgml,v 2.79 2008/06/27 18:00:53 markm68k Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
><P
> The <I
CLASS="CITETITLE"
->User Manual</I
+>Privoxy User Manual</I
> gives users information on how to
install, configure and use <A
HREF="http://www.privoxy.org/"
TARGET="_top"
-><SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-></A
+>Privoxy</A
>.
</P
><P
-> <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> is a web proxy with advanced filtering
- capabilities for protecting privacy, modifying web page content, managing
- cookies, controlling access, and removing ads, banners, pop-ups and other
- obnoxious Internet junk. <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> has a very
- flexible configuration and can be customized to suit individual needs and
- tastes. <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> has application for both
- stand-alone systems and multi-user networks.</P
+> Privoxy is a non-caching
+ <A
+HREF="http://en.wikipedia.org/wiki/Proxy_server"
+TARGET="_top"
+>web proxy</A
+>
+ with advanced filtering capabilities for enhancing privacy,
+ modifying web page data, managing HTTP
+ <A
+HREF="http://en.wikipedia.org/wiki/Browser_cookie"
+TARGET="_top"
+>cookies</A
+>,
+ controlling access, and removing ads, banners, pop-ups and other obnoxious
+ 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
><P
-> <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> is based on <SPAN
-CLASS="APPLICATION"
->Internet
- Junkbuster</SPAN
-> (tm).</P
+> Privoxy is based on Internet Junkbuster (tm).</P
><P
> You can find the latest version of the <I
CLASS="CITETITLE"
->User Manual</I
+>Privoxy User Manual</I
> at <A
HREF="http://www.privoxy.org/user-manual/"
TARGET="_top"
><DT
>2.1.1. <A
HREF="installation.html#INSTALLATION-PACK-RPM"
->Red Hat, SuSE and Conectiva RPMs</A
+>Red Hat and Fedora RPMs</A
></DT
><DT
>2.1.2. <A
HREF="installation.html#INSTALLATION-DEB"
->Debian</A
+>Debian and Ubuntu</A
></DT
><DT
>2.1.3. <A
><DT
>2.1.4. <A
HREF="installation.html#INSTALLATION-PACK-BINTGZ"
->Solaris, NetBSD, FreeBSD, HP-UX</A
+>Solaris</A
></DT
><DT
>2.1.5. <A
><DT
>2.1.6. <A
HREF="installation.html#INSTALLATION-MAC"
->Mac OSX</A
+>Mac OS X</A
></DT
><DT
>2.1.7. <A
></DT
><DT
>2.1.8. <A
+HREF="installation.html#INSTALLATION-TBZ"
+>FreeBSD</A
+></DT
+><DT
+>2.1.9. <A
HREF="installation.html#INSTALLATTION-GENTOO"
>Gentoo</A
></DT
></DD
><DT
>3. <A
-HREF="upgradersnote.html"
+HREF="whatsnew.html"
+>What's New in this Release</A
+></DT
+><DD
+><DL
+><DT
+>3.1. <A
+HREF="whatsnew.html#UPGRADERSNOTE"
>Note to Upgraders</A
></DT
+></DL
+></DD
><DT
>4. <A
HREF="quickstart.html"
->Quickstart to Using <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-></A
+>Quickstart to Using Privoxy</A
></DT
><DD
><DL
><DT
>5. <A
HREF="startup.html"
->Starting <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-></A
+>Starting Privoxy</A
></DT
><DD
><DL
><DT
>5.1. <A
HREF="startup.html#START-REDHAT"
->Red Hat and Conectiva</A
+>Red Hat and Fedora</A
></DT
><DT
>5.2. <A
></DT
><DT
>5.3. <A
-HREF="startup.html#START-SUSE"
->SuSE</A
-></DT
-><DT
->5.4. <A
HREF="startup.html#START-WINDOWS"
>Windows</A
></DT
><DT
HREF="startup.html#START-UNICES"
>Solaris, NetBSD, FreeBSD, HP-UX and others</A
></DT
><DT
HREF="startup.html#START-OS2"
>OS/2</A
></DT
><DT
HREF="startup.html#START-MACOSX"
->Mac OSX</A
+>Mac OS X</A
></DT
><DT
HREF="startup.html#START-AMIGAOS"
>AmigaOS</A
></DT
><DT
HREF="startup.html#START-GENTOO"
>Gentoo</A
></DT
><DT
HREF="startup.html#CMDOPTIONS"
>Command Line Options</A
></DT
><DT
>6. <A
HREF="configuration.html"
-><SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> Configuration</A
+>Privoxy Configuration</A
></DT
><DD
><DL
><DT
>6.1. <A
-HREF="configuration.html#AEN585"
->Controlling <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> with Your Web Browser</A
+HREF="configuration.html#AEN806"
+>Controlling Privoxy with Your Web Browser</A
></DT
><DT
>6.2. <A
><DL
><DT
>7.1. <A
-HREF="config.html#CONF-LOG-LOC"
->Configuration and Log File Locations</A
+HREF="config.html#LOCAL-SET-UP"
+>Local Set-up Documentation</A
></DT
><DD
><DL
><DT
>7.1.1. <A
-HREF="config.html#CONFDIR"
->confdir</A
+HREF="config.html#USER-MANUAL"
+>user-manual</A
></DT
><DT
>7.1.2. <A
-HREF="config.html#LOGDIR"
->logdir</A
+HREF="config.html#TRUST-INFO-URL"
+>trust-info-url</A
></DT
><DT
>7.1.3. <A
-HREF="config.html#ACTIONSFILE"
->actionsfile</A
+HREF="config.html#ADMIN-ADDRESS"
+>admin-address</A
></DT
><DT
>7.1.4. <A
-HREF="config.html#FILTERFILE"
->filterfile</A
-></DT
-><DT
->7.1.5. <A
-HREF="config.html#LOGFILE"
->logfile</A
-></DT
-><DT
->7.1.6. <A
-HREF="config.html#JARFILE"
->jarfile</A
-></DT
-><DT
->7.1.7. <A
-HREF="config.html#TRUSTFILE"
->trustfile</A
+HREF="config.html#PROXY-INFO-URL"
+>proxy-info-url</A
></DT
></DL
></DD
><DT
>7.2. <A
-HREF="config.html#LOCAL-SET-UP"
->Local Set-up Documentation</A
+HREF="config.html#CONF-LOG-LOC"
+>Configuration and Log File Locations</A
></DT
><DD
><DL
><DT
>7.2.1. <A
-HREF="config.html#USER-MANUAL"
->user-manual</A
+HREF="config.html#CONFDIR"
+>confdir</A
></DT
><DT
>7.2.2. <A
-HREF="config.html#TRUST-INFO-URL"
->trust-info-url</A
+HREF="config.html#TEMPLDIR"
+>templdir</A
></DT
><DT
>7.2.3. <A
-HREF="config.html#ADMIN-ADDRESS"
->admin-address</A
+HREF="config.html#LOGDIR"
+>logdir</A
></DT
><DT
>7.2.4. <A
-HREF="config.html#PROXY-INFO-URL"
->proxy-info-url</A
+HREF="config.html#ACTIONSFILE"
+>actionsfile</A
+></DT
+><DT
+>7.2.5. <A
+HREF="config.html#FILTERFILE"
+>filterfile</A
+></DT
+><DT
+>7.2.6. <A
+HREF="config.html#LOGFILE"
+>logfile</A
+></DT
+><DT
+>7.2.7. <A
+HREF="config.html#JARFILE"
+>jarfile</A
+></DT
+><DT
+>7.2.8. <A
+HREF="config.html#TRUSTFILE"
+>trustfile</A
></DT
></DL
></DD
HREF="config.html#SINGLE-THREADED"
>single-threaded</A
></DT
+><DT
+>7.3.3. <A
+HREF="config.html#HOSTNAME"
+>hostname</A
+></DT
></DL
></DD
><DT
></DT
><DT
>7.4.4. <A
+HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
+>enable-remote-http-toggle</A
+></DT
+><DT
+>7.4.5. <A
HREF="config.html#ENABLE-EDIT-ACTIONS"
>enable-edit-actions</A
></DT
><DT
->7.4.5. <A
+>7.4.6. <A
+HREF="config.html#ENFORCE-BLOCKS"
+>enforce-blocks</A
+></DT
+><DT
+>7.4.7. <A
HREF="config.html#ACLS"
>ACLs: permit-access and deny-access</A
></DT
><DT
HREF="config.html#BUFFER-LIMIT"
>buffer-limit</A
></DT
><DT
>7.5.2. <A
HREF="config.html#SOCKS"
->forward-socks4 and forward-socks4a</A
+>forward-socks4, forward-socks4a and forward-socks5</A
></DT
><DT
>7.5.3. <A
HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
>Advanced Forwarding Examples</A
></DT
+><DT
+>7.5.4. <A
+HREF="config.html#FORWARDED-CONNECT-RETRIES"
+>forwarded-connect-retries</A
+></DT
+><DT
+>7.5.5. <A
+HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
+>accept-intercepted-requests</A
+></DT
+><DT
+>7.5.6. <A
+HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING"
+>allow-cgi-request-crunching</A
+></DT
+><DT
+>7.5.7. <A
+HREF="config.html#SPLIT-LARGE-FORMS"
+>split-large-forms</A
+></DT
></DL
></DD
><DT
><DL
><DT
>8.1. <A
-HREF="actions-file.html#AEN1753"
+HREF="actions-file.html#AEN2290"
>Finding the Right Mix</A
></DT
><DT
>8.2. <A
-HREF="actions-file.html#AEN1760"
+HREF="actions-file.html#AEN2297"
>How to Edit</A
></DT
><DT
>8.3. <A
HREF="actions-file.html#ACTIONS-APPLY"
->How Actions are Applied to URLs</A
+>How Actions are Applied to Requests</A
></DT
><DT
>8.4. <A
><DL
><DT
>8.4.1. <A
-HREF="actions-file.html#AEN1833"
+HREF="actions-file.html#AEN2388"
>The Domain Pattern</A
></DT
><DT
>8.4.2. <A
-HREF="actions-file.html#AEN1895"
+HREF="actions-file.html#AEN2464"
>The Path Pattern</A
></DT
+><DT
+>8.4.3. <A
+HREF="actions-file.html#TAG-PATTERN"
+>The Tag Pattern</A
+></DT
></DL
></DD
><DT
></DT
><DT
>8.5.3. <A
+HREF="actions-file.html#CLIENT-HEADER-FILTER"
+>client-header-filter</A
+></DT
+><DT
+>8.5.4. <A
+HREF="actions-file.html#CLIENT-HEADER-TAGGER"
+>client-header-tagger</A
+></DT
+><DT
+>8.5.5. <A
+HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
+>content-type-overwrite</A
+></DT
+><DT
+>8.5.6. <A
+HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
+>crunch-client-header</A
+></DT
+><DT
+>8.5.7. <A
+HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
+>crunch-if-none-match</A
+></DT
+><DT
+>8.5.8. <A
HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
>crunch-incoming-cookies</A
></DT
><DT
->8.5.4. <A
+>8.5.9. <A
+HREF="actions-file.html#CRUNCH-SERVER-HEADER"
+>crunch-server-header</A
+></DT
+><DT
+>8.5.10. <A
HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
>crunch-outgoing-cookies</A
></DT
><DT
HREF="actions-file.html#DEANIMATE-GIFS"
>deanimate-gifs</A
></DT
><DT
HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
>downgrade-http-version</A
></DT
><DT
HREF="actions-file.html#FAST-REDIRECTS"
>fast-redirects</A
></DT
><DT
HREF="actions-file.html#FILTER"
>filter</A
></DT
><DT
->8.5.9. <A
+>8.5.15. <A
+HREF="actions-file.html#FORCE-TEXT-MODE"
+>force-text-mode</A
+></DT
+><DT
+>8.5.16. <A
+HREF="actions-file.html#FORWARD-OVERRIDE"
+>forward-override</A
+></DT
+><DT
+>8.5.17. <A
+HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
+>handle-as-empty-document</A
+></DT
+><DT
+>8.5.18. <A
HREF="actions-file.html#HANDLE-AS-IMAGE"
>handle-as-image</A
></DT
><DT
->8.5.10. <A
+>8.5.19. <A
+HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
+>hide-accept-language</A
+></DT
+><DT
+>8.5.20. <A
+HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
+>hide-content-disposition</A
+></DT
+><DT
+>8.5.21. <A
+HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
+>hide-if-modified-since</A
+></DT
+><DT
+>8.5.22. <A
HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
>hide-forwarded-for-headers</A
></DT
><DT
HREF="actions-file.html#HIDE-FROM-HEADER"
>hide-from-header</A
></DT
><DT
HREF="actions-file.html#HIDE-REFERRER"
>hide-referrer</A
></DT
><DT
HREF="actions-file.html#HIDE-USER-AGENT"
>hide-user-agent</A
></DT
><DT
->8.5.14. <A
-HREF="actions-file.html#KILL-POPUPS"
->kill-popups<A
-NAME="KILL-POPUP"
-></A
-></A
-></DT
-><DT
->8.5.15. <A
+>8.5.26. <A
HREF="actions-file.html#LIMIT-CONNECT"
>limit-connect</A
></DT
><DT
HREF="actions-file.html#PREVENT-COMPRESSION"
>prevent-compression</A
></DT
><DT
-HREF="actions-file.html#SEND-VANILLA-WAFER"
->send-vanilla-wafer</A
+HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
+>overwrite-last-modified</A
></DT
><DT
-HREF="actions-file.html#SEND-WAFER"
->send-wafer</A
+HREF="actions-file.html#REDIRECT"
+>redirect</A
></DT
><DT
->8.5.19. <A
+>8.5.30. <A
+HREF="actions-file.html#SERVER-HEADER-FILTER"
+>server-header-filter</A
+></DT
+><DT
+>8.5.31. <A
+HREF="actions-file.html#SERVER-HEADER-TAGGER"
+>server-header-tagger</A
+></DT
+><DT
+>8.5.32. <A
HREF="actions-file.html#SESSION-COOKIES-ONLY"
>session-cookies-only</A
></DT
><DT
HREF="actions-file.html#SET-IMAGE-BLOCKER"
>set-image-blocker</A
></DT
><DT
-HREF="actions-file.html#AEN2855"
+HREF="actions-file.html#AEN4087"
>Summary</A
></DT
></DL
><DL
><DT
>8.7.1. <A
-HREF="actions-file.html#AEN2920"
+HREF="actions-file.html#AEN4150"
>default.action</A
></DT
><DT
>8.7.2. <A
-HREF="actions-file.html#AEN3086"
+HREF="actions-file.html#AEN4284"
>user.action</A
></DT
></DL
><DT
>9. <A
HREF="filter-file.html"
->The Filter File</A
+>Filter Files</A
></DT
><DD
><DL
><DT
>9.1. <A
-HREF="filter-file.html#AEN3212"
+HREF="filter-file.html#AEN4439"
>Filter File Tutorial</A
></DT
><DT
><DT
>10. <A
HREF="templates.html"
->Templates</A
+>Privoxy's Template Files</A
></DT
><DT
>11. <A
></DT
><DT
>11.2. <A
+HREF="contact.html#REPORTING"
+>Reporting Problems</A
+></DT
+><DD
+><DL
+><DT
+>11.2.1. <A
+HREF="contact.html#CONTACT-ADS"
+>Reporting Ads or Other Configuration Problems</A
+></DT
+><DT
+>11.2.2. <A
HREF="contact.html#CONTACT-BUGS"
->Report Bugs</A
+>Reporting Bugs</A
></DT
+></DL
+></DD
><DT
>11.3. <A
HREF="contact.html#CONTACT-FEATURE"
></DT
><DT
>11.4. <A
-HREF="contact.html#CONTACT-ADS"
->Report Ads or Other Actions-Related Problems</A
-></DT
-><DT
->11.5. <A
HREF="contact.html#CONTACT-OTHER"
>Other</A
></DT
><DT
>12. <A
HREF="copyright.html"
-><SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> Copyright, License and History</A
+>Privoxy Copyright, License and History</A
></DT
><DD
><DL
><DT
>12.1. <A
-HREF="copyright.html#AEN3561"
+HREF="copyright.html#AEN4913"
>License</A
></DT
><DT
></DT
><DT
>14.2. <A
-HREF="appendix.html#AEN3815"
-><SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->'s Internal Pages</A
+HREF="appendix.html#AEN5170"
+>Privoxy's Internal Pages</A
></DT
><DD
><DL
><DT
>14.4. <A
HREF="appendix.html#ACTIONSANAT"
->Anatomy of an Action</A
+>Troubleshooting: Anatomy of an Action</A
></DT
></DL
></DD
projects / privoxy.git / blobdiff