X-Git-Url: https://git.exim.org/exim.git/blobdiff_plain/f3f065bbe8b7d7fdc4d46dbfa063ae4dfb05bfd7..5013d912e961203f2ab2d5f64be90255cda81b80:/src/src/exigrep.src diff --git a/src/src/exigrep.src b/src/src/exigrep.src index f888984b0..45bdc2c80 100644 --- a/src/src/exigrep.src +++ b/src/src/exigrep.src @@ -1,9 +1,13 @@ -#! PERL_COMMAND -w -# $Cambridge: exim/src/src/exigrep.src,v 1.4 2007/01/31 16:52:12 ph10 Exp $ +#! PERL_COMMAND +use warnings; use strict; +BEGIN { pop @INC if $INC[-1] eq '.' }; -# Copyright (c) 2007 University of Cambridge. +use Pod::Usage; +use Getopt::Long; + +# Copyright (c) 2007-2015 University of Cambridge. # See the file NOTICE for conditions of use and distribution. # Except when they appear in comments, the following placeholders in this @@ -28,7 +32,10 @@ use strict; # appears to be compressed, it is passed through zcat. We can't just do this # for all files, because zcat chokes on non-compressed files. -use Getopt::Std qw(getopts); +# Performance optimized in 02/02/2007 by Jori Hamalainen +# Typical run time acceleration: 4 times + + use POSIX qw(mktime); @@ -38,7 +45,7 @@ use POSIX qw(mktime); sub seconds { my($year,$month,$day,$hour,$min,$sec,$tzs,$tzh,$tzm) = - $_[0] =~ /^(\d{4})-(\d\d)-(\d\d)\s(\d\d):(\d\d):(\d\d)(?>\s([+-])(\d\d)(\d\d))?/; + $_[0] =~ /^(\d{4})-(\d\d)-(\d\d)\s(\d\d):(\d\d):(\d\d)(?>\s([+-])(\d\d)(\d\d))?/o; my $seconds = mktime $sec, $min, $hour, $day, $month - 1, $year - 1900; @@ -55,22 +62,34 @@ return $seconds; # This subroutine processes a single line (in $_) from a log file. Program # defensively against short lines finding their way into the log. -my (%saved, %id_list, $pattern, $queue_time); +my (%saved, %id_list, $pattern); + +my $queue_time = -1; +my $insensitive = 1; +my $invert = 0; +my $related = 0; +my $use_pager = 1; +my $literal = 0; + + +# If using "related" option, have to track extra message IDs +my $related_re=''; +my @Mids = (); sub do_line { # Convert syslog lines to mainlog format, as in eximstats. -if (! /^\\d{4}/) { $_ =~ s/^.*? exim\b.*?: //; } +if (!/^\d{4}-/o) { $_ =~ s/^.*? exim\b.*?: //o; } return unless - my($date,$entry) = /^(\d{4}-\d\d-\d\d \d\d:\d\d:\d\d (?:[+-]\d{4} )?)(.*)/; + my($date,$id) = /^(\d{4}-\d\d-\d\d \d\d:\d\d:\d\d (?:[+-]\d{4} )?)(?:\[\d+\] )?(\w{6}\-\w{6}\-\w{2})?/o; # Handle the case when the log line belongs to a specific message. We save # lines for specific messages until the message is complete. Then either print # or discard. -if (my($id) = $entry =~ /^(?:\[\d+\]\s)?(\w{6}\-\w{6}\-\w{2})/) +if (defined $id) { $saved{$id} = '' unless defined($saved{$id}); @@ -78,29 +97,45 @@ if (my($id) = $entry =~ /^(?:\[\d+\]\s)?(\w{6}\-\w{6}\-\w{2})/) $saved{$id} .= $_; - # Are we interested in this id ? + # Are we interested in this id ? Short circuit if we already were interested. - $id_list{$id} = 1 if /$pattern/io; + if ($invert) + { + $id_list{$id} = 1 if (!defined($id_list{$id})); + $id_list{$id} = 0 if (($insensitive && /$pattern/io) || /$pattern/o); + } + else + { + if (defined $id_list{$id} || + ($insensitive && /$pattern/io) || /$pattern/o) + { + $id_list{$id} = 1; + get_related_ids($id) if $related; + } + elsif ($related && $related_re) + { + grep_for_related($_, $id); + } + } # See if this is a completion for some message. If it is interesting, # print it, but in any event, throw away what was saved. - if ($entry =~ - /(?:Completed|rejected (?:by local_scan|by non-SMTP ACL|after DATA))/) + if (index($_, 'Completed') != -1 || + index($_, 'SMTP data timeout') != -1 || + (index($_, 'rejected') != -1 && + /^(\d{4}-\d\d-\d\d \d\d:\d\d:\d\d (?:[+-]\d{4} )?)(?:\[\d+\] )?\w{6}\-\w{6}\-\w{2} rejected/o)) { - if ($saved{$id} =~ /^(\d{4}-\d\d-\d\d \d\d:\d\d:\d\d ([+-]\d{4} )?)(\w{6}\-\w{6}\-\w{2})/) + if ($queue_time != -1 && + $saved{$id} =~ /^(\d{4}-\d\d-\d\d \d\d:\d\d:\d\d ([+-]\d{4} )?)/o) { my $old_sec = &seconds($1); my $sec = &seconds($date); - delete $id_list{$id} if $id_list{$id} && $sec - $old_sec <= $queue_time; - } - - if ($id_list{$id}) - { - delete $id_list{$id}; - print "$saved{$id}\n"; + $id_list{$id} = 0 if $id_list{$id} && $sec - $old_sec <= $queue_time; } + print "$saved{$id}\n" if ($id_list{$id}); + delete $id_list{$id}; delete $saved{$id}; } } @@ -108,23 +143,107 @@ if (my($id) = $entry =~ /^(?:\[\d+\]\s)?(\w{6}\-\w{6}\-\w{2})/) # Handle the case where the log line does not belong to a specific message. # Print it if it is interesting. -elsif ($entry =~ /$pattern/io) { print "$_\n"; } +elsif ( ($invert && (($insensitive && !/$pattern/io) || !/$pattern/o)) || + (!$invert && (($insensitive && /$pattern/io) || /$pattern/o)) ) + { print "$_\n"; } } +# Rotated log files are frequently compressed and there are a variety of +# formats it could be compressed with. Rather than use just one that is +# detected and hardcoded at Exim compile time, detect and use what the +# logfile is compressed with on the fly. +# +# List of known compression extensions and their associated commands: +my $compressors = { + gz => { cmd => 'zcat', args => '' }, + bz2 => { cmd => 'bzcat', args => '' }, + xz => { cmd => 'xzcat', args => '' }, + lzma => { cmd => 'lzma', args => '-dc' } +}; +my $csearch = 0; + +sub detect_compressor_bin + { + my $ext = shift(); + my $c = $compressors->{$ext}->{cmd}; + $compressors->{$ext}->{bin} = `which $c 2>/dev/null`; + chomp($compressors->{$ext}->{bin}); + } -# The main program. Extract the pattern and make sure any relevant characters -# are quoted if the -l flag is given. The -t flag gives a time-on-queue value -# which is an additional condition. +sub detect_compressor_capable + { + my $filename = shift(); + map { &detect_compressor_bin($_) } keys %$compressors + if (!$csearch); + $csearch = 1; + return undef + unless (grep {$filename =~ /\.(?:$_)$/} keys %$compressors); + # Loop through them, figure out which one it detected, + # and build the commandline. + my $cmdline = undef; + foreach my $ext (keys %$compressors) + { + if ($filename =~ /\.(?:$ext)$/) + { + # Just die if compressor not found; if this occurs in the middle of + # two valid files with a lot of matches, error could easily be missed. + die("Didn't find $ext decompressor for $filename\n") + if ($compressors->{$ext}->{bin} eq ''); + $cmdline = $compressors->{$ext}->{bin} ." ". + $compressors->{$ext}->{args}; + last; + } + } + return $cmdline; + } -getopts('lt:',\my %args); -$queue_time = $args{'t'}? $args{'t'} : -1; +sub grep_for_related { + my ($line,$id) = @_; + $id_list{$id} = 1 if $line =~ m/$related_re/; +} + +sub get_related_ids { + my ($id) = @_; + push @Mids, $id unless grep /\b$id\b/, @Mids; + my $re = join '|', @Mids; + $related_re = qr/$re/; +} -die "usage: exigrep [-l] [-t ] []...\n" - if ($#ARGV < 0); +# The main program. Extract the pattern and make sure any relevant characters +# are quoted if the -l flag is given. The -t flag gives a time-on-queue value +# which is an additional condition. The -M flag will also display "related" +# loglines (msgid from matched lines is searched in following lines). + +GetOptions( + 'I|sensitive' => sub { $insensitive = 0 }, + 'l|literal' => \$literal, + 'M|related' => \$related, + 't|queue-time=i' => \$queue_time, + 'pager!' => \$use_pager, + 'v|invert' => \$invert, + 'h|help' => sub { pod2usage(-exit => 0, -verbose => 1) }, + 'm|man' => sub { + pod2usage( + -exit => 0, + -verbose => 2, + -noperldoc => system('perldoc -V 2>/dev/null >&2') + ); + }, +) and @ARGV or pod2usage; $pattern = shift @ARGV; -$pattern = quotemeta $pattern if $args{l}; +$pattern = quotemeta $pattern if $literal; +# Start a pager if output goes to a terminal +if (-t 1 and $use_pager) + { + foreach ($ENV{PAGER}//(), 'less', 'more') + { + open(my $pager, '|-', $_) or next; + select $pager; + last; + } +} # If file arguments are given, open each one and process according as it is # is compressed or not. @@ -134,11 +253,16 @@ if (@ARGV) foreach (@ARGV) { my $filename = $_; - if ($filename =~ /\.(?:COMPRESS_SUFFIX)$/) + if (-x 'ZCAT_COMMAND' && $filename =~ /\.(?:COMPRESS_SUFFIX)$/o) { open(LOG, "ZCAT_COMMAND $filename |") || die "Unable to zcat $filename: $!\n"; } + elsif (my $cmdline = &detect_compressor_capable($filename)) + { + open(LOG, "$cmdline $filename |") || + die "Unable to decompress $filename: $!\n"; + } else { open(LOG, "<$filename") || die "Unable to open $filename: $!\n"; @@ -152,8 +276,90 @@ if (@ARGV) else { do_line() while (); } -# At the end of processing all the input, print any uncompleted data +# At the end of processing all the input, print any uncompleted messages. + +for (keys %id_list) + { + print "+++ $_ has not completed +++\n$saved{$_}\n"; + } + +__END__ + +=head1 NAME + +exigrep - search Exim's main log + +=head1 SYNOPSIS + +B [options] pattern [log] ... + +=head1 DESCRIPTION + +The B utility is a Perl script that searches one or more main log +files for entries that match a given pattern. When it finds a match, +it extracts all the log entries for the relevant message, not just +those that match the pattern. Thus, B can extract complete log +entries for a given message, or all mail for a given user, or for a +given host, for example. + +If no file names are given on the command line, the standard input is read. + +For known file extensions indicating compression (F<.gz>, F<.bz2>, F<.xz>, and F<.lzma>) +a suitable de-compressor is used, if available. + +The output is sent through a pager if a terminal is connected to STDOUT. As +pager are considered: C<$ENV{PAGER}>, C, C. + +=head1 OPTIONS + +=over + +=item B<-l>|B<--literal> + +This means 'literal', that is, treat all characters in the +pattern as standing for themselves. Otherwise the pattern must be a +Perl regular expression. The pattern match is case-insensitive. + +=item B<-t>|B<--queue-time> I + +Limit the output to messages that spent at least I in the +queue. + +=item B<-I>|B<--sensitive> + +Do a case sensitive search. + +=item B<-v>|B<--invert> + +Invert the meaning of the search pattern. That is, print message log +entries that are not related to that pattern. + +=item B<-M>|B<--related> + +Search for related messages too. + +=item B<--no-pager> + +Do not use a pager, even if STDOUT is connected to a terminal. + +=item B<-h>|B<--help> + +Print a short reference help. For more detailed help try L, +or C. + +=item B<-m>|B<--man> + +Print this manual page of B. + +=back + +=head1 SEE ALSO + +L, L, L + +=head1 AUTHOR -for (keys %id_list) { print "+++ $_ not completed +++\n$saved{$_}\n;" } +This manual page was stitched together from spec.txt by Andreas Metzler L +and updated by Heiko Schlittermann L. -# End of exigrep +=cut