-<!DOCTYPE Article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<!--
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
- File : $Source: /cvsroot/ijbswa/current/doc/webserver/faq.html,v $
+ 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.html,v 1.3 2001/09/10 17:43:59 swa Exp $
+ $Id: faq.sgml,v 1.7 2002/03/07 18:16:55 swa Exp $
Written by and Copyright (C) 2001 the SourceForge
IJBSWA team. http://ijbswa.sourceforge.net
<artheader>
<title>Junkbuster Frequently Asked Questions</title>
-<pubdate>$Id: faq.html,v 1.3 2001/09/10 17:43:59 swa Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.7 2002/03/07 18:16:55 swa Exp $</pubdate>
<authorgroup>
<author>
that provides privacy and security to the user of the world wide web.
</para>
<para>
-You can find the latest version of the document at <ulink url="http://ijbswa.sourceforge.net/doc/faq/">http://ijbswa.sourceforge.net/faq/</ulink>.
+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>
<!-- ~~~~~ New section ~~~~~ -->
<sect1 id="introduction"><title>Introduction</title>
-<para>To be filled.
+<para>
+ Fillme.
</para>
</sect1>
<sect2 id="installation"><title>Installation</title>
<para>
- To be done later.
+ Fillme.
</para>
</sect2>
<sect3 id="yahoo"><title>How can I make my Yahoo account work?</title>
<para>
- <comment>Blank para tag to quiet jade processing errors</comment>
+ 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-basci.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>
<sect2 id="misc"><title>Misc</title>
-<sect3 id="ip"><title>How can I hide my IP address?</title>
+<sect3 id="loadingtimes"><title>I noticed considerable
+delays in page requests compared to the old IJB. What's wrong?</title>
<para>
- You cannot hide your IP address with Junkbuster.
+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="image"><title>What is the imagefile (simage.ini, etc.) for?</title>
+
+<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>
- 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..
+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.
+</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> -->
+
</sect2>
</sect1>
<!-- ~~~~~ New section ~~~~~ -->
<sect1 id="copyright"><title>Copyright and History</title>
-<para>To be filled.
+<para>Please see the user manual for information on Copyright and History.
</para>
</sect1>
<!-- ~~~~~ New section ~~~~~ -->
<sect1 id="seealso"><title>See also</title>
-<para>To be filled.
+<para>Please see the user manual for information on references.
</para>
</sect1>
or write to the Free Software Foundation, Inc., 59
Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-$Log: faq.html,v $
+$Log: faq.sgml,v $
+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.