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