From 7e18150b934f4bcb8745637251469e7e34253f24 Mon Sep 17 00:00:00 2001 From: hal9 Date: Sun, 2 Dec 2001 00:20:41 +0000 Subject: [PATCH] Updates for recent changes. --- doc/source/user-manual.sgml | 99 +++++++++++++++++++++++-------------- 1 file changed, 63 insertions(+), 36 deletions(-) diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 42f0b4e5..be25791a 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.21 2001/10/31 21:11:03 hal9 Exp $ + $Id: user-manual.sgml,v 1.22 2001/11/05 23:57:51 hal9 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.21 2001/10/31 21:11:03 hal9 Exp $ +$Id: user-manual.sgml,v 1.22 2001/11/05 23:57:51 hal9 Exp $ @@ -418,7 +418,7 @@ configuration section below. HB.) The main configuration file is named config - on Linux, Unix, BSD, and OS/2, and junkbustr.txt on + on Linux, Unix, BSD, and OS/2, and config.txt on Windows. On Amiga, it is AmiTCP:db/junkbuster/config. @@ -426,7 +426,7 @@ configuration section below. HB.) - The actionsfile file is used to define various + The ijb.action file is used to define various actions relating to images, banners, pop-ups, access restrictions, banners and cookies. There is a CGI based editor for this file that can be accessed via - actionsfile and re_filterfile + ijb.action and re_filterfile can use Perl style regular expressions for maximum flexibility. All files use the # character to denote a comment. Such lines are not processed by Junkbuster. After @@ -467,7 +467,7 @@ configuration section below. HB.) The Main Configuration File Again, the main configuration file is named config on - Linux/Unix/BSD and OS/2, and junkbustr.txt on Windows. + Linux/Unix/BSD and OS/2, and config.txt on Windows. Configuration lines consist of an initial keyword followed by a list of values, all separated by whitespace (any number of spaces or tabs). For example: @@ -579,20 +579,21 @@ configuration section below. HB.) - The actionsfile contains patterns to specify the actions to + The ijb.action file contains patterns to specify the actions to apply to requests for each site. Default: Cookies to and from all - destinations are filtered. Popups are disabled for all sites. All sites are - filtered if re_filterfile specified. No sites are blocked. An empty image is - displayed for filtered ads and other images (formerly - tinygif). The syntax of this file is explained in detail - below. + destinations are kept only during the current browser session (i.e. they + are not saved to disk). Popups are disabled for all sites. All sites are + filtered if re_filterfile specified. No sites are blocked. An + empty image is displayed for filtered ads and other images (formerly + tinygif). The syntax of this file is explained in detail below. - actionsfile actionsfile + actionsfile ijb.action @@ -927,7 +928,7 @@ configuration section below. HB.) choice is Enable. Clicking on enable toggles Junkbuster on and off. This is useful if you want to temporarily disable Junkbuster, e.g., to access - a site that requires cookies which you normally have blocked. This can also + a site that requires cookies which you would otherwise have blocked. This can also be toggled via a web browser at the Junkbuster internal address of http://i.j.b./ on any platform. @@ -979,7 +980,7 @@ configuration section below. HB.) - To enable the web-based actionsfile editor set + To enable the web-based ijb.action file 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 @@ -1392,8 +1393,8 @@ configuration section below. HB.) - Also, we're told they insist on getting cookies and JavaScript, so you need - to add home.com to the cookie file. We consider JavaScript a security risk. + Also, we're told they insist on getting cookies and JavaScript, so you should + add home.com to the cookie file. We consider JavaScript a security risk. Java need not be enabled. @@ -1730,12 +1731,14 @@ Removed references to Win32. HB 09/23/01 The Actions File - The actionsfile is used to define what actions + The ijb.action file (formerly + actionsfile) is used to define what actions Junkbuster takes, and thus determines how images, cookies and various other aspects of HTTP content and transactions are handled. Images can be anything you want, including ads, banners, or just some obnoxious image that you would rather not see. Cookies can be accepted - or rejected. The default file is in fact named actionsfile. + or rejected, or accepted only during the current browser session (i.e. + not written to disk). @@ -1952,7 +1955,7 @@ Removed references to Win32. HB 09/23/01 So in this case JunkBuster would just be a normal, non-blocking, non-anonymizing proxy. You must specifically enable the privacy and blocking features you need (although the - provided default actionsfile file will + provided default ijb.action file will give a good starting point). @@ -2307,6 +2310,24 @@ Removed references to Win32. HB 09/23/01 + + + If the website sets cookies, no-cookies-keep will make sure + they are erased when you exit and restart your web browser. This makes + profiling cookies useless, but won't break sites which require cookies so + that you can log in for transactions. Default: on. + + + + + + +no-cookies-keep + + + + + + Prevent the website from reading cookies: @@ -2410,13 +2431,16 @@ Removed references to Win32. HB 09/23/01 - # Turn off all cookies + # Turn off all persistant cookies { +no-cookies-read } { +no-cookies-set } + # Allow cookies for this browser session ONLY + { +no-cookies-keep } - # Execeptions to the above, sites that need cookies + # Execeptions to the above, sites that benefit from persistant cookies { -no-cookies-read } { -no-cookies-set } + { -no-cookies-keep } .javasoft.com .sun.com .yahoo.com @@ -2424,7 +2448,7 @@ Removed references to Win32. HB 09/23/01 .redhat.com # Alternative way of saying the same thing - {-no-cookies-set -no-cookies-read} + {-no-cookies-set -no-cookies-read -no-cookies-keep} .sourceforge.net .sf.net @@ -2547,8 +2571,8 @@ Removed references to Win32. HB 09/23/01 { or }. But please use only a- z, 0-9, +, and -. Alias names are not case sensitive, and - must be defined before anything else in - actionsfile! And there can only be one set of + must be defined before anything else in the + ijb.actionfile ! And there can only be one set of aliases defined. @@ -2721,7 +2745,7 @@ For RedHat: /etc/rc.d/init.d/junkbuster start Junkbuster will look for a file named config in the current directory. Except on Amiga where it will look for AmiTCP:db/junkbuster/config and Win32 - where it will try junkbstr.txt. If no file is specified + where it will try config.txt. If no file is specified on the command line and no default configuration file can be found, Junkbuster will fail to start. @@ -2740,12 +2764,12 @@ For RedHat: /etc/rc.d/init.d/junkbuster start The included default configuration files should give a reasonable starting point, though may be somewhat aggressive in blocking junk. You will probably - want to keep an eye out for sites that require cookies, and add these to - actionsfile as needed. By default, most of these will - be blocked until you add them to the configuration. If you want the browser - to handle this instead, you will need to edit - actionsfile and disable this feature. If you use more - than one browser, it would make more sense to let + want to keep an eye out for sites that require persistant cookies, and add these to + ijb.action as needed. By default, most of these will + be accepted only during the current browser session, until you add them to + the configuration. If you want the browser to handle this instead, you will + need to edit ijb.action and disable this feature. If you + use more than one browser, it would make more sense to let Junkbuster handle this. In which case, the browser(s) should be set to accept all cookies. @@ -2753,7 +2777,7 @@ For RedHat: /etc/rc.d/init.d/junkbuster start If a particular site shows problems loading properly, try adding it to the {fragile} section of - actionsfile. This will turn off most actions for + ijb.action. This will turn off most actions for this site. @@ -2763,14 +2787,14 @@ For RedHat: /etc/rc.d/init.d/junkbuster start of I.E.) experience problems, you might try to force HTTP/1.0 compatiblity. For Mozilla, look under Edit -> Preferences -> Debug -> Networking. Or set the +downgrade config option in - actionsfile. + ijb.action. 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. Actions (from actionsfile) + be customized. Actions (as specified in ijb.action) can be adjusted by pointing your browser to http://i.j.b./, and then follow the link to edit the actions list. @@ -2782,7 +2806,7 @@ For RedHat: /etc/rc.d/init.d/junkbuster start 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 + to a given URL. In addition to the ijb.action file editor mentioned above, Junkbuster can also be turned on and off from this page. @@ -3179,6 +3203,9 @@ communication (bugs, feature requests, etc.) Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: user-manual.sgml,v $ + Revision 1.22 2001/11/05 23:57:51 hal9 + Minor update for startup now daemon mode. + Revision 1.21 2001/10/31 21:11:03 hal9 Correct 2 minor errors -- 2.39.2