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