more info on not hiding ip address
[privoxy.git] / doc / source / faq.sgml
index 661c566..6c257f7 100644 (file)
@@ -6,7 +6,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: faq.sgml,v 1.3 2001/09/23 10:13:48 swa Exp $
+ $Id: faq.sgml,v 1.8 2002/03/09 15:55:48 swa Exp $
 
  Written by and Copyright (C) 2001 the SourceForge
  IJBSWA team.  http://ijbswa.sourceforge.net
@@ -20,7 +20,7 @@
 <artheader>
 <title>Junkbuster Frequently Asked Questions</title>
 
-<pubdate>$Id: faq.sgml,v 1.3 2001/09/23 10:13:48 swa Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.8 2002/03/09 15:55:48 swa Exp $</pubdate>
 
 <authorgroup>
  <author>
@@ -50,7 +50,8 @@ Please see the Contact section in the user-manual if you want to contact the dev
 
 <!--   ~~~~~       New section      ~~~~~     -->
 <sect1 id="introduction"><title>Introduction</title>
-<para>To be filled.
+<para>
+   Fillme.
 </para>
 </sect1>
 
@@ -62,7 +63,7 @@ Please see the Contact section in the user-manual if you want to contact the dev
 
 <sect2 id="installation"><title>Installation</title>
  <para>
-  To be done later.
+   Fillme.
  </para>
 </sect2>
 
@@ -72,17 +73,190 @@ Please see the Contact section in the user-manual if you want to contact the dev
 
 <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>
 
@@ -92,20 +266,132 @@ Please see the Contact section in the user-manual if you want to contact the dev
 
 <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>
- 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..
+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> -->
+
 </sect2>
 
 </sect1>
@@ -153,6 +439,22 @@ Please see the Contact section in the user-manual if you want to contact the dev
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
 $Log: faq.sgml,v $
+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