generated
[privoxy.git] / doc / webserver / faq / general.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >General Information</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64
8 "><LINK
9 REL="HOME"
10 TITLE="Privoxy Frequently Asked Questions"
11 HREF="index.html"><LINK
12 REL="PREVIOUS"
13 TITLE="Privoxy Frequently Asked Questions"
14 HREF="index.html"><LINK
15 REL="NEXT"
16 TITLE="Installation"
17 HREF="installation.html"><LINK
18 REL="STYLESHEET"
19 TYPE="text/css"
20 HREF="../p_doc.css"></HEAD
21 ><BODY
22 CLASS="SECT1"
23 BGCOLOR="#EEEEEE"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 WIDTH="100%"
32 BORDER="0"
33 CELLPADDING="0"
34 CELLSPACING="0"
35 ><TR
36 ><TH
37 COLSPAN="3"
38 ALIGN="center"
39 >Privoxy Frequently Asked Questions</TH
40 ></TR
41 ><TR
42 ><TD
43 WIDTH="10%"
44 ALIGN="left"
45 VALIGN="bottom"
46 ><A
47 HREF="index.html"
48 >Prev</A
49 ></TD
50 ><TD
51 WIDTH="80%"
52 ALIGN="center"
53 VALIGN="bottom"
54 ></TD
55 ><TD
56 WIDTH="10%"
57 ALIGN="right"
58 VALIGN="bottom"
59 ><A
60 HREF="installation.html"
61 >Next</A
62 ></TD
63 ></TR
64 ></TABLE
65 ><HR
66 ALIGN="LEFT"
67 WIDTH="100%"></DIV
68 ><DIV
69 CLASS="SECT1"
70 ><H1
71 CLASS="SECT1"
72 ><A
73 NAME="GENERAL"
74 >1. General Information</A
75 ></H1
76 ><DIV
77 CLASS="SECT2"
78 ><H3
79 CLASS="SECT2"
80 ><A
81 NAME="NEWJB"
82 >1.1. What is this new version of <SPAN
83 CLASS="APPLICATION"
84 >Privoxy</SPAN
85 >?</A
86 ></H3
87 ><P
88 >  The original <SPAN
89 CLASS="APPLICATION"
90 ><SPAN
91 CLASS="TRADEMARK"
92 >Internet
93   Junkbuster</SPAN
94 >&trade;</SPAN
95 > (tm) is a copyrighted product of <A
96 HREF="http://www.junkbusters.com"
97 TARGET="_top"
98 >Junkbusters Corporation</A
99 >.
100   Development of this effort stopped some time ago as of version 2.0.2. Stefan
101   Waldherr started the ijbswa project on <A
102 HREF="http://sourceforge.net/projects/ijbswa/"
103 TARGET="_top"
104 >Sourceforge</A
105 > to
106   rekindle development. Other developers subsequently joined with Stefan, and
107   have since added many new features, refinements and enhancements. The result
108   of this effort is <SPAN
109 CLASS="APPLICATION"
110 >Privoxy</SPAN
111 >.
112  </P
113 ><P
114 >  <SPAN
115 CLASS="APPLICATION"
116 >Privoxy</SPAN
117 > has evolved from the 
118   <SPAN
119 CLASS="APPLICATION"
120 >Junkbuster 2.0.2</SPAN
121 > code base, and has advanced
122   significantly at this point. 
123  </P
124 ><P
125
126   Please see the <A
127 HREF="copyright.html"
128 >History section</A
129 > for more
130   information on the history of <SPAN
131 CLASS="APPLICATION"
132 >Junkbuster</SPAN
133 > and 
134   <SPAN
135 CLASS="APPLICATION"
136 >Privoxy</SPAN
137 >.
138  </P
139 ></DIV
140 ><DIV
141 CLASS="SECT2"
142 ><H3
143 CLASS="SECT2"
144 ><A
145 NAME="AEN42"
146 >1.2. Why <SPAN
147 CLASS="QUOTE"
148 >"Privoxy"</SPAN
149 >? Why a name change at all?</A
150 ></H3
151 ><P
152 > <SPAN
153 CLASS="APPLICATION"
154 >Privoxy</SPAN
155 > is the 
156  <SPAN
157 CLASS="QUOTE"
158 >"<I
159 CLASS="EMPHASIS"
160 >Privacy Enhancing Proxy</I
161 >"</SPAN
162 >.</P
163 ><P
164 > There are potential legal complications from the continued use of the 
165  <SPAN
166 CLASS="APPLICATION"
167 >Junkbuster</SPAN
168 > name, which is a registered trademark of 
169  <A
170 HREF="http://junkbusters.com"
171 TARGET="_top"
172 >Junkbusters Corporation</A
173 >.
174  And thus they <SPAN
175 CLASS="QUOTE"
176 >"own"</SPAN
177 > the rights to the name.
178  (There are, however, no objections from Junkbusters Corporation to the 
179  <SPAN
180 CLASS="APPLICATION"
181 >Privoxy</SPAN
182 > project itself, and they, in fact, still
183  share our ideals and goals.)</P
184 ><P
185 > The developers also believed that there are so many changes from the original 
186  code, that it was time to make a clean break from the past and make 
187  a name in their own right, especially now with the pending
188  release of version 3.0.</P
189 ></DIV
190 ><DIV
191 CLASS="SECT2"
192 ><H3
193 CLASS="SECT2"
194 ><A
195 NAME="DIFFERS"
196 >1.3. How does <SPAN
197 CLASS="APPLICATION"
198 >Privoxy</SPAN
199 > differ
200 from the old <SPAN
201 CLASS="APPLICATION"
202 >Junkbuster?</SPAN
203 ></A
204 ></H3
205 ><P
206 >  <SPAN
207 CLASS="APPLICATION"
208 >Privoxy</SPAN
209 > picks up where
210   <SPAN
211 CLASS="APPLICATION"
212 >Junkbuster</SPAN
213 > left off. All the old features remain.
214   The new <SPAN
215 CLASS="APPLICATION"
216 >Privoxy</SPAN
217 > still blocks ads and banners,
218   still manages cookies, and still helps protect your privacy. But, these are
219   all enhanced, and many new features have been added, all in the same vein.
220  </P
221 ><P
222 >  The configuration has changed significantly as well. This is something that
223   users will notice right off the bat if you are upgrading from 
224   <SPAN
225 CLASS="APPLICATION"
226 >Junkbuster</SPAN
227 > 2.0.x. The <SPAN
228 CLASS="QUOTE"
229 >"blocklist"</SPAN
230 >
231   file does not exist any more. This is replaced by <SPAN
232 CLASS="QUOTE"
233 >"actions"</SPAN
234 >
235   files, such as <TT
236 CLASS="FILENAME"
237 >default.actions</TT
238 >. This is where most of
239   the per site configuration is now.
240  </P
241 ></DIV
242 ><DIV
243 CLASS="SECT2"
244 ><H3
245 CLASS="SECT2"
246 ><A
247 NAME="FEATURES"
248 >1.4. What are some of the new features?</A
249 ></H3
250 ><P
251 > <P
252 ></P
253 ><UL
254 ><LI
255 ><P
256 >  FIXME: complete the list of features. change the order: most important
257   features to the top of the list. prefix new features with "NEW".
258   </P
259 ></LI
260 ><LI
261 ><P
262 >   Integrated browser based configuration and control utility at <A
263 HREF="http://config.privoxy.org/"
264 TARGET="_top"
265 >http://config.privoxy.org/</A
266 >
267    (shortcut: <A
268 HREF="http://p.p/"
269 TARGET="_top"
270 >http://p.p/</A
271 >). Browser-based
272    tracing of rule and filter effects. Remote toggling.
273   </P
274 ></LI
275 ><LI
276 ><P
277 >    Blocking of annoying pop-up browser windows.
278   </P
279 ></LI
280 ><LI
281 ><P
282 >   HTTP/1.1 compliant (but not all optional 1.1 features are supported).
283   </P
284 ></LI
285 ><LI
286 ><P
287 >   Support for Perl Compatible Regular Expressions in the configuration files, and 
288    generally a more sophisticated and flexible configuration syntax over
289    previous versions. 
290   </P
291 ></LI
292 ><LI
293 ><P
294 >   GIF de-animation. 
295   </P
296 ></LI
297 ><LI
298 ><P
299 >   Web page content filtering (removes banners based on size,
300    invisible <SPAN
301 CLASS="QUOTE"
302 >"web-bugs"</SPAN
303 >, JavaScript and HTML annoyances, pop-ups, etc.)
304   </P
305 ></LI
306 ><LI
307 ><P
308 >   Bypass many click-tracking scripts (avoids script redirection).
309   </P
310 ></LI
311 ><LI
312 ><P
313 >   Multi-threaded (POSIX and native threads).
314   </P
315 ></LI
316 ><LI
317 ><P
318 >   Auto-detection and re-reading of config file changes.
319   </P
320 ></LI
321 ><LI
322 ><P
323 >   User-customizable HTML templates (e.g. 404 error page).
324   </P
325 ></LI
326 ><LI
327 ><P
328 >   Improved cookie management features (e.g. session based cookies).
329   </P
330 ></LI
331 ><LI
332 ><P
333 >   Improved signal handling, and a true daemon mode (Unix).
334   </P
335 ></LI
336 ><LI
337 ><P
338 >   Every feature now controllable on a per-site or per-location basis, configuration
339    more powerful and versatile over-all.
340   </P
341 ></LI
342 ><LI
343 ><P
344 >   Many smaller new features added, limitations and bugs removed, and security holes fixed.
345   </P
346 ></LI
347 ></UL
348 ></P
349 ></DIV
350 ><DIV
351 CLASS="SECT2"
352 ><H3
353 CLASS="SECT2"
354 ><A
355 NAME="PROXYMORON"
356 >1.5. What is a <SPAN
357 CLASS="QUOTE"
358 >"proxy"</SPAN
359 >? How does
360 <SPAN
361 CLASS="APPLICATION"
362 >Privoxy</SPAN
363 > work?</A
364 ></H3
365 ><P
366 >  When you connect to a web site with <SPAN
367 CLASS="APPLICATION"
368 >Privoxy</SPAN
369 >, 
370   you are really connecting to your locally running version of 
371   <SPAN
372 CLASS="APPLICATION"
373 >Privoxy</SPAN
374 >. <SPAN
375 CLASS="APPLICATION"
376 >Privoxy</SPAN
377 >
378   intercepts your requests for the web page, and relays that to the 
379   <SPAN
380 CLASS="QUOTE"
381 >"real"</SPAN
382 > web site. The web site sends the HTTP data stream 
383   back to <SPAN
384 CLASS="APPLICATION"
385 >Privoxy</SPAN
386 >, where
387   <SPAN
388 CLASS="APPLICATION"
389 >Privoxy</SPAN
390 > can work its magic before it 
391   relays this data back to your web browser.
392  </P
393 ><P
394 >  Since <SPAN
395 CLASS="APPLICATION"
396 >Privoxy</SPAN
397 > sits between you and the 
398   WWW, it is in a position to intercept and completely manage all web traffic and 
399   HTTP content before it gets to your browser.
400   <SPAN
401 CLASS="APPLICATION"
402 >Privoxy</SPAN
403 > uses various programming methods to do
404   this, all of which is under your control via the various configuration
405   files and options.
406  </P
407 ><P
408 >  There are many kinds of proxies. <SPAN
409 CLASS="APPLICATION"
410 >Privoxy</SPAN
411 > best 
412   fits the <SPAN
413 CLASS="QUOTE"
414 >"filtering proxy"</SPAN
415 > category.
416  </P
417 ></DIV
418 ><DIV
419 CLASS="SECT2"
420 ><H3
421 CLASS="SECT2"
422 ><A
423 NAME="AEN122"
424 >1.6. How does <SPAN
425 CLASS="APPLICATION"
426 >Privoxy</SPAN
427 > know what is
428 an ad, and what is not?</A
429 ></H3
430 ><P
431 > <SPAN
432 CLASS="APPLICATION"
433 >Privoxy</SPAN
434 > processes all the raw content of every 
435  web page. So it reads everything on each page. It then compares this to the
436  rules as set up in the configuration files, and looks for any matches to
437  these rules. <SPAN
438 CLASS="APPLICATION"
439 >Privoxy</SPAN
440 > makes heavy use of
441  <SPAN
442 CLASS="QUOTE"
443 >"regular expressions"</SPAN
444 >. (If you are not familiar with regular
445  expressions, it is explained briefly in <A
446 HREF="../user-manual/appendix.html"
447 TARGET="_top"
448 >the user manual</A
449 >.) Regular
450  expressions facilitate matching of one text string against another, using
451  wildcards to build complex patterns. So <SPAN
452 CLASS="APPLICATION"
453 >Privoxy</SPAN
454 >
455  will typically look for URLs and other content that match certain key words
456  and expressions as defined in the configuration files. For instance a URL
457  that contains <SPAN
458 CLASS="QUOTE"
459 >"/banners"</SPAN
460 >, has a high probability of containing
461  ad banners, and thus would be a prime candidate to have a matching rule.</P
462 ><P
463 > So <SPAN
464 CLASS="APPLICATION"
465 >Privoxy</SPAN
466 > will look for these kinds of obvious 
467  looking culprits. And also, will use lists of known organizations that
468  specialize in ads. Again, using complex patterns to match as many potential 
469  combinations as possible since there tend to be many, many variations used by 
470  advertisers, and new ones are being introduced all the time.</P
471 ></DIV
472 ><DIV
473 CLASS="SECT2"
474 ><H3
475 CLASS="SECT2"
476 ><A
477 NAME="AEN134"
478 >1.7. Can <SPAN
479 CLASS="APPLICATION"
480 >Privoxy</SPAN
481 > make mistakes? 
482 This does not sound very scientific.</A
483 ></H3
484 ><P
485 > Actually, it's a black art ;-) And yes, it is always possible to have a broad rule
486  accidentally block something by mistake. There is a good chance you may run 
487  into such a situation at some point. It is tricky writing rules to cover
488  every conceivable possibility, and not occasionally get false positives.</P
489 ><P
490 > But this should not be a big concern since the
491  <SPAN
492 CLASS="APPLICATION"
493 >Privoxy</SPAN
494 > configuration is very flexible, and
495  includes tools to help identify these types of situations so they can be
496  addressed as needed, allowing you to customize your installation.
497  (<A
498 HREF="trouble.html#AEN555"
499 >See the Troubleshooting section below</A
500 >.)</P
501 ></DIV
502 ><DIV
503 CLASS="SECT2"
504 ><H3
505 CLASS="SECT2"
506 ><A
507 NAME="BROWSERS2"
508 >1.8. My browser does the same things as
509 <SPAN
510 CLASS="APPLICATION"
511 >Privoxy</SPAN
512 >. Why should I use
513 <SPAN
514 CLASS="APPLICATION"
515 >Privoxy</SPAN
516 > at all?</A
517 ></H3
518 ><P
519 >  Modern browsers do indeed have <I
520 CLASS="EMPHASIS"
521 >some</I
522 > of the same
523   functionality as <SPAN
524 CLASS="APPLICATION"
525 >Privoxy</SPAN
526 >. Maybe this is
527   adequate for you. But <SPAN
528 CLASS="APPLICATION"
529 >Privoxy</SPAN
530 > is much more
531   versatile and powerful, and can do a number of things that browsers just can't.
532  </P
533 ><P
534 >  In addition, a proxy is good choice if you use multiple browsers, or 
535   have a LAN with multiple computers. This way all the configuration 
536   is in one place, and you don't have to maintain a similar configuration 
537   for possibly many browsers.
538
539  </P
540 ></DIV
541 ><DIV
542 CLASS="SECT2"
543 ><H3
544 CLASS="SECT2"
545 ><A
546 NAME="LICENSE"
547 >1.9. Is there is a license or fee? What about a 
548 warranty? Registration?</A
549 ></H3
550 ><P
551 >  <SPAN
552 CLASS="APPLICATION"
553 >Privoxy</SPAN
554 > is licensed under the GNU General Public
555   License (GPL). It is free to use, copy, modify or distribute as you wish
556   under the terms of this license.  Please see the Copyright section for more
557   information on the license and copyright.
558
559   </P
560 ><P
561 >  There is no warranty of any kind, expressed, implied or otherwise. That is
562   something that would cost real money ;-) There is no registration either.
563   <SPAN
564 CLASS="APPLICATION"
565 >Privoxy</SPAN
566 > really is <I
567 CLASS="EMPHASIS"
568 >free</I
569 >
570   in every respect!
571
572  </P
573 ></DIV
574 ><DIV
575 CLASS="SECT2"
576 ><H3
577 CLASS="SECT2"
578 ><A
579 NAME="JOINTEAM"
580 >1.10. I would like to help you, what do I do?</A
581 ></H3
582 ><DIV
583 CLASS="SECT3"
584 ><H4
585 CLASS="SECT3"
586 ><A
587 NAME="JOINTEAM-MONEY"
588 >1.10.1. Money Money Money</A
589 ></H4
590 ><P
591 > We, of course, welcome donations and use the money for domain registering,
592  regular world-wide get-togethers (hahaha). Anyway, we'll soon describe the
593  process how to donate money to the team.</P
594 ></DIV
595 ><DIV
596 CLASS="SECT3"
597 ><H4
598 CLASS="SECT3"
599 ><A
600 NAME="JOINTEAM-WORK"
601 >1.10.2. You want to work with us?</A
602 ></H4
603 ><P
604 >   Well, helping the team is always a good idea. We welcome new developers,
605    RPM gurus or documentation makers. Simply get an account on sourceforge.net
606    and mail your id to the developer mailing list. Then read the
607    section Quickstart in the <A
608 HREF="../developer-manual/quickstart.html"
609 TARGET="_top"
610 >   Developer's Manual</A
611 >.</P
612 ><P
613 > Once we have added you to the team, you'll have write access to the CVS
614  repository, and together we'll find a suitable task for you.</P
615 ></DIV
616 ></DIV
617 ></DIV
618 ><DIV
619 CLASS="NAVFOOTER"
620 ><HR
621 ALIGN="LEFT"
622 WIDTH="100%"><TABLE
623 WIDTH="100%"
624 BORDER="0"
625 CELLPADDING="0"
626 CELLSPACING="0"
627 ><TR
628 ><TD
629 WIDTH="33%"
630 ALIGN="left"
631 VALIGN="top"
632 ><A
633 HREF="index.html"
634 >Prev</A
635 ></TD
636 ><TD
637 WIDTH="34%"
638 ALIGN="center"
639 VALIGN="top"
640 ><A
641 HREF="index.html"
642 >Home</A
643 ></TD
644 ><TD
645 WIDTH="33%"
646 ALIGN="right"
647 VALIGN="top"
648 ><A
649 HREF="installation.html"
650 >Next</A
651 ></TD
652 ></TR
653 ><TR
654 ><TD
655 WIDTH="33%"
656 ALIGN="left"
657 VALIGN="top"
658 >Privoxy Frequently Asked Questions</TD
659 ><TD
660 WIDTH="34%"
661 ALIGN="center"
662 VALIGN="top"
663 >&nbsp;</TD
664 ><TD
665 WIDTH="33%"
666 ALIGN="right"
667 VALIGN="top"
668 >Installation</TD
669 ></TR
670 ></TABLE
671 ></DIV
672 ></BODY
673 ></HTML
674 >