-#! /usr/bin/perl -W
+#! /usr/bin/perl -w
#
-# checkmail Version 0.3 by Thomas Hochstein
+# checkmail Version 0.6.3 by Thomas Hochstein
#
# This script tries to verify the deliverability of (a) mail address(es).
#
-# Copyright (c) 2002-2010 Thomas Hochstein <thh@inter.net>
+# Copyright (c) 2002-2016 Thomas Hochstein <thh@thh.name>
#
# It can be redistributed and/or modified under the same terms under
# which Perl itself is published.
-our $VERSION = "0.3";
+our $VERSION = "0.6.3 (unreleased)";
################################# Configuration ################################
# Please fill in a working configuration!
# -V: display version
if ($options{'V'}) {
- print "$myself v $VERSION\nCopyright (c) 2010 Thomas Hochstein <thh\@inter.net>\n";
+ print "$myself v $VERSION\nCopyright (c) 2002-2016 Thomas Hochstein <thh\@thh.name>\n";
print "This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.\n";
exit(100);
};
};
# -s / -e: override configuration
-$config{'from'} = $options{'s'} if $options{'s'};
+$config{'from'} = $options{'s'} if defined($options{'s'});
$config{'helo'} = $options{'e'} if $options{'e'};
# -f: open file and read addresses to @adresses
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);
};
# no MX record found; log and try A record(s)
} else {
print_dns_result($domain,'MX',undef,$resolver->errorstring,$logr);
- print(" Falling back to A record ...\n") if !($options{'q'});
- # get A record(s)
+ print(" Falling back to A record(s) ...\n") if !($options{'q'});
+ # get A record(s)
+ # may get CNAMEs instead ...
if (my $query = $resolver->query($domain,'A','IN')) {
- print_dns_result($domain,'A',$query->header->ancount,undef,$logr);
+ print_dns_result($domain,'A/CNAME',$query->header->ancount,undef,$logr);
foreach my $rr ($query->answer) {
+ if ($rr->type ne 'A') {
+ # report CNAMEs and don't add them to target list
+ if ($rr->type eq 'CNAME') {
+ printf (" ~ '%s' is a CNAME for '%s' and will be resolved accordingly. \n",$rr->name,$rr->cname) if !($options{'q'});
+ $$logr .= sprintf("- CNAME resolved: %s -> %s\n",$rr->name,$rr->cname);
+ }
+ next;
+ }
$targets{$rr->address} = 0;
$$logr .= sprintf("- %s\n",$rr->address);
};
# 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
=item B<$config{'from'}>
The sender address to be used for I<MAIL FROM> while testing.
+May be empty ('') to set '<>' as MAIL FROM.
=back
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
SMTP dialog until just before the I<DATA> stage, i.e. doing I<EHLO>,
I<MAIL FROM> and I<RCPT TO>. If no MX is defined, B<checkmail> will
fall back to the I<example.org> host itself, provided there is at
-least one A record defined in the DNS. If there are neither MX nor A
-records for I<example.org>, mail is not deliverable and B<checkmail>
-will fail accordingly. If no host can be reached, B<checkmail> will
-fail, too. Finally B<checkmail> will fail if mail to the given
-recipient is not accepted by the respective host.
+least one A record defined in the DNS. CNAMEs will be accepted and
+resolved here. If there are neither MX nor A records for
+I<example.org>, mail is not deliverable and B<checkmail> will fail
+accordingly. If no host can be reached, B<checkmail> will fail,
+too. Finally B<checkmail> will fail if mail to the given recipient
+is not accepted by the respective host.
If B<checkmail> fails, you'll not be able to deliver mail to that
address - at least not using the configured sender address and from
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
=head1 AUTHOR
-Thomas Hochstein <thh@inter.net>
+Thomas Hochstein <thh@thh.name>
=head1 COPYRIGHT AND LICENSE
-Copyright (c) 2002-2010 Thomas Hochstein <thh@inter.net>
+Copyright (c) 2002-2016 Thomas Hochstein <thh@thh.name>
This program is free software; you may redistribute it and/or modify it
under the same terms as Perl itself.
projects / mail / checkmail.git / blobdiff