Exit in case of unrecognized parameters.
[privoxy.git] / 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.59 2009/11/10 16:19:38 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           or $c =~ m/^keep-alive support is disabled/
922             )
923     {
924         # XXX: Some of these may need highlighting
925
926         # Modified: User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; pl-PL; rv:1.8.1.1) Gecko/20070214 Firefox/2.0.0.1
927         # Accept-Language header crunched and replaced with: Accept-Language: pl-pl
928         # cookie 'Set-Cookie: eZSessionCookie=07bfec287c197440d299f81580593c3d; \
929         #  expires=Thursday, 12-Apr-07 15:16:18 GMT; path=/' send by \
930         #  http://wirres.net/article/articleview/4265/1/6/ appears to be using time format 1 (XXX: gone with the wind)
931         # Cookie rewritten to a temporary one: Set-Cookie: NSC_gffe-iuuq-mc-wtfswfs=8efb33a53660;path=/
932         # Text mode is already enabled
933         # Denied request with NULL byte(s) turned into line break(s)
934         # Replaced: 'Connection: Yo, home to Bel Air' with 'Connection: close'
935         # addh-unique: Host: people.freebsd.org
936         # Suppressed offer to compress content
937         # Crunched incoming cookie -- yum!
938         # Accepted the client's request to fetch without filtering.
939         # Crunched outgoing cookie: Cookie: PREF=ID=6cf0abd347b30262:TM=1173357617:LM=1173357617:S=jZypyyJ7LPiwFi1_
940         # addh-unique: Host: subkeys.pgp.net:11371
941         # Referer forged to: Referer: http://10.0.0.1/
942         # Downgraded answer to HTTP/1.0
943         # Parameter: +hide-referrer{pille-palle} is a bad idea, but I don't care.
944         # Referer overwritten with: Referer: pille-palle
945         # Referer replaced with: Referer: pille-palle
946         # crunched x-forwarded-for!
947         # crunched From!
948         #  modified # XXX: pretty stupid log message
949         # Content filtering is enabled. Crunching: 'Range: 1234-5678' to prevent range-mismatch problems
950         # force-text-mode overruled the client's request to fetch without filtering!
951         # Server time in the future.
952         # content-disposition header crunched and replaced with: content-disposition: filename=baz
953         # Content-Disposition header crunched and replaced with: content-disposition: filename=baz
954         # Reducing white space in 'X-LWS-Test: "This  is  quoted" this is not "this  is  " but " this again   is  not'
955         # Ignoring single quote in 'X-LWS-Test: "This  is  quoted" this is not "this  is  " but "  this again   is  not'
956         # Converting tab to space in 'X-LWS-Test:   "This  is  quoted" this   is  not "this  is  "  but  "\
957         #  this again   is  not'
958         # A HTTP/1.1 response without Connection header implies keep-alive.
959         # Disabled filter mode on behalf of the client.
960         # Keeping the server header 'Connection: keep-alive' around.
961         # Keeping the client header 'Connection: close' around. The connection will not be kept alive.
962         # Keeping the client header 'Connection: keep-alive' around. The connection will be kept alive if possible.
963         # Content modified with no Content-Length header set. Creating a fake one for adjustment later on.
964         # Appended client IP address to X-Forwarded-For: 10.0.0.2, 10.0.0.1
965         # Removing 'Connection: close' to imply keep-alive.
966         # keep-alive support is disabled. Crunching: Keep-Alive: 300.
967
968     } elsif ($c =~ m/^scanning headers for:/) {
969
970         return '' unless SHOW_SCAN_INTRO;
971
972     } elsif ($c =~ m/^[Cc]runch(ing|ed)|crumble crunched:/) {
973         # crunched User-Agent!
974         # Crunching: Content-Encoding: gzip
975
976         $content =~ s@(Crunching|crunched)@$h{$1}$1$h{'Standard'}@;
977
978     } elsif ($c =~ m/^Offending request data with NULL bytes turned into \'°\' characters:/) {
979         
980         # Offending request data with NULL bytes turned into '°' characters: Â°Â°n°°(°°°
981
982         $content = h('warning') . $content . h('Standard');
983  
984     } elsif ($c =~ m/^(Transforming \")(.*?)(\" to \")(.*?)(\")/) {
985
986         # Transforming "Proxy-Authenticate: Basic realm="Correos Proxy Server"" to\
987         #  "Proxy-Authenticate: Basic realm="Correos Proxy Server""
988
989        $content =~ s@(?<=^Transforming \")(.*)(?=\" to)@$h{'Header'}$1$h{'Standard'}@;
990        $content =~ s@(?<=to \")(.*)(?=\")@$h{'Header'}$1$h{'Standard'}@;
991
992     } elsif ($c =~ m/^Removing empty header/) {
993
994         # Removing empty header
995         # Ignore for now
996
997     } elsif ($c =~ m/^Content-Type: .* not replaced/) {
998
999         # Content-Type: application/octet-stream not replaced. It doesn't look like text.\
1000         #  Enable force-text-mode if you know what you're doing.
1001         # XXX: Could highlight more here.
1002         $content =~ s@(?<=^Content-Type: )(.*)(?= not replaced)@$h{'content-type'}$1$h{'Standard'}@;
1003
1004     } elsif ($c =~ m/^(Server|Client) keep-alive timeout is/) {
1005
1006        # Server keep-alive timeout is 5. Sticking with 10.
1007        # Client keep-alive timeout is 20. Sticking with 10.
1008
1009        $content =~ s@(?<=timeout is )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1010        $content =~ s@(?<=Sticking with )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1011
1012     } elsif ($c =~ m/^Reducing keep-alive timeout/) {
1013
1014        # Reducing keep-alive timeout from 60 to 10.
1015
1016        $content =~ s@(?<= from )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1017        $content =~ s@(?<= to )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1018
1019     } else {
1020
1021         found_unknown_content($content);
1022     }
1023
1024     # Highlight headers   
1025     unless ($c =~ m/^Transforming/) {
1026         $content = highlight_known_headers($content) unless $no_special_header_highlighting;
1027     }
1028
1029     return $content;
1030 }
1031
1032 sub handle_loglevel_re_filter ($) {
1033
1034     my $content = shift;
1035     my $c = $content;
1036     my $key;
1037     our $t;
1038     our %req;
1039     our %h;
1040     our %header_colours;
1041     our @all_colours;
1042     our $header_colour_index;
1043
1044     if ($c =~ /\.{3}$/
1045         and $c =~ m/^(?:re_)?filtering \'?(.*?)\'? \(size (\d*)\) with (?:filter )?\'?([^\s]*?)\'? ?\.{3}$/) {
1046
1047         # Used by Privoxy 3.0.5 and 3.0.6:
1048         # XXX: Fill in ...
1049         # Used by Privoxy 3.0.7:
1050         # filtering 'Connection: close' (size 17) with 'generic-content-ads' ...
1051
1052         $req{$t}{'filtered_header'} = $1;
1053         $req{$t}{'old_header_size'} = $2;
1054         $req{$t}{'header_filter_name'} = $3;
1055
1056         unless (cli_option_is_set('show-ineffective-filters') or
1057                 $req{$t}{'header_filter_name'} =~ m/^privoxy-filter-test$/) {
1058             return '';
1059         }
1060         $content =~ s@(?<=\(size )(\d+)@$h{'Number'}$1$h{'Standard'}@;   
1061         $content =~ s@($req{$t}{'header_filter_name'})@$h{'filter'}$1$h{'Standard'}@;
1062
1063     } elsif ($c =~ m/^ ?\.\.\. ?produced (\d*) hits \(new size (\d*)\)\./) {
1064
1065         # ...produced 0 hits (new size 23).
1066         #... produced 1 hits (new size 54).
1067
1068         $req{$t}{'header_filter_hits'} = $1;
1069         $req{$t}{'new_header_size'} = $2;
1070
1071         unless (cli_option_is_set('show-ineffective-filters') or
1072                 (defined($req{$t}{'header_filter_name'}) and
1073                  $req{$t}{'header_filter_name'} =~ m/^privoxy-filter-test$/)) {
1074
1075             if ($req{$t}{'header_filter_hits'} == 0 and
1076                 not (defined($req{$t}{'header_filter_name'}) and
1077                  $req{$t}{'header_filter_name'} =~ m/^privoxy-filter-test$/)) {
1078                 return ''; 
1079             }
1080             # Reformat including information from the intro
1081             $c = "'" . h('filter') . $req{$t}{'header_filter_name'} . h('Standard') . "'";
1082             $c .= " hit ";
1083             # XXX: Hide behind constant, it may be interesting if LOG_LEVEL_HEADER isn't enabled as well.
1084             # $c .= $req{$t}{'filtered_header'} . " ";
1085             $c .= h('Number') . $req{$t}{'header_filter_hits'}. h('Standard');
1086             $c .= ($req{$t}{'header_filter_hits'} == 1) ? " time, " : " times, ";
1087
1088             if ($req{$t}{'old_header_size'} !=  $req{$t}{'new_header_size'}) {
1089
1090                 $c .= "changing size from ";
1091                 $c .=  h('Number') . $req{$t}{'old_header_size'} . h('Standard');
1092                 $c .= " to ";
1093                 $c .= h('Number') . $req{$t}{'new_header_size'} . h('Standard');
1094                 $c .= ".";
1095
1096             } else {
1097
1098                 $c .= "keeping the size at " . $req{$t}{'old_header_size'};
1099
1100             }
1101
1102             # Highlight from last line (XXX: What?)
1103             # $c =~ s@(?<=produced )(\d+)@$h{'Number'}$1$h{'Standard'}@;   
1104             # $c =~ s@($req{$t}{'header_filter_name'})@$h{'filter'}$1$h{'Standard'}@;
1105
1106         } else {
1107
1108            # XXX: Untested
1109            $c =~ s@(?<=produced )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1110            $c =~ s@(?<=new size )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1111
1112         }
1113         $content = $c;
1114
1115     } elsif ($c =~ m/^(Tagger|Filter) ([^\s]*) has empty joblist. Nothing to do./) {
1116
1117         # Filter privoxy-filter-test has empty joblist. Nothing to do.
1118         # Tagger variable-test has empty joblist. Nothing to do.
1119
1120         $content =~ s@(?<=$1 )([^\s]*)@$h{'filter'}$1$h{'Standard'}@;
1121
1122     } elsif ($c =~ m/^(?:re_)?filtering ([^\s]+) \(size (\d+)\) with (?:filter )?\'?([^\s]+?)\'? produced (\d+) hits \(new size (\d+)\)/) {
1123
1124         # XXX: only the second version gets highlighted properly.
1125         # re_filtering www.lfk.de/favicon.ico (size 209) with filter untrackable-hulk produced 0 hits (new size 209).
1126         # filtering aci.blogg.de/ (size 37988) with 'blogg.de' produced 3 hits (new size 38057)
1127         $req{$t}{'content_source'} = $1;
1128         $req{$t}{'content_size'}   = $2;
1129         $req{$t}{'content_filter'} = $3;
1130         $req{$t}{'content_hits'}   = $4;
1131         $req{$t}{'new_content_size'} = $5;
1132         $req{$t}{'content_size_change'} = $req{$t}{'new_content_size'} - $req{$t}{'content_size'};
1133         #return '' if ($req{$t}{'content_hits'} == 0 && !cli_option_is_set('show-ineffective-filters'));
1134         if ($req{$t}{'content_hits'} == 0 and
1135             not (cli_option_is_set('show-ineffective-filters')
1136                  or ($req{$t}{'content_filter'} =~ m/^privoxy-filter-test$/))) {
1137                 return ''; 
1138         }
1139
1140         $c =~ s@(?<=\(size )(\d+)\)(?= with)@$h{'Number'}$1$h{'Standard'}@;
1141         $c =~ s@(?<=\(new size )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1142         $c =~ s@(?<=produced )(\d+)(?= hits)@$h{'Number'}$1$h{'Standard'}@;
1143
1144         $c =~ s@([^\s]+?)(\'? produced)@$h{'filter'}$1$h{'Standard'}$2@;
1145         $c = highlight_matched_host($c, '(?<=filtering )[^\s]+');
1146
1147         $c =~ s@\.$@ @;
1148         $c .= "(" . $h{'Number'};
1149         $c .= "+" if ($req{$t}{'content_size_change'} >= 0);
1150         $c .= $req{$t}{'content_size_change'} . $h{'Standard'} . ")";
1151         $content = $c;
1152
1153     } elsif ($c =~ m/^De-chunking successful. Shrunk from (\d+) to (\d+)/) {
1154
1155         $req{$t}{'chunked-size'} = $1;
1156         $req{$t}{'dechunked-size'} = $2;
1157         $req{$t}{'dechunk-change'} = $req{$t}{'dechunked-size'} - $req{$t}{'chunked-size'};
1158
1159         $content .= " (" . h('Number') . $req{$t}{'dechunk-change'} . h('Standard') . ")";
1160
1161         $content =~ s@(?<=from )($req{$t}{'chunked-size'})@$h{'Number'}$1$h{'Standard'}@;
1162         $content =~ s@(?<=to )($req{$t}{'dechunked-size'})@$h{'Number'}$1$h{'Standard'}@;
1163
1164     } elsif ($c =~ m/^Decompression successful. Old size: (\d+), new size: (\d+)./) {
1165
1166         # Decompression successful. Old size: 670, new size: 1166.
1167
1168         $req{$t}{'size-compressed'} = $1;
1169         $req{$t}{'size-decompressed'} = $2;
1170         $req{$t}{'decompression-gain'} = $req{$t}{'size-decompressed'} - $req{$t}{'size-compressed'};
1171
1172         $content =~ s@(?<=Old size: )($req{$t}{'size-compressed'})@$h{'Number'}$1$h{'Standard'}@;
1173         $content =~ s@(?<=new size: )($req{$t}{'size-decompressed'})@$h{'Number'}$1$h{'Standard'}@;
1174
1175         # XXX: Create sub get_percentage()
1176         if ($req{$t}{'size-decompressed'}) {
1177             $req{$t}{'decompression-gain-percent'} =
1178                 $req{$t}{'decompression-gain'} / $req{$t}{'size-decompressed'} * 100;
1179
1180             $content .= " (saved: ";
1181             #$content .= h('Number') . $req{$t}{'decompression-gain'} . h('Standard');
1182             #$content .= "/";
1183             $content .= h('Number') . sprintf("%.2f%%", $req{$t}{'decompression-gain-percent'}) . h('Standard');
1184             $content .= ")";
1185         }
1186
1187     } elsif ($c =~ m/^(Need to de-chunk first)/) {
1188
1189         # Need to de-chunk first
1190         return '' if SUPPRESS_NEED_TO_DE_CHUNK_FIRST;
1191
1192     } elsif ($c =~ m/^(Adding (?:dynamic )?re_filter job)/) {
1193
1194         return ''  if (SUPPRESS_SUCCEEDED_FILTER_ADDITIONS && m/succeeded/);
1195
1196         # Adding re_filter job ...
1197         # Adding dynamic re_filter job s@^(?:\w*)\s+.*\s+HTTP/\d\.\d\s*@IP-ADDRESS: $origin@D\
1198         #  to filter client-ip-address succeeded.
1199
1200     } elsif ($c =~ m/^Reading in filter/) {
1201
1202         return '' unless SHOW_FILTER_READIN_IN;
1203
1204     } else {
1205
1206         found_unknown_content($content);
1207
1208     }
1209
1210     return $content;
1211 }
1212
1213 sub handle_loglevel_redirect ($) {
1214
1215     my $c = shift;
1216     our $t;
1217     our %req;
1218     our %h;
1219
1220     if ($c =~ m/^Decoding "([^""]*)"/) {
1221
1222          $req{$t}{'original-destination'} = $1;
1223          $c = highlight_matched_path($c, '(?<=Decoding ")[^"]*');
1224          $c =~ s@\"@@g;
1225
1226     } elsif ($c =~ m/^Checking/) {
1227
1228          # Checking /_ylt=A0geu.Z76BRGR9k/**http://search.yahoo.com/search?p=view+odb+presentation+on+freebsd\
1229          #  &ei=UTF-8&xargs=0&pstart=1&fr=moz2&b=11 for redirects.
1230
1231          # TODO: Change colour if really url-decoded
1232          $req{$t}{'decoded-original-destination'} = $1;
1233          $c = highlight_matched_path($c, '(?<=Checking ")[^"]*');
1234          $c =~ s@\"@@g;
1235
1236     } elsif ($c =~ m/^pcrs command "([^""]*)" changed "([^""]*)" to "([^""]*)" \((\d+) hits?\)/) {
1237
1238         # pcrs command "s@&from=rss@@" changed "http://it.slashdot.org/article.pl?sid=07/03/02/1657247&from=rss"\
1239         #  to "http://it.slashdot.org/article.pl?sid=07/03/02/1657247" (1 hit).
1240
1241         my ($pcrs_command, $url_before, $url_after, $hits) = ($1, $2, $3, $4); # XXX: save these?
1242
1243         $c =~ s@(?<=pcrs command )"([^""]*)"@$h{'filter'}$1$h{'Standard'}@;
1244         $c = highlight_matched_url($c, '(?<=changed ")[^""]*');
1245         $c =~ s@(?<=changed )"([^""]*)"@$1@; # Remove quotes
1246         $c = highlight_matched_url($c, '(?<=to ")[^""]*');
1247         $c =~ s@(?<=to )"([^""]*)"@$1@; # Remove quotes
1248         $c =~ s@(\d+)(?= hits?)@$h{'hits'}$1$h{'Standard'}@;
1249
1250     } elsif ($c =~ m/(^New URL is: )(.*)/) {
1251
1252         # New URL is: http://it.slashdot.org/article.pl?sid=07/03/04/1511210
1253         # XXX: Use URL highlighter
1254         # XXX: Save?
1255         $c = $1 . h('rewritten-URL') . $2 . h('Standard');
1256
1257     } elsif ($c =~ m/No pcrs command recognized, assuming that/) {
1258         # No pcrs command recognized, assuming that "http://config.privoxy.org/user-manual/favicon.png"\
1259         #  is already properly formatted.
1260         # XXX: assume the same?
1261         $c = highlight_matched_url($c, '(?<=assuming that \")[^"]*');
1262
1263     } else {
1264
1265         found_unknown_content($c);
1266
1267     }
1268
1269     return $c;
1270 }
1271
1272 sub handle_loglevel_gif_deanimate ($) {
1273
1274     my $content = shift;
1275     our $t;
1276     our %req;
1277     our %h;
1278
1279     if ($content =~ m/Success! GIF shrunk from (\d+) bytes to (\d+)\./) {
1280
1281         my $bytes_from = $1;
1282         my $bytes_to = $2;
1283         # Gif-Deanimate: Success! GIF shrunk from 205 bytes to 133.
1284         $content =~ s@$bytes_from@$h{'Number'}$bytes_from$h{'Standard'}@;
1285         # XXX: Do we need g in case of ($1 == $2)?
1286         $content =~ s@$bytes_to@$h{'Number'}$bytes_to$h{'Standard'}@;
1287
1288     } elsif ($content =~ m/GIF (not) changed/) {
1289
1290         # Gif-Deanimate: GIF not changed.
1291         return '' if SUPPRESS_GIF_NOT_CHANGED;
1292         $content =~ s@($1)@$h{'not'}$1$h{'Standard'}@;
1293
1294     } elsif ($content =~ m/^failed! \(gif parsing\)/) {
1295
1296         # failed! (gif parsing)
1297         # XXX: Replace this error message with something less stupid 
1298         $content =~ s@(failed!)@$h{'error'}$1$h{'Standard'}@;
1299
1300     } elsif ($content =~ m/^Need to de-chunk first/) {
1301
1302         # Need to de-chunk first
1303         return '' if SUPPRESS_NEED_TO_DE_CHUNK_FIRST;
1304
1305     } elsif ($content =~ m/^(?:No GIF header found|failed while parsing)/) {
1306
1307         # No GIF header found (XXX: Did I ever commit this?)
1308         # failed while parsing 195 134747048 (XXX: never commited)
1309
1310         # Ignore these for now
1311
1312     } else {
1313
1314         found_unknown_content($content);
1315
1316     }
1317
1318     return $content;
1319 }
1320
1321 sub handle_loglevel_request ($) {
1322
1323     my $content = shift;
1324     our $t;
1325     our %req;
1326     our %h;
1327     our %reason_colours;
1328
1329     if ($content =~ m/crunch! /) {
1330
1331         # config.privoxy.org/send-stylesheet crunch! (CGI Call)
1332
1333         # Highlight crunch reasons
1334         foreach my $reason (keys %reason_colours) {
1335             $content =~ s@\(($reason)\)@$reason_colours{$reason}($1)$h{'Standard'}@g;
1336         }
1337         # Highlight request URL domain and ditch 'crunch!'
1338         $content = highlight_matched_pattern($content, 'request_', '[^ ]*(?= crunch!)');
1339         $content =~ s@ crunch!@@;
1340
1341     } elsif ($content =~ m/\[too long, truncated\]$/) {
1342
1343         # config.privoxy.org/edit-actions-submit?f=3&v=1176116716&s=7&Submit=Submit[...]&filter... [too long, truncated]
1344         $content = highlight_matched_pattern($content, 'request_', '^.*(?=\.\.\. \[too long, truncated\]$)');
1345
1346     } elsif ($content =~ m/(.*)/) { # XXX: Pretty stupid
1347
1348         # trac.vidalia-project.net/wiki/Volunteer?format=txt
1349         $content = h('request_') . $content . h('Standard');
1350
1351     } else {  # XXX: Nop
1352
1353         found_unknown_content($content);
1354
1355     }
1356             
1357     return $content;
1358 }
1359
1360 sub handle_loglevel_crunch ($) {
1361
1362     my $content = shift;
1363     our %h;
1364     our %reason_colours;
1365
1366     # Highlight crunch reason
1367     foreach my $reason (keys %reason_colours) {
1368         $content =~ s@($reason)@$reason_colours{$reason}$1$h{'Standard'}@g;
1369     }
1370
1371     if ($content =~ m/\[too long, truncated\]$/) {
1372
1373         # Blocked: config.privoxy.org/edit-actions-submit?f=3&v=1176116716&s=7&Submit=Submit\
1374         #  [...]&filter... [too long, truncated]
1375         $content = highlight_matched_pattern($content, 'request_', '^.*(?=\.\.\. \[too long, truncated\]$)');
1376
1377     } else {
1378
1379         # Blocked: http://ads.example.org/
1380         $content = highlight_matched_pattern($content, 'request_', '(?<=: ).*');
1381     }
1382
1383     return $content;
1384 }
1385
1386 sub handle_loglevel_connect ($) {
1387
1388     my $c = shift;
1389     our $t;
1390     our %req;
1391     our %h;
1392
1393     if ($c =~ m/^via [^\s]+ to: [^\s]+/) {
1394
1395         # Connect: via 10.0.0.1:8123 to: www.example.org.noconnect
1396
1397         $c = highlight_matched_host($c, '(?<=via )[^\s]+');
1398         $c = highlight_matched_host($c, '(?<=to: )[^\s]+');
1399
1400     } elsif ($c =~ m/^connect to: .* failed: .*/) {
1401
1402         # connect to: www.example.org.noconnect failed: Operation not permitted
1403
1404         $c = highlight_matched_host($c, '(?<=connect to: )[^\s]+');
1405
1406         $c =~ s@(?<=failed: )(.*)@$h{'error'}$1$h{'Standard'}@;
1407
1408     } elsif ($c =~ m/^to ([^\s]*)( successful)?$/) {
1409
1410         # Connect: to www.nzherald.co.nz successful
1411         # Connect: to archiv.radiotux.de
1412
1413         return '' if SUPPRESS_SUCCESSFUL_CONNECTIONS;
1414         $c = highlight_matched_host($c, '(?<=to )[^\s]+');
1415
1416     } elsif ($c =~ m/^to ([^\s]*)$/) {
1417
1418         # Connect: to lists.sourceforge.net:443
1419
1420         $c = highlight_matched_host($c, '(?<=to )[^\s]+');
1421
1422     } elsif ($c =~ m/^accepted connection from .*/ or
1423              $c =~ m/^OK/) {
1424
1425         # accepted connection from 10.0.0.1
1426         # Privoxy 3.0.6 and earlier just say:
1427         # OK
1428         return '' if SUPPRESS_ACCEPTED_CONNECTIONS;
1429         $c = highlight_matched_host($c, '(?<=connection from ).*');
1430
1431     } elsif ($c =~ m/^write header to: .* failed:/) {
1432
1433         # write header to: 10.0.0.1 failed: Broken pipe
1434
1435         $c = highlight_matched_host($c, '(?<=write header to: )[^\s]*');
1436         $c =~ s@(?<=failed: )(.*)@$h{'Error'}$1$h{'Standard'}@;
1437
1438     } elsif ($c =~ m/^write header to client failed:/) {
1439
1440         # write header to client failed: Broken pipe
1441         # XXX: Stil in use?
1442         $c =~ s@(?<=failed: )(.*)@$h{'Error'}$1$h{'Standard'}@;
1443
1444     } elsif ($c =~ m/^socks4_connect:/) {
1445
1446         # socks4_connect: SOCKS request rejected or failed.
1447         $c =~ s@(?<=socks4_connect: )(.*)@$h{'Error'}$1$h{'Standard'}@;
1448
1449     } elsif ($c =~ m/^Listening for new connections/ or
1450              $c =~ m/^accept connection/) {
1451         # XXX: Highlight?
1452         # Privoxy versions above 3.0.6 say:
1453         # Listening for new connections ...
1454         # earlier versions say:
1455         # accept connection ...
1456         return '';
1457
1458     } elsif ($c =~ m/^accept failed:/) {
1459
1460         $c =~ s@(?<=accept failed: )(.*)@$h{'Error'}$1$h{'Standard'}@;
1461
1462     } elsif ($c =~ m/^Overriding forwarding settings/) {
1463
1464         # Overriding forwarding settings based on 'forward 10.0.0.1:8123'
1465         $c =~ s@(?<=based on \')(.*)(?=\')@$h{'configuration-line'}$1$h{'Standard'}@;
1466
1467     } elsif ($c =~ m/^Denying suspicious CONNECT request from/) {
1468
1469         # Denying suspicious CONNECT request from 10.0.0.1
1470         $c = highlight_matched_host($c, '(?<=from )[^\s]+'); # XXX: not an URL
1471
1472     } elsif ($c =~ m/^socks5_connect:/) {
1473     
1474         $c =~ s@(?<=socks5_connect: )(.*)@$h{'error'}$1$h{'Standard'}@;
1475
1476     } elsif ($c =~ m/^Created new connection to/) {
1477
1478         # Created new connection to www.privoxy.org:80 on socket 11.
1479         $c = highlight_matched_host($c, '(?<=connection to )[^\s]+');
1480         $c =~ s@(?<=on socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1481
1482     } elsif ($c =~ m/^Found reusable socket/) {
1483
1484         # Found reusable socket 9 for www.privoxy.org:80 in slot 0.
1485         # 3.0.15 and later:
1486         # Found reusable socket 8 for www.privoxy.org:80 in slot 2.\
1487         #  Timestamp made 0 seconds ago. Timeout: 1. Latency: 0.
1488         $c =~ s@(?<=Found reusable socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1489         $c = highlight_matched_host($c, '(?<=for )[^\s]+');
1490         $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1491         $c =~ s@(?<=made )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1492         $c =~ s@(?<=Timeout: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1493         $c =~ s@(?<=Latency: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1494
1495     } elsif ($c =~ m/^Marking open socket/) {
1496
1497         # Marking open socket 9 for www.privoxy.org:80 in slot 0 as unused.
1498         $c =~ s@(?<=Marking open socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1499         $c = highlight_matched_host($c, '(?<=for )[^\s]+');
1500         $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1501
1502     } elsif ($c =~ m/^No reusable/) {
1503
1504         # No reusable socket for addons.mozilla.org:443 found. Opening a new one.
1505         $c = highlight_matched_host($c, '(?<=for )[^\s]+');
1506
1507     } elsif ($c =~ m/^(Remembering|Forgetting) socket/) {
1508
1509         # Remembering socket 13 for www.privoxy.org:80 in slot 0.
1510         # Forgetting socket 38 for www.privoxy.org:80 in slot 5.
1511
1512         $c =~ s@(?<=socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1513         $c = highlight_matched_host($c, '(?<=for )[^\s]+');
1514         $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1515
1516     } elsif ($c =~ m/^Socket/) {
1517
1518         # Socket 16 already forgotten or never remembered.
1519         $c =~ s@(?<=Socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1520
1521     } elsif ($c =~ m/^The connection to/) {
1522
1523         # The connection to www.privoxy.org:80 in slot 6 timed out. Closing socket 19. Timeout is: 61.
1524         # 3.0.15 and later:
1525         # The connection to 1.bp.blogspot.com:80 in slot 0 timed out. Closing socket 5.\
1526         #  Timeout is: 1. Assumed latency: 4.
1527         # The connection to 10.0.0.1:80 in slot 0 is no longer usable. Closing socket 4.
1528         $c = highlight_matched_host($c, '(?<=connection to )[^\s]+');
1529         $c =~ s@(?<=in slot )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1530         $c =~ s@(?<=Closing socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1531         $c =~ s@(?<=Timeout is: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1532         $c =~ s@(?<=Assumed latency: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1533
1534     } elsif ($c =~ m/^Stopped waiting for the request line./) {
1535
1536         # Stopped waiting for the request line. Timeout: 121.
1537         $c =~ s@(?<=Timeout: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1538
1539     } elsif ($c =~ m/^Waiting for \d/) {
1540
1541         # Waiting for 1 connections to timeout.
1542         $c =~ s@(?<=^Waiting for )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1543
1544     } elsif ($c =~ m/^Initialized/) {
1545
1546         # Initialized 20 socket slots.
1547         $c =~ s@(?<=Initialized )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1548
1549     } elsif ($c =~ m/^Done reading from server/) {
1550
1551         # Done reading from server. Expected content length: 24892. \
1552         #  Actual content length: 24892. Most recently received: 4412.
1553         # 3.0.15 and later:
1554         # Done reading from server. Expected content length: 24892. \
1555         #  Actual content length: 24892. Bytes most recently read: 4412.
1556         # Done reading from server. Content length: 6018 as expected. \
1557         #  Bytes most recently read: 294.
1558         $c =~ s@(?<=ontent length: )(\d+)@$h{'Number'}$1$h{'Standard'}@g;
1559         $c =~ s@(?<=received: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1560         $c =~ s@(?<=read: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1561
1562     } elsif ($c =~ m/^Continuing buffering headers/) {
1563
1564         # Continuing buffering headers. byte_count: 19. header_offset: 517. len: 536.
1565         $c =~ s@(?<=byte_count: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1566         $c =~ s@(?<=header_offset: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1567         $c =~ s@(?<=len: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1568         # 3.0.15 and later:
1569         # Continuing buffering headers. Bytes most recently read: %d.
1570         $c =~ s@(?<=read: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1571
1572     } elsif ($c =~ m/^Received \d+ bytes while/) {
1573
1574         # Received 206 bytes while expecting 12103.
1575         $c =~ s@(?<=Received )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1576         $c =~ s@(?<=expecting )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1577
1578     } elsif ($c =~ m/^Connection from/) {
1579
1580         # Connection from 81.163.28.218 dropped due to ACL
1581         $c =~ s@(?<=^Connection from )((?:\d+\.?){4})@$h{'Number'}$1$h{'Standard'}@;
1582
1583     } elsif ($c =~ m/^(?:Reusing|Closing) server socket \d./ or
1584              $c =~ m/^No additional client request/) {
1585
1586         # Reusing server socket 4. Opened for 10.0.0.1.
1587         # Closing server socket 2. Opened for 10.0.0.1.
1588         # No additional client request received in time. \
1589         #  Closing server socket 4, initially opened for 10.0.0.1.
1590
1591         $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1592         $c = highlight_matched_host($c, '(?<=for )[^\s]+(?=\.$)');
1593
1594     } elsif ($c =~ m/^Connected to /) {
1595
1596         # Connected to tor-jail[10.0.0.2]:9050.
1597
1598         $c = highlight_matched_host($c, '(?<=\[)[^\]]+');
1599         $c = highlight_matched_host($c, '(?<=Connected to )[^\[\s]+');
1600         $c =~ s@(?<=\]:)(\d+)@$h{'Number'}$1$h{'Standard'}@;
1601
1602     } elsif ($c =~ m/^Could not connect to /) {
1603
1604         # Could not connect to [10.0.0.1]:80.
1605
1606         $c = highlight_matched_host($c, '(?<=\[)[^\]]+');
1607         $c =~ s@(?<=\]:)(\d+)@$h{'Number'}$1$h{'Standard'}@;
1608
1609     } elsif ($c =~ m/^Waiting for the next client request/ or
1610              $c =~ m/^The connection on server socket/ ) {
1611
1612         # Waiting for the next client request. Keeping the server socket 5 to 10.0.0.1 open.
1613         # The connection on server socket 6 to upload.wikimedia.org isn't reusable. Closing.
1614
1615         $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1616         $c = highlight_matched_host($c, '(?<=to )[^\s]+');
1617
1618     } elsif ($c =~ m/^Marking the server socket/) {
1619
1620         # Marking the server socket 7 tainted.
1621
1622         $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1623
1624     } elsif ($c =~ m/^Reduced expected bytes to /) {
1625
1626         # Reduced expected bytes to 0 to account for the 1542 ones we already got.
1627         $c =~ s@(?<=bytes to )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1628         $c =~ s@(?<=for the )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1629
1630     } elsif ($c =~ m/^The client closed socket /) {
1631
1632         # The client closed socket 2 while the server socket 4 is still open.
1633         $c =~ s@(?<=closed socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1634         $c =~ s@(?<=server socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1635
1636     } elsif ($c =~ m/^Expected client content length set /) {
1637
1638         # Expected client content length set to 667325411 after reading 4999 bytes.
1639         $c =~ s@(?<=set to )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1640         $c =~ s@(?<=reading )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1641
1642     } elsif ($c =~ m/^Waiting for up to /) {
1643
1644         # Waiting for up to 4999 bytes from the client.
1645         $c =~ s@(?<=up to )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1646
1647     } elsif ($c =~ m/^Looks like we rea/ or
1648              $c =~ m/^Unsetting keep-alive flag/ or
1649              $c =~ m/^No connections to wait/ or
1650              $c =~ m/^Client request arrived in time or the client closed the connection/ or
1651              $c =~ m/^Complete client request received/ or
1652              $c =~ m/^Possible pipeline attempt detected./ or
1653              $c =~ m/^POST request detected. The connection will not be kept alive./ or
1654              $c =~ m/^The server still wants to talk, but the client hung up on us./ or
1655              $c =~ m/^The server didn't specify how long the connection will stay open/ or
1656              $c =~ m/^There might be a request body. The connection will not be kept alive/ or
1657              $c =~ m/^Stopping to watch the client socket. There's already another request waiting./ or
1658              $c =~ m/^Done reading from the client\.$/) {
1659
1660         # Looks like we reached the end of the last chunk. We better stop reading.
1661         # Looks like we read the end of the last chunk together with the server \
1662         #  headers. We better stop reading.
1663         # Unsetting keep-alive flag.
1664         # No connections to wait for left.
1665         # Client request arrived in time or the client closed the connection.
1666         # Complete client request received
1667         # Possible pipeline attempt detected. The connection will not be \
1668         #  kept alive and we will only serve the first request.
1669         # POST request detected. The connection will not be kept alive.
1670         # The server still wants to talk, but the client hung up on us.
1671         # The server didn't specify how long the connection will stay open. Assume it's only a second.
1672         # There might be a request body. The connection will not be kept alive.
1673         # Stopping to watch the client socket. There's already another request waiting.
1674         # Done reading from the client\.
1675
1676     } else {
1677
1678         found_unknown_content($c);
1679
1680     }
1681             
1682     return $c;
1683 }
1684
1685
1686 sub handle_loglevel_info ($) {
1687
1688     my $c = shift;
1689     our $t;
1690     our %req;
1691     our %h;
1692  
1693     if ($c =~ m/^Rewrite detected:/) {
1694
1695         # Rewrite detected: GET http://10.0.0.2:88/blah.txt HTTP/1.1
1696         $c = highlight_matched_request_line($c, '(?<=^Rewrite detected: ).*');
1697
1698     } elsif ($c =~ m/^Decompress(ing deflated|ion didn)/ or
1699              $c =~ m/^Compressed content detected/ or
1700              $c =~ m/^Tagger/
1701             ) {
1702         # Decompressing deflated iob: 117
1703         # Decompression didn't result in any content.
1704         # Compressed content detected, content filtering disabled. Consider recompiling Privoxy\
1705         #  with zlib support or enable the prevent-compression action.
1706         # Tagger 'complete-url' created empty tag. Ignored.
1707
1708         # Ignored for now
1709
1710     } elsif ($c =~ m/^(Re)?loading configuration file /) {
1711
1712         # loading configuration file '/usr/local/etc/privoxy/config':
1713         # Reloading configuration file '/usr/local/etc/privoxy/config'
1714         $c =~ s@(?<=loading configuration file \')([^\']*)@$h{'file'}$1$h{'Standard'}@;
1715
1716     } elsif ($c =~ m/^exiting by signal/) {
1717         
1718         # exiting by signal 15 .. bye
1719         $c =~ s@(?<=exiting by signal )(\d+)@$h{'signal'}$1$h{'Standard'}@;
1720
1721     } elsif ($c =~ m/^Privoxy version/) {
1722         
1723         # Privoxy version 3.0.7
1724         $c =~ s@(?<=^Privoxy version )(\d+\.\d+\.\d+)$@$h{'version'}$1$h{'Standard'}@;
1725
1726     } elsif ($c =~ m/^Program name: /) {
1727
1728         # Program name: /usr/local/sbin/privoxy
1729         $c =~ s@(?<=Program name: )(.*)@$h{'program-name'}$1$h{'Standard'}@;
1730
1731     } elsif ($c =~ m/^Listening on port /) {
1732
1733         # Listening on port 8118 on IP address 10.0.0.1
1734         $c =~ s@(?<=Listening on port )(\d+)@$h{'port'}$1$h{'Standard'}@;
1735         $c =~ s@(?<=on IP address )(.*)@$h{'ip-address'}$1$h{'Standard'}@;
1736
1737     } elsif ($c =~ m/^\(Re-\)Open(?:ing)? logfile/) {
1738
1739         # (Re-)Open logfile /var/log/privoxy/privoxy.log
1740         $c =~ s@(?<=Open logfile )(.*)@$h{'file'}$1$h{'Standard'}@;
1741
1742     } elsif ($c =~ m/^(Request from|Malformed server response detected)/) {
1743
1744         # Request from 10.0.0.1 denied. limit-connect{,} doesn't allow CONNECT requests to port 443.
1745         # Request from 10.0.0.1 marked for blocking. limit-connect{,} doesn't allow CONNECT requests to port 443.
1746         # Malformed server response detected. Downgrading to HTTP/1.0 impossible.
1747
1748         $c =~ s@(?<=Request from )([^\s]*)@$h{'ip-address'}$1$h{'Standard'}@;
1749         $c =~ s@(denied|blocking)@$h{'warning'}$1$h{'Standard'}@;
1750         $c =~ s@(CONNECT)@$h{'method'}$1$h{'Standard'}@;
1751         $c =~ s@(?<=to port )(\d+)@$h{'port'}$1$h{'Standard'}@;
1752
1753     } elsif ($c =~ m/^Status code/) {
1754
1755         # Status code 304 implies no body.
1756         $c =~ s@(?<=Status code )(\d+)@$h{'status-code'}$1$h{'Standard'}@;
1757
1758     } elsif ($c =~ m/^Method/) {
1759
1760         # Method HEAD implies no body.
1761         $c =~ s@(?<=Method )([^\s]+)@$h{'method'}$1$h{'Standard'}@;
1762
1763     } elsif ($c =~ m/^Buffer limit reached while extending /) {
1764
1765         # Buffer limit reached while extending the buffer (iob). Needed: 4197470. Limit: 4194304
1766         $c =~ s@(?<=Needed: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1767         $c =~ s@(?<=Limit: )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1768
1769     } elsif ($c =~ m/^No logfile configured/ or
1770              $c =~ m/^Malformerd HTTP headers detected and MS IIS5 hack enabled/ or
1771              $c =~ m/^Invalid \"chunked\" transfer/ or
1772              $c =~ m/^Support for/ or
1773              $c =~ m/^Flushing header and buffers/
1774              ) {
1775
1776         # No logfile configured. Please enable it before reporting any problems.
1777         # Malformerd HTTP headers detected and MS IIS5 hack enabled. Expect an invalid \
1778         #  response or even no response at all.
1779         # No logfile configured. Logging disabled.
1780         # Invalid "chunked" transfer encoding detected and ignored.
1781         # Support for 'Connection: keep-alive' is experimental, incomplete and\
1782         #  known not to work properly in some situations.
1783         # Flushing header and buffers. Stepping back from filtering.
1784
1785     } else {
1786
1787         found_unknown_content($c);
1788
1789     }
1790
1791     return $c;
1792 }
1793
1794 sub handle_loglevel_cgi ($) {
1795
1796     my $c = shift;
1797     our $t;
1798     our %req;
1799     our %h;
1800
1801     if ($c =~ m/^Granting access to/) {
1802       
1803         #Granting access to http://config.privoxy.org/send-stylesheet, referrer http://p.p/ is trustworthy.
1804
1805     } elsif ($c =~ m/^Substituting: s(.)/) {
1806       
1807         # Substituting: s/@else-not-FEATURE_ZLIB@.*@endif-FEATURE_ZLIB@//sigTU
1808         # XXX: prone to span several lines
1809
1810         my $delimiter = $1;
1811         #$c =~ s@(?<=failed: )(.*)@$h{'error'}$1$h{'Standard'}@;
1812         $c =~ s@(?!<=\\)($delimiter)@$h{'pcrs-delimiter'}$1$h{'Standard'}@g; # XXX: Too aggressive
1813         #$c =~ s@(?!<=\\)($1)@$h{'pcrs-delimiter'}$1$h{'Standard'}@g;
1814     }
1815
1816     return $c;
1817 }
1818
1819 sub handle_loglevel_force ($) {
1820
1821     my $c = shift;
1822     our $t;
1823     our %req;
1824     our %h;
1825
1826     if ($c =~ m/^Ignored force prefix in request:/) {
1827       
1828         # Ignored force prefix in request: "GET http://10.0.0.1/PRIVOXY-FORCE/block HTTP/1.1"
1829         $c =~ s@^(Ignored)@$h{'ignored'}$1$h{'Standard'}@;
1830         $c = highlight_matched_request_line($c, '(?<=request: ")[^"]*');
1831
1832     } elsif ($c =~ m/^Enforcing request:/) {
1833       
1834         # Enforcing request: "GET http://10.0.0.1/block HTTP/1.1".
1835         $c = highlight_matched_request_line($c, '(?<=request: ")[^"]*');
1836
1837     } else {
1838
1839         found_unknown_content($c);
1840
1841     }
1842
1843     return $c;
1844 }
1845
1846 sub handle_loglevel_error ($) {
1847
1848     my $c = shift;
1849     our %h;
1850
1851     if ($c =~ m/^Empty server or forwarder response received on socket \d+./) {
1852
1853         # Empty server or forwarder response received on socket 4.
1854         # Empty server or forwarder response received on socket 3. \
1855         #  Closing client socket 15 without sending data.
1856         $c =~ s@(?<=on socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1857         $c =~ s@(?<=client socket )(\d+)@$h{'Number'}$1$h{'Standard'}@;
1858     }
1859     # XXX: There are probably more messages that deserve highlighting.
1860
1861     return $c;
1862 }
1863
1864
1865 sub handle_loglevel_ignore ($) {
1866     return shift;
1867 }
1868
1869 sub gather_loglevel_request_stats ($$) {
1870     my $c = shift;
1871     my $thread = shift;
1872     our %stats;
1873
1874     $stats{requests}++;
1875 }
1876
1877 sub gather_loglevel_crunch_stats ($$) {
1878     my $c = shift;
1879     my $thread = shift;
1880     our %stats;
1881
1882     $stats{requests}++;
1883     $stats{crunches}++;
1884 }
1885
1886
1887 sub gather_loglevel_error_stats ($$) {
1888
1889     my $c = shift;
1890     my $thread = shift;
1891     our %stats;
1892     our %thread_data;
1893
1894     if ($c =~ m/^Empty server or forwarder response received on socket \d+./) {
1895
1896         # Empty server or forwarder response received on socket 4.
1897         $stats{'empty-responses'}++;
1898         if ($thread_data{$thread}{'new_connection'}) {
1899             $stats{'empty-responses-on-new-connections'}++;
1900         } else {
1901             $stats{'empty-responses-on-reused-connections'}++;
1902         }
1903     }
1904 }
1905
1906 sub gather_loglevel_connect_stats ($$) {
1907
1908     my $c = shift;
1909     my $thread = shift;
1910     our %thread_data;
1911     our %stats;
1912
1913     if ($c =~ m/^via ([^\s]+) to: [^\s]+/) {
1914
1915         # Connect: via 10.0.0.1:8123 to: www.example.org.noconnect
1916         $thread_data{$thread}{'forwarder'} = $1; # XXX: is this missue?
1917
1918     } elsif ($c =~ m/^to ([^\s]*)$/) {
1919
1920         # Connect: to lists.sourceforge.net:443
1921
1922         $thread_data{$thread}{'forwarder'} = 'direct connection';
1923
1924     } elsif ($c =~ m/^Created new connection to/) {
1925
1926         # Created new connection to www.privoxy.org:80 on socket 11.
1927
1928         $thread_data{$thread}{'new_connection'} = 1;
1929
1930     } elsif ($c =~ m/^Reusing server socket \d./ or
1931              $c =~ m/^Found reusable socket/) {
1932
1933         # Reusing server socket 4. Opened for 10.0.0.1.
1934         # Found reusable socket 9 for www.privoxy.org:80 in slot 0.
1935
1936         $thread_data{$thread}{'new_connection'} = 0;
1937         $stats{'reused-connections'}++;
1938     }
1939 }
1940
1941 sub gather_loglevel_header_stats ($) {
1942
1943     my $c = shift;
1944     my $thread = shift;
1945     our %stats;
1946
1947     if ($c =~ m/^A HTTP\/1\.1 response without/ or
1948         $c =~ m/^Keeping the server header 'Connection: keep-alive' around./)
1949     {
1950         # A HTTP/1.1 response without Connection header implies keep-alive.
1951         # Keeping the server header 'Connection: keep-alive' around.
1952         $stats{'server-keep-alive'}++;
1953     }
1954 }
1955
1956 sub init_stats () {
1957     our %stats = (
1958         requests => 0,
1959         crunches => 0,
1960         'server-keep-alive' => 0,
1961         'reused-connections' => 0,
1962         'empty-responses' => 0,
1963         'empty-responses-on-new-connections' => 0,
1964         'empty-responses-on-reused-connections' => 0,
1965         );
1966 }
1967
1968 sub get_percentage ($$) {
1969     my $big = shift;
1970     my $small = shift;
1971     return "NaN" if ($big eq 0);
1972     return sprintf("%.2f%%", $small / $big * 100);
1973 }
1974
1975 sub print_stats () {
1976
1977     our %stats;
1978     my $new_connections = $stats{requests} - $stats{crunches} - $stats{'reused-connections'};
1979     my $outgoing_requests = $stats{requests} - $stats{crunches};
1980
1981     if ($stats{requests} eq 0) {
1982         print "No requests yet.\n";
1983         return;
1984     }
1985
1986     print "Client requests total: " . $stats{requests} . "\n";
1987     print "Crunches: " . $stats{crunches} . " (" .
1988         get_percentage($stats{requests}, $stats{crunches}) . ")\n";
1989     print "Outgoing requests: " . $outgoing_requests . " (" .
1990         get_percentage($stats{requests}, $outgoing_requests) . ")\n";
1991     print "Server keep-alive offers: " . $stats{'server-keep-alive'} . " (" .
1992         get_percentage($stats{requests}, $stats{'server-keep-alive'}) . ")\n";
1993     print "New outgoing connections: " . $new_connections . " (" .
1994         get_percentage($stats{requests}, $new_connections) . ")\n";
1995     print "Reused connections: " . $stats{'reused-connections'} . " (" .
1996         get_percentage($stats{requests}, $stats{'reused-connections'}) . ")\n";
1997     print "Empty responses: " . $stats{'empty-responses'} . " (" .
1998         get_percentage($stats{requests}, $stats{'empty-responses'}) . ")\n";
1999     print "Empty responses on new connections: "
2000          . $stats{'empty-responses-on-new-connections'} . " (" .
2001         get_percentage($stats{requests}, $stats{'empty-responses-on-new-connections'})
2002         . ")\n";
2003     print "Empty responses on reused connections: " .
2004         $stats{'empty-responses-on-reused-connections'} . " (" .
2005         get_percentage($stats{requests}, $stats{'empty-responses-on-reused-connections'}) .
2006         ")\n";
2007 }
2008
2009
2010 ################################################################################
2011 # Functions that actually print stuff
2012 ################################################################################
2013
2014 sub print_clf_message () {
2015
2016     our ($ip, $timestamp, $request_line, $status_code, $size);
2017     our %h;
2018     my $output = '';
2019
2020     return if DEBUG_SUPPRESS_LOG_MESSAGES;
2021
2022     # Rebuild highlighted
2023     $output .= $h{'Number'} . $ip . $h{'Standard'};
2024     $output .= " - - ";
2025     $output .= "[" . $h{'Timestamp'} . $timestamp . $h{'Standard'} . "]";
2026     $output .= " ";
2027     $output .= "\"" . highlight_request_line("$request_line") . "\"";
2028     $output .= " ";
2029     $output .= $h{'Status'} . $status_code . $h{'Standard'};
2030     $output .= " ";
2031     $output .= $h{'Number'} . $size . $h{'Standard'};
2032     $output .= get_line_end();
2033
2034     print $output;
2035 }
2036
2037 sub print_non_clf_message ($) {
2038
2039     our %req;
2040     our %thread_colours;
2041     our %h;
2042     our $t;
2043     our $time_colour_index;
2044     our @time_colours;
2045     my $output;
2046     my $content = shift;
2047     my ($day, $time_stamp, $msecs, $thread, $log_level)
2048      = ($req{$t}{'day'}, $req{$t}{'time-stamp'}, $req{$t}{'msecs'}, $t, $req{$t}{'log-level'} );
2049
2050     return if DEBUG_SUPPRESS_LOG_MESSAGES;
2051
2052     $output .= $h{"Standard"} unless cli_option_is_set('html-output');
2053     #    $output .= "$day ";
2054     $output .= $time_colours[$time_colour_index % 2]; 
2055
2056     $output .= $time_stamp;
2057     $output .= ".$msecs" unless cli_option_is_set('no-msecs');
2058     $output .= $h{"Standard"};
2059     $output .= " ";
2060     $output .= $thread_colours{$thread} if (defined($thread_colours{$thread}));
2061     $output .= $thread;
2062     $output .= $h{"Standard"} . " ";
2063     $output .= $h{$log_level} if (defined($h{$log_level}));
2064     $output .= $log_level;
2065     $output .= $h{"Standard"} . ": ";
2066     $output .= "$content";
2067     $output .= get_line_end();
2068
2069     print $output;
2070 }
2071
2072 sub parse_loop () {
2073
2074     our $t;
2075     our %req; # request data from previous lines
2076     our %h;
2077     our %thread_colours;
2078     our @all_colours;
2079     our @time_colours;
2080     our $thread_colour_index = 0;
2081     our $header_colour_index = 0;
2082     our $time_colour_index = 0;
2083
2084     my ($day, $time_stamp, $thread, $log_level, $content, $c, $msecs);
2085     my $last_msecs  = 0;
2086     my $last_thread = 0;
2087     my $last_timestamp = 0;
2088     my $output;
2089     my $filters_that_did_nothing;
2090     my $key;
2091     my $time_colour;
2092     our $no_special_header_highlighting;
2093     $time_colour = paint_it('white');
2094
2095     my %log_level_handlers = (
2096         'Re-Filter'         => \&handle_loglevel_re_filter,
2097         'Header'            => \&handle_loglevel_header,
2098         'Connect'           => \&handle_loglevel_connect,
2099         'Redirect'          => \&handle_loglevel_redirect,
2100         'Request'           => \&handle_loglevel_request,
2101         'Crunch'            => \&handle_loglevel_crunch,
2102         'Gif-Deanimate'     => \&handle_loglevel_gif_deanimate,
2103         'Info'              => \&handle_loglevel_info,
2104         'CGI'               => \&handle_loglevel_cgi,
2105         'Force'             => \&handle_loglevel_force,
2106         'Error'             => \&handle_loglevel_error,
2107         'Fatal error'       => \&handle_loglevel_ignore,
2108         'Writing'           => \&handle_loglevel_ignore,
2109         'Unknown log level' => \&handle_loglevel_ignore,
2110     );
2111
2112     while (<>) {
2113  
2114         $output = '';
2115
2116         if (m/^(\w{3} \d{2}) (\d\d:\d\d:\d\d)\.?(\d+)? (?:Privoxy\()?([^\)\s]*)[\)]? ([\w -]*): (.*?)\r?$/) {
2117             # XXX: Put in req hash?
2118             $day = $1;
2119             $time_stamp = $2;
2120             $msecs = $3 ? $3 : 0; # Only the cool kids have micro second resolution
2121             $log_level = $5;
2122             $content = $c = $6;
2123             $thread = $t = $4;
2124
2125             $req{$t}{'day'} = $day;
2126             $req{$t}{'time-stamp'} = $time_stamp;
2127             $req{$t}{'msecs'} = $msecs; # Only the cool kids have micro second resolution;
2128             $req{$t}{'log-level'} = $log_level;
2129             $req{$t}{'content'} = $content;
2130             $req{$t}{'log-message'} = $_;
2131             $no_special_header_highlighting = 0;
2132
2133             if (defined($log_level_handlers{$log_level})) {
2134
2135                 $content = $log_level_handlers{$log_level}($content);
2136
2137             } else {
2138
2139                 die "No handler found for log level \"$log_level\"\n";
2140
2141             }
2142
2143             # Highlight Truncations    
2144             if (m/\.\.\. \[(too long, truncated)/) {
2145                 $content =~ s@($1)@$h{'Truncation'}$1$h{'Standard'}@g;
2146             }
2147
2148             next unless $content;
2149
2150             # Register threads to keep the colour constant
2151             if (!defined($thread_colours{$thread})) {
2152                 $thread_colours{$thread} = $all_colours[$thread_colour_index % @all_colours];
2153                 $thread_colour_index++;
2154             }
2155
2156             # Switch timestamp colour if timestamps differ
2157             if ($msecs != $last_msecs || !($time_stamp =~ m/$last_timestamp/)) {
2158                debug_message("Tick tack!") if DEBUG_TICKS;
2159                $time_colour = $time_colours[$time_colour_index % 2]; 
2160                $time_colour_index++
2161             }
2162
2163             $last_msecs = $msecs;
2164             $last_thread = $thread;
2165             $last_timestamp = $time_stamp;
2166
2167             print_non_clf_message($content);
2168
2169         } elsif (m/^((?:\d+\.\d+\.\d+\.\d+|[:\d]+)) - - \[(.*)\] "(.*)" (\d+) (\d+)/) {
2170
2171             # LOG_LEVEL_CLF lines look like this
2172             # 61.152.239.32 - - [04/Mar/2007:18:28:23 +0100] "GET \
2173             #  http://ad.yieldmanager.com/imp?z=1&Z=120x600&s=109339&u=http%3A%2F%2Fwww.365loan.co.uk%2F&r=1\
2174             #  HTTP/1.1" 403 1730
2175             our ($ip, $timestamp, $request_line, $status_code, $size) = ($1, $2, $3, $4, $5);
2176
2177             print_clf_message();
2178     
2179         } else {
2180
2181             # Some Privoxy log messages span more than one line,
2182             # usually to dump lots of content that doesn't need any syntax highlighting.
2183             # XXX: add mechanism to forward these lines to the right handler anyway.
2184             chomp();
2185             unless (DEBUG_SUPPRESS_LOG_MESSAGES or (SUPPRESS_EMPTY_LINES and m/^\s+$/)) {
2186                 print and print get_line_end(); # unless (SUPPRESS_EMPTY_LINES and m/^\s+$/);
2187             }
2188         }
2189     }
2190 }
2191
2192 sub stats_loop () {
2193
2194     my ($day, $time_stamp, $thread, $log_level, $content, $c, $msecs);
2195     my %log_level_handlers = (
2196          'Re-Filter'         => \&handle_loglevel_ignore,
2197          'Header'            => \&gather_loglevel_header_stats,
2198          'Connect'           => \&gather_loglevel_connect_stats,
2199          'Redirect'          => \&handle_loglevel_ignore,
2200          'Request'           => \&gather_loglevel_request_stats,
2201          'Crunch'            => \&gather_loglevel_crunch_stats,
2202          'Gif-Deanimate'     => \&handle_loglevel_ignore,
2203          'Info'              => \&handle_loglevel_ignore,
2204          'CGI'               => \&handle_loglevel_ignore,
2205          'Force'             => \&handle_loglevel_ignore,
2206          'Error'             => \&gather_loglevel_error_stats,
2207          'Fatal error'       => \&handle_loglevel_ignore,
2208          'Writing'           => \&handle_loglevel_ignore,
2209          'Unknown log level' => \&handle_loglevel_ignore
2210     );
2211
2212     while (<>) {
2213         if (m/^(\w{3} \d{2}) (\d\d:\d\d:\d\d)\.?(\d+)? (?:Privoxy\()?([^\)\s]*)[\)]? ([\w -]*): (.*?)\r?$/) {
2214             $day = $1;
2215             $time_stamp = $2;
2216             $msecs = $3 ? $3 : 0;
2217             $log_level = $5;
2218             $content = $c = $6;
2219             $thread = $4;
2220
2221             if (defined($log_level_handlers{$log_level})) {
2222
2223                 $content = $log_level_handlers{$log_level}($content, $thread);
2224
2225             } else {
2226
2227                 die "No handler found for log level \"$log_level\"\n";
2228
2229             }
2230         }
2231     }
2232
2233     print_stats();
2234
2235 }
2236
2237 sub VersionMessage {
2238     my $version_message;
2239
2240     $version_message .= 'Privoxy-Log-Parser ' . PRIVOXY_LOG_PARSER_VERSION  . "\n";
2241     $version_message .= 'Copyright (C) 2007-2009 Fabian Keil <fk@fabiankeil.de>' . "\n";
2242     $version_message .= 'http://www.fabiankeil.de/sourcecode/privoxy-log-parser/' . "\n";
2243
2244     print $version_message;
2245 }
2246
2247 sub get_cli_options () {
2248
2249     our %cli_options = (
2250         'html-output'              => CLI_OPTION_DEFAULT_TO_HTML_OUTPUT,
2251         'title'                    => CLI_OPTION_TITLE,
2252         'no-syntax-highlighting'   => CLI_OPTION_NO_SYNTAX_HIGHLIGHTING,
2253         'no-embedded-css'          => CLI_OPTION_NO_EMBEDDED_CSS,
2254         'no-msecs'                 => CLI_OPTION_NO_MSECS,
2255         'show-ineffective-filters' => CLI_OPTION_SHOW_INEFFECTIVE_FILTERS,
2256         'accept-unknown-messages'  => CLI_OPTION_ACCEPT_UNKNOWN_MESSAGES,
2257         'statistics'               => CLI_OPTION_STATISTICS,
2258     ); 
2259
2260     GetOptions (
2261         'html-output'              => \$cli_options{'html-output'},
2262         'title'                    => \$cli_options{'title'},
2263         'no-syntax-highlighting'   => \$cli_options{'no-syntax-highlighting'},
2264         'no-embedded-css'          => \$cli_options{'no-embedded-css'},
2265         'no-msecs'                 => \$cli_options{'no-msecs'},
2266         'show-ineffective-filters' => \$cli_options{'show-ineffective-filters'},
2267         'accept-unknown-messages'  => \$cli_options{'accept-unknown-messages'},
2268         'statistics'               => \$cli_options{'statistics'},
2269         'version'                  => sub { VersionMessage && exit(0) },
2270         'help'                     => \&help,
2271    ) or exit(1);
2272 }
2273
2274 sub help () {
2275
2276     our %cli_options;
2277
2278     VersionMessage();
2279
2280     print << "    EOF"
2281
2282 Options and their default values if they have any:
2283     [--accept-unknown-messages]
2284     [--html-output]
2285     [--no-embedded-css]
2286     [--no-msecs]
2287     [--no-syntax-highlighting]
2288     [--show-ineffective-filters]
2289     [--statistics]
2290     [--title $cli_options{'title'}]
2291     [--version]
2292 see "perldoc $0" for more information
2293     EOF
2294     ;
2295     exit(0);
2296 }
2297
2298 ################################################################################
2299 # main
2300 ################################################################################
2301 sub main () {
2302
2303     get_cli_options();
2304     set_background(DEFAULT_BACKGROUND);
2305     prepare_our_stuff();
2306
2307     print_intro();
2308
2309     if (cli_option_is_set('statistics')) {
2310         stats_loop();
2311     } else {
2312         parse_loop();
2313     }
2314
2315     print_outro();
2316 }
2317
2318 main();
2319
2320 =head1 NAME
2321
2322 B<privoxy-log-parser> - A parser and syntax-highlighter for Privoxy log messages
2323
2324 =head1 SYNOPSIS
2325
2326 B<privoxy-log-parser> [B<--accept-unknown-messages>] [B<--html-output>]
2327 [B<--no-msecs>] [B<--no-syntax-higlighting>] [B<--show-ineffective-filters>]
2328 [B<--version>]
2329
2330 =head1 DESCRIPTION
2331
2332 B<privoxy-log-parser> reads Privoxy log messages and
2333
2334 - syntax-highlights recognized lines,
2335
2336 - reformats some of them for easier comprehension,
2337
2338 - filters out less useful messages, and
2339
2340 - (in some cases) calculates additional information,
2341   like the compression ratio or how a filter affected
2342   the content size.
2343  
2344 With B<privoxy-log-parser> you should be able to increase Privoxy's log level
2345 without getting confused by the resulting amount of output. For example for
2346 "debug 64" B<privoxy-log-parser> will (by default) only show messages that
2347 affect the content. If a filter doesn't cause any hits, B<privoxy-log-parser>
2348 will hide the "filter foo caused 0 hits" message.
2349
2350 =head1 OPTIONS
2351
2352 [B<--accept-unknown-messages>] Don't print warnings in case of unknown messages,
2353 just don't highlight them.
2354
2355 [B<--html-output>] Use HTML and CSS for the syntax highlighting. If this option is
2356 omitted, ANSI escape sequences are used unless B<--no-syntax-highlighting> is active.
2357 This option is only intended to make embedding log excerpts in web pages easier.
2358 It does not escape any input!
2359
2360 [B<--no-msecs>] Don't expect milisecond resolution
2361
2362 [B<--no-syntax-highlighting>] Disable syntax-highlighting. Useful when
2363 the filtered output is piped into less in which case the ANSI control
2364 codes don't work, or if the terminal itself doesn't support the control
2365 codes.
2366
2367 [B<--show-ineffective-filters>] Don't suppress log lines for filters
2368 that didn't modify the content.
2369
2370 [B<--statistics>] Gather various statistics instead of syntax highlighting
2371 log messages. This is an experimental feature, if the results look wrong
2372 they very well might be. Also note that the results a pretty much guaranteed
2373 to be incorrect if Privoxy and Privoxy-Log-Parser aren't in sync.
2374
2375 [B<--version>] Print version and exit.
2376
2377 =head1 EXAMPLES
2378
2379 To monitor a log file:
2380
2381 tail -F /usr/jails/privoxy-jail/var/log/privoxy/privoxy.log | B<privoxy-log-parser>
2382
2383 Replace '-F' with '-f' if your tail implementation lacks '-F' support
2384 or if the log won't get rotated anyway. The log file location depends
2385 on your system (Doh!).
2386
2387 To monitor Privoxy without having it write to a log file:
2388
2389 privoxy --no-daemon /usr/jails/privoxy-jail/usr/local/etc/privoxy/config 2>&1 | B<privoxy-log-parser>
2390
2391 Again, the config file location depends on your system. Output redirection
2392 depends on your shell, the above works with bourne shells.
2393
2394 To read a processed Privoxy log file from top to bottom, letting the content
2395 scroll by slightly faster than you can read:
2396
2397 B<privoxy-log-parser> < /usr/jails/privoxy-jail/var/log/privoxy/privoxy.log
2398
2399 This is probably only useful to fill screens in the background of haxor movies.
2400
2401 =head1 CAVEATS
2402
2403 Syntax highlighting with ANSI escape sequences will look strange
2404 if your background color isn't black.
2405
2406 Some messages aren't recognized yet and will not be fully highlighted.
2407
2408 B<privoxy-log-parser> is developed with Privoxy 3.0.7 or later in mind,
2409 using earlier Privoxy versions will probably result in an increased amount
2410 of unrecognized log lines.
2411
2412 Privoxy's log files tend to be rather large. If you use HTML
2413 highlighting some browsers can't handle them, get confused and
2414 will eventually crash because of segmentation faults or unexpected
2415 exceptions. This is a problem in the browser and not B<privoxy-log-parser>'s
2416 fault.
2417
2418 =head1 BUGS
2419
2420 Many settings can't be controlled through command line options yet.
2421
2422 =head1 SEE ALSO
2423
2424 privoxy(1)
2425
2426 =head1 AUTHOR
2427
2428 Fabian Keil <fk@fabiankeil.de>
2429
2430 =cut