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 "probes::IOSPing 3"
132
.TH probes::IOSPing 3 "2005-01-04" "1.35pre1" "SmokePing"
134
probes::IOSPing \- Cisco IOS Probe for SmokePing
136
.IX Header "SYNOPSIS"
140
\& binary = /usr/bin/remsh
149
\& iosint = source_address
152
.IX Header "DESCRIPTION"
153
Integrates Cisco \s-1IOS\s0 as a probe into smokeping. Uses the rsh / remsh
154
protocol to run a ping from an \s-1IOS\s0 device.
157
The binary and ioshost options are mandatory.
159
The binary option specifies the path of the binary to be used to
160
connect to the \s-1IOS\s0 device. Commonly used binaries are /usr/bin/rsh
161
and /usr/bin/remsh, although any script or binary should work if can
165
\& /path/to/binary [ -l user ] router ping
168
to produce the \s-1IOS\s0 ping dialog on stdin & stdout.
170
The (optional) packetsize option lets you configure the packetsize for
173
The (optional) forks options lets you configure the number of
174
simultaneous remote pings to be run. \s-1NB\s0 Some \s-1IOS\s0 devices have a
175
maximum of 5 VTYs available, so be careful not to hit a limit.
177
The ioshost option specifies the \s-1IOS\s0 device which should be used for
180
The (optional) iosuser option allows you to specify the remote
181
username the \s-1IOS\s0 device. If this option is omitted, the username
182
defaults to the default user used by the remsh command (usually the
183
user running the remsh command, ie the user running SmokePing).
185
The (optional) iosint option allows you to specify the source address
186
or interface in the \s-1IOS\s0 device. The value should be an \s-1IP\s0 address or
187
an interface name such as \*(L"Ethernet 1/0\*(R". If this option is omitted,
188
the \s-1IOS\s0 device will pick the \s-1IP\s0 address of the outbound interface to
190
.SH "IOS CONFIGURATION"
191
.IX Header "IOS CONFIGURATION"
192
The \s-1IOS\s0 device must have rsh enabled and an appropriate trust defined,
197
\& ip rcmd rsh-enable
198
\& ip rcmd remote-host smoke 192.168.1.2 smoke enable
203
.Sh "Password authentication"
204
.IX Subsection "Password authentication"
205
It is not possible to use password authentication with rsh or remsh
206
due to fundamental limitations of the protocol.
207
.Sh "Ping packet size"
208
.IX Subsection "Ping packet size"
209
The FPing manpage has the following to say on the topic of ping packet
212
Number of bytes of ping data to send. The minimum size (normally 12)
213
allows room for the data that fping needs to do its work (sequence
214
number, timestamp). The reported received data size includes the \s-1IP\s0
215
header (normally 20 bytes) and \s-1ICMP\s0 header (8 bytes), so the minimum
216
total size is 40 bytes. Default is 56, as in ping. Maximum is the
217
theoretical maximum \s-1IP\s0 datagram size (64K), though most systems limit
218
this to a smaller, system-dependent number.
221
Paul J Murphy <paul@murph.org>
223
based on probes::FPing by
225
Tobias Oetiker <tobi@oetiker.ch>