From 156eb857e612b8e125ba5d1448e953c42aa046cd Mon Sep 17 00:00:00 2001 From: Fabian Keil Date: Sat, 2 Jun 2007 14:01:37 +0000 Subject: [PATCH] Start to document forward-override{}. --- doc/source/user-manual.sgml | 123 +++++++++++++++++++++++++++++++++++- 1 file changed, 121 insertions(+), 2 deletions(-) diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 9d738223..28b581fe 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -33,7 +33,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: user-manual.sgml,v 2.29 2007/04/05 11:47:51 fabiankeil Exp $ + $Id: user-manual.sgml,v 2.30 2007/04/25 15:10:36 fabiankeil Exp $ Copyright (C) 2001-2007 Privoxy Developers http://www.privoxy.org/ See LICENSE. @@ -59,7 +59,7 @@ -$Id: user-manual.sgml,v 2.29 2007/04/05 11:47:51 fabiankeil Exp $ +$Id: user-manual.sgml,v 2.30 2007/04/25 15:10:36 fabiankeil Exp $ + +forward-override + + + + Typical use: + + Change the forwarding settings based on User-Agent or request origin + + + + + Effect: + + + Overrules the forward directives in the configuration files. + + + + + + Type: + + + Multi-value. + + + + + Parameter: + + + + forward . to use a direct connection without any additional proxies. + + + + forward 127.0.0.1:8123 to use the HTTP proxy listening at 127.0.0.1 port 8123. + + + + + forward-socks4a 127.0.0.1:9050 . to use the socks4a proxy listening at 127.0.0.1 port 9050. + Replace forward-socks4a with forward-socks4 to use a socks4 connection (with local DNS + resolution) instead. + + + + + forward-socks4a 127.0.0.1:9050 proxy.example.org:8000 to use the socks4a proxy + listening at 127.0.0.1 port 9050 to reach the HTTP proxy listening at proxy.example.org port 8000. + Replace forward-socks4a with forward-socks4 to use a socks4 connection (with local DNS + resolution) instead. + + + + + + + + Notes: + + + This action takes parameters similar to the + forward directives in the configuration + file, but without the URL pattern. It can be used as replacement, but normally it's only + used in cases where matching based on the request URL isn't sufficient. + + + + Please read the description for the forward directives before + using this action. Forwarding to the wrong people will reduce your privacy and increase the + chances of man-in-the-middle attacks. + + + If the ports are missing or invalid, default values will be used. This might change + in the future and you shouldn't rely on it. Otherwise incorrect syntax causes Privoxy + to exit. + + + Use the show-url-info CGI page + to verify that your forward settings do what you thought the do. + + + + + + + Example usage: + + + +# Always use direct connections for requests previously tagged as +# User-Agent: fetch libfetch/2.0 and make sure +# resuming downloads continues to work. +# This way you can continue to use Tor for your normal browsing, +# without overloading the Tor network with your FreeBSD ports updates +# or downloads of bigger files like ISOs. +{+forward-override{forward .} \ + -hide-if-modified-since \ + -overwrite-last-modified \ +} +TAG:^User-Agent: fetch libfetch/2.0$ + + + + + + + + handle-as-empty-document @@ -8816,6 +8930,11 @@ In file: user.action [ View ] [ Edit ]