1
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
4
.\" ========================================================================
5
.de Sh \" Subsection heading
13
.de Sp \" Vertical space (when we can't use .PP)
17
.de Vb \" Begin verbatim text
22
.de Ve \" End verbatim text
26
.\" Set up some character translations and predefined strings. \*(-- will
27
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28
.\" double quote, and \*(R" will give a right double quote. | will give a
29
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30
.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31
.\" expand to `' in nroff, nothing in troff, for use with C<>.
33
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
37
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
51
.\" If the F register is turned on, we'll generate index entries on stderr for
52
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53
.\" entries marked with X<> in POD. Of course, you'll have to process the
54
.\" output yourself in some meaningful fashion.
57
. tm Index:\\$1\t\\n%\t"\\$2"
63
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
64
.\" way too many mistakes in technical documents.
68
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69
.\" Fear. Run. Save yourself. No user-serviceable parts.
70
. \" fudge factors for nroff and troff
79
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
85
. \" simple accents for nroff and troff
95
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
102
. \" troff and (daisy-wheel) nroff accents
103
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110
.ds ae a\h'-(\w'a'u*4/10)'e
111
.ds Ae A\h'-(\w'A'u*4/10)'E
112
. \" corrections for vroff
113
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115
. \" for low resolution devices (crt and lpr)
116
.if \n(.H>23 .if \n(.V>19 \
129
.\" ========================================================================
131
.IX Title "doc::Smokeping::probes::DNS 3"
132
.TH doc::Smokeping::probes::DNS 3 "2006-07-14" "2.0.9" "SmokePing"
134
Smokeping::probes::DNS \- Name Service Probe for SmokePing
136
.IX Header "SYNOPSIS"
146
\& binary = /usr/bin/dig # mandatory
154
\& # The following variables can be overridden in each target section
155
\& lookup = www.example.org
157
\& server = ns1.someisp.net
169
\& probe = DNS # if this should be the default probe
178
\& # probe = DNS # if the default probe is something else
180
\& lookup = www.example.org
182
\& server = ns1.someisp.net
185
.IX Header "DESCRIPTION"
186
Integrates dig as a probe into smokeping. The variable \fBbinary\fR must
187
point to your copy of the dig program. If it is not installed on
188
your system yet, you should install bind-utils >= 9.0.0.
190
The Probe asks the given host n\-times for it's name. Where n is
191
the amount specified in the config File.
193
.IX Header "VARIABLES"
194
Supported probe-specific variables:
197
The location of your dig binary.
199
Example value: /usr/bin/dig
201
This setting is mandatory.
204
Run this many concurrent processes at maximum
211
If you run many probes concurrently you may want to prevent them from
212
hitting your network all at the same time. Using the probe-specific
213
offset parameter you can change the point in time when each probe will
214
be run. Offset is specified in % of total interval, or alternatively as
215
\&'random', and the offset from the 'General' section is used if nothing
216
is specified here. Note that this does \s-1NOT\s0 influence the rrds itself,
217
it is just a matter of when data acqusition is initiated.
218
(This variable is only applicable if the variable 'concurrentprobes' is set
219
in the 'General' section.)
224
Duration of the base interval that this probe should use, if different
225
from the one specified in the 'Database' section. Note that the step in
226
the \s-1RRD\s0 files is fixed when they are originally generated, and if you
227
change the step parameter afterwards, you'll have to delete the old \s-1RRD\s0
228
files or somehow convert them. (This variable is only applicable if
229
the variable 'concurrentprobes' is set in the 'General' section.)
234
How long a single 'ping' takes at maximum
240
Supported target-specific variables:
243
Name of the host to look up in the dns.
245
Example value: www.example.org
248
How many pings should be sent to each target, if different from the global
249
value specified in the Database section. Note that the number of pings in
250
the \s-1RRD\s0 files is fixed when they are originally generated, and if you
251
change this parameter afterwards, you'll have to delete the old \s-1RRD\s0
252
files or somehow convert them.
257
Name of the dns server to use.
259
Example value: ns1.someisp.net
263
\& Igor Petrovski <pigor@myrealbox.com>,
264
\& Carl Elkins <carl@celkins.org.uk>,
265
\& Andre Stolze <stolze@uni-muenster.de>,
266
\& Niko Tyni <ntyni@iki.fi>,
267
\& Chris Poetzel<cpoetzel@anl.gov>