X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;f=doc%2Fsource%2Fuser-manual.sgml;h=6d9c5d6c26ebb2e66447c3c9933b26af94eef35f;hb=2e8c7e4321104708859ad7bf3e5697c0897778c5;hp=2fc2713ebebb94852366df05ee26461041cbb72a;hpb=a976545bde39bbb1cb0a8fe78d175bb8db383d0b;p=privoxy.git diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 2fc2713e..6d9c5d6c 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -13,7 +13,7 @@ - + @@ -36,9 +36,9 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: user-manual.sgml,v 2.209 2016/04/09 10:23:54 fabiankeil Exp $ + $Id: user-manual.sgml,v 2.221 2017/05/20 09:27:54 fabiankeil Exp $ - Copyright (C) 2001-2016 Privoxy Developers https://www.privoxy.org/ + Copyright (C) 2001-2017 Privoxy Developers https://www.privoxy.org/ See LICENSE. ======================================================================== @@ -57,12 +57,12 @@ - Copyright &my-copy; 2001-2016 by + Copyright &my-copy; 2001-2017 by Privoxy Developers -$Id: user-manual.sgml,v 2.209 2016/04/09 10:23:54 fabiankeil Exp $ +$Id: user-manual.sgml,v 2.221 2017/05/20 09:27:54 fabiankeil Exp $ - - @@ -379,8 +376,8 @@ How to install the binary packages depends on your operating system: If you wish to receive an email notification whenever we release updates of Privoxy or the actions file, subscribe - to our announce mailing list, ijbswa-announce@lists.sourceforge.net. + url="https://lists.privoxy.org/mailman/listinfo/privoxy-announce">subscribe + to our announce mailing list, privoxy-announce@lists.privoxy.org. @@ -2281,7 +2278,7 @@ for details. This regular expression is conditional so it will match any page named index.html regardless of path which in this case can have one or more /'s. And this one must contain exactly - .html (but does not have to end with that!). + .html (and end with that!). @@ -2293,6 +2290,7 @@ for details. that contains any of the words ads, banner, banners (because of the ?) or junk. The path does not have to end in these words, just contain them. + The path has to contain at least two slashes (including the one at the beginning). @@ -2393,6 +2391,7 @@ for details. are checked after all server headers are scanned. In both cases all the created tags are considered. + The Client Tag Pattern @@ -2451,6 +2450,8 @@ CLIENT-TAG:^circumvent-blocks$ example.org/blocked-example-page + + @@ -3022,6 +3023,21 @@ TAG:^User-Agent: MPlayer/ TAG:^RANGE-REQUEST$ + + +# Tag all requests with the client IP address +# +# (Technically the client IP address isn't included in the +# client headers but client-header taggers can set it anyway. +# For details see the tagger in default.filter) +{+client-header-tagger{client-ip-address}} +/ + +# Change forwarding settings for requests coming from address 10.0.0.1 +{+forward-override{forward-socks5 127.0.1.2:2222 .}} +TAG:^IP-ADDRESS: 10\.0\.0\.1$ + + @@ -6170,7 +6186,7 @@ for-privoxy-version=3.0.11 The first of our specialized sections is concerned with fragile sites, i.e. sites that require minimum interference, because they are either very complex or very keen on tracking you (and have mechanisms in place that - make them unusable for people who avoid being tracked). We will simply use + make them unusable for people who avoid being tracked). We will use our pre-defined fragile alias instead of stating the list of actions explicitly: @@ -6320,7 +6336,7 @@ count*. It's quite remarkable how many advertisers actually call their banner servers ads.company.com, or call the directory - in which the banners are stored simply banners. So the above + in which the banners are stored literally banners. So the above generic patterns are surprisingly effective. @@ -6776,8 +6792,10 @@ stupid-server.example.com/ The non-standard option letter D (dynamic) allows to use the variables $host, $origin (the IP address the request came from), - $path and $url. They will be replaced with the value they refer to before - the filter is executed. + $path, $url and $listen-address (the address on which Privoxy accepted the + client request. Example: 127.0.0.1:8118). + They will be replaced with the value they refer to before the filter + is executed. @@ -7534,9 +7552,10 @@ pre-defined filters for your convenience: External filters read the content from STDIN and write the rewritten - content to STDOUT. The environment variables PRIVOXY_URL, PRIVOXY_PATH, - PRIVOXY_HOST, PRIVOXY_ORIGIN can be used to get some details about the - client request. + content to STDOUT. + The environment variables PRIVOXY_URL, PRIVOXY_PATH, PRIVOXY_HOST, + PRIVOXY_ORIGIN, PRIVOXY_LISTEN_ADDRESS can be used to get some details + about the client request. &my-app; will temporary store the content to filter in the