More additions.

[privoxy.git] / doc / source / faq.sgml

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<!--
 File        :  $Source: /cvsroot/ijbswa/current/doc/source/faq.sgml,v $

 Purpose     :  FAQ
                This file belongs into
                ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                
 $Id: faq.sgml,v 1.17 2002/03/18 03:53:53 hal9 Exp $

 Written by and Copyright (C) 2001 the SourceForge
 IJBSWA team.  http://ijbswa.sourceforge.net

 Based on the Internet Junkbuster originally written
 by and Copyright (C) 1997 Anonymous Coders and 
 Junkbusters Corporation.  http://www.junkbusters.com
-->

<article id="index">
<artheader>
<title>Junkbuster Frequently Asked Questions</title>

<pubdate>$Id: faq.sgml,v 1.17 2002/03/18 03:53:53 hal9 Exp $</pubdate>

<authorgroup>
 <author>
  <affiliation>
   <orgname>By: Junkbuster Developers</orgname>
   </affiliation>
 </author>
</authorgroup>

<abstract>
 <para>
The FAQ document gives users and developers alike answers to frequently asked
questions about the Internet Junkbuster. <application>Internet
Junkbuster</application> 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. <application>Internet
Junkbuster</application> has application for both stand-alone systems and
multi-user networks.
 </para>
 <para>
You can find the latest version of the document at <ulink url="http://ijbswa.sourceforge.net/faq/">http://ijbswa.sourceforge.net/faq/</ulink>.
Please see the Contact section in the user-manual if you want to contact the developers.
 </para>

<!--   <para> -->
<!--    Feel free to send a note to the developers at <email>ijbswa-developers@lists.sourceforge.net</email>. -->
<!--   </para> -->
</abstract>
</artheader>


<!--   ~~~~~       New section      ~~~~~     -->

<!--
<sect1 id="introduction"><title>Introduction</title>
<para>
   Fillme.
</para>
</sect1>
-->
<!--   ~~~~~       New section      ~~~~~     -->

<sect1 id="questions"><title>Frequently Asked Questions</title>

<!--   ~~~~~       New section      ~~~~~     -->

<sect2 id="general"><title>General Information</title>

<sect3 id="newjb"><title>What is this new version of <application>Junkbuster</application>?</title>
 <para>
  The original <application>Internet Junkbuster</application> (tm) is a 
  coyrighted product of <ulink url="http://www.junkbusters.com">Junkbusters
  Corporation</ulink>. Development of this effort stopped some time ago as of
  version 2.0.2. Stefan Walherr started the ijbswa project on <ulink
  url="http://ijbswa.sourceforge.net">Sourceforge</ulink> to rekindle
  development. Other developers subsequently joined with Stefan, and have
  since added many new features, refinements and enhancements. 
 </para>
 <para>
  The new <application>Junkbuster</application> started with the same
  code base, but has changed significantly at this point.
 </para>

</sect3>

<sect3 id="differs"><title>How does it differ from the old <application>Junkbuster?</application></title>
 <para>
   All the old features remain. The new <application>Junkbuster</application> 
   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.
 </para>
 <para>
  The configuration has changed significantly as well. This is something that
  users will notice right off the bat. The <quote>blocklist</quote> file does
  not exist any more. This is replaced by <quote>actions</quote> files, such
  as <filename>ijb.actions</filename>. This is where most of the per site
  configuration is now.

 </para>
</sect3>

<sect3 id="features"><title>What are some of the new features?</title>
<!--
 The section is in both user-manual and faq. Please keep in sync!!!
-->
<para>
 <itemizedlist>

 <listitem>
  <para>
   Integrated browser based configuration and control utility (<ulink
   url="http://i.j.b">http://i.j.b</ulink>). Browser-based tracing of rule
   and filter effects.
  </para>
 </listitem> 
<!--
 <listitem>
  <para>
   Modularized configuration that will allow for system wide settings, and
   individual user settings. (not implemented yet, probably a 3.1 feature)
  </para>
 </listitem> 
-->
 <listitem>
  <para>
    Blocking of annoying pop-up browser windows.
  </para>
 </listitem> 

 <listitem>
  <para>
   HTTP/1.1 compliant (most, but not all 1.1 features are supported).
  </para>
 </listitem> 

 <listitem>
  <para>
   Support for Perl Compatible Regular Expressions in the configuration files, and 
   generally a more sophisticated and flexible configuration syntax over
   previous versions. 
  </para>
 </listitem> 

 <listitem>
  <para>
   GIF de-animation. 
  </para>
 </listitem> 
 
 <listitem>
  <para>
   Web page content filtering (removes banners based on size,
   invisible <quote>web-bugs</quote>, JavaScript, pop-ups, status bar abuse,
   etc.)
  </para>
 </listitem> 
 
 <listitem>
  <para>
   Bypass many click-tracking scripts (avoids script redirection).
 
  </para>
 </listitem> 
 
 <listitem>
  <para>
   Multi-threaded (POSIX and native threads).
  </para>
 </listitem> 

 <listitem>
  <para>
   Auto-detection and re-reading of config file changes.
  </para>
 </listitem> 

 <listitem>
  <para>
   User-customizable HTML templates (e.g. 404 error page).
  </para>
 </listitem> 

 <listitem>
  <para>
   Improved cookie management features (e.g. session based cookies).
  </para>
</listitem> 

 <listitem>
  <para>
   Builds from source on most UNIX-like systems. Packages available for: Linux
   (RedHat, SuSE, or Debian), Windows, Sun Solaris, Mac OSX, OS/2, HP-UX 11 and AmigaOS.
 
  </para>
 </listitem> 

 <listitem>
  <para>
   In addition, the configuration is much more powerful and versatile over-all.
  </para>
</listitem> 

 </itemizedlist>
</para>

</sect3>

<sect3 id="proxymoron"><title>What is a <quote>proxy</quote>? How does
<application>Junkbuster</application> work? </title>
 <para>
  When you connect to a web site with <application>Junkbuster</application>, 
  you are really connecting to your locally running version of 
  <application>Junkbuster</application>. <application>Junkbuster</application>
  intercepts your requests for the web page, and relays that to the 
  <quote>real</quote> web site. The web site sends the HTTP data stream 
  back to <application>Junkbuster</application>, where
  <application>Junkbuster</application> can work its magic before it 
  relays this data back to your web browser.

 </para>

 <para>
  Since <application>Junkbuster</application> 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.
  <application>Junkbuster</application> uses various programming methods to do
  this, all of which is under your control via the various configuration
  files and options.

 </para>
</sect3>

<sect3 id="browsers2"><title>My browser does the same things as 
Junkbuster. Why should I use Junkbuster at all?</title>
 <para>
  Modern browsers do indeed have <emphasis>some</emphasis> of the same
  functionality as <application>Junkbuster</application>. Maybe this is
  adequate for you. But <application>Junkbuster</application> is much more
  verstatile and powerful, and can do a number of things that browsers just can't.
 </para>
 <para>
  In addition, a proxy is good choice if you use multiple browsers, or 
  have a LAN with multiple computers. This way all the configuration 
  is in one place, and you don't have to maintain a similar configuration 
  for possibly many browsers.

 </para>
</sect3>



<sect3 id="license"><title>Is there is a license or fee? What about a 
warranty? Registration?</title>
 <para>
  <application>Junkbuster</application> 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 <ulink
  url="http://www.gnu.org/copyleft/gpl.html">http://www.gnu.org/copyleft/gpl.html</ulink>
  for specifics.
  </para>
 <para>
  There is no warranty of any kind, expressed, implied or otherwise. That is
  something that would cost real money ;-) There is no registration either.
  <application>Junkbuster</application> really is <emphasis>free</emphasis>
  in every respect!

 </para>
</sect3>

</sect2>


<!--   ~~~~~       New section      ~~~~~     -->

<sect2 id="installation"><title>Installation</title>

<sect3 id="newinstall"><title>Can I install the new 
 <application>Junkbuster</application> over the old one?</title>
 <para>
   We recommend you uninstall the old <application>Junkbuster</application>
   first to minimize conflicts and confusion. You may want to 
   save your old configuration files for future reference. The configuration
   is substantially changed.
 </para>
 <para>
  See the user-manual for platform specific installation instructions.
  [FIXME: This is meant for after the name change for 3.0!]
 </para>
 
</sect3>

<sect3>
<title id="firststep">I just installed Junkbuster. Is there anything 
special I have to do now?</title>

<para>
 All browsers must be told to use <application>Junkbuster</application> 
 as a proxy by specifying the correct proxy address and port number 
 in the appropriate configuration area for the browser. See below.

</para>

</sect3>


<sect3 id="localhost"><title>What is the proxy address of Junkbuster?</title>
 <para>
  If you set up the <application>Junkbuster</application> 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 <quote>localhost</quote>
  (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
  <emphasis>listen-address</emphasis> config option). 
 </para>
 <para>
  When configuring your browser's proxy settings you typically enter
  the word <quote>localhost</quote> in the boxes next to <quote>HTTP</quote>
  and <quote>Secure</quote> (HTTPS) and then the number <quote>8118</quote>
  for <quote>port</quote>.  This tells your browser to send all web 
  requests to <quote>Junkbuster</quote> instead of directly to the 
  Interenet.
 </para>
 <para>
  <application>Junkbuster</application> 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 <application>Junkbuster</application> 
  is running, or the equivalent hostname. Port assignment would be 
  same as above.
 </para>
 <para>
  <application>Junkbuster</application> does not currently handle
  protocols such as FTP, SMTP, IM, IRC, ICQ, or other Internet
  protocols. 
 </para>
</sect3>

<sect3>
<title id="nothing">I just installed Junkbuster, and nothing is happening.
All the ads are there. What's wrong?</title>

<para>
 Did you configure your browser to use <application>Junkbuster</application> 
 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 <application>Junkbuster</application> is running, and your browser 
 is correctly configured by entering the special URL: 
 <ulink url="http://i.j.b/">http://i.j.b/</ulink>. This should give you 
 a banner that says <quote>This is the Internet JUNKBUSTER</quote> and 
 access to <application>Junkbuster's</application> internal configuration. 
 If you see this, then you are good to go. If not, the browser or 
 <application>Junkbuster</application> are not set up correctly.

</para>

</sect3>

</sect2>


<!--   ~~~~~       New section      ~~~~~     -->

<sect2 id="configuration"><title>Configuration</title>

<sect3 id="newconfig"><title>Can I use my old config files?</title>
 <para>
   There are major changes to <application>Junkbuster</application> 
   configuration from version 2.0.x to 2.9.x and later. The older files will
   not work at all. If this is the case, you will need to re-enter your old
   data into the new configuration structure. This is probably also a good 
   recommendation even if upgrading from 2.9.x to 3.x since there were 
   many minor changes along the way.
 </para>
</sect3>

<sect3>
<title id="actionsfile">What is an <quote>actions</quote> file?</title>

<para>
 <quote>actions</quote> files are where various actions that
 <application>Junkbuster</application> might take, are configured. 
 Typically, you would define a set of default actions that apply 
 to all URLs, then add exceptions to these defaults.
</para>
 
<para>
 Actions can be defined on a per site basis, or for groups of sites. Actions
 can also be grouped together and then applied to one or more sites. There
 are many possible actions that might apply to any given site. As an example,
 if we are blocking cookies as one of our default
 <application>actions</application>, but need to accept cookies from a given
 site, we would define this in our <quote>actions</quote> file.

</para>

<para>
 <application>Junkbuster</application> comes with several default
 <application>actions</application> files, with varying degrees 
 of filtering and blocking, as starting points for your own 
 configuration (see below).
</para>

</sect3>


<sect3>
<title id="actconfig">How are actions files configured? What is the easiest
way to do this?</title> 

<para>
 The easiest way to do this, is to access <application>Junkbuster</application>
 with your web browser at <ulink url="http://i.j.b/">http://i.j.b/</ulink>, 
 and then select 
 "<ulink url="http://ijbswa.sourceforge.net/config/edit-actions">Edit the actions list</ulink>"
 from the selection list. You can also do this by editing the appropriate 
 file with a text editor.
</para>

<para>
 Please see the user-manual for a detailed explanation of these and other
 configuration files, and their various options and syntax.
</para>
</sect3>


<!--
FIXME: Commenting these out until we have some data there. HB 03/17/02.

<sect3 id="yahoo"><title>How can I make my Yahoo account work?</title>
 <para>
   Fillme.
 </para>
</sect3>

<sect3 id="hotmail"> <title>How can I make my Hotmail account work?</title>
  <para>
   Fillme.
  </para>
</sect3>

<sect3 id="gmx"> <title>How can I make my GMX account work?</title>
 <para>
   Fillme.
 </para>
</sect3>
-->

<sect3 id="configfiles"> <title>What are the differences between
ijb-intermediate.action, ijb-basic.action, etc.?</title>
 <para>
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.
 </para>
 <para>
<table frame=all><title>Default Configurations</title>
<tgroup cols=5 align=left colsep=1 rowsep=1>
<colspec colname=c1>
<colspec colname=c2>
<colspec colname=c3>
<colspec colname=c4>
<colspec colname=c5>
<thead>
<row>
  <entry>Feature</entry>
  <entry>ijb.action</entry>
  <entry>ijb-basic.action</entry>
  <entry>ijb-intermediate.action</entry>
  <entry>ijb-advanced.action</entry>
</row>
</thead>

<!--  <tfoot> -->
<!--  <row> -->
<!--    <entry>f1</entry> -->
<!--    <entry>f2</entry> -->
<!--    <entry>f3</entry> -->
<!--    <entry>f4</entry> -->
<!--    <entry>f5</entry> -->
<!--  </row> -->
<!--  </tfoot> -->

<tbody>
<!-- new row -->
<row>
  <entry>ad-filtering</entry>
  <entry>?</entry>
  <entry>x</entry>
  <entry>x</entry>
  <entry>x</entry>
</row>
<!-- new row -->
<row>
  <entry>blank image</entry>
  <entry>?</entry>
  <entry>x</entry>
  <entry>x</entry>
  <entry>x</entry>
</row>
<!-- new row -->
<row>
  <entry>de-animate GIFs</entry>
  <entry>?</entry>
  <entry>x</entry>
  <entry>x</entry>
  <entry>x</entry>
</row>
<!-- new row -->
<row>
  <entry>referer forging</entry>
  <entry>?</entry>
  <entry>x</entry>
  <entry>x</entry>
  <entry>x</entry>
</row>
<!-- new row -->
<row>
  <entry>jon's +no-cookies-keep (i.e. session cookies only)</entry>
  <entry>?</entry>
  <entry>x</entry>
  <entry>x</entry>
  <entry>x</entry>
</row>
<!-- new row -->
<row>
  <entry>no-popup windows</entry>
  <entry>?</entry>
  <entry></entry>
  <entry>x</entry>
  <entry>x</entry>
</row>
<!-- new row -->
<row>
  <entry>fast redirects</entry>
  <entry>?</entry>
  <entry></entry>
  <entry>x</entry>
  <entry>x</entry>
</row>
<!-- new row -->
<row>
  <entry>hide-referrer</entry>
  <entry>?</entry>
  <entry></entry>
  <entry>x</entry>
  <entry>x</entry>
</row>
<!-- new row -->
<row>
  <entry>hide-useragent</entry>
  <entry>?</entry>
  <entry></entry>
  <entry>x</entry>
  <entry>x</entry>
</row>
<!-- new row -->
<row>
  <entry>content-modification</entry>
  <entry>?</entry>
  <entry></entry>
  <entry></entry>
  <entry>x</entry>
</row>
<!-- new row -->
<row>
  <entry>feature-x</entry>
  <entry>?</entry>
  <entry></entry>
  <entry></entry>
  <entry></entry>
</row>
<!-- new row -->
<row>
  <entry>feature-y</entry>
  <entry>?</entry>
  <entry></entry>
  <entry></entry>
  <entry></entry>
</row>
<!-- new row -->
<row>
  <entry>feature-z</entry>
  <entry>?</entry>
  <entry></entry>
  <entry></entry>
  <entry></entry>
</row>
<!-- finish -->
</tbody>
</tgroup>
</table>
</para>
</sect3>

<sect3 id="browseconfig"> <title>Why can I change the configuration with a
browser? Does that not raise security issues?</title>
 <para>
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.
 </para>
 <para>
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
update the config files.
 </para>
 <para>
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.
 </para>
 <para>
Note that normally only local users can connect to JunkBuster, so this is not
(normally) a security problem.
 </para>
</sect3>

<sect3>
<title id="lanconfig">How can I set up Junkbuster to act as a proxy for my 
 LAN?</title>
<para>
 By default, <application>Junkbuster</application> 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 <application>Junkbuster</application>
 configuration is located. In that file is a <quote>listen-address</quote> 
 option. It may be commented out with a <quote>#</quote> symbol. Make sure 
 it is uncommented, and assign it the address of the LAN gateway interface, 
 and port number to use:
</para>

<para>
 <screen>
  listen-address  192.168.1.1:8118
 </screen>
</para>

<para>
 Save the file, and restart <application>Junkbuster</application>. Configure 
 all browsers on the network then to use this address and port number.
</para>

</sect3>


<sect3>
<title id="noseeum">Instead of ads, now I get a Junkbuster logo [or 
checkerboard]. I don't want to see anything.</title>
<para>
 This is a configuration option for images that
 <application>Junkbuster</application> is stopping. You have the choice of the
 <application>Junkbuster</application> logo, a checkerboard pattern (this
 scales better), a transparent 1x1 GIF image, or a custom URL or your choice.
</para>

<para>
 If you want to see nothing, then change the <quote>+image-blocker</quote> 
 action to <quote>+image-blocker{blank}</quote>. This can done from the 
 <quote>Edit Actions List</quote> selection at <ulink
 url="http://i.j.b/">http://i.j.b/</ulink>. Or by hand editing the appropriate 
 actions file. This will only effect what is defined as <quote>images</quote>
 though. 

</para>

</sect3>


<sect3>
<title id="whyseeum">Why would anybody want to see the logo or checkerboard?</title>
<para>
 This can be helpful for troubleshooting problems. It might also be good 
 for anyone new to <application>Junkbuster</application> so that they can 
 see if their favorite pages are displaying correctly, and
 <application>Junkbuster</application> is not inadvertantly removing something 
 important.
</para>

</sect3>

<sect3>
<title id="blockedisugly">I see large red banners on some pages that say 
<quote>Blocked</quote>. How do I get rid of this?</title>
<para>
 These are URLs that match something on
 <application>Junkbuster's</application> block list. It is meant to be a
 warning, and they are handled differently than what has been defined as
 <quote>images</quote> (e.g. ad banners). If you want them to be treated as
 images, so that they can be invisible, then move the offending URL from the
 <quote>+block</quote> section to the <quote>+image-blocker</quote> section of
 your actions file. Alternately, you could modify the
 <quote><filename>block</filename></quote> HTML template that is used by
 <application>Junkbuster</application> to display this, and make it something
 more to your liking.

</para>

</sect3>

</sect2>

<!--   ~~~~~       New section      ~~~~~     -->

<sect2 id="misc"><title>Misc</title>

<sect3 id="loadingtimes"><title>I noticed considerable
delays in page requests compared to the old IJB. What's wrong?</title>
<para>
Using the default filtering configuration, I noticed considerable delays in
page requests compared to the old IJB. Loading pages with large contents
seemed to take forever, then suddenly delivering all the content at once.
 </para>
<para>
The whole content must be loaded in order to filter, and nothing is is
sent to the browser during this time. The loading time does not really
change in real numbers, but the feeling is different, because most
browsers are able to start rendering incomplete content, giving the
user a feeling of "it works". 
 </para>
<para>
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.
</para>
</sect3>


<sect3 id="configurl"><title>What is the "http://i.j.b/"?</title>
<para>
Since JunkBuster sits between your web browser and the Internet, it can be
programmed to handle certain pages specially.
</para>

<para>
With recent versions of JunkBuster (version 2.9.x), you can get some
information about JunkBuster 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).
</para>

<para>
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.
</para>

<para>
If you are not running JunkBuster, 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.
</para>

<para>
If you have version 2.0.2, then the equivalent is
http://example.com/show-proxy-args (but you get far less information, and you
should really consider upgrading to 2.9.x).
</para>
</sect3>


<sect3 id="badfiledesc"><title>I get the message 'Bad File Descriptor', why?</title>
<para>
   Fillme.
</para>
</sect3>

<sect3 id="proxy-chaining"><title>How do I chain Junkbuster with other proxies
(e.g. squid)?</title>
<para>
   Fillme.
</para>
</sect3>

<sect3 id="jointeam"><title>I would like to help you, what do I do?</title>
<para>
   Well, helping the team is always a good idea. We welcome new developers,
   RPM gurus or documentation makers. Simply get an account on sourceforge.net
   and mail your id to the developer mailing list. Once we have added you to
   the team, you'll have write access to the CVS repository, and together
   we'll find a suitable task for you.
</para>
</sect3>

<sect3 id="blocklist"><title>Do you still maintain the blocklists?</title>
<para>
    No. The format of the blocklists has changed significantly in the versions
    2.9.x. Once we have released the new version, there will again be
    blocklists that you can update automatically.
</para>
</sect3>

<sect3 id="newads"><title>How can I submit new ads?</title>
<para>
    As of now, please discontinue to submit new ad blocking infos. Once we
    have released the new version, there will again be a form on the website,
    which you can use to contribute new ads.
</para>
</sect3>

<sect3 id="ip"><title>How can I hide my IP address?</title>
<para>
 You cannot hide your IP address with Junkbuster or any other software, since
the server needs to know your IP address to send the answer to you.
</para>
<para>
Fortunately there are many publicly usable anonymous proxies out there, which
solve the problem by providing a further level of indirection between you and
the web server, shared by many people and thus letting your requests "drown"
in white noise of unrelated requests as far as user tracking is concerned.
</para>
<para>
Most of them will, however, log your IP address and make it available to the
authorities in case you abuse that anonymity for criminal purposes. In fact
you can't even rule out that some of them only exist to *collect* information
on (those suspicious) people with a more than average preference for privacy.
</para>
<para>
You can find a list of anonymous public proxies at <ulink
url="http://www.multiproxy.org/anon_list.htm">multiproxy.org</ulink> and many
more through Google.
</para>
</sect3>

<!--  <sect3 id="image"><title>What is the imagefile (simage.ini, etc.) for?</title> -->
<!--  <para> -->
<!--   Anytime the Junkbuster determines (with the help of the blocklist) that a URL -->
<!--   contains an advertisement, it has to decide whether this advertisement is an -->
<!--   image or not. The Junkbuster uses the imagefile for that purpose. -->
<!--  </para> -->
<!--  </sect3> -->

<sect3>
<title id="anonforsure">Can Junkbuster guarantee I am anonymous?</title>
<para>
 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.
</para>
<para>
 <application>Junkbuster</application> can remove various information about you,
 and allows <emphasis>you</emphasis> 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.
</para>
<para>
 A few browsers disclose the user's email address in certain situations, such
 as when transferring a file by FTP. <application>Junkbuster</application>
 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 <application>NSClean</application>.
</para>
<para>
 Browsers available only as binaries could use non-standard headers to give
 out any information they can have access to: see the manufacturer's license
 agreement. It's impossible to anticipate and prevent every breach of privacy
 that might occur. The professionally paranoid prefer browsers available as
 source code, because anticipating their behavior is easier. Trust the source,
 Luke!
</para>

</sect3>

<sect3>
<title id="sitebreak">Might some things break because header information is
being altered?</title>

<para>
 Definitely. More and more sites use HTTP header content to decide what to
 display and how to display it. There is many ways that this can be handled, 
 so having hard and fast rules, is tricky.
</para>

<para>
 <quote>USER AGENT</quote> in particular is often used in this way to identify
 the browser, and adjust content accordingly. Changing this now is not
 recommended, since so many sites do look for this. You may get undesirable 
 results by changing this.
</para>

<para>
 For instance, different browsers use different encodings of Russian and Czech
 characters, certain web servers convert pages on-the-fly according to the
 User Agent header. Giving a <quote>User Agent</quote> with the wrong
 operating system or browser manufacturer causes some sites in these languages
 to be garbled; Surfers to Eastern European sites should change it to
 something closer. And then some page access counters work by looking at the
 <quote>REFERER</quote> header; they may fail or break if unavailable. The
 weather maps of Intellicast have been blocked by their server when no
 <quote>REFERER</quote> or cookie is provided, is another example. There are
 many, many other ways things can go wrong when trying to fool a web server.
</para>

<para>
 If you have problems with a site, you will have to adjust your configuration 
 accordingly. Cookies are probably the most likely adjustment that may 
 be required, but by no means the only one.

</para>

</sect3>


<sect3>
<title id="caching">Can Junkbuster act as a <quote>caching</quote> proxy to 
speed up web browsing?</title>
<para>
 No, it does not have this ability at all. You want something like 
 <ulink url="http://www.squid-cache.org/">Squid</ulink> for this. And, yes, 
 before you ask, <application>Junkbuster</application> can co-exist 
 with other kinds of proxies like <quote>Squid</quote>.
</para>
</sect3>


<sect3>
<title id="logo">The Junkbuster logo that replaces ads is very blocky 
and ugly looking. Can't a better font be used?</title>

<para>
 This is not a font problem. The logo is an image that is created by 
 <application>Junkbuster</application> 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
 <quote>imageblocker</quote> directives: <emphasis>pattern</emphasis>, 
 <emphasis>blank</emphasis>, or a URL of your chosing.
</para>

</sect3>


<sect3>
<title id="wasted">I have large empty spaces now where ads used to be. 
Why does Junkbuster leave these large gaps?</title>
<para>
 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
 that use the overall size of the ad to help organize the page layout and
 position the various components of the page where they were intended to be.
 It is best left this way.

</para>

</sect3>


<sect3>
<title id="ssl">How can Junkbuster filter HTTPS URLs?</title>
<para>
 This is a limitation since HTTPS transactions are encrypted SSL sessions
 between your browser and the secure site, and are meant to be reliably 
 <emphasis>secure</emphasis> and private. This means that all cookies and HTTP
 header information are also encrypted from the time they leave your browser,
 or the site. <application>Junkbuster</application> does not try to unencrypt
 this information, so it just passes through as is.
 <application>Junkbuster</application> can still catch images and ads that
 are embedded in the SSL stream though.

</para>

</sect3>


<sect3>
<title id="secure">Junkbuster runs as a <quote>server</quote>. How 
secure is it? Do I need to take any special precautions?</title>
<para>
 There are no known exploits that might effect
 <application>Junkbuster</application>. On Unix-like systems, 
 <application>Junkbuster</application> can run as a non-privileged 
 user, which is how we recommend it be run. Also, by default 
 <application>Junkbuster</application> only listens to requests 
 from <quote>localhost</quote>. It is not itself directly exposed to the
 Internet in this configuration. If you want to have
 <application>Junkbuster</application> 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 
 <application>Junkbuster</application> config file. All LAN hosts can then use 
 this as their proxy address in the browser proxy configuration. In this way, 
 <application>Junkbuster</application> will not listen on any external ports.
 Of course, a firewall is always good too. Better safe than sorry.

</para>

</sect3>

<sect3>
<title id="filterfile">What is a <quote>re_filterfile</quote>?</title>
<para>
 The <quote>re_filterfile</quote> is used to <quote>filter</quote> any
 page content. By <quote>filtering</quote> we mean it can modify, remove, 
 or change <emphasis>anything</emphasis> on the page, including HTML tags, and
 JavaScript. Regular expressions are used to accomplish this. This is
 potentially a very powerful feature, but requires some expertise.

</para>

<para>
 If you are familiar with regular expressions, and HTML, you can look at 
 the provided <filename>re_filterfile</filename> with a text editor and see
 some of things it can be used for.

</para>

<para>
 Presently, there is no GUI editor option for this part of the configuration.

</para>

</sect3>
</sect2>


<!--   ~~~~~       New section      ~~~~~     -->

<sect2>
<title id="trouble">Troubleshooting</title>

<sect3>
<title id="refused">I just upgraded and am getting <quote>connection refused</quote>
with every web page?</title>
<para>
 Either <application>Junkbuster</application> is not running, or your 
 browser is configured for a different port than what
 <application>Junkbuster</application> is using.
</para>

<para>
 The old <application>Junkbuster</application> 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 <application>Junkbuster's</application> <quote>listen-address</quote>
 setting in the <filename>config</filename> file used to start 
 <application>Junkbuster</application>.
</para>

</sect3>

<sect3>
<title id="flushit">I just added a new rule, but the steenkin ad is 
still getting through. How?</title>
<para>
 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. The best thing to do is try flusing
 the browser's caches. And then try again.
</para>

<para>
 If this doesn't help, you probably have an error in the rule you
 applied. Try pasting the full URL of the offending ad into <ulink
 url="http://ijbswa.sourceforge.net/config/show-url-info">http://ijbswa.sourceforge.net/config/show-url-info</ulink>
 and see if any actions match your new rule.

</para>

</sect3>

<sect3>
<title id="badsite">One of my favorite sites does not work with Junkbuster.
What can I do?</title>

<para>
 First verify that it is indeed a <application>Junkbuster</application> problem, 
 by disabling <application>Junkbuster</application> filtering and blocking. 
 Go to <ulink url="http://i.j.b/">http://i.j.b/</ulink> and click on 
 <quote>Toggle Junkbuster On or Off</quote>, then disable it. Now try that 
 page again.
</para>

<para>
 If still a problem, go to <quote>Show which actions apply to a URL and
 why</quote> from  <ulink url="http://i.j.b/">http://i.j.b/</ulink> 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 <quote>Edit the actions list</quote>. Here you should see various 
 sections that have various <quote>Junkbuster</quote> features disabled 
 for specific sites. Disabled <quote>actions</quote> will have a
 <quote>-</quote> (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.

</para>

<para>
 Alternately, if you are comfortable with a text editor, you can accomplish 
 the same thing by editing the appropriate <quote>actions</quote> file.

</para>

</sect3>

<sect3>
<title id="time">What time is it?</title>
<para>
 Time for you to go!
</para>
</sect3>

</sect2>

</sect1>


<!--   ~~~~~       New section      ~~~~~     -->
<!--
FIXME: Commented out until we have something to put here. HB 03/18/02.
<sect1 id="knownissues"><title>Known Issues</title>
<para>
   Fillme.
</para>
</sect1>
-->
<!--   ~~~~~       New section      ~~~~~     -->
<sect1 id="contact"><title>Contact the developers</title>
<para>Please see the user manual for information on how to contact the developers.
</para>
</sect1>

<!--   ~~~~~       New section      ~~~~~     -->
<sect1 id="copyright"><title>Copyright and History</title>
<para>Please see the user manual for information on Copyright and History.
</para>
</sect1>

<!--   ~~~~~       New section      ~~~~~     -->
<sect1 id="seealso"><title>See also</title>
<para>Please see the user manual for information on references.
</para>
</sect1>

<!-- hhmts end -->
 <!--
 Tue 09/11/01 06:38:14 PM EST: Test SGML doc by Hal Burgiss.
 
 Last modified: Mon Sep 10 19:22:09 CEST 2001
 
 This program is free software; you can redistribute it 
 and/or modify it under the terms of the GNU General
 Public License as published by the Free Software
 Foundation; either version 2 of the License, or (at
 your option) any later version.

 This program is distributed in the hope that it will
 be useful, but WITHOUT ANY WARRANTY; without even the
 implied warranty of MERCHANTABILITY or FITNESS FOR A
 PARTICULAR PURPOSE.  See the GNU General Public
 License for more details.

 The GNU General Public License should be included with
 this file.  If not, you can view it at
 http://www.gnu.org/copyleft/gpl.html
 or write to the Free Software Foundation, Inc., 59
 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

$Log: faq.sgml,v $
Revision 1.17  2002/03/18 03:53:53  hal9
Some new additions.

Revision 1.16  2002/03/17 21:32:56  hal9
A few more additions.

Revision 1.15  2002/03/17 07:25:59  hal9
Correcting some of my typos, and some additions.

Revision 1.14  2002/03/17 02:39:13  hal9
A little more added ...

Revision 1.13  2002/03/17 00:22:20  hal9
Adding new stuff, and trying to incorporate stuff from old faq.

Revision 1.12  2002/03/11 20:13:21  swa
typo

Revision 1.11  2002/03/11 18:42:27  swa
new section

Revision 1.10  2002/03/11 13:13:27  swa
correct feedback channels

Revision 1.9  2002/03/10 23:34:04  swa
more info on not hiding ip address

Revision 1.8  2002/03/09 15:55:48  swa
added default config section

Revision 1.7  2002/03/07 18:16:55  swa
looks better

Revision 1.6  2002/03/07 13:16:31  oes
Committing changes by Stefan

Revision 1.5  2002/03/02 15:50:04  swa
2.9.11 version. more input for docs.

Revision 1.4  2002/02/24 14:34:24  jongfoster
Formatting changes.  Now changing the doctype to DocBook XML 4.1
will work - no other changes are needed.

Revision 1.3  2001/09/23 10:13:48  swa
upload process established. run make webserver and
the documentation is moved to the webserver. documents
are now linked correctly.

Revision 1.2  2001/09/13 15:20:17  swa
merged standards into developer manual

Revision 1.1  2001/09/12 15:36:41  swa
source files for junkbuster documentation

Revision 1.3  2001/09/10 17:43:59  swa
first proposal of a structure.

Revision 1.2  2001/06/13 14:28:31  swa
docs should have an author.

Revision 1.1  2001/06/13 14:20:37  swa
first import of project's documentation for the webserver.

-->

</article>