summaryrefslogtreecommitdiffstats
path: root/lib/Smokeping/probes/EchoPingDNS.pm
blob: dc22f1732a292dd944bc8fc1d943cd1f104794cf (plain)
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
package Smokeping::probes::EchoPingDNS;

=head1 301 Moved Permanently

This is a Smokeping probe module. Please use the command 

C<smokeping -man Smokeping::probes::EchoPingDNS>

to view the documentation or the command

C<smokeping -makepod Smokeping::probes::EchoPingDNS>

to generate the POD document.

=cut

sub pod_hash {
	return {
		name => <<DOC,
Smokeping::probes::EchoPingDNS - an echoping(1) probe for SmokePing
DOC
		overview => <<DOC,
Measures DNS roundtrip times for SmokePing with the echoping_dns plugin. 
DOC
		authors => <<'DOC',
Niko Tyni <ntyni@iki.fi>
DOC
        notes => <<'DOC',
The I<fill>, I<size> and I<udp> EchoPing variables are not valid.

Plugins, including echoping_dns, are available starting with echoping version 6.
DOC
		see_also => <<DOC,
L<Smokeping::probes::EchoPing>, 
L<Smokeping::probes::EchoPingPlugin>
DOC
	}
}

use strict;
use base qw(Smokeping::probes::EchoPingPlugin);
use Carp;

sub plugin_args {
    my $self = shift;
    my $target = shift;
    my @args = ("-t", $target->{vars}{dns_type});
    my $tcp = $target->{vars}{dns_tcp};
    if ($tcp and $tcp ne "no") {
        push @args, "--tcp";
    }
    push @args, $target->{vars}{dns_request};
    return @args;
}

sub test_usage {
	my $self = shift;
	my $bin = $self->{properties}{binary};
    # side effect: this sleeps for a random time between 0 and 1 seconds
    # is there anything smarter to do?
	croak("Your echoping binary doesn't support the dns plugin")
		if `$bin -m dns 127.0.0.1 2>&1` =~ /(not compiled|invalid option|usage)/i;
	$self->SUPER::test_usage;
	return;
}

sub ProbeDesc($) {
	return "DNS pings using the echoping_dns plugin";
}

sub targetvars {
	my $class = shift;
	my $h = $class->SUPER::targetvars;
	delete $h->{udp};
	delete $h->{fill};
	delete $h->{size};
    $h->{plugin}{default} = 'dns';
    return $class->_makevars($h, {
        _mandatory => [ 'dns_request' ],
        dns_request => {
            _doc => <<DOC,
The DNS request (domain name) to be queried.
DOC
            _example => 'example.org',
        },
        dns_type => {
            _doc => <<DOC,
The echoping_dns '-t' option: type of data requested (NS, A, SOA etc.) 
DOC
            _example => 'AAAA',
            _default => 'A',
        },
        dns_tcp => {
            _doc => <<DOC,
The echoping_dns '--tcp' option: use only TCP ('virtual circuit').
Enabled if specified with a value other than 'no' or '0'.
DOC
            _example => 'yes',
        },
    },
    );
}

1;