1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
#-*- perl -*-
#
# Copyright (C) 2001,2002,2004 Ken'ichi Fukamachi
# All rights reserved. This program is free software; you can
# redistribute it and/or modify it under the same terms as Perl itself.
#
# $FML: INET4.pm,v 1.8 2004/01/02 14:42:47 fukachan Exp $
#
package Mail::Delivery::Net::INET4;
use strict;
use vars qw(@ISA @EXPORT @EXPORT_OK);
use Carp;
use Mail::Delivery::Utils;
require Exporter;
@ISA = qw(Exporter);
@EXPORT = qw(connect4);
# Descriptions: try connect(2) by IPv4.
# Arguments: OBJ($self) HASH_REF($args)
# Side Effects: create ipv4 smtp connection
# Return Value: HANDLE
sub connect4
{
my ($self, $args) = @_;
my $mta = $args->{ _mta };
my $socket = undef;
# avoid croak() in IO::Socket module;
# XXX-TODO: how long is timeout ??? (where we specified ?)
eval {
local($SIG{ALRM}) = sub { Log("Error: timeout to connect $mta");};
use IO::Socket;
$socket = new IO::Socket::INET($mta);
};
if ($@) {
Log("Error: cannot create socket for $mta");
$self->error_set("Error: cannot create socket: $@");
return undef;
}
if (defined $socket) {
Log("(debug) o.k. connected to $mta");
$self->{'_socket'} = $socket;
$socket->autoflush(1);
return $socket;
}
else {
Log("(debug) error. fail to connect $mta");
$self->error_set("Error: cannot open socket: $!");
return undef;
}
}
=head1 NAME
Mail::Delivery::Net::INET4 - establish tcp connection over IPv4
=head1 SYNOPSIS
use Mail::Delivery::Net::INET4;
$mta = '127.0.0.1:25';
$self->connect4( { _mta => $mta });
=head1 DESCRIPTION
This module tries to create a socket and establish tcp connection over
IPv4. This is a typical socket program.
=head1 METHODS
=item C<connect4()>
try L<connect(2)>.
If it succeeds, returned
$self->{ _socket } has true value.
If not,
$self->{ _socket } is undef.
Avaialble arguments follows:
connect4( { _mta => $mta });
$mta is a hostname or [raw_ipv4_addr]:port form, for example,
127.0.0.1:25.
=head1 SEE ALSO
L<Mail::Delivery::SMTP>,
L<Socket>,
L<IO::Socket>,
L<Mail::Delivery::Utils>
=head1 CODING STYLE
See C<http://www.fml.org/software/FNF/> on fml coding style guide.
=head1 AUTHOR
Ken'ichi Fukamachi
=head1 COPYRIGHT
Copyright (C) 2001,2002,2004 Ken'ichi Fukamachi
All rights reserved. This program is free software; you can
redistribute it and/or modify it under the same terms as Perl itself.
=head1 HISTORY
Mail::Delivery::Net::INET4 first appeared in fml8 mailing list driver package.
See C<http://www.fml.org/> for more details.
=cut
1;
|
