#! /usr/bin/perl -W
#
-# checkmail Version 0.3 by Thomas Hochstein
+# checkmail Version 0.5 by Thomas Hochstein
#
# This script tries to verify the deliverability of (a) mail address(es).
#
# It can be redistributed and/or modified under the same terms under
# which Perl itself is published.
-our $VERSION = "0.3";
+our $VERSION = "0.5";
################################# Configuration ################################
# Please fill in a working configuration!
# read commandline options
my %options;
-getopts('Vhqlrf:m:', \%options);
+getopts('Vhqlrf:m:s:e:', \%options);
# -V: display version
if ($options{'V'}) {
# display usage information if neither -f nor an address are present
if (!$options{'f'} and !$ARGV[0]) {
- print "Usage: $myself [-hqlr] [-m <host>] <address>|-f <file>\n";
+ print "Usage: $myself [-hqlr] [-m <host>]
[-s <from>] [-e <EHLO>] <address>|-f <file>\n";
print "Options: -V display copyright and version\n";
print " -h show documentation\n";
print " -q quiet (no output, just exit with 0/1/2/3)\n";
print " -l extended logging\n";
print " -r test random address to verify verification\n";
print " -m <host> no DNS lookup, just test this host\n";
+ print " -s <from> override configured value for MAIL FROM\n";
+ print " -e <EHLO> override configured value for EHLO\n";
print " <address> mail address to check\n\n";
print " -f <file> parse file (one address per line)\n";
exit(100);
};
+# -s / -e: override configuration
+$config{'from'} = $options{'s'} if $options{'s'};
+$config{'helo'} = $options{'e'} if $options{'e'};
+
# -f: open file and read addresses to @adresses
my @addresses;
if ($options{'f'}) {
my (%targets,$curstat,$status,$log,$message);
foreach (@addresses) {
my $address = $_;
- my $domain = Mail::Address->new('',$address)->host;
- printf(" * Testing %s ...\n",$address) if !($options{'q'});
- $log .= "\n===== BEGIN $address =====\n";
- # get list of target hosts or take host forced via -m
- if (!$options{'m'}) {
- %targets = %{gettargets($domain,\$log)};
- } else {
- $message = sprintf("Connection to %s forced by -m.\n",$options{'m'});
- $log .= $message;
- print " $message" if !($options{'q'});
- # just one target host with preference 0
- $targets{$options{'m'}} = 0;
- };
- if (%targets) {
- $curstat = checkaddress($address,\%targets,\$log);
- } else {
+ # regexp taken from http://www.regular-expressions.info/email.html
+ # with escaping of "/" added two times and "*" changed to "+"
+ # in localpart, second alternative
+ if ($address !~ /^(?:[a-z0-9!#$%&'*+\/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+\/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f]+)")@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i) {
+ printf(" > Address <%s> is syntactically INVALID.\n",$address) if !($options{'q'});
$curstat = 2;
- $message = 'DNS lookup failure';
- printf(" > Address is INVALID (%s).\n",$message) if !($options{'q'});
- $log .= $message . '.';
+ } else {
+ my $domain = Mail::Address->new('',$address)->host;
+ printf(" * Testing %s ...\n",$address) if !($options{'q'});
+ $log .= "\n===== BEGIN $address =====\n";
+ # get list of target hosts or take host forced via -m
+ if (!$options{'m'}) {
+ %targets = %{gettargets($domain,\$log)};
+ } else {
+ $message = sprintf("Connection to %s forced by -m.\n",$options{'m'});
+ $log .= $message;
+ print " $message" if !($options{'q'});
+ # just one target host with preference 0
+ $targets{$options{'m'}} = 0;
+ };
+ if (%targets) {
+ $curstat = checkaddress($address,\%targets,\$log);
+ } else {
+ $curstat = 2;
+ $message = 'DNS lookup failure';
+ printf(" > Address is INVALID (%s).\n",$message) if !($options{'q'});
+ $log .= $message . '.';
+ };
+ $log .= "====== END $address ======\n";
};
- $log .= "====== END $address ======\n";
$status = $curstat if (!defined($status) or $curstat > $status);
};
# connection failure?
if ($success < 0) {
$status = connection_failed(@message);
+ # reset status - the address has been checked and _is_ valid!
+ $status = 3;
+ print " > Address verification currently impossible. You'll have to try again or send a test mail ...\n" if !($options{'q'});
# verification impossible?
} elsif ($success) {
$status = 3;
- print " > Address verificaton impossible. You'll have to send a test mail ...\n" if !($options{'q'});
+ print " > Address verification impossible. You'll have to send a test mail ...\n" if !($options{'q'});
}
}
# if -r is not set or status was not set to 3: valid address
=head1 SYNOPSIS
-B<checkmail> [B<-Vhqlr>] [B<-m> I<host>] I<address>|B<-f> I<file>
+B<checkmail> [B<-Vhqlr>] [B<-m> I<host>]
[-s I<sender>] [-e I<EHLO>] I<address>|B<-f> I<file>
=head1 REQUIREMENTS
=back
+You may override that configuration by using the B<-e> and B<-s>
+command line options.
+
=head2 Usage
After configuring the script you may run your first test with
checkmail user@example.org
-B<checkmail> will try to determine the mail exchanger(s) (MX)
+B<checkmail> will check the address for syntactic validity. If the
+address is valid, it will try to determine the mail exchanger(s) (MX)
responsible for I<example.org> by querying the DNS for the respective
MX records and then try to connect via SMTP (on port 25) to each of
them in order of precedence (if necessary). It will run through the
from a dial-up or blacklisted host. If in doubt, use the B<-l> option
to have a closer look on the SMTP dialog yourself.
+B<Please note:> To avoid shell expansion on addresses you submit to
+B<checkmail>, use B<batch processing>.
+
=head1 OPTIONS
=over 3
checkmail -m test.host.example user@domain.example
+=item B<-s> I<sender> (value for MAIL FROM)
+
+Override configuration and use I<sender> for MAIL FROM.
+
+=item B<-e> I<EHLO> (value for EHLO)
+
+Override configuration and use I<EHLO> for EHLO.
+
=item B<-f> I<file> (file)
Process all addresses from I<file> (one on each line).
projects / mail / checkmail.git / blobdiff