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