1 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
3 File : $Source: /cvsroot/ijbswa/current/doc/source/faq.sgml,v $
7 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
9 $Id: faq.sgml,v 1.17 2002/03/18 03:53:53 hal9 Exp $
11 Written by and Copyright (C) 2001 the SourceForge
12 IJBSWA team. http://ijbswa.sourceforge.net
14 Based on the Internet Junkbuster originally written
15 by and Copyright (C) 1997 Anonymous Coders and
16 Junkbusters Corporation. http://www.junkbusters.com
21 <title>Junkbuster Frequently Asked Questions</title>
23 <pubdate>$Id: faq.sgml,v 1.17 2002/03/18 03:53:53 hal9 Exp $</pubdate>
28 <orgname>By: Junkbuster Developers</orgname>
35 The FAQ document gives users and developers alike answers to frequently asked
36 questions about the Internet Junkbuster. <application>Internet
37 Junkbuster</application> is a web proxy with advanced filtering capabilities
38 for protecting privacy, filtering web page content, managing cookies,
39 controlling access, and removing ads, banners, pop-ups and other obnoxious
40 Internet Junk. Junkbuster has a very flexible configuration and can be
41 customized to suit individual needs and tastes. <application>Internet
42 Junkbuster</application> has application for both stand-alone systems and
46 You can find the latest version of the document at <ulink url="http://ijbswa.sourceforge.net/faq/">http://ijbswa.sourceforge.net/faq/</ulink>.
47 Please see the Contact section in the user-manual if you want to contact the developers.
51 <!-- Feel free to send a note to the developers at <email>ijbswa-developers@lists.sourceforge.net</email>. -->
57 <!-- ~~~~~ New section ~~~~~ -->
60 <sect1 id="introduction"><title>Introduction</title>
66 <!-- ~~~~~ New section ~~~~~ -->
68 <sect1 id="questions"><title>Frequently Asked Questions</title>
70 <!-- ~~~~~ New section ~~~~~ -->
72 <sect2 id="general"><title>General Information</title>
74 <sect3 id="newjb"><title>What is this new version of <application>Junkbuster</application>?</title>
76 The original <application>Internet Junkbuster</application> (tm) is a
77 coyrighted product of <ulink url="http://www.junkbusters.com">Junkbusters
78 Corporation</ulink>. Development of this effort stopped some time ago as of
79 version 2.0.2. Stefan Walherr started the ijbswa project on <ulink
80 url="http://ijbswa.sourceforge.net">Sourceforge</ulink> to rekindle
81 development. Other developers subsequently joined with Stefan, and have
82 since added many new features, refinements and enhancements.
85 The new <application>Junkbuster</application> started with the same
86 code base, but has changed significantly at this point.
91 <sect3 id="differs"><title>How does it differ from the old <application>Junkbuster?</application></title>
93 All the old features remain. The new <application>Junkbuster</application>
94 still blocks ads and banners, still manages cookies, and still helps protect
95 your privacy. But, these are all enhanced, and many new features have been
96 added, all in the same vein.
99 The configuration has changed significantly as well. This is something that
100 users will notice right off the bat. The <quote>blocklist</quote> file does
101 not exist any more. This is replaced by <quote>actions</quote> files, such
102 as <filename>ijb.actions</filename>. This is where most of the per site
103 configuration is now.
108 <sect3 id="features"><title>What are some of the new features?</title>
110 The section is in both user-manual and faq. Please keep in sync!!!
117 Integrated browser based configuration and control utility (<ulink
118 url="http://i.j.b">http://i.j.b</ulink>). Browser-based tracing of rule
125 Modularized configuration that will allow for system wide settings, and
126 individual user settings. (not implemented yet, probably a 3.1 feature)
132 Blocking of annoying pop-up browser windows.
138 HTTP/1.1 compliant (most, but not all 1.1 features are supported).
144 Support for Perl Compatible Regular Expressions in the configuration files, and
145 generally a more sophisticated and flexible configuration syntax over
158 Web page content filtering (removes banners based on size,
159 invisible <quote>web-bugs</quote>, JavaScript, pop-ups, status bar abuse,
166 Bypass many click-tracking scripts (avoids script redirection).
173 Multi-threaded (POSIX and native threads).
179 Auto-detection and re-reading of config file changes.
185 User-customizable HTML templates (e.g. 404 error page).
191 Improved cookie management features (e.g. session based cookies).
197 Builds from source on most UNIX-like systems. Packages available for: Linux
198 (RedHat, SuSE, or Debian), Windows, Sun Solaris, Mac OSX, OS/2, HP-UX 11 and AmigaOS.
205 In addition, the configuration is much more powerful and versatile over-all.
214 <sect3 id="proxymoron"><title>What is a <quote>proxy</quote>? How does
215 <application>Junkbuster</application> work? </title>
217 When you connect to a web site with <application>Junkbuster</application>,
218 you are really connecting to your locally running version of
219 <application>Junkbuster</application>. <application>Junkbuster</application>
220 intercepts your requests for the web page, and relays that to the
221 <quote>real</quote> web site. The web site sends the HTTP data stream
222 back to <application>Junkbuster</application>, where
223 <application>Junkbuster</application> can work its magic before it
224 relays this data back to your web browser.
229 Since <application>Junkbuster</application> sits between you and the
230 WWW, it is in a position to intercept and completely manage all web traffic and
231 HTTP content before it gets to your browser.
232 <application>Junkbuster</application> uses various programming methods to do
233 this, all of which is under your control via the various configuration
239 <sect3 id="browsers2"><title>My browser does the same things as
240 Junkbuster. Why should I use Junkbuster at all?</title>
242 Modern browsers do indeed have <emphasis>some</emphasis> of the same
243 functionality as <application>Junkbuster</application>. Maybe this is
244 adequate for you. But <application>Junkbuster</application> is much more
245 verstatile and powerful, and can do a number of things that browsers just can't.
248 In addition, a proxy is good choice if you use multiple browsers, or
249 have a LAN with multiple computers. This way all the configuration
250 is in one place, and you don't have to maintain a similar configuration
251 for possibly many browsers.
258 <sect3 id="license"><title>Is there is a license or fee? What about a
259 warranty? Registration?</title>
261 <application>Junkbuster</application> is licensed under the
262 GNU General Public License (GPL). It is free to use, copy,
263 modify or distribute as you wish under the terms of this license.
265 url="http://www.gnu.org/copyleft/gpl.html">http://www.gnu.org/copyleft/gpl.html</ulink>
269 There is no warranty of any kind, expressed, implied or otherwise. That is
270 something that would cost real money ;-) There is no registration either.
271 <application>Junkbuster</application> really is <emphasis>free</emphasis>
280 <!-- ~~~~~ New section ~~~~~ -->
282 <sect2 id="installation"><title>Installation</title>
284 <sect3 id="newinstall"><title>Can I install the new
285 <application>Junkbuster</application> over the old one?</title>
287 We recommend you uninstall the old <application>Junkbuster</application>
288 first to minimize conflicts and confusion. You may want to
289 save your old configuration files for future reference. The configuration
290 is substantially changed.
293 See the user-manual for platform specific installation instructions.
294 [FIXME: This is meant for after the name change for 3.0!]
300 <title id="firststep">I just installed Junkbuster. Is there anything
301 special I have to do now?</title>
304 All browsers must be told to use <application>Junkbuster</application>
305 as a proxy by specifying the correct proxy address and port number
306 in the appropriate configuration area for the browser. See below.
313 <sect3 id="localhost"><title>What is the proxy address of Junkbuster?</title>
315 If you set up the <application>Junkbuster</application> to run on
316 the computer you browse from (rather than your ISP's server or some
317 networked computer on a LAN), the proxy will be on <quote>localhost</quote>
318 (which is the special name used by every computer on the Internet to refer
319 to itself) and the port will be 8118 (unless you have told the Internet
320 Junkbuster to run on a different port with the
321 <emphasis>listen-address</emphasis> config option).
324 When configuring your browser's proxy settings you typically enter
325 the word <quote>localhost</quote> in the boxes next to <quote>HTTP</quote>
326 and <quote>Secure</quote> (HTTPS) and then the number <quote>8118</quote>
327 for <quote>port</quote>. This tells your browser to send all web
328 requests to <quote>Junkbuster</quote> instead of directly to the
332 <application>Junkbuster</application> can also be used to proxy for
333 a Local Area Network. In this case, your would enter either the IP
334 address of the LAN host where <application>Junkbuster</application>
335 is running, or the equivalent hostname. Port assignment would be
339 <application>Junkbuster</application> does not currently handle
340 protocols such as FTP, SMTP, IM, IRC, ICQ, or other Internet
346 <title id="nothing">I just installed Junkbuster, and nothing is happening.
347 All the ads are there. What's wrong?</title>
350 Did you configure your browser to use <application>Junkbuster</application>
351 as a proxy? It does not sound like it. See above. You might also try flushing
352 the browser's caches to force a full re-reading of pages. You can verify
353 that <application>Junkbuster</application> is running, and your browser
354 is correctly configured by entering the special URL:
355 <ulink url="http://i.j.b/">http://i.j.b/</ulink>. This should give you
356 a banner that says <quote>This is the Internet JUNKBUSTER</quote> and
357 access to <application>Junkbuster's</application> internal configuration.
358 If you see this, then you are good to go. If not, the browser or
359 <application>Junkbuster</application> are not set up correctly.
368 <!-- ~~~~~ New section ~~~~~ -->
370 <sect2 id="configuration"><title>Configuration</title>
372 <sect3 id="newconfig"><title>Can I use my old config files?</title>
374 There are major changes to <application>Junkbuster</application>
375 configuration from version 2.0.x to 2.9.x and later. The older files will
376 not work at all. If this is the case, you will need to re-enter your old
377 data into the new configuration structure. This is probably also a good
378 recommendation even if upgrading from 2.9.x to 3.x since there were
379 many minor changes along the way.
384 <title id="actionsfile">What is an <quote>actions</quote> file?</title>
387 <quote>actions</quote> files are where various actions that
388 <application>Junkbuster</application> might take, are configured.
389 Typically, you would define a set of default actions that apply
390 to all URLs, then add exceptions to these defaults.
394 Actions can be defined on a per site basis, or for groups of sites. Actions
395 can also be grouped together and then applied to one or more sites. There
396 are many possible actions that might apply to any given site. As an example,
397 if we are blocking cookies as one of our default
398 <application>actions</application>, but need to accept cookies from a given
399 site, we would define this in our <quote>actions</quote> file.
404 <application>Junkbuster</application> comes with several default
405 <application>actions</application> files, with varying degrees
406 of filtering and blocking, as starting points for your own
407 configuration (see below).
414 <title id="actconfig">How are actions files configured? What is the easiest
415 way to do this?</title>
418 The easiest way to do this, is to access <application>Junkbuster</application>
419 with your web browser at <ulink url="http://i.j.b/">http://i.j.b/</ulink>,
421 "<ulink url="http://ijbswa.sourceforge.net/config/edit-actions">Edit the actions list</ulink>"
422 from the selection list. You can also do this by editing the appropriate
423 file with a text editor.
427 Please see the user-manual for a detailed explanation of these and other
428 configuration files, and their various options and syntax.
434 FIXME: Commenting these out until we have some data there. HB 03/17/02.
436 <sect3 id="yahoo"><title>How can I make my Yahoo account work?</title>
442 <sect3 id="hotmail"> <title>How can I make my Hotmail account work?</title>
448 <sect3 id="gmx"> <title>How can I make my GMX account work?</title>
455 <sect3 id="configfiles"> <title>What are the differences between
456 ijb-intermediate.action, ijb-basic.action, etc.?</title>
458 Configuring the Internet Junkbuster is not easy. To help you get started, we
459 provide you with three different default configurations. The following table
460 shows you, which features are enabled in each configuration.
463 <table frame=all><title>Default Configurations</title>
464 <tgroup cols=5 align=left colsep=1 rowsep=1>
472 <entry>Feature</entry>
473 <entry>ijb.action</entry>
474 <entry>ijb-basic.action</entry>
475 <entry>ijb-intermediate.action</entry>
476 <entry>ijb-advanced.action</entry>
482 <!-- <entry>f1</entry> -->
483 <!-- <entry>f2</entry> -->
484 <!-- <entry>f3</entry> -->
485 <!-- <entry>f4</entry> -->
486 <!-- <entry>f5</entry> -->
493 <entry>ad-filtering</entry>
501 <entry>blank image</entry>
509 <entry>de-animate GIFs</entry>
517 <entry>referer forging</entry>
525 <entry>jon's +no-cookies-keep (i.e. session cookies only)</entry>
533 <entry>no-popup windows</entry>
541 <entry>fast redirects</entry>
549 <entry>hide-referrer</entry>
557 <entry>hide-useragent</entry>
565 <entry>content-modification</entry>
573 <entry>feature-x</entry>
581 <entry>feature-y</entry>
589 <entry>feature-z</entry>
602 <sect3 id="browseconfig"> <title>Why can I change the configuration with a
603 browser? Does that not raise security issues?</title>
605 What I don't understand, is how I can browser edit the config file as a
606 regular user, while the whole /etc/junkbuster hierarchy belongs to the user
607 "junkbuster", with only 644 perms.
610 When you use the browser-based editor, JunkBuster itself is writing to the
611 config files. Because JunkBuster is running as the user "junkbuster", it can
612 update the config files.
615 If you don't like this, setting "enable-edit-actions 0" in the config file
616 will disable the browser-based editor. If you're that paranoid, you should
617 also consider setting "enable-remote-toggle 0" to prevent browser-based
618 enabling/disabling of JunkBuster.
621 Note that normally only local users can connect to JunkBuster, so this is not
622 (normally) a security problem.
627 <title id="lanconfig">How can I set up Junkbuster to act as a proxy for my
630 By default, <application>Junkbuster</application> only responds to requests
631 from localhost. To have it act as a server for a network, this needs to be
632 changed in the main config file where the <application>Junkbuster</application>
633 configuration is located. In that file is a <quote>listen-address</quote>
634 option. It may be commented out with a <quote>#</quote> symbol. Make sure
635 it is uncommented, and assign it the address of the LAN gateway interface,
636 and port number to use:
641 listen-address 192.168.1.1:8118
646 Save the file, and restart <application>Junkbuster</application>. Configure
647 all browsers on the network then to use this address and port number.
654 <title id="noseeum">Instead of ads, now I get a Junkbuster logo [or
655 checkerboard]. I don't want to see anything.</title>
657 This is a configuration option for images that
658 <application>Junkbuster</application> is stopping. You have the choice of the
659 <application>Junkbuster</application> logo, a checkerboard pattern (this
660 scales better), a transparent 1x1 GIF image, or a custom URL or your choice.
664 If you want to see nothing, then change the <quote>+image-blocker</quote>
665 action to <quote>+image-blocker{blank}</quote>. This can done from the
666 <quote>Edit Actions List</quote> selection at <ulink
667 url="http://i.j.b/">http://i.j.b/</ulink>. Or by hand editing the appropriate
668 actions file. This will only effect what is defined as <quote>images</quote>
677 <title id="whyseeum">Why would anybody want to see the logo or checkerboard?</title>
679 This can be helpful for troubleshooting problems. It might also be good
680 for anyone new to <application>Junkbuster</application> so that they can
681 see if their favorite pages are displaying correctly, and
682 <application>Junkbuster</application> is not inadvertantly removing something
689 <title id="blockedisugly">I see large red banners on some pages that say
690 <quote>Blocked</quote>. How do I get rid of this?</title>
692 These are URLs that match something on
693 <application>Junkbuster's</application> block list. It is meant to be a
694 warning, and they are handled differently than what has been defined as
695 <quote>images</quote> (e.g. ad banners). If you want them to be treated as
696 images, so that they can be invisible, then move the offending URL from the
697 <quote>+block</quote> section to the <quote>+image-blocker</quote> section of
698 your actions file. Alternately, you could modify the
699 <quote><filename>block</filename></quote> HTML template that is used by
700 <application>Junkbuster</application> to display this, and make it something
709 <!-- ~~~~~ New section ~~~~~ -->
711 <sect2 id="misc"><title>Misc</title>
713 <sect3 id="loadingtimes"><title>I noticed considerable
714 delays in page requests compared to the old IJB. What's wrong?</title>
716 Using the default filtering configuration, I noticed considerable delays in
717 page requests compared to the old IJB. Loading pages with large contents
718 seemed to take forever, then suddenly delivering all the content at once.
721 The whole content must be loaded in order to filter, and nothing is is
722 sent to the browser during this time. The loading time does not really
723 change in real numbers, but the feeling is different, because most
724 browsers are able to start rendering incomplete content, giving the
725 user a feeling of "it works".
728 To modify the content of a page (i.e. make frames resizeable again, etc.) and
729 not just replace ads, the Internet Junkbuster needs to download the entire
730 page first, do its content magic and then send the page to the browser.
735 <sect3 id="configurl"><title>What is the "http://i.j.b/"?</title>
737 Since JunkBuster sits between your web browser and the Internet, it can be
738 programmed to handle certain pages specially.
742 With recent versions of JunkBuster (version 2.9.x), you can get some
743 information about JunkBuster and change some settings by going to
744 http://i.j.b/ or, equivalently, http://ijbswa.sourceforge.net/config/
745 (Note that i.j.b is far easier to type but may not work in some
750 These pages are *not* forwarded to a server on the internet - instead they are
751 handled by a special web server which is built in to JunkBuster.
755 If you are not running JunkBuster, then http://i.j.b/ will fail, and
756 http://ijbswa.sourceforge.net/config/ will return a web page telling you
757 you're not running JunkBuster.
761 If you have version 2.0.2, then the equivalent is
762 http://example.com/show-proxy-args (but you get far less information, and you
763 should really consider upgrading to 2.9.x).
768 <sect3 id="badfiledesc"><title>I get the message 'Bad File Descriptor', why?</title>
774 <sect3 id="proxy-chaining"><title>How do I chain Junkbuster with other proxies
775 (e.g. squid)?</title>
781 <sect3 id="jointeam"><title>I would like to help you, what do I do?</title>
783 Well, helping the team is always a good idea. We welcome new developers,
784 RPM gurus or documentation makers. Simply get an account on sourceforge.net
785 and mail your id to the developer mailing list. Once we have added you to
786 the team, you'll have write access to the CVS repository, and together
787 we'll find a suitable task for you.
791 <sect3 id="blocklist"><title>Do you still maintain the blocklists?</title>
793 No. The format of the blocklists has changed significantly in the versions
794 2.9.x. Once we have released the new version, there will again be
795 blocklists that you can update automatically.
799 <sect3 id="newads"><title>How can I submit new ads?</title>
801 As of now, please discontinue to submit new ad blocking infos. Once we
802 have released the new version, there will again be a form on the website,
803 which you can use to contribute new ads.
807 <sect3 id="ip"><title>How can I hide my IP address?</title>
809 You cannot hide your IP address with Junkbuster or any other software, since
810 the server needs to know your IP address to send the answer to you.
813 Fortunately there are many publicly usable anonymous proxies out there, which
814 solve the problem by providing a further level of indirection between you and
815 the web server, shared by many people and thus letting your requests "drown"
816 in white noise of unrelated requests as far as user tracking is concerned.
819 Most of them will, however, log your IP address and make it available to the
820 authorities in case you abuse that anonymity for criminal purposes. In fact
821 you can't even rule out that some of them only exist to *collect* information
822 on (those suspicious) people with a more than average preference for privacy.
825 You can find a list of anonymous public proxies at <ulink
826 url="http://www.multiproxy.org/anon_list.htm">multiproxy.org</ulink> and many
831 <!-- <sect3 id="image"><title>What is the imagefile (simage.ini, etc.) for?</title> -->
833 <!-- Anytime the Junkbuster determines (with the help of the blocklist) that a URL -->
834 <!-- contains an advertisement, it has to decide whether this advertisement is an -->
835 <!-- image or not. The Junkbuster uses the imagefile for that purpose. -->
840 <title id="anonforsure">Can Junkbuster guarantee I am anonymous?</title>
842 No. Your chances of remaining anonymous are greatly improved, but unless you
843 are an expert on Internet security it would be safest to assume that
844 everything you do on the Web can be traced back to you.
847 <application>Junkbuster</application> can remove various information about you,
848 and allows <emphasis>you</emphasis> more freedom to decide which sites
849 you can trust. But it's still possible that web sites can find out who you
850 are. Here's one way this can happen.
853 A few browsers disclose the user's email address in certain situations, such
854 as when transferring a file by FTP. <application>Junkbuster</application>
855 does not filter FTP. If you need this feature, or are concerned about the
856 mail handler of your browser disclosing your email address, you might
857 consider products such as <application>NSClean</application>.
860 Browsers available only as binaries could use non-standard headers to give
861 out any information they can have access to: see the manufacturer's license
862 agreement. It's impossible to anticipate and prevent every breach of privacy
863 that might occur. The professionally paranoid prefer browsers available as
864 source code, because anticipating their behavior is easier. Trust the source,
871 <title id="sitebreak">Might some things break because header information is
872 being altered?</title>
875 Definitely. More and more sites use HTTP header content to decide what to
876 display and how to display it. There is many ways that this can be handled,
877 so having hard and fast rules, is tricky.
881 <quote>USER AGENT</quote> in particular is often used in this way to identify
882 the browser, and adjust content accordingly. Changing this now is not
883 recommended, since so many sites do look for this. You may get undesirable
884 results by changing this.
888 For instance, different browsers use different encodings of Russian and Czech
889 characters, certain web servers convert pages on-the-fly according to the
890 User Agent header. Giving a <quote>User Agent</quote> with the wrong
891 operating system or browser manufacturer causes some sites in these languages
892 to be garbled; Surfers to Eastern European sites should change it to
893 something closer. And then some page access counters work by looking at the
894 <quote>REFERER</quote> header; they may fail or break if unavailable. The
895 weather maps of Intellicast have been blocked by their server when no
896 <quote>REFERER</quote> or cookie is provided, is another example. There are
897 many, many other ways things can go wrong when trying to fool a web server.
901 If you have problems with a site, you will have to adjust your configuration
902 accordingly. Cookies are probably the most likely adjustment that may
903 be required, but by no means the only one.
911 <title id="caching">Can Junkbuster act as a <quote>caching</quote> proxy to
912 speed up web browsing?</title>
914 No, it does not have this ability at all. You want something like
915 <ulink url="http://www.squid-cache.org/">Squid</ulink> for this. And, yes,
916 before you ask, <application>Junkbuster</application> can co-exist
917 with other kinds of proxies like <quote>Squid</quote>.
923 <title id="logo">The Junkbuster logo that replaces ads is very blocky
924 and ugly looking. Can't a better font be used?</title>
927 This is not a font problem. The logo is an image that is created by
928 <application>Junkbuster</application> on the fly. So as to not waste
929 memory, the image is rather small. The blockiness comes when the
930 image is scaled to fill a largish area. There is not much to be done
931 about this, other than to use one of the other
932 <quote>imageblocker</quote> directives: <emphasis>pattern</emphasis>,
933 <emphasis>blank</emphasis>, or a URL of your chosing.
940 <title id="wasted">I have large empty spaces now where ads used to be.
941 Why does Junkbuster leave these large gaps?</title>
943 It would be easy enough to just eliminate this space altogether, rather than
944 fill it with blank space. But, this would create problems with many pages
945 that use the overall size of the ad to help organize the page layout and
946 position the various components of the page where they were intended to be.
947 It is best left this way.
955 <title id="ssl">How can Junkbuster filter HTTPS URLs?</title>
957 This is a limitation since HTTPS transactions are encrypted SSL sessions
958 between your browser and the secure site, and are meant to be reliably
959 <emphasis>secure</emphasis> and private. This means that all cookies and HTTP
960 header information are also encrypted from the time they leave your browser,
961 or the site. <application>Junkbuster</application> does not try to unencrypt
962 this information, so it just passes through as is.
963 <application>Junkbuster</application> can still catch images and ads that
964 are embedded in the SSL stream though.
972 <title id="secure">Junkbuster runs as a <quote>server</quote>. How
973 secure is it? Do I need to take any special precautions?</title>
975 There are no known exploits that might effect
976 <application>Junkbuster</application>. On Unix-like systems,
977 <application>Junkbuster</application> can run as a non-privileged
978 user, which is how we recommend it be run. Also, by default
979 <application>Junkbuster</application> only listens to requests
980 from <quote>localhost</quote>. It is not itself directly exposed to the
981 Internet in this configuration. If you want to have
982 <application>Junkbuster</application> serve as a LAN proxy, this will have to
983 be opened up to allow for LAN requests. In this case, we'd recommend
984 you specify only the LAN gateway address, e.g. 192.168.1.1 in the main
985 <application>Junkbuster</application> config file. All LAN hosts can then use
986 this as their proxy address in the browser proxy configuration. In this way,
987 <application>Junkbuster</application> will not listen on any external ports.
988 Of course, a firewall is always good too. Better safe than sorry.
995 <title id="filterfile">What is a <quote>re_filterfile</quote>?</title>
997 The <quote>re_filterfile</quote> is used to <quote>filter</quote> any
998 page content. By <quote>filtering</quote> we mean it can modify, remove,
999 or change <emphasis>anything</emphasis> on the page, including HTML tags, and
1000 JavaScript. Regular expressions are used to accomplish this. This is
1001 potentially a very powerful feature, but requires some expertise.
1006 If you are familiar with regular expressions, and HTML, you can look at
1007 the provided <filename>re_filterfile</filename> with a text editor and see
1008 some of things it can be used for.
1013 Presently, there is no GUI editor option for this part of the configuration.
1021 <!-- ~~~~~ New section ~~~~~ -->
1024 <title id="trouble">Troubleshooting</title>
1027 <title id="refused">I just upgraded and am getting <quote>connection refused</quote>
1028 with every web page?</title>
1030 Either <application>Junkbuster</application> is not running, or your
1031 browser is configured for a different port than what
1032 <application>Junkbuster</application> is using.
1036 The old <application>Junkbuster</application> used port 8000 by
1037 default. This has been changed to port 8118 now, due to a conflict
1038 with NAS (Network Audio Service), which uses port 8000. If you haven't,
1039 you need to change your browser to the new port number, or alternately
1040 change <application>Junkbuster's</application> <quote>listen-address</quote>
1041 setting in the <filename>config</filename> file used to start
1042 <application>Junkbuster</application>.
1048 <title id="flushit">I just added a new rule, but the steenkin ad is
1049 still getting through. How?</title>
1051 If the ad had been displayed before you added its URL, it will probably be
1052 held in the browser's cache for some time, so it will be displayed without
1053 the need for any request to the server. The best thing to do is try flusing
1054 the browser's caches. And then try again.
1058 If this doesn't help, you probably have an error in the rule you
1059 applied. Try pasting the full URL of the offending ad into <ulink
1060 url="http://ijbswa.sourceforge.net/config/show-url-info">http://ijbswa.sourceforge.net/config/show-url-info</ulink>
1061 and see if any actions match your new rule.
1068 <title id="badsite">One of my favorite sites does not work with Junkbuster.
1069 What can I do?</title>
1072 First verify that it is indeed a <application>Junkbuster</application> problem,
1073 by disabling <application>Junkbuster</application> filtering and blocking.
1074 Go to <ulink url="http://i.j.b/">http://i.j.b/</ulink> and click on
1075 <quote>Toggle Junkbuster On or Off</quote>, then disable it. Now try that
1080 If still a problem, go to <quote>Show which actions apply to a URL and
1081 why</quote> from <ulink url="http://i.j.b/">http://i.j.b/</ulink> and
1082 paste the full URL of the page in question into the prompt. See which
1083 actions are being applied to the URL. Now, armed with this information,
1084 go to <quote>Edit the actions list</quote>. Here you should see various
1085 sections that have various <quote>Junkbuster</quote> features disabled
1086 for specific sites. Disabled <quote>actions</quote> will have a
1087 <quote>-</quote> (minus sign) in front of them. Add your problem page
1088 URL to one of these sections that looks like it is disabling the feature that
1089 is causing the problem. Re-try the page. There might be some trial and error
1095 Alternately, if you are comfortable with a text editor, you can accomplish
1096 the same thing by editing the appropriate <quote>actions</quote> file.
1103 <title id="time">What time is it?</title>
1114 <!-- ~~~~~ New section ~~~~~ -->
1116 FIXME: Commented out until we have something to put here. HB 03/18/02.
1117 <sect1 id="knownissues"><title>Known Issues</title>
1123 <!-- ~~~~~ New section ~~~~~ -->
1124 <sect1 id="contact"><title>Contact the developers</title>
1125 <para>Please see the user manual for information on how to contact the developers.
1129 <!-- ~~~~~ New section ~~~~~ -->
1130 <sect1 id="copyright"><title>Copyright and History</title>
1131 <para>Please see the user manual for information on Copyright and History.
1135 <!-- ~~~~~ New section ~~~~~ -->
1136 <sect1 id="seealso"><title>See also</title>
1137 <para>Please see the user manual for information on references.
1143 Tue 09/11/01 06:38:14 PM EST: Test SGML doc by Hal Burgiss.
1145 Last modified: Mon Sep 10 19:22:09 CEST 2001
1147 This program is free software; you can redistribute it
1148 and/or modify it under the terms of the GNU General
1149 Public License as published by the Free Software
1150 Foundation; either version 2 of the License, or (at
1151 your option) any later version.
1153 This program is distributed in the hope that it will
1154 be useful, but WITHOUT ANY WARRANTY; without even the
1155 implied warranty of MERCHANTABILITY or FITNESS FOR A
1156 PARTICULAR PURPOSE. See the GNU General Public
1157 License for more details.
1159 The GNU General Public License should be included with
1160 this file. If not, you can view it at
1161 http://www.gnu.org/copyleft/gpl.html
1162 or write to the Free Software Foundation, Inc., 59
1163 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
1166 Revision 1.17 2002/03/18 03:53:53 hal9
1169 Revision 1.16 2002/03/17 21:32:56 hal9
1170 A few more additions.
1172 Revision 1.15 2002/03/17 07:25:59 hal9
1173 Correcting some of my typos, and some additions.
1175 Revision 1.14 2002/03/17 02:39:13 hal9
1176 A little more added ...
1178 Revision 1.13 2002/03/17 00:22:20 hal9
1179 Adding new stuff, and trying to incorporate stuff from old faq.
1181 Revision 1.12 2002/03/11 20:13:21 swa
1184 Revision 1.11 2002/03/11 18:42:27 swa
1187 Revision 1.10 2002/03/11 13:13:27 swa
1188 correct feedback channels
1190 Revision 1.9 2002/03/10 23:34:04 swa
1191 more info on not hiding ip address
1193 Revision 1.8 2002/03/09 15:55:48 swa
1194 added default config section
1196 Revision 1.7 2002/03/07 18:16:55 swa
1199 Revision 1.6 2002/03/07 13:16:31 oes
1200 Committing changes by Stefan
1202 Revision 1.5 2002/03/02 15:50:04 swa
1203 2.9.11 version. more input for docs.
1205 Revision 1.4 2002/02/24 14:34:24 jongfoster
1206 Formatting changes. Now changing the doctype to DocBook XML 4.1
1207 will work - no other changes are needed.
1209 Revision 1.3 2001/09/23 10:13:48 swa
1210 upload process established. run make webserver and
1211 the documentation is moved to the webserver. documents
1212 are now linked correctly.
1214 Revision 1.2 2001/09/13 15:20:17 swa
1215 merged standards into developer manual
1217 Revision 1.1 2001/09/12 15:36:41 swa
1218 source files for junkbuster documentation
1220 Revision 1.3 2001/09/10 17:43:59 swa
1221 first proposal of a structure.
1223 Revision 1.2 2001/06/13 14:28:31 swa
1224 docs should have an author.
1226 Revision 1.1 2001/06/13 14:20:37 swa
1227 first import of project's documentation for the webserver.