doc/webserver/user-manual/config.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >The Main Configuration File</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
   8 REL="HOME"
   9 TITLE="Privoxy User Manual"
  10 HREF="index.html"><LINK
  11 REL="PREVIOUS"
  12 TITLE="Privoxy Configuration"
  13 HREF="configuration.html"><LINK
  14 REL="NEXT"
  15 TITLE="Actions Files"
  16 HREF="actions-file.html"><LINK
  17 REL="STYLESHEET"
  18 TYPE="text/css"
  19 HREF="../p_doc.css"></HEAD
  20 ><BODY
  21 CLASS="SECT1"
  22 BGCOLOR="#EEEEEE"
  23 TEXT="#000000"
  24 LINK="#0000FF"
  25 VLINK="#840084"
  26 ALINK="#0000FF"
  27 ><DIV
  28 CLASS="NAVHEADER"
  29 ><TABLE
  30 WIDTH="100%"
  31 BORDER="0"
  32 CELLPADDING="0"
  33 CELLSPACING="0"
  34 ><TR
  35 ><TH
  36 COLSPAN="3"
  37 ALIGN="center"
  38 >Privoxy User Manual</TH
  39 ></TR
  40 ><TR
  41 ><TD
  42 WIDTH="10%"
  43 ALIGN="left"
  44 VALIGN="bottom"
  45 ><A
  46 HREF="configuration.html"
  47 >Prev</A
  48 ></TD
  49 ><TD
  50 WIDTH="80%"
  51 ALIGN="center"
  52 VALIGN="bottom"
  53 ></TD
  54 ><TD
  55 WIDTH="10%"
  56 ALIGN="right"
  57 VALIGN="bottom"
  58 ><A
  59 HREF="actions-file.html"
  60 >Next</A
  61 ></TD
  62 ></TR
  63 ></TABLE
  64 ><HR
  65 ALIGN="LEFT"
  66 WIDTH="100%"></DIV
  67 ><DIV
  68 CLASS="SECT1"
  69 ><H1
  70 CLASS="SECT1"
  71 ><A
  72 NAME="CONFIG"
  73 >7. The Main Configuration File</A
  74 ></H1
  75 ><P
  76 > Again, the main configuration file is named <TT
  77 CLASS="FILENAME"
  78 >config</TT
  79 > on
  80  Linux/Unix/BSD and OS/2, and <TT
  81 CLASS="FILENAME"
  82 >config.txt</TT
  83 > on Windows.
  84  Configuration lines consist of an initial keyword followed by a list of
  85  values, all separated by whitespace (any number of spaces or tabs). For
  86  example:</P
  87 ><P
  88 > <TT
  89 CLASS="LITERAL"
  90 >  <P
  91 CLASS="LITERALLAYOUT"
  92 >&nbsp;&nbsp;<I
  93 CLASS="EMPHASIS"
  94 >confdir /etc/privoxy</I
  95 ></P
  96 >
  97  </TT
  98 > </P
  99 ><P
 100 > Assigns the value <TT
 101 CLASS="LITERAL"
 102 >/etc/privoxy</TT
 103 > to the option
 104  <TT
 105 CLASS="LITERAL"
 106 >confdir</TT
 107 > and thus indicates that the configuration
 108  directory is named <SPAN
 109 CLASS="QUOTE"
 110 >"/etc/privoxy/"</SPAN
 111 >.</P
 112 ><P
 113 > All options in the config file except for <TT
 114 CLASS="LITERAL"
 115 >confdir</TT
 116 > and
 117  <TT
 118 CLASS="LITERAL"
 119 >logdir</TT
 120 > are optional. Watch out in the below description
 121  for what happens if you leave them unset.</P
 122 ><P
 123 > The main config file controls all aspects of <SPAN
 124 CLASS="APPLICATION"
 125 >Privoxy</SPAN
 126 >'s
 127  operation that are not location dependent (i.e. they apply universally, no matter
 128  where you may be surfing).</P
 129 ><DIV
 130 CLASS="SECT2"
 131 ><H2
 132 CLASS="SECT2"
 133 ><A
 134 NAME="CONF-LOG-LOC"
 135 >7.1. Configuration and Log File Locations</A
 136 ></H2
 137 ><P
 138 > <SPAN
 139 CLASS="APPLICATION"
 140 >Privoxy</SPAN
 141 > can (and normally does) use a number of
 142  other files for additional configuration, help and logging.
 143  This section of the configuration file tells <SPAN
 144 CLASS="APPLICATION"
 145 >Privoxy</SPAN
 146 >
 147  where to find those other files. </P
 148 ><P
 149 > The user running Privoxy, must have read permission for all
 150  configuration files, and write permission to any files that would
 151  be modified, such as log files.</P
 152 ><DIV
 153 CLASS="SECT3"
 154 ><H4
 155 CLASS="SECT3"
 156 ><A
 157 NAME="CONFDIR"
 158 >7.1.1. confdir</A
 159 ></H4
 160 ><P
 161 ></P
 162 ><DIV
 163 CLASS="VARIABLELIST"
 164 ><DL
 165 ><DT
 166 >Specifies:</DT
 167 ><DD
 168 ><P
 169 >The directory where the other configuration files are located</P
 170 ></DD
 171 ><DT
 172 >Type of value:</DT
 173 ><DD
 174 ><P
 175 >Path name</P
 176 ></DD
 177 ><DT
 178 >Default value:</DT
 179 ><DD
 180 ><P
 181 >/etc/privoxy (Unix) <I
 182 CLASS="EMPHASIS"
 183 >or</I
 184 > <SPAN
 185 CLASS="APPLICATION"
 186 >Privoxy</SPAN
 187 > installation dir (Windows) </P
 188 ></DD
 189 ><DT
 190 >Effect if unset:</DT
 191 ><DD
 192 ><P
 193 ><I
 194 CLASS="EMPHASIS"
 195 >Mandatory</I
 196 ></P
 197 ></DD
 198 ><DT
 199 >Notes:</DT
 200 ><DD
 201 ><P
 202 >    No trailing <SPAN
 203 CLASS="QUOTE"
 204 >"<TT
 205 CLASS="LITERAL"
 206 >/</TT
 207 >"</SPAN
 208 >, please
 209    </P
 210 ><P
 211 >    When development goes modular and multi-user, the blocker, filter, and
 212     per-user config will be stored in subdirectories of <SPAN
 213 CLASS="QUOTE"
 214 >"confdir"</SPAN
 215 >.
 216     For now, the configuration directory structure is flat, except for
 217     <TT
 218 CLASS="FILENAME"
 219 >confdir/templates</TT
 220 >, where the HTML templates for CGI
 221     output reside (e.g. <SPAN
 222 CLASS="APPLICATION"
 223 >Privoxy's</SPAN
 224 > 404 error page).
 225    </P
 226 ></DD
 227 ></DL
 228 ></DIV
 229 ></DIV
 230 ><DIV
 231 CLASS="SECT3"
 232 ><H4
 233 CLASS="SECT3"
 234 ><A
 235 NAME="LOGDIR"
 236 >7.1.2. logdir</A
 237 ></H4
 238 ><P
 239 ></P
 240 ><DIV
 241 CLASS="VARIABLELIST"
 242 ><DL
 243 ><DT
 244 >Specifies:</DT
 245 ><DD
 246 ><P
 247 >    The directory where all logging takes place (i.e. where <TT
 248 CLASS="FILENAME"
 249 >logfile</TT
 250 > and
 251     <TT
 252 CLASS="FILENAME"
 253 >jarfile</TT
 254 > are located)
 255    </P
 256 ></DD
 257 ><DT
 258 >Type of value:</DT
 259 ><DD
 260 ><P
 261 >Path name</P
 262 ></DD
 263 ><DT
 264 >Default value:</DT
 265 ><DD
 266 ><P
 267 >/var/log/privoxy (Unix) <I
 268 CLASS="EMPHASIS"
 269 >or</I
 270 > <SPAN
 271 CLASS="APPLICATION"
 272 >Privoxy</SPAN
 273 > installation dir (Windows) </P
 274 ></DD
 275 ><DT
 276 >Effect if unset:</DT
 277 ><DD
 278 ><P
 279 ><I
 280 CLASS="EMPHASIS"
 281 >Mandatory</I
 282 ></P
 283 ></DD
 284 ><DT
 285 >Notes:</DT
 286 ><DD
 287 ><P
 288 >    No trailing <SPAN
 289 CLASS="QUOTE"
 290 >"<TT
 291 CLASS="LITERAL"
 292 >/</TT
 293 >"</SPAN
 294 >, please
 295    </P
 296 ></DD
 297 ></DL
 298 ></DIV
 299 ></DIV
 300 ><DIV
 301 CLASS="SECT3"
 302 ><H4
 303 CLASS="SECT3"
 304 ><A
 305 NAME="ACTIONSFILE"
 306 >7.1.3. actionsfile</A
 307 ></H4
 308 ><A
 309 NAME="DEFAULT.ACTION"
 310 ></A
 311 ><A
 312 NAME="STANDARD.ACTION"
 313 ></A
 314 ><A
 315 NAME="USER.ACTION"
 316 ></A
 317 ><P
 318 ></P
 319 ><DIV
 320 CLASS="VARIABLELIST"
 321 ><DL
 322 ><DT
 323 >Specifies:</DT
 324 ><DD
 325 ><P
 326 >    The <A
 327 HREF="actions-file.html"
 328 >actions file(s)</A
 329 > to use
 330    </P
 331 ></DD
 332 ><DT
 333 >Type of value:</DT
 334 ><DD
 335 ><P
 336 >File name, relative to <TT
 337 CLASS="LITERAL"
 338 >confdir</TT
 339 >, without the <TT
 340 CLASS="LITERAL"
 341 >.action</TT
 342 > suffix</P
 343 ></DD
 344 ><DT
 345 >Default values:</DT
 346 ><DD
 347 ><P
 348 ></P
 349 ><TABLE
 350 BORDER="0"
 351 ><TBODY
 352 ><TR
 353 ><TD
 354 >     <P
 355 CLASS="LITERALLAYOUT"
 356 >&nbsp;&nbsp;standard&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Internal&nbsp;purposes,&nbsp;no&nbsp;editing&nbsp;recommended</P
 357 >
 358     </TD
 359 ></TR
 360 ><TR
 361 ><TD
 362 >     <P
 363 CLASS="LITERALLAYOUT"
 364 >&nbsp;&nbsp;default&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Main&nbsp;actions&nbsp;file</P
 365 >
 366     </TD
 367 ></TR
 368 ><TR
 369 ><TD
 370 >     <P
 371 CLASS="LITERALLAYOUT"
 372 >&nbsp;&nbsp;user&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;User&nbsp;customizations</P
 373 >
 374     </TD
 375 ></TR
 376 ></TBODY
 377 ></TABLE
 378 ><P
 379 ></P
 380 ></DD
 381 ><DT
 382 >Effect if unset:</DT
 383 ><DD
 384 ><P
 385 >    No actions are taken at all. Simple neutral proxying.
 386    </P
 387 ></DD
 388 ><DT
 389 >Notes:</DT
 390 ><DD
 391 ><P
 392 >    Multiple <TT
 393 CLASS="LITERAL"
 394 >actionsfile</TT
 395 > lines are permitted, and are in fact recommended!
 396    </P
 397 ><P
 398 >
 399     The default values include standard.action, which is used for internal
 400     purposes and should be loaded, default.action, which is the
 401     <SPAN
 402 CLASS="QUOTE"
 403 >"main"</SPAN
 404 > actions file maintained by the developers, and
 405     <TT
 406 CLASS="FILENAME"
 407 >user.action</TT
 408 >, where you can make your personal additions.
 409    </P
 410 ><P
 411 >
 412     Actions files are where all the per site and per URL configuration is done for
 413     ad blocking, cookie management, privacy considerations, etc.
 414     There is no point in using <SPAN
 415 CLASS="APPLICATION"
 416 >Privoxy</SPAN
 417 > without at
 418     least one actions file.
 419    </P
 420 ></DD
 421 ></DL
 422 ></DIV
 423 ></DIV
 424 ><DIV
 425 CLASS="SECT3"
 426 ><H4
 427 CLASS="SECT3"
 428 ><A
 429 NAME="FILTERFILE"
 430 >7.1.4. filterfile</A
 431 ></H4
 432 ><A
 433 NAME="DEFAULT.FILTER"
 434 ></A
 435 ><P
 436 ></P
 437 ><DIV
 438 CLASS="VARIABLELIST"
 439 ><DL
 440 ><DT
 441 >Specifies:</DT
 442 ><DD
 443 ><P
 444 >    The <A
 445 HREF="filter-file.html"
 446 >filter file</A
 447 > to use
 448    </P
 449 ></DD
 450 ><DT
 451 >Type of value:</DT
 452 ><DD
 453 ><P
 454 >File name, relative to <TT
 455 CLASS="LITERAL"
 456 >confdir</TT
 457 ></P
 458 ></DD
 459 ><DT
 460 >Default value:</DT
 461 ><DD
 462 ><P
 463 >default.filter (Unix) <I
 464 CLASS="EMPHASIS"
 465 >or</I
 466 > default.filter.txt (Windows)</P
 467 ></DD
 468 ><DT
 469 >Effect if unset:</DT
 470 ><DD
 471 ><P
 472 >    No textual content filtering takes place, i.e. all
 473     <TT
 474 CLASS="LITERAL"
 475 >+<A
 476 HREF="actions-file.html#FILTER"
 477 >filter</A
 478 >{<TT
 479 CLASS="REPLACEABLE"
 480 ><I
 481 >name</I
 482 ></TT
 483 >}</TT
 484 >
 485     actions in the actions files are turned neutral.
 486    </P
 487 ></DD
 488 ><DT
 489 >Notes:</DT
 490 ><DD
 491 ><P
 492 >    The <A
 493 HREF="filter-file.html"
 494 >filter file</A
 495 > contains content modification
 496     rules that use <A
 497 HREF="appendix.html#REGEX"
 498 >regular expressions</A
 499 >. These rules permit
 500     powerful changes on the content of Web pages, e.g., you could disable your favorite
 501     JavaScript annoyances, re-write the actual displayed text, or just have some
 502     fun replacing <SPAN
 503 CLASS="QUOTE"
 504 >"Microsoft"</SPAN
 505 > with <SPAN
 506 CLASS="QUOTE"
 507 >"MicroSuck"</SPAN
 508 > wherever
 509     it appears on a Web page.
 510    </P
 511 ><P
 512 >    The
 513     <TT
 514 CLASS="LITERAL"
 515 >+<A
 516 HREF="actions-file.html#FILTER"
 517 >filter</A
 518 >{<TT
 519 CLASS="REPLACEABLE"
 520 ><I
 521 >name</I
 522 ></TT
 523 >}</TT
 524 >
 525     actions rely on the relevant filter (<TT
 526 CLASS="REPLACEABLE"
 527 ><I
 528 >name</I
 529 ></TT
 530 >)
 531     to be defined in the filter file!
 532    </P
 533 ><P
 534 >    A pre-defined filter file called <TT
 535 CLASS="FILENAME"
 536 >default.filter</TT
 537 > that contains
 538     a bunch of handy filters for common problems is included in the distribution.
 539     See the section on the <TT
 540 CLASS="LITERAL"
 541 ><A
 542 HREF="actions-file.html#FILTER"
 543 >filter</A
 544 ></TT
 545 >
 546     action for a list.
 547    </P
 548 ></DD
 549 ></DL
 550 ></DIV
 551 ></DIV
 552 ><DIV
 553 CLASS="SECT3"
 554 ><H4
 555 CLASS="SECT3"
 556 ><A
 557 NAME="LOGFILE"
 558 >7.1.5. logfile</A
 559 ></H4
 560 ><P
 561 ></P
 562 ><DIV
 563 CLASS="VARIABLELIST"
 564 ><DL
 565 ><DT
 566 >Specifies:</DT
 567 ><DD
 568 ><P
 569 >    The log file to use
 570    </P
 571 ></DD
 572 ><DT
 573 >Type of value:</DT
 574 ><DD
 575 ><P
 576 >File name, relative to <TT
 577 CLASS="LITERAL"
 578 >logdir</TT
 579 ></P
 580 ></DD
 581 ><DT
 582 >Default value:</DT
 583 ><DD
 584 ><P
 585 >logfile (Unix) <I
 586 CLASS="EMPHASIS"
 587 >or</I
 588 > privoxy.log (Windows)</P
 589 ></DD
 590 ><DT
 591 >Effect if unset:</DT
 592 ><DD
 593 ><P
 594 >    No log file is used, all log messages go to the console (<TT
 595 CLASS="LITERAL"
 596 >stderr</TT
 597 >).
 598    </P
 599 ></DD
 600 ><DT
 601 >Notes:</DT
 602 ><DD
 603 ><P
 604 >    The windows version will additionally log to the console.
 605    </P
 606 ><P
 607 >    The logfile is where all logging and error messages are written. The level
 608     of detail and number of messages are set with the <TT
 609 CLASS="LITERAL"
 610 >debug</TT
 611 >
 612     option (see below). The logfile can be useful for tracking down a problem with
 613     <SPAN
 614 CLASS="APPLICATION"
 615 >Privoxy</SPAN
 616 > (e.g., it's not blocking an ad you
 617     think it should block) but in most cases you probably will never look at it.
 618    </P
 619 ><P
 620 >    Your logfile will grow indefinitely, and you will probably want to
 621     periodically remove it.  On Unix systems, you can do this with a cron job
 622     (see <SPAN
 623 CLASS="QUOTE"
 624 >"man cron"</SPAN
 625 >). For Red Hat, a <B
 626 CLASS="COMMAND"
 627 >logrotate</B
 628 >
 629     script has been included.
 630    </P
 631 ><P
 632 >    On SuSE Linux systems, you can place a line like <SPAN
 633 CLASS="QUOTE"
 634 >"/var/log/privoxy.*
 635     +1024k 644 nobody.nogroup"</SPAN
 636 > in <TT
 637 CLASS="FILENAME"
 638 >/etc/logfiles</TT
 639 >, with
 640     the effect that cron.daily will automatically archive, gzip, and empty the
 641     log, when it exceeds 1M size.
 642    </P
 643 ><P
 644 >    Any log files must be writable by whatever user <SPAN
 645 CLASS="APPLICATION"
 646 >Privoxy</SPAN
 647 >
 648     is being run as (default on UNIX, user id is <SPAN
 649 CLASS="QUOTE"
 650 >"privoxy"</SPAN
 651 >).
 652    </P
 653 ></DD
 654 ></DL
 655 ></DIV
 656 ></DIV
 657 ><DIV
 658 CLASS="SECT3"
 659 ><H4
 660 CLASS="SECT3"
 661 ><A
 662 NAME="JARFILE"
 663 >7.1.6. jarfile</A
 664 ></H4
 665 ><P
 666 ></P
 667 ><DIV
 668 CLASS="VARIABLELIST"
 669 ><DL
 670 ><DT
 671 >Specifies:</DT
 672 ><DD
 673 ><P
 674 >    The file to store intercepted cookies in
 675    </P
 676 ></DD
 677 ><DT
 678 >Type of value:</DT
 679 ><DD
 680 ><P
 681 >File name, relative to <TT
 682 CLASS="LITERAL"
 683 >logdir</TT
 684 ></P
 685 ></DD
 686 ><DT
 687 >Default value:</DT
 688 ><DD
 689 ><P
 690 >jarfile (Unix) <I
 691 CLASS="EMPHASIS"
 692 >or</I
 693 > privoxy.jar (Windows)</P
 694 ></DD
 695 ><DT
 696 >Effect if unset:</DT
 697 ><DD
 698 ><P
 699 >    Intercepted cookies are not stored at all.
 700    </P
 701 ></DD
 702 ><DT
 703 >Notes:</DT
 704 ><DD
 705 ><P
 706 >    The jarfile may grow to ridiculous sizes over time.
 707    </P
 708 ></DD
 709 ></DL
 710 ></DIV
 711 ></DIV
 712 ><DIV
 713 CLASS="SECT3"
 714 ><H4
 715 CLASS="SECT3"
 716 ><A
 717 NAME="TRUSTFILE"
 718 >7.1.7. trustfile</A
 719 ></H4
 720 ><P
 721 ></P
 722 ><DIV
 723 CLASS="VARIABLELIST"
 724 ><DL
 725 ><DT
 726 >Specifies:</DT
 727 ><DD
 728 ><P
 729 >    The trust file to use
 730    </P
 731 ></DD
 732 ><DT
 733 >Type of value:</DT
 734 ><DD
 735 ><P
 736 >File name, relative to <TT
 737 CLASS="LITERAL"
 738 >confdir</TT
 739 ></P
 740 ></DD
 741 ><DT
 742 >Default value:</DT
 743 ><DD
 744 ><P
 745 ><I
 746 CLASS="EMPHASIS"
 747 >Unset (commented out)</I
 748 >. When activated: trust (Unix) <I
 749 CLASS="EMPHASIS"
 750 >or</I
 751 > trust.txt (Windows)</P
 752 ></DD
 753 ><DT
 754 >Effect if unset:</DT
 755 ><DD
 756 ><P
 757 >    The whole trust mechanism is turned off.
 758    </P
 759 ></DD
 760 ><DT
 761 >Notes:</DT
 762 ><DD
 763 ><P
 764 >    The trust mechanism is an experimental feature for building white-lists and should
 765     be used with care. It is <I
 766 CLASS="EMPHASIS"
 767 >NOT</I
 768 > recommended for the casual user.
 769    </P
 770 ><P
 771 >    If you specify a trust file, <SPAN
 772 CLASS="APPLICATION"
 773 >Privoxy</SPAN
 774 > will only allow
 775     access to sites that are named in the trustfile.
 776     You can also mark sites as trusted referrers (with <TT
 777 CLASS="LITERAL"
 778 >+</TT
 779 >), with
 780     the effect that access to untrusted sites will be granted, if a link from a
 781     trusted referrer was used.
 782     The link target will then be added to the <SPAN
 783 CLASS="QUOTE"
 784 >"trustfile"</SPAN
 785 >.
 786     Possible applications include limiting Internet access for children.
 787    </P
 788 ><P
 789 >    If you use <TT
 790 CLASS="LITERAL"
 791 >+</TT
 792 > operator in the trust file, it may grow considerably over time.
 793    </P
 794 ></DD
 795 ></DL
 796 ></DIV
 797 ></DIV
 798 ></DIV
 799 ><DIV
 800 CLASS="SECT2"
 801 ><H2
 802 CLASS="SECT2"
 803 ><A
 804 NAME="LOCAL-SET-UP"
 805 >7.2. Local Set-up Documentation</A
 806 ></H2
 807 ><P
 808 >    If you intend to operate <SPAN
 809 CLASS="APPLICATION"
 810 >Privoxy</SPAN
 811 > for more users
 812     than just yourself, it might be a good idea to let them know how to reach
 813     you, what you block and why you do that, your policies, etc.
 814    </P
 815 ><DIV
 816 CLASS="SECT3"
 817 ><H4
 818 CLASS="SECT3"
 819 ><A
 820 NAME="USER-MANUAL"
 821 >7.2.1. user-manual</A
 822 ></H4
 823 ><P
 824 ></P
 825 ><DIV
 826 CLASS="VARIABLELIST"
 827 ><DL
 828 ><DT
 829 >Specifies:</DT
 830 ><DD
 831 ><P
 832 >    Location of the <SPAN
 833 CLASS="APPLICATION"
 834 >Privoxy</SPAN
 835 > User Manual.
 836    </P
 837 ></DD
 838 ><DT
 839 >Type of value:</DT
 840 ><DD
 841 ><P
 842 >A fully qualified URI</P
 843 ></DD
 844 ><DT
 845 >Default value:</DT
 846 ><DD
 847 ><P
 848 ><I
 849 CLASS="EMPHASIS"
 850 >Unset</I
 851 ></P
 852 ></DD
 853 ><DT
 854 >Effect if unset:</DT
 855 ><DD
 856 ><P
 857 >    <A
 858 HREF="http://www.privoxy.org/user-manual/"
 859 TARGET="_top"
 860 >http://www.privoxy.org/<TT
 861 CLASS="REPLACEABLE"
 862 ><I
 863 >version</I
 864 ></TT
 865 >/user-manual/</A
 866 >
 867     will be used, where <TT
 868 CLASS="REPLACEABLE"
 869 ><I
 870 >version</I
 871 ></TT
 872 > is the <SPAN
 873 CLASS="APPLICATION"
 874 >Privoxy</SPAN
 875 > version.
 876    </P
 877 ></DD
 878 ><DT
 879 >Notes:</DT
 880 ><DD
 881 ><P
 882 >    The User Manual URI is used for help links from some of the internal CGI pages.
 883     The manual itself is normally packaged with the binary distributions, so you probably want
 884     to set this to a locally installed copy. For multi-user setups, you could provide a copy on
 885     a local webserver for all your users and use the corresponding URL here.
 886    </P
 887 ><P
 888 >    Examples:
 889    </P
 890 ><P
 891 >   Unix, in local filesystem:
 892   </P
 893 ><P
 894 >   <TABLE
 895 BORDER="0"
 896 BGCOLOR="#E0E0E0"
 897 WIDTH="90%"
 898 ><TR
 899 ><TD
 900 ><PRE
 901 CLASS="SCREEN"
 902 >user-manual  file:///usr/share/doc/privoxy-2.9.15/user-manual/</PRE
 903 ></TD
 904 ></TR
 905 ></TABLE
 906 >
 907   </P
 908 ><P
 909 >   Any platform, on local webserver (called <SPAN
 910 CLASS="QUOTE"
 911 >"local-webserver"</SPAN
 912 >):
 913   </P
 914 ><P
 915 >   <TABLE
 916 BORDER="0"
 917 BGCOLOR="#E0E0E0"
 918 WIDTH="90%"
 919 ><TR
 920 ><TD
 921 ><PRE
 922 CLASS="SCREEN"
 923 >user-manual  http://local-webserver/privoxy-user-manual/</PRE
 924 ></TD
 925 ></TR
 926 ></TABLE
 927 >
 928   </P
 929 ><DIV
 930 CLASS="WARNING"
 931 ><P
 932 ></P
 933 ><TABLE
 934 CLASS="WARNING"
 935 BORDER="1"
 936 WIDTH="90%"
 937 ><TR
 938 ><TD
 939 ALIGN="CENTER"
 940 ><B
 941 >Warning</B
 942 ></TD
 943 ></TR
 944 ><TR
 945 ><TD
 946 ALIGN="LEFT"
 947 ><P
 948 >     If set, this option should be <I
 949 CLASS="EMPHASIS"
 950 >the first option in the config file</I
 951 >, because
 952      it is used while the config file is being read.
 953    </P
 954 ></TD
 955 ></TR
 956 ></TABLE
 957 ></DIV
 958 ></DD
 959 ></DL
 960 ></DIV
 961 ></DIV
 962 ><DIV
 963 CLASS="SECT3"
 964 ><H4
 965 CLASS="SECT3"
 966 ><A
 967 NAME="TRUST-INFO-URL"
 968 >7.2.2. trust-info-url</A
 969 ></H4
 970 ><P
 971 ></P
 972 ><DIV
 973 CLASS="VARIABLELIST"
 974 ><DL
 975 ><DT
 976 >Specifies:</DT
 977 ><DD
 978 ><P
 979 >    A URL to be displayed in the error page that users will see if access to an untrusted page is denied.
 980    </P
 981 ></DD
 982 ><DT
 983 >Type of value:</DT
 984 ><DD
 985 ><P
 986 >URL</P
 987 ></DD
 988 ><DT
 989 >Default value:</DT
 990 ><DD
 991 ><P
 992 >Two example URL are provided</P
 993 ></DD
 994 ><DT
 995 >Effect if unset:</DT
 996 ><DD
 997 ><P
 998 >    No links are displayed on the "untrusted" error page.
 999    </P
1000 ></DD
1001 ><DT
1002 >Notes:</DT
1003 ><DD
1004 ><P
1005 >    The value of this option only matters if the experimental trust mechanism has been
1006     activated. (See <A
1007 HREF="config.html#TRUSTFILE"
1008 ><I
1009 CLASS="EMPHASIS"
1010 >trustfile</I
1011 ></A
1012 > above.)
1013    </P
1014 ><P
1015 >    If you use the trust mechanism, it is a good idea to write up some on-line
1016     documentation about your trust policy and to specify the URL(s) here.
1017     Use multiple times for multiple URLs.
1018    </P
1019 ><P
1020 >    The URL(s) should be added to the trustfile as well, so users don't end up
1021     locked out from the information on why they were locked out in the first place!
1022    </P
1023 ></DD
1024 ></DL
1025 ></DIV
1026 ></DIV
1027 ><DIV
1028 CLASS="SECT3"
1029 ><H4
1030 CLASS="SECT3"
1031 ><A
1032 NAME="ADMIN-ADDRESS"
1033 >7.2.3. admin-address</A
1034 ></H4
1035 ><P
1036 ></P
1037 ><DIV
1038 CLASS="VARIABLELIST"
1039 ><DL
1040 ><DT
1041 >Specifies:</DT
1042 ><DD
1043 ><P
1044 >    An email address to reach the proxy administrator.
1045    </P
1046 ></DD
1047 ><DT
1048 >Type of value:</DT
1049 ><DD
1050 ><P
1051 >Email address</P
1052 ></DD
1053 ><DT
1054 >Default value:</DT
1055 ><DD
1056 ><P
1057 ><I
1058 CLASS="EMPHASIS"
1059 >Unset</I
1060 ></P
1061 ></DD
1062 ><DT
1063 >Effect if unset:</DT
1064 ><DD
1065 ><P
1066 >    No email address is displayed on error pages and the CGI user interface.
1067    </P
1068 ></DD
1069 ><DT
1070 >Notes:</DT
1071 ><DD
1072 ><P
1073 >    If both <TT
1074 CLASS="LITERAL"
1075 >admin-address</TT
1076 > and <TT
1077 CLASS="LITERAL"
1078 >proxy-info-url</TT
1079 >
1080     are unset, the whole "Local Privoxy Support" box on all generated pages will
1081     not be shown.
1082    </P
1083 ></DD
1084 ></DL
1085 ></DIV
1086 ></DIV
1087 ><DIV
1088 CLASS="SECT3"
1089 ><H4
1090 CLASS="SECT3"
1091 ><A
1092 NAME="PROXY-INFO-URL"
1093 >7.2.4. proxy-info-url</A
1094 ></H4
1095 ><P
1096 ></P
1097 ><DIV
1098 CLASS="VARIABLELIST"
1099 ><DL
1100 ><DT
1101 >Specifies:</DT
1102 ><DD
1103 ><P
1104 >    A URL to documentation about the local <SPAN
1105 CLASS="APPLICATION"
1106 >Privoxy</SPAN
1107 > setup,
1108     configuration or policies.
1109    </P
1110 ></DD
1111 ><DT
1112 >Type of value:</DT
1113 ><DD
1114 ><P
1115 >URL</P
1116 ></DD
1117 ><DT
1118 >Default value:</DT
1119 ><DD
1120 ><P
1121 ><I
1122 CLASS="EMPHASIS"
1123 >Unset</I
1124 ></P
1125 ></DD
1126 ><DT
1127 >Effect if unset:</DT
1128 ><DD
1129 ><P
1130 >    No link to local documentation is displayed on error pages and the CGI user interface.
1131    </P
1132 ></DD
1133 ><DT
1134 >Notes:</DT
1135 ><DD
1136 ><P
1137 >    If both <TT
1138 CLASS="LITERAL"
1139 >admin-address</TT
1140 > and <TT
1141 CLASS="LITERAL"
1142 >proxy-info-url</TT
1143 >
1144     are unset, the whole "Local Privoxy Support" box on all generated pages will
1145     not be shown.
1146    </P
1147 ><P
1148 >    This URL shouldn't be blocked ;-)
1149    </P
1150 ></DD
1151 ></DL
1152 ></DIV
1153 ></DIV
1154 ></DIV
1155 ><DIV
1156 CLASS="SECT2"
1157 ><H2
1158 CLASS="SECT2"
1159 ><A
1160 NAME="DEBUGGING"
1161 >7.3. Debugging</A
1162 ></H2
1163 ><P
1164 >  These options are mainly useful when tracing a problem.
1165   Note that you might also want to invoke
1166   <SPAN
1167 CLASS="APPLICATION"
1168 >Privoxy</SPAN
1169 > with the <TT
1170 CLASS="LITERAL"
1171 >--no-daemon</TT
1172 >
1173   command line option when debugging.
1174  </P
1175 ><DIV
1176 CLASS="SECT3"
1177 ><H4
1178 CLASS="SECT3"
1179 ><A
1180 NAME="DEBUG"
1181 >7.3.1. debug</A
1182 ></H4
1183 ><P
1184 ></P
1185 ><DIV
1186 CLASS="VARIABLELIST"
1187 ><DL
1188 ><DT
1189 >Specifies:</DT
1190 ><DD
1191 ><P
1192 >    Key values that determine what information gets logged to the
1193     <A
1194 HREF="config.html#LOGFILE"
1195 ><I
1196 CLASS="EMPHASIS"
1197 >logfile</I
1198 ></A
1199 >.
1200    </P
1201 ></DD
1202 ><DT
1203 >Type of value:</DT
1204 ><DD
1205 ><P
1206 >Integer values</P
1207 ></DD
1208 ><DT
1209 >Default value:</DT
1210 ><DD
1211 ><P
1212 >12289 (i.e.: URLs plus informational and warning messages)</P
1213 ></DD
1214 ><DT
1215 >Effect if unset:</DT
1216 ><DD
1217 ><P
1218 >    Nothing gets logged.
1219    </P
1220 ></DD
1221 ><DT
1222 >Notes:</DT
1223 ><DD
1224 ><P
1225 >    The available debug levels are:
1226    </P
1227 ><P
1228 >    <TABLE
1229 BORDER="0"
1230 BGCOLOR="#E0E0E0"
1231 WIDTH="90%"
1232 ><TR
1233 ><TD
1234 ><PRE
1235 CLASS="PROGRAMLISTING"
1236 >  debug         1 # show each GET/POST/CONNECT request
1237   debug         2 # show each connection status
1238   debug         4 # show I/O status
1239   debug         8 # show header parsing
1240   debug        16 # log all data into the logfile
1241   debug        32 # debug force feature
1242   debug        64 # debug regular expression filter
1243   debug       128 # debug fast redirects
1244   debug       256 # debug GIF de-animation
1245   debug       512 # Common Log Format
1246   debug      1024 # debug kill pop-ups
1247   debug      4096 # Startup banner and warnings.
1248   debug      8192 # Non-fatal errors</PRE
1249 ></TD
1250 ></TR
1251 ></TABLE
1252 >
1253    </P
1254 ><P
1255 >    To select multiple debug levels, you can either add them or use
1256     multiple <TT
1257 CLASS="LITERAL"
1258 >debug</TT
1259 > lines.
1260    </P
1261 ><P
1262 >    A debug level of 1 is informative because it will show you each request
1263     as it happens. <I
1264 CLASS="EMPHASIS"
1265 >1, 4096 and 8192 are highly recommended</I
1266 >
1267     so that you will notice when things go wrong. The other levels are probably
1268     only of interest if you are hunting down a specific problem. They can produce
1269     a hell of an output (especially 16).
1270
1271    </P
1272 ><P
1273 >    The reporting of <I
1274 CLASS="EMPHASIS"
1275 >fatal</I
1276 > errors (i.e. ones which crash
1277     <SPAN
1278 CLASS="APPLICATION"
1279 >Privoxy</SPAN
1280 >) is always on and cannot be disabled.
1281    </P
1282 ><P
1283 >    If you want to use CLF (Common Log Format), you should set <SPAN
1284 CLASS="QUOTE"
1285 >"debug
1286     512"</SPAN
1287 > <I
1288 CLASS="EMPHASIS"
1289 >ONLY</I
1290 > and not enable anything else.
1291    </P
1292 ></DD
1293 ></DL
1294 ></DIV
1295 ></DIV
1296 ><DIV
1297 CLASS="SECT3"
1298 ><H4
1299 CLASS="SECT3"
1300 ><A
1301 NAME="SINGLE-THREADED"
1302 >7.3.2. single-threaded</A
1303 ></H4
1304 ><P
1305 ></P
1306 ><DIV
1307 CLASS="VARIABLELIST"
1308 ><DL
1309 ><DT
1310 >Specifies:</DT
1311 ><DD
1312 ><P
1313 >    Whether to run only one server thread
1314    </P
1315 ></DD
1316 ><DT
1317 >Type of value:</DT
1318 ><DD
1319 ><P
1320 ><I
1321 CLASS="EMPHASIS"
1322 >None</I
1323 ></P
1324 ></DD
1325 ><DT
1326 >Default value:</DT
1327 ><DD
1328 ><P
1329 ><I
1330 CLASS="EMPHASIS"
1331 >Unset</I
1332 ></P
1333 ></DD
1334 ><DT
1335 >Effect if unset:</DT
1336 ><DD
1337 ><P
1338 >    Multi-threaded (or, where unavailable: forked) operation, i.e. the ability to
1339     serve multiple requests simultaneously.
1340    </P
1341 ></DD
1342 ><DT
1343 >Notes:</DT
1344 ><DD
1345 ><P
1346 >    This option is only there for debug purposes and you should never
1347     need to use it. <I
1348 CLASS="EMPHASIS"
1349 >It will drastically reduce performance.</I
1350 >
1351    </P
1352 ></DD
1353 ></DL
1354 ></DIV
1355 ></DIV
1356 ></DIV
1357 ><DIV
1358 CLASS="SECT2"
1359 ><H2
1360 CLASS="SECT2"
1361 ><A
1362 NAME="ACCESS-CONTROL"
1363 >7.4. Access Control and Security</A
1364 ></H2
1365 ><P
1366 >  This section of the config file controls the security-relevant aspects
1367   of <SPAN
1368 CLASS="APPLICATION"
1369 >Privoxy</SPAN
1370 >'s configuration.
1371  </P
1372 ><DIV
1373 CLASS="SECT3"
1374 ><H4
1375 CLASS="SECT3"
1376 ><A
1377 NAME="LISTEN-ADDRESS"
1378 >7.4.1. listen-address</A
1379 ></H4
1380 ><P
1381 ></P
1382 ><DIV
1383 CLASS="VARIABLELIST"
1384 ><DL
1385 ><DT
1386 >Specifies:</DT
1387 ><DD
1388 ><P
1389 >    The IP address and TCP port on which <SPAN
1390 CLASS="APPLICATION"
1391 >Privoxy</SPAN
1392 > will
1393     listen for client requests.
1394    </P
1395 ></DD
1396 ><DT
1397 >Type of value:</DT
1398 ><DD
1399 ><P
1400 >[<TT
1401 CLASS="REPLACEABLE"
1402 ><I
1403 >IP-Address</I
1404 ></TT
1405 >]:<TT
1406 CLASS="REPLACEABLE"
1407 ><I
1408 >Port</I
1409 ></TT
1410 ></P
1411 ></DD
1412 ><DT
1413 >Default value:</DT
1414 ><DD
1415 ><P
1416 >127.0.0.1:8118</P
1417 ></DD
1418 ><DT
1419 >Effect if unset:</DT
1420 ><DD
1421 ><P
1422 >    Bind to 127.0.0.1 (localhost), port 8118. This is suitable and recommended for
1423     home users who run <SPAN
1424 CLASS="APPLICATION"
1425 >Privoxy</SPAN
1426 > on the same machine as
1427     their browser.
1428    </P
1429 ></DD
1430 ><DT
1431 >Notes:</DT
1432 ><DD
1433 ><P
1434 >    You will need to configure your browser(s) to this proxy address and port.
1435    </P
1436 ><P
1437 >    If you already have another service running on port 8118, or if you want to
1438     serve requests from other machines (e.g. on your local network) as well, you
1439     will need to override the default.
1440    </P
1441 ><P
1442 >    If you leave out the IP address, <SPAN
1443 CLASS="APPLICATION"
1444 >Privoxy</SPAN
1445 > will
1446     bind to all interfaces (addresses) on your machine and may become reachable
1447     from the Internet. In that case, consider using access control lists (ACL's)
1448     (see <SPAN
1449 CLASS="QUOTE"
1450 >"ACLs"</SPAN
1451 > below), or a firewall.
1452    </P
1453 ></DD
1454 ><DT
1455 >Example:</DT
1456 ><DD
1457 ><P
1458 >     Suppose you are running <SPAN
1459 CLASS="APPLICATION"
1460 >Privoxy</SPAN
1461 > on
1462      a machine which has the address 192.168.0.1 on your local private network
1463      (192.168.0.0) and has another outside connection with a different address.
1464      You want it to serve requests from inside only:
1465    </P
1466 ><P
1467 >    <TABLE
1468 BORDER="0"
1469 BGCOLOR="#E0E0E0"
1470 WIDTH="90%"
1471 ><TR
1472 ><TD
1473 ><PRE
1474 CLASS="PROGRAMLISTING"
1475 >  listen-address  192.168.0.1:8118</PRE
1476 ></TD
1477 ></TR
1478 ></TABLE
1479 >
1480    </P
1481 ></DD
1482 ></DL
1483 ></DIV
1484 ></DIV
1485 ><DIV
1486 CLASS="SECT3"
1487 ><H4
1488 CLASS="SECT3"
1489 ><A
1490 NAME="TOGGLE"
1491 >7.4.2. toggle</A
1492 ></H4
1493 ><P
1494 ></P
1495 ><DIV
1496 CLASS="VARIABLELIST"
1497 ><DL
1498 ><DT
1499 >Specifies:</DT
1500 ><DD
1501 ><P
1502 >    Initial state of "toggle" status
1503    </P
1504 ></DD
1505 ><DT
1506 >Type of value:</DT
1507 ><DD
1508 ><P
1509 >1 or 0</P
1510 ></DD
1511 ><DT
1512 >Default value:</DT
1513 ><DD
1514 ><P
1515 >1</P
1516 ></DD
1517 ><DT
1518 >Effect if unset:</DT
1519 ><DD
1520 ><P
1521 >    Act as if toggled on
1522    </P
1523 ></DD
1524 ><DT
1525 >Notes:</DT
1526 ><DD
1527 ><P
1528 >    If set to 0, <SPAN
1529 CLASS="APPLICATION"
1530 >Privoxy</SPAN
1531 > will start in
1532     <SPAN
1533 CLASS="QUOTE"
1534 >"toggled off"</SPAN
1535 > mode, i.e. behave like a normal, content-neutral
1536     proxy where all ad blocking, filtering, etc are disabled. See
1537     <TT
1538 CLASS="LITERAL"
1539 >enable-remote-toggle</TT
1540 > below. This is not really useful
1541     anymore, since toggling is much easier via <A
1542 HREF="http://config.privoxy.org/toggle"
1543 TARGET="_top"
1544 >the web interface</A
1545 > than via
1546     editing the <TT
1547 CLASS="FILENAME"
1548 >conf</TT
1549 > file.
1550    </P
1551 ><P
1552 >    The windows version will only display the toggle icon in the system tray
1553     if this option is present.
1554    </P
1555 ></DD
1556 ></DL
1557 ></DIV
1558 ></DIV
1559 ><DIV
1560 CLASS="SECT3"
1561 ><H4
1562 CLASS="SECT3"
1563 ><A
1564 NAME="ENABLE-REMOTE-TOGGLE"
1565 >7.4.3. enable-remote-toggle</A
1566 ></H4
1567 ><P
1568 ></P
1569 ><DIV
1570 CLASS="VARIABLELIST"
1571 ><DL
1572 ><DT
1573 >Specifies:</DT
1574 ><DD
1575 ><P
1576 >    Whether or not the <A
1577 HREF="http://config.privoxy.org/toggle"
1578 TARGET="_top"
1579 >web-based toggle
1580     feature</A
1581 > may be used
1582    </P
1583 ></DD
1584 ><DT
1585 >Type of value:</DT
1586 ><DD
1587 ><P
1588 >0 or 1</P
1589 ></DD
1590 ><DT
1591 >Default value:</DT
1592 ><DD
1593 ><P
1594 >1</P
1595 ></DD
1596 ><DT
1597 >Effect if unset:</DT
1598 ><DD
1599 ><P
1600 >    The web-based toggle feature is disabled.
1601    </P
1602 ></DD
1603 ><DT
1604 >Notes:</DT
1605 ><DD
1606 ><P
1607 >    When toggled off, <SPAN
1608 CLASS="APPLICATION"
1609 >Privoxy</SPAN
1610 > acts like a normal,
1611     content-neutral proxy, i.e. it acts as if none of the actions applied to
1612     any URL.
1613    </P
1614 ><P
1615 >    For the time being, access to the toggle feature can <I
1616 CLASS="EMPHASIS"
1617 >not</I
1618 > be
1619     controlled separately by <SPAN
1620 CLASS="QUOTE"
1621 >"ACLs"</SPAN
1622 > or HTTP authentication,
1623     so that everybody who can access <SPAN
1624 CLASS="APPLICATION"
1625 >Privoxy</SPAN
1626 > (see
1627     <SPAN
1628 CLASS="QUOTE"
1629 >"ACLs"</SPAN
1630 > and <TT
1631 CLASS="LITERAL"
1632 >listen-address</TT
1633 > above) can
1634     toggle it for all users. So this option is <I
1635 CLASS="EMPHASIS"
1636 >not recommended</I
1637 >
1638     for multi-user environments with untrusted users.
1639    </P
1640 ><P
1641 >    Note that you must have compiled <SPAN
1642 CLASS="APPLICATION"
1643 >Privoxy</SPAN
1644 > with
1645     support for this feature, otherwise this option has no effect.
1646    </P
1647 ></DD
1648 ></DL
1649 ></DIV
1650 ></DIV
1651 ><DIV
1652 CLASS="SECT3"
1653 ><H4
1654 CLASS="SECT3"
1655 ><A
1656 NAME="ENABLE-EDIT-ACTIONS"
1657 >7.4.4. enable-edit-actions</A
1658 ></H4
1659 ><P
1660 ></P
1661 ><DIV
1662 CLASS="VARIABLELIST"
1663 ><DL
1664 ><DT
1665 >Specifies:</DT
1666 ><DD
1667 ><P
1668 >    Whether or not the <A
1669 HREF="http://config.privoxy.org/show-status"
1670 TARGET="_top"
1671 >web-based actions
1672     file editor</A
1673 > may be used
1674    </P
1675 ></DD
1676 ><DT
1677 >Type of value:</DT
1678 ><DD
1679 ><P
1680 >0 or 1</P
1681 ></DD
1682 ><DT
1683 >Default value:</DT
1684 ><DD
1685 ><P
1686 >1</P
1687 ></DD
1688 ><DT
1689 >Effect if unset:</DT
1690 ><DD
1691 ><P
1692 >    The web-based actions file editor is disabled.
1693    </P
1694 ></DD
1695 ><DT
1696 >Notes:</DT
1697 ><DD
1698 ><P
1699 >    For the time being, access to the editor can <I
1700 CLASS="EMPHASIS"
1701 >not</I
1702 > be
1703     controlled separately by <SPAN
1704 CLASS="QUOTE"
1705 >"ACLs"</SPAN
1706 > or HTTP authentication,
1707     so that everybody who can access <SPAN
1708 CLASS="APPLICATION"
1709 >Privoxy</SPAN
1710 > (see
1711     <SPAN
1712 CLASS="QUOTE"
1713 >"ACLs"</SPAN
1714 > and <TT
1715 CLASS="LITERAL"
1716 >listen-address</TT
1717 > above) can
1718     modify its configuration for all users. So this option is <I
1719 CLASS="EMPHASIS"
1720 >not
1721     recommended</I
1722 > for multi-user environments with untrusted users.
1723    </P
1724 ><P
1725 >    Note that you must have compiled <SPAN
1726 CLASS="APPLICATION"
1727 >Privoxy</SPAN
1728 > with
1729     support for this feature, otherwise this option has no effect.
1730    </P
1731 ></DD
1732 ></DL
1733 ></DIV
1734 ></DIV
1735 ><DIV
1736 CLASS="SECT3"
1737 ><H4
1738 CLASS="SECT3"
1739 ><A
1740 NAME="ACLS"
1741 >7.4.5. ACLs: permit-access and deny-access</A
1742 ></H4
1743 ><A
1744 NAME="PERMIT-ACCES"
1745 ></A
1746 ><A
1747 NAME="DENY-ACCES"
1748 ></A
1749 ><P
1750 ></P
1751 ><DIV
1752 CLASS="VARIABLELIST"
1753 ><DL
1754 ><DT
1755 >Specifies:</DT
1756 ><DD
1757 ><P
1758 >    Who can access what.
1759    </P
1760 ></DD
1761 ><DT
1762 >Type of value:</DT
1763 ><DD
1764 ><P
1765 >    <TT
1766 CLASS="REPLACEABLE"
1767 ><I
1768 >src_addr</I
1769 ></TT
1770 >[/<TT
1771 CLASS="REPLACEABLE"
1772 ><I
1773 >src_masklen</I
1774 ></TT
1775 >]
1776     [<TT
1777 CLASS="REPLACEABLE"
1778 ><I
1779 >dst_addr</I
1780 ></TT
1781 >[/<TT
1782 CLASS="REPLACEABLE"
1783 ><I
1784 >dst_masklen</I
1785 ></TT
1786 >]]
1787    </P
1788 ><P
1789 >    Where <TT
1790 CLASS="REPLACEABLE"
1791 ><I
1792 >src_addr</I
1793 ></TT
1794 > and
1795    <TT
1796 CLASS="REPLACEABLE"
1797 ><I
1798 >dst_addr</I
1799 ></TT
1800 > are IP addresses in dotted decimal notation or valid
1801     DNS names, and <TT
1802 CLASS="REPLACEABLE"
1803 ><I
1804 >src_masklen</I
1805 ></TT
1806 > and
1807     <TT
1808 CLASS="REPLACEABLE"
1809 ><I
1810 >dst_masklen</I
1811 ></TT
1812 > are subnet masks in CIDR notation, i.e. integer
1813     values from 2 to 30 representing the length (in bits) of the network address. The masks and the whole
1814     destination part are optional.
1815    </P
1816 ></DD
1817 ><DT
1818 >Default value:</DT
1819 ><DD
1820 ><P
1821 ><I
1822 CLASS="EMPHASIS"
1823 >Unset</I
1824 ></P
1825 ></DD
1826 ><DT
1827 >Effect if unset:</DT
1828 ><DD
1829 ><P
1830 >    Don't restrict access further than implied by <TT
1831 CLASS="LITERAL"
1832 >listen-address</TT
1833 >
1834    </P
1835 ></DD
1836 ><DT
1837 >Notes:</DT
1838 ><DD
1839 ><P
1840 >    Access controls are included at the request of ISPs and systems
1841     administrators, and <I
1842 CLASS="EMPHASIS"
1843 >are not usually needed by individual users</I
1844 >.
1845     For a typical home user, it will normally suffice to ensure that
1846     <SPAN
1847 CLASS="APPLICATION"
1848 >Privoxy</SPAN
1849 > only listens on the localhost
1850     (127.0.0.1) or internal (home) network address by means of the
1851     <A
1852 HREF="config.html#LISTEN-ADDRESS"
1853 ><I
1854 CLASS="EMPHASIS"
1855 >listen-address</I
1856 ></A
1857 >
1858     option.
1859    </P
1860 ><P
1861 >    Please see the warnings in the FAQ that this proxy is not intended to be a substitute
1862     for a firewall or to encourage anyone to defer addressing basic security
1863     weaknesses.
1864    </P
1865 ><P
1866 >    Multiple ACL lines are OK.
1867     If any ACLs are specified, then the <SPAN
1868 CLASS="APPLICATION"
1869 >Privoxy</SPAN
1870 >
1871     talks only to IP addresses that match at least one <TT
1872 CLASS="LITERAL"
1873 >permit-access</TT
1874 > line
1875     and don't match any subsequent <TT
1876 CLASS="LITERAL"
1877 >deny-access</TT
1878 > line. In other words, the
1879     last match wins, with the default being <TT
1880 CLASS="LITERAL"
1881 >deny-access</TT
1882 >.
1883    </P
1884 ><P
1885 >    If <SPAN
1886 CLASS="APPLICATION"
1887 >Privoxy</SPAN
1888 > is using a forwarder (see <TT
1889 CLASS="LITERAL"
1890 >forward</TT
1891 > below)
1892     for a particular destination URL, the <TT
1893 CLASS="REPLACEABLE"
1894 ><I
1895 >dst_addr</I
1896 ></TT
1897 >
1898     that is examined is the address of the forwarder and <I
1899 CLASS="EMPHASIS"
1900 >NOT</I
1901 > the address
1902     of the ultimate target. This is necessary because it may be impossible for the local
1903     <SPAN
1904 CLASS="APPLICATION"
1905 >Privoxy</SPAN
1906 > to determine the IP address of the
1907     ultimate target (that's often what gateways are used for).
1908    </P
1909 ><P
1910 >    You should prefer using IP addresses over DNS names, because the address lookups take
1911     time. All DNS names must resolve! You can <I
1912 CLASS="EMPHASIS"
1913 >not</I
1914 > use domain patterns
1915     like <SPAN
1916 CLASS="QUOTE"
1917 >"*.org"</SPAN
1918 > or partial domain names. If a DNS name resolves to multiple
1919     IP addresses, only the first one is used.
1920    </P
1921 ><P
1922 >    Denying access to particular sites by ACL may have undesired side effects
1923     if the site in question is hosted on a machine which also hosts other sites.
1924    </P
1925 ></DD
1926 ><DT
1927 >Examples:</DT
1928 ><DD
1929 ><P
1930 >    Explicitly define the default behavior if no ACL and
1931     <TT
1932 CLASS="LITERAL"
1933 >listen-address</TT
1934 > are set: <SPAN
1935 CLASS="QUOTE"
1936 >"localhost"</SPAN
1937 >
1938     is OK. The absence of a <TT
1939 CLASS="REPLACEABLE"
1940 ><I
1941 >dst_addr</I
1942 ></TT
1943 > implies that
1944     <I
1945 CLASS="EMPHASIS"
1946 >all</I
1947 > destination addresses are OK:
1948    </P
1949 ><P
1950 >    <TABLE
1951 BORDER="0"
1952 BGCOLOR="#E0E0E0"
1953 WIDTH="90%"
1954 ><TR
1955 ><TD
1956 ><PRE
1957 CLASS="SCREEN"
1958 >  permit-access  localhost</PRE
1959 ></TD
1960 ></TR
1961 ></TABLE
1962 >
1963    </P
1964 ><P
1965 >    Allow any host on the same class C subnet as www.privoxy.org access to
1966     nothing but www.example.com:
1967    </P
1968 ><P
1969 >    <TABLE
1970 BORDER="0"
1971 BGCOLOR="#E0E0E0"
1972 WIDTH="90%"
1973 ><TR
1974 ><TD
1975 ><PRE
1976 CLASS="SCREEN"
1977 >  permit-access  www.privoxy.org/24 www.example.com/32</PRE
1978 ></TD
1979 ></TR
1980 ></TABLE
1981 >
1982    </P
1983 ><P
1984 >    Allow access from any host on the 26-bit subnet 192.168.45.64 to anywhere,
1985     with the exception that 192.168.45.73 may not access www.dirty-stuff.example.com:
1986    </P
1987 ><P
1988 >    <TABLE
1989 BORDER="0"
1990 BGCOLOR="#E0E0E0"
1991 WIDTH="90%"
1992 ><TR
1993 ><TD
1994 ><PRE
1995 CLASS="SCREEN"
1996 >  permit-access  192.168.45.64/26
1997   deny-access    192.168.45.73    www.dirty-stuff.example.com</PRE
1998 ></TD
1999 ></TR
2000 ></TABLE
2001 >
2002    </P
2003 ></DD
2004 ></DL
2005 ></DIV
2006 ></DIV
2007 ><DIV
2008 CLASS="SECT3"
2009 ><H4
2010 CLASS="SECT3"
2011 ><A
2012 NAME="BUFFER-LIMIT"
2013 >7.4.6. buffer-limit</A
2014 ></H4
2015 ><P
2016 ></P
2017 ><DIV
2018 CLASS="VARIABLELIST"
2019 ><DL
2020 ><DT
2021 >Specifies:</DT
2022 ><DD
2023 ><P
2024 >    Maximum size of the buffer for content filtering.
2025    </P
2026 ></DD
2027 ><DT
2028 >Type of value:</DT
2029 ><DD
2030 ><P
2031 >Size in Kbytes</P
2032 ></DD
2033 ><DT
2034 >Default value:</DT
2035 ><DD
2036 ><P
2037 >4096</P
2038 ></DD
2039 ><DT
2040 >Effect if unset:</DT
2041 ><DD
2042 ><P
2043 >    Use a 4MB (4096 KB) limit.
2044    </P
2045 ></DD
2046 ><DT
2047 >Notes:</DT
2048 ><DD
2049 ><P
2050 >    For content filtering, i.e. the <TT
2051 CLASS="LITERAL"
2052 >+filter</TT
2053 > and
2054     <TT
2055 CLASS="LITERAL"
2056 >+deanimate-gif</TT
2057 > actions, it is necessary that
2058     <SPAN
2059 CLASS="APPLICATION"
2060 >Privoxy</SPAN
2061 > buffers the entire document body.
2062     This can be potentially dangerous, since a server could just keep sending
2063     data indefinitely and wait for your RAM to exhaust -- with nasty consequences.
2064     Hence this option.
2065    </P
2066 ><P
2067 >    When a document buffer size reaches the <TT
2068 CLASS="LITERAL"
2069 >buffer-limit</TT
2070 >, it is
2071     flushed to the client unfiltered and no further attempt to
2072     filter the rest of the document is made. Remember that there may be multiple threads
2073     running, which might require up to <TT
2074 CLASS="LITERAL"
2075 >buffer-limit</TT
2076 > Kbytes
2077     <I
2078 CLASS="EMPHASIS"
2079 >each</I
2080 >, unless you have enabled <SPAN
2081 CLASS="QUOTE"
2082 >"single-threaded"</SPAN
2083 >
2084     above.
2085    </P
2086 ></DD
2087 ></DL
2088 ></DIV
2089 ></DIV
2090 ></DIV
2091 ><DIV
2092 CLASS="SECT2"
2093 ><H2
2094 CLASS="SECT2"
2095 ><A
2096 NAME="FORWARDING"
2097 >7.5. Forwarding</A
2098 ></H2
2099 ><P
2100 > This feature allows routing of HTTP requests through a chain of
2101  multiple proxies.
2102  It can be used to better protect privacy and confidentiality when
2103  accessing specific domains by routing requests to those domains
2104  through an anonymous public proxy (see e.g. <A
2105 HREF="http://www.multiproxy.org/anon_list.htm"
2106 TARGET="_top"
2107 >http://www.multiproxy.org/anon_list.htm</A
2108 >)
2109  Or to use a caching proxy to speed up browsing. Or chaining to a parent
2110  proxy may be necessary because the machine that <SPAN
2111 CLASS="APPLICATION"
2112 >Privoxy</SPAN
2113 >
2114  runs on has no direct Internet access.</P
2115 ><P
2116 > Also specified here are SOCKS proxies. <SPAN
2117 CLASS="APPLICATION"
2118 >Privoxy</SPAN
2119 >
2120  supports the SOCKS 4 and SOCKS 4A protocols.</P
2121 ><DIV
2122 CLASS="SECT3"
2123 ><H4
2124 CLASS="SECT3"
2125 ><A
2126 NAME="FORWARD"
2127 >7.5.1. forward</A
2128 ></H4
2129 ><P
2130 ></P
2131 ><DIV
2132 CLASS="VARIABLELIST"
2133 ><DL
2134 ><DT
2135 >Specifies:</DT
2136 ><DD
2137 ><P
2138 >    To which parent HTTP proxy specific requests should be routed.
2139    </P
2140 ></DD
2141 ><DT
2142 >Type of value:</DT
2143 ><DD
2144 ><P
2145 >    <TT
2146 CLASS="REPLACEABLE"
2147 ><I
2148 >target_domain</I
2149 ></TT
2150 >[:<TT
2151 CLASS="REPLACEABLE"
2152 ><I
2153 >port</I
2154 ></TT
2155 >]
2156     <TT
2157 CLASS="REPLACEABLE"
2158 ><I
2159 >http_parent</I
2160 ></TT
2161 >[/<TT
2162 CLASS="REPLACEABLE"
2163 ><I
2164 >port</I
2165 ></TT
2166 >]
2167    </P
2168 ><P
2169 >    Where <TT
2170 CLASS="REPLACEABLE"
2171 ><I
2172 >target_domain</I
2173 ></TT
2174 > is a domain name pattern (see the
2175     chapter on domain matching in the <TT
2176 CLASS="FILENAME"
2177 >default.action</TT
2178 > file),
2179     <TT
2180 CLASS="REPLACEABLE"
2181 ><I
2182 >http_parent</I
2183 ></TT
2184 > is the address of the parent HTTP proxy
2185     as an IP addresses in dotted decimal notation or as a valid DNS name (or <SPAN
2186 CLASS="QUOTE"
2187 >"."</SPAN
2188 > to denote
2189     <SPAN
2190 CLASS="QUOTE"
2191 >"no forwarding"</SPAN
2192 >, and the optional
2193     <TT
2194 CLASS="REPLACEABLE"
2195 ><I
2196 >port</I
2197 ></TT
2198 > parameters are TCP ports, i.e. integer
2199     values from 1 to 64535
2200    </P
2201 ></DD
2202 ><DT
2203 >Default value:</DT
2204 ><DD
2205 ><P
2206 ><I
2207 CLASS="EMPHASIS"
2208 >Unset</I
2209 ></P
2210 ></DD
2211 ><DT
2212 >Effect if unset:</DT
2213 ><DD
2214 ><P
2215 >    Don't use parent HTTP proxies.
2216    </P
2217 ></DD
2218 ><DT
2219 >Notes:</DT
2220 ><DD
2221 ><P
2222 >    If <TT
2223 CLASS="REPLACEABLE"
2224 ><I
2225 >http_parent</I
2226 ></TT
2227 > is <SPAN
2228 CLASS="QUOTE"
2229 >"."</SPAN
2230 >, then requests are not
2231     forwarded to another HTTP proxy but are made directly to the web servers.
2232    </P
2233 ><P
2234 >    Multiple lines are OK, they are checked in sequence, and the last match wins.
2235    </P
2236 ></DD
2237 ><DT
2238 >Examples:</DT
2239 ><DD
2240 ><P
2241 >    Everything goes to an example anonymizing proxy, except SSL on port 443 (which it doesn't handle):
2242    </P
2243 ><P
2244 >    <TABLE
2245 BORDER="0"
2246 BGCOLOR="#E0E0E0"
2247 WIDTH="90%"
2248 ><TR
2249 ><TD
2250 ><PRE
2251 CLASS="SCREEN"
2252 >  forward   .*     anon-proxy.example.org:8080
2253   forward   :443   .</PRE
2254 ></TD
2255 ></TR
2256 ></TABLE
2257 >
2258    </P
2259 ><P
2260 >    Everything goes to our example ISP's caching proxy, except for requests
2261     to that ISP's sites:
2262    </P
2263 ><P
2264 >    <TABLE
2265 BORDER="0"
2266 BGCOLOR="#E0E0E0"
2267 WIDTH="90%"
2268 ><TR
2269 ><TD
2270 ><PRE
2271 CLASS="SCREEN"
2272 >  forward   .*.                caching-proxy.example-isp.net:8000
2273   forward   .example-isp.net   .</PRE
2274 ></TD
2275 ></TR
2276 ></TABLE
2277 >
2278    </P
2279 ></DD
2280 ></DL
2281 ></DIV
2282 ></DIV
2283 ><DIV
2284 CLASS="SECT3"
2285 ><H4
2286 CLASS="SECT3"
2287 ><A
2288 NAME="SOCKS"
2289 >7.5.2. forward-socks4 and forward-socks4a</A
2290 ></H4
2291 ><A
2292 NAME="FORWARD-SOCKS4"
2293 ></A
2294 ><A
2295 NAME="FORWARD-SOCKS4A"
2296 ></A
2297 ><P
2298 ></P
2299 ><DIV
2300 CLASS="VARIABLELIST"
2301 ><DL
2302 ><DT
2303 >Specifies:</DT
2304 ><DD
2305 ><P
2306 >    Through which SOCKS proxy (and to which parent HTTP proxy) specific requests should be routed.
2307    </P
2308 ></DD
2309 ><DT
2310 >Type of value:</DT
2311 ><DD
2312 ><P
2313 >    <TT
2314 CLASS="REPLACEABLE"
2315 ><I
2316 >target_domain</I
2317 ></TT
2318 >[:<TT
2319 CLASS="REPLACEABLE"
2320 ><I
2321 >port</I
2322 ></TT
2323 >]
2324     <TT
2325 CLASS="REPLACEABLE"
2326 ><I
2327 >socks_proxy</I
2328 ></TT
2329 >[/<TT
2330 CLASS="REPLACEABLE"
2331 ><I
2332 >port</I
2333 ></TT
2334 >]
2335     <TT
2336 CLASS="REPLACEABLE"
2337 ><I
2338 >http_parent</I
2339 ></TT
2340 >[/<TT
2341 CLASS="REPLACEABLE"
2342 ><I
2343 >port</I
2344 ></TT
2345 >]
2346    </P
2347 ><P
2348 >    Where <TT
2349 CLASS="REPLACEABLE"
2350 ><I
2351 >target_domain</I
2352 ></TT
2353 > is a domain name pattern (see the
2354     chapter on domain matching in the <TT
2355 CLASS="FILENAME"
2356 >default.action</TT
2357 > file),
2358     <TT
2359 CLASS="REPLACEABLE"
2360 ><I
2361 >http_parent</I
2362 ></TT
2363 > and <TT
2364 CLASS="REPLACEABLE"
2365 ><I
2366 >socks_proxy</I
2367 ></TT
2368 >
2369     are IP addresses in dotted decimal notation or valid DNS names (<TT
2370 CLASS="REPLACEABLE"
2371 ><I
2372 >http_parent</I
2373 ></TT
2374 >
2375     may be <SPAN
2376 CLASS="QUOTE"
2377 >"."</SPAN
2378 > to denote <SPAN
2379 CLASS="QUOTE"
2380 >"no HTTP forwarding"</SPAN
2381 >), and the optional
2382     <TT
2383 CLASS="REPLACEABLE"
2384 ><I
2385 >port</I
2386 ></TT
2387 > parameters are TCP ports, i.e. integer values from 1 to 64535
2388    </P
2389 ></DD
2390 ><DT
2391 >Default value:</DT
2392 ><DD
2393 ><P
2394 ><I
2395 CLASS="EMPHASIS"
2396 >Unset</I
2397 ></P
2398 ></DD
2399 ><DT
2400 >Effect if unset:</DT
2401 ><DD
2402 ><P
2403 >    Don't use SOCKS proxies.
2404    </P
2405 ></DD
2406 ><DT
2407 >Notes:</DT
2408 ><DD
2409 ><P
2410 >    Multiple lines are OK, they are checked in sequence, and the last match wins.
2411    </P
2412 ><P
2413 >    The difference between <TT
2414 CLASS="LITERAL"
2415 >forward-socks4</TT
2416 > and <TT
2417 CLASS="LITERAL"
2418 >forward-socks4a</TT
2419 >
2420     is that in the SOCKS 4A protocol, the DNS resolution of the target hostname happens on the SOCKS
2421     server, while in SOCKS 4 it happens locally.
2422    </P
2423 ><P
2424 >    If <TT
2425 CLASS="REPLACEABLE"
2426 ><I
2427 >http_parent</I
2428 ></TT
2429 > is <SPAN
2430 CLASS="QUOTE"
2431 >"."</SPAN
2432 >, then requests are not
2433     forwarded to another HTTP proxy but are made (HTTP-wise) directly to the web servers, albeit through
2434     a SOCKS proxy.
2435    </P
2436 ></DD
2437 ><DT
2438 >Examples:</DT
2439 ><DD
2440 ><P
2441 >     From the company example.com, direct connections are made to all
2442      <SPAN
2443 CLASS="QUOTE"
2444 >"internal"</SPAN
2445 > domains, but everything outbound goes through
2446      their ISP's proxy by way of example.com's corporate SOCKS 4A gateway to
2447      the Internet.
2448    </P
2449 ><P
2450 >    <TABLE
2451 BORDER="0"
2452 BGCOLOR="#E0E0E0"
2453 WIDTH="90%"
2454 ><TR
2455 ><TD
2456 ><PRE
2457 CLASS="SCREEN"
2458 >  forward-socks4a   .*.            socks-gw.example.com:1080  www-cache.example-isp.net:8080
2459   forward           .example.com   .</PRE
2460 ></TD
2461 ></TR
2462 ></TABLE
2463 >
2464    </P
2465 ><P
2466 >    A rule that uses a SOCKS 4 gateway for all destinations but no HTTP parent looks like this:
2467    </P
2468 ><P
2469 >    <TABLE
2470 BORDER="0"
2471 BGCOLOR="#E0E0E0"
2472 WIDTH="90%"
2473 ><TR
2474 ><TD
2475 ><PRE
2476 CLASS="SCREEN"
2477 >  forward-socks4   .*.            socks-gw.example.com:1080  .</PRE
2478 ></TD
2479 ></TR
2480 ></TABLE
2481 >
2482    </P
2483 ></DD
2484 ></DL
2485 ></DIV
2486 ></DIV
2487 ><DIV
2488 CLASS="SECT3"
2489 ><H4
2490 CLASS="SECT3"
2491 ><A
2492 NAME="ADVANCED-FORWARDING-EXAMPLES"
2493 >7.5.3. Advanced Forwarding Examples</A
2494 ></H4
2495 ><P
2496 > If you have links to multiple ISPs that provide various special content
2497  only to their subscribers, you can configure multiple <SPAN
2498 CLASS="APPLICATION"
2499 >Privoxies</SPAN
2500 >
2501  which have connections to the respective ISPs to act as forwarders to each other, so that
2502  <I
2503 CLASS="EMPHASIS"
2504 >your</I
2505 > users can see the internal content of all ISPs.</P
2506 ><P
2507 > Assume that host-a has a PPP connection to isp-a.net. And host-b has a PPP connection to
2508  isp-b.net. Both run <SPAN
2509 CLASS="APPLICATION"
2510 >Privoxy</SPAN
2511 >. Their forwarding
2512  configuration can look like this:</P
2513 ><P
2514 > host-a:</P
2515 ><P
2516 > <TABLE
2517 BORDER="0"
2518 BGCOLOR="#E0E0E0"
2519 WIDTH="100%"
2520 ><TR
2521 ><TD
2522 ><PRE
2523 CLASS="SCREEN"
2524 >  forward    .*.         .
2525   forward    .isp-b.net  host-b:8118</PRE
2526 ></TD
2527 ></TR
2528 ></TABLE
2529 ></P
2530 ><P
2531 > host-b:</P
2532 ><P
2533 > <TABLE
2534 BORDER="0"
2535 BGCOLOR="#E0E0E0"
2536 WIDTH="100%"
2537 ><TR
2538 ><TD
2539 ><PRE
2540 CLASS="SCREEN"
2541 >  forward    .*.         .
2542   forward    .isp-a.net  host-a:8118</PRE
2543 ></TD
2544 ></TR
2545 ></TABLE
2546 ></P
2547 ><P
2548 > Now, your users can set their browser's proxy to use either
2549  host-a or host-b and be able to browse the internal content
2550  of both isp-a and isp-b.</P
2551 ><P
2552 > If you intend to chain <SPAN
2553 CLASS="APPLICATION"
2554 >Privoxy</SPAN
2555 > and
2556  <SPAN
2557 CLASS="APPLICATION"
2558 >squid</SPAN
2559 > locally, then chain as
2560  <TT
2561 CLASS="LITERAL"
2562 >browser -&#62; squid -&#62; privoxy</TT
2563 > is the recommended way. </P
2564 ><P
2565 > Assuming that <SPAN
2566 CLASS="APPLICATION"
2567 >Privoxy</SPAN
2568 > and <SPAN
2569 CLASS="APPLICATION"
2570 >squid</SPAN
2571 >
2572  run on the same box, your squid configuration could then look like this:</P
2573 ><P
2574 > <TABLE
2575 BORDER="0"
2576 BGCOLOR="#E0E0E0"
2577 WIDTH="100%"
2578 ><TR
2579 ><TD
2580 ><PRE
2581 CLASS="SCREEN"
2582 >  # Define Privoxy as parent proxy (without ICP)
2583   cache_peer 127.0.0.1 parent 8118 7 no-query
2584
2585   # Define ACL for protocol FTP
2586   acl ftp proto FTP
2587
2588   # Do not forward FTP requests to Privoxy
2589   always_direct allow ftp
2590
2591   # Forward all the rest to Privoxy
2592   never_direct allow all</PRE
2593 ></TD
2594 ></TR
2595 ></TABLE
2596 ></P
2597 ><P
2598 > You would then need to change your browser's proxy settings to <SPAN
2599 CLASS="APPLICATION"
2600 >squid</SPAN
2601 >'s address and port.
2602  Squid normally uses port 3128. If unsure consult <TT
2603 CLASS="LITERAL"
2604 >http_port</TT
2605 > in <TT
2606 CLASS="FILENAME"
2607 >squid.conf</TT
2608 >.</P
2609 ></DIV
2610 ></DIV
2611 ><DIV
2612 CLASS="SECT2"
2613 ><H2
2614 CLASS="SECT2"
2615 ><A
2616 NAME="WINDOWS-GUI"
2617 >7.6. Windows GUI Options</A
2618 ></H2
2619 ><P
2620 > <SPAN
2621 CLASS="APPLICATION"
2622 >Privoxy</SPAN
2623 > has a number of options specific to the
2624  Windows GUI interface:</P
2625 ><A
2626 NAME="ACTIVITY-ANIMATION"
2627 ></A
2628 ><P
2629 > If <SPAN
2630 CLASS="QUOTE"
2631 >"activity-animation"</SPAN
2632 > is set to 1, the
2633  <SPAN
2634 CLASS="APPLICATION"
2635 >Privoxy</SPAN
2636 > icon will animate when
2637  <SPAN
2638 CLASS="QUOTE"
2639 >"Privoxy"</SPAN
2640 > is active. To turn off, set to 0.</P
2641 ><P
2642 > <TT
2643 CLASS="LITERAL"
2644 >  <P
2645 CLASS="LITERALLAYOUT"
2646 >&nbsp;&nbsp;<I
2647 CLASS="EMPHASIS"
2648 >activity-animation   1</I
2649 ><br>
2650 &nbsp;&nbsp;&nbsp;</P
2651 >
2652  </TT
2653 ></P
2654 ><A
2655 NAME="LOG-MESSAGES"
2656 ></A
2657 ><P
2658 > If <SPAN
2659 CLASS="QUOTE"
2660 >"log-messages"</SPAN
2661 > is set to 1,
2662  <SPAN
2663 CLASS="APPLICATION"
2664 >Privoxy</SPAN
2665 > will log messages to the console
2666  window:</P
2667 ><P
2668 > <TT
2669 CLASS="LITERAL"
2670 >  <P
2671 CLASS="LITERALLAYOUT"
2672 >&nbsp;&nbsp;<I
2673 CLASS="EMPHASIS"
2674 >log-messages       1</I
2675 ><br>
2676 &nbsp;&nbsp;&nbsp;</P
2677 >
2678  </TT
2679 ></P
2680 ><A
2681 NAME="LOG-BUFFER-SIZE"
2682 ></A
2683 ><P
2684 >
2685  If <SPAN
2686 CLASS="QUOTE"
2687 >"log-buffer-size"</SPAN
2688 > is set to 1, the size of the log buffer,
2689  i.e. the amount of memory used for the log messages displayed in the
2690  console window, will be limited to <SPAN
2691 CLASS="QUOTE"
2692 >"log-max-lines"</SPAN
2693 > (see below).</P
2694 ><P
2695 > Warning: Setting this to 0 will result in the buffer to grow infinitely and
2696  eat up all your memory!</P
2697 ><P
2698 > <TT
2699 CLASS="LITERAL"
2700 >  <P
2701 CLASS="LITERALLAYOUT"
2702 >&nbsp;&nbsp;<I
2703 CLASS="EMPHASIS"
2704 >log-buffer-size      1</I
2705 ><br>
2706 &nbsp;&nbsp;&nbsp;</P
2707 >
2708  </TT
2709 ></P
2710 ><A
2711 NAME="LOG-MAX-LINES"
2712 ></A
2713 ><P
2714 > <SPAN
2715 CLASS="APPLICATION"
2716 >log-max-lines</SPAN
2717 > is the maximum number of lines held
2718  in the log buffer. See above.</P
2719 ><P
2720 > <TT
2721 CLASS="LITERAL"
2722 >  <P
2723 CLASS="LITERALLAYOUT"
2724 >&nbsp;&nbsp;<I
2725 CLASS="EMPHASIS"
2726 >log-max-lines      200</I
2727 ><br>
2728 &nbsp;&nbsp;&nbsp;</P
2729 >
2730  </TT
2731 ></P
2732 ><A
2733 NAME="LOG-HIGHLIGHT-MESSAGES"
2734 ></A
2735 ><P
2736 > If <SPAN
2737 CLASS="QUOTE"
2738 >"log-highlight-messages"</SPAN
2739 > is set to 1,
2740  <SPAN
2741 CLASS="APPLICATION"
2742 >Privoxy</SPAN
2743 > will highlight portions of the log
2744  messages with a bold-faced font:</P
2745 ><P
2746 > <TT
2747 CLASS="LITERAL"
2748 >  <P
2749 CLASS="LITERALLAYOUT"
2750 >&nbsp;&nbsp;<I
2751 CLASS="EMPHASIS"
2752 >log-highlight-messages   1</I
2753 ><br>
2754 &nbsp;&nbsp;&nbsp;</P
2755 >
2756  </TT
2757 ></P
2758 ><A
2759 NAME="LOG-FONT-NAME"
2760 ></A
2761 ><P
2762 > The font used in the console window:</P
2763 ><P
2764 > <TT
2765 CLASS="LITERAL"
2766 >  <P
2767 CLASS="LITERALLAYOUT"
2768 >&nbsp;&nbsp;<I
2769 CLASS="EMPHASIS"
2770 >log-font-name        Comic Sans MS</I
2771 ><br>
2772 &nbsp;&nbsp;&nbsp;</P
2773 >
2774  </TT
2775 ></P
2776 ><A
2777 NAME="LOG-FONT-SIZE"
2778 ></A
2779 ><P
2780 > Font size used in the console window:</P
2781 ><P
2782 > <TT
2783 CLASS="LITERAL"
2784 >  <P
2785 CLASS="LITERALLAYOUT"
2786 >&nbsp;&nbsp;<I
2787 CLASS="EMPHASIS"
2788 >log-font-size        8</I
2789 ><br>
2790 &nbsp;&nbsp;&nbsp;</P
2791 >
2792  </TT
2793 ></P
2794 ><A
2795 NAME="SHOW-ON-TASK-BAR"
2796 ></A
2797 ><P
2798 >
2799  <SPAN
2800 CLASS="QUOTE"
2801 >"show-on-task-bar"</SPAN
2802 > controls whether or not
2803  <SPAN
2804 CLASS="APPLICATION"
2805 >Privoxy</SPAN
2806 > will appear as a button on the Task bar
2807  when minimized:</P
2808 ><P
2809 > <TT
2810 CLASS="LITERAL"
2811 >  <P
2812 CLASS="LITERALLAYOUT"
2813 >&nbsp;&nbsp;<I
2814 CLASS="EMPHASIS"
2815 >show-on-task-bar     0</I
2816 ><br>
2817 &nbsp;&nbsp;&nbsp;</P
2818 >
2819  </TT
2820 ></P
2821 ><A
2822 NAME="CLOSE-BUTTON-MINIMIZES"
2823 ></A
2824 ><P
2825 > If <SPAN
2826 CLASS="QUOTE"
2827 >"close-button-minimizes"</SPAN
2828 > is set to 1, the Windows close
2829  button will minimize <SPAN
2830 CLASS="APPLICATION"
2831 >Privoxy</SPAN
2832 > instead of closing
2833  the program (close with the exit option on the File menu).</P
2834 ><P
2835 > <TT
2836 CLASS="LITERAL"
2837 >  <P
2838 CLASS="LITERALLAYOUT"
2839 >&nbsp;&nbsp;<I
2840 CLASS="EMPHASIS"
2841 >close-button-minimizes  1</I
2842 ><br>
2843 &nbsp;&nbsp;&nbsp;</P
2844 >
2845  </TT
2846 ></P
2847 ><A
2848 NAME="HIDE-CONSOLE"
2849 ></A
2850 ><P
2851 > The <SPAN
2852 CLASS="QUOTE"
2853 >"hide-console"</SPAN
2854 > option is specific to the MS-Win console
2855  version of <SPAN
2856 CLASS="APPLICATION"
2857 >Privoxy</SPAN
2858 >. If this option is used,
2859  <SPAN
2860 CLASS="APPLICATION"
2861 >Privoxy</SPAN
2862 > will disconnect from and hide  the
2863  command console.</P
2864 ><P
2865 > <TT
2866 CLASS="LITERAL"
2867 >  <P
2868 CLASS="LITERALLAYOUT"
2869 >&nbsp;&nbsp;#<I
2870 CLASS="EMPHASIS"
2871 >hide-console</I
2872 ><br>
2873 &nbsp;&nbsp;&nbsp;</P
2874 >
2875  </TT
2876 ></P
2877 ></DIV
2878 ></DIV
2879 ><DIV
2880 CLASS="NAVFOOTER"
2881 ><HR
2882 ALIGN="LEFT"
2883 WIDTH="100%"><TABLE
2884 WIDTH="100%"
2885 BORDER="0"
2886 CELLPADDING="0"
2887 CELLSPACING="0"
2888 ><TR
2889 ><TD
2890 WIDTH="33%"
2891 ALIGN="left"
2892 VALIGN="top"
2893 ><A
2894 HREF="configuration.html"
2895 >Prev</A
2896 ></TD
2897 ><TD
2898 WIDTH="34%"
2899 ALIGN="center"
2900 VALIGN="top"
2901 ><A
2902 HREF="index.html"
2903 >Home</A
2904 ></TD
2905 ><TD
2906 WIDTH="33%"
2907 ALIGN="right"
2908 VALIGN="top"
2909 ><A
2910 HREF="actions-file.html"
2911 >Next</A
2912 ></TD
2913 ></TR
2914 ><TR
2915 ><TD
2916 WIDTH="33%"
2917 ALIGN="left"
2918 VALIGN="top"
2919 ><SPAN
2920 CLASS="APPLICATION"
2921 >Privoxy</SPAN
2922 > Configuration</TD
2923 ><TD
2924 WIDTH="34%"
2925 ALIGN="center"
2926 VALIGN="top"
2927 >&nbsp;</TD
2928 ><TD
2929 WIDTH="33%"
2930 ALIGN="right"
2931 VALIGN="top"
2932 >Actions Files</TD
2933 ></TR
2934 ></TABLE
2935 ></DIV
2936 ></BODY
2937 ></HTML
2938 >