From 64d6166ea65c879c4b7571f1075ce567bd209ecf Mon Sep 17 00:00:00 2001 From: swa Date: Sat, 23 Mar 2002 15:13:11 +0000 Subject: [PATCH] renamed every reference to the old name with foobar. fixed "application foobar application" tag, fixed "the foobar" with "foobar". left junkbustser in cvs comments and remarks to history untouched. --- doc/source/developer-manual.sgml | 81 +++---- doc/source/faq.sgml | 258 +++++++++++---------- doc/source/user-manual.sgml | 383 ++++++++++++++++--------------- 3 files changed, 367 insertions(+), 355 deletions(-) diff --git a/doc/source/developer-manual.sgml b/doc/source/developer-manual.sgml index 2c3fb12d..5364951b 100644 --- a/doc/source/developer-manual.sgml +++ b/doc/source/developer-manual.sgml @@ -6,10 +6,10 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: developer-manual.sgml,v 1.6 2002/02/24 14:25:06 jongfoster Exp $ + $Id: developer-manual.sgml,v 1.7 2002/03/11 13:13:27 swa Exp $ Written by and Copyright (C) 2001 the SourceForge - IJBSWA team. http://ijbswa.sourceforge.net + FOOBAR team. http://ijbswa.sourceforge.net Based on the Internet Junkbuster originally written by and Copyright (C) 1997 Anonymous Coders and @@ -18,14 +18,14 @@
- Junkbuster Developer Manual + foobar Developer Manual - $Id: developer-manual.sgml,v 1.6 2002/02/24 14:25:06 jongfoster Exp $ + $Id: developer-manual.sgml,v 1.7 2002/03/11 13:13:27 swa Exp $ - By: Junkbuster Developers + By: foobar Developers @@ -34,13 +34,13 @@ The developer manual gives the users information on how to help the developer team. It provides guidance on coding, testing, documentation and other -issues. Internet Junkbuster is a web proxy with -advanced filtering capabilities for protecting privacy, filtering web page -content, managing cookies, controlling access, and removing ads, banners, -pop-ups and other obnoxious Internet Junk. Junkbuster has a very flexible -configuration and can be customized to suit individual needs and -tastes. Internet Junkbuster has application for -both stand-alone systems and multi-user networks. +issues. foobar is a web proxy with advanced +filtering capabilities for protecting privacy, filtering web page content, +managing cookies, controlling access, and removing ads, banners, pop-ups and +other obnoxious Internet Junk. foobar has a very +flexible configuration and can be customized to suit individual needs and +tastes. foobar has application for both stand-alone +systems and multi-user networks. You can find the latest version of the user manual at - Quickstart to Junkbuster Development + Quickstart to Foobar Development To be filled. @@ -89,7 +89,7 @@ via scp. - + @@ -97,16 +97,16 @@ via scp. Introduction - This set of standards is designed to make our lives easier. - It is developed with the simple goal of helping us keep the - "new and improved Junkbusters" consistent and reliable. Thus - making maintenance easier and increasing chances of success of - the project. + This set of standards is designed to make our lives easier. It is + developed with the simple goal of helping us keep the "new and improved + foobar" consistent and reliable. Thus making + maintenance easier and increasing chances of success of the + project. - And that of course comes back to us as individuals. If we - can increase our development and product efficiencies then we - can solve more of the request for changes/improvements and in - general feel good about ourselves. ;-> + And that of course comes back to us as individuals. If we can + increase our development and product efficiencies then we can solve more + of the request for changes/improvements and in general feel good about + ourselves. ;-> @@ -339,7 +339,7 @@ if ( 1 == X ) reserves these for use by the compiler and system headers.) Do not use identifiers which are reserved in ANSI C++. (E.g. template, class, true, false, ...). This is in case we ever - decide to port JunkBuster to C++. + decide to port Foobar to C++. Example: @@ -366,7 +366,7 @@ int msiis5hack = 0; int msIis5Hack = 0; reserves these for use by the compiler and system headers.) Do not use identifiers which are reserved in ANSI C++. (E.g. template, class, true, false, ...). This is in case we ever - decide to port JunkBuster to C++. + decide to port Foobar to C++. Example: @@ -824,7 +824,7 @@ for ( size_t cnt = 0; cnt < len; cnt ++ ) char *s2 ); I could then not use it to compare argv's in main: int main( - int argc, const char *argv[] ) { strcmp( argv[0], "junkbusters" + int argc, const char *argv[] ) { strcmp( argv[0], "foobars" ); } Both these pointers are *const*! If the c runtime library @@ -1219,7 +1219,7 @@ static void unload_re_filterfile( void *f ) { ... } Example for file comments: -const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.6 2002/02/24 14:25:06 jongfoster Exp $"; +const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.7 2002/03/11 13:13:27 swa Exp $"; /********************************************************************* * * File : $Source$ @@ -1227,7 +1227,7 @@ const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.6 2002/02/24 14:25:0 * Purpose : (Fill me in with a good description!) * * Copyright : Written by and Copyright (C) 2001 the SourceForge - * IJBSWA team. http://ijbswa.sourceforge.net + * FOOBAR team. http://ijbswa.sourceforge.net * * Based on the Internet Junkbuster originally written * by and Copyright (C) 1997 Anonymous Coders and @@ -1279,7 +1279,7 @@ const char FILENAME_h_rcs[] = FILENAME_H_VERSION; #ifndef _FILENAME_H #define _FILENAME_H -#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.6 2002/02/24 14:25:06 jongfoster Exp $" +#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.7 2002/03/11 13:13:27 swa Exp $" /********************************************************************* * * File : $Source$ @@ -1287,7 +1287,7 @@ const char FILENAME_h_rcs[] = FILENAME_H_VERSION; * Purpose : (Fill me in with a good description!) * * Copyright : Written by and Copyright (C) 2001 the SourceForge - * IJBSWA team. http://ijbswa.sourceforge.net + * FOOBAR team. http://ijbswa.sourceforge.net * * Based on the Internet Junkbuster originally written * by and Copyright (C) 1997 Anonymous Coders and @@ -1399,20 +1399,20 @@ Remove any existing rpm with rpm -e Remove any file that was left over. This includes (but is not limited to) - /var/log/junkbuster - /etc/junkbuster - /usr/sbin/junkbuster - /etc/init.d/junkbuster - /usr/doc/junkbuster* + /var/log/foobar + /etc/foobar + /usr/sbin/foobar + /etc/init.d/foobar + /usr/doc/foobar* Install the rpm. Any error messages? - start,stop,status junkbuster with the specific script - (e.g. /etc/rc.d/init/junkbuster stop). Reboot your machine. Does + start,stop,status foobar with the specific script + (e.g. /etc/rc.d/init/foobar stop). Reboot your machine. Does autostart work? - Start browsing. Does the junkbuster work? Logfile written? + Start browsing. Does foobar work? Logfile written? Remove the rpm. Any error messages? All files removed? @@ -1426,7 +1426,7 @@ at sourceforge. Three simple steps: Select category: the distribution you test on. - Select group: the version of Junkbuster that we are about to release. + Select group: the version of foobar that we are about to release. Fill the Summary and Detailed Description with something intelligent (keep it short and precise). @@ -1476,6 +1476,9 @@ at sourceforge. Three simple steps: Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: developer-manual.sgml,v $ + Revision 1.7 2002/03/11 13:13:27 swa + correct feedback channels + Revision 1.6 2002/02/24 14:25:06 jongfoster Formatting changes. Now changing the doctype to DocBook XML 4.1 will work - no other changes are needed. diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml index 6351b1a8..cb752398 100644 --- a/doc/source/faq.sgml +++ b/doc/source/faq.sgml @@ -6,10 +6,10 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: faq.sgml,v 1.18 2002/03/18 16:40:31 hal9 Exp $ + $Id: faq.sgml,v 1.19 2002/03/21 17:01:54 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge - IJBSWA team. http://ijbswa.sourceforge.net + FOOBAR team. http://ijbswa.sourceforge.net Based on the Internet Junkbuster originally written by and Copyright (C) 1997 Anonymous Coders and @@ -18,14 +18,14 @@
-Junkbuster Frequently Asked Questions +Foobar Frequently Asked Questions -$Id: faq.sgml,v 1.18 2002/03/18 16:40:31 hal9 Exp $ +$Id: faq.sgml,v 1.19 2002/03/21 17:01:54 hal9 Exp $ - By: Junkbuster Developers + By: Foobar Developers @@ -33,14 +33,15 @@ The FAQ document gives users and developers alike answers to frequently asked -questions about the Internet Junkbuster. Internet -Junkbuster is a web proxy with advanced filtering capabilities -for protecting privacy, filtering web page content, managing cookies, -controlling access, and removing ads, banners, pop-ups and other obnoxious -Internet Junk. Junkbuster has a very flexible configuration and can be -customized to suit individual needs and tastes. Internet -Junkbuster has application for both stand-alone systems and -multi-user networks. +questions about +Foobar. Foobar is a web +proxy with advanced filtering capabilities for protecting privacy, filtering +web page content, managing cookies, controlling access, and removing ads, +banners, pop-ups and other obnoxious Internet +Junk. Foobar has a very flexible configuration and +can be customized to suit individual needs and +tastes. Foobar has application for both stand-alone +systems and multi-user networks. You can find the latest version of the document at http://ijbswa.sourceforge.net/faq/. @@ -72,18 +73,18 @@ Please see the Contact section in the General Information -What is this new version of <application>Junkbuster</application>? +What is this new version of <application>Foobar</application>? The original Internet Junkbuster (tm) is a coyrighted product of Junkbusters Corporation. Development of this effort stopped some time ago as of - version 2.0.2. Stefan Walherr started the ijbswa project on Sourceforge to rekindle development. Other developers subsequently joined with Stefan, and have since added many new features, refinements and enhancements. - The new Junkbuster started with the same + The new Foobar started with the same code base, but has changed significantly at this point. @@ -91,7 +92,7 @@ Please see the Contact section in the How does it differ from the old <application>Junkbuster?</application> - All the old features remain. The new Junkbuster + All the old features remain. The new Foobar still blocks ads and banners, still manages cookies, and still helps protect your privacy. But, these are all enhanced, and many new features have been added, all in the same vein. @@ -213,40 +214,41 @@ Please see the Contact section in the What is a <quote>proxy</quote>? How does -<application>Junkbuster</application> work? +Foobar work? - When you connect to a web site with Junkbuster, + When you connect to a web site with Foobar, you are really connecting to your locally running version of - Junkbuster. Junkbuster + Foobar. Foobar intercepts your requests for the web page, and relays that to the real web site. The web site sends the HTTP data stream - back to Junkbuster, where - Junkbuster can work its magic before it + back to Foobar, where + Foobar can work its magic before it relays this data back to your web browser. - Since Junkbuster sits between you and the + Since Foobar sits between you and the WWW, it is in a position to intercept and completely manage all web traffic and HTTP content before it gets to your browser. - Junkbuster uses various programming methods to do + Foobar uses various programming methods to do this, all of which is under your control via the various configuration files and options. - There are many kinds of proxies. Junkbuster best + There are many kinds of proxies. Foobar best fits the filtering proxy category. -My browser does the same things as -Junkbuster. Why should I use Junkbuster at all? +My browser does the same things as +<application>Foobar</application>. Why should I use +<application>Foobar</application> at all? Modern browsers do indeed have some of the same - functionality as Junkbuster. Maybe this is - adequate for you. But Junkbuster is much more + functionality as Foobar. Maybe this is + adequate for you. But Foobar is much more verstatile and powerful, and can do a number of things that browsers just can't. @@ -263,7 +265,7 @@ Junkbuster. Why should I use Junkbuster at all? Is there is a license or fee? What about a warranty? Registration? - Junkbuster is licensed under the + Foobar is licensed under the GNU General Public License (GPL). It is free to use, copy, modify or distribute as you wish under the terms of this license. See There is no warranty of any kind, expressed, implied or otherwise. That is something that would cost real money ;-) There is no registration either. - Junkbuster really is free + Foobar really is free in every respect! @@ -287,7 +289,7 @@ warranty? Registration? Installation Can I install the new - <application>Junkbuster</application> over the old one? + Foobar over the old one? We recommend you uninstall the old Junkbuster first to minimize conflicts and confusion. You may want to @@ -304,11 +306,11 @@ warranty? Registration? -I just installed Junkbuster. Is there anything +<title id="firststep">I just installed <application>Foobar</application>. Is there anything special I have to do now? - All browsers must be told to use Junkbuster + All browsers must be told to use Foobar as a proxy by specifying the correct proxy address and port number in the appropriate configuration area for the browser. See below. @@ -317,14 +319,13 @@ special I have to do now? -What is the proxy address of Junkbuster? +What is the proxy address of <application>Foobar</application>? - If you set up the Junkbuster to run on + If you set up the Foobar to run on the computer you browse from (rather than your ISP's server or some networked computer on a LAN), the proxy will be on localhost (which is the special name used by every computer on the Internet to refer - to itself) and the port will be 8118 (unless you have told the Internet - Junkbuster to run on a different port with the + to itself) and the port will be 8118 (unless you have Foobar to run on a different port with the listen-address config option). @@ -332,38 +333,38 @@ special I have to do now? the word localhost in the boxes next to HTTP and Secure (HTTPS) and then the number 8118 for port. This tells your browser to send all web - requests to Junkbuster instead of directly to the + requests to Foobar instead of directly to the Interenet. - Junkbuster can also be used to proxy for + Foobar can also be used to proxy for a Local Area Network. In this case, your would enter either the IP - address of the LAN host where Junkbuster + address of the LAN host where Foobar is running, or the equivalent hostname. Port assignment would be same as above. - Junkbuster does not currently handle + Foobar does not currently handle protocols such as FTP, SMTP, IM, IRC, ICQ, or other Internet protocols. -I just installed Junkbuster, and nothing is happening. +<title id="nothing">I just installed <application>Foobar</application>, and nothing is happening. All the ads are there. What's wrong? - Did you configure your browser to use Junkbuster + Did you configure your browser to use Foobar as a proxy? It does not sound like it. See above. You might also try flushing the browser's caches to force a full re-reading of pages. You can verify - that Junkbuster is running, and your browser + that Foobar is running, and your browser is correctly configured by entering the special URL: http://i.j.b/. This should give you - a banner that says This is the Internet JUNKBUSTER and - access to Junkbuster's internal configuration. + a banner that says This is Foobar and + access to Foobar's internal configuration. If you see this, then you are good to go. If not, the browser or - Junkbuster are not set up correctly. + Foobar are not set up correctly. @@ -392,7 +393,7 @@ All the ads are there. What's wrong? actions files are where various actions that - Junkbuster might take, are configured. + Foobar might take, are configured. Typically, you would define a set of default actions that apply to all URLs, then add exceptions to these defaults. @@ -408,7 +409,7 @@ All the ads are there. What's wrong? - Junkbuster comes with several default + Foobar comes with several default actions files, with varying degrees of filtering and blocking, as starting points for your own configuration (see below). @@ -432,7 +433,7 @@ some of these actions. way to do this? - The easiest way to do this, is to access Junkbuster + The easiest way to do this, is to access Foobar with your web browser at http://i.j.b/, and then select "Edit the actions list" @@ -475,9 +476,9 @@ FIXME: Commenting these out until we have some data there. HB 03/17/02. What are the differences between ijb-intermediate.action, ijb-basic.action, etc.? -Configuring the Internet Junkbuster is not easy. To help you get started, we -provide you with three different default configurations. The following table -shows you, which features are enabled in each configuration. +Configuring Foobar is not easy. To help you get +started, we provide you with three different default configurations. The +following table shows you, which features are enabled in each configuration. Default Configurations @@ -623,33 +624,34 @@ shows you, which features are enabled in each configuration. browser? Does that not raise security issues? What I don't understand, is how I can browser edit the config file as a -regular user, while the whole /etc/junkbuster hierarchy belongs to the user -"junkbuster", with only 644 perms. +regular user, while the whole /etc/foobar hierarchy belongs to the user +"foobar", with only 644 perms. -When you use the browser-based editor, JunkBuster itself is writing to the -config files. Because JunkBuster is running as the user "junkbuster", it can +When you use the browser-based editor, Foobar +itself is writing to the config files. Because +Foobar is running as the user "foobar", it can update the config files. If you don't like this, setting "enable-edit-actions 0" in the config file will disable the browser-based editor. If you're that paranoid, you should also consider setting "enable-remote-toggle 0" to prevent browser-based -enabling/disabling of JunkBuster. +enabling/disabling of Foobar. -Note that normally only local users can connect to JunkBuster, so this is not +Note that normally only local users can connect to Foobar, so this is not (normally) a security problem. -How can I set up Junkbuster to act as a proxy for my +<title id="lanconfig">How can I set up <application>Foobar</application> to act as a proxy for my LAN? - By default, Junkbuster only responds to requests + By default, Foobar only responds to requests from localhost. To have it act as a server for a network, this needs to be - changed in the main config file where the Junkbuster + changed in the main config file where the Foobar configuration is located. In that file is a listen-address option. It may be commented out with a # symbol. Make sure it is uncommented, and assign it the address of the LAN gateway interface, @@ -663,7 +665,7 @@ Note that normally only local users can connect to JunkBuster, so this is not - Save the file, and restart Junkbuster. Configure + Save the file, and restart Foobar. Configure all browsers on the network then to use this address and port number. @@ -671,12 +673,12 @@ Note that normally only local users can connect to JunkBuster, so this is not -Instead of ads, now I get a Junkbuster logo [or +<title id="noseeum">Instead of ads, now I get a Foobar logo [or checkerboard]. I don't want to see anything. This is a configuration option for images that - Junkbuster is stopping. You have the choice of the - Junkbuster logo, a checkerboard pattern (this + Foobar is stopping. You have the choice of the + Foobar logo, a checkerboard pattern (this scales better), a transparent 1x1 GIF image, or a custom URL or your choice. @@ -697,9 +699,9 @@ checkerboard]. I don't want to see anything. Why would anybody want to see the logo or checkerboard? This can be helpful for troubleshooting problems. It might also be good - for anyone new to Junkbuster so that they can + for anyone new to Foobar so that they can see if their favorite pages are displaying correctly, and - Junkbuster is not inadvertantly removing something + Foobar is not inadvertantly removing something important. @@ -710,7 +712,7 @@ checkerboard]. I don't want to see anything. Blocked. How do I get rid of this? These are URLs that match something in one of - Junkbuster's block actions (+block). It is meant + Foobar's block actions (+block). It is meant to be a warning so that you know something has been blocked and an easy way for you to see why. These are handled differently than what has been defined as images (e.g. ad banners). If you want them to be treated @@ -718,7 +720,7 @@ checkerboard]. I don't want to see anything. offending URL from the +block section to the +imageblock section of your actions file. Alternately, you could modify the block HTML template that - is used by Junkbuster to display this, and make it + is used by Foobar to display this, and make it something more to your liking. @@ -731,12 +733,12 @@ checkerboard]. I don't want to see anything. Misc -How much does Junkbuster slow my browsing down? This +<title id="slowsme">How much does <application>Foobar</application> slow my browsing down? This has to add extra time to browsing. It should not slow you down any in real terms, and may actually help speed things up since ads, banners and other junk are not being displayed. - The actual processing time required by Junkbuster + The actual processing time required by Foobar itself for each page, is relatively small in the overall scheme of things, and happens very quickly. This is typically more than offset by time saved not downloading and rendering ad images. @@ -768,21 +770,21 @@ user a feeling of "it works". To modify the content of a page (i.e. make frames resizeable again, etc.) and -not just replace ads, the Internet Junkbuster needs to download the entire -page first, do its content magic and then send the page to the browser. +not just replace ads, Foobar needs to download the +entire page first, do its content magic and then send the page to the browser. What is the "http://i.j.b/"? -Since JunkBuster sits between your web browser and the Internet, it can be +Since Foobar sits between your web browser and the Internet, it can be programmed to handle certain pages specially. -With recent versions of JunkBuster (version 2.9.x), you can get some -information about JunkBuster and change some settings by going to +With recent versions of Foobar (version 2.9.x), you can get some +information about Foobar and change some settings by going to http://i.j.b/ or, equivalently, http://ijbswa.sourceforge.net/config/ (Note that i.j.b is far easier to type but may not work in some configurations). @@ -790,13 +792,13 @@ configurations). These pages are *not* forwarded to a server on the internet - instead they are -handled by a special web server which is built in to JunkBuster. +handled by a special web server which is built in to Foobar. -If you are not running JunkBuster, then http://i.j.b/ will fail, and +If you are not running Foobar, then http://i.j.b/ will fail, and http://ijbswa.sourceforge.net/config/ will return a web page telling you -you're not running JunkBuster. +you're not running Foobar. @@ -815,7 +817,7 @@ FIXME: commented out until we have data. HB 03/18/02. -How do I chain Junkbuster with other proxies +<sect3 id="proxy-chaining"><title>How do I chain <application>Foobar</application> with other proxies (e.g. squid)? Fillme. @@ -851,7 +853,7 @@ FIXME: commented out until we have data. HB 03/18/02. How can I hide my IP address? - You cannot hide your IP address with Junkbuster or any other software, since + You cannot hide your IP address with Foobar or any other software, since the server needs to know your IP address to send the answer to you. @@ -875,28 +877,28 @@ more through Google. - + - + -Can Junkbuster guarantee I am anonymous? +Can <application>Foobar</application> guarantee I am anonymous? No. Your chances of remaining anonymous are greatly improved, but unless you are an expert on Internet security it would be safest to assume that everything you do on the Web can be traced back to you. - Junkbuster can remove various information about you, + Foobar can remove various information about you, and allows you more freedom to decide which sites you can trust. But it's still possible that web sites can find out who you are. Here's one way this can happen. A few browsers disclose the user's email address in certain situations, such - as when transferring a file by FTP. Junkbuster + as when transferring a file by FTP. Foobar does not filter FTP. If you need this feature, or are concerned about the mail handler of your browser disclosing your email address, you might consider products such as NSClean. @@ -953,33 +955,33 @@ being altered? -Can Junkbuster act as a <quote>caching</quote> proxy to +<title id="caching">Can <application>Foobar</application> act as a <quote>caching</quote> proxy to speed up web browsing? No, it does not have this ability at all. You want something like Squid for this. And, yes, - before you ask, Junkbuster can co-exist + before you ask, Foobar can co-exist with other kinds of proxies like Squid. -What about as a firewall? Can Junkbuster protect me? +What about as a firewall? Can <application>Foobar</application> protect me? Not in the way you mean, or in the way a true firewall can, or a proxy that - has this specific capability. Junkbuster can help + has this specific capability. Foobar can help protect your privacy, but not really protect you from intrusion attempts. - This is not a font problem. The logo is an image that is created by - Junkbuster on the fly. So as to not waste + Foobar on the fly. So as to not waste memory, the image is rather small. The blockiness comes when the image is scaled to fill a largish area. There is not much to be done about this, other than to use one of the other @@ -991,7 +993,7 @@ and ugly looking. Can't a better font be used? I have large empty spaces now where ads used to be. -Why does Junkbuster leave these large gaps? +Why does Foobar leave these large gaps? It would be easy enough to just eliminate this space altogether, rather than fill it with blank space. But, this would create problems with many pages @@ -1003,15 +1005,15 @@ Why does Junkbuster leave these large gaps? -How can Junkbuster filter Secure (HTTPS) URLs? +How can <application>Foobar</application> filter Secure (HTTPS) URLs? This is a limitation since HTTPS transactions are encrypted SSL sessions between your browser and the secure site, and are meant to be reliably secure and private. This means that all cookies and HTTP header information are also encrypted from the time they leave your browser, - to the site, and vice versa. Junkbuster does not + to the site, and vice versa. Foobar does not try to unencrypt this information, so it just passes through as is. - Junkbuster can still catch images and ads that + Foobar can still catch images and ads that are embedded in the SSL stream though. @@ -1019,22 +1021,22 @@ Why does Junkbuster leave these large gaps? -Junkbuster runs as a <quote>server</quote>. How +<title id="secure"><application>Foobar</application> runs as a <quote>server</quote>. How secure is it? Do I need to take any special precautions? There are no known exploits that might effect - Junkbuster. On Unix-like systems, - Junkbuster can run as a non-privileged + Foobar. On Unix-like systems, + Foobar can run as a non-privileged user, which is how we recommend it be run. Also, by default - Junkbuster only listens to requests + Foobar only listens to requests from localhost. It is not itself directly exposed to the Internet in this configuration. If you want to have - Junkbuster serve as a LAN proxy, this will have to + Foobar serve as a LAN proxy, this will have to be opened up to allow for LAN requests. In this case, we'd recommend you specify only the LAN gateway address, e.g. 192.168.1.1 in the main - Junkbuster config file. All LAN hosts can then use + Foobar config file. All LAN hosts can then use this as their proxy address in the browser proxy configuration. In this way, - Junkbuster will not listen on any external ports. + Foobar will not listen on any external ports. Of course, a firewall is always good too. Better safe than sorry. @@ -1073,19 +1075,19 @@ secure is it? Do I need to take any special precautions? I just upgraded and am getting <quote>connection refused</quote> with every web page? - Either Junkbuster is not running, or your + Either Foobar is not running, or your browser is configured for a different port than what - Junkbuster is using. + Foobar is using. - The old Junkbuster used port 8000 by + The old Foobar used port 8000 by default. This has been changed to port 8118 now, due to a conflict with NAS (Network Audio Service), which uses port 8000. If you haven't, you need to change your browser to the new port number, or alternately - change Junkbuster's listen-address + change Foobar's listen-address setting in the config file used to start - Junkbuster. + Foobar. @@ -1096,7 +1098,7 @@ still getting through. How? If the ad had been displayed before you added its URL, it will probably be held in the browser's cache for some time, so it will be displayed without - the need for any request to the server, and Junkbuster + the need for any request to the server, and Foobar will not be in the picture. The best thing to do is try flusing the browser's caches. And then try again. @@ -1111,30 +1113,31 @@ still getting through. How? -One of my favorite sites does not work with Junkbuster. +<title id="badsite">One of my favorite sites does not work with <application>Foobar</application>. What can I do? - First verify that it is indeed a Junkbuster problem, - by disabling Junkbuster filtering and blocking. + First verify that it is indeed a Foobar problem, + by disabling Foobar filtering and blocking. Go to http://i.j.b/ and click on - Toggle Junkbuster On or Off, then disable it. Now try that + Toggle Foobar On or Off, then disable it. Now try that page again. If still a problem, go to Show which actions apply to a URL and - why from http://i.j.b/ and - paste the full URL of the page in question into the prompt. See which - actions are being applied to the URL. Now, armed with this information, - go to Edit the actions list. Here you should see various - sections that have various Junkbuster features disabled - for specific sites. Disabled actions will have a - - (minus sign) in front of them. Add your problem page - URL to one of these sections that looks like it is disabling the feature that - is causing the problem. Re-try the page. There might be some trial and error - involved. This is discussed in a little more detail in - the user-manual appendix. + why from http://i.j.b/ and paste + the full URL of the page in question into the prompt. See which actions are + being applied to the URL. Now, armed with this information, go to Edit + the actions list. Here you should see various sections that have + various Foobar features disabled for specific + sites. Disabled actions will have a - (minus + sign) in front of them. Add your problem page URL to one of these sections + that looks like it is disabling the feature that is causing the + problem. Re-try the page. There might be some trial and error involved. This + is discussed in a little more detail in the user-manual + appendix. @@ -1209,6 +1212,9 @@ FIXME: Commented out until we have something to put here. HB 03/18/02. Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: faq.sgml,v $ +Revision 1.19 2002/03/21 17:01:54 hal9 +Some touch ups. + Revision 1.18 2002/03/18 16:40:31 hal9 More additions. diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 1c7ad0be..16e2b4d0 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -6,10 +6,10 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: user-manual.sgml,v 1.49 2002/03/21 17:01:05 hal9 Exp $ + $Id: user-manual.sgml,v 1.50 2002/03/23 05:06:21 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge - IJBSWA team. http://ijbswa.sourceforge.net + Foobar team. http://ijbswa.sourceforge.net Based on the Internet Junkbuster originally written by and Copyright (C) 1997 Anonymous Coders and @@ -26,14 +26,14 @@ Hal Burgiss
-Junkbuster User Manual +Foobar User Manual -$Id: user-manual.sgml,v 1.49 2002/03/21 17:01:05 hal9 Exp $ +$Id: user-manual.sgml,v 1.50 2002/03/23 05:06:21 hal9 Exp $ - By: Junkbuster Developers + By: Foobar Developers @@ -41,14 +41,14 @@ Hal Burgiss The user manual gives users information on how to install, configure and use - Internet Junkbuster. Internet - Junkbuster is a web proxy with advanced filtering capabilities - for protecting privacy, filtering web page content, managing cookies, - controlling access, and removing ads, banners, pop-ups and other obnoxious - Internet Junk. Junkbuster has a very flexible configuration and can be - customized to suit individual needs and tastes. Internet - Junkbuster has application for both stand-alone systems and - multi-user networks. + Foobar. Foobar is a + web proxy with advanced filtering capabilities for protecting privacy, + filtering web page content, managing cookies, controlling access, and + removing ads, banners, pop-ups and other obnoxious Internet + Junk. Foobar has a very flexible configuration + and can be customized to suit individual needs and + tastes. Foobar has application for both + stand-alone systems and multi-user networks. You can find the latest version of the user manual at http://ijbswa.sourceforge.net/user-manual/. @@ -66,19 +66,18 @@ You can find the latest version of the user manual at Introduction - Internet Junkbuster is a web proxy with advanced + Foobar is a web proxy with advanced filtering capabilities for protecting privacy, filtering and modifying web page content, managing cookies, controlling access, and removing ads, banners, pop-ups and other obnoxious Internet Junk. - Junkbuster has a very flexible configuration and - can be customized to suit individual needs and tastes. Internet - Junkbuster has application for both stand-alone systems and + Foobar has a very flexible configuration and + can be customized to suit individual needs and tastes. Foobar has application for both stand-alone systems and multi-user networks. This documentation is included with the current BETA version of - Internet Junkbuster and is mostly complete at this + Foobar and is mostly complete at this point. The most up to date reference for the time being is still the comments in the source files and in the individual configuration files. Development of version 3.0 is currently nearing completion, and includes many significant @@ -98,9 +97,10 @@ You can find the latest version of the user manual at Installation - Junkbuster is available as raw source code, or + Foobar is available as raw source code, or pre-compiled binaries. See the Junkbuster Home Page - for binaries and current release info. Junkbuster + url="http://sourceforge.net/projects/ijbswa/">Foobar Home Page + for binaries and current release info. Foobar is also available via CVS. This is the recommended approach at this time. But please be aware that CVS @@ -298,10 +298,10 @@ You can find the latest version of the user manual at - rpm -Uvv /usr/src/redhat/RPMS/i686/junkbuster-2.9.11-1.i686.rpm + rpm -Uvv /usr/src/redhat/RPMS/i686/foobar-2.9.11-1.i686.rpm - This will place the Junkbuster configuration - files in /etc/junkbuster/, and log files in - /var/log/junkbuster/. + This will place the Foobar configuration + files in /etc/foobar/, and log files in + /var/log/foobar/. @@ -342,10 +342,10 @@ You can find the latest version of the user manual at - rpm -Uvv /usr/src/packages/RPMS/i686/junkbuster-2.9.11-1.i686.rpm + rpm -Uvv /usr/src/packages/RPMS/i686/foobar-2.9.11-1.i686.rpm - This will place the Junkbuster configuration - files in /etc/junkbuster/, and log files in - /var/log/junkbuster/. + This will place the Foobar configuration + files in /etc/foobar/, and log files in + /var/log/foobar/. @@ -375,18 +375,18 @@ Thanx David Schmidt! --> - Junkbuster is packaged in a WarpIN self- + Foobar is packaged in a WarpIN self- installing archive. The self-installing program will be named depending on the release version, something like: ijbos2_setup_1.2.3.exe. In order to install it, simply run this executable or double-click on its icon and follow the WarpIN - installation panels. A shadow of the Junkbuster + installation panels. A shadow of the Foobar executable will be placed in your startup folder so it will start automatically whenever OS/2 starts. - The directory you choose to install Junkbuster + The directory you choose to install Foobar into will contain all of the configuration files. @@ -455,11 +455,11 @@ configuration section below. HB.) -JunkBuster Configuration +<application>Foobar</application> Configuration - All JunkBuster configuration is kept + All Foobar configuration is kept in text files. These files can be edited with a text editor. - Many important aspects of JunkBuster can + Many important aspects of Foobar can also be controlled easily with a web browser. @@ -468,9 +468,9 @@ configuration section below. HB.) -Controlling Junkbuster with Your Web Browser +Controlling <application>Foobar</application> with Your Web Browser - JunkBuster can be reached by the special + Foobar can be reached by the special URL http://i.j.b/ (or alternately http://ijbswa.sourceforge.net/config/), which is an internal page. You will see the following section: @@ -486,7 +486,7 @@ Please choose from the following options: * Show the source code version numbers * Show the client's request headers. * Show which actions apply to a URL and why - * Toggle JunkBuster on or off + * Toggle Foobar on or off * Edit the actions list @@ -496,18 +496,18 @@ Please choose from the following options: This should be self-explanatory. Note the last item is an editor for the actions list, which is where much of the ad, banner, cookie, and URL blocking magic is configured as well as other advanced features of - Junkbuster. This is an easy way to adjust various - aspects of Junkbuster configuration. The actions + Foobar. This is an easy way to adjust various + aspects of Foobar configuration. The actions file, and other configuration files, are explained in detail below. - Junkbuster will automatically detect any changes + Foobar will automatically detect any changes to these files. - Toggle JunkBuster On or Off is handy for sites that might + Toggle Foobar On or Off is handy for sites that might have problems with your current actions and filters, or just to test if - a site misbehaves, whether it is JunkBuster - causing the problem or not. Junkbuster continues + a site misbehaves, whether it is Foobar + causing the problem or not. Foobar continues to run as a proxy in this case, but all filtering is disabled. @@ -525,9 +525,9 @@ Please choose from the following options: Configuration Files Overview For Unix, *BSD and Linux, all configuration files are located in - /etc/junkbuster/ by default. For MS Windows, OS/2, and + /etc/foobar/ by default. For MS Windows, OS/2, and AmigaOS these are all in the same directory as the - Junkbuster executable. The name and number of + Foobar executable. The name and number of configuration files has changed from previous versions, and is subject to change as development progresses. @@ -576,10 +576,10 @@ Please choose from the following options: 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 + lines are not processed by Foobar. After making any changes, there is no need to restart - Junkbuster in order for the changes to take - effect. Junkbuster should detect such changes + Foobar in order for the changes to take + effect. Foobar should detect such changes automatically. @@ -631,7 +631,7 @@ Please choose from the following options: existing configuration line, you can make it a comment and it will be treated as if it weren't there. This is called commenting out an option and can be useful to turn off features: If you comment out the - logfile line, junkbuster will not + logfile line, Foobar will not log to a file at all. Watch for the default: section in each explanation to see what happens if the option is left unset (or commented out). @@ -643,7 +643,7 @@ Please choose from the following options: - There are various aspects of Junkbuster behavior + There are various aspects of Foobar behavior that can be tuned. @@ -654,17 +654,17 @@ Please choose from the following options: Defining Other Configuration Files - Junkbuster can use a number of other files to tell it + Foobar can use a number of other files to tell it what ads to block, what cookies to accept, etc. This section of the - configuration file tells Junkbuster where to find + configuration file tells Foobar where to find all those other files. On Windows and AmigaOS, - Junkbuster looks for these files in the same + Foobar looks for these files in the same directory as the executable. On Unix and OS/2, - Junkbuster looks for these files in the current + Foobar looks for these files in the current working directory. In either case, an absolute path name can be used to avoid problems. @@ -684,7 +684,7 @@ Please choose from the following options: - confdir /etc/junkbuster # No trailing /, please. + confdir /etc/foobar # No trailing /, please. @@ -700,7 +700,7 @@ Please choose from the following options: - logdir /var/log/junkbuster + logdir /var/log/foobar @@ -712,16 +712,16 @@ Please choose from the following options: - 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 kept only during the current browser session (i.e. they - are not saved to disk). Pop-ups are disabled for all sites. All sites are + 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 kept only during the current browser session (i.e. they are + not saved to disk). Pop-ups are disabled for all sites. All sites are filtered through selected sections of re_filterfile. No sites - are blocked. The JunkBuster logo is displayed for filtered ads and other - images. The syntax of this file is explained in detail below. Other actions files - are included, and you are free to use any of them. They have varying - degrees of aggressiveness. + are blocked. The Foobar logo is displayed for + filtered ads and other images. The syntax of this file is explained in detail + below. Other actions files + are included, and you are free to use any of them. They have varying degrees + of aggressiveness. @@ -766,7 +766,7 @@ Please choose from the following options: The logfile is where all logging and error messages are written. The logfile can be useful for tracking down a problem with - Junkbuster (e.g., it's not blocking an ad you + Foobar (e.g., it's not blocking an ad you think it should block) but in most cases you probably will never look at it. @@ -778,7 +778,7 @@ Please choose from the following options: - On SuSE Linux systems, you can place a line like /var/log/junkbuster.* + On SuSE Linux systems, you can place a line like /var/log/foobar.* +1024k 644 nobody.nogroup in /etc/logfiles, with the effect that cron.daily will automatically archive, gzip, and empty the log, when it exceeds 1M size. @@ -801,7 +801,7 @@ Please choose from the following options: The jarfile defines where - Junkbuster stores the cookies it intercepts. Note + Foobar stores the cookies it intercepts. Note that if you use a jarfile, it may grow quite large. Default: Don't store intercepted cookies. @@ -818,7 +818,7 @@ Please choose from the following options: If you specify a trustfile, - Junkbuster will only allow access to sites that + Foobar will only allow access to sites that are named in the trustfile. You can also mark sites as trusted referrers, with the effect that access to untrusted sites will be granted, if a link from a trusted referrer was used. The link target will then be added to the @@ -869,7 +869,7 @@ Please choose from the following options: This part of the configuration file contains options that control how - Junkbuster operates. + Foobar operates. @@ -890,7 +890,7 @@ Please choose from the following options: Proxy-info-url can be set to a URL that contains more info - about this Junkbuster installation, it's + about this Foobar installation, it's configuration and policies. It is used in many of the proxy-generated pages and its use is highly recommended in multi-user installations, since your users will want to know why certain content is blocked or modified. Default: @@ -909,7 +909,7 @@ Please choose from the following options: Listen-address specifies the address and port where - Junkbuster will listen for connections from your + Foobar will listen for connections from your Web browser. The default is to listen on the localhost port 8118, and this is suitable for most users. (In your web browser, under proxy configuration, list the proxy server as localhost and the @@ -921,14 +921,14 @@ Please choose from the following options: serve requests from other machines (e.g. on your local network) as well, you will need to override the default. The syntax is listen-address [<ip-address>]:<port>. If you leave - out the IP address, junkbuster will bind to all + out the IP address, foobar will bind to all interfaces (addresses) on your machine and may become reachable from the Internet. In that case, consider using access control lists (acl's) (see aclfile above), or a firewall. - For example, suppose you are running Junkbuster on + For example, suppose you are running Foobar on a machine which has the address 192.168.0.1 on your local private network (192.168.0.0) and has another outside connection with a different address. You want it to serve requests from inside only: @@ -1001,7 +1001,7 @@ Please choose from the following options: The reporting of FATAL errors (i.e. ones which crash - JunkBuster) is always on and cannot be disabled. + Foobar) is always on and cannot be disabled. @@ -1041,12 +1041,12 @@ Please choose from the following options: - Junkbuster normally uses + Foobar normally uses multi-threading, a software technique that permits it to handle many different requests simultaneously. In some cases you may wish to disable this -- particularly if you're trying to debug a problem. The single-threaded option forces - Junkbuster to handle requests sequentially. + Foobar to handle requests sequentially. Default: Multi-threaded mode. @@ -1062,27 +1062,27 @@ Please choose from the following options: toggle allows you to temporarily disable all - Junkbuster's filtering. Just set toggle + Foobar's filtering. Just set toggle 0. - The Windows version of Junkbuster puts an icon in + The Windows version of Foobar puts an icon in the system tray, which also allows you to change this option. If you right-click on that icon (or select the Options menu), one 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 + Foobar on and off. This is useful if you want + to temporarily disable Foobar, e.g., to access a site that requires cookies which you would otherwise have blocked. This can also - be toggled via a web browser at the Junkbuster + be toggled via a web browser at the Foobar internal address of http://i.j.b on any platform. - toggle 1 means Junkbuster runs + toggle 1 means Foobar runs normally, toggle 0 means that - Junkbuster becomes a non-anonymizing non-blocking + Foobar becomes a non-anonymizing non-blocking proxy. Default: 1 (on). @@ -1099,7 +1099,7 @@ Please choose from the following options: For content filtering, i.e. the +filter and +deanimate-gif actions, it is necessary that - Junkbuster buffers the entire document body. + Foobar buffers 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. With nasty consequences. @@ -1127,7 +1127,7 @@ Please choose from the following options: 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 + that you must have compiled Foobar with support for this feature, otherwise this option has no effect. This internal page can be reached at http://i.j.b. @@ -1150,10 +1150,10 @@ Please choose from the following options: - Allow JunkBuster to be toggled on and off + Allow Foobar 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, + Foobar with support for this feature, otherwise this option has no effect. @@ -1258,12 +1258,12 @@ Please choose from the following options: - IMPORTANT NOTE: If the junkbuster is using a + IMPORTANT NOTE: If Foobar is using a forwarder (see below) or a gateway for a particular destination URL, the DST_ADDR that is examined is the address of the forwarder or the gateway and NOT the address of the ultimate target. This is necessary because it may be impossible for the local - Junkbuster to determine the address of the + Foobar to determine the address of the ultimate target (that's often what gateways are used for). @@ -1288,14 +1288,14 @@ Please choose from the following options: A silly example to illustrate permitting any host on the class-C subnet with - Junkbuster to go anywhere: + Foobar to go anywhere: - permit-access www.junkbusters.com/24 + permit-access www.foobar.com/24 @@ -1309,7 +1309,7 @@ Please choose from the following options: - deny-access ident.junkbusters.com + deny-access ident.foobar.com @@ -1363,7 +1363,7 @@ Please choose from the following options: - An ISP may want to provide a Junkbuster that is + An ISP may want to provide a Foobar that is accessible by the world and yet restrict use of some of their private content to hosts on its internal network (i.e. its own subscribers). Say, for instance the ISP owns the Class-B IP address block 123.124.0.0 (a 16 @@ -1421,7 +1421,7 @@ Please choose from the following options: - Also specified here are SOCKS proxies. Junkbuster + Also specified here are SOCKS proxies. Foobar SOCKS 4 and SOCKS 4A. The difference is that SOCKS 4A will resolve the target hostname using DNS on the SOCKS server, not our local DNS client. @@ -1594,7 +1594,7 @@ Please choose from the following options: host-a has a PPP connection to isp-a.com. And host-b has a PPP connection to - isp-b.com. host-a can run a Junkbuster proxy with + isp-b.com. host-a can run a Foobar proxy with forwarding like this: @@ -1610,7 +1610,7 @@ Please choose from the following options: - host-b can run a Junkbuster proxy with forwarding + host-b can run a Foobar proxy with forwarding like this: @@ -1654,9 +1654,9 @@ Please choose from the following options: - If you intend to chain Junkbuster and + If you intend to chain Foobar and squid locally, then chain as - browser -> squid -> junkbuster is the recommended way. + browser -> squid -> foobar is the recommended way. @@ -1667,7 +1667,7 @@ Please choose from the following options: - # Define junkbuster as parent cache + # Define Foobar as parent cache @@ -1676,13 +1676,13 @@ Please choose from the following options: # Define ACL for protocol FTP acl FTP proto FTP - # Do not forward ACL FTP to junkbuster + # Do not forward ACL FTP to foobar always_direct allow FTP - # Do not forward ACL CONNECT (https) to junkbuster + # Do not forward ACL CONNECT (https) to foobar always_direct allow CONNECT - # Forward the rest to junkbuster + # Forward the rest to foobar never_direct allow all @@ -1702,14 +1702,14 @@ Please choose from the following options: Removed references to Win32. HB 09/23/01 --> - Junkbuster has a number of options specific to the + Foobar has a number of options specific to the Windows GUI interface: If activity-animation is set to 1, the - Junkbuster icon will animate when - Junkbuster is active. To turn off, set to 0. + Foobar icon will animate when + Foobar is active. To turn off, set to 0. @@ -1724,7 +1724,7 @@ Removed references to Win32. HB 09/23/01 If log-messages is set to 1, - Junkbuster will log messages to the console + Foobar will log messages to the console window: @@ -1776,7 +1776,7 @@ Removed references to Win32. HB 09/23/01 If log-highlight-messages is set to 1, - Junkbuster will highlight portions of the log + Foobar will highlight portions of the log messages with a bold-faced font: @@ -1820,7 +1820,7 @@ Removed references to Win32. HB 09/23/01 show-on-task-bar controls whether or not - Junkbuster will appear as a button on the Task bar + Foobar will appear as a button on the Task bar when minimized: @@ -1836,7 +1836,7 @@ Removed references to Win32. HB 09/23/01 If close-button-minimizes is set to 1, the Windows close - button will minimize Junkbuster instead of closing + button will minimize Foobar instead of closing the program (close with the exit option on the File menu). @@ -1852,8 +1852,8 @@ Removed references to Win32. HB 09/23/01 The hide-console option is specific to the MS-Win console - version of JunkBuster. If this option is used, - Junkbuster will disconnect from and hide the + version of Foobar. If this option is used, + Foobar will disconnect from and hide the command console. @@ -1880,13 +1880,13 @@ Removed references to Win32. HB 09/23/01 The ijb.action file (formerly actionsfile) is used to define what actions - Junkbuster takes, and thus determines how images, + Foobar 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 URL that you would rather not see. Cookies can be accepted or rejected, or accepted only during the current browser session (i.e. not written to disk). Changes to ijb.action should - be immediately visible to Junkbuster without + be immediately visible to Foobar without the need to restart. @@ -1909,7 +1909,7 @@ Removed references to Win32. HB 09/23/01 There are four types of lines in this file: comments (begin with a # character), actions, aliases and patterns, all of which are explained below, as well as the configuration file syntax that - Junkbuster understands. + Foobar understands. @@ -1994,7 +1994,7 @@ Removed references to Win32. HB 09/23/01 - If Junkbuster was compiled with + If Foobar was compiled with pcre support (default), Perl compatible regular expressions can be used. See the pcre/docs/ directory or man perlre (also available on If nothing is specified in this file, no actions are taken. - So in this case JunkBuster would just be a + So in this case Foobar 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 ijb.action file will @@ -2115,7 +2115,7 @@ Removed references to Win32. HB 09/23/01 - The list of valid Junkbuster actions are: + The list of valid Foobar actions are: @@ -2183,7 +2183,7 @@ Removed references to Win32. HB 09/23/01 +downgrade will downgrade HTTP/1.1 client requests to HTTP/1.0 and downgrade the responses as well. Use this action for servers that use HTTP/1.1 protocol features that - Junkbuster doesn't handle well yet. HTTP/1.1 + Foobar doesn't handle well yet. HTTP/1.1 is only partially implemented. Default is not to downgrade requests. @@ -2215,7 +2215,7 @@ Removed references to Win32. HB 09/23/01 The +fast-redirects option enables interception of these - requests by Junkbuster, who will cut off all but + requests by Foobar, who will cut off all but the last valid URL in the request and send a local redirect back to your browser without contacting the remote site. @@ -2397,13 +2397,13 @@ Removed references to Win32. HB 09/23/01 -Quickstart to Using Junkbuster +Quickstart to Using <application>Foobar</application> - Install package, then run and enjoy! JunkBuster + Install package, then run and enjoy! Foobar is typically started by specifying the main configuration file to be used on the command line. Example Unix startup command: @@ -3009,7 +3008,7 @@ Removed references to Win32. HB 09/23/01 - # /usr/sbin/junkbuster /etc/junkbuster/config + # /usr/sbin/foobar /etc/foobar/config @@ -3019,21 +3018,21 @@ Removed references to Win32. HB 09/23/01 -For for SuSE: /etc/rc.d/junkbuster start +For for SuSE: /etc/rc.d/foobar start -For RedHat: /etc/rc.d/init.d/junkbuster start +For RedHat: /etc/rc.d/init.d/foobar start If no configuration file is specified on the command line, - Junkbuster will look for a file named + Foobar will look for a file named config in the current directory. Except on Win32 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. + Foobar will fail to start. @@ -3056,7 +3055,7 @@ For RedHat: /etc/rc.d/init.d/junkbuster start 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 + Foobar handle this. In which case, the browser(s) should be set to accept all cookies. @@ -3068,7 +3067,7 @@ For RedHat: /etc/rc.d/init.d/junkbuster start - Junkbuster is HTTP/1.1 compliant, but not all 1.1 + Foobar is HTTP/1.1 compliant, but not all 1.1 features are as yet implemented. If browsers that support HTTP/1.1 (like Mozilla or recent versions of I.E.) experience problems, you might try to force HTTP/1.0 compatibility. For Mozilla, look @@ -3078,7 +3077,7 @@ For RedHat: /etc/rc.d/init.d/junkbuster start - After running Junkbuster for a while, you can + After running Foobar 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 (as specified in ijb.action) @@ -3089,19 +3088,19 @@ For RedHat: /etc/rc.d/init.d/junkbuster start - In fact, various aspects of Junkbuster + In fact, various aspects of Foobar 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 ijb.action file - editor mentioned above, Junkbuster can also + editor mentioned above, Foobar can also be turned on and off from this page. If you encounter problems, please verify it is a - Junkbuster bug, by disabling - Junkbuster, and then trying the same page. + Foobar bug, by disabling + Foobar, and then trying the same page. Also, try another browser if possible to eliminate browser or site problems. Before reporting it as a bug, see if there is not a configuration option that is enabled that is causing the page not to load. You can @@ -3116,7 +3115,7 @@ For RedHat: /etc/rc.d/init.d/junkbuster start Command Line Options - JunkBuster may be invoked with the following + Foobar may be invoked with the following command-line options: @@ -3177,7 +3176,7 @@ For RedHat: /etc/rc.d/init.d/junkbuster start If no configfile is included on the command line, - JunkBuster will look for a file named + Foobar will look for a file named config in the current directory (except on Win32 where it will look for config.txt instead). Specify full path to avoid confusion. @@ -3211,7 +3210,7 @@ please note: Submit bugs only thru our Sourceforge bug forum. Make sure that the bug has not already been submitted. Please try to -verify that it is a Junkbuster bug, and not +verify that it is a Foobar bug, and not a browser or site bug first. If you are using your own custom configuration, please try the stock configs to see if the problem is a configuration related bug. And if not using the latest development snapshot, please @@ -3247,7 +3246,7 @@ For any other issues, feel free to use the History - Junkbuster was originally written by Anonymous + Junkbuster was originally written by Anonymous Coders and Junkbuster's Corporation, and was released as free open-source software under the GNU GPL. Stefan Waldherr made many improvements, and started the SourceForge project to - rekindle development. There are now several active developers contributing. - The last stable release was v2.0.2, which has now grown whiskers ;-). + url="http://sourceforge.net/projects/ijbswa/">SourceForge project + Foobar to rekindle development. There are now several active + developers contributing. The last stable release was v2.0.2, which has now + grown whiskers ;-). @@ -3340,7 +3340,7 @@ For any other issues, feel free to use the Regular Expressions - Junkbuster can use regular expressions + Foobar can use regular expressions in various config files. Assuming support for pcre (Perl Compatible Regular Expressions) is compiled in, which is the default. Such configuration directives do not require regular expressions, but they can be @@ -3453,7 +3453,7 @@ For any other issues, feel free to use the We are barely scratching the surface of regular expressions here so that you - can understand the default Junkbuster + can understand the default Foobar configuration files, and maybe use this knowledge to customize your own installation. There is much, much more that can be done with regular expressions. Now that you know enough to get started, you can learn more on @@ -3571,24 +3571,24 @@ For any other issues, feel free to use the - Junkbuster main page: + Foobar main page:
@@ -3658,7 +3658,7 @@ For any other issues, feel free to use the Anatomy of an Action - The way Junkbuster applies actions + The way Foobar applies actions to any given URL can be complex, and not always so easy to understand what is happening. And sometimes we need to be able to see - just what Junkbuster is doing. Especially, - if something Junkbuster is doing is causing + just what Foobar is doing. Especially, + if something Foobar is doing is causing us a problem inadvertantly. It can be a little daunting to look at the actions files themselves, since they tend to be filled with regular expressions whose consequences are not always - so obvious. Junkbuster provides the + so obvious. Foobar provides the http://ijbswa.sourceforge.net/config/show-url-info page that can show us very specifically how actions are being applied to any given URL. This is a big help for troubleshooting. @@ -3723,7 +3723,7 @@ For any other issues, feel free to use the This is the top section, and only tells us of the compiled in defaults. This - is basically what Junkbuster would do if there + is basically what Foobar would do if there were not any actions defined, i.e. it does nothing. Every action is disabled. This is not particularly informative for our purposes here. OK, next section: @@ -3811,7 +3811,7 @@ For any other issues, feel free to use the