source: patches/iputils-s20101006-doc-1.patch@ 52dbae7

clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 52dbae7 was ecc1136, checked in by Joe Ciccone <jciccone@…>, 14 years ago

Updated IPutils to s20101006.
  • Property mode set to 100644
File size: 132.2 KB
RevLine 
[ecc1136]1Submitted By: Joe Ciccone <jciccone@gmail.com>
2Date: 2011-01-08
3Initial Package Version: s20100418
4Upstream Status: Unknown
5Origin: Unknown
6Description: Contains Pregenerated Documentation
7
8
9diff -Naur iputils-s20101006.orig/doc/arping.8 iputils-s20101006/doc/arping.8
10--- iputils-s20101006.orig/doc/arping.8 1969-12-31 19:00:00.000000000 -0500
11+++ iputils-s20101006/doc/arping.8 2011-01-08 20:09:50.402928174 -0500
[8867e46]12@@ -0,0 +1,110 @@
13+.\" This manpage has been automatically generated by docbook2man
14+.\" from a DocBook document. This tool can be found at:
15+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
16+.\" Please send any bug reports, improvements, comments, patches,
17+.\" etc. to Steve Cheng <steve@ggi-project.org>.
[ecc1136]18+.TH "ARPING" "8" "08 January 2011" "iputils-101006" "System Manager's Manual: iputils"
[8867e46]19+.SH NAME
20+arping \- send ARP REQUEST to a neighbour host
21+.SH SYNOPSIS
22+
23+\fBarping\fR [\fB-AbDfhqUV\fR] [\fB-c \fIcount\fB\fR] [\fB-w \fIdeadline\fB\fR] [\fB-s \fIsource\fB\fR] \fB-I \fIinterface\fB\fR \fB\fIdestination\fB\fR
24+
25+.SH "DESCRIPTION"
26+.PP
27+Ping \fIdestination\fR on device \fIinterface\fR by ARP packets,
28+using source address \fIsource\fR.
29+.SH "OPTIONS"
30+.TP
31+\fB-A\fR
32+The same as \fB-U\fR, but ARP REPLY packets used instead
33+of ARP REQUEST.
34+.TP
35+\fB-b\fR
36+Send only MAC level broadcasts. Normally \fBarping\fR starts
37+from sending broadcast, and switch to unicast after reply received.
38+.TP
39+\fB-c \fIcount\fB\fR
40+Stop after sending \fIcount\fR ARP REQUEST
41+packets. With
42+\fIdeadline\fR
43+option, \fBarping\fR waits for
44+\fIcount\fR ARP REPLY packets, until the timeout expires.
45+.TP
46+\fB-D\fR
47+Duplicate address detection mode (DAD). See
48+RFC2131, 4.4.1.
49+Returns 0, if DAD succeeded i.e. no replies are received
50+.TP
51+\fB-f\fR
52+Finish after the first reply confirming that target is alive.
53+.TP
54+\fB-I \fIinterface\fB\fR
55+Name of network device where to send ARP REQUEST packets. This option
56+is required.
57+.TP
58+\fB-h\fR
59+Print help page and exit.
60+.TP
61+\fB-q\fR
62+Quiet output. Nothing is displayed.
63+.TP
64+\fB-s \fIsource\fB\fR
65+IP source address to use in ARP packets.
66+If this option is absent, source address is:
67+.RS
68+.TP 0.2i
69+\(bu
70+In DAD mode (with option \fB-D\fR) set to 0.0.0.0.
71+.TP 0.2i
72+\(bu
73+In Unsolicited ARP mode (with options \fB-U\fR or \fB-A\fR)
74+set to \fIdestination\fR.
75+.TP 0.2i
76+\(bu
77+Otherwise, it is calculated from routing tables.
78+.RE
79+.TP
80+\fB-U\fR
81+Unsolicited ARP mode to update neighbours' ARP caches.
82+No replies are expected.
83+.TP
84+\fB-V\fR
85+Print version of the program and exit.
86+.TP
87+\fB-w \fIdeadline\fB\fR
88+Specify a timeout, in seconds, before
89+\fBarping\fR
90+exits regardless of how many
91+packets have been sent or received. In this case
92+\fBarping\fR
93+does not stop after
94+\fIcount\fR
95+packet are sent, it waits either for
96+\fIdeadline\fR
97+expire or until
98+\fIcount\fR
99+probes are answered.
100+.SH "SEE ALSO"
101+.PP
102+\fBping\fR(8),
103+\fBclockdiff\fR(8),
104+\fBtracepath\fR(8).
105+.SH "AUTHOR"
106+.PP
107+\fBarping\fR was written by
108+Alexey Kuznetsov
109+<kuznet@ms2.inr.ac.ru>.
110+It is now maintained by
111+YOSHIFUJI Hideaki
112+<yoshfuji@skbuff.net>.
113+.SH "SECURITY"
114+.PP
115+\fBarping\fR requires CAP_NET_RAWIO capability
116+to be executed. It is not recommended to be used as set-uid root,
117+because it allows user to modify ARP caches of neighbour hosts.
118+.SH "AVAILABILITY"
119+.PP
120+\fBarping\fR is part of \fIiputils\fR package
121+and the latest versions are available in source form at
122+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
[ecc1136]123diff -Naur iputils-s20101006.orig/doc/clockdiff.8 iputils-s20101006/doc/clockdiff.8
124--- iputils-s20101006.orig/doc/clockdiff.8 1969-12-31 19:00:00.000000000 -0500
125+++ iputils-s20101006/doc/clockdiff.8 2011-01-08 20:09:50.611280874 -0500
[8867e46]126@@ -0,0 +1,81 @@
127+.\" This manpage has been automatically generated by docbook2man
128+.\" from a DocBook document. This tool can be found at:
129+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
130+.\" Please send any bug reports, improvements, comments, patches,
131+.\" etc. to Steve Cheng <steve@ggi-project.org>.
[ecc1136]132+.TH "CLOCKDIFF" "8" "08 January 2011" "iputils-101006" "System Manager's Manual: iputils"
[8867e46]133+.SH NAME
134+clockdiff \- measure clock difference between hosts
135+.SH SYNOPSIS
136+
137+\fBclockdiff\fR [\fB-o\fR] [\fB-o1\fR] \fB\fIdestination\fB\fR
138+
139+.SH "DESCRIPTION"
140+.PP
141+\fBclockdiff\fR Measures clock difference between us and
142+\fIdestination\fR with 1 msec resolution using ICMP TIMESTAMP
143+[2]
144+packets or, optionally, IP TIMESTAMP option
145+[3]
146+option added to ICMP ECHO.
147+[1]
148+.SH "OPTIONS"
149+.TP
150+\fB-o\fR
151+Use IP TIMESTAMP with ICMP ECHO instead of ICMP TIMESTAMP
152+messages. It is useful with some destinations, which do not support
153+ICMP TIMESTAMP (f.e. Solaris <2.4).
154+.TP
155+\fB-o1\fR
156+Slightly different form of \fB-o\fR, namely it uses three-term
157+IP TIMESTAMP with prespecified hop addresses instead of four term one.
158+What flavor works better depends on target host. Particularly,
159+\fB-o\fR is better for Linux.
160+.SH "WARNINGS"
161+.TP 0.2i
162+\(bu
163+Some nodes (Cisco) use non-standard timestamps, which is allowed
164+by RFC, but makes timestamps mostly useless.
165+.TP 0.2i
166+\(bu
167+Some nodes generate messed timestamps (Solaris>2.4), when
168+run \fBxntpd\fR. Seems, its IP stack uses a corrupted clock source,
169+which is synchronized to time-of-day clock periodically and jumps
170+randomly making timestamps mostly useless. Good news is that you can
171+use NTP in this case, which is even better.
172+.TP 0.2i
173+\(bu
174+\fBclockdiff\fR shows difference in time modulo 24 days.
175+.SH "SEE ALSO"
176+.PP
177+\fBping\fR(8),
178+\fBarping\fR(8),
179+\fBtracepath\fR(8).
180+.SH "REFERENCES"
181+.PP
182+[1] ICMP ECHO,
183+RFC0792, page 14.
184+.PP
185+[2] ICMP TIMESTAMP,
186+RFC0792, page 16.
187+.PP
188+[3] IP TIMESTAMP option,
189+RFC0791, 3.1, page 16.
190+.SH "AUTHOR"
191+.PP
192+\fBclockdiff\fR was compiled by
193+Alexey Kuznetsov
194+<kuznet@ms2.inr.ac.ru>. It was based on code borrowed
195+from BSD \fBtimed\fR daemon.
196+It is now maintained by
197+YOSHIFUJI Hideaki
198+<yoshfuji@skbuff.net>.
199+.SH "SECURITY"
200+.PP
201+\fBclockdiff\fR requires CAP_NET_RAWIO capability
202+to be executed. It is safe to be used as set-uid root.
203+.SH "AVAILABILITY"
204+.PP
205+\fBclockdiff\fR is part of \fIiputils\fR package
206+and the latest versions are available in source form at
207+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
[ecc1136]208diff -Naur iputils-s20101006.orig/doc/index.html iputils-s20101006/doc/index.html
209--- iputils-s20101006.orig/doc/index.html 1969-12-31 19:00:00.000000000 -0500
210+++ iputils-s20101006/doc/index.html 2011-01-08 20:09:49.631531431 -0500
[8867e46]211@@ -0,0 +1,170 @@
212+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
213+<HTML
214+><HEAD
215+><TITLE
216+>System Manager's Manual: iputils</TITLE
217+><META
218+NAME="GENERATOR"
219+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
220+REL="NEXT"
221+TITLE="ping"
222+HREF="r3.html"></HEAD
223+><BODY
224+CLASS="REFERENCE"
225+BGCOLOR="#FFFFFF"
226+TEXT="#000000"
227+LINK="#0000FF"
228+VLINK="#840084"
229+ALINK="#0000FF"
230+><DIV
231+CLASS="NAVHEADER"
232+><TABLE
233+SUMMARY="Header navigation table"
234+WIDTH="100%"
235+BORDER="0"
236+CELLPADDING="0"
237+CELLSPACING="0"
238+><TR
239+><TD
240+WIDTH="10%"
241+ALIGN="left"
242+VALIGN="bottom"
243+>&nbsp;</TD
244+><TD
245+WIDTH="80%"
246+ALIGN="center"
247+VALIGN="bottom"
248+></TD
249+><TD
250+WIDTH="10%"
251+ALIGN="right"
252+VALIGN="bottom"
253+><A
254+HREF="r3.html"
255+ACCESSKEY="N"
256+>Next</A
257+></TD
258+></TR
259+></TABLE
260+><HR
261+ALIGN="LEFT"
262+WIDTH="100%"></DIV
263+><DIV
264+CLASS="REFERENCE"
265+><A
266+NAME="INDEX"
267+></A
268+><DIV
269+CLASS="TITLEPAGE"
270+><H1
271+CLASS="TITLE"
272+>I. System Manager's Manual: iputils</H1
273+><DIV
274+CLASS="TOC"
275+><DL
276+><DT
277+><B
278+>Table of Contents</B
279+></DT
280+><DT
281+><A
282+HREF="r3.html"
283+>ping</A
284+>&nbsp;--&nbsp;send ICMP ECHO_REQUEST to network hosts</DT
285+><DT
286+><A
287+HREF="r437.html"
288+>arping</A
289+>&nbsp;--&nbsp;send ARP REQUEST to a neighbour host</DT
290+><DT
291+><A
292+HREF="r596.html"
293+>clockdiff</A
294+>&nbsp;--&nbsp;measure clock difference between hosts</DT
295+><DT
296+><A
297+HREF="r691.html"
298+>rarpd</A
299+>&nbsp;--&nbsp;answer RARP REQUESTs</DT
300+><DT
301+><A
302+HREF="r790.html"
303+>tracepath</A
304+>&nbsp;--&nbsp;traces path to a network host discovering MTU along this path</DT
305+><DT
306+><A
307+HREF="r884.html"
308+>traceroute6</A
309+>&nbsp;--&nbsp;traces path to a network host</DT
310+><DT
311+><A
312+HREF="r949.html"
313+>tftpd</A
314+>&nbsp;--&nbsp;Trivial File Transfer Protocol server</DT
315+><DT
316+><A
317+HREF="r1022.html"
318+>rdisc</A
319+>&nbsp;--&nbsp;network router discovery daemon</DT
320+><DT
321+><A
322+HREF="r1144.html"
323+>pg3</A
324+>&nbsp;--&nbsp;send stream of UDP packets</DT
325+></DL
326+></DIV
327+></DIV
328+></DIV
329+><DIV
330+CLASS="NAVFOOTER"
331+><HR
332+ALIGN="LEFT"
333+WIDTH="100%"><TABLE
334+SUMMARY="Footer navigation table"
335+WIDTH="100%"
336+BORDER="0"
337+CELLPADDING="0"
338+CELLSPACING="0"
339+><TR
340+><TD
341+WIDTH="33%"
342+ALIGN="left"
343+VALIGN="top"
344+>&nbsp;</TD
345+><TD
346+WIDTH="34%"
347+ALIGN="center"
348+VALIGN="top"
349+>&nbsp;</TD
350+><TD
351+WIDTH="33%"
352+ALIGN="right"
353+VALIGN="top"
354+><A
355+HREF="r3.html"
356+ACCESSKEY="N"
357+>Next</A
358+></TD
359+></TR
360+><TR
361+><TD
362+WIDTH="33%"
363+ALIGN="left"
364+VALIGN="top"
365+>&nbsp;</TD
366+><TD
367+WIDTH="34%"
368+ALIGN="center"
369+VALIGN="top"
370+>&nbsp;</TD
371+><TD
372+WIDTH="33%"
373+ALIGN="right"
374+VALIGN="top"
375+>ping</TD
376+></TR
377+></TABLE
378+></DIV
379+></BODY
380+></HTML
381+>
382\ No newline at end of file
[ecc1136]383diff -Naur iputils-s20101006.orig/doc/iputils.html iputils-s20101006/doc/iputils.html
384--- iputils-s20101006.orig/doc/iputils.html 1969-12-31 19:00:00.000000000 -0500
385+++ iputils-s20101006/doc/iputils.html 2011-01-08 20:09:50.282802377 -0500
[8867e46]386@@ -0,0 +1,491 @@
387+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
388+<HTML
389+><HEAD
390+><TITLE
391+>iputils: documentation directory</TITLE
392+><META
393+NAME="GENERATOR"
394+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
395+><BODY
396+CLASS="ARTICLE"
397+BGCOLOR="#FFFFFF"
398+TEXT="#000000"
399+LINK="#0000FF"
400+VLINK="#840084"
401+ALINK="#0000FF"
402+><DIV
403+CLASS="ARTICLE"
404+><DIV
405+CLASS="TITLEPAGE"
406+><H1
407+CLASS="TITLE"
408+><A
409+NAME="AEN2"
410+>iputils: documentation directory</A
411+></H1
412+><HR></DIV
413+><DIV
414+CLASS="TOC"
415+><DL
416+><DT
417+><B
418+>Table of Contents</B
419+></DT
420+><DT
421+>1. <A
422+HREF="#AEN4"
423+>Index</A
424+></DT
425+><DT
426+>2. <A
427+HREF="#AEN34"
428+>Historical notes</A
429+></DT
430+><DT
431+>3. <A
432+HREF="#AEN89"
433+>Installation notes</A
434+></DT
435+><DT
436+>4. <A
437+HREF="#AEN109"
438+>Availability</A
439+></DT
440+><DT
441+>5. <A
442+HREF="#AEN114"
443+>Copying</A
444+></DT
445+></DL
446+></DIV
447+><DIV
448+CLASS="SECT1"
449+><H2
450+CLASS="SECT1"
451+><A
452+NAME="AEN4"
453+>1. Index</A
454+></H2
455+><P
456+></P
457+><UL
458+><LI
459+><P
460+> <A
461+HREF="ping.html"
462+TARGET="_top"
463+>ping, ping6</A
464+>.
465+ </P
466+></LI
467+><LI
468+><P
469+> <A
470+HREF="arping.html"
471+TARGET="_top"
472+>arping</A
473+>.
474+ </P
475+></LI
476+><LI
477+><P
478+> <A
479+HREF="clockdiff.html"
480+TARGET="_top"
481+>clockdiff</A
482+>.
483+ </P
484+></LI
485+><LI
486+><P
487+> <A
488+HREF="rarpd.html"
489+TARGET="_top"
490+>rarpd</A
491+>.
492+ </P
493+></LI
494+><LI
495+><P
496+> <A
497+HREF="tracepath.html"
498+TARGET="_top"
499+>tracepath, tracepath6</A
500+>.
501+ </P
502+></LI
503+><LI
504+><P
505+> <A
506+HREF="traceroute6.html"
507+TARGET="_top"
508+>traceroute6</A
509+>.
510+ </P
511+></LI
512+><LI
513+><P
514+> <A
515+HREF="rdisc.html"
516+TARGET="_top"
517+>rdisc</A
518+>.
519+ </P
520+></LI
521+><LI
522+><P
523+> <A
524+HREF="tftpd.html"
525+TARGET="_top"
526+>tftpd</A
527+>.
528+ </P
529+></LI
530+><LI
531+><P
532+> <A
533+HREF="pg3.html"
534+TARGET="_top"
535+>pg3, ipg, pgset</A
536+>.
537+ </P
538+></LI
539+></UL
540+></DIV
541+><DIV
542+CLASS="SECT1"
543+><HR><H2
544+CLASS="SECT1"
545+><A
546+NAME="AEN34"
547+>2. Historical notes</A
548+></H2
549+><P
550+>This package appeared as a desperate attempt to bring some life
551+to state of basic networking applets: <B
552+CLASS="COMMAND"
553+>ping</B
554+>, <B
555+CLASS="COMMAND"
556+>traceroute</B
557+>
558+etc. Though it was known that port of BSD <B
559+CLASS="COMMAND"
560+>ping</B
561+> to Linux
562+was basically broken, neither maintainers of well known (and superb)
563+Linux net-tools package nor maintainers of Linux distributions
564+worried about fixing well known bugs, which were reported in linux-kernel
565+and linux-net mail lists for ages, were identified and nevertheless
566+not repaired. So, one day 1001th resuming of the subject happened
567+to be the last straw to break camel's back, I just parsed my hard disks
568+and collected a set of utilities, which shared the following properties:</P
569+><P
570+></P
571+><UL
572+><LI
573+><P
574+>Small
575+ </P
576+></LI
577+><LI
578+><P
579+>Useful despite of this
580+ </P
581+></LI
582+><LI
583+><P
584+>I never seen it was made right
585+ </P
586+></LI
587+><LI
588+><P
589+>Not quite trivial
590+ </P
591+></LI
592+><LI
593+><P
594+>Demonstrating some important feature of Linux
595+ </P
596+></LI
597+><LI
598+><P
599+>The last but not the least, I use it more or less regularly
600+ </P
601+></LI
602+></UL
603+><P
604+>This utility set was not supposed to be a reference set or something like
605+that. Most of them were cloned from some originals:
606+<DIV
607+CLASS="INFORMALTABLE"
608+><P
609+></P
610+><A
611+NAME="AEN54"
612+></A
613+><TABLE
614+BORDER="1"
615+CLASS="CALSTABLE"
616+><COL><COL><TBODY
617+><TR
618+><TD
619+>ping</TD
620+><TD
621+>cloned of an ancient NetTools-B-xx</TD
622+></TR
623+><TR
624+><TD
625+>ping6</TD
626+><TD
627+>cloned of a very old Pedro's utility set</TD
628+></TR
629+><TR
630+><TD
631+>traceroute6</TD
632+><TD
633+>cloned of NRL Sep 96 distribution</TD
634+></TR
635+><TR
636+><TD
637+>rdisc</TD
638+><TD
639+>cloned of SUN in.rdisc</TD
640+></TR
641+><TR
642+><TD
643+>clockdiff</TD
644+><TD
645+>broken out of some BSD timed</TD
646+></TR
647+><TR
648+><TD
649+>tftpd</TD
650+><TD
651+>it is clone of some ancient NetKit package</TD
652+></TR
653+></TBODY
654+></TABLE
655+><P
656+></P
657+></DIV
658+></P
659+><P
660+>Also I added some utilities written from scratch, namely
661+<B
662+CLASS="COMMAND"
663+>tracepath</B
664+>, <B
665+CLASS="COMMAND"
666+>arping</B
667+> and later <B
668+CLASS="COMMAND"
669+>rarpd</B
670+>
671+(the last one does not satisfy all the criteria, I used it two or three
672+times).</P
673+><P
674+>Hesitated a bit I overcame temptation to add <B
675+CLASS="COMMAND"
676+>traceroute</B
677+>.
678+The variant released by LBNL to that time was mostly sane and bugs
679+in it were mostly not specific to Linux, but main reason was that
680+the latest version of LBNL <B
681+CLASS="COMMAND"
682+>traceroute</B
683+> was not
684+<SPAN
685+CLASS="emphasis"
686+><I
687+CLASS="EMPHASIS"
688+>small</I
689+></SPAN
690+>, it consisted of several files,
691+used a wicked (and failing with Linux :-)) autoconfiguration etc.
692+So, instead I assembled to iputils a simplistic <B
693+CLASS="COMMAND"
694+>tracepath</B
695+> utility
696+and IPv6 version of traceroute, and published my
697+<A
698+HREF="ftp://ftp.inr.ac.ru/ip-routing/lbl-tools"
699+TARGET="_top"
700+> patches</A
701+>.
702+to LBNL <B
703+CLASS="COMMAND"
704+>traceroute</B
705+> separately.<A
706+NAME="AEN86"
707+HREF="#FTN.AEN86"
708+><SPAN
709+CLASS="footnote"
710+>[1]</SPAN
711+></A
712+></P
713+></DIV
714+><DIV
715+CLASS="SECT1"
716+><HR><H2
717+CLASS="SECT1"
718+><A
719+NAME="AEN89"
720+>3. Installation notes</A
721+></H2
722+><P
723+><KBD
724+CLASS="USERINPUT"
725+>make</KBD
726+> to compile utilities. <KBD
727+CLASS="USERINPUT"
728+>make html</KBD
729+> to prepare
730+html documentation, <KBD
731+CLASS="USERINPUT"
732+>make man</KBD
733+> if you prefer man pages.
734+Nothing fancy, provided you have DocBook package installed.</P
735+><P
736+><KBD
737+CLASS="USERINPUT"
738+>make install</KBD
739+> installs <SPAN
740+CLASS="emphasis"
741+><I
742+CLASS="EMPHASIS"
743+>only</I
744+></SPAN
745+> HTML documentation
746+to <TT
747+CLASS="FILENAME"
748+>/usr/doc/iputils</TT
749+>. It even does not try
750+to install binaries and man pages. If you read historical
751+notes above, the reason should be evident. Most of utilities
752+intersect with utilities distributed in another packages, and
753+making such target rewriting existing installation would be a crime
754+from my side. The decision what variant of <B
755+CLASS="COMMAND"
756+>ping</B
757+> is preferred,
758+how to resolve the conflicts etc. is left to you or to person who
759+assembled an rpm. I vote for variant from <B
760+CLASS="COMMAND"
761+>iputils</B
762+> of course.</P
763+><P
764+>Anyway, select utilities which you like and install them to the places
765+which you prefer together with their man pages.</P
766+><P
767+>It is possible that compilation will fail, if you use some
768+funny Linux distribution mangling header files in some unexpected ways
769+(expected ones are the ways of redhat of course :-)).
770+I validate iputils against <A
771+HREF="http://www.asplinux.ru"
772+TARGET="_top"
773+>asplinux</A
774+>
775+distribution, which is inevitably followed by validity with respect
776+to <A
777+HREF="http://www.redhat.com"
778+TARGET="_top"
779+>redhat</A
780+>.
781+If your distribution is one of widely known ones, suse or debian,
782+it also will compile provided snapshot is elder than month or so and
783+someone reported all the problems, if they took place at all.</P
784+><P
785+><SPAN
786+CLASS="emphasis"
787+><I
788+CLASS="EMPHASIS"
789+>Anyway, please, do not abuse me complaining about some compilation problems
790+in any distribution different of asplinux or redhat.
791+If you have a fix, please, send it to
792+<A
793+HREF="mailto:kuznet@ms2.inr.ac.ru"
794+TARGET="_top"
795+>me</A
796+>,
797+I will check that it does not break distributions mentioned above
798+and apply it. But I am not going to undertake any investigations,
799+bare reports are deemed to be routed to <TT
800+CLASS="FILENAME"
801+>/dev/null</TT
802+>.</I
803+></SPAN
804+></P
805+></DIV
806+><DIV
807+CLASS="SECT1"
808+><HR><H2
809+CLASS="SECT1"
810+><A
811+NAME="AEN109"
812+>4. Availability</A
813+></H2
814+><P
815+>The collection of documents is part of <TT
816+CLASS="FILENAME"
817+>iputils</TT
818+> package
819+and the latest versions are available in source form at
820+<A
821+HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2"
822+TARGET="_top"
823+>http://www.skbuff.net/iputils/iputils-current.tar.bz2</A
824+>.</P
825+></DIV
826+><DIV
827+CLASS="SECT1"
828+><HR><H2
829+CLASS="SECT1"
830+><A
831+NAME="AEN114"
832+>5. Copying</A
833+></H2
834+><P
835+>Different files are copyrighted by different persons and organizations
836+and distributed under different licenses. For details look into corresponding
837+source files.</P
838+></DIV
839+></DIV
840+><H3
841+CLASS="FOOTNOTES"
842+>Notes</H3
843+><TABLE
844+BORDER="0"
845+CLASS="FOOTNOTES"
846+WIDTH="100%"
847+><TR
848+><TD
849+ALIGN="LEFT"
850+VALIGN="TOP"
851+WIDTH="5%"
852+><A
853+NAME="FTN.AEN86"
854+HREF="#AEN86"
855+><SPAN
856+CLASS="footnote"
857+>[1]</SPAN
858+></A
859+></TD
860+><TD
861+ALIGN="LEFT"
862+VALIGN="TOP"
863+WIDTH="95%"
864+><P
865+>This was mistake.
866+Due to this <B
867+CLASS="COMMAND"
868+>traceroute</B
869+> was in a sad state until recently.
870+Good news, redhat-7.2 seems to add these patches to their traceroute
871+rpm eventually. So, I think I will refrain of suicide for awhile.</P
872+></TD
873+></TR
874+></TABLE
875+></BODY
876+></HTML
877+>
878\ No newline at end of file
[ecc1136]879diff -Naur iputils-s20101006.orig/doc/pg3.8 iputils-s20101006/doc/pg3.8
880--- iputils-s20101006.orig/doc/pg3.8 1969-12-31 19:00:00.000000000 -0500
881+++ iputils-s20101006/doc/pg3.8 2011-01-08 20:09:50.890656148 -0500
[8867e46]882@@ -0,0 +1,86 @@
883+.\" This manpage has been automatically generated by docbook2man
884+.\" from a DocBook document. This tool can be found at:
885+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
886+.\" Please send any bug reports, improvements, comments, patches,
887+.\" etc. to Steve Cheng <steve@ggi-project.org>.
[ecc1136]888+.TH "PG3" "8" "08 January 2011" "iputils-101006" "System Manager's Manual: iputils"
[8867e46]889+.SH NAME
890+pg3, ipg, pgset \- send stream of UDP packets
891+.SH SYNOPSIS
892+
893+\fBsource ipg\fR
894+
895+
896+\fBpg\fR
897+
898+
899+\fBpgset\fR \fB\fICOMMAND\fB\fR
900+
901+.SH "DESCRIPTION"
902+.PP
903+\fBipg\fR is not a program, it is script which should be sourced
904+to \fBbash\fR. When sourced it loads module \fIpg3\fR and
905+exports a few of functions accessible from parent shell. These macros
906+are \fBpg\fR to start packet injection and to get the results of run;
907+and \fBpgset\fR to setup packet generator.
908+.PP
909+\fBpgset\fR can send the following commands to module \fIpg3\fR:
910+.SH "COMMAND"
911+.TP
912+\fBodev \fIDEVICE\fB\fR
913+Name of Ethernet device to test. See
914+warning below.
915+.TP
916+\fBpkt_size \fIBYTES\fB\fR
917+Size of packet to generate. The size includes all the headers: UDP, IP,
918+MAC, but does not account for overhead internal to medium, i.e. FCS
919+and various paddings.
920+.TP
921+\fBfrags \fINUMBER\fB\fR
922+Each packet will contain \fINUMBER\fR of fragments.
923+Maximal amount for linux-2.4 is 6. Far not all the devices support
924+fragmented buffers.
925+.TP
926+\fBcount \fINUMBER\fB\fR
927+Send stream of \fINUMBER\fR of packets and stop after this.
928+.TP
929+\fBipg \fITIME\fB\fR
930+Introduce artificial delay between packets of \fITIME\fR
931+microseconds.
932+.TP
933+\fBdst \fIIP_ADDRESS\fB\fR
934+Select IP destination where the stream is sent to.
935+Beware, never set this address at random. \fBpg3\fR is not a toy,
936+it creates really tough stream. Default value is 0.0.0.0.
937+.TP
938+\fBdst \fIMAC_ADDRESS\fB\fR
939+Select MAC destination where the stream is sent to.
940+Default value is 00:00:00:00:00:00 in hope that this will not be received
941+by any node on LAN.
942+.TP
943+\fBstop\fR
944+Abort packet injection.
945+.SH "WARNING"
946+.PP
947+When output device is set to some random device different
948+of hardware Ethernet device, \fBpg3\fR will crash kernel.
949+.PP
950+Do not use it on VLAN, ethertap, VTUN and other devices,
951+which emulate Ethernet not being real Ethernet in fact.
952+.SH "AUTHOR"
953+.PP
954+\fBpg3\fR was written by Robert Olsson <robert.olsson@its.uu.se>.
955+.SH "SECURITY"
956+.PP
957+This can be used only by superuser.
958+.PP
959+This tool creates floods of packets which is unlikely to be handled
960+even by high-end machines. For example, it saturates gigabit link with
961+60 byte packets when used with Intel's e1000. In face of such stream
962+switches, routers and end hosts may deadlock, crash, explode.
963+Use only in test lab environment.
964+.SH "AVAILABILITY"
965+.PP
966+\fBpg3\fR is part of \fIiputils\fR package
967+and the latest versions are available in source form at
968+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
[ecc1136]969diff -Naur iputils-s20101006.orig/doc/ping.8 iputils-s20101006/doc/ping.8
970--- iputils-s20101006.orig/doc/ping.8 1969-12-31 19:00:00.000000000 -0500
971+++ iputils-s20101006/doc/ping.8 2011-01-08 20:09:50.986782167 -0500
[8867e46]972@@ -0,0 +1,408 @@
973+.\" This manpage has been automatically generated by docbook2man
974+.\" from a DocBook document. This tool can be found at:
975+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
976+.\" Please send any bug reports, improvements, comments, patches,
977+.\" etc. to Steve Cheng <steve@ggi-project.org>.
[ecc1136]978+.TH "PING" "8" "08 January 2011" "iputils-101006" "System Manager's Manual: iputils"
[8867e46]979+.SH NAME
980+ping, ping6 \- send ICMP ECHO_REQUEST to network hosts
981+.SH SYNOPSIS
982+
983+\fBping\fR [\fB-LRUbdfnqrvVaAB\fR] [\fB-c \fIcount\fB\fR] [\fB-m \fImark\fB\fR] [\fB-i \fIinterval\fB\fR] [\fB-l \fIpreload\fB\fR] [\fB-p \fIpattern\fB\fR] [\fB-s \fIpacketsize\fB\fR] [\fB-t \fIttl\fB\fR] [\fB-w \fIdeadline\fB\fR] [\fB-F \fIflowlabel\fB\fR] [\fB-I \fIinterface\fB\fR] [\fB-M \fIhint\fB\fR] [\fB-N \fInioption\fB\fR] [\fB-Q \fItos\fB\fR] [\fB-S \fIsndbuf\fB\fR] [\fB-T \fItimestamp option\fB\fR] [\fB-W \fItimeout\fB\fR] [\fB\fIhop\fB\fR\fI ...\fR] \fB\fIdestination\fB\fR
984+
985+.SH "DESCRIPTION"
986+.PP
987+\fBping\fR uses the ICMP protocol's mandatory ECHO_REQUEST
988+datagram to elicit an ICMP ECHO_RESPONSE from a host or gateway.
989+ECHO_REQUEST datagrams (``pings'') have an IP and ICMP
990+header, followed by a struct timeval and then an arbitrary
991+number of ``pad'' bytes used to fill out the packet.
992+.PP
993+\fBping6\fR can also send Node Information Queries (RFC4620).
994+.SH "OPTIONS"
995+.TP
996+\fB-a\fR
997+Audible ping.
998+.TP
999+\fB-A\fR
1000+Adaptive ping. Interpacket interval adapts to round-trip time, so that
1001+effectively not more than one (or more, if preload is set) unanswered probes
1002+present in the network. Minimal interval is 200msec for not super-user.
1003+On networks with low rtt this mode is essentially equivalent to flood mode.
1004+.TP
1005+\fB-b\fR
1006+Allow pinging a broadcast address.
1007+.TP
1008+\fB-B\fR
1009+Do not allow \fBping\fR to change source address of probes.
1010+The address is bound to one selected when \fBping\fR starts.
1011+.TP
1012+\fB-m \fImark\fB\fR
1013+use \fImark\fR to tag the packets going out. This is useful
1014+for variety of reasons within the kernel such as using policy
1015+routing to select specific outbound processing.
1016+.TP
1017+\fB-c \fIcount\fB\fR
1018+Stop after sending \fIcount\fR ECHO_REQUEST
1019+packets. With
1020+\fIdeadline\fR
1021+option, \fBping\fR waits for
1022+\fIcount\fR ECHO_REPLY packets, until the timeout expires.
1023+.TP
1024+\fB-d\fR
1025+Set the SO_DEBUG option on the socket being used.
1026+Essentially, this socket option is not used by Linux kernel.
1027+.TP
1028+\fB-F \fIflow label\fB\fR
1029+Allocate and set 20 bit flow label on echo request packets.
1030+(Only \fBping6\fR). If value is zero, kernel allocates random flow label.
1031+.TP
1032+\fB-f\fR
1033+Flood ping. For every ECHO_REQUEST sent a period ``.'' is printed,
1034+while for ever ECHO_REPLY received a backspace is printed.
1035+This provides a rapid display of how many packets are being dropped.
1036+If interval is not given, it sets interval to zero and
1037+outputs packets as fast as they come back or one hundred times per second,
1038+whichever is more.
1039+Only the super-user may use this option with zero interval.
1040+.TP
1041+\fB-i \fIinterval\fB\fR
1042+Wait \fIinterval\fR seconds between sending each packet.
1043+The default is to wait for one second between each packet normally,
1044+or not to wait in flood mode. Only super-user may set interval
1045+to values less 0.2 seconds.
1046+.TP
1047+\fB-I \fIinterface address\fB\fR
1048+Set source address to specified interface address. Argument
1049+may be numeric IP address or name of device. When pinging IPv6
1050+link-local address this option is required.
1051+.TP
1052+\fB-l \fIpreload\fB\fR
1053+If \fIpreload\fR is specified,
1054+\fBping\fR sends that many packets not waiting for reply.
1055+Only the super-user may select preload more than 3.
1056+.TP
1057+\fB-L\fR
1058+Suppress loopback of multicast packets. This flag only applies if the ping
1059+destination is a multicast address.
1060+.TP
1061+\fB-N \fInioption\fB\fR
1062+Send ICMPv6 Node Information Queries (RFC4620), instead of Echo Request.
1063+.RS
1064+.TP
1065+\fBname\fR
1066+Queries for Node Names.
1067+.RE
1068+.RS
1069+.TP
1070+\fBipv6\fR
1071+Queries for IPv6 Addresses. There are several IPv6 specific flags.
1072+.RS
1073+.TP
1074+\fBipv6-global\fR
1075+Request IPv6 global-scope addresses.
1076+.RE
1077+.RS
1078+.TP
1079+\fBipv6-sitelocal\fR
1080+Request IPv6 site-local addresses.
1081+.RE
1082+.RS
1083+.TP
1084+\fBipv6-linklocal\fR
1085+Request IPv6 link-local addresses.
1086+.RE
1087+.RS
1088+.TP
1089+\fBipv6-all\fR
1090+Request IPv6 addresses on other interfaces.
1091+.RE
1092+.RE
1093+.RS
1094+.TP
1095+\fBipv4\fR
1096+Queries for IPv4 Addresses. There is one IPv4 specific flag.
1097+.RS
1098+.TP
1099+\fBipv4-all\fR
1100+Request IPv4 addresses on other interfaces.
1101+.RE
1102+.RE
1103+.RS
1104+.TP
1105+\fBsubject-ipv6=\fIipv6addr\fB\fR
1106+IPv6 subject address.
1107+.RE
1108+.RS
1109+.TP
1110+\fBsubject-ipv4=\fIipv4addr\fB\fR
1111+IPv4 subject address.
1112+.RE
1113+.RS
1114+.TP
1115+\fBsubject-name=\fInodename\fB\fR
1116+Subject name. If it contains more than one dot,
1117+fully-qualified domain name is assumed.
1118+.RE
1119+.RS
1120+.TP
1121+\fBsubject-fqdn=\fInodename\fB\fR
1122+Subject name. Fully-qualified domain name is
1123+always assumed.
1124+.RE
1125+.TP
1126+\fB-n\fR
1127+Numeric output only.
1128+No attempt will be made to lookup symbolic names for host addresses.
1129+.TP
1130+\fB-p \fIpattern\fB\fR
1131+You may specify up to 16 ``pad'' bytes to fill out the packet you send.
1132+This is useful for diagnosing data-dependent problems in a network.
1133+For example, \fB-p ff\fR will cause the sent packet
1134+to be filled with all ones.
1135+.TP
1136+\fB-D\fR
1137+Print timestamp (unix time + microseconds as in gettimeofday) before
1138+each line.
1139+.TP
1140+\fB-Q \fItos\fB\fR
1141+Set Quality of Service -related bits in ICMP datagrams.
1142+\fItos\fR can be either decimal or hex number.
1143+Traditionally (RFC1349), these have been interpreted as: 0 for reserved
1144+(currently being redefined as congestion control), 1-4 for Type of Service
1145+and 5-7 for Precedence.
1146+Possible settings for Type of Service are: minimal cost: 0x02,
1147+reliability: 0x04, throughput: 0x08, low delay: 0x10. Multiple TOS bits
1148+should not be set simultaneously. Possible settings for
1149+special Precedence range from priority (0x20) to net control (0xe0). You
1150+must be root (CAP_NET_ADMIN capability) to use Critical or
1151+higher precedence value. You cannot set
1152+bit 0x01 (reserved) unless ECN has been enabled in the kernel.
1153+In RFC2474, these fields has been redefined as 8-bit Differentiated
1154+Services (DS), consisting of: bits 0-1 of separate data (ECN will be used,
1155+here), and bits 2-7 of Differentiated Services Codepoint (DSCP).
1156+.TP
1157+\fB-q\fR
1158+Quiet output.
1159+Nothing is displayed except the summary lines at startup time and
1160+when finished.
1161+.TP
1162+\fB-R\fR
1163+Record route.
1164+Includes the RECORD_ROUTE option in the ECHO_REQUEST
1165+packet and displays the route buffer on returned packets.
1166+Note that the IP header is only large enough for nine such routes.
1167+Many hosts ignore or discard this option.
1168+.TP
1169+\fB-r\fR
1170+Bypass the normal routing tables and send directly to a host on an attached
1171+interface.
1172+If the host is not on a directly-attached network, an error is returned.
1173+This option can be used to ping a local host through an interface
1174+that has no route through it provided the option \fB-I\fR is also
1175+used.
1176+.TP
1177+\fB-s \fIpacketsize\fB\fR
1178+Specifies the number of data bytes to be sent.
1179+The default is 56, which translates into 64 ICMP
1180+data bytes when combined with the 8 bytes of ICMP header data.
1181+.TP
1182+\fB-S \fIsndbuf\fB\fR
1183+Set socket sndbuf. If not specified, it is selected to buffer
1184+not more than one packet.
1185+.TP
1186+\fB-t \fIttl\fB\fR
1187+Set the IP Time to Live.
1188+.TP
1189+\fB-T \fItimestamp option\fB\fR
1190+Set special IP timestamp options.
1191+\fItimestamp option\fR may be either
1192+\fItsonly\fR (only timestamps),
1193+\fItsandaddr\fR (timestamps and addresses) or
1194+\fItsprespec host1 [host2 [host3 [host4]]]\fR
1195+(timestamp prespecified hops).
1196+.TP
1197+\fB-M \fIhint\fB\fR
1198+Select Path MTU Discovery strategy.
1199+\fIhint\fR may be either \fIdo\fR
1200+(prohibit fragmentation, even local one),
1201+\fIwant\fR (do PMTU discovery, fragment locally when packet size
1202+is large), or \fIdont\fR (do not set DF flag).
1203+.TP
1204+\fB-U\fR
1205+Print full user-to-user latency (the old behaviour). Normally
1206+\fBping\fR
1207+prints network round trip time, which can be different
1208+f.e. due to DNS failures.
1209+.TP
1210+\fB-v\fR
1211+Verbose output.
1212+.TP
1213+\fB-V\fR
1214+Show version and exit.
1215+.TP
1216+\fB-w \fIdeadline\fB\fR
1217+Specify a timeout, in seconds, before
1218+\fBping\fR
1219+exits regardless of how many
1220+packets have been sent or received. In this case
1221+\fBping\fR
1222+does not stop after
1223+\fIcount\fR
1224+packet are sent, it waits either for
1225+\fIdeadline\fR
1226+expire or until
1227+\fIcount\fR
1228+probes are answered or for some error notification from network.
1229+.TP
1230+\fB-W \fItimeout\fB\fR
1231+Time to wait for a response, in seconds. The option affects only timeout
1232+in absense of any responses, otherwise \fBping\fR waits for two RTTs.
1233+.PP
1234+When using \fBping\fR for fault isolation, it should first be run
1235+on the local host, to verify that the local network interface is up
1236+and running. Then, hosts and gateways further and further away should be
1237+``pinged''. Round-trip times and packet loss statistics are computed.
1238+If duplicate packets are received, they are not included in the packet
1239+loss calculation, although the round trip time of these packets is used
1240+in calculating the minimum/average/maximum round-trip time numbers.
1241+When the specified number of packets have been sent (and received) or
1242+if the program is terminated with a
1243+SIGINT, a brief summary is displayed. Shorter current statistics
1244+can be obtained without termination of process with signal
1245+SIGQUIT.
1246+.PP
1247+If \fBping\fR does not receive any reply packets at all it will
1248+exit with code 1. If a packet
1249+\fIcount\fR
1250+and
1251+\fIdeadline\fR
1252+are both specified, and fewer than
1253+\fIcount\fR
1254+packets are received by the time the
1255+\fIdeadline\fR
1256+has arrived, it will also exit with code 1.
1257+On other error it exits with code 2. Otherwise it exits with code 0. This
1258+makes it possible to use the exit code to see if a host is alive or
1259+not.
1260+.PP
1261+This program is intended for use in network testing, measurement and
1262+management.
1263+Because of the load it can impose on the network, it is unwise to use
1264+\fBping\fR during normal operations or from automated scripts.
1265+.SH "ICMP PACKET DETAILS"
1266+.PP
1267+An IP header without options is 20 bytes.
1268+An ICMP ECHO_REQUEST packet contains an additional 8 bytes worth
1269+of ICMP header followed by an arbitrary amount of data.
1270+When a \fIpacketsize\fR is given, this indicated the size of this
1271+extra piece of data (the default is 56). Thus the amount of data received
1272+inside of an IP packet of type ICMP ECHO_REPLY will always be 8 bytes
1273+more than the requested data space (the ICMP header).
1274+.PP
1275+If the data space is at least of size of struct timeval
1276+\fBping\fR uses the beginning bytes of this space to include
1277+a timestamp which it uses in the computation of round trip times.
1278+If the data space is shorter, no round trip times are given.
1279+.SH "DUPLICATE AND DAMAGED PACKETS"
1280+.PP
1281+\fBping\fR will report duplicate and damaged packets.
1282+Duplicate packets should never occur, and seem to be caused by
1283+inappropriate link-level retransmissions.
1284+Duplicates may occur in many situations and are rarely (if ever) a
1285+good sign, although the presence of low levels of duplicates may not
1286+always be cause for alarm.
1287+.PP
1288+Damaged packets are obviously serious cause for alarm and often
1289+indicate broken hardware somewhere in the
1290+\fBping\fR packet's path (in the network or in the hosts).
1291+.SH "TRYING DIFFERENT DATA PATTERNS"
1292+.PP
1293+The (inter)network layer should never treat packets differently depending
1294+on the data contained in the data portion.
1295+Unfortunately, data-dependent problems have been known to sneak into
1296+networks and remain undetected for long periods of time.
1297+In many cases the particular pattern that will have problems is something
1298+that doesn't have sufficient ``transitions'', such as all ones or all
1299+zeros, or a pattern right at the edge, such as almost all zeros.
1300+It isn't necessarily enough to specify a data pattern of all zeros (for
1301+example) on the command line because the pattern that is of interest is
1302+at the data link level, and the relationship between what you type and
1303+what the controllers transmit can be complicated.
1304+.PP
1305+This means that if you have a data-dependent problem you will probably
1306+have to do a lot of testing to find it.
1307+If you are lucky, you may manage to find a file that either can't be sent
1308+across your network or that takes much longer to transfer than other
1309+similar length files.
1310+You can then examine this file for repeated patterns that you can test
1311+using the \fB-p\fR option of \fBping\fR.
1312+.SH "TTL DETAILS"
1313+.PP
1314+The TTL value of an IP packet represents the maximum number of IP routers
1315+that the packet can go through before being thrown away.
1316+In current practice you can expect each router in the Internet to decrement
1317+the TTL field by exactly one.
1318+.PP
1319+The TCP/IP specification states that the TTL field for TCP
1320+packets should be set to 60, but many systems use smaller values
1321+(4.3 BSD uses 30, 4.2 used 15).
1322+.PP
1323+The maximum possible value of this field is 255, and most Unix systems set
1324+the TTL field of ICMP ECHO_REQUEST packets to 255.
1325+This is why you will find you can ``ping'' some hosts, but not reach them
1326+with
1327+\fBtelnet\fR(1)
1328+or
1329+\fBftp\fR(1).
1330+.PP
1331+In normal operation ping prints the ttl value from the packet it receives.
1332+When a remote system receives a ping packet, it can do one of three things
1333+with the TTL field in its response:
1334+.TP 0.2i
1335+\(bu
1336+Not change it; this is what Berkeley Unix systems did before the
1337+4.3BSD Tahoe release. In this case the TTL value in the received packet
1338+will be 255 minus the number of routers in the round-trip path.
1339+.TP 0.2i
1340+\(bu
1341+Set it to 255; this is what current Berkeley Unix systems do.
1342+In this case the TTL value in the received packet will be 255 minus the
1343+number of routers in the path \fBfrom\fR
1344+the remote system \fBto\fR the \fBping\fRing host.
1345+.TP 0.2i
1346+\(bu
1347+Set it to some other value. Some machines use the same value for
1348+ICMP packets that they use for TCP packets, for example either 30 or 60.
1349+Others may use completely wild values.
1350+.SH "BUGS"
1351+.TP 0.2i
1352+\(bu
1353+Many Hosts and Gateways ignore the RECORD_ROUTE option.
1354+.TP 0.2i
1355+\(bu
1356+The maximum IP header length is too small for options like
1357+RECORD_ROUTE to be completely useful.
1358+There's not much that that can be done about this, however.
1359+.TP 0.2i
1360+\(bu
1361+Flood pinging is not recommended in general, and flood pinging the
1362+broadcast address should only be done under very controlled conditions.
1363+.SH "SEE ALSO"
1364+.PP
1365+\fBnetstat\fR(1),
1366+\fBifconfig\fR(8).
1367+.SH "HISTORY"
1368+.PP
1369+The \fBping\fR command appeared in 4.3BSD.
1370+.PP
1371+The version described here is its descendant specific to Linux.
1372+.SH "SECURITY"
1373+.PP
1374+\fBping\fR requires CAP_NET_RAWIO capability
1375+to be executed. It may be used as set-uid root.
1376+.SH "AVAILABILITY"
1377+.PP
1378+\fBping\fR is part of \fIiputils\fR package
1379+and the latest versions are available in source form at
1380+http://www.skbuff.net/iputils/iputils-current.tar.bz2.
[ecc1136]1381diff -Naur iputils-s20101006.orig/doc/r1022.html iputils-s20101006/doc/r1022.html
1382--- iputils-s20101006.orig/doc/r1022.html 1969-12-31 19:00:00.000000000 -0500
1383+++ iputils-s20101006/doc/r1022.html 2011-01-08 20:09:49.623373190 -0500
[8867e46]1384@@ -0,0 +1,511 @@
1385+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
1386+<HTML
1387+><HEAD
1388+><TITLE
1389+>rdisc</TITLE
1390+><META
1391+NAME="GENERATOR"
1392+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
1393+REL="HOME"
1394+TITLE="System Manager's Manual: iputils"
1395+HREF="index.html"><LINK
1396+REL="PREVIOUS"
1397+TITLE="tftpd"
1398+HREF="r949.html"><LINK
1399+REL="NEXT"
1400+TITLE="pg3"
1401+HREF="r1144.html"></HEAD
1402+><BODY
1403+CLASS="REFENTRY"
1404+BGCOLOR="#FFFFFF"
1405+TEXT="#000000"
1406+LINK="#0000FF"
1407+VLINK="#840084"
1408+ALINK="#0000FF"
1409+><DIV
1410+CLASS="NAVHEADER"
1411+><TABLE
1412+SUMMARY="Header navigation table"
1413+WIDTH="100%"
1414+BORDER="0"
1415+CELLPADDING="0"
1416+CELLSPACING="0"
1417+><TR
1418+><TH
1419+COLSPAN="3"
1420+ALIGN="center"
1421+>System Manager's Manual: iputils</TH
1422+></TR
1423+><TR
1424+><TD
1425+WIDTH="10%"
1426+ALIGN="left"
1427+VALIGN="bottom"
1428+><A
1429+HREF="r949.html"
1430+ACCESSKEY="P"
1431+>Prev</A
1432+></TD
1433+><TD
1434+WIDTH="80%"
1435+ALIGN="center"
1436+VALIGN="bottom"
1437+></TD
1438+><TD
1439+WIDTH="10%"
1440+ALIGN="right"
1441+VALIGN="bottom"
1442+><A
1443+HREF="r1144.html"
1444+ACCESSKEY="N"
1445+>Next</A
1446+></TD
1447+></TR
1448+></TABLE
1449+><HR
1450+ALIGN="LEFT"
1451+WIDTH="100%"></DIV
1452+><H1
1453+><A
1454+NAME="RDISC"
1455+></A
1456+>rdisc</H1
1457+><DIV
1458+CLASS="REFNAMEDIV"
1459+><A
1460+NAME="AEN1027"
1461+></A
1462+><H2
1463+>Name</H2
1464+>rdisc&nbsp;--&nbsp;network router discovery daemon</DIV
1465+><DIV
1466+CLASS="REFSYNOPSISDIV"
1467+><A
1468+NAME="AEN1030"
1469+></A
1470+><H2
1471+>Synopsis</H2
1472+><P
1473+><B
1474+CLASS="COMMAND"
1475+>rdisc</B
1476+> [<CODE
1477+CLASS="OPTION"
1478+>-abdfstvV</CODE
1479+>] [<TT
1480+CLASS="REPLACEABLE"
1481+><I
1482+>send_address</I
1483+></TT
1484+>] [<TT
1485+CLASS="REPLACEABLE"
1486+><I
1487+>receive_address</I
1488+></TT
1489+>]</P
1490+></DIV
1491+><DIV
1492+CLASS="REFSECT1"
1493+><A
1494+NAME="AEN1039"
1495+></A
1496+><H2
1497+>DESCRIPTION</H2
1498+><P
1499+><B
1500+CLASS="COMMAND"
1501+>rdisc</B
1502+> implements client side of the ICMP router discover protocol.
1503+<B
1504+CLASS="COMMAND"
1505+>rdisc</B
1506+> is invoked at boot time to populate the network
1507+routing tables with default routes. </P
1508+><P
1509+><B
1510+CLASS="COMMAND"
1511+>rdisc</B
1512+> listens on the ALL_HOSTS (224.0.0.1) multicast address
1513+(or <TT
1514+CLASS="REPLACEABLE"
1515+><I
1516+>receive_address</I
1517+></TT
1518+> provided it is given)
1519+for ROUTER_ADVERTISE messages from routers. The received
1520+messages are handled by first ignoring those listed router addresses
1521+with which the host does not share a network. Among the remaining addresses
1522+the ones with the highest preference are selected as default routers
1523+and a default route is entered in the kernel routing table
1524+for each one of them.</P
1525+><P
1526+>Optionally, <B
1527+CLASS="COMMAND"
1528+>rdisc</B
1529+> can avoid waiting for routers to announce
1530+themselves by sending out a few ROUTER_SOLICITATION messages
1531+to the ALL_ROUTERS (224.0.0.2) multicast address
1532+(or <TT
1533+CLASS="REPLACEABLE"
1534+><I
1535+>send_address</I
1536+></TT
1537+> provided it is given)
1538+when it is started.</P
1539+><P
1540+>A timer is associated with each router address and the address will
1541+no longer be considered for inclusion in the the routing tables if the
1542+timer expires before a new
1543+<SPAN
1544+CLASS="emphasis"
1545+><I
1546+CLASS="EMPHASIS"
1547+>advertise</I
1548+></SPAN
1549+> message is received from the router.
1550+The address will also be excluded from consideration if the host receives an
1551+<SPAN
1552+CLASS="emphasis"
1553+><I
1554+CLASS="EMPHASIS"
1555+>advertise</I
1556+></SPAN
1557+>
1558+message with the preference being maximally negative.</P
1559+><P
1560+>Server side of router discovery protocol is supported by Cisco IOS
1561+and by any more or less complete UNIX routing daemon, f.e <B
1562+CLASS="COMMAND"
1563+>gated</B
1564+>.</P
1565+></DIV
1566+><DIV
1567+CLASS="REFSECT1"
1568+><A
1569+NAME="AEN1055"
1570+></A
1571+><H2
1572+>OPTIONS</H2
1573+><P
1574+></P
1575+><DIV
1576+CLASS="VARIABLELIST"
1577+><DL
1578+><DT
1579+><CODE
1580+CLASS="OPTION"
1581+>-a</CODE
1582+></DT
1583+><DD
1584+><P
1585+>Accept all routers independently of the preference they have in their
1586+<SPAN
1587+CLASS="emphasis"
1588+><I
1589+CLASS="EMPHASIS"
1590+>advertise</I
1591+></SPAN
1592+> messages.
1593+Normally <B
1594+CLASS="COMMAND"
1595+>rdisc</B
1596+> only accepts (and enters in the kernel routing
1597+tables) the router or routers with the highest preference.
1598+ </P
1599+></DD
1600+><DT
1601+><CODE
1602+CLASS="OPTION"
1603+>-b</CODE
1604+></DT
1605+><DD
1606+><P
1607+>Opposite to <CODE
1608+CLASS="OPTION"
1609+>-a</CODE
1610+>, i.e. install only router with the best
1611+preference value. It is default behaviour.
1612+ </P
1613+></DD
1614+><DT
1615+><CODE
1616+CLASS="OPTION"
1617+>-d</CODE
1618+></DT
1619+><DD
1620+><P
1621+>Send debugging messages to syslog.
1622+ </P
1623+></DD
1624+><DT
1625+><CODE
1626+CLASS="OPTION"
1627+>-f</CODE
1628+></DT
1629+><DD
1630+><P
1631+>Run <B
1632+CLASS="COMMAND"
1633+>rdisc</B
1634+> forever even if no routers are found.
1635+Normally <B
1636+CLASS="COMMAND"
1637+>rdisc</B
1638+> gives up if it has not received any
1639+<SPAN
1640+CLASS="emphasis"
1641+><I
1642+CLASS="EMPHASIS"
1643+>advertise</I
1644+></SPAN
1645+> message after after soliciting three times,
1646+in which case it exits with a non-zero exit code.
1647+If <CODE
1648+CLASS="OPTION"
1649+>-f</CODE
1650+> is not specified in the first form then
1651+<CODE
1652+CLASS="OPTION"
1653+>-s</CODE
1654+> must be specified.
1655+ </P
1656+></DD
1657+><DT
1658+><CODE
1659+CLASS="OPTION"
1660+>-s</CODE
1661+></DT
1662+><DD
1663+><P
1664+>Send three <SPAN
1665+CLASS="emphasis"
1666+><I
1667+CLASS="EMPHASIS"
1668+>solicitation</I
1669+></SPAN
1670+> messages initially to quickly discover
1671+the routers when the system is booted.
1672+When <CODE
1673+CLASS="OPTION"
1674+>-s</CODE
1675+> is specified <B
1676+CLASS="COMMAND"
1677+>rdisc</B
1678+>
1679+exits with a non-zero exit code if it can not find any routers.
1680+This can be overridden with the <CODE
1681+CLASS="OPTION"
1682+>-f</CODE
1683+> option.
1684+ </P
1685+></DD
1686+><DT
1687+><CODE
1688+CLASS="OPTION"
1689+>-t</CODE
1690+></DT
1691+><DD
1692+><P
1693+>Test mode. Do not go to background.
1694+ </P
1695+></DD
1696+><DT
1697+><CODE
1698+CLASS="OPTION"
1699+>-v</CODE
1700+></DT
1701+><DD
1702+><P
1703+>Be verbose i.e. send lots of debugging messages to syslog.
1704+ </P
1705+></DD
1706+><DT
1707+><CODE
1708+CLASS="OPTION"
1709+>-V</CODE
1710+></DT
1711+><DD
1712+><P
1713+>Print version and exit.
1714+ </P
1715+></DD
1716+></DL
1717+></DIV
1718+></DIV
1719+><DIV
1720+CLASS="REFSECT1"
1721+><A
1722+NAME="AEN1110"
1723+></A
1724+><H2
1725+>HISTORY</H2
1726+><P
1727+>This program was developed by Sun Microsystems (see copyright
1728+notice in source file). It was ported to Linux by
1729+<A
1730+HREF="mailto:kuznet@ms2.inr.ac.ru"
1731+TARGET="_top"
1732+>Alexey Kuznetsov
1733+&lt;kuznet@ms2.inr.ac.ru&gt;</A
1734+>.
1735+It is now maintained by
1736+<A
1737+HREF="mailto:yoshfuji@skbuff.net"
1738+TARGET="_top"
1739+>YOSHIFUJI Hideaki
1740+&lt;yoshfuji@skbuff.net&gt;</A
1741+>.</P
1742+></DIV
1743+><DIV
1744+CLASS="REFSECT1"
1745+><A
1746+NAME="AEN1115"
1747+></A
1748+><H2
1749+>SEE ALSO</H2
1750+><P
1751+><SPAN
1752+CLASS="CITEREFENTRY"
1753+><SPAN
1754+CLASS="REFENTRYTITLE"
1755+>icmp</SPAN
1756+>(7)</SPAN
1757+>,
1758+<SPAN
1759+CLASS="CITEREFENTRY"
1760+><SPAN
1761+CLASS="REFENTRYTITLE"
1762+>inet</SPAN
1763+>(7)</SPAN
1764+>,
1765+<A
1766+HREF="r3.html"
1767+><SPAN
1768+CLASS="CITEREFENTRY"
1769+><SPAN
1770+CLASS="REFENTRYTITLE"
1771+>ping</SPAN
1772+>(8)</SPAN
1773+></A
1774+>.</P
1775+></DIV
1776+><DIV
1777+CLASS="REFSECT1"
1778+><A
1779+NAME="AEN1128"
1780+></A
1781+><H2
1782+>REFERENCES</H2
1783+><P
1784+>Deering, S.E.,ed "ICMP Router Discovery Messages",
1785+<A
1786+HREF="ftp://ftp.isi.edu/in-notes/rfc1256.txt"
1787+TARGET="_top"
1788+>RFC1256</A
1789+>, Network Information Center, SRI International,
1790+Menlo Park, Calif., September 1991.</P
1791+></DIV
1792+><DIV
1793+CLASS="REFSECT1"
1794+><A
1795+NAME="AEN1132"
1796+></A
1797+><H2
1798+>SECURITY</H2
1799+><P
1800+><B
1801+CLASS="COMMAND"
1802+>rdisc</B
1803+> requires <CODE
1804+CLASS="CONSTANT"
1805+>CAP_NET_RAWIO</CODE
1806+> to listen
1807+and send ICMP messages and capability <CODE
1808+CLASS="CONSTANT"
1809+>CAP_NET_ADMIN</CODE
1810+>
1811+to update routing tables. </P
1812+></DIV
1813+><DIV
1814+CLASS="REFSECT1"
1815+><A
1816+NAME="AEN1138"
1817+></A
1818+><H2
1819+>AVAILABILITY</H2
1820+><P
1821+><B
1822+CLASS="COMMAND"
1823+>rdisc</B
1824+> is part of <TT
1825+CLASS="FILENAME"
1826+>iputils</TT
1827+> package
1828+and the latest versions are available in source form at
1829+<A
1830+HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2"
1831+TARGET="_top"
1832+>http://www.skbuff.net/iputils/iputils-current.tar.bz2</A
1833+>.</P
1834+></DIV
1835+><DIV
1836+CLASS="NAVFOOTER"
1837+><HR
1838+ALIGN="LEFT"
1839+WIDTH="100%"><TABLE
1840+SUMMARY="Footer navigation table"
1841+WIDTH="100%"
1842+BORDER="0"
1843+CELLPADDING="0"
1844+CELLSPACING="0"
1845+><TR
1846+><TD
1847+WIDTH="33%"
1848+ALIGN="left"
1849+VALIGN="top"
1850+><A
1851+HREF="r949.html"
1852+ACCESSKEY="P"
1853+>Prev</A
1854+></TD
1855+><TD
1856+WIDTH="34%"
1857+ALIGN="center"
1858+VALIGN="top"
1859+><A
1860+HREF="index.html"
1861+ACCESSKEY="H"
1862+>Home</A
1863+></TD
1864+><TD
1865+WIDTH="33%"
1866+ALIGN="right"
1867+VALIGN="top"
1868+><A
1869+HREF="r1144.html"
1870+ACCESSKEY="N"
1871+>Next</A
1872+></TD
1873+></TR
1874+><TR
1875+><TD
1876+WIDTH="33%"
1877+ALIGN="left"
1878+VALIGN="top"
1879+>tftpd</TD
1880+><TD
1881+WIDTH="34%"
1882+ALIGN="center"
1883+VALIGN="top"
1884+>&nbsp;</TD
1885+><TD
1886+WIDTH="33%"
1887+ALIGN="right"
1888+VALIGN="top"
1889+>pg3</TD
1890+></TR
1891+></TABLE
1892+></DIV
1893+></BODY
1894+></HTML
1895+>
1896\ No newline at end of file
[ecc1136]1897diff -Naur iputils-s20101006.orig/doc/r1144.html iputils-s20101006/doc/r1144.html
1898--- iputils-s20101006.orig/doc/r1144.html 1969-12-31 19:00:00.000000000 -0500
1899+++ iputils-s20101006/doc/r1144.html 2011-01-08 20:09:49.631531431 -0500
[8867e46]1900@@ -0,0 +1,428 @@
1901+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
1902+<HTML
1903+><HEAD
1904+><TITLE
1905+>pg3</TITLE
1906+><META
1907+NAME="GENERATOR"
1908+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
1909+REL="HOME"
1910+TITLE="System Manager's Manual: iputils"
1911+HREF="index.html"><LINK
1912+REL="PREVIOUS"
1913+TITLE="rdisc"
1914+HREF="r1022.html"></HEAD
1915+><BODY
1916+CLASS="REFENTRY"
1917+BGCOLOR="#FFFFFF"
1918+TEXT="#000000"
1919+LINK="#0000FF"
1920+VLINK="#840084"
1921+ALINK="#0000FF"
1922+><DIV
1923+CLASS="NAVHEADER"
1924+><TABLE
1925+SUMMARY="Header navigation table"
1926+WIDTH="100%"
1927+BORDER="0"
1928+CELLPADDING="0"
1929+CELLSPACING="0"
1930+><TR
1931+><TH
1932+COLSPAN="3"
1933+ALIGN="center"
1934+>System Manager's Manual: iputils</TH
1935+></TR
1936+><TR
1937+><TD
1938+WIDTH="10%"
1939+ALIGN="left"
1940+VALIGN="bottom"
1941+><A
1942+HREF="r1022.html"
1943+ACCESSKEY="P"
1944+>Prev</A
1945+></TD
1946+><TD
1947+WIDTH="80%"
1948+ALIGN="center"
1949+VALIGN="bottom"
1950+></TD
1951+><TD
1952+WIDTH="10%"
1953+ALIGN="right"
1954+VALIGN="bottom"
1955+>&nbsp;</TD
1956+></TR
1957+></TABLE
1958+><HR
1959+ALIGN="LEFT"
1960+WIDTH="100%"></DIV
1961+><H1
1962+><A
1963+NAME="PG3"
1964+></A
1965+>pg3</H1
1966+><DIV
1967+CLASS="REFNAMEDIV"
1968+><A
1969+NAME="AEN1149"
1970+></A
1971+><H2
1972+>Name</H2
1973+>pg3, ipg, pgset&nbsp;--&nbsp;send stream of UDP packets</DIV
1974+><DIV
1975+CLASS="REFSYNOPSISDIV"
1976+><A
1977+NAME="AEN1152"
1978+></A
1979+><H2
1980+>Synopsis</H2
1981+><P
1982+><B
1983+CLASS="COMMAND"
1984+>source ipg</B
1985+> </P
1986+><P
1987+><B
1988+CLASS="COMMAND"
1989+>pg</B
1990+> </P
1991+><P
1992+><B
1993+CLASS="COMMAND"
1994+>pgset</B
1995+> {<TT
1996+CLASS="REPLACEABLE"
1997+><I
1998+>COMMAND</I
1999+></TT
2000+>}</P
2001+></DIV
2002+><DIV
2003+CLASS="REFSECT1"
2004+><A
2005+NAME="AEN1161"
2006+></A
2007+><H2
2008+>DESCRIPTION</H2
2009+><P
2010+><B
2011+CLASS="COMMAND"
2012+>ipg</B
2013+> is not a program, it is script which should be sourced
2014+to <B
2015+CLASS="COMMAND"
2016+>bash</B
2017+>. When sourced it loads module <TT
2018+CLASS="FILENAME"
2019+>pg3</TT
2020+> and
2021+exports a few of functions accessible from parent shell. These macros
2022+are <B
2023+CLASS="COMMAND"
2024+>pg</B
2025+> to start packet injection and to get the results of run;
2026+and <B
2027+CLASS="COMMAND"
2028+>pgset</B
2029+> to setup packet generator.</P
2030+><P
2031+><B
2032+CLASS="COMMAND"
2033+>pgset</B
2034+> can send the following commands to module <TT
2035+CLASS="FILENAME"
2036+>pg3</TT
2037+>:</P
2038+></DIV
2039+><DIV
2040+CLASS="REFSECT1"
2041+><A
2042+NAME="AEN1172"
2043+></A
2044+><H2
2045+>COMMAND</H2
2046+><P
2047+></P
2048+><DIV
2049+CLASS="VARIABLELIST"
2050+><DL
2051+><DT
2052+><CODE
2053+CLASS="OPTION"
2054+>odev <TT
2055+CLASS="REPLACEABLE"
2056+><I
2057+>DEVICE</I
2058+></TT
2059+></CODE
2060+></DT
2061+><DD
2062+><P
2063+>Name of Ethernet device to test. See
2064+<A
2065+HREF="r1144.html#PG3.WARNING"
2066+>warning</A
2067+> below.
2068+ </P
2069+></DD
2070+><DT
2071+><CODE
2072+CLASS="OPTION"
2073+>pkt_size <TT
2074+CLASS="REPLACEABLE"
2075+><I
2076+>BYTES</I
2077+></TT
2078+></CODE
2079+></DT
2080+><DD
2081+><P
2082+>Size of packet to generate. The size includes all the headers: UDP, IP,
2083+MAC, but does not account for overhead internal to medium, i.e. FCS
2084+and various paddings.
2085+ </P
2086+></DD
2087+><DT
2088+><CODE
2089+CLASS="OPTION"
2090+>frags <TT
2091+CLASS="REPLACEABLE"
2092+><I
2093+>NUMBER</I
2094+></TT
2095+></CODE
2096+></DT
2097+><DD
2098+><P
2099+>Each packet will contain <TT
2100+CLASS="REPLACEABLE"
2101+><I
2102+>NUMBER</I
2103+></TT
2104+> of fragments.
2105+Maximal amount for linux-2.4 is 6. Far not all the devices support
2106+fragmented buffers.
2107+ </P
2108+></DD
2109+><DT
2110+><CODE
2111+CLASS="OPTION"
2112+>count <TT
2113+CLASS="REPLACEABLE"
2114+><I
2115+>NUMBER</I
2116+></TT
2117+></CODE
2118+></DT
2119+><DD
2120+><P
2121+>Send stream of <TT
2122+CLASS="REPLACEABLE"
2123+><I
2124+>NUMBER</I
2125+></TT
2126+> of packets and stop after this.
2127+ </P
2128+></DD
2129+><DT
2130+><CODE
2131+CLASS="OPTION"
2132+>ipg <TT
2133+CLASS="REPLACEABLE"
2134+><I
2135+>TIME</I
2136+></TT
2137+></CODE
2138+></DT
2139+><DD
2140+><P
2141+>Introduce artificial delay between packets of <TT
2142+CLASS="REPLACEABLE"
2143+><I
2144+>TIME</I
2145+></TT
2146+>
2147+microseconds.
2148+ </P
2149+></DD
2150+><DT
2151+><CODE
2152+CLASS="OPTION"
2153+>dst <TT
2154+CLASS="REPLACEABLE"
2155+><I
2156+>IP_ADDRESS</I
2157+></TT
2158+></CODE
2159+></DT
2160+><DD
2161+><P
2162+>Select IP destination where the stream is sent to.
2163+Beware, never set this address at random. <B
2164+CLASS="COMMAND"
2165+>pg3</B
2166+> is not a toy,
2167+it creates really tough stream. Default value is 0.0.0.0.
2168+ </P
2169+></DD
2170+><DT
2171+><CODE
2172+CLASS="OPTION"
2173+>dst <TT
2174+CLASS="REPLACEABLE"
2175+><I
2176+>MAC_ADDRESS</I
2177+></TT
2178+></CODE
2179+></DT
2180+><DD
2181+><P
2182+>Select MAC destination where the stream is sent to.
2183+Default value is 00:00:00:00:00:00 in hope that this will not be received
2184+by any node on LAN.
2185+ </P
2186+></DD
2187+><DT
2188+><CODE
2189+CLASS="OPTION"
2190+>stop</CODE
2191+></DT
2192+><DD
2193+><P
2194+>Abort packet injection.
2195+ </P
2196+></DD
2197+></DL
2198+></DIV
2199+></DIV
2200+><DIV
2201+CLASS="REFSECT1"
2202+><A
2203+NAME="PG3.WARNING"
2204+></A
2205+><H2
2206+>WARNING</H2
2207+><P
2208+>When output device is set to some random device different
2209+of hardware Ethernet device, <B
2210+CLASS="COMMAND"
2211+>pg3</B
2212+> will crash kernel.</P
2213+><P
2214+>Do not use it on VLAN, ethertap, VTUN and other devices,
2215+which emulate Ethernet not being real Ethernet in fact.</P
2216+></DIV
2217+><DIV
2218+CLASS="REFSECT1"
2219+><A
2220+NAME="AEN1232"
2221+></A
2222+><H2
2223+>AUTHOR</H2
2224+><P
2225+><B
2226+CLASS="COMMAND"
2227+>pg3</B
2228+> was written by <A
2229+HREF="mailto:robert.olsson@its.uu.se"
2230+TARGET="_top"
2231+>Robert Olsson &lt;robert.olsson@its.uu.se&gt;</A
2232+>.</P
2233+></DIV
2234+><DIV
2235+CLASS="REFSECT1"
2236+><A
2237+NAME="AEN1237"
2238+></A
2239+><H2
2240+>SECURITY</H2
2241+><P
2242+>This can be used only by superuser.</P
2243+><P
2244+>This tool creates floods of packets which is unlikely to be handled
2245+even by high-end machines. For example, it saturates gigabit link with
2246+60 byte packets when used with Intel's e1000. In face of such stream
2247+switches, routers and end hosts may deadlock, crash, explode.
2248+Use only in test lab environment.</P
2249+></DIV
2250+><DIV
2251+CLASS="REFSECT1"
2252+><A
2253+NAME="AEN1241"
2254+></A
2255+><H2
2256+>AVAILABILITY</H2
2257+><P
2258+><B
2259+CLASS="COMMAND"
2260+>pg3</B
2261+> is part of <TT
2262+CLASS="FILENAME"
2263+>iputils</TT
2264+> package
2265+and the latest versions are available in source form at
2266+<A
2267+HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2"
2268+TARGET="_top"
2269+>http://www.skbuff.net/iputils/iputils-current.tar.bz2</A
2270+>.</P
2271+></DIV
2272+><DIV
2273+CLASS="NAVFOOTER"
2274+><HR
2275+ALIGN="LEFT"
2276+WIDTH="100%"><TABLE
2277+SUMMARY="Footer navigation table"
2278+WIDTH="100%"
2279+BORDER="0"
2280+CELLPADDING="0"
2281+CELLSPACING="0"
2282+><TR
2283+><TD
2284+WIDTH="33%"
2285+ALIGN="left"
2286+VALIGN="top"
2287+><A
2288+HREF="r1022.html"
2289+ACCESSKEY="P"
2290+>Prev</A
2291+></TD
2292+><TD
2293+WIDTH="34%"
2294+ALIGN="center"
2295+VALIGN="top"
2296+><A
2297+HREF="index.html"
2298+ACCESSKEY="H"
2299+>Home</A
2300+></TD
2301+><TD
2302+WIDTH="33%"
2303+ALIGN="right"
2304+VALIGN="top"
2305+>&nbsp;</TD
2306+></TR
2307+><TR
2308+><TD
2309+WIDTH="33%"
2310+ALIGN="left"
2311+VALIGN="top"
2312+>rdisc</TD
2313+><TD
2314+WIDTH="34%"
2315+ALIGN="center"
2316+VALIGN="top"
2317+>&nbsp;</TD
2318+><TD
2319+WIDTH="33%"
2320+ALIGN="right"
2321+VALIGN="top"
2322+>&nbsp;</TD
2323+></TR
2324+></TABLE
2325+></DIV
2326+></BODY
2327+></HTML
2328+>
2329\ No newline at end of file
[ecc1136]2330diff -Naur iputils-s20101006.orig/doc/r3.html iputils-s20101006/doc/r3.html
2331--- iputils-s20101006.orig/doc/r3.html 1969-12-31 19:00:00.000000000 -0500
2332+++ iputils-s20101006/doc/r3.html 2011-01-08 20:09:49.558814956 -0500
[8867e46]2333@@ -0,0 +1,1494 @@
2334+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2335+<HTML
2336+><HEAD
2337+><TITLE
2338+>ping</TITLE
2339+><META
2340+NAME="GENERATOR"
2341+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
2342+REL="HOME"
2343+TITLE="System Manager's Manual: iputils"
2344+HREF="index.html"><LINK
2345+REL="PREVIOUS"
2346+TITLE="System Manager's Manual: iputils"
2347+HREF="index.html"><LINK
2348+REL="NEXT"
2349+TITLE="arping"
2350+HREF="r437.html"></HEAD
2351+><BODY
2352+CLASS="REFENTRY"
2353+BGCOLOR="#FFFFFF"
2354+TEXT="#000000"
2355+LINK="#0000FF"
2356+VLINK="#840084"
2357+ALINK="#0000FF"
2358+><DIV
2359+CLASS="NAVHEADER"
2360+><TABLE
2361+SUMMARY="Header navigation table"
2362+WIDTH="100%"
2363+BORDER="0"
2364+CELLPADDING="0"
2365+CELLSPACING="0"
2366+><TR
2367+><TH
2368+COLSPAN="3"
2369+ALIGN="center"
2370+>System Manager's Manual: iputils</TH
2371+></TR
2372+><TR
2373+><TD
2374+WIDTH="10%"
2375+ALIGN="left"
2376+VALIGN="bottom"
2377+><A
2378+HREF="index.html"
2379+ACCESSKEY="P"
2380+>Prev</A
2381+></TD
2382+><TD
2383+WIDTH="80%"
2384+ALIGN="center"
2385+VALIGN="bottom"
2386+></TD
2387+><TD
2388+WIDTH="10%"
2389+ALIGN="right"
2390+VALIGN="bottom"
2391+><A
2392+HREF="r437.html"
2393+ACCESSKEY="N"
2394+>Next</A
2395+></TD
2396+></TR
2397+></TABLE
2398+><HR
2399+ALIGN="LEFT"
2400+WIDTH="100%"></DIV
2401+><H1
2402+><A
2403+NAME="PING"
2404+></A
2405+>ping</H1
2406+><DIV
2407+CLASS="REFNAMEDIV"
2408+><A
2409+NAME="AEN8"
2410+></A
2411+><H2
2412+>Name</H2
2413+>ping, ping6&nbsp;--&nbsp;send ICMP ECHO_REQUEST to network hosts</DIV
2414+><DIV
2415+CLASS="REFSYNOPSISDIV"
2416+><A
2417+NAME="AEN11"
2418+></A
2419+><H2
2420+>Synopsis</H2
2421+><P
2422+><B
2423+CLASS="COMMAND"
2424+>ping</B
2425+> [<CODE
2426+CLASS="OPTION"
2427+>-LRUbdfnqrvVaAB</CODE
2428+>] [-c <TT
2429+CLASS="REPLACEABLE"
2430+><I
2431+>count</I
2432+></TT
2433+>] [-m <TT
2434+CLASS="REPLACEABLE"
2435+><I
2436+>mark</I
2437+></TT
2438+>] [-i <TT
2439+CLASS="REPLACEABLE"
2440+><I
2441+>interval</I
2442+></TT
2443+>] [-l <TT
2444+CLASS="REPLACEABLE"
2445+><I
2446+>preload</I
2447+></TT
2448+>] [-p <TT
2449+CLASS="REPLACEABLE"
2450+><I
2451+>pattern</I
2452+></TT
2453+>] [-s <TT
2454+CLASS="REPLACEABLE"
2455+><I
2456+>packetsize</I
2457+></TT
2458+>] [-t <TT
2459+CLASS="REPLACEABLE"
2460+><I
2461+>ttl</I
2462+></TT
2463+>] [-w <TT
2464+CLASS="REPLACEABLE"
2465+><I
2466+>deadline</I
2467+></TT
2468+>] [-F <TT
2469+CLASS="REPLACEABLE"
2470+><I
2471+>flowlabel</I
2472+></TT
2473+>] [-I <TT
2474+CLASS="REPLACEABLE"
2475+><I
2476+>interface</I
2477+></TT
2478+>] [-M <TT
2479+CLASS="REPLACEABLE"
2480+><I
2481+>hint</I
2482+></TT
2483+>] [-N <TT
2484+CLASS="REPLACEABLE"
2485+><I
2486+>nioption</I
2487+></TT
2488+>] [-Q <TT
2489+CLASS="REPLACEABLE"
2490+><I
2491+>tos</I
2492+></TT
2493+>] [-S <TT
2494+CLASS="REPLACEABLE"
2495+><I
2496+>sndbuf</I
2497+></TT
2498+>] [-T <TT
2499+CLASS="REPLACEABLE"
2500+><I
2501+>timestamp option</I
2502+></TT
2503+>] [-W <TT
2504+CLASS="REPLACEABLE"
2505+><I
2506+>timeout</I
2507+></TT
2508+>] [<TT
2509+CLASS="REPLACEABLE"
2510+><I
2511+>hop</I
2512+></TT
2513+>...] {<TT
2514+CLASS="REPLACEABLE"
2515+><I
2516+>destination</I
2517+></TT
2518+>}</P
2519+></DIV
2520+><DIV
2521+CLASS="REFSECT1"
2522+><A
2523+NAME="AEN52"
2524+></A
2525+><H2
2526+>DESCRIPTION</H2
2527+><P
2528+><B
2529+CLASS="COMMAND"
2530+>ping</B
2531+> uses the ICMP protocol's mandatory ECHO_REQUEST
2532+datagram to elicit an ICMP ECHO_RESPONSE from a host or gateway.
2533+ECHO_REQUEST datagrams (``pings'') have an IP and ICMP
2534+header, followed by a <CODE
2535+CLASS="STRUCTNAME"
2536+>struct timeval</CODE
2537+> and then an arbitrary
2538+number of ``pad'' bytes used to fill out the packet.</P
2539+><P
2540+><B
2541+CLASS="COMMAND"
2542+>ping6</B
2543+> can also send Node Information Queries (RFC4620).</P
2544+></DIV
2545+><DIV
2546+CLASS="REFSECT1"
2547+><A
2548+NAME="AEN59"
2549+></A
2550+><H2
2551+>OPTIONS</H2
2552+><P
2553+></P
2554+><DIV
2555+CLASS="VARIABLELIST"
2556+><DL
2557+><DT
2558+><CODE
2559+CLASS="OPTION"
2560+>-a</CODE
2561+></DT
2562+><DD
2563+><P
2564+>Audible ping.
2565+ </P
2566+></DD
2567+><DT
2568+><CODE
2569+CLASS="OPTION"
2570+>-A</CODE
2571+></DT
2572+><DD
2573+><P
2574+>Adaptive ping. Interpacket interval adapts to round-trip time, so that
2575+effectively not more than one (or more, if preload is set) unanswered probes
2576+present in the network. Minimal interval is 200msec for not super-user.
2577+On networks with low rtt this mode is essentially equivalent to flood mode.
2578+ </P
2579+></DD
2580+><DT
2581+><CODE
2582+CLASS="OPTION"
2583+>-b</CODE
2584+></DT
2585+><DD
2586+><P
2587+>Allow pinging a broadcast address.
2588+ </P
2589+></DD
2590+><DT
2591+><CODE
2592+CLASS="OPTION"
2593+>-B</CODE
2594+></DT
2595+><DD
2596+><P
2597+>Do not allow <B
2598+CLASS="COMMAND"
2599+>ping</B
2600+> to change source address of probes.
2601+The address is bound to one selected when <B
2602+CLASS="COMMAND"
2603+>ping</B
2604+> starts.
2605+ </P
2606+></DD
2607+><DT
2608+><CODE
2609+CLASS="OPTION"
2610+>-m <TT
2611+CLASS="REPLACEABLE"
2612+><I
2613+>mark</I
2614+></TT
2615+></CODE
2616+></DT
2617+><DD
2618+><P
2619+>use <TT
2620+CLASS="REPLACEABLE"
2621+><I
2622+>mark</I
2623+></TT
2624+> to tag the packets going out. This is useful
2625+for variety of reasons within the kernel such as using policy
2626+routing to select specific outbound processing.
2627+ </P
2628+></DD
2629+><DT
2630+><CODE
2631+CLASS="OPTION"
2632+><A
2633+NAME="PING.COUNT"
2634+></A
2635+>-c <TT
2636+CLASS="REPLACEABLE"
2637+><I
2638+>count</I
2639+></TT
2640+></CODE
2641+></DT
2642+><DD
2643+><P
2644+>Stop after sending <TT
2645+CLASS="REPLACEABLE"
2646+><I
2647+>count</I
2648+></TT
2649+> ECHO_REQUEST
2650+packets. With
2651+<A
2652+HREF="r3.html#PING.DEADLINE"
2653+><TT
2654+CLASS="REPLACEABLE"
2655+><I
2656+>deadline</I
2657+></TT
2658+></A
2659+>
2660+option, <B
2661+CLASS="COMMAND"
2662+>ping</B
2663+> waits for
2664+<TT
2665+CLASS="REPLACEABLE"
2666+><I
2667+>count</I
2668+></TT
2669+> ECHO_REPLY packets, until the timeout expires.
2670+ </P
2671+></DD
2672+><DT
2673+><CODE
2674+CLASS="OPTION"
2675+>-d</CODE
2676+></DT
2677+><DD
2678+><P
2679+>Set the <CODE
2680+CLASS="CONSTANT"
2681+>SO_DEBUG</CODE
2682+> option on the socket being used.
2683+Essentially, this socket option is not used by Linux kernel.
2684+ </P
2685+></DD
2686+><DT
2687+><CODE
2688+CLASS="OPTION"
2689+>-F <TT
2690+CLASS="REPLACEABLE"
2691+><I
2692+>flow label</I
2693+></TT
2694+></CODE
2695+></DT
2696+><DD
2697+><P
2698+>Allocate and set 20 bit flow label on echo request packets.
2699+(Only <B
2700+CLASS="COMMAND"
2701+>ping6</B
2702+>). If value is zero, kernel allocates random flow label.
2703+ </P
2704+></DD
2705+><DT
2706+><CODE
2707+CLASS="OPTION"
2708+>-f</CODE
2709+></DT
2710+><DD
2711+><P
2712+>Flood ping. For every ECHO_REQUEST sent a period ``.'' is printed,
2713+while for ever ECHO_REPLY received a backspace is printed.
2714+This provides a rapid display of how many packets are being dropped.
2715+If interval is not given, it sets interval to zero and
2716+outputs packets as fast as they come back or one hundred times per second,
2717+whichever is more.
2718+Only the super-user may use this option with zero interval.
2719+ </P
2720+></DD
2721+><DT
2722+><CODE
2723+CLASS="OPTION"
2724+>-i <TT
2725+CLASS="REPLACEABLE"
2726+><I
2727+>interval</I
2728+></TT
2729+></CODE
2730+></DT
2731+><DD
2732+><P
2733+>Wait <TT
2734+CLASS="REPLACEABLE"
2735+><I
2736+>interval</I
2737+></TT
2738+> seconds between sending each packet.
2739+The default is to wait for one second between each packet normally,
2740+or not to wait in flood mode. Only super-user may set interval
2741+to values less 0.2 seconds.
2742+ </P
2743+></DD
2744+><DT
2745+><CODE
2746+CLASS="OPTION"
2747+>-I <TT
2748+CLASS="REPLACEABLE"
2749+><I
2750+>interface address</I
2751+></TT
2752+></CODE
2753+></DT
2754+><DD
2755+><P
2756+>Set source address to specified interface address. Argument
2757+may be numeric IP address or name of device. When pinging IPv6
2758+link-local address this option is required.
2759+ </P
2760+></DD
2761+><DT
2762+><CODE
2763+CLASS="OPTION"
2764+>-l <TT
2765+CLASS="REPLACEABLE"
2766+><I
2767+>preload</I
2768+></TT
2769+></CODE
2770+></DT
2771+><DD
2772+><P
2773+>If <TT
2774+CLASS="REPLACEABLE"
2775+><I
2776+>preload</I
2777+></TT
2778+> is specified,
2779+<B
2780+CLASS="COMMAND"
2781+>ping</B
2782+> sends that many packets not waiting for reply.
2783+Only the super-user may select preload more than 3.
2784+ </P
2785+></DD
2786+><DT
2787+><CODE
2788+CLASS="OPTION"
2789+>-L</CODE
2790+></DT
2791+><DD
2792+><P
2793+>Suppress loopback of multicast packets. This flag only applies if the ping
2794+destination is a multicast address.
2795+ </P
2796+></DD
2797+><DT
2798+><CODE
2799+CLASS="OPTION"
2800+>-N <TT
2801+CLASS="REPLACEABLE"
2802+><I
2803+>nioption</I
2804+></TT
2805+></CODE
2806+></DT
2807+><DD
2808+><P
2809+>Send ICMPv6 Node Information Queries (RFC4620), instead of Echo Request.
2810+ <P
2811+></P
2812+><DIV
2813+CLASS="VARIABLELIST"
2814+><DL
2815+><DT
2816+><CODE
2817+CLASS="OPTION"
2818+>name</CODE
2819+></DT
2820+><DD
2821+><P
2822+>Queries for Node Names.</P
2823+></DD
2824+></DL
2825+></DIV
2826+>
2827+ <P
2828+></P
2829+><DIV
2830+CLASS="VARIABLELIST"
2831+><DL
2832+><DT
2833+><CODE
2834+CLASS="OPTION"
2835+>ipv6</CODE
2836+></DT
2837+><DD
2838+><P
2839+>Queries for IPv6 Addresses. There are several IPv6 specific flags.
2840+ <P
2841+></P
2842+><DIV
2843+CLASS="VARIABLELIST"
2844+><DL
2845+><DT
2846+><CODE
2847+CLASS="OPTION"
2848+>ipv6-global</CODE
2849+></DT
2850+><DD
2851+><P
2852+>Request IPv6 global-scope addresses.</P
2853+></DD
2854+></DL
2855+></DIV
2856+>
2857+ <P
2858+></P
2859+><DIV
2860+CLASS="VARIABLELIST"
2861+><DL
2862+><DT
2863+><CODE
2864+CLASS="OPTION"
2865+>ipv6-sitelocal</CODE
2866+></DT
2867+><DD
2868+><P
2869+>Request IPv6 site-local addresses.</P
2870+></DD
2871+></DL
2872+></DIV
2873+>
2874+ <P
2875+></P
2876+><DIV
2877+CLASS="VARIABLELIST"
2878+><DL
2879+><DT
2880+><CODE
2881+CLASS="OPTION"
2882+>ipv6-linklocal</CODE
2883+></DT
2884+><DD
2885+><P
2886+>Request IPv6 link-local addresses.</P
2887+></DD
2888+></DL
2889+></DIV
2890+>
2891+ <P
2892+></P
2893+><DIV
2894+CLASS="VARIABLELIST"
2895+><DL
2896+><DT
2897+><CODE
2898+CLASS="OPTION"
2899+>ipv6-all</CODE
2900+></DT
2901+><DD
2902+><P
2903+>Request IPv6 addresses on other interfaces.</P
2904+></DD
2905+></DL
2906+></DIV
2907+>
2908+ </P
2909+></DD
2910+></DL
2911+></DIV
2912+>
2913+ <P
2914+></P
2915+><DIV
2916+CLASS="VARIABLELIST"
2917+><DL
2918+><DT
2919+><CODE
2920+CLASS="OPTION"
2921+>ipv4</CODE
2922+></DT
2923+><DD
2924+><P
2925+>Queries for IPv4 Addresses. There is one IPv4 specific flag.
2926+ <P
2927+></P
2928+><DIV
2929+CLASS="VARIABLELIST"
2930+><DL
2931+><DT
2932+><CODE
2933+CLASS="OPTION"
2934+>ipv4-all</CODE
2935+></DT
2936+><DD
2937+><P
2938+>Request IPv4 addresses on other interfaces.</P
2939+></DD
2940+></DL
2941+></DIV
2942+>
2943+ </P
2944+></DD
2945+></DL
2946+></DIV
2947+>
2948+ <P
2949+></P
2950+><DIV
2951+CLASS="VARIABLELIST"
2952+><DL
2953+><DT
2954+><CODE
2955+CLASS="OPTION"
2956+>subject-ipv6=<TT
2957+CLASS="REPLACEABLE"
2958+><I
2959+>ipv6addr</I
2960+></TT
2961+></CODE
2962+></DT
2963+><DD
2964+><P
2965+>IPv6 subject address.</P
2966+></DD
2967+></DL
2968+></DIV
2969+>
2970+ <P
2971+></P
2972+><DIV
2973+CLASS="VARIABLELIST"
2974+><DL
2975+><DT
2976+><CODE
2977+CLASS="OPTION"
2978+>subject-ipv4=<TT
2979+CLASS="REPLACEABLE"
2980+><I
2981+>ipv4addr</I
2982+></TT
2983+></CODE
2984+></DT
2985+><DD
2986+><P
2987+>IPv4 subject address.</P
2988+></DD
2989+></DL
2990+></DIV
2991+>
2992+ <P
2993+></P
2994+><DIV
2995+CLASS="VARIABLELIST"
2996+><DL
2997+><DT
2998+><CODE
2999+CLASS="OPTION"
3000+>subject-name=<TT
3001+CLASS="REPLACEABLE"
3002+><I
3003+>nodename</I
3004+></TT
3005+></CODE
3006+></DT
3007+><DD
3008+><P
3009+>Subject name. If it contains more than one dot,
3010+ fully-qualified domain name is assumed.</P
3011+></DD
3012+></DL
3013+></DIV
3014+>
3015+ <P
3016+></P
3017+><DIV
3018+CLASS="VARIABLELIST"
3019+><DL
3020+><DT
3021+><CODE
3022+CLASS="OPTION"
3023+>subject-fqdn=<TT
3024+CLASS="REPLACEABLE"
3025+><I
3026+>nodename</I
3027+></TT
3028+></CODE
3029+></DT
3030+><DD
3031+><P
3032+>Subject name. Fully-qualified domain name is
3033+ always assumed.</P
3034+></DD
3035+></DL
3036+></DIV
3037+>
3038+ </P
3039+></DD
3040+><DT
3041+><CODE
3042+CLASS="OPTION"
3043+>-n</CODE
3044+></DT
3045+><DD
3046+><P
3047+>Numeric output only.
3048+No attempt will be made to lookup symbolic names for host addresses.
3049+ </P
3050+></DD
3051+><DT
3052+><CODE
3053+CLASS="OPTION"
3054+>-p <TT
3055+CLASS="REPLACEABLE"
3056+><I
3057+>pattern</I
3058+></TT
3059+></CODE
3060+></DT
3061+><DD
3062+><P
3063+>You may specify up to 16 ``pad'' bytes to fill out the packet you send.
3064+This is useful for diagnosing data-dependent problems in a network.
3065+For example, <CODE
3066+CLASS="OPTION"
3067+>-p ff</CODE
3068+> will cause the sent packet
3069+to be filled with all ones.
3070+ </P
3071+></DD
3072+><DT
3073+><CODE
3074+CLASS="OPTION"
3075+>-D</CODE
3076+></DT
3077+><DD
3078+><P
3079+>Print timestamp (unix time + microseconds as in gettimeofday) before
3080+each line.
3081+ </P
3082+></DD
3083+><DT
3084+><CODE
3085+CLASS="OPTION"
3086+>-Q <TT
3087+CLASS="REPLACEABLE"
3088+><I
3089+>tos</I
3090+></TT
3091+></CODE
3092+></DT
3093+><DD
3094+><P
3095+>Set Quality of Service -related bits in ICMP datagrams.
3096+<TT
3097+CLASS="REPLACEABLE"
3098+><I
3099+>tos</I
3100+></TT
3101+> can be either decimal or hex number.
3102+Traditionally (RFC1349), these have been interpreted as: 0 for reserved
3103+(currently being redefined as congestion control), 1-4 for Type of Service
3104+and 5-7 for Precedence.
3105+Possible settings for Type of Service are: minimal cost: 0x02,
3106+reliability: 0x04, throughput: 0x08, low delay: 0x10. Multiple TOS bits
3107+should not be set simultaneously. Possible settings for
3108+special Precedence range from priority (0x20) to net control (0xe0). You
3109+must be root (<CODE
3110+CLASS="CONSTANT"
3111+>CAP_NET_ADMIN</CODE
3112+> capability) to use Critical or
3113+higher precedence value. You cannot set
3114+bit 0x01 (reserved) unless ECN has been enabled in the kernel.
3115+In RFC2474, these fields has been redefined as 8-bit Differentiated
3116+Services (DS), consisting of: bits 0-1 of separate data (ECN will be used,
3117+here), and bits 2-7 of Differentiated Services Codepoint (DSCP).
3118+ </P
3119+></DD
3120+><DT
3121+><CODE
3122+CLASS="OPTION"
3123+>-q</CODE
3124+></DT
3125+><DD
3126+><P
3127+>Quiet output.
3128+Nothing is displayed except the summary lines at startup time and
3129+when finished.
3130+ </P
3131+></DD
3132+><DT
3133+><CODE
3134+CLASS="OPTION"
3135+>-R</CODE
3136+></DT
3137+><DD
3138+><P
3139+>Record route.
3140+Includes the RECORD_ROUTE option in the ECHO_REQUEST
3141+packet and displays the route buffer on returned packets.
3142+Note that the IP header is only large enough for nine such routes.
3143+Many hosts ignore or discard this option.
3144+ </P
3145+></DD
3146+><DT
3147+><CODE
3148+CLASS="OPTION"
3149+>-r</CODE
3150+></DT
3151+><DD
3152+><P
3153+>Bypass the normal routing tables and send directly to a host on an attached
3154+interface.
3155+If the host is not on a directly-attached network, an error is returned.
3156+This option can be used to ping a local host through an interface
3157+that has no route through it provided the option <CODE
3158+CLASS="OPTION"
3159+>-I</CODE
3160+> is also
3161+used.
3162+ </P
3163+></DD
3164+><DT
3165+><CODE
3166+CLASS="OPTION"
3167+>-s <TT
3168+CLASS="REPLACEABLE"
3169+><I
3170+>packetsize</I
3171+></TT
3172+></CODE
3173+></DT
3174+><DD
3175+><P
3176+>Specifies the number of data bytes to be sent.
3177+The default is 56, which translates into 64 ICMP
3178+data bytes when combined with the 8 bytes of ICMP header data.
3179+ </P
3180+></DD
3181+><DT
3182+><CODE
3183+CLASS="OPTION"
3184+>-S <TT
3185+CLASS="REPLACEABLE"
3186+><I
3187+>sndbuf</I
3188+></TT
3189+></CODE
3190+></DT
3191+><DD
3192+><P
3193+>Set socket sndbuf. If not specified, it is selected to buffer
3194+not more than one packet.
3195+ </P
3196+></DD
3197+><DT
3198+><CODE
3199+CLASS="OPTION"
3200+>-t <TT
3201+CLASS="REPLACEABLE"
3202+><I
3203+>ttl</I
3204+></TT
3205+></CODE
3206+></DT
3207+><DD
3208+><P
3209+>Set the IP Time to Live.
3210+ </P
3211+></DD
3212+><DT
3213+><CODE
3214+CLASS="OPTION"
3215+>-T <TT
3216+CLASS="REPLACEABLE"
3217+><I
3218+>timestamp option</I
3219+></TT
3220+></CODE
3221+></DT
3222+><DD
3223+><P
3224+>Set special IP timestamp options.
3225+<TT
3226+CLASS="REPLACEABLE"
3227+><I
3228+>timestamp option</I
3229+></TT
3230+> may be either
3231+<TT
3232+CLASS="REPLACEABLE"
3233+><I
3234+>tsonly</I
3235+></TT
3236+> (only timestamps),
3237+<TT
3238+CLASS="REPLACEABLE"
3239+><I
3240+>tsandaddr</I
3241+></TT
3242+> (timestamps and addresses) or
3243+<TT
3244+CLASS="REPLACEABLE"
3245+><I
3246+>tsprespec host1 [host2 [host3 [host4]]]</I
3247+></TT
3248+>
3249+(timestamp prespecified hops).
3250+ </P
3251+></DD
3252+><DT
3253+><CODE
3254+CLASS="OPTION"
3255+>-M <TT
3256+CLASS="REPLACEABLE"
3257+><I
3258+>hint</I
3259+></TT
3260+></CODE
3261+></DT
3262+><DD
3263+><P
3264+>Select Path MTU Discovery strategy.
3265+<TT
3266+CLASS="REPLACEABLE"
3267+><I
3268+>hint</I
3269+></TT
3270+> may be either <TT
3271+CLASS="REPLACEABLE"
3272+><I
3273+>do</I
3274+></TT
3275+>
3276+(prohibit fragmentation, even local one),
3277+<TT
3278+CLASS="REPLACEABLE"
3279+><I
3280+>want</I
3281+></TT
3282+> (do PMTU discovery, fragment locally when packet size
3283+is large), or <TT
3284+CLASS="REPLACEABLE"
3285+><I
3286+>dont</I
3287+></TT
3288+> (do not set DF flag).
3289+ </P
3290+></DD
3291+><DT
3292+><CODE
3293+CLASS="OPTION"
3294+>-U</CODE
3295+></DT
3296+><DD
3297+><P
3298+>Print full user-to-user latency (the old behaviour). Normally
3299+<B
3300+CLASS="COMMAND"
3301+>ping</B
3302+>
3303+prints network round trip time, which can be different
3304+f.e. due to DNS failures.
3305+ </P
3306+></DD
3307+><DT
3308+><CODE
3309+CLASS="OPTION"
3310+>-v</CODE
3311+></DT
3312+><DD
3313+><P
3314+>Verbose output.
3315+ </P
3316+></DD
3317+><DT
3318+><CODE
3319+CLASS="OPTION"
3320+>-V</CODE
3321+></DT
3322+><DD
3323+><P
3324+>Show version and exit.
3325+ </P
3326+></DD
3327+><DT
3328+><CODE
3329+CLASS="OPTION"
3330+><A
3331+NAME="PING.DEADLINE"
3332+></A
3333+>-w <TT
3334+CLASS="REPLACEABLE"
3335+><I
3336+>deadline</I
3337+></TT
3338+></CODE
3339+></DT
3340+><DD
3341+><P
3342+>Specify a timeout, in seconds, before
3343+<B
3344+CLASS="COMMAND"
3345+>ping</B
3346+>
3347+exits regardless of how many
3348+packets have been sent or received. In this case
3349+<B
3350+CLASS="COMMAND"
3351+>ping</B
3352+>
3353+does not stop after
3354+<A
3355+HREF="r3.html#PING.COUNT"
3356+><TT
3357+CLASS="REPLACEABLE"
3358+><I
3359+>count</I
3360+></TT
3361+></A
3362+>
3363+packet are sent, it waits either for
3364+<A
3365+HREF="r3.html#PING.DEADLINE"
3366+><TT
3367+CLASS="REPLACEABLE"
3368+><I
3369+>deadline</I
3370+></TT
3371+></A
3372+>
3373+expire or until
3374+<A
3375+HREF="r3.html#PING.COUNT"
3376+><TT
3377+CLASS="REPLACEABLE"
3378+><I
3379+>count</I
3380+></TT
3381+></A
3382+>
3383+probes are answered or for some error notification from network.
3384+ </P
3385+></DD
3386+><DT
3387+><CODE
3388+CLASS="OPTION"
3389+>-W <TT
3390+CLASS="REPLACEABLE"
3391+><I
3392+>timeout</I
3393+></TT
3394+></CODE
3395+></DT
3396+><DD
3397+><P
3398+>Time to wait for a response, in seconds. The option affects only timeout
3399+in absense of any responses, otherwise <B
3400+CLASS="COMMAND"
3401+>ping</B
3402+> waits for two RTTs.
3403+ </P
3404+></DD
3405+></DL
3406+></DIV
3407+><P
3408+>When using <B
3409+CLASS="COMMAND"
3410+>ping</B
3411+> for fault isolation, it should first be run
3412+on the local host, to verify that the local network interface is up
3413+and running. Then, hosts and gateways further and further away should be
3414+``pinged''. Round-trip times and packet loss statistics are computed.
3415+If duplicate packets are received, they are not included in the packet
3416+loss calculation, although the round trip time of these packets is used
3417+in calculating the minimum/average/maximum round-trip time numbers.
3418+When the specified number of packets have been sent (and received) or
3419+if the program is terminated with a
3420+<CODE
3421+CLASS="CONSTANT"
3422+>SIGINT</CODE
3423+>, a brief summary is displayed. Shorter current statistics
3424+can be obtained without termination of process with signal
3425+<CODE
3426+CLASS="CONSTANT"
3427+>SIGQUIT</CODE
3428+>.</P
3429+><P
3430+>If <B
3431+CLASS="COMMAND"
3432+>ping</B
3433+> does not receive any reply packets at all it will
3434+exit with code 1. If a packet
3435+<A
3436+HREF="r3.html#PING.COUNT"
3437+><TT
3438+CLASS="REPLACEABLE"
3439+><I
3440+>count</I
3441+></TT
3442+></A
3443+>
3444+and
3445+<A
3446+HREF="r3.html#PING.DEADLINE"
3447+><TT
3448+CLASS="REPLACEABLE"
3449+><I
3450+>deadline</I
3451+></TT
3452+></A
3453+>
3454+are both specified, and fewer than
3455+<A
3456+HREF="r3.html#PING.COUNT"
3457+><TT
3458+CLASS="REPLACEABLE"
3459+><I
3460+>count</I
3461+></TT
3462+></A
3463+>
3464+packets are received by the time the
3465+<A
3466+HREF="r3.html#PING.DEADLINE"
3467+><TT
3468+CLASS="REPLACEABLE"
3469+><I
3470+>deadline</I
3471+></TT
3472+></A
3473+>
3474+has arrived, it will also exit with code 1.
3475+On other error it exits with code 2. Otherwise it exits with code 0. This
3476+makes it possible to use the exit code to see if a host is alive or
3477+not.</P
3478+><P
3479+>This program is intended for use in network testing, measurement and
3480+management.
3481+Because of the load it can impose on the network, it is unwise to use
3482+<B
3483+CLASS="COMMAND"
3484+>ping</B
3485+> during normal operations or from automated scripts.</P
3486+></DIV
3487+><DIV
3488+CLASS="REFSECT1"
3489+><A
3490+NAME="AEN362"
3491+></A
3492+><H2
3493+>ICMP PACKET DETAILS</H2
3494+><P
3495+>An IP header without options is 20 bytes.
3496+An ICMP ECHO_REQUEST packet contains an additional 8 bytes worth
3497+of ICMP header followed by an arbitrary amount of data.
3498+When a <TT
3499+CLASS="REPLACEABLE"
3500+><I
3501+>packetsize</I
3502+></TT
3503+> is given, this indicated the size of this
3504+extra piece of data (the default is 56). Thus the amount of data received
3505+inside of an IP packet of type ICMP ECHO_REPLY will always be 8 bytes
3506+more than the requested data space (the ICMP header).</P
3507+><P
3508+>If the data space is at least of size of <CODE
3509+CLASS="STRUCTNAME"
3510+>struct timeval</CODE
3511+>
3512+<B
3513+CLASS="COMMAND"
3514+>ping</B
3515+> uses the beginning bytes of this space to include
3516+a timestamp which it uses in the computation of round trip times.
3517+If the data space is shorter, no round trip times are given.</P
3518+></DIV
3519+><DIV
3520+CLASS="REFSECT1"
3521+><A
3522+NAME="AEN369"
3523+></A
3524+><H2
3525+>DUPLICATE AND DAMAGED PACKETS</H2
3526+><P
3527+><B
3528+CLASS="COMMAND"
3529+>ping</B
3530+> will report duplicate and damaged packets.
3531+Duplicate packets should never occur, and seem to be caused by
3532+inappropriate link-level retransmissions.
3533+Duplicates may occur in many situations and are rarely (if ever) a
3534+good sign, although the presence of low levels of duplicates may not
3535+always be cause for alarm.</P
3536+><P
3537+>Damaged packets are obviously serious cause for alarm and often
3538+indicate broken hardware somewhere in the
3539+<B
3540+CLASS="COMMAND"
3541+>ping</B
3542+> packet's path (in the network or in the hosts).</P
3543+></DIV
3544+><DIV
3545+CLASS="REFSECT1"
3546+><A
3547+NAME="AEN375"
3548+></A
3549+><H2
3550+>TRYING DIFFERENT DATA PATTERNS</H2
3551+><P
3552+>The (inter)network layer should never treat packets differently depending
3553+on the data contained in the data portion.
3554+Unfortunately, data-dependent problems have been known to sneak into
3555+networks and remain undetected for long periods of time.
3556+In many cases the particular pattern that will have problems is something
3557+that doesn't have sufficient ``transitions'', such as all ones or all
3558+zeros, or a pattern right at the edge, such as almost all zeros.
3559+It isn't necessarily enough to specify a data pattern of all zeros (for
3560+example) on the command line because the pattern that is of interest is
3561+at the data link level, and the relationship between what you type and
3562+what the controllers transmit can be complicated.</P
3563+><P
3564+>This means that if you have a data-dependent problem you will probably
3565+have to do a lot of testing to find it.
3566+If you are lucky, you may manage to find a file that either can't be sent
3567+across your network or that takes much longer to transfer than other
3568+similar length files.
3569+You can then examine this file for repeated patterns that you can test
3570+using the <CODE
3571+CLASS="OPTION"
3572+>-p</CODE
3573+> option of <B
3574+CLASS="COMMAND"
3575+>ping</B
3576+>.</P
3577+></DIV
3578+><DIV
3579+CLASS="REFSECT1"
3580+><A
3581+NAME="AEN381"
3582+></A
3583+><H2
3584+>TTL DETAILS</H2
3585+><P
3586+>The TTL value of an IP packet represents the maximum number of IP routers
3587+that the packet can go through before being thrown away.
3588+In current practice you can expect each router in the Internet to decrement
3589+the TTL field by exactly one.</P
3590+><P
3591+>The TCP/IP specification states that the TTL field for TCP
3592+packets should be set to 60, but many systems use smaller values
3593+(4.3 BSD uses 30, 4.2 used 15).</P
3594+><P
3595+>The maximum possible value of this field is 255, and most Unix systems set
3596+the TTL field of ICMP ECHO_REQUEST packets to 255.
3597+This is why you will find you can ``ping'' some hosts, but not reach them
3598+with
3599+<SPAN
3600+CLASS="CITEREFENTRY"
3601+><SPAN
3602+CLASS="REFENTRYTITLE"
3603+>telnet</SPAN
3604+>(1)</SPAN
3605+>
3606+or
3607+<SPAN
3608+CLASS="CITEREFENTRY"
3609+><SPAN
3610+CLASS="REFENTRYTITLE"
3611+>ftp</SPAN
3612+>(1)</SPAN
3613+>.</P
3614+><P
3615+>In normal operation ping prints the ttl value from the packet it receives.
3616+When a remote system receives a ping packet, it can do one of three things
3617+with the TTL field in its response:</P
3618+><P
3619+></P
3620+><UL
3621+><LI
3622+><P
3623+>Not change it; this is what Berkeley Unix systems did before the
3624+4.3BSD Tahoe release. In this case the TTL value in the received packet
3625+will be 255 minus the number of routers in the round-trip path.
3626+ </P
3627+></LI
3628+><LI
3629+><P
3630+>Set it to 255; this is what current Berkeley Unix systems do.
3631+In this case the TTL value in the received packet will be 255 minus the
3632+number of routers in the path <SPAN
3633+CLASS="emphasis"
3634+><I
3635+CLASS="EMPHASIS"
3636+>from</I
3637+></SPAN
3638+>
3639+the remote system <SPAN
3640+CLASS="emphasis"
3641+><I
3642+CLASS="EMPHASIS"
3643+>to</I
3644+></SPAN
3645+> the <B
3646+CLASS="COMMAND"
3647+>ping</B
3648+>ing host.
3649+ </P
3650+></LI
3651+><LI
3652+><P
3653+>Set it to some other value. Some machines use the same value for
3654+ICMP packets that they use for TCP packets, for example either 30 or 60.
3655+Others may use completely wild values.
3656+ </P
3657+></LI
3658+></UL
3659+></DIV
3660+><DIV
3661+CLASS="REFSECT1"
3662+><A
3663+NAME="AEN403"
3664+></A
3665+><H2
3666+>BUGS</H2
3667+><P
3668+></P
3669+><UL
3670+><LI
3671+><P
3672+>Many Hosts and Gateways ignore the RECORD_ROUTE option.
3673+ </P
3674+></LI
3675+><LI
3676+><P
3677+>The maximum IP header length is too small for options like
3678+RECORD_ROUTE to be completely useful.
3679+There's not much that that can be done about this, however.
3680+ </P
3681+></LI
3682+><LI
3683+><P
3684+>Flood pinging is not recommended in general, and flood pinging the
3685+broadcast address should only be done under very controlled conditions.
3686+ </P
3687+></LI
3688+></UL
3689+></DIV
3690+><DIV
3691+CLASS="REFSECT1"
3692+><A
3693+NAME="AEN412"
3694+></A
3695+><H2
3696+>SEE ALSO</H2
3697+><P
3698+><SPAN
3699+CLASS="CITEREFENTRY"
3700+><SPAN
3701+CLASS="REFENTRYTITLE"
3702+>netstat</SPAN
3703+>(1)</SPAN
3704+>,
3705+<SPAN
3706+CLASS="CITEREFENTRY"
3707+><SPAN
3708+CLASS="REFENTRYTITLE"
3709+>ifconfig</SPAN
3710+>(8)</SPAN
3711+>.</P
3712+></DIV
3713+><DIV
3714+CLASS="REFSECT1"
3715+><A
3716+NAME="AEN421"
3717+></A
3718+><H2
3719+>HISTORY</H2
3720+><P
3721+>The <B
3722+CLASS="COMMAND"
3723+>ping</B
3724+> command appeared in 4.3BSD.</P
3725+><P
3726+>The version described here is its descendant specific to Linux.</P
3727+></DIV
3728+><DIV
3729+CLASS="REFSECT1"
3730+><A
3731+NAME="AEN426"
3732+></A
3733+><H2
3734+>SECURITY</H2
3735+><P
3736+><B
3737+CLASS="COMMAND"
3738+>ping</B
3739+> requires <CODE
3740+CLASS="CONSTANT"
3741+>CAP_NET_RAWIO</CODE
3742+> capability
3743+to be executed. It may be used as set-uid root.</P
3744+></DIV
3745+><DIV
3746+CLASS="REFSECT1"
3747+><A
3748+NAME="AEN431"
3749+></A
3750+><H2
3751+>AVAILABILITY</H2
3752+><P
3753+><B
3754+CLASS="COMMAND"
3755+>ping</B
3756+> is part of <TT
3757+CLASS="FILENAME"
3758+>iputils</TT
3759+> package
3760+and the latest versions are available in source form at
3761+<A
3762+HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2"
3763+TARGET="_top"
3764+>http://www.skbuff.net/iputils/iputils-current.tar.bz2</A
3765+>.</P
3766+></DIV
3767+><DIV
3768+CLASS="NAVFOOTER"
3769+><HR
3770+ALIGN="LEFT"
3771+WIDTH="100%"><TABLE
3772+SUMMARY="Footer navigation table"
3773+WIDTH="100%"
3774+BORDER="0"
3775+CELLPADDING="0"
3776+CELLSPACING="0"
3777+><TR
3778+><TD
3779+WIDTH="33%"
3780+ALIGN="left"
3781+VALIGN="top"
3782+><A
3783+HREF="index.html"
3784+ACCESSKEY="P"
3785+>Prev</A
3786+></TD
3787+><TD
3788+WIDTH="34%"
3789+ALIGN="center"
3790+VALIGN="top"
3791+><A
3792+HREF="index.html"
3793+ACCESSKEY="H"
3794+>Home</A
3795+></TD
3796+><TD
3797+WIDTH="33%"
3798+ALIGN="right"
3799+VALIGN="top"
3800+><A
3801+HREF="r437.html"
3802+ACCESSKEY="N"
3803+>Next</A
3804+></TD
3805+></TR
3806+><TR
3807+><TD
3808+WIDTH="33%"
3809+ALIGN="left"
3810+VALIGN="top"
3811+>System Manager's Manual: iputils</TD
3812+><TD
3813+WIDTH="34%"
3814+ALIGN="center"
3815+VALIGN="top"
3816+>&nbsp;</TD
3817+><TD
3818+WIDTH="33%"
3819+ALIGN="right"
3820+VALIGN="top"
3821+>arping</TD
3822+></TR
3823+></TABLE
3824+></DIV
3825+></BODY
3826+></HTML
3827+>
3828\ No newline at end of file
[ecc1136]3829diff -Naur iputils-s20101006.orig/doc/r437.html iputils-s20101006/doc/r437.html
3830--- iputils-s20101006.orig/doc/r437.html 1969-12-31 19:00:00.000000000 -0500
3831+++ iputils-s20101006/doc/r437.html 2011-01-08 20:09:49.571531343 -0500
[8867e46]3832@@ -0,0 +1,598 @@
3833+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
3834+<HTML
3835+><HEAD
3836+><TITLE
3837+>arping</TITLE
3838+><META
3839+NAME="GENERATOR"
3840+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
3841+REL="HOME"
3842+TITLE="System Manager's Manual: iputils"
3843+HREF="index.html"><LINK
3844+REL="PREVIOUS"
3845+TITLE="ping"
3846+HREF="r3.html"><LINK
3847+REL="NEXT"
3848+TITLE="clockdiff"
3849+HREF="r596.html"></HEAD
3850+><BODY
3851+CLASS="REFENTRY"
3852+BGCOLOR="#FFFFFF"
3853+TEXT="#000000"
3854+LINK="#0000FF"
3855+VLINK="#840084"
3856+ALINK="#0000FF"
3857+><DIV
3858+CLASS="NAVHEADER"
3859+><TABLE
3860+SUMMARY="Header navigation table"
3861+WIDTH="100%"
3862+BORDER="0"
3863+CELLPADDING="0"
3864+CELLSPACING="0"
3865+><TR
3866+><TH
3867+COLSPAN="3"
3868+ALIGN="center"
3869+>System Manager's Manual: iputils</TH
3870+></TR
3871+><TR
3872+><TD
3873+WIDTH="10%"
3874+ALIGN="left"
3875+VALIGN="bottom"
3876+><A
3877+HREF="r3.html"
3878+ACCESSKEY="P"
3879+>Prev</A
3880+></TD
3881+><TD
3882+WIDTH="80%"
3883+ALIGN="center"
3884+VALIGN="bottom"
3885+></TD
3886+><TD
3887+WIDTH="10%"
3888+ALIGN="right"
3889+VALIGN="bottom"
3890+><A
3891+HREF="r596.html"
3892+ACCESSKEY="N"
3893+>Next</A
3894+></TD
3895+></TR
3896+></TABLE
3897+><HR
3898+ALIGN="LEFT"
3899+WIDTH="100%"></DIV
3900+><H1
3901+><A
3902+NAME="ARPING"
3903+></A
3904+>arping</H1
3905+><DIV
3906+CLASS="REFNAMEDIV"
3907+><A
3908+NAME="AEN442"
3909+></A
3910+><H2
3911+>Name</H2
3912+>arping&nbsp;--&nbsp;send ARP REQUEST to a neighbour host</DIV
3913+><DIV
3914+CLASS="REFSYNOPSISDIV"
3915+><A
3916+NAME="AEN445"
3917+></A
3918+><H2
3919+>Synopsis</H2
3920+><P
3921+><B
3922+CLASS="COMMAND"
3923+>arping</B
3924+> [<CODE
3925+CLASS="OPTION"
3926+>-AbDfhqUV</CODE
3927+>] [-c <TT
3928+CLASS="REPLACEABLE"
3929+><I
3930+>count</I
3931+></TT
3932+>] [-w <TT
3933+CLASS="REPLACEABLE"
3934+><I
3935+>deadline</I
3936+></TT
3937+>] [-s <TT
3938+CLASS="REPLACEABLE"
3939+><I
3940+>source</I
3941+></TT
3942+>] {-I <TT
3943+CLASS="REPLACEABLE"
3944+><I
3945+>interface</I
3946+></TT
3947+>} {<TT
3948+CLASS="REPLACEABLE"
3949+><I
3950+>destination</I
3951+></TT
3952+>}</P
3953+></DIV
3954+><DIV
3955+CLASS="REFSECT1"
3956+><A
3957+NAME="AEN460"
3958+></A
3959+><H2
3960+>DESCRIPTION</H2
3961+><P
3962+>Ping <TT
3963+CLASS="REPLACEABLE"
3964+><I
3965+>destination</I
3966+></TT
3967+> on device <TT
3968+CLASS="REPLACEABLE"
3969+><I
3970+>interface</I
3971+></TT
3972+> by ARP packets,
3973+using source address <TT
3974+CLASS="REPLACEABLE"
3975+><I
3976+>source</I
3977+></TT
3978+>.</P
3979+></DIV
3980+><DIV
3981+CLASS="REFSECT1"
3982+><A
3983+NAME="AEN466"
3984+></A
3985+><H2
3986+>OPTIONS</H2
3987+><P
3988+></P
3989+><DIV
3990+CLASS="VARIABLELIST"
3991+><DL
3992+><DT
3993+><CODE
3994+CLASS="OPTION"
3995+>-A</CODE
3996+></DT
3997+><DD
3998+><P
3999+>The same as <CODE
4000+CLASS="OPTION"
4001+>-U</CODE
4002+>, but ARP REPLY packets used instead
4003+of ARP REQUEST.
4004+ </P
4005+></DD
4006+><DT
4007+><CODE
4008+CLASS="OPTION"
4009+>-b</CODE
4010+></DT
4011+><DD
4012+><P
4013+>Send only MAC level broadcasts. Normally <B
4014+CLASS="COMMAND"
4015+>arping</B
4016+> starts
4017+from sending broadcast, and switch to unicast after reply received.
4018+ </P
4019+></DD
4020+><DT
4021+><CODE
4022+CLASS="OPTION"
4023+><A
4024+NAME="ARPING.COUNT"
4025+></A
4026+>-c <TT
4027+CLASS="REPLACEABLE"
4028+><I
4029+>count</I
4030+></TT
4031+></CODE
4032+></DT
4033+><DD
4034+><P
4035+>Stop after sending <TT
4036+CLASS="REPLACEABLE"
4037+><I
4038+>count</I
4039+></TT
4040+> ARP REQUEST
4041+packets. With
4042+<A
4043+HREF="r437.html#ARPING.DEADLINE"
4044+><TT
4045+CLASS="REPLACEABLE"
4046+><I
4047+>deadline</I
4048+></TT
4049+></A
4050+>
4051+option, <B
4052+CLASS="COMMAND"
4053+>arping</B
4054+> waits for
4055+<TT
4056+CLASS="REPLACEABLE"
4057+><I
4058+>count</I
4059+></TT
4060+> ARP REPLY packets, until the timeout expires.
4061+ </P
4062+></DD
4063+><DT
4064+><CODE
4065+CLASS="OPTION"
4066+>-D</CODE
4067+></DT
4068+><DD
4069+><P
4070+>Duplicate address detection mode (DAD). See
4071+<A
4072+HREF="ftp://ftp.isi.edu/in-notes/rfc2131.txt"
4073+TARGET="_top"
4074+>RFC2131, 4.4.1</A
4075+>.
4076+Returns 0, if DAD succeeded i.e. no replies are received
4077+ </P
4078+></DD
4079+><DT
4080+><CODE
4081+CLASS="OPTION"
4082+>-f</CODE
4083+></DT
4084+><DD
4085+><P
4086+>Finish after the first reply confirming that target is alive.
4087+ </P
4088+></DD
4089+><DT
4090+><CODE
4091+CLASS="OPTION"
4092+><A
4093+NAME="OPT.INTERFACE"
4094+></A
4095+>-I <TT
4096+CLASS="REPLACEABLE"
4097+><I
4098+>interface</I
4099+></TT
4100+></CODE
4101+></DT
4102+><DD
4103+><P
4104+>Name of network device where to send ARP REQUEST packets. This option
4105+is required.
4106+ </P
4107+></DD
4108+><DT
4109+><CODE
4110+CLASS="OPTION"
4111+>-h</CODE
4112+></DT
4113+><DD
4114+><P
4115+>Print help page and exit.
4116+ </P
4117+></DD
4118+><DT
4119+><CODE
4120+CLASS="OPTION"
4121+>-q</CODE
4122+></DT
4123+><DD
4124+><P
4125+>Quiet output. Nothing is displayed.
4126+ </P
4127+></DD
4128+><DT
4129+><CODE
4130+CLASS="OPTION"
4131+><A
4132+NAME="OPT.SOURCE"
4133+></A
4134+>-s <TT
4135+CLASS="REPLACEABLE"
4136+><I
4137+>source</I
4138+></TT
4139+></CODE
4140+></DT
4141+><DD
4142+><P
4143+>IP source address to use in ARP packets.
4144+If this option is absent, source address is:
4145+ <P
4146+></P
4147+><UL
4148+><LI
4149+><P
4150+>In DAD mode (with option <CODE
4151+CLASS="OPTION"
4152+>-D</CODE
4153+>) set to 0.0.0.0.
4154+ </P
4155+></LI
4156+><LI
4157+><P
4158+>In Unsolicited ARP mode (with options <CODE
4159+CLASS="OPTION"
4160+>-U</CODE
4161+> or <CODE
4162+CLASS="OPTION"
4163+>-A</CODE
4164+>)
4165+set to <TT
4166+CLASS="REPLACEABLE"
4167+><I
4168+>destination</I
4169+></TT
4170+>.
4171+ </P
4172+></LI
4173+><LI
4174+><P
4175+>Otherwise, it is calculated from routing tables.
4176+ </P
4177+></LI
4178+></UL
4179+>
4180+ </P
4181+></DD
4182+><DT
4183+><CODE
4184+CLASS="OPTION"
4185+>-U</CODE
4186+></DT
4187+><DD
4188+><P
4189+>Unsolicited ARP mode to update neighbours' ARP caches.
4190+No replies are expected.
4191+ </P
4192+></DD
4193+><DT
4194+><CODE
4195+CLASS="OPTION"
4196+>-V</CODE
4197+></DT
4198+><DD
4199+><P
4200+>Print version of the program and exit.
4201+ </P
4202+></DD
4203+><DT
4204+><CODE
4205+CLASS="OPTION"
4206+><A
4207+NAME="ARPING.DEADLINE"
4208+></A
4209+>-w <TT
4210+CLASS="REPLACEABLE"
4211+><I
4212+>deadline</I
4213+></TT
4214+></CODE
4215+></DT
4216+><DD
4217+><P
4218+>Specify a timeout, in seconds, before
4219+<B
4220+CLASS="COMMAND"
4221+>arping</B
4222+>
4223+exits regardless of how many
4224+packets have been sent or received. In this case
4225+<B
4226+CLASS="COMMAND"
4227+>arping</B
4228+>
4229+does not stop after
4230+<A
4231+HREF="r437.html#ARPING.COUNT"
4232+><TT
4233+CLASS="REPLACEABLE"
4234+><I
4235+>count</I
4236+></TT
4237+></A
4238+>
4239+packet are sent, it waits either for
4240+<A
4241+HREF="r437.html#ARPING.DEADLINE"
4242+><TT
4243+CLASS="REPLACEABLE"
4244+><I
4245+>deadline</I
4246+></TT