From b5e1f76dcf150f7e4a7b83673c458b8506aef099 Mon Sep 17 00:00:00 2001 From: hal9 Date: Wed, 24 Oct 2001 17:10:55 +0000 Subject: [PATCH] Catching up with Jon's recent work, and a few other things. --- doc/source/user-manual.sgml | 133 +++++++++++++++++++++++++++++++----- 1 file changed, 117 insertions(+), 16 deletions(-) diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 9a82387b..f66421dd 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -7,7 +7,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: user-manual.sgml,v 1.15 2001/10/14 23:46:24 hal9 Exp $ + $Id: user-manual.sgml,v 1.16 2001/10/21 17:19:21 swa Exp $ Written by and Copyright (C) 2001 the SourceForge IJBSWA team. http://ijbswa.sourceforge.net @@ -30,7 +30,7 @@ Hal Burgiss Junkbuster User Manual -$Id: user-manual.sgml,v 1.15 2001/10/14 23:46:24 hal9 Exp $ +$Id: user-manual.sgml,v 1.16 2001/10/21 17:19:21 swa Exp $ @@ -206,6 +206,7 @@ You can find the latest version of the user manual at + autoconf #recommended for CVS source ./configure make redhat-dist @@ -270,6 +272,7 @@ You can find the latest version of the user manual at http://ijbswa.sourceforge.net/config/. + (Still under active development.) @@ -468,7 +474,7 @@ configuration section below. HB.) - The # indicates a comment. Any part of a + A # indicates a comment. Any part of a line following a # is ignored, except if the # is preceded by a \. @@ -492,7 +498,7 @@ configuration section below. HB.) There are various aspects of Junkbuster behavior - that can be adjusted. + that can be tuned. @@ -928,6 +934,84 @@ configuration section below. HB.) + + For content filtering, i.e. the +filter and + +deanimate-gif actions, it is neccessary that + Junkbuster buffers up the entire document body. + This can be potentially dangerous, since a server could just keep sending + data indefinitely and wait for your RAM to exhaust. + + + + The buffer-limit option lets you set the maximum + size in Kbytes that each buffer may use. When the documents buffer exceeds + this size, it is flushed to the client unfiltered and no further attempt to + filter the rest of it is made. Remember that there may multiple threads + running, which might require increasing the buffer-limit + Kbytes each, unless you have enabled + single-threaded above. + + + + + + + buffer-limit 4069 + + + + + + + To enable the web-based actionsfile editor set + enable-edit-actions to 1, or 0 to disable. Note + that you must have compiled JunkBuster with + support for this feature, otherwise this option has no effect. This + internal page can be reached at http://ijbswa.sourceforge.net/config/. + + + + Security note: If this is enabled, anyone who can use the proxy + can edit the actions file, and their changes will affect all users. + For shared proxies, you probably want to disable this. Default: enabled. + + + + + + + enable-edit-actions 1 + + + + + + + Allow JunkBuster to be toggled on and off + remotely, using your web browser. Set enable-remote-toggleto + 1 to enable, and 0 to disable. Note that you must have compiled + JunkBuster with support for this feature, + otherwise this option has no effect. + + + + Security note: If this is enabled, anyone who can use the proxy + can toggle it on or off, and their changes will affect all users. + For shared proxies, you probably want to disable this. Default: + enabled. + + + + + + + enable-remote-toggle 1 + + + + + @@ -1164,7 +1248,8 @@ configuration section below. HB.) This feature allows chaining of HTTP requests via multiple proxies. It can be used to better protect privacy and confidentiality when accessing specific domains by routing requests to those domains - to a special purpose filtering proxy such as lpwa.com. + to a special purpose filtering proxy such as lpwa.com. Or to use + a caching proxy to speed up browsing. @@ -2440,7 +2525,7 @@ Removed references to Win32. HB 09/23/01 -. Alias names are not case sensitive, and must be defined before anything else in actionsfile! And there can only be one set of - aliases of defined. + aliases defined. @@ -2605,15 +2690,14 @@ Removed references to Win32. HB 09/23/01 - Be sure your browser is set to use - the proxy which is by default at localhost, port 8000. With - Netscape (and Mozilla), - this can be set under Edit -> Preferences -> Advanced -> - Proxies -> HTTP Proxy. For Internet - Explorer: Tools > Internet Properties -> - Connections -> LAN Setting. Then, check Use Proxy - and fill in the appropriate info (Address: localhost, Port: 8000). - Include if HTTPS proxy support too. + Be sure your browser is set to use the proxy which is by default at + localhost, port 8000. With Netscape (and + Mozilla), this can be set under Edit + -> Preferences -> Advanced -> Proxies -> HTTP Proxy. + For Internet Explorer: Tools > + Internet Properties -> Connections -> LAN Setting. Then, + check Use Proxy and fill in the appropriate info (Address: + localhost, Port: 8000). Include if HTTPS proxy support too. @@ -2649,7 +2733,21 @@ Removed references to Win32. HB 09/23/01 After running Junkbuster for a while, you can start to fine tune the configuration to suit your personal, or site, preferences and requirements. There are many, many aspects that can - be customized. + be customized. Actions (from actionsfile) + can be adjusted by pointing your browser to + http://ijbswa.sourceforge.net/config/, + and then follow the link to edit the actions list. + (This is an internal page and does not require Internet access.) + + + + In fact, various aspects of Junkbuster + configuration can be viewed from this page, including + current configuration parameters, source code version numbers, + the browser's request headers, and actions that apply + to a given URL. In addition to the actionsfile + editor mentioned above, Junkbuster can also + be turned on and off from this page. @@ -3044,6 +3142,9 @@ communication (bugs, feature requests, etc.) Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: user-manual.sgml,v $ + Revision 1.16 2001/10/21 17:19:21 swa + wrong url in documentation + Revision 1.15 2001/10/14 23:46:24 hal9 Various minor changes. Fleshed out SEE ALSO section. -- 2.49.0