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
|
package Net::Ping;
# Authors: karrer@bernina.ethz.ch (Andreas Karrer)
# pmarquess@bfsec.bt.co.uk (Paul Marquess)
require 5.002 ;
require Exporter;
use strict ;
use vars qw(@ISA @EXPORT $VERSION $tcp_proto $echo_port) ;
@ISA = qw(Exporter);
@EXPORT = qw(ping pingecho);
$VERSION = 1.01;
use Socket 'PF_INET', 'AF_INET', 'SOCK_STREAM';
use Carp ;
$tcp_proto = (getprotobyname('tcp'))[2];
$echo_port = (getservbyname('echo', 'tcp'))[2];
sub ping {
croak "ping not implemented yet. Use pingecho()";
}
sub pingecho {
croak "usage: pingecho host [timeout]"
unless @_ == 1 or @_ == 2 ;
my ($host, $timeout) = @_;
my ($saddr, $ip);
my ($ret) ;
local (*PINGSOCK);
# check if $host is alive by connecting to its echo port, within $timeout
# (default 5) seconds. returns 1 if OK, 0 if no answer, 0 if host not found
$timeout = 5 unless $timeout;
if ($host =~ /^\s*((\d+\.){3}\d+)\s*$/)
{ $ip = pack ('C4', split (/\./, $1)) }
else
{ $ip = (gethostbyname($host))[4] }
return 0 unless $ip; # "no such host"
$saddr = pack('S n a4 x8', AF_INET, $echo_port, $ip);
$SIG{'ALRM'} = sub { die } ;
alarm($timeout);
$ret = 0;
eval <<'EOM' ;
return unless socket(PINGSOCK, PF_INET, SOCK_STREAM, $tcp_proto) ;
return unless connect(PINGSOCK, $saddr) ;
$ret=1 ;
EOM
alarm(0);
close(PINGSOCK);
$ret;
}
1;
__END__
=cut
=head1 NAME
Net::Ping, pingecho - check a host for upness
=head1 SYNOPSIS
use Net::Ping;
print "'jimmy' is alive and kicking\n" if pingecho('jimmy', 10) ;
=head1 DESCRIPTION
This module contains routines to test for the reachability of remote hosts.
Currently the only routine implemented is pingecho().
pingecho() uses a TCP echo (I<not> an ICMP one) to determine if the
remote host is reachable. This is usually adequate to tell that a remote
host is available to rsh(1), ftp(1), or telnet(1) onto.
=head2 Parameters
=over 5
=item hostname
The remote host to check, specified either as a hostname or as an IP address.
=item timeout
The timeout in seconds. If not specified it will default to 5 seconds.
=back
=head1 WARNING
pingecho() uses alarm to implement the timeout, so don't set another alarm
while you are using it.
|
