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.9 2002/03/10 23:34:04 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.9 2002/03/10 23:34:04 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="contact"><title>Contact the developers</title>
 407 <para>Please see the user manual for information on how to contact the developers.
 408 </para>
 409 </sect1>
 410
 411 <!--   ~~~~~       New section      ~~~~~     -->
 412 <sect1 id="copyright"><title>Copyright and History</title>
 413 <para>Please see the user manual for information on Copyright and History.
 414 </para>
 415 </sect1>
 416
 417 <!--   ~~~~~       New section      ~~~~~     -->
 418 <sect1 id="seealso"><title>See also</title>
 419 <para>Please see the user manual for information on references.
 420 </para>
 421 </sect1>
 422
 423 <!-- hhmts end -->
 424  <!--
 425  Tue 09/11/01 06:38:14 PM EST: Test SGML doc by Hal Burgiss.
 426
 427  Last modified: Mon Sep 10 19:22:09 CEST 2001
 428
 429  This program is free software; you can redistribute it
 430  and/or modify it under the terms of the GNU General
 431  Public License as published by the Free Software
 432  Foundation; either version 2 of the License, or (at
 433  your option) any later version.
 434
 435  This program is distributed in the hope that it will
 436  be useful, but WITHOUT ANY WARRANTY; without even the
 437  implied warranty of MERCHANTABILITY or FITNESS FOR A
 438  PARTICULAR PURPOSE.  See the GNU General Public
 439  License for more details.
 440
 441  The GNU General Public License should be included with
 442  this file.  If not, you can view it at
 443  http://www.gnu.org/copyleft/gpl.html
 444  or write to the Free Software Foundation, Inc., 59
 445  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 446
 447 $Log: faq.sgml,v $
 448 Revision 1.9  2002/03/10 23:34:04  swa
 449 more info on not hiding ip address
 450
 451 Revision 1.8  2002/03/09 15:55:48  swa
 452 added default config section
 453
 454 Revision 1.7  2002/03/07 18:16:55  swa
 455 looks better
 456
 457 Revision 1.6  2002/03/07 13:16:31  oes
 458 Committing changes by Stefan
 459
 460 Revision 1.5  2002/03/02 15:50:04  swa
 461 2.9.11 version. more input for docs.
 462
 463 Revision 1.4  2002/02/24 14:34:24  jongfoster
 464 Formatting changes.  Now changing the doctype to DocBook XML 4.1
 465 will work - no other changes are needed.
 466
 467 Revision 1.3  2001/09/23 10:13:48  swa
 468 upload process established. run make webserver and
 469 the documentation is moved to the webserver. documents
 470 are now linked correctly.
 471
 472 Revision 1.2  2001/09/13 15:20:17  swa
 473 merged standards into developer manual
 474
 475 Revision 1.1  2001/09/12 15:36:41  swa
 476 source files for junkbuster documentation
 477
 478 Revision 1.3  2001/09/10 17:43:59  swa
 479 first proposal of a structure.
 480
 481 Revision 1.2  2001/06/13 14:28:31  swa
 482 docs should have an author.
 483
 484 Revision 1.1  2001/06/13 14:20:37  swa
 485 first import of project's documentation for the webserver.
 486
 487 -->
 488
 489 </article>