updated.
[privoxy.git] / doc / text / faq.txt
1
2 Junkbuster Frequently Asked Questions
3
4    By: Junkbuster Developers
5    
6    $Id: faq.sgml,v 1.7 2002/03/07 18:16:55 swa Exp $
7    
8    The FAQ document gives users and developers alike answers to
9    frequently asked questions about the Internet Junkbuster. The Internet
10    Junkbuster is an application that provides privacy and security to the
11    user of the world wide web.
12    
13    You can find the latest version of the document at
14    [1]http://ijbswa.sourceforge.net/faq/. Please see the Contact section
15    in the user-manual if you want to contact the developers.
16    
17    Feel free to send a note to the developers at
18    <[2]ijbswa-developers@lists.sourceforge.net>.
19      _________________________________________________________________
20    
21    Table of Contents
22    1. [3]Introduction
23    2. [4]Frequently Asked Questions
24           
25         2.1. [5]Installation
26         2.2. [6]Configuration
27                 
28               2.2.1. [7]How can I make my Yahoo account work?
29               2.2.2. [8]How can I make my Hotmail account work?
30               2.2.3. [9]How can I make my GMX account work?
31               2.2.4. [10]Why can I change the configuration with a
32                       browser? Does that not raise security issues?
33                       
34         2.3. [11]Misc
35                 
36               2.3.1. [12]I noticed considerable delays in page requests
37                       compared to the old IJB. What's wrong?
38                       
39               2.3.2. [13]What is the "http://i.j.b/"?
40               2.3.3. [14]I get the message 'Bad File Descriptor', why?
41               2.3.4. [15]How do I chain Junkbuster with other proxies
42                       (e.g. squid)?
43                       
44               2.3.5. [16]I would like to help you, what do I do?
45               2.3.6. [17]Do you still maintain the blocklists?
46               2.3.7. [18]How can I submit new ads?
47               2.3.8. [19]How can I hide my IP address?
48               2.3.9. [20]What is the imagefile (simage.ini, etc.) for?
49                       
50    3. [21]Contact the developers
51    4. [22]Copyright and History
52    5. [23]See also
53           
54 1. Introduction
55
56    Fillme.
57      _________________________________________________________________
58    
59 2. Frequently Asked Questions
60
61 2.1. Installation
62
63    Fillme.
64      _________________________________________________________________
65    
66 2.2. Configuration
67
68 2.2.1. How can I make my Yahoo account work?
69
70    Fillme.
71      _________________________________________________________________
72    
73 2.2.2. How can I make my Hotmail account work?
74
75    Fillme.
76      _________________________________________________________________
77    
78 2.2.3. How can I make my GMX account work?
79
80    Fillme.
81      _________________________________________________________________
82    
83 2.2.4. Why can I change the configuration with a browser? Does that not
84 raise security issues?
85
86    What I don't understand, is how I can browser edit the config file as
87    a regular user, while the whole /etc/junkbuster hierarchy belongs to
88    the user "junkbuster", with only 644 perms.
89    
90    When you use the browser-based editor, JunkBuster itself is writing to
91    the config files. Because JunkBuster is running as the user
92    "junkbuster", it can update the config files.
93    
94    If you don't like this, setting "enable-edit-actions 0" in the config
95    file will disable the browser-based editor. If you're that paranoid,
96    you should also consider setting "enable-remote-toggle 0" to prevent
97    browser-based enabling/disabling of JunkBuster.
98    
99    Note that normally only local users can connect to JunkBuster, so this
100    is not (normally) a security problem.
101      _________________________________________________________________
102    
103 2.3. Misc
104
105 2.3.1. I noticed considerable delays in page requests compared to the old
106 IJB. What's wrong?
107
108    Using the default filtering configuration, I noticed considerable
109    delays in page requests compared to the old IJB. Loading pages with
110    large contents seemed to take forever, then suddenly delivering all
111    the content at once.
112    
113    The whole content must be loaded in order to filter, and nothing is is
114    sent to the browser during this time. The loading time does not really
115    change in real numbers, but the feeling is different, because most
116    browsers are able to start rendering incomplete content, giving the
117    user a feeling of "it works".
118    
119    To modify the content of a page (i.e. make frames resizeable again,
120    etc.) and not just replace ads, the Internet Junkbuster needs to
121    download the entire page first, do its content magic and then send the
122    page to the browser.
123      _________________________________________________________________
124    
125 2.3.2. What is the "http://i.j.b/"?
126
127    Since JunkBuster sits between your web browser and the Internet, it
128    can be programmed to handle certain pages specially.
129    
130    With recent versions of JunkBuster (version 2.9.x), you can get some
131    information about JunkBuster and change some settings by going to
132    http://i.j.b/ or, equivalently, http://ijbswa.sourceforge.net/config/
133    (Note that i.j.b is far easier to type but may not work in some
134    configurations).
135    
136    These pages are *not* forwarded to a server on the internet - instead
137    they are handled by a special web server which is built in to
138    JunkBuster.
139    
140    If you are not running JunkBuster, then http://i.j.b/ will fail, and
141    http://ijbswa.sourceforge.net/config/ will return a web page telling
142    you you're not running JunkBuster.
143    
144    If you have version 2.0.2, then the equivalent is
145    http://example.com/show-proxy-args (but you get far less information,
146    and you should really consider upgrading to 2.9.x).
147      _________________________________________________________________
148    
149 2.3.3. I get the message 'Bad File Descriptor', why?
150
151    Fillme.
152      _________________________________________________________________
153    
154 2.3.4. How do I chain Junkbuster with other proxies (e.g. squid)?
155
156    Fillme.
157      _________________________________________________________________
158    
159 2.3.5. I would like to help you, what do I do?
160
161    Well, helping the team is always a good idea. We welcome new
162    developers, RPM gurus or documentation makers. Simply get an account
163    on sourceforge.net and mail your id to the developer mailing list.
164    Once we have added you to the team, you'll have write access to the
165    CVS repository, and we'll find a suitable task for you together.
166      _________________________________________________________________
167    
168 2.3.6. Do you still maintain the blocklists?
169
170    No. The format of the blocklists has changed significantly in the
171    versions 2.9.x. Once we have released the new version, there will
172    again be blocklists that you can update automatically.
173      _________________________________________________________________
174    
175 2.3.7. How can I submit new ads?
176
177    As of now, please discontinue to submit new ad blocking infos. Once we
178    have released the new version, there will again be a form on the
179    website, which you can use to contribute new ads.
180      _________________________________________________________________
181    
182 2.3.8. How can I hide my IP address?
183
184    You cannot hide your IP address with Junkbuster.
185      _________________________________________________________________
186    
187 2.3.9. What is the imagefile (simage.ini, etc.) for?
188
189    Anytime the Junkbuster determines (with the help of the blocklist)
190    that a URL contains an advertisement, it has to decide whether this
191    advertisement is an image or not. The Junkbuster uses the imagefile
192    for that purpose.
193      _________________________________________________________________
194    
195 3. Contact the developers
196
197    Please see the user manual for information on how to contact the
198    developers.
199      _________________________________________________________________
200    
201 4. Copyright and History
202
203    Please see the user manual for information on Copyright and History.
204      _________________________________________________________________
205    
206 5. See also
207
208    Please see the user manual for information on references.
209
210 References
211
212    1. http://ijbswa.sourceforge.net/faq/
213    2. mailto:ijbswa-developers@lists.sourceforge.net
214    3. file://localhost/home/swa/sf/current/doc/source/tmp.html#INTRODUCTION
215    4. file://localhost/home/swa/sf/current/doc/source/tmp.html#QUESTIONS
216    5. file://localhost/home/swa/sf/current/doc/source/tmp.html#INSTALLATION
217    6. file://localhost/home/swa/sf/current/doc/source/tmp.html#CONFIGURATION
218    7. file://localhost/home/swa/sf/current/doc/source/tmp.html#YAHOO
219    8. file://localhost/home/swa/sf/current/doc/source/tmp.html#HOTMAIL
220    9. file://localhost/home/swa/sf/current/doc/source/tmp.html#GMX
221   10. file://localhost/home/swa/sf/current/doc/source/tmp.html#BROWSECONFIG
222   11. file://localhost/home/swa/sf/current/doc/source/tmp.html#MISC
223   12. file://localhost/home/swa/sf/current/doc/source/tmp.html#LOADINGTIMES
224   13. file://localhost/home/swa/sf/current/doc/source/tmp.html#CONFIGURL
225   14. file://localhost/home/swa/sf/current/doc/source/tmp.html#BADFILEDESC
226   15. file://localhost/home/swa/sf/current/doc/source/tmp.html#PROXY-CHAINING
227   16. file://localhost/home/swa/sf/current/doc/source/tmp.html#JOINTEAM
228   17. file://localhost/home/swa/sf/current/doc/source/tmp.html#BLOCKLIST
229   18. file://localhost/home/swa/sf/current/doc/source/tmp.html#NEWADS
230   19. file://localhost/home/swa/sf/current/doc/source/tmp.html#IP
231   20. file://localhost/home/swa/sf/current/doc/source/tmp.html#IMAGE
232   21. file://localhost/home/swa/sf/current/doc/source/tmp.html#CONTACT
233   22. file://localhost/home/swa/sf/current/doc/source/tmp.html#COPYRIGHT
234   23. file://localhost/home/swa/sf/current/doc/source/tmp.html#SEEALSO