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.6 2002/03/07 13:16:31 oes 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.6 2002/03/07 13:16:31 oes 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="browseconfig"> <title>Why can I change the configuration with a
  93 browser? Does that not raise security issues?</title>
  94  <para>
  95 What I don't understand, is how I can browser edit the config file as a
  96 regular user, while the whole /etc/junkbuster hierarchy belongs to the user
  97 "junkbuster", with only 644 perms.
  98  </para>
  99  <para>
 100 When you use the browser-based editor, JunkBuster itself is writing to the
 101 config files.  Because JunkBuster is running as the user "junkbuster", it can
 102 update the config files.
 103  </para>
 104  <para>
 105 If you don't like this, setting "enable-edit-actions 0" in the config file
 106 will disable the browser-based editor.  If you're that paranoid, you should
 107 also consider setting "enable-remote-toggle 0" to prevent browser-based
 108 enabling/disabling of JunkBuster.
 109  </para>
 110  <para>
 111 Note that normally only local users can connect to JunkBuster, so this is not
 112 (normally) a security problem.
 113  </para>
 114 </sect3>
 115
 116 </sect2>
 117
 118 <!--   ~~~~~       New section      ~~~~~     -->
 119
 120 <sect2 id="misc"><title>Misc</title>
 121
 122 <sect3 id="loadingtimes"><title>I noticed considerable
 123 delays in page requests compared to the old IJB. What's wrong?</title>
 124 <para>
 125 Using the default filtering configuration, I noticed considerable delays in
 126 page requests compared to the old IJB. Loading pages with large contents
 127 seemed to take forever, then suddenly delivering all the content at once.
 128  </para>
 129 <para>
 130 The whole content must be loaded in order to filter, and nothing is is
 131 sent to the browser during this time. The loading time does not really
 132 change in real numbers, but the feeling is different, because most
 133 browsers are able to start rendering incomplete content, giving the
 134 user a feeling of "it works".
 135  </para>
 136 <para>
 137 To modify the content of a page (i.e. make frames resizeable again, etc.) and
 138 not just replace ads, the Internet Junkbuster needs to download the entire
 139 page first, do its content magic and then send the page to the browser.
 140 </para>
 141 </sect3>
 142
 143
 144 <sect3 id="configurl"><title>What is the "http://i.j.b/"?</title>
 145 <para>
 146 Since JunkBuster sits between your web browser and the Internet, it can be
 147 programmed to handle certain pages specially.
 148 </para>
 149
 150 <para>
 151 With recent versions of JunkBuster (version 2.9.x), you can get some
 152 information about JunkBuster and change some settings by going to
 153 http://i.j.b/ or, equivalently, http://ijbswa.sourceforge.net/config/
 154 (Note that i.j.b is far easier to type but may not work in some
 155 configurations).
 156 </para>
 157
 158 <para>
 159 These pages are *not* forwarded to a server on the internet - instead they are
 160 handled by a special web server which is built in to JunkBuster.
 161 </para>
 162
 163 <para>
 164 If you are not running JunkBuster, then http://i.j.b/ will fail, and
 165 http://ijbswa.sourceforge.net/config/ will return a web page telling you
 166 you're not running JunkBuster.
 167 </para>
 168
 169 <para>
 170 If you have version 2.0.2, then the equivalent is
 171 http://example.com/show-proxy-args (but you get far less information, and you
 172 should really consider upgrading to 2.9.x).
 173 </para>
 174 </sect3>
 175
 176
 177 <sect3 id="badfiledesc"><title>I get the message 'Bad File Descriptor', why?</title>
 178 <para>
 179    Fillme.
 180 </para>
 181 </sect3>
 182
 183 <sect3 id="proxy-chaining"><title>How do I chain Junkbuster with other proxies
 184 (e.g. squid)?</title>
 185 <para>
 186    Fillme.
 187 </para>
 188 </sect3>
 189
 190 <sect3 id="jointeam"><title>I would like to help you, what do I do?</title>
 191 <para>
 192    Well, helping the team is always a good idea. We welcome new developers,
 193    RPM gurus or documentation makers. Simply get an account on sourceforge.net
 194    and mail your id to the developer mailing list. Once we have added you to
 195    the team, you'll have write access to the CVS repository, and we'll find a
 196    suitable task for you together.
 197 </para>
 198 </sect3>
 199
 200 <sect3 id="blocklist"><title>Do you still maintain the blocklists?</title>
 201 <para>
 202     No. The format of the blocklists has changed significantly in the versions
 203     2.9.x. Once we have released the new version, there will again be
 204     blocklists that you can update automatically.
 205 </para>
 206 </sect3>
 207
 208 <sect3 id="newads"><title>How can I submit new ads?</title>
 209 <para>
 210     As of now, please discontinue to submit new ad blocking infos. Once we
 211     have released the new version, there will again be a form on the website,
 212     which you can use to contribute new ads.
 213 </para>
 214 </sect3>
 215
 216 <sect3 id="ip"><title>How can I hide my IP address?</title>
 217 <para>
 218  You cannot hide your IP address with Junkbuster.
 219 </para>
 220 </sect3>
 221
 222 <sect3 id="image"><title>What is the imagefile (simage.ini, etc.) for?</title>
 223 <para>
 224  Anytime the Junkbuster determines (with the help of the blocklist) that a URL
 225  contains an advertisement, it has to decide whether this advertisement is an
 226  image or not. The Junkbuster uses the imagefile for that purpose.
 227 </para>
 228 </sect3>
 229
 230 </sect2>
 231
 232 </sect1>
 233
 234 <!--   ~~~~~       New section      ~~~~~     -->
 235 <sect1 id="contact"><title>Contact the developers</title>
 236 <para>Please see the user manual for information on how to contact the developers.
 237 </para>
 238 </sect1>
 239
 240 <!--   ~~~~~       New section      ~~~~~     -->
 241 <sect1 id="copyright"><title>Copyright and History</title>
 242 <para>Please see the user manual for information on Copyright and History.
 243 </para>
 244 </sect1>
 245
 246 <!--   ~~~~~       New section      ~~~~~     -->
 247 <sect1 id="seealso"><title>See also</title>
 248 <para>Please see the user manual for information on references.
 249 </para>
 250 </sect1>
 251
 252 <!-- hhmts end -->
 253  <!--
 254  Tue 09/11/01 06:38:14 PM EST: Test SGML doc by Hal Burgiss.
 255
 256  Last modified: Mon Sep 10 19:22:09 CEST 2001
 257
 258  This program is free software; you can redistribute it
 259  and/or modify it under the terms of the GNU General
 260  Public License as published by the Free Software
 261  Foundation; either version 2 of the License, or (at
 262  your option) any later version.
 263
 264  This program is distributed in the hope that it will
 265  be useful, but WITHOUT ANY WARRANTY; without even the
 266  implied warranty of MERCHANTABILITY or FITNESS FOR A
 267  PARTICULAR PURPOSE.  See the GNU General Public
 268  License for more details.
 269
 270  The GNU General Public License should be included with
 271  this file.  If not, you can view it at
 272  http://www.gnu.org/copyleft/gpl.html
 273  or write to the Free Software Foundation, Inc., 59
 274  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 275
 276 $Log: faq.sgml,v $
 277 Revision 1.6  2002/03/07 13:16:31  oes
 278 Committing changes by Stefan
 279
 280 Revision 1.5  2002/03/02 15:50:04  swa
 281 2.9.11 version. more input for docs.
 282
 283 Revision 1.4  2002/02/24 14:34:24  jongfoster
 284 Formatting changes.  Now changing the doctype to DocBook XML 4.1
 285 will work - no other changes are needed.
 286
 287 Revision 1.3  2001/09/23 10:13:48  swa
 288 upload process established. run make webserver and
 289 the documentation is moved to the webserver. documents
 290 are now linked correctly.
 291
 292 Revision 1.2  2001/09/13 15:20:17  swa
 293 merged standards into developer manual
 294
 295 Revision 1.1  2001/09/12 15:36:41  swa
 296 source files for junkbuster documentation
 297
 298 Revision 1.3  2001/09/10 17:43:59  swa
 299 first proposal of a structure.
 300
 301 Revision 1.2  2001/06/13 14:28:31  swa
 302 docs should have an author.
 303
 304 Revision 1.1  2001/06/13 14:20:37  swa
 305 first import of project's documentation for the webserver.
 306
 307 -->
 308
 309 </article>