tools/privoxy-log-parser.pl

   1 #!/usr/bin/perl
   2
   3 ################################################################################
   4 # privoxy-log-parser
   5 #
   6 # A parser for Privoxy log messages. For incomplete documentation run
   7 # perldoc privoxy-log-parser(.pl), for fancy screenshots see:
   8 #
   9 # http://www.fabiankeil.de/sourcecode/privoxy-log-parser/
  10 #
  11 # $Id: privoxy-log-parser.pl,v 1.53 2009/10/08 11:45:56 fabiankeil Exp $
  12 #
  13 # TODO:
  14 #       - LOG_LEVEL_CGI, LOG_LEVEL_ERROR, LOG_LEVEL_WRITE content highlighting
  15 #       - create fancy statistics
  16 #       - grep through Privoxy sources to find unsupported log messages
  17 #       - hunt down substitutions that match content from variables which
  18 #         can contain stuff like ()?'[]
  19 #       - replace $h{'foo'} with h('foo') where possible
  20 #       - hunt down XXX comments instead of just creating them
  21 #       - add example log lines for every regex and mark them up for
  22 #         regression testing
  23 #       - Handle incomplete input without Perl warning about undefined variables.
  24 #       - Use generic highlighting function that takes a regex and the
  25 #         hash key as input.
  26 #
  27 # Copyright (c) 2007-2009 Fabian Keil <fk@fabiankeil.de>
  28 #
  29 # Permission to use, copy, modify, and distribute this software for any
  30 # purpose with or without fee is hereby granted, provided that the above
  31 # copyright notice and this permission notice appear in all copies.
  32 #
  33 # THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  34 # WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  35 # MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  36 # ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  37 # WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  38 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  39 # OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  40 ################################################################################
  41
  42 use strict;
  43 use warnings;
  44 use Getopt::Long;
  45
  46 use constant {
  47     PRIVOXY_LOG_PARSER_VERSION => '0.5',
  48     # Feel free to mess with these ...
  49     DEFAULT_BACKGROUND => 'black',  # Choose registered colour (like 'black')
  50     DEFAULT_TEXT_COLOUR => 'white', # Choose registered colour (like 'black')
  51     HEADER_DEFAULT_COLOUR => 'yellow',
  52     REGISTER_HEADERS_WITH_THE_SAME_COLOUR => 1,
  53
  54     CLI_OPTION_DEFAULT_TO_HTML_OUTPUT => 0,
  55     CLI_OPTION_TITLE => 'Privoxy-Log-Parser in da house',
  56     CLI_OPTION_NO_EMBEDDED_CSS => 0,
  57     CLI_OPTION_NO_MSECS => 0,
  58     CLI_OPTION_NO_SYNTAX_HIGHLIGHTING => 0,
  59     CLI_OPTION_ERROR_LOG_FILE => '/var/log/privoxy-log.log',
  60     CLI_OPTION_SHOW_INEFFECTIVE_FILTERS => 0,
  61     CLI_OPTION_ACCEPT_UNKNOWN_MESSAGES => 0,
  62     CLI_OPTION_STATISTICS => 0,
  63
  64     SUPPRESS_SUCCEEDED_FILTER_ADDITIONS => 1,
  65     SHOW_SCAN_INTRO => 0,
  66     SHOW_FILTER_READIN_IN => 0,
  67     SUPPRESS_EMPTY_LINES => 1,
  68     SUPPRESS_SUCCESSFUL_CONNECTIONS => 1,
  69     SUPPRESS_ACCEPTED_CONNECTIONS => 1,
  70     SUPPRESS_GIF_NOT_CHANGED => 1,
  71     SUPPRESS_NEED_TO_DE_CHUNK_FIRST => 1,
  72
  73     DEBUG_HEADER_REGISTERING => 0,
  74     DEBUG_HEADER_HIGHLIGHTING => 0,
  75     DEBUG_TICKS => 0,
  76     DEBUG_PAINT_IT => 0,
  77     DEBUG_SUPPRESS_LOG_MESSAGES => 0,
  78
  79     PUNISH_MISSING_LOG_KNOWLEDGE_WITH_DEATH => 0,
  80     PUNISH_MISSING_HIGHLIGHT_KNOWLEDGE_WITH_DEATH => 1,
  81
  82     LOG_UNPARSED_LINES_TO_EXTRA_FILE => 0,
  83
  84     # You better leave these alone unless you know what you're doing.
  85     COLOUR_RESET      => "\033[0;0m",
  86     ESCAPE => "\033[",
  87 };
  88
  89 sub prepare_our_stuff () {
  90
  91     # Syntax Higlight hash
  92     our @all_colours = (
  93         'red', 'green', 'brown', 'blue', 'purple', 'cyan',
  94         'light_gray', 'light_red', 'light_green', 'yellow',
  95         'light_blue', 'pink', 'light_cyan', 'white'
  96     );
  97
  98     our %h = (
  99         # LOG_LEVEL
 100         Info            => 'blue',
 101         Header          => 'green',
 102         Filter          => 'purple', # XXX: Used?
 103         'Re-Filter'     => 'purple',
 104         Connect         => 'brown',
 105         Request         => 'light_cyan',
 106         CGI             => 'light_green',
 107         Redirect        => 'cyan',
 108         Error           => 'light_red',
 109         Crunch          => 'cyan',
 110         'Fatal error'   => 'light_red',
 111         'Gif-Deanimate' => 'blue',
 112         Force           => 'red',
 113         Writing         => 'light_green',
 114         # ----------------------
 115         URL                  => 'yellow',
 116         path                 => 'brown',
 117         request_             => 'brown', # host+path but no protocol
 118         'ip-address'         => 'yellow',
 119         Number               => 'yellow',
 120         Standard             => 'reset',
 121         Truncation           => 'light_red',
 122         Status               => 'brown',
 123         Timestamp            => 'brown',
 124         Crunching            => 'light_red',
 125         crunched             => 'light_red',
 126         'Request-Line'       => 'pink',
 127         method               => 'purple',
 128         destination          => 'yellow',
 129         'http-version'       => 'pink',
 130         'crunch-pattern'     => 'pink',
 131         not                  => 'brown',
 132         file                 => 'brown',
 133         signal               => 'yellow',
 134         version              => 'green',
 135         'program-name'       => 'cyan',
 136         port                 => 'red',
 137         host                 => 'red',
 138         warning              => 'light_red',
 139         debug                => 'light_red',
 140         filter               => 'green',
 141         tag                  => 'green',
 142         tagger               => 'green',
 143         'status-message'     => 'light_cyan',
 144         'status-code'        => 'yellow',
 145         'invalid-request'    => 'light_red',
 146         'hits'               => 'yellow',
 147         error                => 'light_red',
 148         'rewritten-URL'      => 'light_red',
 149         'pcrs-delimiter'     => 'light_red',
 150         'ignored'            => 'light_red',
 151         'action-bits-update' => 'light_red',
 152         'configuration-line' => 'red',
 153         'content-type'       => 'yellow',
 154     );
 155
 156     our %h_colours = %h;
 157
 158     # Header colours need their own hash so the keys can be accessed properly
 159     our %header_colours = (
 160         # Prefilled with headers that should not appear with default header colours
 161         Cookie => 'light_red',
 162         'Set-Cookie' => 'light_red',
 163         Warning => 'light_red',
 164         Default => HEADER_DEFAULT_COLOUR,
 165     );
 166
 167     # Crunch reasons need their own hash as well
 168     our %reason_colours = (
 169         'Unsupported HTTP feature'               => 'light_red',
 170         Blocked                                  => 'light_red',
 171         Untrusted                                => 'light_red',
 172         Redirected                               => 'green',
 173         'CGI Call'                               => 'white',
 174         'DNS failure'                            => 'red',
 175         'Forwarding failed'                      => 'light_red',
 176         'Connection failure'                     => 'light_red',
 177         'Out of memory (may mask other reasons)' => 'light_red',
 178         'No reason recorded'                     => 'light_red',
 179     );
 180
 181     our @time_colours = ('white', 'light_gray');
 182
 183     # Translate highlight strings into highlight code
 184     prepare_highlight_hash(\%header_colours);
 185     prepare_highlight_hash(\%reason_colours);
 186     prepare_highlight_hash(\%h);
 187     prepare_colour_array(\@all_colours);
 188     prepare_colour_array(\@time_colours);
 189     init_css_colours();
 190
 191     init_stats();
 192 }
 193
 194 sub paint_it ($) {
 195 ###############################################################
 196 # Takes a colour string and returns an ANSI escape sequence
 197 # (unless --no-syntax-highlighting is used).
 198 # XXX: The Rolling Stones reference has to go.
 199 ###############################################################
 200
 201     my $colour = shift @_;
 202
 203     return "" if cli_option_is_set('no-syntax-highlighting');
 204
 205     my %light = (
 206         black       => 0,
 207         red         => 0,
 208         green       => 0,
 209         brown       => 0,
 210         blue        => 0,
 211         purple      => 0,
 212         cyan        => 0,
 213         light_gray  => 0,
 214         gray        => 0,
 215         dark_gray   => 1,
 216         light_red   => 1,
 217         light_green => 1,
 218         yellow      => 1,
 219         light_blue  => 1,
 220         pink        => 1,
 221         light_cyan  => 1,
 222         white       => 1,
 223     );
 224
 225     my %text = (
 226         black       => 30,
 227         red         => 31,
 228         green       => 32,
 229         brown       => 33,
 230         blue        => 34,
 231         purple      => 35,
 232         cyan        => 36,
 233         gray        => 37,
 234         light_gray  => 37,
 235         dark_gray   => 30,
 236         light_red   => 31,
 237         light_green => 32,
 238         yellow      => 33,
 239         light_blue  => 34,
 240         pink        => 35,
 241         light_cyan  => 36,
 242         white       => 37,
 243     );
 244
 245     my $bg_code = get_background();
 246     my $colour_code;
 247     our $default = default_colours();
 248
 249     if (defined($text{$colour})) {
 250         $colour_code  = ESCAPE;
 251         $colour_code .= $text{$colour};
 252         $colour_code .= ";";
 253         $colour_code .= $light{$colour} ? "1" : "2";
 254         $colour_code .= ";";
 255         $colour_code .= $bg_code;
 256         $colour_code .= "m";
 257         debug_message $colour . " is \'" . $colour_code . $colour . $default . "\'" if DEBUG_PAINT_IT;
 258
 259     } elsif ($colour =~ /reset/) {
 260
 261         $colour_code = default_colours();
 262
 263     } else {
 264
 265         die "What's $colour supposed to mean?\n";
 266     }
 267
 268     return $colour_code;
 269 }
 270
 271 sub get_semantic_html_markup ($) {
 272 ###############################################################
 273 # Takes a string and returns a span element
 274 ###############################################################
 275
 276     my $type = shift @_;
 277     my $code;
 278
 279     if ($type =~ /Standard/) {
 280         $code = '</span>';
 281     } else {
 282         $type = lc($type);
 283         $code = '<span title="' . $type . '" class="' . $type . '">';
 284     }
 285
 286     return $code;
 287 }
 288
 289 sub cli_option_is_set ($) {
 290
 291     our %cli_options;
 292     my $cli_option = shift;
 293
 294     die "Unknown CLI option: $cli_option" unless defined $cli_options{$cli_option};
 295
 296     return $cli_options{$cli_option};
 297 }
 298
 299 sub get_html_title () {
 300
 301     our %cli_options;
 302     return $cli_options{'title'};
 303
 304 }
 305
 306 sub init_css_colours() {
 307
 308     our %css_colours = (
 309         black       => "000",
 310         red         => "F00",
 311         green       => "0F0",
 312         brown       => "C90",
 313         blue        => "0F0",
 314         purple      => "F06", # XXX: wrong
 315         cyan        => "F09", # XXX: wrong
 316         light_gray  => "999",
 317         gray        => "333",
 318         dark_gray   => "222",
 319         light_red   => "F33",
 320         light_green => "33F",
 321         yellow      => "FF0",
 322         light_blue  => "30F",
 323         pink        => "F0F",
 324         light_cyan  => "66F",
 325         white       => "FFF",
 326     );
 327 }
 328
 329 sub get_css_colour ($) {
 330
 331    our %css_colours;
 332    my $colour = shift;
 333
 334    die "What's $colour supposed to mean?\n" unless defined($css_colours{$colour});
 335
 336    return '#' . $css_colours{$colour};
 337 }
 338
 339 sub get_css_line ($) {
 340
 341     our %h_colours;
 342
 343     my $class = shift;
 344     my $css_line;
 345
 346     $css_line .= '.' . lc($class) . ' {'; # XXX: lc() shouldn't be necessary
 347     die "What's $class supposed to mean?\n" unless defined($h_colours{$class});
 348     $css_line .= 'color:' . get_css_colour($h_colours{$class}) . ';';
 349     $css_line .= 'background-color:' . get_css_colour(DEFAULT_BACKGROUND) . ';';
 350     $css_line .= '}' . "\n";
 351
 352     return $css_line;
 353 }
 354
 355 sub get_css_line_for_colour ($) {
 356
 357     our %h_colours;
 358
 359     my $colour = shift;
 360     my $css_line;
 361
 362     $css_line .= '.' . lc($colour) . ' {'; # XXX: lc() shouldn't be necessary
 363     $css_line .= 'color:' . get_css_colour($colour) . ';';
 364     $css_line .= 'background-color:' . get_css_colour(DEFAULT_BACKGROUND) . ';';
 365     $css_line .= '}' . "\n";
 366
 367     return $css_line;
 368 }
 369
 370 # XXX: Wrong solution
 371 sub get_missing_css_lines () {
 372
 373     my $css_line;
 374
 375     $css_line .= '.' . 'default' . ' {';
 376     $css_line .= 'color:' . HEADER_DEFAULT_COLOUR . ';';
 377     $css_line .= 'background-color:' . get_css_colour(DEFAULT_BACKGROUND) . ';';
 378     $css_line .= '}' . "\n";
 379
 380     return $css_line;
 381 }
 382
 383 sub get_css () {
 384
 385     our %h_colours;
 386     our %css_colours; #XXX: Wrong solution
 387
 388     my $css = '';
 389
 390     $css .= '.privoxy-log {';
 391     $css .= 'color:' . get_css_colour(DEFAULT_TEXT_COLOUR) . ';';
 392     $css .= 'background-color:' . get_css_colour(DEFAULT_BACKGROUND) . ';';
 393     $css .= '}' . "\n";
 394
 395     foreach my $key (keys %h_colours) {
 396
 397         next if ($h_colours{$key} =~ m/reset/); #XXX: Wrong solution.
 398         $css .= get_css_line($key);
 399
 400     }
 401
 402     foreach my $colour (keys %css_colours) {
 403
 404         $css .= get_css_line_for_colour($colour);
 405
 406     }
 407
 408     $css .= get_missing_css_lines(); #XXX: Wrong solution
 409
 410     return $css;
 411 }
 412
 413 sub print_intro () {
 414
 415     my $intro = '';
 416
 417     if (cli_option_is_set('html-output')) {
 418
 419         my $title = get_html_title();
 420
 421         $intro .= '<html><head>';
 422         $intro .= '<title>' . $title . '</title>';
 423         $intro .= '<style>' . get_css() . '</style>' unless cli_option_is_set('no-embedded-css');
 424         $intro .= '</head><body>';
 425         $intro .= '<h1>' . $title . '</h1><p class="privoxy-log">';
 426
 427         print $intro;
 428     }
 429 }
 430
 431 sub print_outro () {
 432
 433     my $outro = '';
 434
 435     if (cli_option_is_set('html-output')) {
 436
 437         $outro = '</p></body></html>';
 438         print $outro;
 439
 440     }
 441 }
 442
 443 sub get_line_end () {
 444
 445     my $line_end = "\n";
 446
 447     $line_end = '<br>' . $line_end if cli_option_is_set('html-output');
 448
 449     return $line_end;
 450 }
 451
 452 sub get_colour_html_markup ($) {
 453 ###############################################################
 454 # Takes a colour string a span element. XXX: WHAT?
 455 # XXX: This function shouldn't be necessary, the
 456 # markup should always be semantically correct.
 457 ###############################################################
 458
 459     my $type = shift @_;
 460     my $code;
 461
 462     if ($type =~ /Standard/) {
 463         $code = '</span>';
 464     } else {
 465         $code = '<span class="' . lc($type) . '">';
 466     }
 467
 468     return $code;
 469 }
 470
 471 sub default_colours () {
 472     # XXX: Properly
 473     our $bg_code;
 474     return reset_colours();
 475 }
 476
 477 sub show_colours () {
 478     # XXX: Implement
 479 }
 480
 481 sub reset_colours () {
 482     return ESCAPE . "0m";
 483 }
 484
 485 sub set_background ($){
 486
 487     my $colour = shift;
 488     our $bg_code;
 489     my %backgrounds = (
 490               black       => "40",
 491               red         => "41",
 492               green       => "42",
 493               brown       => "43",
 494               blue        => "44",
 495               magenta     => "45",
 496               cyan        => "46",
 497               white       => "47",
 498               default     => "49",
 499     );
 500
 501     if (defined($backgrounds{$colour})) {
 502         $bg_code = $backgrounds{$colour};
 503     } else {
 504         die "Invalid background colour: " . $colour;
 505     }
 506 }
 507
 508 sub get_background (){
 509     return our $bg_code;
 510 }
 511
 512 sub prepare_highlight_hash ($) {
 513     my $ref = shift;
 514
 515     if (!cli_option_is_set('html-output')) {
 516
 517         foreach my $key (keys %$ref) {
 518             $$ref{$key} = paint_it($$ref{$key});
 519         }
 520
 521     } else {
 522
 523         foreach my $key (keys %$ref) {
 524             $$ref{$key} = get_semantic_html_markup($key);
 525         }
 526
 527     }
 528 }
 529
 530 sub prepare_colour_array ($) {
 531     my $ref = shift;
 532
 533     if (!cli_option_is_set('html-output')) {
 534
 535         foreach my $i (0 ... @$ref - 1) {
 536             $$ref[$i] = paint_it($$ref[$i]);
 537         }
 538
 539     } else {
 540
 541         foreach my $i (0 ... @$ref - 1) {
 542             $$ref[$i] = get_colour_html_markup($$ref[$i]);
 543         }
 544
 545     }
 546 }
 547
 548 sub found_unknown_content ($) {
 549
 550     my $unknown = shift;
 551     my $message;
 552
 553     our %req;
 554     our $t;
 555
 556     return if cli_option_is_set('accept-unknown-messages');
 557
 558     return if ($unknown =~ /\[too long, truncated\]$/);
 559
 560     $message = "found_unknown_content: Don't know how to highlight: ";
 561     # Break line so the log file can later be parsed as Privoxy log file again
 562     $message .= '"' . $unknown . '"' . " in:\n";
 563     $message .= $req{$t}{'log-message'};
 564     debug_message($message);
 565     log_parse_error($req{$t}{'log-message'});
 566
 567     die "Unworthy content parser" if PUNISH_MISSING_LOG_KNOWLEDGE_WITH_DEATH;
 568 }
 569
 570 sub log_parse_error ($) {
 571
 572     my $message = shift;
 573
 574     if (LOG_UNPARSED_LINES_TO_EXTRA_FILE) {
 575         open(ERRORLOG, ">>" . ERROR_LOG_FILE) || die "Writing " . ERROR_LOG_FILE . " failed";
 576         print ERRORLOG $message;
 577         close(ERRORLOG);
 578     }
 579 }
 580
 581 sub debug_message (@) {
 582     my @message = @_;
 583     our %h;
 584
 585     print $h{'debug'} . "@message" . $h{'Standard'} . "\n";
 586 }
 587
 588 ################################################################################
 589 # highlighter functions that aren't loglevel-specific
 590 ################################################################################
 591
 592 sub h ($) {
 593
 594     # Get highlight marker
 595     our %h;
 596     my $highlight = shift; # XXX: Stupid name;
 597     my $result = '';
 598     my $message;
 599
 600     if (defined($highlight)) {
 601
 602         $result = $h{$highlight};
 603
 604     } else {
 605
 606         $message = "h: Don't recognize highlighter $highlight.";
 607         debug_message($message);
 608         log_parser_error($message);
 609         die "Unworthy highlighter function" if PUNISH_MISSING_HIGHLIGHT_KNOWLEDGE_WITH_DEATH;
 610     }
 611
 612     return $result;
 613 }
 614
 615 sub highlight_known_headers ($) {
 616
 617     my $content = shift;
 618     our %header_colours;
 619     our %h;
 620     my $headers = join ('|', keys %header_colours);
 621
 622     debug_message("Searching $content for things to highlight.") if DEBUG_HEADER_HIGHLIGHTING;
 623
 624     if ($content =~ m/(?<=\s)($headers):/) {
 625         my $header = $1;
 626         $content =~ s@(?<=[\s|'])($header)(?=:)@$header_colours{$header}$1$h{'Standard'}@ig;
 627         debug_message("Highlighted $content") if DEBUG_HEADER_HIGHLIGHTING;
 628     }
 629
 630     return $content;
 631 }
 632
 633 sub highlight_matched_request_line ($$) {
 634
 635     my $result = shift; # XXX: Stupid name;
 636     my $regex = shift;
 637     if ($result =~ m@(.*)($regex)(.*)@) {
 638         $result = $1 . highlight_request_line($2) . $3
 639     }
 640     return $result;
 641 }
 642
 643 sub highlight_request_line ($) {
 644
 645     my $rl = shift;
 646     my ($method, $url, $http_version);
 647     our %h;
 648
 649     #GET http://images.sourceforge.net/sfx/icon_warning.gif HTTP/1.1
 650     if ($rl =~ m/Invalid request/) {
 651
 652         $rl = h('invalid-request') . $rl . h('Standard');
 653
 654     } elsif ($rl =~ m/^([-\w]+) (.*) (HTTP\/\d\.\d)/) {
 655
 656         # XXX: might not match in case of HTTP method fuzzing.
 657         # XXX: save these: ($method, $path, $http_version) = ($1, $2, $3);
 658         $rl =~ s@^(\w+)@$h{'method'}$1$h{'Standard'}@;
 659         if ($rl =~ /http:\/\//) {
 660             $rl = highlight_matched_url($rl, '[^\s]*(?=\sHTTP)');
 661         } else {
 662             $rl = highlight_matched_pattern($rl, 'request_', '[^\s]*(?=\sHTTP)');
 663         }
 664
 665         $rl =~ s@(HTTP\/\d\.\d)$@$h{'http-version'}$1$h{'Standard'}@;
 666
 667     } elsif ($rl =~ m/\.\.\. \[too long, truncated\]$/) {
 668
 669         $rl =~ s@^(\w+)@$h{'method'}$1$h{'Standard'}@;
 670         $rl = highlight_matched_url($rl, '[^\s]*(?=\.\.\.)');
 671
 672     } elsif ($rl =~ m/^ $/) {
 673
 674         $rl = h('error') . "No request line specified!" . h('Standard');
 675
 676     } else {
 677
 678         debug_message ("Can't parse request line: $rl");
 679
 680     }
 681
 682     return $rl;
 683 }
 684
 685 sub highlight_response_line ($) {
 686
 687     my $rl = shift;
 688     my ($http_version, $status_code, $status_message);
 689
 690     #HTTP/1.1 200 OK
 691     #ICY 200 OK
 692
 693     # TODO: Mark different status codes differently
 694
 695     if ($rl =~ m/((?:HTTP\/\d\.\d|ICY)) (\d+) (.*)/) {
 696         ($http_version, $status_code, $status_message) = ($1, $2, $3);
 697     } else {
 698         debug_message ("Can't parse response line: $rl") and die 'Fix this';
 699     }
 700
 701     # Rebuild highlighted
 702     $rl= "";
 703     $rl .= h('http-version') . $http_version . h('Standard');
 704     $rl .= " ";
 705     $rl .= h('status-code') . $status_code . h('Standard');
 706     $rl .= " ";
 707     $rl .= h('status-message') . $status_message . h('Standard');
 708
 709     return $rl;
 710 }
 711
 712 sub highlight_matched_url ($$) {
 713
 714     my $result = shift; # XXX: Stupid name;
 715     my $regex = shift;
 716
 717     #print "Got $result, regex ($regex)\n";
 718
 719     if ($result =~ m@(.*?)($regex)(.*)@) {
 720         $result = $1 . highlight_url($2) . $3;
 721         #print "Now the result is $result\n";
 722     }
 723
 724     return $result;
 725 }
 726
 727 sub highlight_matched_host ($$) {
 728
 729     my $result = shift; # XXX: Stupid name;
 730     my $regex = shift;
 731
 732     if ($result =~ m@(.*?)($regex)(.*)@) {
 733         $result = $1 . h('host') . $2 . h('Standard') . $3;
 734     }
 735
 736     return $result;
 737 }
 738
 739 sub highlight_matched_pattern ($$$) {
 740
 741     our %h;
 742     my $result = shift; # XXX: Stupid name;
 743     my $key = shift;
 744     my $regex = shift;
 745
 746     die "Unknown key $key" unless defined $h{$key};
 747
 748     if ($result =~ m@(.*?)($regex)(.*)@) {
 749         $result = $1 . h($key) . $2 . h('Standard') . $3;
 750     }
 751
 752     return $result;
 753 }
 754
 755 sub highlight_matched_path ($$) {
 756
 757     my $result = shift; # XXX: Stupid name;
 758     my $regex = shift;
 759
 760     if ($result =~ m@(.*?)($regex)(.*)@) {
 761         $result = $1 . h('path') . $2 . h('Standard') . $3;
 762     }
 763
 764     return $result;
 765 }
 766
 767 sub highlight_url ($) {
 768
 769     my $url = shift;
 770
 771     if (cli_option_is_set('html-output')) {
 772
 773         $url = '<a href="' . $url . '">' . $url . '</a>';
 774
 775     } else {
 776
 777         $url = h('URL') . $url . h('Standard');
 778
 779     }
 780
 781     return $url;
 782 }
 783
 784 ################################################################################
 785 # loglevel-specific highlighter functions
 786 ################################################################################
 787
 788 sub handle_loglevel_header ($) {
 789
 790     my $content = shift;
 791     my $c = $content;
 792     our $t;
 793     our %req;
 794     our %h;
 795     our %header_colours;
 796     our @all_colours;
 797     our $header_colour_index;
 798     our $no_special_header_highlighting;
 799
 800     # Register new headers
 801     # scan: Accept: image/png,image/*;q=0.8,*/*;q=0.5
 802     if ($c =~ m/^scan: ((?>[^:]+)):/) {
 803         my $header = $1;
 804         if (!defined($header_colours{$header}) and $header =~ /^[\d\w-]*$/) {
 805             debug_message "Registering previously unknown header $1" if DEBUG_HEADER_REGISTERING;
 806
 807             if (REGISTER_HEADERS_WITH_THE_SAME_COLOUR) {
 808                 $header_colours{$header} =  $header_colours{'Default'};
 809             } else {
 810                 $header_colours{$header} = $all_colours[$header_colour_index % @all_colours];
 811                 $header_colour_index++;
 812             }
 813         }
 814     }
 815
 816     if ($c =~ m/^scan: ((\w*) (.*) (HTTP\/\d\.\d))/) {
 817
 818             # Client request line
 819             # Save for statistics (XXX: Not implemented yet)
 820             $req{$t}{'method'} = $2;
 821             $req{$t}{'destination'} = $3;
 822             $req{$t}{'http-version'} = $4;
 823
 824             $content = highlight_request_line($1);
 825
 826     } elsif ($c =~ m/^(scan: )((?:HTTP\/\d\.\d|ICY) (\d+) (.*))/) {
 827
 828             # Server response line
 829             $req{$t}{'response_line'} = $2;
 830             $req{$t}{'status_code'} = $3;
 831             $req{$t}{'status_message'} = $4;
 832             $content = $1 . highlight_response_line($req{$t}{'response_line'});
 833
 834     } elsif ($c =~ m/^Crunching (?:server|client) header: .* \(contains: ([^\)]*)\)/) {
 835
 836         # Crunching server header: Set-Cookie: trac_form_token=d5308c34e16d15e9e301a456; (contains: Cookie:)
 837         $content =~ s@(?<=contains: )($1)@$h{'crunch-pattern'}$1$h{'Standard'}@;
 838         $content =~ s@(Crunching)@$h{$1}$1$h{'Standard'}@;
 839
 840     } elsif ($c =~ m/^New host is: ([^\s]*)\./) {
 841
 842         # New host is: trac.vidalia-project.net. Crunching Referer: http://www.vidalia-project.net/
 843         $c = highlight_matched_host($c, '(?<=New host is: )[^\s]+');
 844         $content = highlight_matched_url($c, '(?<=Crunching Referer: )[^\s]+');
 845
 846     } elsif ($c =~ m/^Text mode enabled by force. (Take cover)!/) {
 847
 848         # Text mode enabled by force. Take cover!
 849         $content =~ s@($1)@$h{'warning'}$1$h{'Standard'}@;
 850
 851     } elsif ($c =~ m/^(New HTTP Request-Line: )(.*)/) {
 852
 853         # New HTTP Request-Line: GET http://www.privoxy.org/ HTTP/1.1
 854         $content = $1 . highlight_request_line($2);
 855
 856     } elsif ($c =~ m/^Adjust(ed)? Content-Length to \d+/) {
 857
 858         # Adjusted Content-Length to 2132
 859         # Adjust Content-Length to 33533
 860         $content =~ s@(?<=Content-Length to )(\d+)@$h{'Number'}$1$h{'Standard'}@;
 861         $content = highlight_known_headers($content);
 862
 863     } elsif ($c =~ m/^Destination extracted from "Host:" header. New request URL:/) {
 864
 865         # Destination extracted from "Host:" header. New request URL: http://www.cccmz.de/~ridcully/blog/
 866         $content = highlight_matched_url($content, '(?<=New request URL: ).*');
 867
 868     } elsif ($c =~ m/^Couldn\'t parse:/) {
 869
 870         # XXX: These should probable be logged with LOG_LEVEL_ERROR
 871         # Couldn't parse: If-Modified-Since: Wed, 21 Mar 2007 16:34:50 GMT (crunching!)
 872         # Couldn't parse: at, 24 Mar 2007 13:46:21 GMT in If-Modified-Since: Sat, 24 Mar 2007 13:46:21 GMT (crunching!)
 873         $content =~ s@^(Couldn\'t parse)@$h{'error'}$1$h{'Standard'}@;
 874
 875     } elsif ($c =~ /^Tagger \'([^\']*)\' added tag \'([^\']*)\'/ or
 876              $c =~ m/^Adding tag \'([^\']*)\' created by header tagger \'([^\']*)\'/) {
 877
 878         # Adding tag 'GET request' created by header tagger 'method-man' (XXX: no longer used)
 879         # Tagger 'revalidation' added tag 'REVALIDATION-REQUEST'. No action bit update necessary.
 880         # Tagger 'revalidation' added tag 'REVALIDATION-REQUEST'. Action bits updated accordingly.
 881
 882         # XXX: Save tag and tagger
 883
 884         $content =~ s@(?<=^Tagger \')([^\']*)@$h{'tagger'}$1$h{'Standard'}@;
 885         $content =~ s@(?<=added tag \')([^\']*)@$h{'tag'}$1$h{'Standard'}@;
 886         $content =~ s@(?<=Action bits )(updated)@$h{'action-bits-update'}$1$h{'Standard'}@;
 887         $no_special_header_highlighting = 1;
 888
 889     } elsif ($c =~ /^Tagger \'([^\']*)\' didn['']t add tag \'([^\']*)\'/) {
 890
 891         # Tagger 'revalidation' didn't add tag 'REVALIDATION-REQUEST'. Tag already present
 892         # XXX: Save tag and tagger
 893
 894         $content =~ s@(?<=^Tagger \')([^\']*)@$h{'tag'}$1$h{'Standard'}@;
 895         $content =~ s@(?<=didn['']t add tag \')([^\']*)@$h{'tagger'}$1$h{'Standard'}@;
 896
 897     } elsif ($c =~ m/^(?:scan:|Randomiz|addh:|Adding:|Removing:|Referer:|Modified:|Accept-Language header|[Cc]ookie)/
 898           or $c =~ m/^(Text mode is already enabled|Denied request with NULL byte|Replaced:|add-unique:)/
 899           or $c =~ m/^(Crunched (incoming|outgoing) cookie|Suppressed offer|Accepted the client)/
 900           or $c =~ m/^(addh-unique|Referer forged to)/
 901           or $c =~ m/^Downgraded answer to HTTP\/1.0/
 902           or $c =~ m/^Parameter: \+hide-referrer\{[^\}]*\} is a bad idea, but I don\'t care./
 903           or $c =~ m/^Referer (?:overwritten|replaced) with: Referer: / #XXX: should this be highlighted?
 904           or $c =~ m/^Referer crunched!/
 905           or $c =~ m/^crunched x-forwarded-for!/
 906           or $c =~ m/^crunched From!/
 907           or $c =~ m/^ modified$/
 908           or $c =~ m/^Content filtering is enabled. Crunching:/
 909           or $c =~ m/^force-text-mode overruled the client/
 910           or $c =~ m/^Server time in the future\./
 911           or $c =~ m/^content-disposition header crunched and replaced with:/i
 912           or $c =~ m/^Reducing white space in /
 913           or $c =~ m/^Ignoring single quote in /
 914           or $c =~ m/^Converting tab to space in /
 915           or $c =~ m/A HTTP\/1\.1 response without/
 916           or $c =~ m/Disabled filter mode on behalf of the client/
 917           or $c =~ m/Keeping the (?:server|client) header /
 918           or $c =~ m/Content modified with no Content-Length header set/
 919           or $c =~ m/^Appended client IP address to/
 920           or $c =~ m/^Removing 'Connection: close' to imply keep-alive./
 921             )
 922     {
 923         # XXX: Some of these may need highlighting
 924
 925         # Modified: User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; pl-PL; rv:1.8.1.1) Gecko/20070214 Firefox/2.0.0.1
 926         # Accept-Language header crunched and replaced with: Accept-Language: pl-pl
 927         # cookie 'Set-Cookie: eZSessionCookie=07bfec287c197440d299f81580593c3d; \
 928         #  expires=Thursday, 12-Apr-07 15:16:18 GMT; path=/' send by \
 929         #  http://wirres.net/article/articleview/4265/1/6/ appears to be using time format 1 (XXX: gone with the wind)
 930         # Cookie rewritten to a temporary one: Set-Cookie: NSC_gffe-iuuq-mc-wtfswfs=8efb33a53660;path=/
 931         # Text mode is already enabled
 932         # Denied request with NULL byte(s) turned into line break(s)
 933         # Replaced: 'Connection: Yo, home to Bel Air' with 'Connection: close'
 934         # addh-unique: Host: people.freebsd.org
 935         # Suppressed offer to compress content
 936         # Crunched incoming cookie -- yum!
 937         # Accepted the client's request to fetch without filtering.
 938         # Crunched outgoing cookie: Cookie: PREF=ID=6cf0abd347b30262:TM=1173357617:LM=1173357617:S=jZypyyJ7LPiwFi1_
 939         # addh-unique: Host: subkeys.pgp.net:11371
 940         # Referer forged to: Referer: http://10.0.0.1/
 941         # Downgraded answer to HTTP/1.0
 942         # Parameter: +hide-referrer{pille-palle} is a bad idea, but I don't care.
 943         # Referer overwritten with: Referer: pille-palle
 944         # Referer replaced with: Referer: pille-palle
 945         # crunched x-forwarded-for!
 946         # crunched From!
 947         #  modified # XXX: pretty stupid log message
 948         # Content filtering is enabled. Crunching: 'Range: 1234-5678' to prevent range-mismatch problems
 949         # force-text-mode overruled the client's request to fetch without filtering!
 950         # Server time in the future.
 951         # content-disposition header crunched and replaced with: content-disposition: filename=baz
 952         # Content-Disposition header crunched and replaced with: content-disposition: filename=baz
 953         # Reducing white space in 'X-LWS-Test: "This  is  quoted" this is not "this  is  " but " this again   is  not'
 954         # Ignoring single quote in 'X-LWS-Test: "This  is  quoted" this is not "this  is  " but "  this again   is  not'
 955         # Converting tab to space in 'X-LWS-Test:   "This  is  quoted" this   is  not "this  is  "  but  "\
 956         #  this again   is  not'
 957         # A HTTP/1.1 response without Connection header implies keep-alive.
 958         # Disabled filter mode on behalf of the client.
 959         # Keeping the server header 'Connection: keep-alive' around.
 960         # Keeping the client header 'Connection: close' around. The connection will not be kept alive.
 961         # Keeping the client header 'Connection: keep-alive' around. The connection will be kept alive if possible.
 962         # Content modified with no Content-Length header set. Creating a fake one for adjustment later on.
 963         # Appended client IP address to X-Forwarded-For: 10.0.0.2, 10.0.0.1
 964         # Removing 'Connection: close' to imply keep-alive.
 965
 966     } elsif ($c =~ m/^scanning headers for:/) {
 967
 968         return '' unless SHOW_SCAN_INTRO;
 969
 970     } elsif ($c =~ m/^[Cc]runch(ing|ed)|crumble crunched:/) {
 971         # crunched User-Agent!
 972         # Crunching: Content-Encoding: gzip
 973
 974         $content =~ s@(Crunching|crunched)@$h{$1}$1$h{'Standard'}@;
 975
 976     } elsif ($c =~ m/^Offending request data with NULL bytes turned into \'°\' characters:/) {
 977
 978         # Offending request data with NULL bytes turned into '°' characters: °°n°°(°°°
 979
 980         $content = h('warning') . $content . h('Standard');
 981
 982     } elsif ($c =~ m/^(Transforming \")(.*?)(\" to \")(.*?)(\")/) {
 983
 984         # Transforming "Proxy-Authenticate: Basic realm="Correos Proxy Server"" to\
 985         #  "Proxy-Authenticate: Basic realm="Correos Proxy Server""
 986
 987        $content =~ s@(?<=^Transforming \")(.*)(?=\" to)@$h{'Header'}$1$h{'Standard'}@;
 988        $content =~ s@(?<=to \")(.*)(?=\")@$h{'Header'}$1$h{'Standard'}@;
 989
 990     } elsif ($c =~ m/^Removing empty header/) {
 991
 992         # Removing empty header
 993         # Ignore for now
 994
 995     } elsif ($c =~ m/^Content-Type: .* not replaced/) {
 996
 997         # Content-Type: application/octet-stream not replaced. It doesn't look like text.\
 998         #  Enable force-text-mode if you know what you're doing.
 999         # XXX: Could highlight more here.
1000         $content =~ s@(?<=^Content-Type: )(.*)(?= not replaced)@$h{'content-type'}$1$h{'Standard'}@;
1001
1002     } elsif ($c =~ m/^(Server|Client) keep-alive timeout is/) {
1003
1004        # Server keep-alive timeout is 5. Sticking with 10.
1005        # Client keep-alive timeout is 20. Sticking with 10.
1006
1007        $content =~ s@(?<=timeout is )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1008        $content =~ s@(?<=Sticking with )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1009
1010     } elsif ($c =~ m/^Reducing keep-alive timeout/) {
1011
1012        # Reducing keep-alive timeout from 60 to 10.
1013
1014        $content =~ s@(?<= from )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1015        $content =~ s@(?<= to )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1016
1017     } else {
1018
1019         found_unknown_content($content);
1020     }
1021
1022     # Highlight headers
1023     unless ($c =~ m/^Transforming/) {
1024         $content = highlight_known_headers($content) unless $no_special_header_highlighting;
1025     }
1026
1027     return $content;
1028 }
1029
1030 sub handle_loglevel_re_filter ($) {
1031
1032     my $content = shift;
1033     my $c = $content;
1034     my $key;
1035     our $t;
1036     our %req;
1037     our %h;
1038     our %header_colours;
1039     our @all_colours;
1040     our $header_colour_index;
1041
1042     if ($c =~ /\.{3}$/
1043         and $c =~ m/^(?:re_)?filtering \'?(.*?)\'? \(size (\d*)\) with (?:filter )?\'?([^\s]*?)\'? ?\.{3}$/) {
1044
1045         # Used by Privoxy 3.0.5 and 3.0.6:
1046         # XXX: Fill in ...
1047         # Used by Privoxy 3.0.7:
1048         # filtering 'Connection: close' (size 17) with 'generic-content-ads' ...
1049
1050         $req{$t}{'filtered_header'} = $1;
1051         $req{$t}{'old_header_size'} = $2;
1052         $req{$t}{'header_filter_name'} = $3;
1053
1054         unless (cli_option_is_set('show-ineffective-filters') or
1055                 $req{$t}{'header_filter_name'} =~ m/^privoxy-filter-test$/) {
1056             return '';
1057         }
1058         $content =~ s@(?<=\(size )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1059         $content =~ s@($req{$t}{'header_filter_name'})@$h{'filter'}$1$h{'Standard'}@;
1060
1061     } elsif ($c =~ m/^ ?\.\.\. ?produced (\d*) hits \(new size (\d*)\)\./) {
1062
1063         # ...produced 0 hits (new size 23).
1064         #... produced 1 hits (new size 54).
1065
1066         $req{$t}{'header_filter_hits'} = $1;
1067         $req{$t}{'new_header_size'} = $2;
1068
1069         unless (cli_option_is_set('show-ineffective-filters') or
1070                 (defined($req{$t}{'header_filter_name'}) and
1071                  $req{$t}{'header_filter_name'} =~ m/^privoxy-filter-test$/)) {
1072
1073             if ($req{$t}{'header_filter_hits'} == 0 and
1074                 not (defined($req{$t}{'header_filter_name'}) and
1075                  $req{$t}{'header_filter_name'} =~ m/^privoxy-filter-test$/)) {
1076                 return '';
1077             }
1078             # Reformat including information from the intro
1079             $c = "'" . h('filter') . $req{$t}{'header_filter_name'} . h('Standard') . "'";
1080             $c .= " hit ";
1081             # XXX: Hide behind constant, it may be interesting if LOG_LEVEL_HEADER isn't enabled as well.
1082             # $c .= $req{$t}{'filtered_header'} . " ";
1083             $c .= h('Number') . $req{$t}{'header_filter_hits'}. h('Standard');
1084             $c .= ($req{$t}{'header_filter_hits'} == 1) ? " time, " : " times, ";
1085
1086             if ($req{$t}{'old_header_size'} !=  $req{$t}{'new_header_size'}) {
1087
1088                 $c .= "changing size from ";
1089                 $c .=  h('Number') . $req{$t}{'old_header_size'} . h('Standard');
1090                 $c .= " to ";
1091                 $c .= h('Number') . $req{$t}{'new_header_size'} . h('Standard');
1092                 $c .= ".";
1093
1094             } else {
1095
1096                 $c .= "keeping the size at " . $req{$t}{'old_header_size'};
1097
1098             }
1099
1100             # Highlight from last line (XXX: What?)
1101             # $c =~ s@(?<=produced )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1102             # $c =~ s@($req{$t}{'header_filter_name'})@$h{'filter'}$1$h{'Standard'}@;
1103
1104         } else {
1105
1106            # XXX: Untested
1107            $c =~ s@(?<=produced )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1108            $c =~ s@(?<=new size )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1109
1110         }
1111         $content = $c;
1112
1113     } elsif ($c =~ m/^(Tagger|Filter) ([^\s]*) has empty joblist. Nothing to do./) {
1114
1115         # Filter privoxy-filter-test has empty joblist. Nothing to do.
1116         # Tagger variable-test has empty joblist. Nothing to do.
1117
1118         $content =~ s@(?<=$1 )([^\s]*)@$h{'filter'}$1$h{'Standard'}@;
1119
1120     } elsif ($c =~ m/^(?:re_)?filtering ([^\s]+) \(size (\d+)\) with (?:filter )?\'?([^\s]+?)\'? produced (\d+) hits \(new size (\d+)\)/) {
1121
1122         # XXX: only the second version gets highlighted properly.
1123         # re_filtering www.lfk.de/favicon.ico (size 209) with filter untrackable-hulk produced 0 hits (new size 209).
1124         # filtering aci.blogg.de/ (size 37988) with 'blogg.de' produced 3 hits (new size 38057)
1125         $req{$t}{'content_source'} = $1;
1126         $req{$t}{'content_size'}   = $2;
1127         $req{$t}{'content_filter'} = $3;
1128         $req{$t}{'content_hits'}   = $4;
1129         $req{$t}{'new_content_size'} = $5;
1130         $req{$t}{'content_size_change'} = $req{$t}{'new_content_size'} - $req{$t}{'content_size'};
1131         #return '' if ($req{$t}{'content_hits'} == 0 && !cli_option_is_set('show-ineffective-filters'));
1132         if ($req{$t}{'content_hits'} == 0 and
1133             not (cli_option_is_set('show-ineffective-filters')
1134                  or ($req{$t}{'content_filter'} =~ m/^privoxy-filter-test$/))) {
1135                 return '';
1136         }
1137
1138         $c =~ s@(?<=\(size )(\d+)\)(?= with)@$h{'Number'}$1$h{'Standard'}@;
1139         $c =~ s@(?<=\(new size )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1140         $c =~ s@(?<=produced )(\d+)(?= hits)@$h{'Number'}$1$h{'Standard'}@;
1141
1142         $c =~ s@([^\s]+?)(\'? produced)@$h{'filter'}$1$h{'Standard'}$2@;
1143         $c = highlight_matched_host($c, '(?<=filtering )[^\s]+');
1144
1145         $c =~ s@\.$@ @;
1146         $c .= "(" . $h{'Number'};
1147         $c .= "+" if ($req{$t}{'content_size_change'} >= 0);
1148         $c .= $req{$t}{'content_size_change'} . $h{'Standard'} . ")";
1149         $content = $c;
1150
1151     } elsif ($c =~ m/^De-chunking successful. Shrunk from (\d+) to (\d+)/) {
1152
1153         $req{$t}{'chunked-size'} = $1;
1154         $req{$t}{'dechunked-size'} = $2;
1155         $req{$t}{'dechunk-change'} = $req{$t}{'dechunked-size'} - $req{$t}{'chunked-size'};
1156
1157         $content .= " (" . h('Number') . $req{$t}{'dechunk-change'} . h('Standard') . ")";
1158
1159         $content =~ s@(?<=from )($req{$t}{'chunked-size'})@$h{'Number'}$1$h{'Standard'}@;
1160         $content =~ s@(?<=to )($req{$t}{'dechunked-size'})@$h{'Number'}$1$h{'Standard'}@;
1161
1162     } elsif ($c =~ m/^Decompression successful. Old size: (\d+), new size: (\d+)./) {
1163
1164         # Decompression successful. Old size: 670, new size: 1166.
1165
1166         $req{$t}{'size-compressed'} = $1;
1167         $req{$t}{'size-decompressed'} = $2;
1168         $req{$t}{'decompression-gain'} = $req{$t}{'size-decompressed'} - $req{$t}{'size-compressed'};
1169
1170         $content =~ s@(?<=Old size: )($req{$t}{'size-compressed'})@$h{'Number'}$1$h{'Standard'}@;
1171         $content =~ s@(?<=new size: )($req{$t}{'size-decompressed'})@$h{'Number'}$1$h{'Standard'}@;
1172
1173         # XXX: Create sub get_percentage()
1174         if ($req{$t}{'size-decompressed'}) {
1175             $req{$t}{'decompression-gain-percent'} =
1176                 $req{$t}{'decompression-gain'} / $req{$t}{'size-decompressed'} * 100;
1177
1178             $content .= " (saved: ";
1179             #$content .= h('Number') . $req{$t}{'decompression-gain'} . h('Standard');
1180             #$content .= "/";
1181             $content .= h('Number') . sprintf("%.2f%%", $req{$t}{'decompression-gain-percent'}) . h('Standard');
1182             $content .= ")";
1183         }
1184
1185     } elsif ($c =~ m/^(Need to de-chunk first)/) {
1186
1187         # Need to de-chunk first
1188         return '' if SUPPRESS_NEED_TO_DE_CHUNK_FIRST;
1189
1190     } elsif ($c =~ m/^(Adding (?:dynamic )?re_filter job)/) {
1191
1192         return ''  if (SUPPRESS_SUCCEEDED_FILTER_ADDITIONS && m/succeeded/);
1193
1194         # Adding re_filter job ...
1195         # Adding dynamic re_filter job s@^(?:\w*)\s+.*\s+HTTP/\d\.\d\s*@IP-ADDRESS: $origin@D\
1196         #  to filter client-ip-address succeeded.
1197
1198     } elsif ($c =~ m/^Reading in filter/) {
1199
1200         return '' unless SHOW_FILTER_READIN_IN;
1201
1202     } else {
1203
1204         found_unknown_content($content);
1205
1206     }
1207
1208     return $content;
1209 }
1210
1211 sub handle_loglevel_redirect ($) {
1212
1213     my $c = shift;
1214     our $t;
1215     our %req;
1216     our %h;
1217
1218     if ($c =~ m/^Decoding "([^""]*)"/) {
1219
1220          $req{$t}{'original-destination'} = $1;
1221          $c = highlight_matched_path($c, '(?<=Decoding ")[^"]*');
1222          $c =~ s@\"@@g;
1223
1224     } elsif ($c =~ m/^Checking/) {
1225
1226          # Checking /_ylt=A0geu.Z76BRGR9k/**http://search.yahoo.com/search?p=view+odb+presentation+on+freebsd\
1227          #  &ei=UTF-8&xargs=0&pstart=1&fr=moz2&b=11 for redirects.
1228
1229          # TODO: Change colour if really url-decoded
1230          $req{$t}{'decoded-original-destination'} = $1;
1231          $c = highlight_matched_path($c, '(?<=Checking ")[^"]*');
1232          $c =~ s@\"@@g;
1233
1234     } elsif ($c =~ m/^pcrs command "([^""]*)" changed "([^""]*)" to "([^""]*)" \((\d+) hits?\)/) {
1235
1236         # pcrs command "s@&from=rss@@" changed "http://it.slashdot.org/article.pl?sid=07/03/02/1657247&from=rss"\
1237         #  to "http://it.slashdot.org/article.pl?sid=07/03/02/1657247" (1 hit).
1238
1239         my ($pcrs_command, $url_before, $url_after, $hits) = ($1, $2, $3, $4); # XXX: save these?
1240
1241         $c =~ s@(?<=pcrs command )"([^""]*)"@$h{'filter'}$1$h{'Standard'}@;
1242         $c = highlight_matched_url($c, '(?<=changed ")[^""]*');
1243         $c =~ s@(?<=changed )"([^""]*)"@$1@; # Remove quotes
1244         $c = highlight_matched_url($c, '(?<=to ")[^""]*');
1245         $c =~ s@(?<=to )"([^""]*)"@$1@; # Remove quotes
1246         $c =~ s@(\d+)(?= hits?)@$h{'hits'}$1$h{'Standard'}@;
1247
1248     } elsif ($c =~ m/(^New URL is: )(.*)/) {
1249
1250         # New URL is: http://it.slashdot.org/article.pl?sid=07/03/04/1511210
1251         # XXX: Use URL highlighter
1252         # XXX: Save?
1253         $c = $1 . h('rewritten-URL') . $2 . h('Standard');
1254
1255     } elsif ($c =~ m/No pcrs command recognized, assuming that/) {
1256         # No pcrs command recognized, assuming that "http://config.privoxy.org/user-manual/favicon.png"\
1257         #  is already properly formatted.
1258         # XXX: assume the same?
1259         $c = highlight_matched_url($c, '(?<=assuming that \")[^"]*');
1260
1261     } else {
1262
1263         found_unknown_content($c);
1264
1265     }
1266
1267     return $c;
1268 }
1269
1270 sub handle_loglevel_gif_deanimate ($) {
1271
1272     my $content = shift;
1273     our $t;
1274     our %req;
1275     our %h;
1276
1277     if ($content =~ m/Success! GIF shrunk from (\d+) bytes to (\d+)\./) {
1278
1279         my $bytes_from = $1;
1280         my $bytes_to = $2;
1281         # Gif-Deanimate: Success! GIF shrunk from 205 bytes to 133.
1282         $content =~ s@$bytes_from@$h{'Number'}$bytes_from$h{'Standard'}@;
1283         # XXX: Do we need g in case of ($1 == $2)?
1284         $content =~ s@$bytes_to@$h{'Number'}$bytes_to$h{'Standard'}@;
1285
1286     } elsif ($content =~ m/GIF (not) changed/) {
1287
1288         # Gif-Deanimate: GIF not changed.
1289         return '' if SUPPRESS_GIF_NOT_CHANGED;
1290         $content =~ s@($1)@$h{'not'}$1$h{'Standard'}@;
1291
1292     } elsif ($content =~ m/^failed! \(gif parsing\)/) {
1293
1294         # failed! (gif parsing)
1295         # XXX: Replace this error message with something less stupid
1296         $content =~ s@(failed!)@$h{'error'}$1$h{'Standard'}@;
1297
1298     } elsif ($content =~ m/^Need to de-chunk first/) {
1299
1300         # Need to de-chunk first
1301         return '' if SUPPRESS_NEED_TO_DE_CHUNK_FIRST;
1302
1303     } elsif ($content =~ m/^(?:No GIF header found|failed while parsing)/) {
1304
1305         # No GIF header found (XXX: Did I ever commit this?)
1306         # failed while parsing 195 134747048 (XXX: never commited)
1307
1308         # Ignore these for now
1309
1310     } else {
1311
1312         found_unknown_content($content);
1313
1314     }
1315
1316     return $content;
1317 }
1318
1319 sub handle_loglevel_request ($) {
1320
1321     my $content = shift;
1322     our $t;
1323     our %req;
1324     our %h;
1325     our %reason_colours;
1326
1327     if ($content =~ m/crunch! /) {
1328
1329         # config.privoxy.org/send-stylesheet crunch! (CGI Call)
1330
1331         # Highlight crunch reasons
1332         foreach my $reason (keys %reason_colours) {
1333             $content =~ s@\(($reason)\)@$reason_colours{$reason}($1)$h{'Standard'}@g;
1334         }
1335         # Highlight request URL domain and ditch 'crunch!'
1336         $content = highlight_matched_pattern($content, 'request_', '[^ ]*(?= crunch!)');
1337         $content =~ s@ crunch!@@;
1338
1339     } elsif ($content =~ m/\[too long, truncated\]$/) {
1340
1341         # config.privoxy.org/edit-actions-submit?f=3&v=1176116716&s=7&Submit=Submit[...]&filter... [too long, truncated]
1342         $content = highlight_matched_pattern($content, 'request_', '^.*(?=\.\.\. \[too long, truncated\]$)');
1343
1344     } elsif ($content =~ m/(.*)/) { # XXX: Pretty stupid
1345
1346         # trac.vidalia-project.net/wiki/Volunteer?format=txt
1347         $content = h('request_') . $content . h('Standard');
1348
1349     } else {  # XXX: Nop
1350
1351         found_unknown_content($content);
1352
1353     }
1354
1355     return $content;
1356 }
1357
1358 sub handle_loglevel_crunch ($) {
1359
1360     my $content = shift;
1361     our %h;
1362     our %reason_colours;
1363
1364     # Highlight crunch reason
1365     foreach my $reason (keys %reason_colours) {
1366         $content =~ s@($reason)@$reason_colours{$reason}$1$h{'Standard'}@g;
1367     }
1368
1369     if ($content =~ m/\[too long, truncated\]$/) {
1370
1371         # Blocked: config.privoxy.org/edit-actions-submit?f=3&v=1176116716&s=7&Submit=Submit\
1372         #  [...]&filter... [too long, truncated]
1373         $content = highlight_matched_pattern($content, 'request_', '^.*(?=\.\.\. \[too long, truncated\]$)');
1374
1375     } else {
1376
1377         # Blocked: http://ads.example.org/
1378         $content = highlight_matched_pattern($content, 'request_', '(?<=: ).*');
1379     }
1380
1381     return $content;
1382 }
1383
1384 sub handle_loglevel_connect ($) {
1385
1386     my $c = shift;
1387     our $t;
1388     our %req;
1389     our %h;
1390
1391     if ($c =~ m/^via [^\s]+ to: [^\s]+/) {
1392
1393         # Connect: via 10.0.0.1:8123 to: www.example.org.noconnect
1394
1395         $c = highlight_matched_host($c, '(?<=via )[^\s]+');
1396         $c = highlight_matched_host($c, '(?<=to: )[^\s]+');
1397
1398     } elsif ($c =~ m/^connect to: .* failed: .*/) {
1399
1400         # connect to: www.example.org.noconnect failed: Operation not permitted
1401
1402         $c = highlight_matched_host($c, '(?<=connect to: )[^\s]+');
1403
1404         $c =~ s@(?<=failed: )(.*)@$h{'error'}$1$h{'Standard'}@;
1405
1406     } elsif ($c =~ m/^to ([^\s]*)( successful)?$/) {
1407
1408         # Connect: to www.nzherald.co.nz successful
1409         # Connect: to archiv.radiotux.de
1410
1411         return '' if SUPPRESS_SUCCESSFUL_CONNECTIONS;
1412         $c = highlight_matched_host($c, '(?<=to )[^\s]+');
1413
1414     } elsif ($c =~ m/^to ([^\s]*)$/) {
1415
1416         # Connect: to lists.sourceforge.net:443
1417
1418         $c = highlight_matched_host($c, '(?<=to )[^\s]+');
1419
1420     } elsif ($c =~ m/^accepted connection from .*/ or
1421              $c =~ m/^OK/) {
1422
1423         # accepted connection from 10.0.0.1
1424         # Privoxy 3.0.6 and earlier just say:
1425         # OK
1426         return '' if SUPPRESS_ACCEPTED_CONNECTIONS;
1427         $c = highlight_matched_host($c, '(?<=connection from ).*');
1428
1429     } elsif ($c =~ m/^write header to: .* failed:/) {
1430
1431         # write header to: 10.0.0.1 failed: Broken pipe
1432
1433         $c = highlight_matched_host($c, '(?<=write header to: )[^\s]*');
1434         $c =~ s@(?<=failed: )(.*)@$h{'Error'}$1$h{'Standard'}@;
1435
1436     } elsif ($c =~ m/^write header to client failed:/) {
1437
1438         # write header to client failed: Broken pipe
1439         # XXX: Stil in use?
1440         $c =~ s@(?<=failed: )(.*)@$h{'Error'}$1$h{'Standard'}@;
1441
1442     } elsif ($c =~ m/^socks4_connect:/) {
1443
1444         # socks4_connect: SOCKS request rejected or failed.
1445         $c =~ s@(?<=socks4_connect: )(.*)@$h{'Error'}$1$h{'Standard'}@;
1446
1447     } elsif ($c =~ m/^Listening for new connections/ or
1448              $c =~ m/^accept connection/) {
1449         # XXX: Highlight?
1450         # Privoxy versions above 3.0.6 say:
1451         # Listening for new connections ...
1452         # earlier versions say:
1453         # accept connection ...
1454         return '';
1455
1456     } elsif ($c =~ m/^accept failed:/) {
1457
1458         $c =~ s@(?<=accept failed: )(.*)@$h{'Error'}$1$h{'Standard'}@;
1459
1460     } elsif ($c =~ m/^Overriding forwarding settings/) {
1461
1462         # Overriding forwarding settings based on 'forward 10.0.0.1:8123'
1463         $c =~ s@(?<=based on \')(.*)(?=\')@$h{'configuration-line'}$1$h{'Standard'}@;
1464
1465     } elsif ($c =~ m/^Denying suspicious CONNECT request from/) {
1466
1467         # Denying suspicious CONNECT request from 10.0.0.1
1468         $c = highlight_matched_host($c, '(?<=from )[^\s]+'); # XXX: not an URL
1469
1470     } elsif ($c =~ m/^socks5_connect:/) {
1471
1472         $c =~ s@(?<=socks5_connect: )(.*)@$h{'error'}$1$h{'Standard'}@;
1473
1474     } elsif ($c =~ m/^Created new connection to/) {
1475
1476         # Created new connection to www.privoxy.org:80 on socket 11.
1477         $c = highlight_matched_host($c, '(?<=connection to )[^\s]+');
1478         $c =~ s@(?<=on socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1479
1480     } elsif ($c =~ m/^Found reusable socket/) {
1481
1482         # Found reusable socket 9 for www.privoxy.org:80 in slot 0.
1483         $c =~ s@(?<=Found reusable socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1484         $c = highlight_matched_host($c, '(?<=for )[^\s]+');
1485         $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1486
1487     } elsif ($c =~ m/^Marking open socket/) {
1488
1489         # Marking open socket 9 for www.privoxy.org:80 in slot 0 as unused.
1490         $c =~ s@(?<=Marking open socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1491         $c = highlight_matched_host($c, '(?<=for )[^\s]+');
1492         $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1493
1494     } elsif ($c =~ m/^No reusable/) {
1495
1496         # No reusable socket for addons.mozilla.org:443 found. Opening a new one.
1497         $c = highlight_matched_host($c, '(?<=for )[^\s]+');
1498
1499     } elsif ($c =~ m/^(Remembering|Forgetting) socket/) {
1500
1501         # Remembering socket 13 for www.privoxy.org:80 in slot 0.
1502         # Forgetting socket 38 for www.privoxy.org:80 in slot 5.
1503
1504         $c =~ s@(?<=socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1505         $c = highlight_matched_host($c, '(?<=for )[^\s]+');
1506         $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1507
1508     } elsif ($c =~ m/^Socket/) {
1509
1510         # Socket 16 already forgotten or never remembered.
1511         $c =~ s@(?<=Socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1512
1513     } elsif ($c =~ m/^The connection to/) {
1514
1515         # The connection to www.privoxy.org:80 in slot 6 timed out. Closing socket 19. Timeout is: 61.
1516         # 3.0.15 and later:
1517         # The connection to 1.bp.blogspot.com:80 in slot 0 timed out. Closing socket 5.\
1518         #  Timeout is: 1. Assumed latency: 4.
1519         # The connection to 10.0.0.1:80 in slot 0 is no longer usable. Closing socket 4.
1520         $c = highlight_matched_host($c, '(?<=connection to )[^\s]+');
1521         $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1522         $c =~ s@(?<=Closing socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1523         $c =~ s@(?<=Timeout is: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1524         $c =~ s@(?<=Assumed latency: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1525
1526     } elsif ($c =~ m/^Stopped waiting for the request line./) {
1527
1528         # Stopped waiting for the request line. Timeout: 121.
1529         $c =~ s@(?<=Timeout: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1530
1531     } elsif ($c =~ m/^Waiting for \d/) {
1532
1533         # Waiting for 1 connections to timeout.
1534         $c =~ s@(?<=^Waiting for )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1535
1536     } elsif ($c =~ m/^Initialized/) {
1537
1538         # Initialized 20 socket slots.
1539         $c =~ s@(?<=Initialized )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1540
1541     } elsif ($c =~ m/^Done reading from server/) {
1542
1543         # Done reading from server. Expected content length: 24892. \
1544         #  Actual content length: 24892. Most recently received: 4412.
1545         # 3.0.15 and later:
1546         # Done reading from server. Expected content length: 24892. \
1547         #  Actual content length: 24892. Bytes most recently read: 4412.
1548         # Done reading from server. Content length: 6018 as expected. \
1549         #  Bytes most recently read: 294.
1550         $c =~ s@(?<=ontent length: )(\d+)@$h{'Number'}$1$h{'Standard'}@g;
1551         $c =~ s@(?<=received: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1552         $c =~ s@(?<=read: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1553
1554     } elsif ($c =~ m/^Continuing buffering headers/) {
1555
1556         # Continuing buffering headers. byte_count: 19. header_offset: 517. len: 536.
1557         $c =~ s@(?<=byte_count: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1558         $c =~ s@(?<=header_offset: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1559         $c =~ s@(?<=len: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1560         # 3.0.15 and later:
1561         # Continuing buffering headers. Bytes most recently read: %d.
1562         $c =~ s@(?<=read: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1563
1564     } elsif ($c =~ m/^Received \d+ bytes while/) {
1565
1566         # Received 206 bytes while expecting 12103.
1567         $c =~ s@(?<=Received )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1568         $c =~ s@(?<=expecting )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1569
1570     } elsif ($c =~ m/^Connection from/) {
1571
1572         # Connection from 81.163.28.218 dropped due to ACL
1573         $c =~ s@(?<=^Connection from )((?:\d+\.?){4})@$h{'Number'}$1$h{'Standard'}@;
1574
1575     } elsif ($c =~ m/^(?:Reusing|Closing) server socket \d./ or
1576              $c =~ m/^No additional client request/) {
1577
1578         # Reusing server socket 4. Opened for 10.0.0.1.
1579         # Closing server socket 2. Opened for 10.0.0.1.
1580         # No additional client request received in time. \
1581         #  Closing server socket 4, initially opened for 10.0.0.1.
1582
1583         $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1584         $c = highlight_matched_host($c, '(?<=for )[^\s]+(?=\.$)');
1585
1586     } elsif ($c =~ m/^Connected to /) {
1587
1588         # Connected to tor-jail[10.0.0.2]:9050.
1589
1590         $c = highlight_matched_host($c, '(?<=\[)[^\]]+');
1591         $c = highlight_matched_host($c, '(?<=Connected to )[^\[\s]+');
1592         $c =~ s@(?<=\]:)(\d+)@$h{'Number'}$1$h{'Standard'}@;
1593
1594     } elsif ($c =~ m/^Could not connect to /) {
1595
1596         # Could not connect to [10.0.0.1]:80.
1597
1598         $c = highlight_matched_host($c, '(?<=\[)[^\]]+');
1599         $c =~ s@(?<=\]:)(\d+)@$h{'Number'}$1$h{'Standard'}@;
1600
1601     } elsif ($c =~ m/^Waiting for the next client request/ or
1602              $c =~ m/^The connection on server socket/ ) {
1603
1604         # Waiting for the next client request. Keeping the server socket 5 to 10.0.0.1 open.
1605         # The connection on server socket 6 to upload.wikimedia.org isn't reusable. Closing.
1606
1607         $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1608         $c = highlight_matched_host($c, '(?<=to )[^\s]+');
1609
1610     } elsif ($c =~ m/^Marking the server socket/) {
1611
1612         # Marking the server socket 7 tainted.
1613
1614         $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1615
1616     } elsif ($c =~ m/^Reduced expected bytes to /) {
1617
1618         # Reduced expected bytes to 0 to account for the 1542 ones we already got.
1619         $c =~ s@(?<=bytes to )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1620         $c =~ s@(?<=for the )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1621
1622     } elsif ($c =~ m/^The client closed socket /) {
1623
1624         # The client closed socket 2 while the server socket 4 is still open.
1625         $c =~ s@(?<=closed socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1626         $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1627
1628     } elsif ($c =~ m/^Looks like we rea/ or
1629              $c =~ m/^Unsetting keep-alive flag/ or
1630              $c =~ m/^No connections to wait/ or
1631              $c =~ m/^Client request arrived in time or the client closed the connection/ or
1632              $c =~ m/^Complete client request received/ or
1633              $c =~ m/^Possible pipeline attempt detected./ or
1634              $c =~ m/^POST request detected. The connection will not be kept alive./ or
1635              $c =~ m/^The server still wants to talk, but the client hung up on us./ or
1636              $c =~ m/^The server didn't specify how long the connection will stay open/ or
1637              $c =~ m/^There might be a request body. The connection will not be kept alive/ or
1638              $c =~ m/^Stopping to watch the client socket. There's already another request waiting./) {
1639
1640         # Looks like we reached the end of the last chunk. We better stop reading.
1641         # Looks like we read the end of the last chunk together with the server \
1642         #  headers. We better stop reading.
1643         # Unsetting keep-alive flag.
1644         # No connections to wait for left.
1645         # Client request arrived in time or the client closed the connection.
1646         # Complete client request received
1647         # Possible pipeline attempt detected. The connection will not be \
1648         #  kept alive and we will only serve the first request.
1649         # POST request detected. The connection will not be kept alive.
1650         # The server still wants to talk, but the client hung up on us.
1651         # The server didn't specify how long the connection will stay open. Assume it's only a second.
1652         # There might be a request body. The connection will not be kept alive.
1653         # Stopping to watch the client socket. There's already another request waiting.
1654
1655     } else {
1656
1657         found_unknown_content($c);
1658
1659     }
1660
1661     return $c;
1662 }
1663
1664
1665 sub handle_loglevel_info ($) {
1666
1667     my $c = shift;
1668     our $t;
1669     our %req;
1670     our %h;
1671
1672     if ($c =~ m/^Rewrite detected:/) {
1673
1674         # Rewrite detected: GET http://10.0.0.2:88/blah.txt HTTP/1.1
1675         $c = highlight_matched_request_line($c, '(?<=^Rewrite detected: ).*');
1676
1677     } elsif ($c =~ m/^Decompress(ing deflated|ion didn)/ or
1678              $c =~ m/^Compressed content detected/ or
1679              $c =~ m/^Tagger/
1680             ) {
1681         # Decompressing deflated iob: 117
1682         # Decompression didn't result in any content.
1683         # Compressed content detected, content filtering disabled. Consider recompiling Privoxy\
1684         #  with zlib support or enable the prevent-compression action.
1685         # Tagger 'complete-url' created empty tag. Ignored.
1686
1687         # Ignored for now
1688
1689     } elsif ($c =~ m/^(Re)?loading configuration file /) {
1690
1691         # loading configuration file '/usr/local/etc/privoxy/config':
1692         # Reloading configuration file '/usr/local/etc/privoxy/config'
1693         $c =~ s@(?<=loading configuration file \')([^\']*)@$h{'file'}$1$h{'Standard'}@;
1694
1695     } elsif ($c =~ m/^exiting by signal/) {
1696
1697         # exiting by signal 15 .. bye
1698         $c =~ s@(?<=exiting by signal )(\d+)@$h{'signal'}$1$h{'Standard'}@;
1699
1700     } elsif ($c =~ m/^Privoxy version/) {
1701
1702         # Privoxy version 3.0.7
1703         $c =~ s@(?<=^Privoxy version )(\d+\.\d+\.\d+)$@$h{'version'}$1$h{'Standard'}@;
1704
1705     } elsif ($c =~ m/^Program name: /) {
1706
1707         # Program name: /usr/local/sbin/privoxy
1708         $c =~ s@(?<=Program name: )(.*)@$h{'program-name'}$1$h{'Standard'}@;
1709
1710     } elsif ($c =~ m/^Listening on port /) {
1711
1712         # Listening on port 8118 on IP address 10.0.0.1
1713         $c =~ s@(?<=Listening on port )(\d+)@$h{'port'}$1$h{'Standard'}@;
1714         $c =~ s@(?<=on IP address )(.*)@$h{'ip-address'}$1$h{'Standard'}@;
1715
1716     } elsif ($c =~ m/^\(Re-\)Open(?:ing)? logfile/) {
1717
1718         # (Re-)Open logfile /var/log/privoxy/privoxy.log
1719         $c =~ s@(?<=Open logfile )(.*)@$h{'file'}$1$h{'Standard'}@;
1720
1721     } elsif ($c =~ m/^(Request from|Malformed server response detected)/) {
1722
1723         # Request from 10.0.0.1 denied. limit-connect{,} doesn't allow CONNECT requests to port 443.
1724         # Request from 10.0.0.1 marked for blocking. limit-connect{,} doesn't allow CONNECT requests to port 443.
1725         # Malformed server response detected. Downgrading to HTTP/1.0 impossible.
1726
1727         $c =~ s@(?<=Request from )([^\s]*)@$h{'ip-address'}$1$h{'Standard'}@;
1728         $c =~ s@(denied|blocking)@$h{'warning'}$1$h{'Standard'}@;
1729         $c =~ s@(CONNECT)@$h{'method'}$1$h{'Standard'}@;
1730         $c =~ s@(?<=to port )(\d+)@$h{'port'}$1$h{'Standard'}@;
1731
1732     } elsif ($c =~ m/^Status code/) {
1733
1734         # Status code 304 implies no body.
1735         $c =~ s@(?<=Status code )(\d+)@$h{'status-code'}$1$h{'Standard'}@;
1736
1737     } elsif ($c =~ m/^Method/) {
1738
1739         # Method HEAD implies no body.
1740         $c =~ s@(?<=Method )([^\s]+)@$h{'method'}$1$h{'Standard'}@;
1741
1742     } elsif ($c =~ m/^Buffer limit reached while extending /) {
1743
1744         # Buffer limit reached while extending the buffer (iob). Needed: 4197470. Limit: 4194304
1745         $c =~ s@(?<=Needed: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1746         $c =~ s@(?<=Limit: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1747
1748     } elsif ($c =~ m/^No logfile configured/ or
1749              $c =~ m/^Malformerd HTTP headers detected and MS IIS5 hack enabled/ or
1750              $c =~ m/^Invalid \"chunked\" transfer/ or
1751              $c =~ m/^Support for/ or
1752              $c =~ m/^Flushing header and buffers/
1753              ) {
1754
1755         # No logfile configured. Please enable it before reporting any problems.
1756         # Malformerd HTTP headers detected and MS IIS5 hack enabled. Expect an invalid \
1757         #  response or even no response at all.
1758         # No logfile configured. Logging disabled.
1759         # Invalid "chunked" transfer encoding detected and ignored.
1760         # Support for 'Connection: keep-alive' is experimental, incomplete and\
1761         #  known not to work properly in some situations.
1762         # Flushing header and buffers. Stepping back from filtering.
1763
1764     } else {
1765
1766         found_unknown_content($c);
1767
1768     }
1769
1770     return $c;
1771 }
1772
1773 sub handle_loglevel_cgi ($) {
1774
1775     my $c = shift;
1776     our $t;
1777     our %req;
1778     our %h;
1779
1780     if ($c =~ m/^Granting access to/) {
1781
1782         #Granting access to http://config.privoxy.org/send-stylesheet, referrer http://p.p/ is trustworthy.
1783
1784     } elsif ($c =~ m/^Substituting: s(.)/) {
1785
1786         # Substituting: s/@else-not-FEATURE_ZLIB@.*@endif-FEATURE_ZLIB@//sigTU
1787         # XXX: prone to span several lines
1788
1789         my $delimiter = $1;
1790         #$c =~ s@(?<=failed: )(.*)@$h{'error'}$1$h{'Standard'}@;
1791         $c =~ s@(?!<=\\)($delimiter)@$h{'pcrs-delimiter'}$1$h{'Standard'}@g; # XXX: Too aggressive
1792         #$c =~ s@(?!<=\\)($1)@$h{'pcrs-delimiter'}$1$h{'Standard'}@g;
1793     }
1794
1795     return $c;
1796 }
1797
1798 sub handle_loglevel_force ($) {
1799
1800     my $c = shift;
1801     our $t;
1802     our %req;
1803     our %h;
1804
1805     if ($c =~ m/^Ignored force prefix in request:/) {
1806
1807         # Ignored force prefix in request: "GET http://10.0.0.1/PRIVOXY-FORCE/block HTTP/1.1"
1808         $c =~ s@^(Ignored)@$h{'ignored'}$1$h{'Standard'}@;
1809         $c = highlight_matched_request_line($c, '(?<=request: ")[^"]*');
1810
1811     } elsif ($c =~ m/^Enforcing request:/) {
1812
1813         # Enforcing request: "GET http://10.0.0.1/block HTTP/1.1".
1814         $c = highlight_matched_request_line($c, '(?<=request: ")[^"]*');
1815
1816     } else {
1817
1818         found_unknown_content($c);
1819
1820     }
1821
1822     return $c;
1823 }
1824
1825 sub handle_loglevel_error ($) {
1826
1827     my $c = shift;
1828     our %h;
1829
1830     if ($c =~ m/^Empty server or forwarder response received on socket \d+./) {
1831
1832         # Empty server or forwarder response received on socket 4.
1833         $c =~ s@(?<=on socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1834     }
1835     # XXX: There are probably more messages that deserve highlighting.
1836
1837     return $c;
1838 }
1839
1840
1841 sub handle_loglevel_ignore ($) {
1842     return shift;
1843 }
1844
1845 sub gather_loglevel_request_stats ($$) {
1846     my $c = shift;
1847     my $thread = shift;
1848     our %stats;
1849
1850     $stats{requests}++;
1851 }
1852
1853 sub gather_loglevel_crunch_stats ($$) {
1854     my $c = shift;
1855     my $thread = shift;
1856     our %stats;
1857
1858     $stats{requests}++;
1859     $stats{crunches}++;
1860 }
1861
1862
1863 sub gather_loglevel_error_stats ($$) {
1864
1865     my $c = shift;
1866     my $thread = shift;
1867     our %stats;
1868     our %thread_data;
1869
1870     if ($c =~ m/^Empty server or forwarder response received on socket \d+./) {
1871
1872         # Empty server or forwarder response received on socket 4.
1873         $stats{'empty-responses'}++;
1874         if ($thread_data{$thread}{'new_connection'}) {
1875             $stats{'empty-responses-on-new-connections'}++;
1876         } else {
1877             $stats{'empty-responses-on-reused-connections'}++;
1878         }
1879     }
1880 }
1881
1882 sub gather_loglevel_connect_stats ($$) {
1883
1884     my $c = shift;
1885     my $thread = shift;
1886     our %thread_data;
1887     our %stats;
1888
1889     if ($c =~ m/^via ([^\s]+) to: [^\s]+/) {
1890
1891         # Connect: via 10.0.0.1:8123 to: www.example.org.noconnect
1892         $thread_data{$thread}{'forwarder'} = $1; # XXX: is this missue?
1893
1894     } elsif ($c =~ m/^to ([^\s]*)$/) {
1895
1896         # Connect: to lists.sourceforge.net:443
1897
1898         $thread_data{$thread}{'forwarder'} = 'direct connection';
1899
1900     } elsif ($c =~ m/^Created new connection to/) {
1901
1902         # Created new connection to www.privoxy.org:80 on socket 11.
1903
1904         $thread_data{$thread}{'new_connection'} = 1;
1905
1906     } elsif ($c =~ m/^Reusing server socket \d./ or
1907              $c =~ m/^Found reusable socket/) {
1908
1909         # Reusing server socket 4. Opened for 10.0.0.1.
1910         # Found reusable socket 9 for www.privoxy.org:80 in slot 0.
1911
1912         $thread_data{$thread}{'new_connection'} = 0;
1913         $stats{'reused-connections'}++;
1914     }
1915 }
1916
1917 sub gather_loglevel_header_stats ($) {
1918
1919     my $c = shift;
1920     my $thread = shift;
1921     our %stats;
1922
1923     if ($c =~ m/^A HTTP\/1\.1 response without/ or
1924         $c =~ m/^Keeping the server header 'Connection: keep-alive' around./)
1925     {
1926         # A HTTP/1.1 response without Connection header implies keep-alive.
1927         # Keeping the server header 'Connection: keep-alive' around.
1928         $stats{'server-keep-alive'}++;
1929     }
1930 }
1931
1932 sub init_stats () {
1933     our %stats = (
1934         requests => 0,
1935         crunches => 0,
1936         'server-keep-alive' => 0,
1937         'reused-connections' => 0,
1938         'empty-responses' => 0,
1939         'empty-responses-on-new-connections' => 0,
1940         'empty-responses-on-reused-connections' => 0,
1941         );
1942 }
1943
1944 sub get_percentage ($$) {
1945     my $big = shift;
1946     my $small = shift;
1947     return "NaN" if ($big eq 0);
1948     return sprintf("%.2f%%", $small / $big * 100);
1949 }
1950
1951 sub print_stats () {
1952
1953     our %stats;
1954     my $new_connections = $stats{requests} - $stats{crunches} - $stats{'reused-connections'};
1955     my $outgoing_requests = $stats{requests} - $stats{crunches};
1956
1957     if ($stats{requests} eq 0) {
1958         print "No requests yet.\n";
1959         return;
1960     }
1961
1962     print "Client requests total: " . $stats{requests} . "\n";
1963     print "Crunches: " . $stats{crunches} . " (" .
1964         get_percentage($stats{requests}, $stats{crunches}) . ")\n";
1965     print "Outgoing requests: " . $outgoing_requests . " (" .
1966         get_percentage($stats{requests}, $outgoing_requests) . ")\n";
1967     print "Server keep-alive offers: " . $stats{'server-keep-alive'} . " (" .
1968         get_percentage($stats{requests}, $stats{'server-keep-alive'}) . ")\n";
1969     print "New outgoing connections: " . $new_connections . " (" .
1970         get_percentage($stats{requests}, $new_connections) . ")\n";
1971     print "Reused connections: " . $stats{'reused-connections'} . " (" .
1972         get_percentage($stats{requests}, $stats{'reused-connections'}) . ")\n";
1973     print "Empty responses: " . $stats{'empty-responses'} . " (" .
1974         get_percentage($stats{requests}, $stats{'empty-responses'}) . ")\n";
1975     print "Empty responses on new connections: "
1976          . $stats{'empty-responses-on-new-connections'} . " (" .
1977         get_percentage($stats{requests}, $stats{'empty-responses-on-new-connections'})
1978         . ")\n";
1979     print "Empty responses on reused connections: " .
1980         $stats{'empty-responses-on-reused-connections'} . " (" .
1981         get_percentage($stats{requests}, $stats{'empty-responses-on-reused-connections'}) .
1982         ")\n";
1983 }
1984
1985
1986 ################################################################################
1987 # Functions that actually print stuff
1988 ################################################################################
1989
1990 sub print_clf_message () {
1991
1992     our ($ip, $timestamp, $request_line, $status_code, $size);
1993     our %h;
1994     my $output = '';
1995
1996     return if DEBUG_SUPPRESS_LOG_MESSAGES;
1997
1998     # Rebuild highlighted
1999     $output .= $h{'Number'} . $ip . $h{'Standard'};
2000     $output .= " - - ";
2001     $output .= "[" . $h{'Timestamp'} . $timestamp . $h{'Standard'} . "]";
2002     $output .= " ";
2003     $output .= "\"" . highlight_request_line("$request_line") . "\"";
2004     $output .= " ";
2005     $output .= $h{'Status'} . $status_code . $h{'Standard'};
2006     $output .= " ";
2007     $output .= $h{'Number'} . $size . $h{'Standard'};
2008     $output .= get_line_end();
2009
2010     print $output;
2011 }
2012
2013 sub print_non_clf_message ($) {
2014
2015     our %req;
2016     our %thread_colours;
2017     our %h;
2018     our $t;
2019     our $time_colour_index;
2020     our @time_colours;
2021     my $output;
2022     my $content = shift;
2023     my ($day, $time_stamp, $msecs, $thread, $log_level)
2024      = ($req{$t}{'day'}, $req{$t}{'time-stamp'}, $req{$t}{'msecs'}, $t, $req{$t}{'log-level'} );
2025
2026     return if DEBUG_SUPPRESS_LOG_MESSAGES;
2027
2028     $output .= $h{"Standard"} unless cli_option_is_set('html-output');
2029     #    $output .= "$day ";
2030     $output .= $time_colours[$time_colour_index % 2];
2031
2032     $output .= $time_stamp;
2033     $output .= ".$msecs" unless cli_option_is_set('no-msecs');
2034     $output .= $h{"Standard"};
2035     $output .= " ";
2036     $output .= $thread_colours{$thread} if (defined($thread_colours{$thread}));
2037     $output .= $thread;
2038     $output .= $h{"Standard"} . " ";
2039     $output .= $h{$log_level} if (defined($h{$log_level}));
2040     $output .= $log_level;
2041     $output .= $h{"Standard"} . ": ";
2042     $output .= "$content";
2043     $output .= get_line_end();
2044
2045     print $output;
2046 }
2047
2048 sub parse_loop () {
2049
2050     our $t;
2051     our %req; # request data from previous lines
2052     our %h;
2053     our %thread_colours;
2054     our @all_colours;
2055     our @time_colours;
2056     our $thread_colour_index = 0;
2057     our $header_colour_index = 0;
2058     our $time_colour_index = 0;
2059
2060     my ($day, $time_stamp, $thread, $log_level, $content, $c, $msecs);
2061     my $last_msecs  = 0;
2062     my $last_thread = 0;
2063     my $last_timestamp = 0;
2064     my $output;
2065     my $filters_that_did_nothing;
2066     my $key;
2067     my $time_colour;
2068     our $no_special_header_highlighting;
2069     $time_colour = paint_it('white');
2070
2071     my %log_level_handlers = (
2072         'Re-Filter'         => \&handle_loglevel_re_filter,
2073         'Header'            => \&handle_loglevel_header,
2074         'Connect'           => \&handle_loglevel_connect,
2075         'Redirect'          => \&handle_loglevel_redirect,
2076         'Request'           => \&handle_loglevel_request,
2077         'Crunch'            => \&handle_loglevel_crunch,
2078         'Gif-Deanimate'     => \&handle_loglevel_gif_deanimate,
2079         'Info'              => \&handle_loglevel_info,
2080         'CGI'               => \&handle_loglevel_cgi,
2081         'Force'             => \&handle_loglevel_force,
2082         'Error'             => \&handle_loglevel_error,
2083         'Fatal error'       => \&handle_loglevel_ignore,
2084         'Writing'           => \&handle_loglevel_ignore,
2085         'Unknown log level' => \&handle_loglevel_ignore,
2086     );
2087
2088     while (<>) {
2089
2090         $output = '';
2091
2092         if (m/^(\w{3} \d{2}) (\d\d:\d\d:\d\d)\.?(\d+)? (?:Privoxy\()?([^\)\s]*)[\)]? ([\w -]*): (.*?)\r?$/) {
2093             # XXX: Put in req hash?
2094             $day = $1;
2095             $time_stamp = $2;
2096             $msecs = $3 ? $3 : 0; # Only the cool kids have micro second resolution
2097             $log_level = $5;
2098             $content = $c = $6;
2099             $thread = $t = $4;
2100
2101             $req{$t}{'day'} = $day;
2102             $req{$t}{'time-stamp'} = $time_stamp;
2103             $req{$t}{'msecs'} = $msecs; # Only the cool kids have micro second resolution;
2104             $req{$t}{'log-level'} = $log_level;
2105             $req{$t}{'content'} = $content;
2106             $req{$t}{'log-message'} = $_;
2107             $no_special_header_highlighting = 0;
2108
2109             if (defined($log_level_handlers{$log_level})) {
2110
2111                 $content = $log_level_handlers{$log_level}($content);
2112
2113             } else {
2114
2115                 die "No handler found for log level \"$log_level\"\n";
2116
2117             }
2118
2119             # Highlight Truncations
2120             if (m/\.\.\. \[(too long, truncated)/) {
2121                 $content =~ s@($1)@$h{'Truncation'}$1$h{'Standard'}@g;
2122             }
2123
2124             next unless $content;
2125
2126             # Register threads to keep the colour constant
2127             if (!defined($thread_colours{$thread})) {
2128                 $thread_colours{$thread} = $all_colours[$thread_colour_index % @all_colours];
2129                 $thread_colour_index++;
2130             }
2131
2132             # Switch timestamp colour if timestamps differ
2133             if ($msecs != $last_msecs || !($time_stamp =~ m/$last_timestamp/)) {
2134                debug_message("Tick tack!") if DEBUG_TICKS;
2135                $time_colour = $time_colours[$time_colour_index % 2];
2136                $time_colour_index++
2137             }
2138
2139             $last_msecs = $msecs;
2140             $last_thread = $thread;
2141             $last_timestamp = $time_stamp;
2142
2143             print_non_clf_message($content);
2144
2145         } elsif (m/^((?:\d+\.\d+\.\d+\.\d+|[:\d]+)) - - \[(.*)\] "(.*)" (\d+) (\d+)/) {
2146
2147             # LOG_LEVEL_CLF lines look like this
2148             # 61.152.239.32 - - [04/Mar/2007:18:28:23 +0100] "GET \
2149             #  http://ad.yieldmanager.com/imp?z=1&Z=120x600&s=109339&u=http%3A%2F%2Fwww.365loan.co.uk%2F&r=1\
2150             #  HTTP/1.1" 403 1730
2151             our ($ip, $timestamp, $request_line, $status_code, $size) = ($1, $2, $3, $4, $5);
2152
2153             print_clf_message();
2154
2155         } else {
2156
2157             # Some Privoxy log messages span more than one line,
2158             # usually to dump lots of content that doesn't need any syntax highlighting.
2159             # XXX: add mechanism to forward these lines to the right handler anyway.
2160             chomp();
2161             unless (DEBUG_SUPPRESS_LOG_MESSAGES or (SUPPRESS_EMPTY_LINES and m/^\s+$/)) {
2162                 print and print get_line_end(); # unless (SUPPRESS_EMPTY_LINES and m/^\s+$/);
2163             }
2164         }
2165     }
2166 }
2167
2168 sub stats_loop () {
2169
2170     my ($day, $time_stamp, $thread, $log_level, $content, $c, $msecs);
2171     my %log_level_handlers = (
2172          'Re-Filter'         => \&handle_loglevel_ignore,
2173          'Header'            => \&gather_loglevel_header_stats,
2174          'Connect'           => \&gather_loglevel_connect_stats,
2175          'Redirect'          => \&handle_loglevel_ignore,
2176          'Request'           => \&gather_loglevel_request_stats,
2177          'Crunch'            => \&gather_loglevel_crunch_stats,
2178          'Gif-Deanimate'     => \&handle_loglevel_ignore,
2179          'Info'              => \&handle_loglevel_ignore,
2180          'CGI'               => \&handle_loglevel_ignore,
2181          'Force'             => \&handle_loglevel_ignore,
2182          'Error'             => \&gather_loglevel_error_stats,
2183          'Fatal error'       => \&handle_loglevel_ignore,
2184          'Writing'           => \&handle_loglevel_ignore,
2185          'Unknown log level' => \&handle_loglevel_ignore
2186     );
2187
2188     while (<>) {
2189         if (m/^(\w{3} \d{2}) (\d\d:\d\d:\d\d)\.?(\d+)? (?:Privoxy\()?([^\)\s]*)[\)]? ([\w -]*): (.*?)\r?$/) {
2190             $day = $1;
2191             $time_stamp = $2;
2192             $msecs = $3 ? $3 : 0;
2193             $log_level = $5;
2194             $content = $c = $6;
2195             $thread = $4;
2196
2197             if (defined($log_level_handlers{$log_level})) {
2198
2199                 $content = $log_level_handlers{$log_level}($content, $thread);
2200
2201             } else {
2202
2203                 die "No handler found for log level \"$log_level\"\n";
2204
2205             }
2206         }
2207     }
2208
2209     print_stats();
2210
2211 }
2212
2213 sub VersionMessage {
2214     my $version_message;
2215
2216     $version_message .= 'Privoxy-Log-Parser ' . PRIVOXY_LOG_PARSER_VERSION  . "\n";
2217     $version_message .= 'Copyright (C) 2007-2009 Fabian Keil <fk@fabiankeil.de>' . "\n";
2218     $version_message .= 'http://www.fabiankeil.de/sourcecode/privoxy-log-parser/' . "\n";
2219
2220     print $version_message;
2221 }
2222
2223 sub get_cli_options () {
2224
2225     our %cli_options = (
2226         'html-output'              => CLI_OPTION_DEFAULT_TO_HTML_OUTPUT,
2227         'title'                    => CLI_OPTION_TITLE,
2228         'no-syntax-highlighting'   => CLI_OPTION_NO_SYNTAX_HIGHLIGHTING,
2229         'no-embedded-css'          => CLI_OPTION_NO_EMBEDDED_CSS,
2230         'no-msecs'                 => CLI_OPTION_NO_MSECS,
2231         'show-ineffective-filters' => CLI_OPTION_SHOW_INEFFECTIVE_FILTERS,
2232         'accept-unknown-messages'  => CLI_OPTION_ACCEPT_UNKNOWN_MESSAGES,
2233         'statistics'               => CLI_OPTION_STATISTICS,
2234     );
2235
2236     GetOptions (
2237         'html-output'              => \$cli_options{'html-output'},
2238         'title'                    => \$cli_options{'title'},
2239         'no-syntax-highlighting'   => \$cli_options{'no-syntax-highlighting'},
2240         'no-embedded-css'          => \$cli_options{'no-embedded-css'},
2241         'no-msecs'                 => \$cli_options{'no-msecs'},
2242         'show-ineffective-filters' => \$cli_options{'show-ineffective-filters'},
2243         'accept-unknown-messages'  => \$cli_options{'accept-unknown-messages'},
2244         'statistics'               => \$cli_options{'statistics'},
2245         'version'                  => sub { VersionMessage && exit(0) }
2246    );
2247 }
2248
2249
2250
2251 ################################################################################
2252 # main
2253 ################################################################################
2254 sub main () {
2255
2256     get_cli_options();
2257     set_background(DEFAULT_BACKGROUND);
2258     prepare_our_stuff();
2259
2260     print_intro();
2261
2262     if (cli_option_is_set('statistics')) {
2263         stats_loop();
2264     } else {
2265         parse_loop();
2266     }
2267
2268     print_outro();
2269 }
2270
2271 main();
2272
2273 =head1 NAME
2274
2275 B<privoxy-log-parser> - A parser and syntax-highlighter for Privoxy log messages
2276
2277 =head1 SYNOPSIS
2278
2279 B<privoxy-log-parser> [B<--accept-unknown-messages>] [B<--html-output>]
2280 [B<--no-msecs>] [B<--no-syntax-higlighting>] [B<--show-ineffective-filters>]
2281 [B<--version>]
2282
2283 =head1 DESCRIPTION
2284
2285 B<privoxy-log-parser> reads Privoxy log messages and
2286
2287 - syntax-highlights recognized lines,
2288
2289 - reformats some of them for easier comprehension,
2290
2291 - filters out less useful messages, and
2292
2293 - (in some cases) calculates additional information,
2294   like the compression ratio or how a filter affected
2295   the content size.
2296
2297 With B<privoxy-log-parser> you should be able to increase Privoxy's log level
2298 without getting confused by the resulting amount of output. For example for
2299 "debug 64" B<privoxy-log-parser> will (by default) only show messages that
2300 affect the content. If a filter doesn't cause any hits, B<privoxy-log-parser>
2301 will hide the "filter foo caused 0 hits" message.
2302
2303 =head1 OPTIONS
2304
2305 [B<--accept-unknown-messages>] Don't print warnings in case of unknown messages,
2306 just don't highlight them.
2307
2308 [B<--html-output>] Use HTML and CSS for the syntax highlighting. If this option is
2309 omitted, ANSI escape sequences are used unless B<--no-syntax-highlighting> is active.
2310 This option is only intended to make embedding log excerpts in web pages easier.
2311 It does not escape any input!
2312
2313 [B<--no-msecs>] Don't expect milisecond resolution
2314
2315 [B<--no-syntax-highlighting>] Disable syntax-highlighting. Useful when
2316 the filtered output is piped into less in which case the ANSI control
2317 codes don't work, or if the terminal itself doesn't support the control
2318 codes.
2319
2320 [B<--show-ineffective-filters>] Don't suppress log lines for filters
2321 that didn't modify the content.
2322
2323 [B<--statistics>] Gather various statistics instead of syntax highlighting
2324 log messages. This is an experimental feature, if the results look wrong
2325 they very well might be. Also note that the results a pretty much guaranteed
2326 to be incorrect if Privoxy and Privoxy-Log-Parser aren't in sync.
2327
2328 [B<--version>] Print version and exit.
2329
2330 =head1 EXAMPLES
2331
2332 To monitor a log file:
2333
2334 tail -F /usr/jails/privoxy-jail/var/log/privoxy/privoxy.log | B<privoxy-log-parser>
2335
2336 Replace '-F' with '-f' if your tail implementation lacks '-F' support
2337 or if the log won't get rotated anyway. The log file location depends
2338 on your system (Doh!).
2339
2340 To monitor Privoxy without having it write to a log file:
2341
2342 privoxy --no-daemon /usr/jails/privoxy-jail/usr/local/etc/privoxy/config 2>&1 | B<privoxy-log-parser>
2343
2344 Again, the config file location depends on your system. Output redirection
2345 depends on your shell, the above works with bourne shells.
2346
2347 To read a processed Privoxy log file from top to bottom, letting the content
2348 scroll by slightly faster than you can read:
2349
2350 B<privoxy-log-parser> < /usr/jails/privoxy-jail/var/log/privoxy/privoxy.log
2351
2352 This is probably only useful to fill screens in the background of haxor movies.
2353
2354 =head1 CAVEATS
2355
2356 Syntax highlighting with ANSI escape sequences will look strange
2357 if your background color isn't black.
2358
2359 Some messages aren't recognized yet and will not be fully highlighted.
2360
2361 B<privoxy-log-parser> is developed with Privoxy 3.0.7 or later in mind,
2362 using earlier Privoxy versions will probably result in an increased amount
2363 of unrecognized log lines.
2364
2365 Privoxy's log files tend to be rather large. If you use HTML
2366 highlighting some browsers can't handle them, get confused and
2367 will eventually crash because of segmentation faults or unexpected
2368 exceptions. This is a problem in the browser and not B<privoxy-log-parser>'s
2369 fault.
2370
2371 =head1 BUGS
2372
2373 Many settings can't be controlled through command line options yet.
2374
2375 =head1 SEE ALSO
2376
2377 privoxy(1)
2378
2379 =head1 AUTHOR
2380
2381 Fabian Keil <fk@fabiankeil.de>
2382
2383 =cut