doc/source/faq.sgml

   1 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
   2 <!--
   3  File        :  $Source: /cvsroot/ijbswa/current/doc/source/faq.sgml,v $
   4
   5  Purpose     :  FAQ
   6                 This file belongs into
   7                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
   8
   9  $Id: faq.sgml,v 1.8 2002/03/09 15:55:48 swa Exp $
  10
  11  Written by and Copyright (C) 2001 the SourceForge
  12  IJBSWA team.  http://ijbswa.sourceforge.net
  13
  14  Based on the Internet Junkbuster originally written
  15  by and Copyright (C) 1997 Anonymous Coders and
  16  Junkbusters Corporation.  http://www.junkbusters.com
  17 -->
  18
  19 <article id="index">
  20 <artheader>
  21 <title>Junkbuster Frequently Asked Questions</title>
  22
  23 <pubdate>$Id: faq.sgml,v 1.8 2002/03/09 15:55:48 swa Exp $</pubdate>
  24
  25 <authorgroup>
  26  <author>
  27   <affiliation>
  28    <orgname>By: Junkbuster Developers</orgname>
  29    </affiliation>
  30  </author>
  31 </authorgroup>
  32
  33 <abstract>
  34  <para>
  35     The FAQ document gives users and developers alike answers to frequently
  36 asked questions about the Internet Junkbuster. The Internet Junkbuster is an application
  37 that provides privacy and security to the user of the world wide web.
  38  </para>
  39  <para>
  40 You can find the latest version of the document at <ulink url="http://ijbswa.sourceforge.net/faq/">http://ijbswa.sourceforge.net/faq/</ulink>.
  41 Please see the Contact section in the user-manual if you want to contact the developers.
  42  </para>
  43
  44  <para>
  45   Feel free to send a note to the developers at <email>ijbswa-developers@lists.sourceforge.net</email>.
  46  </para>
  47 </abstract>
  48 </artheader>
  49
  50
  51 <!--   ~~~~~       New section      ~~~~~     -->
  52 <sect1 id="introduction"><title>Introduction</title>
  53 <para>
  54    Fillme.
  55 </para>
  56 </sect1>
  57
  58 <!--   ~~~~~       New section      ~~~~~     -->
  59
  60 <sect1 id="questions"><title>Frequently Asked Questions</title>
  61
  62 <!--   ~~~~~       New section      ~~~~~     -->
  63
  64 <sect2 id="installation"><title>Installation</title>
  65  <para>
  66    Fillme.
  67  </para>
  68 </sect2>
  69
  70 <!--   ~~~~~       New section      ~~~~~     -->
  71
  72 <sect2 id="configuration"><title>Configuration</title>
  73
  74 <sect3 id="yahoo"><title>How can I make my Yahoo account work?</title>
  75  <para>
  76    Fillme.
  77  </para>
  78 </sect3>
  79
  80 <sect3 id="hotmail"> <title>How can I make my Hotmail account work?</title>
  81   <para>
  82    Fillme.
  83   </para>
  84 </sect3>
  85
  86 <sect3 id="gmx"> <title>How can I make my GMX account work?</title>
  87  <para>
  88    Fillme.
  89  </para>
  90 </sect3>
  91
  92 <sect3 id="configfiles"> <title>What are the differences between
  93 ijb-intermediate.action, ijb-basci.action, etc.?</title>
  94  <para>
  95 Configuring the Internet Junkbuster is not easy. To help you get started, we
  96 provide you with three different default configurations. The following table
  97 shows you, which features are enabled in each configuration.
  98  </para>
  99  <para>
 100 <table frame=all><title>Default Configurations</title>
 101 <tgroup cols=5 align=left colsep=1 rowsep=1>
 102 <colspec colname=c1>
 103 <colspec colname=c2>
 104 <colspec colname=c3>
 105 <colspec colname=c4>
 106 <colspec colname=c5>
 107 <thead>
 108 <row>
 109   <entry>Feature</entry>
 110   <entry>ijb.action</entry>
 111   <entry>ijb-basic.action</entry>
 112   <entry>ijb-intermediate.action</entry>
 113   <entry>ijb-advanced.action</entry>
 114 </row>
 115 </thead>
 116
 117 <!--  <tfoot> -->
 118 <!--  <row> -->
 119 <!--    <entry>f1</entry> -->
 120 <!--    <entry>f2</entry> -->
 121 <!--    <entry>f3</entry> -->
 122 <!--    <entry>f4</entry> -->
 123 <!--    <entry>f5</entry> -->
 124 <!--  </row> -->
 125 <!--  </tfoot> -->
 126
 127 <tbody>
 128 <!-- new row -->
 129 <row>
 130   <entry>ad-filtering</entry>
 131   <entry>?</entry>
 132   <entry>x</entry>
 133   <entry>x</entry>
 134   <entry>x</entry>
 135 </row>
 136 <!-- new row -->
 137 <row>
 138   <entry>blank image</entry>
 139   <entry>?</entry>
 140   <entry>x</entry>
 141   <entry>x</entry>
 142   <entry>x</entry>
 143 </row>
 144 <!-- new row -->
 145 <row>
 146   <entry>de-animate GIFs</entry>
 147   <entry>?</entry>
 148   <entry>x</entry>
 149   <entry>x</entry>
 150   <entry>x</entry>
 151 </row>
 152 <!-- new row -->
 153 <row>
 154   <entry>referer forging</entry>
 155   <entry>?</entry>
 156   <entry>x</entry>
 157   <entry>x</entry>
 158   <entry>x</entry>
 159 </row>
 160 <!-- new row -->
 161 <row>
 162   <entry>jon's +no-cookies-keep (i.e. session cookies only)</entry>
 163   <entry>?</entry>
 164   <entry>x</entry>
 165   <entry>x</entry>
 166   <entry>x</entry>
 167 </row>
 168 <!-- new row -->
 169 <row>
 170   <entry>no-popup windows</entry>
 171   <entry>?</entry>
 172   <entry></entry>
 173   <entry>x</entry>
 174   <entry>x</entry>
 175 </row>
 176 <!-- new row -->
 177 <row>
 178   <entry>fast redirects</entry>
 179   <entry>?</entry>
 180   <entry></entry>
 181   <entry>x</entry>
 182   <entry>x</entry>
 183 </row>
 184 <!-- new row -->
 185 <row>
 186   <entry>hide-referrer</entry>
 187   <entry>?</entry>
 188   <entry></entry>
 189   <entry>x</entry>
 190   <entry>x</entry>
 191 </row>
 192 <!-- new row -->
 193 <row>
 194   <entry>hide-useragent</entry>
 195   <entry>?</entry>
 196   <entry></entry>
 197   <entry>x</entry>
 198   <entry>x</entry>
 199 </row>
 200 <!-- new row -->
 201 <row>
 202   <entry>content-modification</entry>
 203   <entry>?</entry>
 204   <entry></entry>
 205   <entry></entry>
 206   <entry>x</entry>
 207 </row>
 208 <!-- new row -->
 209 <row>
 210   <entry>feature-x</entry>
 211   <entry>?</entry>
 212   <entry></entry>
 213   <entry></entry>
 214   <entry></entry>
 215 </row>
 216 <!-- new row -->
 217 <row>
 218   <entry>feature-y</entry>
 219   <entry>?</entry>
 220   <entry></entry>
 221   <entry></entry>
 222   <entry></entry>
 223 </row>
 224 <!-- new row -->
 225 <row>
 226   <entry>feature-z</entry>
 227   <entry>?</entry>
 228   <entry></entry>
 229   <entry></entry>
 230   <entry></entry>
 231 </row>
 232 <!-- finish -->
 233 </tbody>
 234 </tgroup>
 235 </table>
 236 </para>
 237 </sect3>
 238
 239 <sect3 id="browseconfig"> <title>Why can I change the configuration with a
 240 browser? Does that not raise security issues?</title>
 241  <para>
 242 What I don't understand, is how I can browser edit the config file as a
 243 regular user, while the whole /etc/junkbuster hierarchy belongs to the user
 244 "junkbuster", with only 644 perms.
 245  </para>
 246  <para>
 247 When you use the browser-based editor, JunkBuster itself is writing to the
 248 config files.  Because JunkBuster is running as the user "junkbuster", it can
 249 update the config files.
 250  </para>
 251  <para>
 252 If you don't like this, setting "enable-edit-actions 0" in the config file
 253 will disable the browser-based editor.  If you're that paranoid, you should
 254 also consider setting "enable-remote-toggle 0" to prevent browser-based
 255 enabling/disabling of JunkBuster.
 256  </para>
 257  <para>
 258 Note that normally only local users can connect to JunkBuster, so this is not
 259 (normally) a security problem.
 260  </para>
 261 </sect3>
 262
 263 </sect2>
 264
 265 <!--   ~~~~~       New section      ~~~~~     -->
 266
 267 <sect2 id="misc"><title>Misc</title>
 268
 269 <sect3 id="loadingtimes"><title>I noticed considerable
 270 delays in page requests compared to the old IJB. What's wrong?</title>
 271 <para>
 272 Using the default filtering configuration, I noticed considerable delays in
 273 page requests compared to the old IJB. Loading pages with large contents
 274 seemed to take forever, then suddenly delivering all the content at once.
 275  </para>
 276 <para>
 277 The whole content must be loaded in order to filter, and nothing is is
 278 sent to the browser during this time. The loading time does not really
 279 change in real numbers, but the feeling is different, because most
 280 browsers are able to start rendering incomplete content, giving the
 281 user a feeling of "it works".
 282  </para>
 283 <para>
 284 To modify the content of a page (i.e. make frames resizeable again, etc.) and
 285 not just replace ads, the Internet Junkbuster needs to download the entire
 286 page first, do its content magic and then send the page to the browser.
 287 </para>
 288 </sect3>
 289
 290
 291 <sect3 id="configurl"><title>What is the "http://i.j.b/"?</title>
 292 <para>
 293 Since JunkBuster sits between your web browser and the Internet, it can be
 294 programmed to handle certain pages specially.
 295 </para>
 296
 297 <para>
 298 With recent versions of JunkBuster (version 2.9.x), you can get some
 299 information about JunkBuster and change some settings by going to
 300 http://i.j.b/ or, equivalently, http://ijbswa.sourceforge.net/config/
 301 (Note that i.j.b is far easier to type but may not work in some
 302 configurations).
 303 </para>
 304
 305 <para>
 306 These pages are *not* forwarded to a server on the internet - instead they are
 307 handled by a special web server which is built in to JunkBuster.
 308 </para>
 309
 310 <para>
 311 If you are not running JunkBuster, then http://i.j.b/ will fail, and
 312 http://ijbswa.sourceforge.net/config/ will return a web page telling you
 313 you're not running JunkBuster.
 314 </para>
 315
 316 <para>
 317 If you have version 2.0.2, then the equivalent is
 318 http://example.com/show-proxy-args (but you get far less information, and you
 319 should really consider upgrading to 2.9.x).
 320 </para>
 321 </sect3>
 322
 323
 324 <sect3 id="badfiledesc"><title>I get the message 'Bad File Descriptor', why?</title>
 325 <para>
 326    Fillme.
 327 </para>
 328 </sect3>
 329
 330 <sect3 id="proxy-chaining"><title>How do I chain Junkbuster with other proxies
 331 (e.g. squid)?</title>
 332 <para>
 333    Fillme.
 334 </para>
 335 </sect3>
 336
 337 <sect3 id="jointeam"><title>I would like to help you, what do I do?</title>
 338 <para>
 339    Well, helping the team is always a good idea. We welcome new developers,
 340    RPM gurus or documentation makers. Simply get an account on sourceforge.net
 341    and mail your id to the developer mailing list. Once we have added you to
 342    the team, you'll have write access to the CVS repository, and together
 343    we'll find a suitable task for you.
 344 </para>
 345 </sect3>
 346
 347 <sect3 id="blocklist"><title>Do you still maintain the blocklists?</title>
 348 <para>
 349     No. The format of the blocklists has changed significantly in the versions
 350     2.9.x. Once we have released the new version, there will again be
 351     blocklists that you can update automatically.
 352 </para>
 353 </sect3>
 354
 355 <sect3 id="newads"><title>How can I submit new ads?</title>
 356 <para>
 357     As of now, please discontinue to submit new ad blocking infos. Once we
 358     have released the new version, there will again be a form on the website,
 359     which you can use to contribute new ads.
 360 </para>
 361 </sect3>
 362
 363 <sect3 id="ip"><title>How can I hide my IP address?</title>
 364 <para>
 365  You cannot hide your IP address with Junkbuster or any other software, since
 366 the server needs to know your IP address to send the answer to you.
 367 </para>
 368 <para>
 369 Fortunately there are many publicly usable anonymous proxies out there, which
 370 solve the problem by providing a further level of indirection between you and
 371 the web server, shared by many people and thus letting your requests "drown"
 372 in white noise of unrelated requests as far as user tracking is concerned.
 373 </para>
 374 <para>
 375 Most of them will, however, log your IP address and make it available to the
 376 authorities in case you abuse that anonymity for criminal purposes. In fact
 377 you can't even rule out that some of them only exist to *collect* information
 378 on (those suspicious) people with a more than average preference for privacy.
 379 </para>
 380 <para>
 381 You can find a list of anonymous public proxies at <ulink
 382 url="http://www.multiproxy.org/anon_list.htm">multiproxy.org</ulink> and many
 383 more through Google.
 384 </para>
 385 </sect3>
 386
 387 <!--  <sect3 id="image"><title>What is the imagefile (simage.ini, etc.) for?</title> -->
 388 <!--  <para> -->
 389 <!--   Anytime the Junkbuster determines (with the help of the blocklist) that a URL -->
 390 <!--   contains an advertisement, it has to decide whether this advertisement is an -->
 391 <!--   image or not. The Junkbuster uses the imagefile for that purpose. -->
 392 <!--  </para> -->
 393 <!--  </sect3> -->
 394
 395 </sect2>
 396
 397 </sect1>
 398
 399 <!--   ~~~~~       New section      ~~~~~     -->
 400 <sect1 id="contact"><title>Contact the developers</title>
 401 <para>Please see the user manual for information on how to contact the developers.
 402 </para>
 403 </sect1>
 404
 405 <!--   ~~~~~       New section      ~~~~~     -->
 406 <sect1 id="copyright"><title>Copyright and History</title>
 407 <para>Please see the user manual for information on Copyright and History.
 408 </para>
 409 </sect1>
 410
 411 <!--   ~~~~~       New section      ~~~~~     -->
 412 <sect1 id="seealso"><title>See also</title>
 413 <para>Please see the user manual for information on references.
 414 </para>
 415 </sect1>
 416
 417 <!-- hhmts end -->
 418  <!--
 419  Tue 09/11/01 06:38:14 PM EST: Test SGML doc by Hal Burgiss.
 420
 421  Last modified: Mon Sep 10 19:22:09 CEST 2001
 422
 423  This program is free software; you can redistribute it
 424  and/or modify it under the terms of the GNU General
 425  Public License as published by the Free Software
 426  Foundation; either version 2 of the License, or (at
 427  your option) any later version.
 428
 429  This program is distributed in the hope that it will
 430  be useful, but WITHOUT ANY WARRANTY; without even the
 431  implied warranty of MERCHANTABILITY or FITNESS FOR A
 432  PARTICULAR PURPOSE.  See the GNU General Public
 433  License for more details.
 434
 435  The GNU General Public License should be included with
 436  this file.  If not, you can view it at
 437  http://www.gnu.org/copyleft/gpl.html
 438  or write to the Free Software Foundation, Inc., 59
 439  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 440
 441 $Log: faq.sgml,v $
 442 Revision 1.8  2002/03/09 15:55:48  swa
 443 added default config section
 444
 445 Revision 1.7  2002/03/07 18:16:55  swa
 446 looks better
 447
 448 Revision 1.6  2002/03/07 13:16:31  oes
 449 Committing changes by Stefan
 450
 451 Revision 1.5  2002/03/02 15:50:04  swa
 452 2.9.11 version. more input for docs.
 453
 454 Revision 1.4  2002/02/24 14:34:24  jongfoster
 455 Formatting changes.  Now changing the doctype to DocBook XML 4.1
 456 will work - no other changes are needed.
 457
 458 Revision 1.3  2001/09/23 10:13:48  swa
 459 upload process established. run make webserver and
 460 the documentation is moved to the webserver. documents
 461 are now linked correctly.
 462
 463 Revision 1.2  2001/09/13 15:20:17  swa
 464 merged standards into developer manual
 465
 466 Revision 1.1  2001/09/12 15:36:41  swa
 467 source files for junkbuster documentation
 468
 469 Revision 1.3  2001/09/10 17:43:59  swa
 470 first proposal of a structure.
 471
 472 Revision 1.2  2001/06/13 14:28:31  swa
 473 docs should have an author.
 474
 475 Revision 1.1  2001/06/13 14:20:37  swa
 476 first import of project's documentation for the webserver.
 477
 478 -->
 479
 480 </article>