Purpose : Used with other docs and files only.
- $Id: p-config.sgml,v 2.43 2009/03/28 15:33:41 fabiankeil Exp $
+ $Id: p-config.sgml,v 2.48 2009/04/17 11:42:07 fabiankeil Exp $
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/
See LICENSE.
Sample Configuration File for Privoxy v&p-version;
</title>
<para>
- $Id: p-config.sgml,v 2.43 2009/03/28 15:33:41 fabiankeil Exp $
+ $Id: p-config.sgml,v 2.48 2009/04/17 11:42:07 fabiankeil Exp $
</para>
<para>
Copyright (C) 2001-2009 Privoxy Developers http://www.privoxy.org/
will need to override the default.
</para>
<para>
- IPv6 address containing colons has to be quoted by brackets.
+ IPv6 addresses containing colons have to be quoted by brackets.
</para>
<para>
If you leave out the IP address, <application>Privoxy</application> will
- bind to all interfaces (addresses) on your machine and may become reachable
+ bind to all IPv4 interfaces (addresses) on your machine and may become reachable
from the Internet. In that case, consider using <link
linkend="acls">access control lists</link> (ACL's, see below), and/or
- a firewall.
+ a firewall. If the hostname is localhost, <application>Privoxy</application>
+ will explicitly try to bind to an IPv4 address. For other hostnames it depends
+ on the operating system which IP version will be used.
</para>
<para>
If you open <application>Privoxy</application> to untrusted users, you will
</programlisting>
</para>
<para>
- Suppose you are running <application>Privoxy</application> on IPv6 capable
- machine and you want to listen on IPv6 loopback device:
+ Suppose you are running <application>Privoxy</application> on an
+ IPv6-capable machine and you want it to listen on the IPv6 address
+ of the loopback device:
</para>
<para>
<programlisting>
<para>
Where <replaceable class="parameter">src_addr</replaceable> and
<replaceable class="parameter">dst_addr</replaceable> are IPv4 addresses in dotted decimal notation or valid
- DNS names, <replaceable class="parameter">port</replaceable> is port
+ DNS names, <replaceable class="parameter">port</replaceable> is a port
number, and <replaceable class="parameter">src_masklen</replaceable> and
<replaceable class="parameter">dst_masklen</replaceable> are subnet masks in CIDR notation, i.e. integer
values from 2 to 30 representing the length (in bits) of the network address. The masks and the whole
<ulink url="http://tools.ietf.org/html/rfc3493">RFC 3493</ulink>, then
<replaceable class="parameter">src_addr</replaceable> and <replaceable
class="parameter">dst_addr</replaceable> can be IPv6 addresses delimeted by
- brackets, <replaceable class="parameter">port</replaceable> can be number
- or service name, and
+ brackets, <replaceable class="parameter">port</replaceable> can be a number
+ or a service name, and
<replaceable class="parameter">src_masklen</replaceable> and
- <replaceable class="parameter">dst_masklen</replaceable> can be number
+ <replaceable class="parameter">dst_masklen</replaceable> can be a number
from 0 to 128.
</para>
</listitem>
<listitem>
<para><emphasis>Unset</emphasis></para>
<para>
- No <replaceable class="parameter">port</replaceable> means match any port
- and no <replaceable class="parameter">src_masklen</replaceable> or
- no <replaceable class="parameter">src_masklen</replaceable> means exactly
- given IP address (i.e. 32 for IPv4 and 128 for IPv6).
+ If no <replaceable class="parameter">port</replaceable> is specified,
+ any port will match. If no <replaceable class="parameter">src_masklen</replaceable> or
+ <replaceable class="parameter">src_masklen</replaceable> is given, the complete IP
+ address has to match (i.e. 32 bits for IPv4 and 128 bits for IPv6).
</para>
</listitem>
</varlistentry>
<para>
Some systems allows IPv4 client to connect to IPv6 server socket.
Then the client's IPv4 address will be translated by system into
- IPv6 address space with special prefix ::ffff/96 (so called IPv4
+ IPv6 address space with special prefix ::ffff:0:0/96 (so called IPv4
mapped IPv6 address). <application>Privoxy</application> can handle it
and maps such ACL addresses automatically.
</para>
</screen>
</para>
<para>
- Allow access from IPv4 network 192.0.2.0/24 even if listening on
- IPv6 wild card address (where supported by operating system):
+ Allow access from the IPv4 network 192.0.2.0/24 even if listening on
+ an IPv6 wild card address (not supported on all platforms):
</para>
<para>
<programlisting>
</programlisting>
</para>
<para>
- This is equivalent to the following line even if listening on IPv4
- address (where supported by operating system):
+ This is equivalent to the following line even if listening on an
+ IPv4 address (not supported on all platforms):
</para>
<para>
<programlisting>
forwarded to another HTTP proxy but are made directly to the web servers.
</para>
<para>
- <replaceable class="parameter">http_parent</replaceable> can be IPv6
- numerical address (if
+ <replaceable class="parameter">http_parent</replaceable> can be a
+ numerical IPv6 address (if
<ulink url="http://tools.ietf.org/html/rfc3493">RFC 3493</ulink> is
- implemented). However not to clash with port delimiter, quote
- whole IP address with brackets. On the other hand <replaceable
- class="parameter">target_pattern</replaceable> containing IPv6 address
- must be delimited by angle brackets (normal brackets are reserved for
- regular expression already).
+ implemented). To prevent clashes with the port delimiter, the whole IP
+ address has to be put into brackets. On the other hand a <replaceable
+ class="parameter">target_pattern</replaceable> containing an IPv6 address
+ has to be put into angle brackets (normal brackets are reserved for
+ regular expressions already).
</para>
<para>
Multiple lines are OK, they are checked in sequence, and the last match wins.
</screen>
</para>
<para>
- Parent proxy specified by IPv6 address:
+ Parent proxy specified by an IPv6 address:
</para>
<para>
<programlisting>
</para>
<para>
<programlisting>
- forward / parent-proxy.example.org:8000
+ forward / parent-proxy.example.org:8000
forward ipv6-server.example.org .
forward <[2-3][0-9a-f][0-9a-f][0-9a-f]:*> .
</programlisting>
</para>
<para>
<replaceable class="parameter">socks_proxy</replaceable> and
- <replaceable clss="parameter">http_parent</replaceable> can be IPv6
- numerical address (if
+ <replaceable class="parameter">http_parent</replaceable> can be a
+ numerical IPv6 address (if
<ulink url="http://tools.ietf.org/html/rfc3493">RFC 3493</ulink> is
- implemented). However not to clash with port
- delimiter, quote whole IP address with brackets. On the other
- hand <replaceable class="parameter">target_pattern</replaceable> containing
- IPv6 address must be delimited by angle brackets (normal brackets are
- reserved for regular expression already). The only exception is SOCKS 4
- version where only IPv4 is suppored.
+ implemented). To prevent clashes with the port delimiter, the whole IP
+ address has to be put into brackets. On the other hand a <replaceable
+ class="parameter">target_pattern</replaceable> containing an IPv6 address
+ has to be put into angle brackets (normal brackets are reserved for
+ regular expressions already).
</para>
<para>
If <replaceable class="parameter">http_parent</replaceable> is <quote>.</quote>, then requests are not
<![%config-file;[<literallayout>@@forwarded-connect-retries 0</literallayout>]]>
</sect3>
+</sect2>
+
+<sect2 id="misc">
+<title>Miscellaneous</title>
+
<sect3 renderas="sect4" id="accept-intercepted-requests"><title>accept-intercepted-requests</title>
<variablelist>
<varlistentry>