Ticket #1164: iputils-s20161105-build-1.patch
File iputils-s20161105-build-1.patch, 156.3 KB (added by , 7 years ago) |
---|
-
iputils-s20161105
Submitted By: William Harrington <kb0iic at cross-lfs dot org> Date: 2017-08-25 Initial Package Version: s20161105 Upstream Status: None Origin: https://github.com/iputils/iputils Description: Edit Makefile USE_ Variables and include man pages. diff -Naur iputils-s20161105.orig/Makefile iputils-s20161105/Makefile
old new 28 28 # sysfs support (with libsysfs - deprecated) [no|yes|static] 29 29 USE_SYSFS=no 30 30 # IDN support [yes|no|static] 31 USE_IDN= yes31 USE_IDN=no 32 32 33 33 # Do not use getifaddrs [no|yes|static] 34 34 WITHOUT_IFADDRS=no … … 36 36 ARPING_DEFAULT_DEVICE= 37 37 38 38 # nettle library for ipv6 ping [yes|no|static] 39 USE_NETTLE= yes39 USE_NETTLE=no 40 40 # libgcrypt library for ipv6 ping [no|yes|static] 41 41 USE_GCRYPT=no 42 42 # Crypto library for ping6 [shared|static|no] 43 USE_CRYPTO= shared43 USE_CRYPTO=no 44 44 # Resolv library for ping6 [yes|static] 45 45 USE_RESOLV=yes 46 46 # ping6 source routing (deprecated by RFC5095) [no|yes|RFC3542] -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/arping.8 iputils-s20161105/doc/arping.8
old new 1 .\" This manpage has been automatically generated by docbook2man 2 .\" from a DocBook document. This tool can be found at: 3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 4 .\" Please send any bug reports, improvements, comments, patches, 5 .\" etc. to Steve Cheng <steve@ggi-project.org>. 6 .TH "ARPING" "8" "" "iputils-161105" "System Manager's Manual: iputils" 7 .SH NAME 8 arping \- send ARP REQUEST to a neighbour host 9 .SH SYNOPSIS 10 11 \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 12 13 .SH "DESCRIPTION" 14 .PP 15 Ping \fIdestination\fR on device \fIinterface\fR by ARP packets, 16 using source address \fIsource\fR. 17 .SH "OPTIONS" 18 .TP 19 \fB-A\fR 20 The same as \fB-U\fR, but ARP REPLY packets used instead 21 of ARP REQUEST. 22 .TP 23 \fB-b\fR 24 Send only MAC level broadcasts. Normally \fBarping\fR starts 25 from sending broadcast, and switch to unicast after reply received. 26 .TP 27 \fB-c \fIcount\fB\fR 28 Stop after sending \fIcount\fR ARP REQUEST 29 packets. With 30 \fIdeadline\fR 31 option, instead wait for 32 \fIcount\fR ARP REPLY packets, or until the timeout expires. 33 .TP 34 \fB-D\fR 35 Duplicate address detection mode (DAD). See 36 RFC2131, 4.4.1. 37 Returns 0, if DAD succeeded i.e. no replies are received 38 .TP 39 \fB-f\fR 40 Finish after the first reply confirming that target is alive. 41 .TP 42 \fB-I \fIinterface\fB\fR 43 Name of network device where to send ARP REQUEST packets. 44 .TP 45 \fB-h\fR 46 Print help page and exit. 47 .TP 48 \fB-q\fR 49 Quiet output. Nothing is displayed. 50 .TP 51 \fB-s \fIsource\fB\fR 52 IP source address to use in ARP packets. 53 If this option is absent, source address is: 54 .RS 55 .TP 0.2i 56 \(bu 57 In DAD mode (with option \fB-D\fR) set to 0.0.0.0. 58 .TP 0.2i 59 \(bu 60 In Unsolicited ARP mode (with options \fB-U\fR or \fB-A\fR) 61 set to \fIdestination\fR. 62 .TP 0.2i 63 \(bu 64 Otherwise, it is calculated from routing tables. 65 .RE 66 .TP 67 \fB-U\fR 68 Unsolicited ARP mode to update neighbours' ARP caches. 69 No replies are expected. 70 .TP 71 \fB-V\fR 72 Print version of the program and exit. 73 .TP 74 \fB-w \fIdeadline\fB\fR 75 Specify a timeout, in seconds, before 76 \fBarping\fR 77 exits regardless of how many 78 packets have been sent or received. In this case 79 \fBarping\fR 80 does not stop after 81 \fIcount\fR 82 packet are sent, it waits either for 83 \fIdeadline\fR 84 expire or until 85 \fIcount\fR 86 probes are answered. 87 .SH "SEE ALSO" 88 .PP 89 \fBping\fR(8), 90 \fBclockdiff\fR(8), 91 \fBtracepath\fR(8). 92 .SH "AUTHOR" 93 .PP 94 \fBarping\fR was written by 95 Alexey Kuznetsov 96 <kuznet@ms2.inr.ac.ru>. 97 It is now maintained by 98 YOSHIFUJI Hideaki 99 <yoshfuji@skbuff.net>. 100 .SH "SECURITY" 101 .PP 102 \fBarping\fR requires CAP_NET_RAW capability 103 to be executed. It is not recommended to be used as set-uid root, 104 because it allows user to modify ARP caches of neighbour hosts. 105 .SH "AVAILABILITY" 106 .PP 107 \fBarping\fR is part of \fIiputils\fR package 108 and the latest versions are available in source form at 109 http://www.skbuff.net/iputils/iputils-current.tar.bz2. -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/clockdiff.8 iputils-s20161105/doc/clockdiff.8
old new 1 .\" This manpage has been automatically generated by docbook2man 2 .\" from a DocBook document. This tool can be found at: 3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 4 .\" Please send any bug reports, improvements, comments, patches, 5 .\" etc. to Steve Cheng <steve@ggi-project.org>. 6 .TH "CLOCKDIFF" "8" "" "iputils-161105" "System Manager's Manual: iputils" 7 .SH NAME 8 clockdiff \- measure clock difference between hosts 9 .SH SYNOPSIS 10 11 \fBclockdiff\fR [\fB-o\fR] [\fB-o1\fR] \fB\fIdestination\fB\fR 12 13 .SH "DESCRIPTION" 14 .PP 15 \fBclockdiff\fR Measures clock difference between us and 16 \fIdestination\fR with 1 msec resolution using ICMP TIMESTAMP 17 [2] 18 packets or, optionally, IP TIMESTAMP option 19 [3] 20 option added to ICMP ECHO. 21 [1] 22 .SH "OPTIONS" 23 .TP 24 \fB-o\fR 25 Use IP TIMESTAMP with ICMP ECHO instead of ICMP TIMESTAMP 26 messages. It is useful with some destinations, which do not support 27 ICMP TIMESTAMP (f.e. Solaris <2.4). 28 .TP 29 \fB-o1\fR 30 Slightly different form of \fB-o\fR, namely it uses three-term 31 IP TIMESTAMP with prespecified hop addresses instead of four term one. 32 What flavor works better depends on target host. Particularly, 33 \fB-o\fR is better for Linux. 34 .SH "WARNINGS" 35 .TP 0.2i 36 \(bu 37 Some nodes (Cisco) use non-standard timestamps, which is allowed 38 by RFC, but makes timestamps mostly useless. 39 .TP 0.2i 40 \(bu 41 Some nodes generate messed timestamps (Solaris>2.4), when 42 run \fBxntpd\fR. Seems, its IP stack uses a corrupted clock source, 43 which is synchronized to time-of-day clock periodically and jumps 44 randomly making timestamps mostly useless. Good news is that you can 45 use NTP in this case, which is even better. 46 .TP 0.2i 47 \(bu 48 \fBclockdiff\fR shows difference in time modulo 24 days. 49 .SH "SEE ALSO" 50 .PP 51 \fBping\fR(8), 52 \fBarping\fR(8), 53 \fBtracepath\fR(8). 54 .SH "REFERENCES" 55 .PP 56 [1] ICMP ECHO, 57 RFC0792, page 14. 58 .PP 59 [2] ICMP TIMESTAMP, 60 RFC0792, page 16. 61 .PP 62 [3] IP TIMESTAMP option, 63 RFC0791, 3.1, page 16. 64 .SH "AUTHOR" 65 .PP 66 \fBclockdiff\fR was compiled by 67 Alexey Kuznetsov 68 <kuznet@ms2.inr.ac.ru>. It was based on code borrowed 69 from BSD \fBtimed\fR daemon. 70 It is now maintained by 71 YOSHIFUJI Hideaki 72 <yoshfuji@skbuff.net>. 73 .SH "SECURITY" 74 .PP 75 \fBclockdiff\fR requires CAP_NET_RAW capability 76 to be executed. It is safe to be used as set-uid root. 77 .SH "AVAILABILITY" 78 .PP 79 \fBclockdiff\fR is part of \fIiputils\fR package 80 and the latest versions are available in source form at 81 http://www.skbuff.net/iputils/iputils-current.tar.bz2. -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/ninfod.8 iputils-s20161105/doc/ninfod.8
old new 1 .\" This manpage has been automatically generated by docbook2man 2 .\" from a DocBook document. This tool can be found at: 3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 4 .\" Please send any bug reports, improvements, comments, patches, 5 .\" etc. to Steve Cheng <steve@ggi-project.org>. 6 .TH "NINFOD" "8" "" "iputils-161105" "System Manager's Manual: iputils" 7 .SH NAME 8 ninfod \- Respond to IPv6 Node Information Queries 9 .SH SYNOPSIS 10 11 \fBninfod\fR [\fB-dhv\fR] [\fB-p \fIpidfile\fB\fR] [\fB-u \fIuser\fB\fR] 12 13 .SH "DESCRIPTION" 14 .PP 15 Responds to IPv6 Node Information Queries (RFC4620) from clients. 16 Queries can be sent by various implementations of \fBping6\fR command. 17 .SH "OPTIONS" 18 .TP 19 \fB-a\fR 20 Debug mode. Do not go background. 21 .TP 22 \fB-h\fR 23 Show help. 24 .TP 25 \fB-v\fR 26 Verbose mode. 27 .TP 28 \fB-u \fIuser\fB\fR 29 Run as another user. 30 \fIuser\fR can either be username or user ID. 31 .TP 32 \fB-p \fIpidfile\fB\fR 33 File for process-id storage. 34 \fIuser\fR is required to be able to create the file. 35 .SH "SEE ALSO" 36 .PP 37 \fBping\fR(8). 38 .SH "AUTHOR" 39 .PP 40 \fBninfod\fR was written by USAGI/WIDE Project. 41 .SH "COPYING" 42 .PP 43 44 .nf 45 Copyright (C) 2012 YOSHIFUJI Hideaki. 46 Copyright (C) 2002 USAGI/WIDE Project. 47 All rights reserved. 48 49 Redistribution and use in source and binary forms, with or without 50 modification, are permitted provided that the following conditions 51 are met: 52 1. Redistributions of source code must retain the above copyright 53 notice, this list of conditions and the following disclaimer. 54 2. Redistributions in binary form must reproduce the above copyright 55 notice, this list of conditions and the following disclaimer in the 56 documentation and/or other materials provided with the distribution. 57 3. Neither the name of the project nor the names of its contributors 58 may be used to endorse or promote products derived from this software 59 without specific prior written permission. 60 61 THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND 62 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 63 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 64 ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE 65 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 66 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 67 OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 68 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 69 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 70 OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 71 SUCH DAMAGE. 72 .fi -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/pg3.8 iputils-s20161105/doc/pg3.8
old new 1 .\" This manpage has been automatically generated by docbook2man 2 .\" from a DocBook document. This tool can be found at: 3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 4 .\" Please send any bug reports, improvements, comments, patches, 5 .\" etc. to Steve Cheng <steve@ggi-project.org>. 6 .TH "PG3" "8" "" "iputils-161105" "System Manager's Manual: iputils" 7 .SH NAME 8 pg3, ipg, pgset \- send stream of UDP packets 9 .SH SYNOPSIS 10 11 \fBsource ipg\fR 12 13 14 \fBpg\fR 15 16 17 \fBpgset\fR \fB\fICOMMAND\fB\fR 18 19 .SH "DESCRIPTION" 20 .PP 21 \fBipg\fR is not a program, it is script which should be sourced 22 to \fBbash\fR. When sourced it loads module \fIpg3\fR and 23 exports a few of functions accessible from parent shell. These macros 24 are \fBpg\fR to start packet injection and to get the results of run; 25 and \fBpgset\fR to setup packet generator. 26 .PP 27 \fBpgset\fR can send the following commands to module \fIpg3\fR: 28 .SH "COMMAND" 29 .TP 30 \fBodev \fIDEVICE\fB\fR 31 Name of Ethernet device to test. See 32 warning below. 33 .TP 34 \fBpkt_size \fIBYTES\fB\fR 35 Size of packet to generate. The size includes all the headers: UDP, IP, 36 MAC, but does not account for overhead internal to medium, i.e. FCS 37 and various paddings. 38 .TP 39 \fBfrags \fINUMBER\fB\fR 40 Each packet will contain \fINUMBER\fR of fragments. 41 Maximal amount for linux-2.4 is 6. Far not all the devices support 42 fragmented buffers. 43 .TP 44 \fBcount \fINUMBER\fB\fR 45 Send stream of \fINUMBER\fR of packets and stop after this. 46 .TP 47 \fBipg \fITIME\fB\fR 48 Introduce artificial delay between packets of \fITIME\fR 49 microseconds. 50 .TP 51 \fBdst \fIIP_ADDRESS\fB\fR 52 Select IP destination where the stream is sent to. 53 Beware, never set this address at random. \fBpg3\fR is not a toy, 54 it creates really tough stream. Default value is 0.0.0.0. 55 .TP 56 \fBdst \fIMAC_ADDRESS\fB\fR 57 Select MAC destination where the stream is sent to. 58 Default value is 00:00:00:00:00:00 in hope that this will not be received 59 by any node on LAN. 60 .TP 61 \fBstop\fR 62 Abort packet injection. 63 .SH "WARNING" 64 .PP 65 When output device is set to some random device different 66 of hardware Ethernet device, \fBpg3\fR will crash kernel. 67 .PP 68 Do not use it on VLAN, ethertap, VTUN and other devices, 69 which emulate Ethernet not being real Ethernet in fact. 70 .SH "AUTHOR" 71 .PP 72 \fBpg3\fR was written by Robert Olsson <robert.olsson@its.uu.se>. 73 .SH "SECURITY" 74 .PP 75 This can be used only by superuser. 76 .PP 77 This tool creates floods of packets which is unlikely to be handled 78 even by high-end machines. For example, it saturates gigabit link with 79 60 byte packets when used with Intel's e1000. In face of such stream 80 switches, routers and end hosts may deadlock, crash, explode. 81 Use only in test lab environment. 82 .SH "AVAILABILITY" 83 .PP 84 \fBpg3\fR is part of \fIiputils\fR package 85 and the latest versions are available in source form at 86 http://www.skbuff.net/iputils/iputils-current.tar.bz2. -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/ping.8 iputils-s20161105/doc/ping.8
old new 1 .\" This manpage has been automatically generated by docbook2man 2 .\" from a DocBook document. This tool can be found at: 3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 4 .\" Please send any bug reports, improvements, comments, patches, 5 .\" etc. to Steve Cheng <steve@ggi-project.org>. 6 .TH "PING" "8" "" "iputils-161105" "System Manager's Manual: iputils" 7 .SH NAME 8 ping \- send ICMP ECHO_REQUEST to network hosts 9 .SH SYNOPSIS 10 11 \fBping\fR [\fB-aAbBdDfhLnOqrRUvV46\fR] [\fB-c \fIcount\fB\fR] [\fB-F \fIflowlabel\fB\fR] [\fB-i \fIinterval\fB\fR] [\fB-I \fIinterface\fB\fR] [\fB-l \fIpreload\fB\fR] [\fB-m \fImark\fB\fR] [\fB-M \fIpmtudisc_option\fB\fR] [\fB-N \fInodeinfo_option\fB\fR] [\fB-w \fIdeadline\fB\fR] [\fB-W \fItimeout\fB\fR] [\fB-p \fIpattern\fB\fR] [\fB-Q \fItos\fB\fR] [\fB-s \fIpacketsize\fB\fR] [\fB-S \fIsndbuf\fB\fR] [\fB-t \fIttl\fB\fR] [\fB-T \fItimestamp option\fB\fR] [\fB\fIhop\fB\fR\fI ...\fR] \fB\fIdestination\fB\fR 12 13 .SH "DESCRIPTION" 14 .PP 15 \fBping\fR uses the ICMP protocol's mandatory ECHO_REQUEST 16 datagram to elicit an ICMP ECHO_RESPONSE from a host or gateway. 17 ECHO_REQUEST datagrams (``pings'') have an IP and ICMP 18 header, followed by a struct timeval and then an arbitrary 19 number of ``pad'' bytes used to fill out the packet. 20 .PP 21 \fBping\fR works with both IPv4 and IPv6. Using only one of them 22 explicitly can be enforced by specifying \fB-4\fR or \fB-6\fR. 23 .PP 24 \fBping\fR can also send IPv6 Node Information Queries (RFC4620). 25 Intermediate \fIhop\fRs may not be allowed, because IPv6 source routing was deprecated (RFC5095). 26 .SH "OPTIONS" 27 .TP 28 \fB-4\fR 29 Use IPv4 only. 30 .TP 31 \fB-6\fR 32 Use IPv6 only. 33 .TP 34 \fB-a\fR 35 Audible ping. 36 .TP 37 \fB-A\fR 38 Adaptive ping. Interpacket interval adapts to round-trip time, so that 39 effectively not more than one (or more, if preload is set) unanswered probe 40 is present in the network. Minimal interval is 200msec for not super-user. 41 On networks with low rtt this mode is essentially equivalent to flood mode. 42 .TP 43 \fB-b\fR 44 Allow pinging a broadcast address. 45 .TP 46 \fB-B\fR 47 Do not allow \fBping\fR to change source address of probes. 48 The address is bound to one selected when \fBping\fR starts. 49 .TP 50 \fB-c \fIcount\fB\fR 51 Stop after sending \fIcount\fR ECHO_REQUEST 52 packets. With 53 \fIdeadline\fR 54 option, \fBping\fR waits for 55 \fIcount\fR ECHO_REPLY packets, until the timeout expires. 56 .TP 57 \fB-d\fR 58 Set the SO_DEBUG option on the socket being used. 59 Essentially, this socket option is not used by Linux kernel. 60 .TP 61 \fB-D\fR 62 Print timestamp (unix time + microseconds as in gettimeofday) before 63 each line. 64 .TP 65 \fB-f\fR 66 Flood ping. For every ECHO_REQUEST sent a period ``.'' is printed, 67 while for ever ECHO_REPLY received a backspace is printed. 68 This provides a rapid display of how many packets are being dropped. 69 If interval is not given, it sets interval to zero and 70 outputs packets as fast as they come back or one hundred times per second, 71 whichever is more. 72 Only the super-user may use this option with zero interval. 73 .TP 74 \fB-F \fIflow label\fB\fR 75 IPv6 only. 76 Allocate and set 20 bit flow label (in hex) on echo request packets. 77 If value is zero, kernel allocates random flow label. 78 .TP 79 \fB-h\fR 80 Show help. 81 .TP 82 \fB-i \fIinterval\fB\fR 83 Wait \fIinterval\fR seconds between sending each packet. 84 The default is to wait for one second between each packet normally, 85 or not to wait in flood mode. Only super-user may set interval 86 to values less than 0.2 seconds. 87 .TP 88 \fB-I \fIinterface\fB\fR 89 \fIinterface\fR is either an address, or an interface name. 90 If \fIinterface\fR is an address, it sets source address 91 to specified interface address. 92 If \fIinterface\fR in an interface name, it sets 93 source interface to specified interface. 94 For IPv6, when doing ping to a link-local scope 95 address, link specification (by the '%'-notation in 96 \fIdestination\fR, or by this option) is required. 97 .TP 98 \fB-l \fIpreload\fB\fR 99 If \fIpreload\fR is specified, 100 \fBping\fR sends that many packets not waiting for reply. 101 Only the super-user may select preload more than 3. 102 .TP 103 \fB-L\fR 104 Suppress loopback of multicast packets. This flag only applies if the ping 105 destination is a multicast address. 106 .TP 107 \fB-m \fImark\fB\fR 108 use \fImark\fR to tag the packets going out. This is useful 109 for variety of reasons within the kernel such as using policy 110 routing to select specific outbound processing. 111 .TP 112 \fB-M \fIpmtudisc_opt\fB\fR 113 Select Path MTU Discovery strategy. 114 \fIpmtudisc_option\fR may be either \fIdo\fR 115 (prohibit fragmentation, even local one), 116 \fIwant\fR (do PMTU discovery, fragment locally when packet size 117 is large), or \fIdont\fR (do not set DF flag). 118 .TP 119 \fB-N \fInodeinfo_option\fB\fR 120 IPv6 only. 121 Send ICMPv6 Node Information Queries (RFC4620), instead of Echo Request. 122 CAP_NET_RAW capability is required. 123 .RS 124 .TP 125 \fBhelp\fR 126 Show help for NI support. 127 .RE 128 .RS 129 .TP 130 \fBname\fR 131 Queries for Node Names. 132 .RE 133 .RS 134 .TP 135 \fBipv6\fR 136 Queries for IPv6 Addresses. There are several IPv6 specific flags. 137 .RS 138 .TP 139 \fBipv6-global\fR 140 Request IPv6 global-scope addresses. 141 .RE 142 .RS 143 .TP 144 \fBipv6-sitelocal\fR 145 Request IPv6 site-local addresses. 146 .RE 147 .RS 148 .TP 149 \fBipv6-linklocal\fR 150 Request IPv6 link-local addresses. 151 .RE 152 .RS 153 .TP 154 \fBipv6-all\fR 155 Request IPv6 addresses on other interfaces. 156 .RE 157 .RE 158 .RS 159 .TP 160 \fBipv4\fR 161 Queries for IPv4 Addresses. There is one IPv4 specific flag. 162 .RS 163 .TP 164 \fBipv4-all\fR 165 Request IPv4 addresses on other interfaces. 166 .RE 167 .RE 168 .RS 169 .TP 170 \fBsubject-ipv6=\fIipv6addr\fB\fR 171 IPv6 subject address. 172 .RE 173 .RS 174 .TP 175 \fBsubject-ipv4=\fIipv4addr\fB\fR 176 IPv4 subject address. 177 .RE 178 .RS 179 .TP 180 \fBsubject-name=\fInodename\fB\fR 181 Subject name. If it contains more than one dot, 182 fully-qualified domain name is assumed. 183 .RE 184 .RS 185 .TP 186 \fBsubject-fqdn=\fInodename\fB\fR 187 Subject name. Fully-qualified domain name is 188 always assumed. 189 .RE 190 .TP 191 \fB-n\fR 192 Numeric output only. 193 No attempt will be made to lookup symbolic names for host addresses. 194 .TP 195 \fB-O\fR 196 Report outstanding ICMP ECHO reply before sending next packet. 197 This is useful together with the timestamp \fB-D\fR to 198 log output to a diagnostic file and search for missing answers. 199 .TP 200 \fB-p \fIpattern\fB\fR 201 You may specify up to 16 ``pad'' bytes to fill out the packet you send. 202 This is useful for diagnosing data-dependent problems in a network. 203 For example, \fB-p ff\fR will cause the sent packet 204 to be filled with all ones. 205 .TP 206 \fB-q\fR 207 Quiet output. 208 Nothing is displayed except the summary lines at startup time and 209 when finished. 210 .TP 211 \fB-Q \fItos\fB\fR 212 Set Quality of Service -related bits in ICMP datagrams. 213 \fItos\fR can be decimal (\fBping\fR only) or hex number. 214 215 In RFC2474, these fields are interpreted as 8-bit Differentiated 216 Services (DS), consisting of: bits 0-1 (2 lowest bits) of separate 217 data, and bits 2-7 (highest 6 bits) of Differentiated Services 218 Codepoint (DSCP). In RFC2481 and RFC3168, bits 0-1 are used for ECN. 219 220 Historically (RFC1349, obsoleted by RFC2474), these were interpreted 221 as: bit 0 (lowest bit) for reserved (currently being redefined as 222 congestion control), 1-4 for Type of Service and bits 5-7 223 (highest bits) for Precedence. 224 .TP 225 \fB-r\fR 226 Bypass the normal routing tables and send directly to a host on an attached 227 interface. 228 If the host is not on a directly-attached network, an error is returned. 229 This option can be used to ping a local host through an interface 230 that has no route through it provided the option \fB-I\fR is also 231 used. 232 .TP 233 \fB-R\fR 234 \fBping\fR only. 235 Record route. 236 Includes the RECORD_ROUTE option in the ECHO_REQUEST 237 packet and displays the route buffer on returned packets. 238 Note that the IP header is only large enough for nine such routes. 239 Many hosts ignore or discard this option. 240 .TP 241 \fB-s \fIpacketsize\fB\fR 242 Specifies the number of data bytes to be sent. 243 The default is 56, which translates into 64 ICMP 244 data bytes when combined with the 8 bytes of ICMP header data. 245 .TP 246 \fB-S \fIsndbuf\fB\fR 247 Set socket sndbuf. If not specified, it is selected to buffer 248 not more than one packet. 249 .TP 250 \fB-t \fIttl\fB\fR 251 \fBping\fR only. 252 Set the IP Time to Live. 253 .TP 254 \fB-T \fItimestamp option\fB\fR 255 Set special IP timestamp options. 256 \fItimestamp option\fR may be either 257 \fItsonly\fR (only timestamps), 258 \fItsandaddr\fR (timestamps and addresses) or 259 \fItsprespec host1 [host2 [host3 [host4]]]\fR 260 (timestamp prespecified hops). 261 .TP 262 \fB-U\fR 263 Print full user-to-user latency (the old behaviour). Normally 264 \fBping\fR 265 prints network round trip time, which can be different 266 f.e. due to DNS failures. 267 .TP 268 \fB-v\fR 269 Verbose output. 270 .TP 271 \fB-V\fR 272 Show version and exit. 273 .TP 274 \fB-w \fIdeadline\fB\fR 275 Specify a timeout, in seconds, before 276 \fBping\fR 277 exits regardless of how many 278 packets have been sent or received. In this case 279 \fBping\fR 280 does not stop after 281 \fIcount\fR 282 packet are sent, it waits either for 283 \fIdeadline\fR 284 expire or until 285 \fIcount\fR 286 probes are answered or for some error notification from network. 287 .TP 288 \fB-W \fItimeout\fB\fR 289 Time to wait for a response, in seconds. The option affects only timeout 290 in absence of any responses, otherwise \fBping\fR waits for two RTTs. 291 .PP 292 When using \fBping\fR for fault isolation, it should first be run 293 on the local host, to verify that the local network interface is up 294 and running. Then, hosts and gateways further and further away should be 295 ``pinged''. Round-trip times and packet loss statistics are computed. 296 If duplicate packets are received, they are not included in the packet 297 loss calculation, although the round trip time of these packets is used 298 in calculating the minimum/average/maximum round-trip time numbers. 299 When the specified number of packets have been sent (and received) or 300 if the program is terminated with a 301 SIGINT, a brief summary is displayed. Shorter current statistics 302 can be obtained without termination of process with signal 303 SIGQUIT. 304 .PP 305 If \fBping\fR does not receive any reply packets at all it will 306 exit with code 1. If a packet 307 \fIcount\fR 308 and 309 \fIdeadline\fR 310 are both specified, and fewer than 311 \fIcount\fR 312 packets are received by the time the 313 \fIdeadline\fR 314 has arrived, it will also exit with code 1. 315 On other error it exits with code 2. Otherwise it exits with code 0. This 316 makes it possible to use the exit code to see if a host is alive or 317 not. 318 .PP 319 This program is intended for use in network testing, measurement and 320 management. 321 Because of the load it can impose on the network, it is unwise to use 322 \fBping\fR during normal operations or from automated scripts. 323 .SH "ICMP PACKET DETAILS" 324 .PP 325 An IP header without options is 20 bytes. 326 An ICMP ECHO_REQUEST packet contains an additional 8 bytes worth 327 of ICMP header followed by an arbitrary amount of data. 328 When a \fIpacketsize\fR is given, this indicated the size of this 329 extra piece of data (the default is 56). Thus the amount of data received 330 inside of an IP packet of type ICMP ECHO_REPLY will always be 8 bytes 331 more than the requested data space (the ICMP header). 332 .PP 333 If the data space is at least of size of struct timeval 334 \fBping\fR uses the beginning bytes of this space to include 335 a timestamp which it uses in the computation of round trip times. 336 If the data space is shorter, no round trip times are given. 337 .SH "DUPLICATE AND DAMAGED PACKETS" 338 .PP 339 \fBping\fR will report duplicate and damaged packets. 340 Duplicate packets should never occur, and seem to be caused by 341 inappropriate link-level retransmissions. 342 Duplicates may occur in many situations and are rarely (if ever) a 343 good sign, although the presence of low levels of duplicates may not 344 always be cause for alarm. 345 .PP 346 Damaged packets are obviously serious cause for alarm and often 347 indicate broken hardware somewhere in the 348 \fBping\fR packet's path (in the network or in the hosts). 349 .SH "TRYING DIFFERENT DATA PATTERNS" 350 .PP 351 The (inter)network layer should never treat packets differently depending 352 on the data contained in the data portion. 353 Unfortunately, data-dependent problems have been known to sneak into 354 networks and remain undetected for long periods of time. 355 In many cases the particular pattern that will have problems is something 356 that doesn't have sufficient ``transitions'', such as all ones or all 357 zeros, or a pattern right at the edge, such as almost all zeros. 358 It isn't necessarily enough to specify a data pattern of all zeros (for 359 example) on the command line because the pattern that is of interest is 360 at the data link level, and the relationship between what you type and 361 what the controllers transmit can be complicated. 362 .PP 363 This means that if you have a data-dependent problem you will probably 364 have to do a lot of testing to find it. 365 If you are lucky, you may manage to find a file that either can't be sent 366 across your network or that takes much longer to transfer than other 367 similar length files. 368 You can then examine this file for repeated patterns that you can test 369 using the \fB-p\fR option of \fBping\fR. 370 .SH "TTL DETAILS" 371 .PP 372 The TTL value of an IP packet represents the maximum number of IP routers 373 that the packet can go through before being thrown away. 374 In current practice you can expect each router in the Internet to decrement 375 the TTL field by exactly one. 376 .PP 377 The TCP/IP specification states that the TTL field for TCP 378 packets should be set to 60, but many systems use smaller values 379 (4.3 BSD uses 30, 4.2 used 15). 380 .PP 381 The maximum possible value of this field is 255, and most Unix systems set 382 the TTL field of ICMP ECHO_REQUEST packets to 255. 383 This is why you will find you can ``ping'' some hosts, but not reach them 384 with 385 \fBtelnet\fR(1) 386 or 387 \fBftp\fR(1). 388 .PP 389 In normal operation ping prints the TTL value from the packet it receives. 390 When a remote system receives a ping packet, it can do one of three things 391 with the TTL field in its response: 392 .TP 0.2i 393 \(bu 394 Not change it; this is what Berkeley Unix systems did before the 395 4.3BSD Tahoe release. In this case the TTL value in the received packet 396 will be 255 minus the number of routers in the round-trip path. 397 .TP 0.2i 398 \(bu 399 Set it to 255; this is what current Berkeley Unix systems do. 400 In this case the TTL value in the received packet will be 255 minus the 401 number of routers in the path \fBfrom\fR 402 the remote system \fBto\fR the \fBping\fRing host. 403 .TP 0.2i 404 \(bu 405 Set it to some other value. Some machines use the same value for 406 ICMP packets that they use for TCP packets, for example either 30 or 60. 407 Others may use completely wild values. 408 .SH "BUGS" 409 .TP 0.2i 410 \(bu 411 Many Hosts and Gateways ignore the RECORD_ROUTE option. 412 .TP 0.2i 413 \(bu 414 The maximum IP header length is too small for options like 415 RECORD_ROUTE to be completely useful. 416 There's not much that can be done about this, however. 417 .TP 0.2i 418 \(bu 419 Flood pinging is not recommended in general, and flood pinging the 420 broadcast address should only be done under very controlled conditions. 421 .SH "SEE ALSO" 422 .PP 423 \fBnetstat\fR(1), 424 \fBifconfig\fR(8). 425 .SH "HISTORY" 426 .PP 427 The \fBping\fR command appeared in 4.3BSD. 428 .PP 429 The version described here is its descendant specific to Linux. 430 .PP 431 As of version s20150815, the \fBping6\fR binary doesn't exist anymore. 432 It has been merged into \fBping\fR. Creating a symlink named 433 \fBping6\fR pointing to \fBping\fR will result in the same 434 funcionality as before. 435 .SH "SECURITY" 436 .PP 437 \fBping\fR requires CAP_NET_RAW capability 438 to be executed 1) if the program is used for non-echo queries 439 (See \fB-N\fR option), or 2) if kernel does not 440 support non-raw ICMP sockets, or 3) if the user is not allowed 441 to create an ICMP echo socket. The program may be used as 442 set-uid root. 443 .SH "AVAILABILITY" 444 .PP 445 \fBping\fR is part of \fIiputils\fR package 446 and the latest versions are available in source form at 447 http://www.skbuff.net/iputils/iputils-current.tar.bz2. -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r1.html iputils-s20161105/doc/r1.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >System Manager's Manual: iputils</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="NEXT" 10 TITLE="ping" 11 HREF="r3.html"></HEAD 12 ><BODY 13 CLASS="REFERENCE" 14 BGCOLOR="#FFFFFF" 15 TEXT="#000000" 16 LINK="#0000FF" 17 VLINK="#840084" 18 ALINK="#0000FF" 19 ><DIV 20 CLASS="NAVHEADER" 21 ><TABLE 22 SUMMARY="Header navigation table" 23 WIDTH="100%" 24 BORDER="0" 25 CELLPADDING="0" 26 CELLSPACING="0" 27 ><TR 28 ><TD 29 WIDTH="10%" 30 ALIGN="left" 31 VALIGN="bottom" 32 > </TD 33 ><TD 34 WIDTH="80%" 35 ALIGN="center" 36 VALIGN="bottom" 37 ></TD 38 ><TD 39 WIDTH="10%" 40 ALIGN="right" 41 VALIGN="bottom" 42 ><A 43 HREF="r3.html" 44 ACCESSKEY="N" 45 >Next >>></A 46 ></TD 47 ></TR 48 ></TABLE 49 ><HR 50 ALIGN="LEFT" 51 WIDTH="100%"></DIV 52 ><DIV 53 CLASS="REFERENCE" 54 ><A 55 NAME="INDEX" 56 ></A 57 ><DIV 58 CLASS="TITLEPAGE" 59 ><H1 60 CLASS="TITLE" 61 >I. System Manager's Manual: iputils</H1 62 ><DIV 63 CLASS="TOC" 64 ><DL 65 ><DT 66 ><B 67 >Table of Contents</B 68 ></DT 69 ><DT 70 ><A 71 HREF="r3.html" 72 >ping</A 73 > -- send ICMP ECHO_REQUEST to network hosts</DT 74 ><DT 75 ><A 76 HREF="r483.html" 77 >arping</A 78 > -- send ARP REQUEST to a neighbour host</DT 79 ><DT 80 ><A 81 HREF="r641.html" 82 >clockdiff</A 83 > -- measure clock difference between hosts</DT 84 ><DT 85 ><A 86 HREF="r736.html" 87 >rarpd</A 88 > -- answer RARP REQUESTs</DT 89 ><DT 90 ><A 91 HREF="r835.html" 92 >tracepath</A 93 > -- traces path to a network host discovering MTU along this path</DT 94 ><DT 95 ><A 96 HREF="r942.html" 97 >traceroute6</A 98 > -- traces path to a network host</DT 99 ><DT 100 ><A 101 HREF="r1007.html" 102 >tftpd</A 103 > -- Trivial File Transfer Protocol server</DT 104 ><DT 105 ><A 106 HREF="r1080.html" 107 >ninfod</A 108 > -- Respond to IPv6 Node Information Queries</DT 109 ><DT 110 ><A 111 HREF="r1149.html" 112 >rdisc</A 113 > -- network router discovery daemon</DT 114 ><DT 115 ><A 116 HREF="r1293.html" 117 >pg3</A 118 > -- send stream of UDP packets</DT 119 ></DL 120 ></DIV 121 ></DIV 122 ></DIV 123 ><DIV 124 CLASS="NAVFOOTER" 125 ><HR 126 ALIGN="LEFT" 127 WIDTH="100%"><TABLE 128 SUMMARY="Footer navigation table" 129 WIDTH="100%" 130 BORDER="0" 131 CELLPADDING="0" 132 CELLSPACING="0" 133 ><TR 134 ><TD 135 WIDTH="33%" 136 ALIGN="left" 137 VALIGN="top" 138 > </TD 139 ><TD 140 WIDTH="34%" 141 ALIGN="center" 142 VALIGN="top" 143 > </TD 144 ><TD 145 WIDTH="33%" 146 ALIGN="right" 147 VALIGN="top" 148 ><A 149 HREF="r3.html" 150 ACCESSKEY="N" 151 >Next >>></A 152 ></TD 153 ></TR 154 ><TR 155 ><TD 156 WIDTH="33%" 157 ALIGN="left" 158 VALIGN="top" 159 > </TD 160 ><TD 161 WIDTH="34%" 162 ALIGN="center" 163 VALIGN="top" 164 > </TD 165 ><TD 166 WIDTH="33%" 167 ALIGN="right" 168 VALIGN="top" 169 >ping</TD 170 ></TR 171 ></TABLE 172 ></DIV 173 ></BODY 174 ></HTML 175 > 176 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r1007.html iputils-s20161105/doc/r1007.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >tftpd</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="System Manager's Manual: iputils" 11 HREF="r1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="traceroute6" 14 HREF="r942.html"><LINK 15 REL="NEXT" 16 TITLE="ninfod" 17 HREF="r1080.html"></HEAD 18 ><BODY 19 CLASS="REFENTRY" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >System Manager's Manual: iputils</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="r942.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="r1080.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><H1 69 ><A 70 NAME="TFTPD" 71 ></A 72 >tftpd</H1 73 ><DIV 74 CLASS="REFNAMEDIV" 75 ><A 76 NAME="AEN1012" 77 ></A 78 ><H2 79 >Name</H2 80 >tftpd -- Trivial File Transfer Protocol server</DIV 81 ><DIV 82 CLASS="REFSYNOPSISDIV" 83 ><A 84 NAME="AEN1015" 85 ></A 86 ><H2 87 >Synopsis</H2 88 ><P 89 ><B 90 CLASS="COMMAND" 91 >tftpd</B 92 > {<TT 93 CLASS="REPLACEABLE" 94 ><I 95 >directory</I 96 ></TT 97 >}</P 98 ></DIV 99 ><DIV 100 CLASS="REFSECT1" 101 ><A 102 NAME="AEN1020" 103 ></A 104 ><H2 105 >DESCRIPTION</H2 106 ><P 107 ><B 108 CLASS="COMMAND" 109 >tftpd</B 110 > is a server which supports the DARPA 111 Trivial File Transfer Protocol 112 (<A 113 HREF="http://tools.ietf.org/rfc/rfc1350.txt" 114 TARGET="_top" 115 >RFC1350</A 116 >). 117 The TFTP server is started 118 by <SPAN 119 CLASS="CITEREFENTRY" 120 ><SPAN 121 CLASS="REFENTRYTITLE" 122 >inetd</SPAN 123 >(8)</SPAN 124 >.</P 125 ><P 126 ><TT 127 CLASS="REPLACEABLE" 128 ><I 129 >directory</I 130 ></TT 131 > is required argument; if it is not given 132 <B 133 CLASS="COMMAND" 134 >tftpd</B 135 > aborts. This path is prepended to any file name requested 136 via TFTP protocol, effectively chrooting <B 137 CLASS="COMMAND" 138 >tftpd</B 139 > to this directory. 140 File names are validated not to escape out of this directory, however 141 administrator may configure such escape using symbolic links.</P 142 ><P 143 >It is in difference of variants of <B 144 CLASS="COMMAND" 145 >tftpd</B 146 > usually distributed 147 with unix-like systems, which take a list of directories and match 148 file names to start from one of given prefixes or to some random 149 default, when no arguments were given. There are two reasons not to 150 behave in this way: first, it is inconvenient, clients are not expected 151 to know something about layout of filesystem on server host. 152 And second, TFTP protocol is not a tool for browsing of server's filesystem, 153 it is just an agent allowing to boot dumb clients. </P 154 ><P 155 >In the case when <B 156 CLASS="COMMAND" 157 >tftpd</B 158 > is used together with 159 <A 160 HREF="r736.html" 161 ><SPAN 162 CLASS="CITEREFENTRY" 163 ><SPAN 164 CLASS="REFENTRYTITLE" 165 >rarpd</SPAN 166 >(8)</SPAN 167 ></A 168 >, 169 tftp directories in these services should coincide and it is expected 170 that each client booted via TFTP has boot image corresponding 171 its IP address with an architecture suffix following Sun Microsystems 172 conventions. See 173 <A 174 HREF="r736.html" 175 ><SPAN 176 CLASS="CITEREFENTRY" 177 ><SPAN 178 CLASS="REFENTRYTITLE" 179 >rarpd</SPAN 180 >(8)</SPAN 181 ></A 182 > 183 for more details.</P 184 ></DIV 185 ><DIV 186 CLASS="REFSECT1" 187 ><A 188 NAME="AEN1044" 189 ></A 190 ><H2 191 >SECURITY</H2 192 ><P 193 >TFTP protocol does not provide any authentication. 194 Due to this capital flaw <B 195 CLASS="COMMAND" 196 >tftpd</B 197 > is not able to restrict 198 access to files and will allow only publically readable 199 files to be accessed. Files may be written only if they already 200 exist and are publically writable.</P 201 ><P 202 >Impact is evident, directory exported via TFTP <I 203 CLASS="EMPHASIS" 204 >must not</I 205 > 206 contain sensitive information of any kind, everyone is allowed 207 to read it as soon as a client is allowed. Boot images do not contain 208 such information as rule, however you should think twice before 209 publishing f.e. Cisco IOS config files via TFTP, they contain 210 <I 211 CLASS="EMPHASIS" 212 >unencrypted</I 213 > passwords and may contain some information 214 about the network, which you were not going to make public.</P 215 ><P 216 >The <B 217 CLASS="COMMAND" 218 >tftpd</B 219 > server should be executed by <B 220 CLASS="COMMAND" 221 >inetd</B 222 > 223 with dropped root privileges, namely with a user ID giving minimal 224 access to files published in tftp directory. If it is executed 225 as superuser occasionally, <B 226 CLASS="COMMAND" 227 >tftpd</B 228 > drops its UID and GID 229 to 65534, which is most likely not the thing which you expect. 230 However, this is not very essential; remember, only files accessible 231 for everyone can be read or written via TFTP.</P 232 ></DIV 233 ><DIV 234 CLASS="REFSECT1" 235 ><A 236 NAME="AEN1055" 237 ></A 238 ><H2 239 >SEE ALSO</H2 240 ><P 241 ><A 242 HREF="r736.html" 243 ><SPAN 244 CLASS="CITEREFENTRY" 245 ><SPAN 246 CLASS="REFENTRYTITLE" 247 >rarpd</SPAN 248 >(8)</SPAN 249 ></A 250 >, 251 <SPAN 252 CLASS="CITEREFENTRY" 253 ><SPAN 254 CLASS="REFENTRYTITLE" 255 >tftp</SPAN 256 >(1)</SPAN 257 >, 258 <SPAN 259 CLASS="CITEREFENTRY" 260 ><SPAN 261 CLASS="REFENTRYTITLE" 262 >inetd</SPAN 263 >(8)</SPAN 264 >.</P 265 ></DIV 266 ><DIV 267 CLASS="REFSECT1" 268 ><A 269 NAME="AEN1068" 270 ></A 271 ><H2 272 >HISTORY</H2 273 ><P 274 >The <B 275 CLASS="COMMAND" 276 >tftpd</B 277 > command appeared in 4.2BSD. The source in iputils 278 is cleaned up both syntactically (ANSIized) and semantically (UDP socket IO).</P 279 ><P 280 >It is distributed with iputils mostly as good demo of an interesting feature 281 (<CODE 282 CLASS="CONSTANT" 283 >MSG_CONFIRM</CODE 284 >) allowing to boot long images by dumb clients 285 not answering ARP requests until they are finally booted. 286 However, this is full functional and can be used in production.</P 287 ></DIV 288 ><DIV 289 CLASS="REFSECT1" 290 ><A 291 NAME="AEN1074" 292 ></A 293 ><H2 294 >AVAILABILITY</H2 295 ><P 296 ><B 297 CLASS="COMMAND" 298 >tftpd</B 299 > is part of <TT 300 CLASS="FILENAME" 301 >iputils</TT 302 > package 303 and the latest versions are available in source form at 304 <A 305 HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2" 306 TARGET="_top" 307 >http://www.skbuff.net/iputils/iputils-current.tar.bz2</A 308 >.</P 309 ></DIV 310 ><DIV 311 CLASS="NAVFOOTER" 312 ><HR 313 ALIGN="LEFT" 314 WIDTH="100%"><TABLE 315 SUMMARY="Footer navigation table" 316 WIDTH="100%" 317 BORDER="0" 318 CELLPADDING="0" 319 CELLSPACING="0" 320 ><TR 321 ><TD 322 WIDTH="33%" 323 ALIGN="left" 324 VALIGN="top" 325 ><A 326 HREF="r942.html" 327 ACCESSKEY="P" 328 ><<< Previous</A 329 ></TD 330 ><TD 331 WIDTH="34%" 332 ALIGN="center" 333 VALIGN="top" 334 ><A 335 HREF="r1.html" 336 ACCESSKEY="H" 337 >Home</A 338 ></TD 339 ><TD 340 WIDTH="33%" 341 ALIGN="right" 342 VALIGN="top" 343 ><A 344 HREF="r1080.html" 345 ACCESSKEY="N" 346 >Next >>></A 347 ></TD 348 ></TR 349 ><TR 350 ><TD 351 WIDTH="33%" 352 ALIGN="left" 353 VALIGN="top" 354 >traceroute6</TD 355 ><TD 356 WIDTH="34%" 357 ALIGN="center" 358 VALIGN="top" 359 > </TD 360 ><TD 361 WIDTH="33%" 362 ALIGN="right" 363 VALIGN="top" 364 >ninfod</TD 365 ></TR 366 ></TABLE 367 ></DIV 368 ></BODY 369 ></HTML 370 > 371 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r1080.html iputils-s20161105/doc/r1080.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >ninfod</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="System Manager's Manual: iputils" 11 HREF="r1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="tftpd" 14 HREF="r1007.html"><LINK 15 REL="NEXT" 16 TITLE="rdisc" 17 HREF="r1149.html"></HEAD 18 ><BODY 19 CLASS="REFENTRY" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >System Manager's Manual: iputils</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="r1007.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="r1149.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><H1 69 ><A 70 NAME="NINFOD" 71 ></A 72 >ninfod</H1 73 ><DIV 74 CLASS="REFNAMEDIV" 75 ><A 76 NAME="AEN1085" 77 ></A 78 ><H2 79 >Name</H2 80 >ninfod -- Respond to IPv6 Node Information Queries</DIV 81 ><DIV 82 CLASS="REFSYNOPSISDIV" 83 ><A 84 NAME="AEN1088" 85 ></A 86 ><H2 87 >Synopsis</H2 88 ><P 89 ><B 90 CLASS="COMMAND" 91 >ninfod</B 92 > [<CODE 93 CLASS="OPTION" 94 >-dhv</CODE 95 >] [-p <TT 96 CLASS="REPLACEABLE" 97 ><I 98 >pidfile</I 99 ></TT 100 >] [-u <TT 101 CLASS="REPLACEABLE" 102 ><I 103 >user</I 104 ></TT 105 >]</P 106 ></DIV 107 ><DIV 108 CLASS="REFSECT1" 109 ><A 110 NAME="AEN1097" 111 ></A 112 ><H2 113 >DESCRIPTION</H2 114 ><P 115 >Responds to <A 116 HREF="http://tools.ietf.org/rfc/rfc4620.txt" 117 TARGET="_top" 118 >IPv6 Node Information Queries (RFC4620)</A 119 > from clients. 120 Queries can be sent by various implementations of <B 121 CLASS="COMMAND" 122 >ping6</B 123 > command.</P 124 ></DIV 125 ><DIV 126 CLASS="REFSECT1" 127 ><A 128 NAME="AEN1102" 129 ></A 130 ><H2 131 >OPTIONS</H2 132 ><P 133 ></P 134 ><DIV 135 CLASS="VARIABLELIST" 136 ><DL 137 ><DT 138 ><CODE 139 CLASS="OPTION" 140 >-a</CODE 141 ></DT 142 ><DD 143 ><P 144 >Debug mode. Do not go background. 145 </P 146 ></DD 147 ><DT 148 ><CODE 149 CLASS="OPTION" 150 >-h</CODE 151 ></DT 152 ><DD 153 ><P 154 >Show help. 155 </P 156 ></DD 157 ><DT 158 ><CODE 159 CLASS="OPTION" 160 >-v</CODE 161 ></DT 162 ><DD 163 ><P 164 >Verbose mode. 165 </P 166 ></DD 167 ><DT 168 ><CODE 169 CLASS="OPTION" 170 >-u <TT 171 CLASS="REPLACEABLE" 172 ><I 173 >user</I 174 ></TT 175 ></CODE 176 ></DT 177 ><DD 178 ><P 179 >Run as another user. 180 <TT 181 CLASS="REPLACEABLE" 182 ><I 183 >user</I 184 ></TT 185 > can either be username or user ID. 186 </P 187 ></DD 188 ><DT 189 ><CODE 190 CLASS="OPTION" 191 >-p <TT 192 CLASS="REPLACEABLE" 193 ><I 194 >pidfile</I 195 ></TT 196 ></CODE 197 ></DT 198 ><DD 199 ><P 200 >File for process-id storage. 201 <TT 202 CLASS="REPLACEABLE" 203 ><I 204 >user</I 205 ></TT 206 > is required to be able to create the file. 207 </P 208 ></DD 209 ></DL 210 ></DIV 211 ></DIV 212 ><DIV 213 CLASS="REFSECT1" 214 ><A 215 NAME="AEN1134" 216 ></A 217 ><H2 218 >SEE ALSO</H2 219 ><P 220 ><A 221 HREF="r3.html" 222 ><SPAN 223 CLASS="CITEREFENTRY" 224 ><SPAN 225 CLASS="REFENTRYTITLE" 226 >ping</SPAN 227 >(8)</SPAN 228 ></A 229 >.</P 230 ></DIV 231 ><DIV 232 CLASS="REFSECT1" 233 ><A 234 NAME="AEN1141" 235 ></A 236 ><H2 237 >AUTHOR</H2 238 ><P 239 ><B 240 CLASS="COMMAND" 241 >ninfod</B 242 > was written by USAGI/WIDE Project.</P 243 ></DIV 244 ><DIV 245 CLASS="REFSECT1" 246 ><A 247 NAME="AEN1145" 248 ></A 249 ><H2 250 >COPYING</H2 251 ><P 252 ><P 253 CLASS="LITERALLAYOUT" 254 >Copyright (C) 2012 YOSHIFUJI Hideaki.<br> 255 Copyright (C) 2002 USAGI/WIDE Project.<br> 256 All rights reserved.<br> 257 <br> 258 Redistribution and use in source and binary forms, with or without<br> 259 modification, are permitted provided that the following conditions<br> 260 are met:<br> 261 1. Redistributions of source code must retain the above copyright<br> 262 notice, this list of conditions and the following disclaimer.<br> 263 2. Redistributions in binary form must reproduce the above copyright<br> 264 notice, this list of conditions and the following disclaimer in the<br> 265 documentation and/or other materials provided with the distribution.<br> 266 3. Neither the name of the project nor the names of its contributors<br> 267 may be used to endorse or promote products derived from this software<br> 268 without specific prior written permission.<br> 269 <br> 270 THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND<br> 271 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE<br> 272 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE<br> 273 ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE<br> 274 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL<br> 275 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS<br> 276 OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)<br> 277 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT<br> 278 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY<br> 279 OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF<br> 280 SUCH DAMAGE.</P 281 ></P 282 ></DIV 283 ><DIV 284 CLASS="NAVFOOTER" 285 ><HR 286 ALIGN="LEFT" 287 WIDTH="100%"><TABLE 288 SUMMARY="Footer navigation table" 289 WIDTH="100%" 290 BORDER="0" 291 CELLPADDING="0" 292 CELLSPACING="0" 293 ><TR 294 ><TD 295 WIDTH="33%" 296 ALIGN="left" 297 VALIGN="top" 298 ><A 299 HREF="r1007.html" 300 ACCESSKEY="P" 301 ><<< Previous</A 302 ></TD 303 ><TD 304 WIDTH="34%" 305 ALIGN="center" 306 VALIGN="top" 307 ><A 308 HREF="r1.html" 309 ACCESSKEY="H" 310 >Home</A 311 ></TD 312 ><TD 313 WIDTH="33%" 314 ALIGN="right" 315 VALIGN="top" 316 ><A 317 HREF="r1149.html" 318 ACCESSKEY="N" 319 >Next >>></A 320 ></TD 321 ></TR 322 ><TR 323 ><TD 324 WIDTH="33%" 325 ALIGN="left" 326 VALIGN="top" 327 >tftpd</TD 328 ><TD 329 WIDTH="34%" 330 ALIGN="center" 331 VALIGN="top" 332 > </TD 333 ><TD 334 WIDTH="33%" 335 ALIGN="right" 336 VALIGN="top" 337 >rdisc</TD 338 ></TR 339 ></TABLE 340 ></DIV 341 ></BODY 342 ></HTML 343 > 344 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r1149.html iputils-s20161105/doc/r1149.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >rdisc</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="System Manager's Manual: iputils" 11 HREF="r1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="ninfod" 14 HREF="r1080.html"><LINK 15 REL="NEXT" 16 TITLE="pg3" 17 HREF="r1293.html"></HEAD 18 ><BODY 19 CLASS="REFENTRY" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >System Manager's Manual: iputils</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="r1080.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="r1293.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><H1 69 ><A 70 NAME="RDISC" 71 ></A 72 >rdisc</H1 73 ><DIV 74 CLASS="REFNAMEDIV" 75 ><A 76 NAME="AEN1154" 77 ></A 78 ><H2 79 >Name</H2 80 >rdisc -- network router discovery daemon</DIV 81 ><DIV 82 CLASS="REFSYNOPSISDIV" 83 ><A 84 NAME="AEN1157" 85 ></A 86 ><H2 87 >Synopsis</H2 88 ><P 89 ><B 90 CLASS="COMMAND" 91 >rdisc</B 92 > [<CODE 93 CLASS="OPTION" 94 >-abdfrstvV</CODE 95 >] [-p <TT 96 CLASS="REPLACEABLE" 97 ><I 98 >preference</I 99 ></TT 100 >] [-T <TT 101 CLASS="REPLACEABLE" 102 ><I 103 >max_interval</I 104 ></TT 105 >] [<TT 106 CLASS="REPLACEABLE" 107 ><I 108 >send_address</I 109 ></TT 110 >] [<TT 111 CLASS="REPLACEABLE" 112 ><I 113 >receive_address</I 114 ></TT 115 >]</P 116 ></DIV 117 ><DIV 118 CLASS="REFSECT1" 119 ><A 120 NAME="AEN1170" 121 ></A 122 ><H2 123 >DESCRIPTION</H2 124 ><P 125 ><B 126 CLASS="COMMAND" 127 >rdisc</B 128 > implements client side of the ICMP router discover protocol. 129 <B 130 CLASS="COMMAND" 131 >rdisc</B 132 > is invoked at boot time to populate the network 133 routing tables with default routes. </P 134 ><P 135 ><B 136 CLASS="COMMAND" 137 >rdisc</B 138 > listens on the ALL_HOSTS (224.0.0.1) multicast address 139 (or <TT 140 CLASS="REPLACEABLE" 141 ><I 142 >receive_address</I 143 ></TT 144 > provided it is given) 145 for ROUTER_ADVERTISE messages from routers. The received 146 messages are handled by first ignoring those listed router addresses 147 with which the host does not share a network. Among the remaining addresses 148 the ones with the highest preference are selected as default routers 149 and a default route is entered in the kernel routing table 150 for each one of them.</P 151 ><P 152 >Optionally, <B 153 CLASS="COMMAND" 154 >rdisc</B 155 > can avoid waiting for routers to announce 156 themselves by sending out a few ROUTER_SOLICITATION messages 157 to the ALL_ROUTERS (224.0.0.2) multicast address 158 (or <TT 159 CLASS="REPLACEABLE" 160 ><I 161 >send_address</I 162 ></TT 163 > provided it is given) 164 when it is started.</P 165 ><P 166 >A timer is associated with each router address and the address will 167 no longer be considered for inclusion in the the routing tables if the 168 timer expires before a new 169 <I 170 CLASS="EMPHASIS" 171 >advertise</I 172 > message is received from the router. 173 The address will also be excluded from consideration if the host receives an 174 <I 175 CLASS="EMPHASIS" 176 >advertise</I 177 > 178 message with the preference being maximally negative.</P 179 ><P 180 >Server side of router discovery protocol is supported by Cisco IOS 181 and by any more or less complete UNIX routing daemon, f.e <B 182 CLASS="COMMAND" 183 >gated</B 184 >. 185 Or, <B 186 CLASS="COMMAND" 187 >rdisc</B 188 > can act as responder, if compiled with -DRDISC_SERVER.</P 189 ></DIV 190 ><DIV 191 CLASS="REFSECT1" 192 ><A 193 NAME="AEN1187" 194 ></A 195 ><H2 196 >OPTIONS</H2 197 ><P 198 ></P 199 ><DIV 200 CLASS="VARIABLELIST" 201 ><DL 202 ><DT 203 ><CODE 204 CLASS="OPTION" 205 >-a</CODE 206 ></DT 207 ><DD 208 ><P 209 >Accept all routers independently of the preference they have in their 210 <I 211 CLASS="EMPHASIS" 212 >advertise</I 213 > messages. 214 Normally <B 215 CLASS="COMMAND" 216 >rdisc</B 217 > only accepts (and enters in the kernel routing 218 tables) the router or routers with the highest preference. 219 </P 220 ></DD 221 ><DT 222 ><CODE 223 CLASS="OPTION" 224 >-b</CODE 225 ></DT 226 ><DD 227 ><P 228 >Opposite to <CODE 229 CLASS="OPTION" 230 >-a</CODE 231 >, i.e. install only router with the best 232 preference value. It is default behaviour. 233 </P 234 ></DD 235 ><DT 236 ><CODE 237 CLASS="OPTION" 238 >-d</CODE 239 ></DT 240 ><DD 241 ><P 242 >Send debugging messages to syslog. 243 </P 244 ></DD 245 ><DT 246 ><CODE 247 CLASS="OPTION" 248 >-f</CODE 249 ></DT 250 ><DD 251 ><P 252 >Run <B 253 CLASS="COMMAND" 254 >rdisc</B 255 > forever even if no routers are found. 256 Normally <B 257 CLASS="COMMAND" 258 >rdisc</B 259 > gives up if it has not received any 260 <I 261 CLASS="EMPHASIS" 262 >advertise</I 263 > message after after soliciting three times, 264 in which case it exits with a non-zero exit code. 265 If <CODE 266 CLASS="OPTION" 267 >-f</CODE 268 > is not specified in the first form then 269 <CODE 270 CLASS="OPTION" 271 >-s</CODE 272 > must be specified. 273 </P 274 ></DD 275 ><DT 276 ><CODE 277 CLASS="OPTION" 278 >-r</CODE 279 ></DT 280 ><DD 281 ><P 282 >Responder mode, available only if compiled with -DRDISC_SERVER. 283 </P 284 ></DD 285 ><DT 286 ><CODE 287 CLASS="OPTION" 288 >-s</CODE 289 ></DT 290 ><DD 291 ><P 292 >Send three <I 293 CLASS="EMPHASIS" 294 >solicitation</I 295 > messages initially to quickly discover 296 the routers when the system is booted. 297 When <CODE 298 CLASS="OPTION" 299 >-s</CODE 300 > is specified <B 301 CLASS="COMMAND" 302 >rdisc</B 303 > 304 exits with a non-zero exit code if it can not find any routers. 305 This can be overridden with the <CODE 306 CLASS="OPTION" 307 >-f</CODE 308 > option. 309 </P 310 ></DD 311 ><DT 312 ><CODE 313 CLASS="OPTION" 314 >-p <TT 315 CLASS="REPLACEABLE" 316 ><I 317 >preference</I 318 ></TT 319 ></CODE 320 ></DT 321 ><DD 322 ><P 323 >Set preference in advertisement. 324 Available only with -r option. 325 </P 326 ></DD 327 ><DT 328 ><CODE 329 CLASS="OPTION" 330 >-T <TT 331 CLASS="REPLACEABLE" 332 ><I 333 >max_interval</I 334 ></TT 335 ></CODE 336 ></DT 337 ><DD 338 ><P 339 >Set maximum advertisement interval in seconds. Default is 600 secs. 340 Available only with -r option. 341 </P 342 ></DD 343 ><DT 344 ><CODE 345 CLASS="OPTION" 346 >-t</CODE 347 ></DT 348 ><DD 349 ><P 350 >Test mode. Do not go to background. 351 </P 352 ></DD 353 ><DT 354 ><CODE 355 CLASS="OPTION" 356 >-v</CODE 357 ></DT 358 ><DD 359 ><P 360 >Be verbose i.e. send lots of debugging messages to syslog. 361 </P 362 ></DD 363 ><DT 364 ><CODE 365 CLASS="OPTION" 366 >-V</CODE 367 ></DT 368 ><DD 369 ><P 370 >Print version and exit. 371 </P 372 ></DD 373 ></DL 374 ></DIV 375 ></DIV 376 ><DIV 377 CLASS="REFSECT1" 378 ><A 379 NAME="AEN1259" 380 ></A 381 ><H2 382 >HISTORY</H2 383 ><P 384 >This program was developed by Sun Microsystems (see copyright 385 notice in source file). It was ported to Linux by 386 <A 387 HREF="mailto:kuznet@ms2.inr.ac.ru" 388 TARGET="_top" 389 >Alexey Kuznetsov 390 <kuznet@ms2.inr.ac.ru></A 391 >. 392 It is now maintained by 393 <A 394 HREF="mailto:yoshfuji@skbuff.net" 395 TARGET="_top" 396 >YOSHIFUJI Hideaki 397 <yoshfuji@skbuff.net></A 398 >.</P 399 ></DIV 400 ><DIV 401 CLASS="REFSECT1" 402 ><A 403 NAME="AEN1264" 404 ></A 405 ><H2 406 >SEE ALSO</H2 407 ><P 408 ><SPAN 409 CLASS="CITEREFENTRY" 410 ><SPAN 411 CLASS="REFENTRYTITLE" 412 >icmp</SPAN 413 >(7)</SPAN 414 >, 415 <SPAN 416 CLASS="CITEREFENTRY" 417 ><SPAN 418 CLASS="REFENTRYTITLE" 419 >inet</SPAN 420 >(7)</SPAN 421 >, 422 <A 423 HREF="r3.html" 424 ><SPAN 425 CLASS="CITEREFENTRY" 426 ><SPAN 427 CLASS="REFENTRYTITLE" 428 >ping</SPAN 429 >(8)</SPAN 430 ></A 431 >.</P 432 ></DIV 433 ><DIV 434 CLASS="REFSECT1" 435 ><A 436 NAME="AEN1277" 437 ></A 438 ><H2 439 >REFERENCES</H2 440 ><P 441 >Deering, S.E.,ed "ICMP Router Discovery Messages", 442 <A 443 HREF="http://tools.ietf.org/rfc/rfc1256.txt" 444 TARGET="_top" 445 >RFC1256</A 446 >, Network Information Center, SRI International, 447 Menlo Park, Calif., September 1991.</P 448 ></DIV 449 ><DIV 450 CLASS="REFSECT1" 451 ><A 452 NAME="AEN1281" 453 ></A 454 ><H2 455 >SECURITY</H2 456 ><P 457 ><B 458 CLASS="COMMAND" 459 >rdisc</B 460 > requires <CODE 461 CLASS="CONSTANT" 462 >CAP_NET_RAW</CODE 463 > to listen 464 and send ICMP messages and capability <CODE 465 CLASS="CONSTANT" 466 >CAP_NET_ADMIN</CODE 467 > 468 to update routing tables. </P 469 ></DIV 470 ><DIV 471 CLASS="REFSECT1" 472 ><A 473 NAME="AEN1287" 474 ></A 475 ><H2 476 >AVAILABILITY</H2 477 ><P 478 ><B 479 CLASS="COMMAND" 480 >rdisc</B 481 > is part of <TT 482 CLASS="FILENAME" 483 >iputils</TT 484 > package 485 and the latest versions are available in source form at 486 <A 487 HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2" 488 TARGET="_top" 489 >http://www.skbuff.net/iputils/iputils-current.tar.bz2</A 490 >.</P 491 ></DIV 492 ><DIV 493 CLASS="NAVFOOTER" 494 ><HR 495 ALIGN="LEFT" 496 WIDTH="100%"><TABLE 497 SUMMARY="Footer navigation table" 498 WIDTH="100%" 499 BORDER="0" 500 CELLPADDING="0" 501 CELLSPACING="0" 502 ><TR 503 ><TD 504 WIDTH="33%" 505 ALIGN="left" 506 VALIGN="top" 507 ><A 508 HREF="r1080.html" 509 ACCESSKEY="P" 510 ><<< Previous</A 511 ></TD 512 ><TD 513 WIDTH="34%" 514 ALIGN="center" 515 VALIGN="top" 516 ><A 517 HREF="r1.html" 518 ACCESSKEY="H" 519 >Home</A 520 ></TD 521 ><TD 522 WIDTH="33%" 523 ALIGN="right" 524 VALIGN="top" 525 ><A 526 HREF="r1293.html" 527 ACCESSKEY="N" 528 >Next >>></A 529 ></TD 530 ></TR 531 ><TR 532 ><TD 533 WIDTH="33%" 534 ALIGN="left" 535 VALIGN="top" 536 >ninfod</TD 537 ><TD 538 WIDTH="34%" 539 ALIGN="center" 540 VALIGN="top" 541 > </TD 542 ><TD 543 WIDTH="33%" 544 ALIGN="right" 545 VALIGN="top" 546 >pg3</TD 547 ></TR 548 ></TABLE 549 ></DIV 550 ></BODY 551 ></HTML 552 > 553 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r1293.html iputils-s20161105/doc/r1293.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >pg3</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="System Manager's Manual: iputils" 11 HREF="r1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="rdisc" 14 HREF="r1149.html"></HEAD 15 ><BODY 16 CLASS="REFENTRY" 17 BGCOLOR="#FFFFFF" 18 TEXT="#000000" 19 LINK="#0000FF" 20 VLINK="#840084" 21 ALINK="#0000FF" 22 ><DIV 23 CLASS="NAVHEADER" 24 ><TABLE 25 SUMMARY="Header navigation table" 26 WIDTH="100%" 27 BORDER="0" 28 CELLPADDING="0" 29 CELLSPACING="0" 30 ><TR 31 ><TH 32 COLSPAN="3" 33 ALIGN="center" 34 >System Manager's Manual: iputils</TH 35 ></TR 36 ><TR 37 ><TD 38 WIDTH="10%" 39 ALIGN="left" 40 VALIGN="bottom" 41 ><A 42 HREF="r1149.html" 43 ACCESSKEY="P" 44 ><<< Previous</A 45 ></TD 46 ><TD 47 WIDTH="80%" 48 ALIGN="center" 49 VALIGN="bottom" 50 ></TD 51 ><TD 52 WIDTH="10%" 53 ALIGN="right" 54 VALIGN="bottom" 55 > </TD 56 ></TR 57 ></TABLE 58 ><HR 59 ALIGN="LEFT" 60 WIDTH="100%"></DIV 61 ><H1 62 ><A 63 NAME="PG3" 64 ></A 65 >pg3</H1 66 ><DIV 67 CLASS="REFNAMEDIV" 68 ><A 69 NAME="AEN1298" 70 ></A 71 ><H2 72 >Name</H2 73 >pg3, ipg, pgset -- send stream of UDP packets</DIV 74 ><DIV 75 CLASS="REFSYNOPSISDIV" 76 ><A 77 NAME="AEN1301" 78 ></A 79 ><H2 80 >Synopsis</H2 81 ><P 82 ><B 83 CLASS="COMMAND" 84 >source ipg</B 85 ></P 86 ><P 87 ><B 88 CLASS="COMMAND" 89 >pg</B 90 ></P 91 ><P 92 ><B 93 CLASS="COMMAND" 94 >pgset</B 95 > {<TT 96 CLASS="REPLACEABLE" 97 ><I 98 >COMMAND</I 99 ></TT 100 >}</P 101 ></DIV 102 ><DIV 103 CLASS="REFSECT1" 104 ><A 105 NAME="AEN1310" 106 ></A 107 ><H2 108 >DESCRIPTION</H2 109 ><P 110 ><B 111 CLASS="COMMAND" 112 >ipg</B 113 > is not a program, it is script which should be sourced 114 to <B 115 CLASS="COMMAND" 116 >bash</B 117 >. When sourced it loads module <TT 118 CLASS="FILENAME" 119 >pg3</TT 120 > and 121 exports a few of functions accessible from parent shell. These macros 122 are <B 123 CLASS="COMMAND" 124 >pg</B 125 > to start packet injection and to get the results of run; 126 and <B 127 CLASS="COMMAND" 128 >pgset</B 129 > to setup packet generator.</P 130 ><P 131 ><B 132 CLASS="COMMAND" 133 >pgset</B 134 > can send the following commands to module <TT 135 CLASS="FILENAME" 136 >pg3</TT 137 >:</P 138 ></DIV 139 ><DIV 140 CLASS="REFSECT1" 141 ><A 142 NAME="AEN1321" 143 ></A 144 ><H2 145 >COMMAND</H2 146 ><P 147 ></P 148 ><DIV 149 CLASS="VARIABLELIST" 150 ><DL 151 ><DT 152 ><CODE 153 CLASS="OPTION" 154 >odev <TT 155 CLASS="REPLACEABLE" 156 ><I 157 >DEVICE</I 158 ></TT 159 ></CODE 160 ></DT 161 ><DD 162 ><P 163 >Name of Ethernet device to test. See 164 <A 165 HREF="r1293.html#PG3.WARNING" 166 >warning</A 167 > below. 168 </P 169 ></DD 170 ><DT 171 ><CODE 172 CLASS="OPTION" 173 >pkt_size <TT 174 CLASS="REPLACEABLE" 175 ><I 176 >BYTES</I 177 ></TT 178 ></CODE 179 ></DT 180 ><DD 181 ><P 182 >Size of packet to generate. The size includes all the headers: UDP, IP, 183 MAC, but does not account for overhead internal to medium, i.e. FCS 184 and various paddings. 185 </P 186 ></DD 187 ><DT 188 ><CODE 189 CLASS="OPTION" 190 >frags <TT 191 CLASS="REPLACEABLE" 192 ><I 193 >NUMBER</I 194 ></TT 195 ></CODE 196 ></DT 197 ><DD 198 ><P 199 >Each packet will contain <TT 200 CLASS="REPLACEABLE" 201 ><I 202 >NUMBER</I 203 ></TT 204 > of fragments. 205 Maximal amount for linux-2.4 is 6. Far not all the devices support 206 fragmented buffers. 207 </P 208 ></DD 209 ><DT 210 ><CODE 211 CLASS="OPTION" 212 >count <TT 213 CLASS="REPLACEABLE" 214 ><I 215 >NUMBER</I 216 ></TT 217 ></CODE 218 ></DT 219 ><DD 220 ><P 221 >Send stream of <TT 222 CLASS="REPLACEABLE" 223 ><I 224 >NUMBER</I 225 ></TT 226 > of packets and stop after this. 227 </P 228 ></DD 229 ><DT 230 ><CODE 231 CLASS="OPTION" 232 >ipg <TT 233 CLASS="REPLACEABLE" 234 ><I 235 >TIME</I 236 ></TT 237 ></CODE 238 ></DT 239 ><DD 240 ><P 241 >Introduce artificial delay between packets of <TT 242 CLASS="REPLACEABLE" 243 ><I 244 >TIME</I 245 ></TT 246 > 247 microseconds. 248 </P 249 ></DD 250 ><DT 251 ><CODE 252 CLASS="OPTION" 253 >dst <TT 254 CLASS="REPLACEABLE" 255 ><I 256 >IP_ADDRESS</I 257 ></TT 258 ></CODE 259 ></DT 260 ><DD 261 ><P 262 >Select IP destination where the stream is sent to. 263 Beware, never set this address at random. <B 264 CLASS="COMMAND" 265 >pg3</B 266 > is not a toy, 267 it creates really tough stream. Default value is 0.0.0.0. 268 </P 269 ></DD 270 ><DT 271 ><CODE 272 CLASS="OPTION" 273 >dst <TT 274 CLASS="REPLACEABLE" 275 ><I 276 >MAC_ADDRESS</I 277 ></TT 278 ></CODE 279 ></DT 280 ><DD 281 ><P 282 >Select MAC destination where the stream is sent to. 283 Default value is 00:00:00:00:00:00 in hope that this will not be received 284 by any node on LAN. 285 </P 286 ></DD 287 ><DT 288 ><CODE 289 CLASS="OPTION" 290 >stop</CODE 291 ></DT 292 ><DD 293 ><P 294 >Abort packet injection. 295 </P 296 ></DD 297 ></DL 298 ></DIV 299 ></DIV 300 ><DIV 301 CLASS="REFSECT1" 302 ><A 303 NAME="PG3.WARNING" 304 ></A 305 ><H2 306 >WARNING</H2 307 ><P 308 >When output device is set to some random device different 309 of hardware Ethernet device, <B 310 CLASS="COMMAND" 311 >pg3</B 312 > will crash kernel.</P 313 ><P 314 >Do not use it on VLAN, ethertap, VTUN and other devices, 315 which emulate Ethernet not being real Ethernet in fact.</P 316 ></DIV 317 ><DIV 318 CLASS="REFSECT1" 319 ><A 320 NAME="AEN1381" 321 ></A 322 ><H2 323 >AUTHOR</H2 324 ><P 325 ><B 326 CLASS="COMMAND" 327 >pg3</B 328 > was written by <A 329 HREF="mailto:robert.olsson@its.uu.se" 330 TARGET="_top" 331 >Robert Olsson <robert.olsson@its.uu.se></A 332 >.</P 333 ></DIV 334 ><DIV 335 CLASS="REFSECT1" 336 ><A 337 NAME="AEN1386" 338 ></A 339 ><H2 340 >SECURITY</H2 341 ><P 342 >This can be used only by superuser.</P 343 ><P 344 >This tool creates floods of packets which is unlikely to be handled 345 even by high-end machines. For example, it saturates gigabit link with 346 60 byte packets when used with Intel's e1000. In face of such stream 347 switches, routers and end hosts may deadlock, crash, explode. 348 Use only in test lab environment.</P 349 ></DIV 350 ><DIV 351 CLASS="REFSECT1" 352 ><A 353 NAME="AEN1390" 354 ></A 355 ><H2 356 >AVAILABILITY</H2 357 ><P 358 ><B 359 CLASS="COMMAND" 360 >pg3</B 361 > is part of <TT 362 CLASS="FILENAME" 363 >iputils</TT 364 > package 365 and the latest versions are available in source form at 366 <A 367 HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2" 368 TARGET="_top" 369 >http://www.skbuff.net/iputils/iputils-current.tar.bz2</A 370 >.</P 371 ></DIV 372 ><DIV 373 CLASS="NAVFOOTER" 374 ><HR 375 ALIGN="LEFT" 376 WIDTH="100%"><TABLE 377 SUMMARY="Footer navigation table" 378 WIDTH="100%" 379 BORDER="0" 380 CELLPADDING="0" 381 CELLSPACING="0" 382 ><TR 383 ><TD 384 WIDTH="33%" 385 ALIGN="left" 386 VALIGN="top" 387 ><A 388 HREF="r1149.html" 389 ACCESSKEY="P" 390 ><<< Previous</A 391 ></TD 392 ><TD 393 WIDTH="34%" 394 ALIGN="center" 395 VALIGN="top" 396 ><A 397 HREF="r1.html" 398 ACCESSKEY="H" 399 >Home</A 400 ></TD 401 ><TD 402 WIDTH="33%" 403 ALIGN="right" 404 VALIGN="top" 405 > </TD 406 ></TR 407 ><TR 408 ><TD 409 WIDTH="33%" 410 ALIGN="left" 411 VALIGN="top" 412 >rdisc</TD 413 ><TD 414 WIDTH="34%" 415 ALIGN="center" 416 VALIGN="top" 417 > </TD 418 ><TD 419 WIDTH="33%" 420 ALIGN="right" 421 VALIGN="top" 422 > </TD 423 ></TR 424 ></TABLE 425 ></DIV 426 ></BODY 427 ></HTML 428 > 429 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r3.html iputils-s20161105/doc/r3.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >ping</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="System Manager's Manual: iputils" 11 HREF="r1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="System Manager's Manual: iputils" 14 HREF="r1.html"><LINK 15 REL="NEXT" 16 TITLE="arping" 17 HREF="r483.html"></HEAD 18 ><BODY 19 CLASS="REFENTRY" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >System Manager's Manual: iputils</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="r1.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="r483.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><H1 69 ><A 70 NAME="PING" 71 ></A 72 >ping</H1 73 ><DIV 74 CLASS="REFNAMEDIV" 75 ><A 76 NAME="AEN8" 77 ></A 78 ><H2 79 >Name</H2 80 >ping -- send ICMP ECHO_REQUEST to network hosts</DIV 81 ><DIV 82 CLASS="REFSYNOPSISDIV" 83 ><A 84 NAME="AEN11" 85 ></A 86 ><H2 87 >Synopsis</H2 88 ><P 89 ><B 90 CLASS="COMMAND" 91 >ping</B 92 > [<CODE 93 CLASS="OPTION" 94 >-aAbBdDfhLnOqrRUvV46</CODE 95 >] [-c <TT 96 CLASS="REPLACEABLE" 97 ><I 98 >count</I 99 ></TT 100 >] [-F <TT 101 CLASS="REPLACEABLE" 102 ><I 103 >flowlabel</I 104 ></TT 105 >] [-i <TT 106 CLASS="REPLACEABLE" 107 ><I 108 >interval</I 109 ></TT 110 >] [-I <TT 111 CLASS="REPLACEABLE" 112 ><I 113 >interface</I 114 ></TT 115 >] [-l <TT 116 CLASS="REPLACEABLE" 117 ><I 118 >preload</I 119 ></TT 120 >] [-m <TT 121 CLASS="REPLACEABLE" 122 ><I 123 >mark</I 124 ></TT 125 >] [-M <TT 126 CLASS="REPLACEABLE" 127 ><I 128 >pmtudisc_option</I 129 ></TT 130 >] [-N <TT 131 CLASS="REPLACEABLE" 132 ><I 133 >nodeinfo_option</I 134 ></TT 135 >] [-w <TT 136 CLASS="REPLACEABLE" 137 ><I 138 >deadline</I 139 ></TT 140 >] [-W <TT 141 CLASS="REPLACEABLE" 142 ><I 143 >timeout</I 144 ></TT 145 >] [-p <TT 146 CLASS="REPLACEABLE" 147 ><I 148 >pattern</I 149 ></TT 150 >] [-Q <TT 151 CLASS="REPLACEABLE" 152 ><I 153 >tos</I 154 ></TT 155 >] [-s <TT 156 CLASS="REPLACEABLE" 157 ><I 158 >packetsize</I 159 ></TT 160 >] [-S <TT 161 CLASS="REPLACEABLE" 162 ><I 163 >sndbuf</I 164 ></TT 165 >] [-t <TT 166 CLASS="REPLACEABLE" 167 ><I 168 >ttl</I 169 ></TT 170 >] [-T <TT 171 CLASS="REPLACEABLE" 172 ><I 173 >timestamp option</I 174 ></TT 175 >] [<TT 176 CLASS="REPLACEABLE" 177 ><I 178 >hop</I 179 ></TT 180 >...] {<TT 181 CLASS="REPLACEABLE" 182 ><I 183 >destination</I 184 ></TT 185 >}</P 186 ></DIV 187 ><DIV 188 CLASS="REFSECT1" 189 ><A 190 NAME="AEN52" 191 ></A 192 ><H2 193 >DESCRIPTION</H2 194 ><P 195 ><B 196 CLASS="COMMAND" 197 >ping</B 198 > uses the ICMP protocol's mandatory ECHO_REQUEST 199 datagram to elicit an ICMP ECHO_RESPONSE from a host or gateway. 200 ECHO_REQUEST datagrams (``pings'') have an IP and ICMP 201 header, followed by a <CODE 202 CLASS="STRUCTNAME" 203 >struct timeval</CODE 204 > and then an arbitrary 205 number of ``pad'' bytes used to fill out the packet.</P 206 ><P 207 ><B 208 CLASS="COMMAND" 209 >ping</B 210 > works with both IPv4 and IPv6. Using only one of them 211 explicitly can be enforced by specifying <CODE 212 CLASS="OPTION" 213 >-4</CODE 214 > or <CODE 215 CLASS="OPTION" 216 >-6</CODE 217 >.</P 218 ><P 219 ><B 220 CLASS="COMMAND" 221 >ping</B 222 > can also send IPv6 Node Information Queries (RFC4620). 223 Intermediate <TT 224 CLASS="REPLACEABLE" 225 ><I 226 >hop</I 227 ></TT 228 >s may not be allowed, because IPv6 source routing was deprecated (RFC5095).</P 229 ></DIV 230 ><DIV 231 CLASS="REFSECT1" 232 ><A 233 NAME="AEN64" 234 ></A 235 ><H2 236 >OPTIONS</H2 237 ><P 238 ></P 239 ><DIV 240 CLASS="VARIABLELIST" 241 ><DL 242 ><DT 243 ><CODE 244 CLASS="OPTION" 245 >-4</CODE 246 ></DT 247 ><DD 248 ><P 249 >Use IPv4 only. 250 </P 251 ></DD 252 ><DT 253 ><CODE 254 CLASS="OPTION" 255 >-6</CODE 256 ></DT 257 ><DD 258 ><P 259 >Use IPv6 only. 260 </P 261 ></DD 262 ><DT 263 ><CODE 264 CLASS="OPTION" 265 >-a</CODE 266 ></DT 267 ><DD 268 ><P 269 >Audible ping. 270 </P 271 ></DD 272 ><DT 273 ><CODE 274 CLASS="OPTION" 275 >-A</CODE 276 ></DT 277 ><DD 278 ><P 279 >Adaptive ping. Interpacket interval adapts to round-trip time, so that 280 effectively not more than one (or more, if preload is set) unanswered probe 281 is present in the network. Minimal interval is 200msec for not super-user. 282 On networks with low rtt this mode is essentially equivalent to flood mode. 283 </P 284 ></DD 285 ><DT 286 ><CODE 287 CLASS="OPTION" 288 >-b</CODE 289 ></DT 290 ><DD 291 ><P 292 >Allow pinging a broadcast address. 293 </P 294 ></DD 295 ><DT 296 ><CODE 297 CLASS="OPTION" 298 >-B</CODE 299 ></DT 300 ><DD 301 ><P 302 >Do not allow <B 303 CLASS="COMMAND" 304 >ping</B 305 > to change source address of probes. 306 The address is bound to one selected when <B 307 CLASS="COMMAND" 308 >ping</B 309 > starts. 310 </P 311 ></DD 312 ><DT 313 ><CODE 314 CLASS="OPTION" 315 ><A 316 NAME="PING.COUNT" 317 ></A 318 >-c <TT 319 CLASS="REPLACEABLE" 320 ><I 321 >count</I 322 ></TT 323 ></CODE 324 ></DT 325 ><DD 326 ><P 327 >Stop after sending <TT 328 CLASS="REPLACEABLE" 329 ><I 330 >count</I 331 ></TT 332 > ECHO_REQUEST 333 packets. With 334 <A 335 HREF="r3.html#PING.DEADLINE" 336 ><TT 337 CLASS="REPLACEABLE" 338 ><I 339 >deadline</I 340 ></TT 341 ></A 342 > 343 option, <B 344 CLASS="COMMAND" 345 >ping</B 346 > waits for 347 <TT 348 CLASS="REPLACEABLE" 349 ><I 350 >count</I 351 ></TT 352 > ECHO_REPLY packets, until the timeout expires. 353 </P 354 ></DD 355 ><DT 356 ><CODE 357 CLASS="OPTION" 358 >-d</CODE 359 ></DT 360 ><DD 361 ><P 362 >Set the <CODE 363 CLASS="CONSTANT" 364 >SO_DEBUG</CODE 365 > option on the socket being used. 366 Essentially, this socket option is not used by Linux kernel. 367 </P 368 ></DD 369 ><DT 370 ><CODE 371 CLASS="OPTION" 372 >-D</CODE 373 ></DT 374 ><DD 375 ><P 376 >Print timestamp (unix time + microseconds as in gettimeofday) before 377 each line. 378 </P 379 ></DD 380 ><DT 381 ><CODE 382 CLASS="OPTION" 383 >-f</CODE 384 ></DT 385 ><DD 386 ><P 387 >Flood ping. For every ECHO_REQUEST sent a period ``.'' is printed, 388 while for ever ECHO_REPLY received a backspace is printed. 389 This provides a rapid display of how many packets are being dropped. 390 If interval is not given, it sets interval to zero and 391 outputs packets as fast as they come back or one hundred times per second, 392 whichever is more. 393 Only the super-user may use this option with zero interval. 394 </P 395 ></DD 396 ><DT 397 ><CODE 398 CLASS="OPTION" 399 >-F <TT 400 CLASS="REPLACEABLE" 401 ><I 402 >flow label</I 403 ></TT 404 ></CODE 405 ></DT 406 ><DD 407 ><P 408 >IPv6 only. 409 Allocate and set 20 bit flow label (in hex) on echo request packets. 410 If value is zero, kernel allocates random flow label. 411 </P 412 ></DD 413 ><DT 414 ><CODE 415 CLASS="OPTION" 416 >-h</CODE 417 ></DT 418 ><DD 419 ><P 420 >Show help. 421 </P 422 ></DD 423 ><DT 424 ><CODE 425 CLASS="OPTION" 426 >-i <TT 427 CLASS="REPLACEABLE" 428 ><I 429 >interval</I 430 ></TT 431 ></CODE 432 ></DT 433 ><DD 434 ><P 435 >Wait <TT 436 CLASS="REPLACEABLE" 437 ><I 438 >interval</I 439 ></TT 440 > seconds between sending each packet. 441 The default is to wait for one second between each packet normally, 442 or not to wait in flood mode. Only super-user may set interval 443 to values less than 0.2 seconds. 444 </P 445 ></DD 446 ><DT 447 ><CODE 448 CLASS="OPTION" 449 >-I <TT 450 CLASS="REPLACEABLE" 451 ><I 452 >interface</I 453 ></TT 454 ></CODE 455 ></DT 456 ><DD 457 ><P 458 ><TT 459 CLASS="REPLACEABLE" 460 ><I 461 >interface</I 462 ></TT 463 > is either an address, or an interface name. 464 If <TT 465 CLASS="REPLACEABLE" 466 ><I 467 >interface</I 468 ></TT 469 > is an address, it sets source address 470 to specified interface address. 471 If <TT 472 CLASS="REPLACEABLE" 473 ><I 474 >interface</I 475 ></TT 476 > in an interface name, it sets 477 source interface to specified interface. 478 For IPv6, when doing ping to a link-local scope 479 address, link specification (by the '%'-notation in 480 <TT 481 CLASS="REPLACEABLE" 482 ><I 483 >destination</I 484 ></TT 485 >, or by this option) is required. 486 </P 487 ></DD 488 ><DT 489 ><CODE 490 CLASS="OPTION" 491 >-l <TT 492 CLASS="REPLACEABLE" 493 ><I 494 >preload</I 495 ></TT 496 ></CODE 497 ></DT 498 ><DD 499 ><P 500 >If <TT 501 CLASS="REPLACEABLE" 502 ><I 503 >preload</I 504 ></TT 505 > is specified, 506 <B 507 CLASS="COMMAND" 508 >ping</B 509 > sends that many packets not waiting for reply. 510 Only the super-user may select preload more than 3. 511 </P 512 ></DD 513 ><DT 514 ><CODE 515 CLASS="OPTION" 516 >-L</CODE 517 ></DT 518 ><DD 519 ><P 520 >Suppress loopback of multicast packets. This flag only applies if the ping 521 destination is a multicast address. 522 </P 523 ></DD 524 ><DT 525 ><CODE 526 CLASS="OPTION" 527 >-m <TT 528 CLASS="REPLACEABLE" 529 ><I 530 >mark</I 531 ></TT 532 ></CODE 533 ></DT 534 ><DD 535 ><P 536 >use <TT 537 CLASS="REPLACEABLE" 538 ><I 539 >mark</I 540 ></TT 541 > to tag the packets going out. This is useful 542 for variety of reasons within the kernel such as using policy 543 routing to select specific outbound processing. 544 </P 545 ></DD 546 ><DT 547 ><CODE 548 CLASS="OPTION" 549 >-M <TT 550 CLASS="REPLACEABLE" 551 ><I 552 >pmtudisc_opt</I 553 ></TT 554 ></CODE 555 ></DT 556 ><DD 557 ><P 558 >Select Path MTU Discovery strategy. 559 <TT 560 CLASS="REPLACEABLE" 561 ><I 562 >pmtudisc_option</I 563 ></TT 564 > may be either <TT 565 CLASS="REPLACEABLE" 566 ><I 567 >do</I 568 ></TT 569 > 570 (prohibit fragmentation, even local one), 571 <TT 572 CLASS="REPLACEABLE" 573 ><I 574 >want</I 575 ></TT 576 > (do PMTU discovery, fragment locally when packet size 577 is large), or <TT 578 CLASS="REPLACEABLE" 579 ><I 580 >dont</I 581 ></TT 582 > (do not set DF flag). 583 </P 584 ></DD 585 ><DT 586 ><CODE 587 CLASS="OPTION" 588 >-N <TT 589 CLASS="REPLACEABLE" 590 ><I 591 >nodeinfo_option</I 592 ></TT 593 ></CODE 594 ></DT 595 ><DD 596 ><P 597 >IPv6 only. 598 Send ICMPv6 Node Information Queries (RFC4620), instead of Echo Request. 599 <CODE 600 CLASS="CONSTANT" 601 >CAP_NET_RAW</CODE 602 > capability is required. 603 <P 604 ></P 605 ><DIV 606 CLASS="VARIABLELIST" 607 ><DL 608 ><DT 609 ><CODE 610 CLASS="OPTION" 611 >help</CODE 612 ></DT 613 ><DD 614 ><P 615 >Show help for NI support.</P 616 ></DD 617 ></DL 618 ></DIV 619 > 620 <P 621 ></P 622 ><DIV 623 CLASS="VARIABLELIST" 624 ><DL 625 ><DT 626 ><CODE 627 CLASS="OPTION" 628 >name</CODE 629 ></DT 630 ><DD 631 ><P 632 >Queries for Node Names.</P 633 ></DD 634 ></DL 635 ></DIV 636 > 637 <P 638 ></P 639 ><DIV 640 CLASS="VARIABLELIST" 641 ><DL 642 ><DT 643 ><CODE 644 CLASS="OPTION" 645 >ipv6</CODE 646 ></DT 647 ><DD 648 ><P 649 >Queries for IPv6 Addresses. There are several IPv6 specific flags. 650 <P 651 ></P 652 ><DIV 653 CLASS="VARIABLELIST" 654 ><DL 655 ><DT 656 ><CODE 657 CLASS="OPTION" 658 >ipv6-global</CODE 659 ></DT 660 ><DD 661 ><P 662 >Request IPv6 global-scope addresses.</P 663 ></DD 664 ></DL 665 ></DIV 666 > 667 <P 668 ></P 669 ><DIV 670 CLASS="VARIABLELIST" 671 ><DL 672 ><DT 673 ><CODE 674 CLASS="OPTION" 675 >ipv6-sitelocal</CODE 676 ></DT 677 ><DD 678 ><P 679 >Request IPv6 site-local addresses.</P 680 ></DD 681 ></DL 682 ></DIV 683 > 684 <P 685 ></P 686 ><DIV 687 CLASS="VARIABLELIST" 688 ><DL 689 ><DT 690 ><CODE 691 CLASS="OPTION" 692 >ipv6-linklocal</CODE 693 ></DT 694 ><DD 695 ><P 696 >Request IPv6 link-local addresses.</P 697 ></DD 698 ></DL 699 ></DIV 700 > 701 <P 702 ></P 703 ><DIV 704 CLASS="VARIABLELIST" 705 ><DL 706 ><DT 707 ><CODE 708 CLASS="OPTION" 709 >ipv6-all</CODE 710 ></DT 711 ><DD 712 ><P 713 >Request IPv6 addresses on other interfaces.</P 714 ></DD 715 ></DL 716 ></DIV 717 > 718 </P 719 ></DD 720 ></DL 721 ></DIV 722 > 723 <P 724 ></P 725 ><DIV 726 CLASS="VARIABLELIST" 727 ><DL 728 ><DT 729 ><CODE 730 CLASS="OPTION" 731 >ipv4</CODE 732 ></DT 733 ><DD 734 ><P 735 >Queries for IPv4 Addresses. There is one IPv4 specific flag. 736 <P 737 ></P 738 ><DIV 739 CLASS="VARIABLELIST" 740 ><DL 741 ><DT 742 ><CODE 743 CLASS="OPTION" 744 >ipv4-all</CODE 745 ></DT 746 ><DD 747 ><P 748 >Request IPv4 addresses on other interfaces.</P 749 ></DD 750 ></DL 751 ></DIV 752 > 753 </P 754 ></DD 755 ></DL 756 ></DIV 757 > 758 <P 759 ></P 760 ><DIV 761 CLASS="VARIABLELIST" 762 ><DL 763 ><DT 764 ><CODE 765 CLASS="OPTION" 766 >subject-ipv6=<TT 767 CLASS="REPLACEABLE" 768 ><I 769 >ipv6addr</I 770 ></TT 771 ></CODE 772 ></DT 773 ><DD 774 ><P 775 >IPv6 subject address.</P 776 ></DD 777 ></DL 778 ></DIV 779 > 780 <P 781 ></P 782 ><DIV 783 CLASS="VARIABLELIST" 784 ><DL 785 ><DT 786 ><CODE 787 CLASS="OPTION" 788 >subject-ipv4=<TT 789 CLASS="REPLACEABLE" 790 ><I 791 >ipv4addr</I 792 ></TT 793 ></CODE 794 ></DT 795 ><DD 796 ><P 797 >IPv4 subject address.</P 798 ></DD 799 ></DL 800 ></DIV 801 > 802 <P 803 ></P 804 ><DIV 805 CLASS="VARIABLELIST" 806 ><DL 807 ><DT 808 ><CODE 809 CLASS="OPTION" 810 >subject-name=<TT 811 CLASS="REPLACEABLE" 812 ><I 813 >nodename</I 814 ></TT 815 ></CODE 816 ></DT 817 ><DD 818 ><P 819 >Subject name. If it contains more than one dot, 820 fully-qualified domain name is assumed.</P 821 ></DD 822 ></DL 823 ></DIV 824 > 825 <P 826 ></P 827 ><DIV 828 CLASS="VARIABLELIST" 829 ><DL 830 ><DT 831 ><CODE 832 CLASS="OPTION" 833 >subject-fqdn=<TT 834 CLASS="REPLACEABLE" 835 ><I 836 >nodename</I 837 ></TT 838 ></CODE 839 ></DT 840 ><DD 841 ><P 842 >Subject name. Fully-qualified domain name is 843 always assumed.</P 844 ></DD 845 ></DL 846 ></DIV 847 > 848 </P 849 ></DD 850 ><DT 851 ><CODE 852 CLASS="OPTION" 853 >-n</CODE 854 ></DT 855 ><DD 856 ><P 857 >Numeric output only. 858 No attempt will be made to lookup symbolic names for host addresses. 859 </P 860 ></DD 861 ><DT 862 ><CODE 863 CLASS="OPTION" 864 >-O</CODE 865 ></DT 866 ><DD 867 ><P 868 >Report outstanding ICMP ECHO reply before sending next packet. 869 This is useful together with the timestamp <CODE 870 CLASS="OPTION" 871 >-D</CODE 872 > to 873 log output to a diagnostic file and search for missing answers. 874 </P 875 ></DD 876 ><DT 877 ><CODE 878 CLASS="OPTION" 879 >-p <TT 880 CLASS="REPLACEABLE" 881 ><I 882 >pattern</I 883 ></TT 884 ></CODE 885 ></DT 886 ><DD 887 ><P 888 >You may specify up to 16 ``pad'' bytes to fill out the packet you send. 889 This is useful for diagnosing data-dependent problems in a network. 890 For example, <CODE 891 CLASS="OPTION" 892 >-p ff</CODE 893 > will cause the sent packet 894 to be filled with all ones. 895 </P 896 ></DD 897 ><DT 898 ><CODE 899 CLASS="OPTION" 900 >-q</CODE 901 ></DT 902 ><DD 903 ><P 904 >Quiet output. 905 Nothing is displayed except the summary lines at startup time and 906 when finished. 907 </P 908 ></DD 909 ><DT 910 ><CODE 911 CLASS="OPTION" 912 >-Q <TT 913 CLASS="REPLACEABLE" 914 ><I 915 >tos</I 916 ></TT 917 ></CODE 918 ></DT 919 ><DD 920 ><P 921 > Set Quality of Service -related bits in ICMP datagrams. 922 <TT 923 CLASS="REPLACEABLE" 924 ><I 925 >tos</I 926 ></TT 927 > can be decimal (<B 928 CLASS="COMMAND" 929 >ping</B 930 > only) or hex number. 931 </P 932 ><P 933 > In RFC2474, these fields are interpreted as 8-bit Differentiated 934 Services (DS), consisting of: bits 0-1 (2 lowest bits) of separate 935 data, and bits 2-7 (highest 6 bits) of Differentiated Services 936 Codepoint (DSCP). In RFC2481 and RFC3168, bits 0-1 are used for ECN. 937 </P 938 ><P 939 > Historically (RFC1349, obsoleted by RFC2474), these were interpreted 940 as: bit 0 (lowest bit) for reserved (currently being redefined as 941 congestion control), 1-4 for Type of Service and bits 5-7 942 (highest bits) for Precedence. 943 </P 944 ></DD 945 ><DT 946 ><CODE 947 CLASS="OPTION" 948 >-r</CODE 949 ></DT 950 ><DD 951 ><P 952 >Bypass the normal routing tables and send directly to a host on an attached 953 interface. 954 If the host is not on a directly-attached network, an error is returned. 955 This option can be used to ping a local host through an interface 956 that has no route through it provided the option <CODE 957 CLASS="OPTION" 958 >-I</CODE 959 > is also 960 used. 961 </P 962 ></DD 963 ><DT 964 ><CODE 965 CLASS="OPTION" 966 >-R</CODE 967 ></DT 968 ><DD 969 ><P 970 ><B 971 CLASS="COMMAND" 972 >ping</B 973 > only. 974 Record route. 975 Includes the RECORD_ROUTE option in the ECHO_REQUEST 976 packet and displays the route buffer on returned packets. 977 Note that the IP header is only large enough for nine such routes. 978 Many hosts ignore or discard this option. 979 </P 980 ></DD 981 ><DT 982 ><CODE 983 CLASS="OPTION" 984 >-s <TT 985 CLASS="REPLACEABLE" 986 ><I 987 >packetsize</I 988 ></TT 989 ></CODE 990 ></DT 991 ><DD 992 ><P 993 >Specifies the number of data bytes to be sent. 994 The default is 56, which translates into 64 ICMP 995 data bytes when combined with the 8 bytes of ICMP header data. 996 </P 997 ></DD 998 ><DT 999 ><CODE 1000 CLASS="OPTION" 1001 >-S <TT 1002 CLASS="REPLACEABLE" 1003 ><I 1004 >sndbuf</I 1005 ></TT 1006 ></CODE 1007 ></DT 1008 ><DD 1009 ><P 1010 >Set socket sndbuf. If not specified, it is selected to buffer 1011 not more than one packet. 1012 </P 1013 ></DD 1014 ><DT 1015 ><CODE 1016 CLASS="OPTION" 1017 >-t <TT 1018 CLASS="REPLACEABLE" 1019 ><I 1020 >ttl</I 1021 ></TT 1022 ></CODE 1023 ></DT 1024 ><DD 1025 ><P 1026 ><B 1027 CLASS="COMMAND" 1028 >ping</B 1029 > only. 1030 Set the IP Time to Live. 1031 </P 1032 ></DD 1033 ><DT 1034 ><CODE 1035 CLASS="OPTION" 1036 >-T <TT 1037 CLASS="REPLACEABLE" 1038 ><I 1039 >timestamp option</I 1040 ></TT 1041 ></CODE 1042 ></DT 1043 ><DD 1044 ><P 1045 >Set special IP timestamp options. 1046 <TT 1047 CLASS="REPLACEABLE" 1048 ><I 1049 >timestamp option</I 1050 ></TT 1051 > may be either 1052 <TT 1053 CLASS="REPLACEABLE" 1054 ><I 1055 >tsonly</I 1056 ></TT 1057 > (only timestamps), 1058 <TT 1059 CLASS="REPLACEABLE" 1060 ><I 1061 >tsandaddr</I 1062 ></TT 1063 > (timestamps and addresses) or 1064 <TT 1065 CLASS="REPLACEABLE" 1066 ><I 1067 >tsprespec host1 [host2 [host3 [host4]]]</I 1068 ></TT 1069 > 1070 (timestamp prespecified hops). 1071 </P 1072 ></DD 1073 ><DT 1074 ><CODE 1075 CLASS="OPTION" 1076 >-U</CODE 1077 ></DT 1078 ><DD 1079 ><P 1080 >Print full user-to-user latency (the old behaviour). Normally 1081 <B 1082 CLASS="COMMAND" 1083 >ping</B 1084 > 1085 prints network round trip time, which can be different 1086 f.e. due to DNS failures. 1087 </P 1088 ></DD 1089 ><DT 1090 ><CODE 1091 CLASS="OPTION" 1092 >-v</CODE 1093 ></DT 1094 ><DD 1095 ><P 1096 >Verbose output. 1097 </P 1098 ></DD 1099 ><DT 1100 ><CODE 1101 CLASS="OPTION" 1102 >-V</CODE 1103 ></DT 1104 ><DD 1105 ><P 1106 >Show version and exit. 1107 </P 1108 ></DD 1109 ><DT 1110 ><CODE 1111 CLASS="OPTION" 1112 ><A 1113 NAME="PING.DEADLINE" 1114 ></A 1115 >-w <TT 1116 CLASS="REPLACEABLE" 1117 ><I 1118 >deadline</I 1119 ></TT 1120 ></CODE 1121 ></DT 1122 ><DD 1123 ><P 1124 >Specify a timeout, in seconds, before 1125 <B 1126 CLASS="COMMAND" 1127 >ping</B 1128 > 1129 exits regardless of how many 1130 packets have been sent or received. In this case 1131 <B 1132 CLASS="COMMAND" 1133 >ping</B 1134 > 1135 does not stop after 1136 <A 1137 HREF="r3.html#PING.COUNT" 1138 ><TT 1139 CLASS="REPLACEABLE" 1140 ><I 1141 >count</I 1142 ></TT 1143 ></A 1144 > 1145 packet are sent, it waits either for 1146 <A 1147 HREF="r3.html#PING.DEADLINE" 1148 ><TT 1149 CLASS="REPLACEABLE" 1150 ><I 1151 >deadline</I 1152 ></TT 1153 ></A 1154 > 1155 expire or until 1156 <A 1157 HREF="r3.html#PING.COUNT" 1158 ><TT 1159 CLASS="REPLACEABLE" 1160 ><I 1161 >count</I 1162 ></TT 1163 ></A 1164 > 1165 probes are answered or for some error notification from network. 1166 </P 1167 ></DD 1168 ><DT 1169 ><CODE 1170 CLASS="OPTION" 1171 >-W <TT 1172 CLASS="REPLACEABLE" 1173 ><I 1174 >timeout</I 1175 ></TT 1176 ></CODE 1177 ></DT 1178 ><DD 1179 ><P 1180 >Time to wait for a response, in seconds. The option affects only timeout 1181 in absence of any responses, otherwise <B 1182 CLASS="COMMAND" 1183 >ping</B 1184 > waits for two RTTs. 1185 </P 1186 ></DD 1187 ></DL 1188 ></DIV 1189 ><P 1190 >When using <B 1191 CLASS="COMMAND" 1192 >ping</B 1193 > for fault isolation, it should first be run 1194 on the local host, to verify that the local network interface is up 1195 and running. Then, hosts and gateways further and further away should be 1196 ``pinged''. Round-trip times and packet loss statistics are computed. 1197 If duplicate packets are received, they are not included in the packet 1198 loss calculation, although the round trip time of these packets is used 1199 in calculating the minimum/average/maximum round-trip time numbers. 1200 When the specified number of packets have been sent (and received) or 1201 if the program is terminated with a 1202 <CODE 1203 CLASS="CONSTANT" 1204 >SIGINT</CODE 1205 >, a brief summary is displayed. Shorter current statistics 1206 can be obtained without termination of process with signal 1207 <CODE 1208 CLASS="CONSTANT" 1209 >SIGQUIT</CODE 1210 >.</P 1211 ><P 1212 >If <B 1213 CLASS="COMMAND" 1214 >ping</B 1215 > does not receive any reply packets at all it will 1216 exit with code 1. If a packet 1217 <A 1218 HREF="r3.html#PING.COUNT" 1219 ><TT 1220 CLASS="REPLACEABLE" 1221 ><I 1222 >count</I 1223 ></TT 1224 ></A 1225 > 1226 and 1227 <A 1228 HREF="r3.html#PING.DEADLINE" 1229 ><TT 1230 CLASS="REPLACEABLE" 1231 ><I 1232 >deadline</I 1233 ></TT 1234 ></A 1235 > 1236 are both specified, and fewer than 1237 <A 1238 HREF="r3.html#PING.COUNT" 1239 ><TT 1240 CLASS="REPLACEABLE" 1241 ><I 1242 >count</I 1243 ></TT 1244 ></A 1245 > 1246 packets are received by the time the 1247 <A 1248 HREF="r3.html#PING.DEADLINE" 1249 ><TT 1250 CLASS="REPLACEABLE" 1251 ><I 1252 >deadline</I 1253 ></TT 1254 ></A 1255 > 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.</P 1260 ><P 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 <B 1265 CLASS="COMMAND" 1266 >ping</B 1267 > during normal operations or from automated scripts.</P 1268 ></DIV 1269 ><DIV 1270 CLASS="REFSECT1" 1271 ><A 1272 NAME="AEN402" 1273 ></A 1274 ><H2 1275 >ICMP PACKET DETAILS</H2 1276 ><P 1277 >An IP header without options is 20 bytes. 1278 An ICMP ECHO_REQUEST packet contains an additional 8 bytes worth 1279 of ICMP header followed by an arbitrary amount of data. 1280 When a <TT 1281 CLASS="REPLACEABLE" 1282 ><I 1283 >packetsize</I 1284 ></TT 1285 > is given, this indicated the size of this 1286 extra piece of data (the default is 56). Thus the amount of data received 1287 inside of an IP packet of type ICMP ECHO_REPLY will always be 8 bytes 1288 more than the requested data space (the ICMP header).</P 1289 ><P 1290 >If the data space is at least of size of <CODE 1291 CLASS="STRUCTNAME" 1292 >struct timeval</CODE 1293 > 1294 <B 1295 CLASS="COMMAND" 1296 >ping</B 1297 > uses the beginning bytes of this space to include 1298 a timestamp which it uses in the computation of round trip times. 1299 If the data space is shorter, no round trip times are given.</P 1300 ></DIV 1301 ><DIV 1302 CLASS="REFSECT1" 1303 ><A 1304 NAME="AEN409" 1305 ></A 1306 ><H2 1307 >DUPLICATE AND DAMAGED PACKETS</H2 1308 ><P 1309 ><B 1310 CLASS="COMMAND" 1311 >ping</B 1312 > will report duplicate and damaged packets. 1313 Duplicate packets should never occur, and seem to be caused by 1314 inappropriate link-level retransmissions. 1315 Duplicates may occur in many situations and are rarely (if ever) a 1316 good sign, although the presence of low levels of duplicates may not 1317 always be cause for alarm.</P 1318 ><P 1319 >Damaged packets are obviously serious cause for alarm and often 1320 indicate broken hardware somewhere in the 1321 <B 1322 CLASS="COMMAND" 1323 >ping</B 1324 > packet's path (in the network or in the hosts).</P 1325 ></DIV 1326 ><DIV 1327 CLASS="REFSECT1" 1328 ><A 1329 NAME="AEN415" 1330 ></A 1331 ><H2 1332 >TRYING DIFFERENT DATA PATTERNS</H2 1333 ><P 1334 >The (inter)network layer should never treat packets differently depending 1335 on the data contained in the data portion. 1336 Unfortunately, data-dependent problems have been known to sneak into 1337 networks and remain undetected for long periods of time. 1338 In many cases the particular pattern that will have problems is something 1339 that doesn't have sufficient ``transitions'', such as all ones or all 1340 zeros, or a pattern right at the edge, such as almost all zeros. 1341 It isn't necessarily enough to specify a data pattern of all zeros (for 1342 example) on the command line because the pattern that is of interest is 1343 at the data link level, and the relationship between what you type and 1344 what the controllers transmit can be complicated.</P 1345 ><P 1346 >This means that if you have a data-dependent problem you will probably 1347 have to do a lot of testing to find it. 1348 If you are lucky, you may manage to find a file that either can't be sent 1349 across your network or that takes much longer to transfer than other 1350 similar length files. 1351 You can then examine this file for repeated patterns that you can test 1352 using the <CODE 1353 CLASS="OPTION" 1354 >-p</CODE 1355 > option of <B 1356 CLASS="COMMAND" 1357 >ping</B 1358 >.</P 1359 ></DIV 1360 ><DIV 1361 CLASS="REFSECT1" 1362 ><A 1363 NAME="AEN421" 1364 ></A 1365 ><H2 1366 >TTL DETAILS</H2 1367 ><P 1368 >The TTL value of an IP packet represents the maximum number of IP routers 1369 that the packet can go through before being thrown away. 1370 In current practice you can expect each router in the Internet to decrement 1371 the TTL field by exactly one.</P 1372 ><P 1373 >The TCP/IP specification states that the TTL field for TCP 1374 packets should be set to 60, but many systems use smaller values 1375 (4.3 BSD uses 30, 4.2 used 15).</P 1376 ><P 1377 >The maximum possible value of this field is 255, and most Unix systems set 1378 the TTL field of ICMP ECHO_REQUEST packets to 255. 1379 This is why you will find you can ``ping'' some hosts, but not reach them 1380 with 1381 <SPAN 1382 CLASS="CITEREFENTRY" 1383 ><SPAN 1384 CLASS="REFENTRYTITLE" 1385 >telnet</SPAN 1386 >(1)</SPAN 1387 > 1388 or 1389 <SPAN 1390 CLASS="CITEREFENTRY" 1391 ><SPAN 1392 CLASS="REFENTRYTITLE" 1393 >ftp</SPAN 1394 >(1)</SPAN 1395 >.</P 1396 ><P 1397 >In normal operation ping prints the TTL value from the packet it receives. 1398 When a remote system receives a ping packet, it can do one of three things 1399 with the TTL field in its response:</P 1400 ><P 1401 ></P 1402 ><UL 1403 ><LI 1404 ><P 1405 >Not change it; this is what Berkeley Unix systems did before the 1406 4.3BSD Tahoe release. In this case the TTL value in the received packet 1407 will be 255 minus the number of routers in the round-trip path. 1408 </P 1409 ></LI 1410 ><LI 1411 ><P 1412 >Set it to 255; this is what current Berkeley Unix systems do. 1413 In this case the TTL value in the received packet will be 255 minus the 1414 number of routers in the path <I 1415 CLASS="EMPHASIS" 1416 >from</I 1417 > 1418 the remote system <I 1419 CLASS="EMPHASIS" 1420 >to</I 1421 > the <B 1422 CLASS="COMMAND" 1423 >ping</B 1424 >ing host. 1425 </P 1426 ></LI 1427 ><LI 1428 ><P 1429 >Set it to some other value. Some machines use the same value for 1430 ICMP packets that they use for TCP packets, for example either 30 or 60. 1431 Others may use completely wild values. 1432 </P 1433 ></LI 1434 ></UL 1435 ></DIV 1436 ><DIV 1437 CLASS="REFSECT1" 1438 ><A 1439 NAME="AEN443" 1440 ></A 1441 ><H2 1442 >BUGS</H2 1443 ><P 1444 ></P 1445 ><UL 1446 ><LI 1447 ><P 1448 >Many Hosts and Gateways ignore the RECORD_ROUTE option. 1449 </P 1450 ></LI 1451 ><LI 1452 ><P 1453 >The maximum IP header length is too small for options like 1454 RECORD_ROUTE to be completely useful. 1455 There's not much that can be done about this, however. 1456 </P 1457 ></LI 1458 ><LI 1459 ><P 1460 >Flood pinging is not recommended in general, and flood pinging the 1461 broadcast address should only be done under very controlled conditions. 1462 </P 1463 ></LI 1464 ></UL 1465 ></DIV 1466 ><DIV 1467 CLASS="REFSECT1" 1468 ><A 1469 NAME="AEN452" 1470 ></A 1471 ><H2 1472 >SEE ALSO</H2 1473 ><P 1474 ><SPAN 1475 CLASS="CITEREFENTRY" 1476 ><SPAN 1477 CLASS="REFENTRYTITLE" 1478 >netstat</SPAN 1479 >(1)</SPAN 1480 >, 1481 <SPAN 1482 CLASS="CITEREFENTRY" 1483 ><SPAN 1484 CLASS="REFENTRYTITLE" 1485 >ifconfig</SPAN 1486 >(8)</SPAN 1487 >.</P 1488 ></DIV 1489 ><DIV 1490 CLASS="REFSECT1" 1491 ><A 1492 NAME="AEN461" 1493 ></A 1494 ><H2 1495 >HISTORY</H2 1496 ><P 1497 >The <B 1498 CLASS="COMMAND" 1499 >ping</B 1500 > command appeared in 4.3BSD.</P 1501 ><P 1502 >The version described here is its descendant specific to Linux.</P 1503 ><P 1504 >As of version s20150815, the <B 1505 CLASS="COMMAND" 1506 >ping6</B 1507 > binary doesn't exist anymore. 1508 It has been merged into <B 1509 CLASS="COMMAND" 1510 >ping</B 1511 >. Creating a symlink named 1512 <B 1513 CLASS="COMMAND" 1514 >ping6</B 1515 > pointing to <B 1516 CLASS="COMMAND" 1517 >ping</B 1518 > will result in the same 1519 funcionality as before.</P 1520 ></DIV 1521 ><DIV 1522 CLASS="REFSECT1" 1523 ><A 1524 NAME="AEN471" 1525 ></A 1526 ><H2 1527 >SECURITY</H2 1528 ><P 1529 ><B 1530 CLASS="COMMAND" 1531 >ping</B 1532 > requires <CODE 1533 CLASS="CONSTANT" 1534 >CAP_NET_RAW</CODE 1535 > capability 1536 to be executed 1) if the program is used for non-echo queries 1537 (See <CODE 1538 CLASS="OPTION" 1539 >-N</CODE 1540 > option), or 2) if kernel does not 1541 support non-raw ICMP sockets, or 3) if the user is not allowed 1542 to create an ICMP echo socket. The program may be used as 1543 set-uid root.</P 1544 ></DIV 1545 ><DIV 1546 CLASS="REFSECT1" 1547 ><A 1548 NAME="AEN477" 1549 ></A 1550 ><H2 1551 >AVAILABILITY</H2 1552 ><P 1553 ><B 1554 CLASS="COMMAND" 1555 >ping</B 1556 > is part of <TT 1557 CLASS="FILENAME" 1558 >iputils</TT 1559 > package 1560 and the latest versions are available in source form at 1561 <A 1562 HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2" 1563 TARGET="_top" 1564 >http://www.skbuff.net/iputils/iputils-current.tar.bz2</A 1565 >.</P 1566 ></DIV 1567 ><DIV 1568 CLASS="NAVFOOTER" 1569 ><HR 1570 ALIGN="LEFT" 1571 WIDTH="100%"><TABLE 1572 SUMMARY="Footer navigation table" 1573 WIDTH="100%" 1574 BORDER="0" 1575 CELLPADDING="0" 1576 CELLSPACING="0" 1577 ><TR 1578 ><TD 1579 WIDTH="33%" 1580 ALIGN="left" 1581 VALIGN="top" 1582 ><A 1583 HREF="r1.html" 1584 ACCESSKEY="P" 1585 ><<< Previous</A 1586 ></TD 1587 ><TD 1588 WIDTH="34%" 1589 ALIGN="center" 1590 VALIGN="top" 1591 ><A 1592 HREF="r1.html" 1593 ACCESSKEY="H" 1594 >Home</A 1595 ></TD 1596 ><TD 1597 WIDTH="33%" 1598 ALIGN="right" 1599 VALIGN="top" 1600 ><A 1601 HREF="r483.html" 1602 ACCESSKEY="N" 1603 >Next >>></A 1604 ></TD 1605 ></TR 1606 ><TR 1607 ><TD 1608 WIDTH="33%" 1609 ALIGN="left" 1610 VALIGN="top" 1611 >System Manager's Manual: iputils</TD 1612 ><TD 1613 WIDTH="34%" 1614 ALIGN="center" 1615 VALIGN="top" 1616 > </TD 1617 ><TD 1618 WIDTH="33%" 1619 ALIGN="right" 1620 VALIGN="top" 1621 >arping</TD 1622 ></TR 1623 ></TABLE 1624 ></DIV 1625 ></BODY 1626 ></HTML 1627 > 1628 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r483.html iputils-s20161105/doc/r483.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >arping</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="System Manager's Manual: iputils" 11 HREF="r1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="ping" 14 HREF="r3.html"><LINK 15 REL="NEXT" 16 TITLE="clockdiff" 17 HREF="r641.html"></HEAD 18 ><BODY 19 CLASS="REFENTRY" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >System Manager's Manual: iputils</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="r3.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="r641.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><H1 69 ><A 70 NAME="ARPING" 71 ></A 72 >arping</H1 73 ><DIV 74 CLASS="REFNAMEDIV" 75 ><A 76 NAME="AEN488" 77 ></A 78 ><H2 79 >Name</H2 80 >arping -- send ARP REQUEST to a neighbour host</DIV 81 ><DIV 82 CLASS="REFSYNOPSISDIV" 83 ><A 84 NAME="AEN491" 85 ></A 86 ><H2 87 >Synopsis</H2 88 ><P 89 ><B 90 CLASS="COMMAND" 91 >arping</B 92 > [<CODE 93 CLASS="OPTION" 94 >-AbDfhqUV</CODE 95 >] [-c <TT 96 CLASS="REPLACEABLE" 97 ><I 98 >count</I 99 ></TT 100 >] [-w <TT 101 CLASS="REPLACEABLE" 102 ><I 103 >deadline</I 104 ></TT 105 >] [-s <TT 106 CLASS="REPLACEABLE" 107 ><I 108 >source</I 109 ></TT 110 >] [-I <TT 111 CLASS="REPLACEABLE" 112 ><I 113 >interface</I 114 ></TT 115 >] {<TT 116 CLASS="REPLACEABLE" 117 ><I 118 >destination</I 119 ></TT 120 >}</P 121 ></DIV 122 ><DIV 123 CLASS="REFSECT1" 124 ><A 125 NAME="AEN506" 126 ></A 127 ><H2 128 >DESCRIPTION</H2 129 ><P 130 >Ping <TT 131 CLASS="REPLACEABLE" 132 ><I 133 >destination</I 134 ></TT 135 > on device <TT 136 CLASS="REPLACEABLE" 137 ><I 138 >interface</I 139 ></TT 140 > by ARP packets, 141 using source address <TT 142 CLASS="REPLACEABLE" 143 ><I 144 >source</I 145 ></TT 146 >.</P 147 ></DIV 148 ><DIV 149 CLASS="REFSECT1" 150 ><A 151 NAME="AEN512" 152 ></A 153 ><H2 154 >OPTIONS</H2 155 ><P 156 ></P 157 ><DIV 158 CLASS="VARIABLELIST" 159 ><DL 160 ><DT 161 ><CODE 162 CLASS="OPTION" 163 >-A</CODE 164 ></DT 165 ><DD 166 ><P 167 >The same as <CODE 168 CLASS="OPTION" 169 >-U</CODE 170 >, but ARP REPLY packets used instead 171 of ARP REQUEST. 172 </P 173 ></DD 174 ><DT 175 ><CODE 176 CLASS="OPTION" 177 >-b</CODE 178 ></DT 179 ><DD 180 ><P 181 >Send only MAC level broadcasts. Normally <B 182 CLASS="COMMAND" 183 >arping</B 184 > starts 185 from sending broadcast, and switch to unicast after reply received. 186 </P 187 ></DD 188 ><DT 189 ><CODE 190 CLASS="OPTION" 191 ><A 192 NAME="ARPING.COUNT" 193 ></A 194 >-c <TT 195 CLASS="REPLACEABLE" 196 ><I 197 >count</I 198 ></TT 199 ></CODE 200 ></DT 201 ><DD 202 ><P 203 >Stop after sending <TT 204 CLASS="REPLACEABLE" 205 ><I 206 >count</I 207 ></TT 208 > ARP REQUEST 209 packets. With 210 <A 211 HREF="r483.html#ARPING.DEADLINE" 212 ><TT 213 CLASS="REPLACEABLE" 214 ><I 215 >deadline</I 216 ></TT 217 ></A 218 > 219 option, instead wait for 220 <TT 221 CLASS="REPLACEABLE" 222 ><I 223 >count</I 224 ></TT 225 > ARP REPLY packets, or until the timeout expires. 226 </P 227 ></DD 228 ><DT 229 ><CODE 230 CLASS="OPTION" 231 >-D</CODE 232 ></DT 233 ><DD 234 ><P 235 >Duplicate address detection mode (DAD). See 236 <A 237 HREF="http://tools.ietf.org/rfc/rfc2131.txt" 238 TARGET="_top" 239 >RFC2131, 4.4.1</A 240 >. 241 Returns 0, if DAD succeeded i.e. no replies are received 242 </P 243 ></DD 244 ><DT 245 ><CODE 246 CLASS="OPTION" 247 >-f</CODE 248 ></DT 249 ><DD 250 ><P 251 >Finish after the first reply confirming that target is alive. 252 </P 253 ></DD 254 ><DT 255 ><CODE 256 CLASS="OPTION" 257 ><A 258 NAME="OPT.INTERFACE" 259 ></A 260 >-I <TT 261 CLASS="REPLACEABLE" 262 ><I 263 >interface</I 264 ></TT 265 ></CODE 266 ></DT 267 ><DD 268 ><P 269 >Name of network device where to send ARP REQUEST packets. 270 </P 271 ></DD 272 ><DT 273 ><CODE 274 CLASS="OPTION" 275 >-h</CODE 276 ></DT 277 ><DD 278 ><P 279 >Print help page and exit. 280 </P 281 ></DD 282 ><DT 283 ><CODE 284 CLASS="OPTION" 285 >-q</CODE 286 ></DT 287 ><DD 288 ><P 289 >Quiet output. Nothing is displayed. 290 </P 291 ></DD 292 ><DT 293 ><CODE 294 CLASS="OPTION" 295 ><A 296 NAME="OPT.SOURCE" 297 ></A 298 >-s <TT 299 CLASS="REPLACEABLE" 300 ><I 301 >source</I 302 ></TT 303 ></CODE 304 ></DT 305 ><DD 306 ><P 307 >IP source address to use in ARP packets. 308 If this option is absent, source address is: 309 <P 310 ></P 311 ><UL 312 ><LI 313 ><P 314 >In DAD mode (with option <CODE 315 CLASS="OPTION" 316 >-D</CODE 317 >) set to 0.0.0.0. 318 </P 319 ></LI 320 ><LI 321 ><P 322 >In Unsolicited ARP mode (with options <CODE 323 CLASS="OPTION" 324 >-U</CODE 325 > or <CODE 326 CLASS="OPTION" 327 >-A</CODE 328 >) 329 set to <TT 330 CLASS="REPLACEABLE" 331 ><I 332 >destination</I 333 ></TT 334 >. 335 </P 336 ></LI 337 ><LI 338 ><P 339 >Otherwise, it is calculated from routing tables. 340 </P 341 ></LI 342 ></UL 343 > 344 </P 345 ></DD 346 ><DT 347 ><CODE 348 CLASS="OPTION" 349 >-U</CODE 350 ></DT 351 ><DD 352 ><P 353 >Unsolicited ARP mode to update neighbours' ARP caches. 354 No replies are expected. 355 </P 356 ></DD 357 ><DT 358 ><CODE 359 CLASS="OPTION" 360 >-V</CODE 361 ></DT 362 ><DD 363 ><P 364 >Print version of the program and exit. 365 </P 366 ></DD 367 ><DT 368 ><CODE 369 CLASS="OPTION" 370 ><A 371 NAME="ARPING.DEADLINE" 372 ></A 373 >-w <TT 374 CLASS="REPLACEABLE" 375 ><I 376 >deadline</I 377 ></TT 378 ></CODE 379 ></DT 380 ><DD 381 ><P 382 >Specify a timeout, in seconds, before 383 <B 384 CLASS="COMMAND" 385 >arping</B 386 > 387 exits regardless of how many 388 packets have been sent or received. In this case 389 <B 390 CLASS="COMMAND" 391 >arping</B 392 > 393 does not stop after 394 <A 395 HREF="r483.html#ARPING.COUNT" 396 ><TT 397 CLASS="REPLACEABLE" 398 ><I 399 >count</I 400 ></TT 401 ></A 402 > 403 packet are sent, it waits either for 404 <A 405 HREF="r483.html#ARPING.DEADLINE" 406 ><TT 407 CLASS="REPLACEABLE" 408 ><I 409 >deadline</I 410 ></TT 411 ></A 412 > 413 expire or until 414 <A 415 HREF="r483.html#ARPING.COUNT" 416 ><TT 417 CLASS="REPLACEABLE" 418 ><I 419 >count</I 420 ></TT 421 ></A 422 > 423 probes are answered. 424 </P 425 ></DD 426 ></DL 427 ></DIV 428 ></DIV 429 ><DIV 430 CLASS="REFSECT1" 431 ><A 432 NAME="AEN609" 433 ></A 434 ><H2 435 >SEE ALSO</H2 436 ><P 437 ><A 438 HREF="r3.html" 439 ><SPAN 440 CLASS="CITEREFENTRY" 441 ><SPAN 442 CLASS="REFENTRYTITLE" 443 >ping</SPAN 444 >(8)</SPAN 445 ></A 446 >, 447 <A 448 HREF="r641.html" 449 ><SPAN 450 CLASS="CITEREFENTRY" 451 ><SPAN 452 CLASS="REFENTRYTITLE" 453 >clockdiff</SPAN 454 >(8)</SPAN 455 ></A 456 >, 457 <A 458 HREF="r835.html" 459 ><SPAN 460 CLASS="CITEREFENTRY" 461 ><SPAN 462 CLASS="REFENTRYTITLE" 463 >tracepath</SPAN 464 >(8)</SPAN 465 ></A 466 >.</P 467 ></DIV 468 ><DIV 469 CLASS="REFSECT1" 470 ><A 471 NAME="AEN624" 472 ></A 473 ><H2 474 >AUTHOR</H2 475 ><P 476 ><B 477 CLASS="COMMAND" 478 >arping</B 479 > was written by 480 <A 481 HREF="mailto:kuznet@ms2.inr.ac.ru" 482 TARGET="_top" 483 >Alexey Kuznetsov 484 <kuznet@ms2.inr.ac.ru></A 485 >. 486 It is now maintained by 487 <A 488 HREF="mailto:yoshfuji@skbuff.net" 489 TARGET="_top" 490 >YOSHIFUJI Hideaki 491 <yoshfuji@skbuff.net></A 492 >.</P 493 ></DIV 494 ><DIV 495 CLASS="REFSECT1" 496 ><A 497 NAME="AEN630" 498 ></A 499 ><H2 500 >SECURITY</H2 501 ><P 502 ><B 503 CLASS="COMMAND" 504 >arping</B 505 > requires <CODE 506 CLASS="CONSTANT" 507 >CAP_NET_RAW</CODE 508 > capability 509 to be executed. It is not recommended to be used as set-uid root, 510 because it allows user to modify ARP caches of neighbour hosts.</P 511 ></DIV 512 ><DIV 513 CLASS="REFSECT1" 514 ><A 515 NAME="AEN635" 516 ></A 517 ><H2 518 >AVAILABILITY</H2 519 ><P 520 ><B 521 CLASS="COMMAND" 522 >arping</B 523 > is part of <TT 524 CLASS="FILENAME" 525 >iputils</TT 526 > package 527 and the latest versions are available in source form at 528 <A 529 HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2" 530 TARGET="_top" 531 >http://www.skbuff.net/iputils/iputils-current.tar.bz2</A 532 >.</P 533 ></DIV 534 ><DIV 535 CLASS="NAVFOOTER" 536 ><HR 537 ALIGN="LEFT" 538 WIDTH="100%"><TABLE 539 SUMMARY="Footer navigation table" 540 WIDTH="100%" 541 BORDER="0" 542 CELLPADDING="0" 543 CELLSPACING="0" 544 ><TR 545 ><TD 546 WIDTH="33%" 547 ALIGN="left" 548 VALIGN="top" 549 ><A 550 HREF="r3.html" 551 ACCESSKEY="P" 552 ><<< Previous</A 553 ></TD 554 ><TD 555 WIDTH="34%" 556 ALIGN="center" 557 VALIGN="top" 558 ><A 559 HREF="r1.html" 560 ACCESSKEY="H" 561 >Home</A 562 ></TD 563 ><TD 564 WIDTH="33%" 565 ALIGN="right" 566 VALIGN="top" 567 ><A 568 HREF="r641.html" 569 ACCESSKEY="N" 570 >Next >>></A 571 ></TD 572 ></TR 573 ><TR 574 ><TD 575 WIDTH="33%" 576 ALIGN="left" 577 VALIGN="top" 578 >ping</TD 579 ><TD 580 WIDTH="34%" 581 ALIGN="center" 582 VALIGN="top" 583 > </TD 584 ><TD 585 WIDTH="33%" 586 ALIGN="right" 587 VALIGN="top" 588 >clockdiff</TD 589 ></TR 590 ></TABLE 591 ></DIV 592 ></BODY 593 ></HTML 594 > 595 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r641.html iputils-s20161105/doc/r641.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >clockdiff</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="System Manager's Manual: iputils" 11 HREF="r1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="arping" 14 HREF="r483.html"><LINK 15 REL="NEXT" 16 TITLE="rarpd" 17 HREF="r736.html"></HEAD 18 ><BODY 19 CLASS="REFENTRY" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >System Manager's Manual: iputils</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="r483.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="r736.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><H1 69 ><A 70 NAME="CLOCKDIFF" 71 ></A 72 >clockdiff</H1 73 ><DIV 74 CLASS="REFNAMEDIV" 75 ><A 76 NAME="AEN646" 77 ></A 78 ><H2 79 >Name</H2 80 >clockdiff -- measure clock difference between hosts</DIV 81 ><DIV 82 CLASS="REFSYNOPSISDIV" 83 ><A 84 NAME="AEN649" 85 ></A 86 ><H2 87 >Synopsis</H2 88 ><P 89 ><B 90 CLASS="COMMAND" 91 >clockdiff</B 92 > [<CODE 93 CLASS="OPTION" 94 >-o</CODE 95 >] [<CODE 96 CLASS="OPTION" 97 >-o1</CODE 98 >] {<TT 99 CLASS="REPLACEABLE" 100 ><I 101 >destination</I 102 ></TT 103 >}</P 104 ></DIV 105 ><DIV 106 CLASS="REFSECT1" 107 ><A 108 NAME="AEN658" 109 ></A 110 ><H2 111 >DESCRIPTION</H2 112 ><P 113 ><B 114 CLASS="COMMAND" 115 >clockdiff</B 116 > Measures clock difference between us and 117 <TT 118 CLASS="REPLACEABLE" 119 ><I 120 >destination</I 121 ></TT 122 > with 1 msec resolution using ICMP TIMESTAMP 123 <A 124 HREF="r641.html#CLOCKDIFF.ICMP-TIMESTAMP" 125 >[2]</A 126 > 127 packets or, optionally, IP TIMESTAMP option 128 <A 129 HREF="r641.html#CLOCKDIFF.IP-TIMESTAMP" 130 >[3]</A 131 > 132 option added to ICMP ECHO. 133 <A 134 HREF="r641.html#CLOCKDIFF.ICMP-ECHO" 135 >[1]</A 136 ></P 137 ></DIV 138 ><DIV 139 CLASS="REFSECT1" 140 ><A 141 NAME="AEN666" 142 ></A 143 ><H2 144 >OPTIONS</H2 145 ><P 146 ></P 147 ><DIV 148 CLASS="VARIABLELIST" 149 ><DL 150 ><DT 151 ><CODE 152 CLASS="OPTION" 153 >-o</CODE 154 ></DT 155 ><DD 156 ><P 157 >Use IP TIMESTAMP with ICMP ECHO instead of ICMP TIMESTAMP 158 messages. It is useful with some destinations, which do not support 159 ICMP TIMESTAMP (f.e. Solaris <2.4). 160 </P 161 ></DD 162 ><DT 163 ><CODE 164 CLASS="OPTION" 165 >-o1</CODE 166 ></DT 167 ><DD 168 ><P 169 >Slightly different form of <CODE 170 CLASS="OPTION" 171 >-o</CODE 172 >, namely it uses three-term 173 IP TIMESTAMP with prespecified hop addresses instead of four term one. 174 What flavor works better depends on target host. Particularly, 175 <CODE 176 CLASS="OPTION" 177 >-o</CODE 178 > is better for Linux. 179 </P 180 ></DD 181 ></DL 182 ></DIV 183 ></DIV 184 ><DIV 185 CLASS="REFSECT1" 186 ><A 187 NAME="AEN681" 188 ></A 189 ><H2 190 >WARNINGS</H2 191 ><P 192 ></P 193 ><UL 194 ><LI 195 ><P 196 >Some nodes (Cisco) use non-standard timestamps, which is allowed 197 by RFC, but makes timestamps mostly useless. 198 </P 199 ></LI 200 ><LI 201 ><P 202 >Some nodes generate messed timestamps (Solaris>2.4), when 203 run <B 204 CLASS="COMMAND" 205 >xntpd</B 206 >. Seems, its IP stack uses a corrupted clock source, 207 which is synchronized to time-of-day clock periodically and jumps 208 randomly making timestamps mostly useless. Good news is that you can 209 use NTP in this case, which is even better. 210 </P 211 ></LI 212 ><LI 213 ><P 214 ><B 215 CLASS="COMMAND" 216 >clockdiff</B 217 > shows difference in time modulo 24 days. 218 </P 219 ></LI 220 ></UL 221 ></DIV 222 ><DIV 223 CLASS="REFSECT1" 224 ><A 225 NAME="AEN692" 226 ></A 227 ><H2 228 >SEE ALSO</H2 229 ><P 230 ><A 231 HREF="r3.html" 232 ><SPAN 233 CLASS="CITEREFENTRY" 234 ><SPAN 235 CLASS="REFENTRYTITLE" 236 >ping</SPAN 237 >(8)</SPAN 238 ></A 239 >, 240 <A 241 HREF="r483.html" 242 ><SPAN 243 CLASS="CITEREFENTRY" 244 ><SPAN 245 CLASS="REFENTRYTITLE" 246 >arping</SPAN 247 >(8)</SPAN 248 ></A 249 >, 250 <A 251 HREF="r835.html" 252 ><SPAN 253 CLASS="CITEREFENTRY" 254 ><SPAN 255 CLASS="REFENTRYTITLE" 256 >tracepath</SPAN 257 >(8)</SPAN 258 ></A 259 >.</P 260 ></DIV 261 ><DIV 262 CLASS="REFSECT1" 263 ><A 264 NAME="AEN707" 265 ></A 266 ><H2 267 >REFERENCES</H2 268 ><P 269 >[1] <A 270 NAME="CLOCKDIFF.ICMP-ECHO" 271 ></A 272 >ICMP ECHO, 273 <A 274 HREF="http://tools.ietf.org/rfc/rfc792.txt" 275 TARGET="_top" 276 >RFC0792, page 14</A 277 >.</P 278 ><P 279 >[2] <A 280 NAME="CLOCKDIFF.ICMP-TIMESTAMP" 281 ></A 282 >ICMP TIMESTAMP, 283 <A 284 HREF="http://tools.ietf.org/rfc/rfc792.txt" 285 TARGET="_top" 286 >RFC0792, page 16</A 287 >.</P 288 ><P 289 >[3] <A 290 NAME="CLOCKDIFF.IP-TIMESTAMP" 291 ></A 292 >IP TIMESTAMP option, 293 <A 294 HREF="http://tools.ietf.org/rfc/rfc791.txt" 295 TARGET="_top" 296 >RFC0791, 3.1, page 16</A 297 >.</P 298 ></DIV 299 ><DIV 300 CLASS="REFSECT1" 301 ><A 302 NAME="AEN718" 303 ></A 304 ><H2 305 >AUTHOR</H2 306 ><P 307 ><B 308 CLASS="COMMAND" 309 >clockdiff</B 310 > was compiled by 311 <A 312 HREF="mailto:kuznet@ms2.inr.ac.ru" 313 TARGET="_top" 314 >Alexey Kuznetsov 315 <kuznet@ms2.inr.ac.ru></A 316 >. It was based on code borrowed 317 from BSD <B 318 CLASS="COMMAND" 319 >timed</B 320 > daemon. 321 It is now maintained by 322 <A 323 HREF="mailto:yoshfuji@skbuff.net" 324 TARGET="_top" 325 >YOSHIFUJI Hideaki 326 <yoshfuji@skbuff.net></A 327 >.</P 328 ></DIV 329 ><DIV 330 CLASS="REFSECT1" 331 ><A 332 NAME="AEN725" 333 ></A 334 ><H2 335 >SECURITY</H2 336 ><P 337 ><B 338 CLASS="COMMAND" 339 >clockdiff</B 340 > requires <CODE 341 CLASS="CONSTANT" 342 >CAP_NET_RAW</CODE 343 > capability 344 to be executed. It is safe to be used as set-uid root.</P 345 ></DIV 346 ><DIV 347 CLASS="REFSECT1" 348 ><A 349 NAME="AEN730" 350 ></A 351 ><H2 352 >AVAILABILITY</H2 353 ><P 354 ><B 355 CLASS="COMMAND" 356 >clockdiff</B 357 > is part of <TT 358 CLASS="FILENAME" 359 >iputils</TT 360 > package 361 and the latest versions are available in source form at 362 <A 363 HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2" 364 TARGET="_top" 365 >http://www.skbuff.net/iputils/iputils-current.tar.bz2</A 366 >.</P 367 ></DIV 368 ><DIV 369 CLASS="NAVFOOTER" 370 ><HR 371 ALIGN="LEFT" 372 WIDTH="100%"><TABLE 373 SUMMARY="Footer navigation table" 374 WIDTH="100%" 375 BORDER="0" 376 CELLPADDING="0" 377 CELLSPACING="0" 378 ><TR 379 ><TD 380 WIDTH="33%" 381 ALIGN="left" 382 VALIGN="top" 383 ><A 384 HREF="r483.html" 385 ACCESSKEY="P" 386 ><<< Previous</A 387 ></TD 388 ><TD 389 WIDTH="34%" 390 ALIGN="center" 391 VALIGN="top" 392 ><A 393 HREF="r1.html" 394 ACCESSKEY="H" 395 >Home</A 396 ></TD 397 ><TD 398 WIDTH="33%" 399 ALIGN="right" 400 VALIGN="top" 401 ><A 402 HREF="r736.html" 403 ACCESSKEY="N" 404 >Next >>></A 405 ></TD 406 ></TR 407 ><TR 408 ><TD 409 WIDTH="33%" 410 ALIGN="left" 411 VALIGN="top" 412 >arping</TD 413 ><TD 414 WIDTH="34%" 415 ALIGN="center" 416 VALIGN="top" 417 > </TD 418 ><TD 419 WIDTH="33%" 420 ALIGN="right" 421 VALIGN="top" 422 >rarpd</TD 423 ></TR 424 ></TABLE 425 ></DIV 426 ></BODY 427 ></HTML 428 > 429 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r736.html iputils-s20161105/doc/r736.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >rarpd</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="System Manager's Manual: iputils" 11 HREF="r1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="clockdiff" 14 HREF="r641.html"><LINK 15 REL="NEXT" 16 TITLE="tracepath" 17 HREF="r835.html"></HEAD 18 ><BODY 19 CLASS="REFENTRY" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >System Manager's Manual: iputils</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="r641.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="r835.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><H1 69 ><A 70 NAME="RARPD" 71 ></A 72 >rarpd</H1 73 ><DIV 74 CLASS="REFNAMEDIV" 75 ><A 76 NAME="AEN741" 77 ></A 78 ><H2 79 >Name</H2 80 >rarpd -- answer RARP REQUESTs</DIV 81 ><DIV 82 CLASS="REFSYNOPSISDIV" 83 ><A 84 NAME="AEN744" 85 ></A 86 ><H2 87 >Synopsis</H2 88 ><P 89 ><B 90 CLASS="COMMAND" 91 >arping</B 92 > [<CODE 93 CLASS="OPTION" 94 >-aAvde</CODE 95 >] [-b <TT 96 CLASS="REPLACEABLE" 97 ><I 98 >bootdir</I 99 ></TT 100 >] [<TT 101 CLASS="REPLACEABLE" 102 ><I 103 >interface</I 104 ></TT 105 >]</P 106 ></DIV 107 ><DIV 108 CLASS="REFSECT1" 109 ><A 110 NAME="AEN753" 111 ></A 112 ><H2 113 >DESCRIPTION</H2 114 ><P 115 >Listens 116 <A 117 HREF="http://tools.ietf.org/rfc/rfc903.txt" 118 TARGET="_top" 119 >RARP</A 120 > 121 requests from clients. Provided MAC address of client 122 is found in <TT 123 CLASS="FILENAME" 124 >/etc/ethers</TT 125 > database and 126 obtained host name is resolvable to an IP address appropriate 127 for attached network, <B 128 CLASS="COMMAND" 129 >rarpd</B 130 > answers to client with RARPD 131 reply carrying an IP address.</P 132 ><P 133 >To allow multiple boot servers on the network <B 134 CLASS="COMMAND" 135 >rarpd</B 136 > 137 optionally checks for presence Sun-like bootable image in TFTP directory. 138 It should have form <KBD 139 CLASS="USERINPUT" 140 >Hexadecimal_IP.ARCH</KBD 141 >, f.e. to load 142 sparc 193.233.7.98 <TT 143 CLASS="FILENAME" 144 >C1E90762.SUN4M</TT 145 > is linked to 146 an image appropriate for SUM4M in directory <TT 147 CLASS="FILENAME" 148 >/etc/tftpboot</TT 149 >.</P 150 ></DIV 151 ><DIV 152 CLASS="REFSECT1" 153 ><A 154 NAME="AEN764" 155 ></A 156 ><H2 157 >WARNING</H2 158 ><P 159 >This facility is deeply obsoleted by 160 <A 161 HREF="http://tools.ietf.org/rfc/rfc951.txt" 162 TARGET="_top" 163 >BOOTP</A 164 > 165 and later 166 <A 167 HREF="http://tools.ietf.org/rfc/rfc2131.txt" 168 TARGET="_top" 169 >DHCP</A 170 > protocols. 171 However, some clients really still need this to boot.</P 172 ></DIV 173 ><DIV 174 CLASS="REFSECT1" 175 ><A 176 NAME="AEN769" 177 ></A 178 ><H2 179 >OPTIONS</H2 180 ><P 181 ></P 182 ><DIV 183 CLASS="VARIABLELIST" 184 ><DL 185 ><DT 186 ><CODE 187 CLASS="OPTION" 188 >-a</CODE 189 ></DT 190 ><DD 191 ><P 192 >Listen on all the interfaces. Currently it is an internal 193 option, its function is overridden with <TT 194 CLASS="REPLACEABLE" 195 ><I 196 >interface</I 197 ></TT 198 > 199 argument. It should not be used. 200 </P 201 ></DD 202 ><DT 203 ><CODE 204 CLASS="OPTION" 205 >-A</CODE 206 ></DT 207 ><DD 208 ><P 209 >Listen not only RARP but also ARP messages, some rare clients 210 use ARP by some unknown reason. 211 </P 212 ></DD 213 ><DT 214 ><CODE 215 CLASS="OPTION" 216 >-v</CODE 217 ></DT 218 ><DD 219 ><P 220 >Be verbose. 221 </P 222 ></DD 223 ><DT 224 ><CODE 225 CLASS="OPTION" 226 >-d</CODE 227 ></DT 228 ><DD 229 ><P 230 >Debug mode. Do not go to background. 231 </P 232 ></DD 233 ><DT 234 ><CODE 235 CLASS="OPTION" 236 >-e</CODE 237 ></DT 238 ><DD 239 ><P 240 >Do not check for presence of a boot image, reply if MAC address 241 resolves to a valid IP address using <TT 242 CLASS="FILENAME" 243 >/etc/ethers</TT 244 > 245 database and DNS. 246 </P 247 ></DD 248 ><DT 249 ><CODE 250 CLASS="OPTION" 251 >-b <TT 252 CLASS="REPLACEABLE" 253 ><I 254 >bootdir</I 255 ></TT 256 ></CODE 257 ></DT 258 ><DD 259 ><P 260 >TFTP boot directory. Default is <TT 261 CLASS="FILENAME" 262 >/etc/tftpboot</TT 263 > 264 </P 265 ></DD 266 ></DL 267 ></DIV 268 ></DIV 269 ><DIV 270 CLASS="REFSECT1" 271 ><A 272 NAME="AEN806" 273 ></A 274 ><H2 275 >SEE ALSO</H2 276 ><P 277 ><A 278 HREF="r483.html" 279 ><SPAN 280 CLASS="CITEREFENTRY" 281 ><SPAN 282 CLASS="REFENTRYTITLE" 283 >arping</SPAN 284 >(8)</SPAN 285 ></A 286 >, 287 <A 288 HREF="r1007.html" 289 ><SPAN 290 CLASS="CITEREFENTRY" 291 ><SPAN 292 CLASS="REFENTRYTITLE" 293 >tftpd</SPAN 294 >(8)</SPAN 295 ></A 296 >.</P 297 ></DIV 298 ><DIV 299 CLASS="REFSECT1" 300 ><A 301 NAME="AEN817" 302 ></A 303 ><H2 304 >AUTHOR</H2 305 ><P 306 ><B 307 CLASS="COMMAND" 308 >rarpd</B 309 > was written by 310 <A 311 HREF="mailto:kuznet@ms2.inr.ac.ru" 312 TARGET="_top" 313 >Alexey Kuznetsov 314 <kuznet@ms2.inr.ac.ru></A 315 >. 316 It is now maintained by 317 <A 318 HREF="mailto:yoshfuji@skbuff.net" 319 TARGET="_top" 320 >YOSHIFUJI Hideaki 321 <yoshfuji@skbuff.net></A 322 >.</P 323 ></DIV 324 ><DIV 325 CLASS="REFSECT1" 326 ><A 327 NAME="AEN823" 328 ></A 329 ><H2 330 >SECURITY</H2 331 ><P 332 ><B 333 CLASS="COMMAND" 334 >rarpd</B 335 > requires <CODE 336 CLASS="CONSTANT" 337 >CAP_NET_RAW</CODE 338 > capability 339 to listen and send RARP and ARP packets. It also needs <CODE 340 CLASS="CONSTANT" 341 >CAP_NET_ADMIN</CODE 342 > 343 to give to kernel hint for ARP resolution; this is not strictly required, 344 but some (most of, to be more exact) clients are so badly broken that 345 are not able to answer ARP before they are finally booted. This is 346 not wonderful taking into account that clients using RARPD in 2002 347 are all unsupported relic creatures of 90's and even earlier.</P 348 ></DIV 349 ><DIV 350 CLASS="REFSECT1" 351 ><A 352 NAME="AEN829" 353 ></A 354 ><H2 355 >AVAILABILITY</H2 356 ><P 357 ><B 358 CLASS="COMMAND" 359 >rarpd</B 360 > is part of <TT 361 CLASS="FILENAME" 362 >iputils</TT 363 > package 364 and the latest versions are available in source form at 365 <A 366 HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2" 367 TARGET="_top" 368 >http://www.skbuff.net/iputils/iputils-current.tar.bz2</A 369 >.</P 370 ></DIV 371 ><DIV 372 CLASS="NAVFOOTER" 373 ><HR 374 ALIGN="LEFT" 375 WIDTH="100%"><TABLE 376 SUMMARY="Footer navigation table" 377 WIDTH="100%" 378 BORDER="0" 379 CELLPADDING="0" 380 CELLSPACING="0" 381 ><TR 382 ><TD 383 WIDTH="33%" 384 ALIGN="left" 385 VALIGN="top" 386 ><A 387 HREF="r641.html" 388 ACCESSKEY="P" 389 ><<< Previous</A 390 ></TD 391 ><TD 392 WIDTH="34%" 393 ALIGN="center" 394 VALIGN="top" 395 ><A 396 HREF="r1.html" 397 ACCESSKEY="H" 398 >Home</A 399 ></TD 400 ><TD 401 WIDTH="33%" 402 ALIGN="right" 403 VALIGN="top" 404 ><A 405 HREF="r835.html" 406 ACCESSKEY="N" 407 >Next >>></A 408 ></TD 409 ></TR 410 ><TR 411 ><TD 412 WIDTH="33%" 413 ALIGN="left" 414 VALIGN="top" 415 >clockdiff</TD 416 ><TD 417 WIDTH="34%" 418 ALIGN="center" 419 VALIGN="top" 420 > </TD 421 ><TD 422 WIDTH="33%" 423 ALIGN="right" 424 VALIGN="top" 425 >tracepath</TD 426 ></TR 427 ></TABLE 428 ></DIV 429 ></BODY 430 ></HTML 431 > 432 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r835.html iputils-s20161105/doc/r835.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >tracepath</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="System Manager's Manual: iputils" 11 HREF="r1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="rarpd" 14 HREF="r736.html"><LINK 15 REL="NEXT" 16 TITLE="traceroute6" 17 HREF="r942.html"></HEAD 18 ><BODY 19 CLASS="REFENTRY" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >System Manager's Manual: iputils</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="r736.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="r942.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><H1 69 ><A 70 NAME="TRACEPATH" 71 ></A 72 >tracepath</H1 73 ><DIV 74 CLASS="REFNAMEDIV" 75 ><A 76 NAME="AEN840" 77 ></A 78 ><H2 79 >Name</H2 80 >tracepath, tracepath6 -- traces path to a network host discovering MTU along this path</DIV 81 ><DIV 82 CLASS="REFSYNOPSISDIV" 83 ><A 84 NAME="AEN843" 85 ></A 86 ><H2 87 >Synopsis</H2 88 ><P 89 ><B 90 CLASS="COMMAND" 91 >tracepath</B 92 > [-n] [-b] [-l <TT 93 CLASS="REPLACEABLE" 94 ><I 95 >pktlen</I 96 ></TT 97 >] [-m <TT 98 CLASS="REPLACEABLE" 99 ><I 100 >max_hops</I 101 ></TT 102 >] [-p <TT 103 CLASS="REPLACEABLE" 104 ><I 105 >port</I 106 ></TT 107 >] {<TT 108 CLASS="REPLACEABLE" 109 ><I 110 >destination</I 111 ></TT 112 >}</P 113 ></DIV 114 ><DIV 115 CLASS="REFSECT1" 116 ><A 117 NAME="AEN856" 118 ></A 119 ><H2 120 >DESCRIPTION</H2 121 ><P 122 >It traces path to <TT 123 CLASS="REPLACEABLE" 124 ><I 125 >destination</I 126 ></TT 127 > discovering MTU along this path. 128 It uses UDP port <TT 129 CLASS="REPLACEABLE" 130 ><I 131 >port</I 132 ></TT 133 > or some random port. 134 It is similar to <B 135 CLASS="COMMAND" 136 >traceroute</B 137 >, only does not require superuser 138 privileges and has no fancy options.</P 139 ><P 140 ><B 141 CLASS="COMMAND" 142 >tracepath6</B 143 > is good replacement for <B 144 CLASS="COMMAND" 145 >traceroute6</B 146 > 147 and classic example of application of Linux error queues. 148 The situation with IPv4 is worse, because commercial 149 IP routers do not return enough information in ICMP error messages. 150 Probably, it will change, when they will be updated. 151 For now it uses Van Jacobson's trick, sweeping a range 152 of UDP ports to maintain trace history.</P 153 ></DIV 154 ><DIV 155 CLASS="REFSECT1" 156 ><A 157 NAME="AEN865" 158 ></A 159 ><H2 160 >OPTIONS</H2 161 ><P 162 ></P 163 ><DIV 164 CLASS="VARIABLELIST" 165 ><DL 166 ><DT 167 ><CODE 168 CLASS="OPTION" 169 >-n</CODE 170 ></DT 171 ><DD 172 ><P 173 >Print primarily IP addresses numerically. 174 </P 175 ></DD 176 ><DT 177 ><CODE 178 CLASS="OPTION" 179 >-b</CODE 180 ></DT 181 ><DD 182 ><P 183 >Print both of host names and IP addresses. 184 </P 185 ></DD 186 ><DT 187 ><CODE 188 CLASS="OPTION" 189 >-l</CODE 190 ></DT 191 ><DD 192 ><P 193 >Sets the initial packet length to <TT 194 CLASS="REPLACEABLE" 195 ><I 196 >pktlen</I 197 ></TT 198 > instead of 199 65535 for <B 200 CLASS="COMMAND" 201 >tracepath</B 202 > or 128000 for <B 203 CLASS="COMMAND" 204 >tracepath6</B 205 >. 206 </P 207 ></DD 208 ><DT 209 ><CODE 210 CLASS="OPTION" 211 >-m</CODE 212 ></DT 213 ><DD 214 ><P 215 >Set maximum hops (or maximum TTLs) to <TT 216 CLASS="REPLACEABLE" 217 ><I 218 >max_hops</I 219 ></TT 220 > 221 instead of 30. 222 </P 223 ></DD 224 ><DT 225 ><CODE 226 CLASS="OPTION" 227 >-p</CODE 228 ></DT 229 ><DD 230 ><P 231 >Sets the initial destination port to use. 232 </P 233 ></DD 234 ></DL 235 ></DIV 236 ></DIV 237 ><DIV 238 CLASS="REFSECT1" 239 ><A 240 NAME="AEN897" 241 ></A 242 ><H2 243 >OUTPUT</H2 244 ><P 245 ><P 246 CLASS="LITERALLAYOUT" 247 >root@mops:~ # tracepath6 3ffe:2400:0:109::2<br> 248 1?: [LOCALHOST] pmtu 1500<br> 249 1: dust.inr.ac.ru 0.411ms<br> 250 2: dust.inr.ac.ru asymm 1 0.390ms pmtu 1480<br> 251 2: 3ffe:2400:0:109::2 463.514ms reached<br> 252 Resume: pmtu 1480 hops 2 back 2</P 253 ></P 254 ><P 255 >The first column shows <TT 256 CLASS="LITERAL" 257 >TTL</TT 258 > of the probe, followed by colon. 259 Usually value of <TT 260 CLASS="LITERAL" 261 >TTL</TT 262 > is obtained from reply from network, 263 but sometimes reply does not contain necessary information and 264 we have to guess it. In this case the number is followed by ?.</P 265 ><P 266 >The second column shows the network hop, which replied to the probe. 267 It is either address of router or word <TT 268 CLASS="LITERAL" 269 >[LOCALHOST]</TT 270 >, if 271 the probe was not sent to the network.</P 272 ><P 273 >The rest of line shows miscellaneous information about path to 274 the correspinding network hop. As rule it contains value of RTT. 275 Additionally, it can show Path MTU, when it changes. 276 If the path is asymmetric 277 or the probe finishes before it reach prescribed hop, difference 278 between number of hops in forward and backward direction is shown 279 following keyword <TT 280 CLASS="LITERAL" 281 >async</TT 282 >. This information is not reliable. 283 F.e. the third line shows asymmetry of 1, it is because the first probe 284 with TTL of 2 was rejected at the first hop due to Path MTU Discovery.</P 285 ><P 286 >The last line summarizes information about all the path to the destination, 287 it shows detected Path MTU, amount of hops to the destination and our 288 guess about amount of hops from the destination to us, which can be 289 different when the path is asymmetric.</P 290 ></DIV 291 ><DIV 292 CLASS="REFSECT1" 293 ><A 294 NAME="AEN909" 295 ></A 296 ><H2 297 >SEE ALSO</H2 298 ><P 299 ><SPAN 300 CLASS="CITEREFENTRY" 301 ><SPAN 302 CLASS="REFENTRYTITLE" 303 >traceroute</SPAN 304 >(8)</SPAN 305 >, 306 <A 307 HREF="r942.html" 308 ><SPAN 309 CLASS="CITEREFENTRY" 310 ><SPAN 311 CLASS="REFENTRYTITLE" 312 >traceroute6</SPAN 313 >(8)</SPAN 314 ></A 315 >, 316 <A 317 HREF="r3.html" 318 ><SPAN 319 CLASS="CITEREFENTRY" 320 ><SPAN 321 CLASS="REFENTRYTITLE" 322 >ping</SPAN 323 >(8)</SPAN 324 ></A 325 >.</P 326 ></DIV 327 ><DIV 328 CLASS="REFSECT1" 329 ><A 330 NAME="AEN923" 331 ></A 332 ><H2 333 >AUTHOR</H2 334 ><P 335 ><B 336 CLASS="COMMAND" 337 >tracepath</B 338 > was written by 339 <A 340 HREF="mailto:kuznet@ms2.inr.ac.ru" 341 TARGET="_top" 342 >Alexey Kuznetsov 343 <kuznet@ms2.inr.ac.ru></A 344 >.</P 345 ></DIV 346 ><DIV 347 CLASS="REFSECT1" 348 ><A 349 NAME="AEN928" 350 ></A 351 ><H2 352 >SECURITY</H2 353 ><P 354 >No security issues.</P 355 ><P 356 >This lapidary deserves to be elaborated. 357 <B 358 CLASS="COMMAND" 359 >tracepath</B 360 > is not a privileged program, unlike 361 <B 362 CLASS="COMMAND" 363 >traceroute</B 364 >, <B 365 CLASS="COMMAND" 366 >ping</B 367 > and other beasts of this kind. 368 <B 369 CLASS="COMMAND" 370 >tracepath</B 371 > may be executed by everyone who has some access 372 to network, enough to send UDP datagrams to investigated destination 373 using given port.</P 374 ></DIV 375 ><DIV 376 CLASS="REFSECT1" 377 ><A 378 NAME="AEN936" 379 ></A 380 ><H2 381 >AVAILABILITY</H2 382 ><P 383 ><B 384 CLASS="COMMAND" 385 >tracepath</B 386 > is part of <TT 387 CLASS="FILENAME" 388 >iputils</TT 389 > package 390 and the latest versions are available in source form at 391 <A 392 HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2" 393 TARGET="_top" 394 >http://www.skbuff.net/iputils/iputils-current.tar.bz2</A 395 >.</P 396 ></DIV 397 ><DIV 398 CLASS="NAVFOOTER" 399 ><HR 400 ALIGN="LEFT" 401 WIDTH="100%"><TABLE 402 SUMMARY="Footer navigation table" 403 WIDTH="100%" 404 BORDER="0" 405 CELLPADDING="0" 406 CELLSPACING="0" 407 ><TR 408 ><TD 409 WIDTH="33%" 410 ALIGN="left" 411 VALIGN="top" 412 ><A 413 HREF="r736.html" 414 ACCESSKEY="P" 415 ><<< Previous</A 416 ></TD 417 ><TD 418 WIDTH="34%" 419 ALIGN="center" 420 VALIGN="top" 421 ><A 422 HREF="r1.html" 423 ACCESSKEY="H" 424 >Home</A 425 ></TD 426 ><TD 427 WIDTH="33%" 428 ALIGN="right" 429 VALIGN="top" 430 ><A 431 HREF="r942.html" 432 ACCESSKEY="N" 433 >Next >>></A 434 ></TD 435 ></TR 436 ><TR 437 ><TD 438 WIDTH="33%" 439 ALIGN="left" 440 VALIGN="top" 441 >rarpd</TD 442 ><TD 443 WIDTH="34%" 444 ALIGN="center" 445 VALIGN="top" 446 > </TD 447 ><TD 448 WIDTH="33%" 449 ALIGN="right" 450 VALIGN="top" 451 >traceroute6</TD 452 ></TR 453 ></TABLE 454 ></DIV 455 ></BODY 456 ></HTML 457 > 458 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/r942.html iputils-s20161105/doc/r942.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >traceroute6</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="System Manager's Manual: iputils" 11 HREF="r1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="tracepath" 14 HREF="r835.html"><LINK 15 REL="NEXT" 16 TITLE="tftpd" 17 HREF="r1007.html"></HEAD 18 ><BODY 19 CLASS="REFENTRY" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >System Manager's Manual: iputils</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="r835.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="r1007.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><H1 69 ><A 70 NAME="TRACEROUTE6" 71 ></A 72 >traceroute6</H1 73 ><DIV 74 CLASS="REFNAMEDIV" 75 ><A 76 NAME="AEN947" 77 ></A 78 ><H2 79 >Name</H2 80 >traceroute6 -- traces path to a network host</DIV 81 ><DIV 82 CLASS="REFSYNOPSISDIV" 83 ><A 84 NAME="AEN950" 85 ></A 86 ><H2 87 >Synopsis</H2 88 ><P 89 ><B 90 CLASS="COMMAND" 91 >traceroute6</B 92 > [<CODE 93 CLASS="OPTION" 94 >-dnrvV</CODE 95 >] [-i <TT 96 CLASS="REPLACEABLE" 97 ><I 98 >interface</I 99 ></TT 100 >] [-m <TT 101 CLASS="REPLACEABLE" 102 ><I 103 >max_ttl</I 104 ></TT 105 >] [-p <TT 106 CLASS="REPLACEABLE" 107 ><I 108 >port</I 109 ></TT 110 >] [-q <TT 111 CLASS="REPLACEABLE" 112 ><I 113 >max_probes</I 114 ></TT 115 >] [-s <TT 116 CLASS="REPLACEABLE" 117 ><I 118 >source</I 119 ></TT 120 >] [-w <TT 121 CLASS="REPLACEABLE" 122 ><I 123 >wait time</I 124 ></TT 125 >] {<TT 126 CLASS="REPLACEABLE" 127 ><I 128 >destination</I 129 ></TT 130 >} [<TT 131 CLASS="REPLACEABLE" 132 ><I 133 >size</I 134 ></TT 135 >]</P 136 ></DIV 137 ><DIV 138 CLASS="REFSECT1" 139 ><A 140 NAME="AEN971" 141 ></A 142 ><H2 143 >DESCRIPTION</H2 144 ><P 145 >Description can be found in 146 <SPAN 147 CLASS="CITEREFENTRY" 148 ><SPAN 149 CLASS="REFENTRYTITLE" 150 >traceroute</SPAN 151 >(8)</SPAN 152 >, 153 all the references to IP replaced to IPv6. It is needless to copy 154 the description from there.</P 155 ></DIV 156 ><DIV 157 CLASS="REFSECT1" 158 ><A 159 NAME="AEN977" 160 ></A 161 ><H2 162 >SEE ALSO</H2 163 ><P 164 ><SPAN 165 CLASS="CITEREFENTRY" 166 ><SPAN 167 CLASS="REFENTRYTITLE" 168 >traceroute</SPAN 169 >(8)</SPAN 170 >, 171 <SPAN 172 CLASS="CITEREFENTRY" 173 ><SPAN 174 CLASS="REFENTRYTITLE" 175 >tracepath</SPAN 176 >(8)</SPAN 177 >, 178 <SPAN 179 CLASS="CITEREFENTRY" 180 ><SPAN 181 CLASS="REFENTRYTITLE" 182 >ping</SPAN 183 >(8)</SPAN 184 >.</P 185 ></DIV 186 ><DIV 187 CLASS="REFSECT1" 188 ><A 189 NAME="AEN989" 190 ></A 191 ><H2 192 >HISTORY</H2 193 ><P 194 >This program has long history. Author of <B 195 CLASS="COMMAND" 196 >traceroute</B 197 > 198 is Van Jacobson and it first appeared in 1988. This clone is 199 based on a port of <B 200 CLASS="COMMAND" 201 >traceroute</B 202 > to IPv6 published 203 in NRL IPv6 distribution in 1996. In turn, it was ported 204 to Linux by Pedro Roque. After this it was kept in sync by 205 <A 206 HREF="mailto:kuznet@ms2.inr.ac.ru" 207 TARGET="_top" 208 >Alexey Kuznetsov 209 <kuznet@ms2.inr.ac.ru></A 210 >. And eventually entered 211 <B 212 CLASS="COMMAND" 213 >iputils</B 214 > package.</P 215 ></DIV 216 ><DIV 217 CLASS="REFSECT1" 218 ><A 219 NAME="AEN996" 220 ></A 221 ><H2 222 >SECURITY</H2 223 ><P 224 ><B 225 CLASS="COMMAND" 226 >tracepath6</B 227 > requires <CODE 228 CLASS="CONSTANT" 229 >CAP_NET_RAW</CODE 230 > capability 231 to be executed. It is safe to be used as set-uid root.</P 232 ></DIV 233 ><DIV 234 CLASS="REFSECT1" 235 ><A 236 NAME="AEN1001" 237 ></A 238 ><H2 239 >AVAILABILITY</H2 240 ><P 241 ><B 242 CLASS="COMMAND" 243 >traceroute6</B 244 > is part of <TT 245 CLASS="FILENAME" 246 >iputils</TT 247 > package 248 and the latest versions are available in source form at 249 <A 250 HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2" 251 TARGET="_top" 252 >http://www.skbuff.net/iputils/iputils-current.tar.bz2</A 253 >.</P 254 ></DIV 255 ><DIV 256 CLASS="NAVFOOTER" 257 ><HR 258 ALIGN="LEFT" 259 WIDTH="100%"><TABLE 260 SUMMARY="Footer navigation table" 261 WIDTH="100%" 262 BORDER="0" 263 CELLPADDING="0" 264 CELLSPACING="0" 265 ><TR 266 ><TD 267 WIDTH="33%" 268 ALIGN="left" 269 VALIGN="top" 270 ><A 271 HREF="r835.html" 272 ACCESSKEY="P" 273 ><<< Previous</A 274 ></TD 275 ><TD 276 WIDTH="34%" 277 ALIGN="center" 278 VALIGN="top" 279 ><A 280 HREF="r1.html" 281 ACCESSKEY="H" 282 >Home</A 283 ></TD 284 ><TD 285 WIDTH="33%" 286 ALIGN="right" 287 VALIGN="top" 288 ><A 289 HREF="r1007.html" 290 ACCESSKEY="N" 291 >Next >>></A 292 ></TD 293 ></TR 294 ><TR 295 ><TD 296 WIDTH="33%" 297 ALIGN="left" 298 VALIGN="top" 299 >tracepath</TD 300 ><TD 301 WIDTH="34%" 302 ALIGN="center" 303 VALIGN="top" 304 > </TD 305 ><TD 306 WIDTH="33%" 307 ALIGN="right" 308 VALIGN="top" 309 >tftpd</TD 310 ></TR 311 ></TABLE 312 ></DIV 313 ></BODY 314 ></HTML 315 > 316 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/rarpd.8 iputils-s20161105/doc/rarpd.8
old new 1 .\" This manpage has been automatically generated by docbook2man 2 .\" from a DocBook document. This tool can be found at: 3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 4 .\" Please send any bug reports, improvements, comments, patches, 5 .\" etc. to Steve Cheng <steve@ggi-project.org>. 6 .TH "RARPD" "8" "" "iputils-161105" "System Manager's Manual: iputils" 7 .SH NAME 8 rarpd \- answer RARP REQUESTs 9 .SH SYNOPSIS 10 11 \fBarping\fR [\fB-aAvde\fR] [\fB-b \fIbootdir\fB\fR] [\fB\fIinterface\fB\fR] 12 13 .SH "DESCRIPTION" 14 .PP 15 Listens 16 RARP 17 requests from clients. Provided MAC address of client 18 is found in \fI/etc/ethers\fR database and 19 obtained host name is resolvable to an IP address appropriate 20 for attached network, \fBrarpd\fR answers to client with RARPD 21 reply carrying an IP address. 22 .PP 23 To allow multiple boot servers on the network \fBrarpd\fR 24 optionally checks for presence Sun-like bootable image in TFTP directory. 25 It should have form \fBHexadecimal_IP.ARCH\fR, f.e. to load 26 sparc 193.233.7.98 \fIC1E90762.SUN4M\fR is linked to 27 an image appropriate for SUM4M in directory \fI/etc/tftpboot\fR. 28 .SH "WARNING" 29 .PP 30 This facility is deeply obsoleted by 31 BOOTP 32 and later 33 DHCP protocols. 34 However, some clients really still need this to boot. 35 .SH "OPTIONS" 36 .TP 37 \fB-a\fR 38 Listen on all the interfaces. Currently it is an internal 39 option, its function is overridden with \fIinterface\fR 40 argument. It should not be used. 41 .TP 42 \fB-A\fR 43 Listen not only RARP but also ARP messages, some rare clients 44 use ARP by some unknown reason. 45 .TP 46 \fB-v\fR 47 Be verbose. 48 .TP 49 \fB-d\fR 50 Debug mode. Do not go to background. 51 .TP 52 \fB-e\fR 53 Do not check for presence of a boot image, reply if MAC address 54 resolves to a valid IP address using \fI/etc/ethers\fR 55 database and DNS. 56 .TP 57 \fB-b \fIbootdir\fB\fR 58 TFTP boot directory. Default is \fI/etc/tftpboot\fR 59 .SH "SEE ALSO" 60 .PP 61 \fBarping\fR(8), 62 \fBtftpd\fR(8). 63 .SH "AUTHOR" 64 .PP 65 \fBrarpd\fR was written by 66 Alexey Kuznetsov 67 <kuznet@ms2.inr.ac.ru>. 68 It is now maintained by 69 YOSHIFUJI Hideaki 70 <yoshfuji@skbuff.net>. 71 .SH "SECURITY" 72 .PP 73 \fBrarpd\fR requires CAP_NET_RAW capability 74 to listen and send RARP and ARP packets. It also needs CAP_NET_ADMIN 75 to give to kernel hint for ARP resolution; this is not strictly required, 76 but some (most of, to be more exact) clients are so badly broken that 77 are not able to answer ARP before they are finally booted. This is 78 not wonderful taking into account that clients using RARPD in 2002 79 are all unsupported relic creatures of 90's and even earlier. 80 .SH "AVAILABILITY" 81 .PP 82 \fBrarpd\fR is part of \fIiputils\fR package 83 and the latest versions are available in source form at 84 http://www.skbuff.net/iputils/iputils-current.tar.bz2. -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/rdisc.8 iputils-s20161105/doc/rdisc.8
old new 1 .\" This manpage has been automatically generated by docbook2man 2 .\" from a DocBook document. This tool can be found at: 3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 4 .\" Please send any bug reports, improvements, comments, patches, 5 .\" etc. to Steve Cheng <steve@ggi-project.org>. 6 .TH "RDISC" "8" "" "iputils-161105" "System Manager's Manual: iputils" 7 .SH NAME 8 rdisc \- network router discovery daemon 9 .SH SYNOPSIS 10 11 \fBrdisc\fR [\fB-abdfrstvV\fR] [\fB-p \fIpreference\fB\fR] [\fB-T \fImax_interval\fB\fR] [\fB\fIsend_address\fB\fR] [\fB\fIreceive_address\fB\fR] 12 13 .SH "DESCRIPTION" 14 .PP 15 \fBrdisc\fR implements client side of the ICMP router discover protocol. 16 \fBrdisc\fR is invoked at boot time to populate the network 17 routing tables with default routes. 18 .PP 19 \fBrdisc\fR listens on the ALL_HOSTS (224.0.0.1) multicast address 20 (or \fIreceive_address\fR provided it is given) 21 for ROUTER_ADVERTISE messages from routers. The received 22 messages are handled by first ignoring those listed router addresses 23 with which the host does not share a network. Among the remaining addresses 24 the ones with the highest preference are selected as default routers 25 and a default route is entered in the kernel routing table 26 for each one of them. 27 .PP 28 Optionally, \fBrdisc\fR can avoid waiting for routers to announce 29 themselves by sending out a few ROUTER_SOLICITATION messages 30 to the ALL_ROUTERS (224.0.0.2) multicast address 31 (or \fIsend_address\fR provided it is given) 32 when it is started. 33 .PP 34 A timer is associated with each router address and the address will 35 no longer be considered for inclusion in the the routing tables if the 36 timer expires before a new 37 \fBadvertise\fR message is received from the router. 38 The address will also be excluded from consideration if the host receives an 39 \fBadvertise\fR 40 message with the preference being maximally negative. 41 .PP 42 Server side of router discovery protocol is supported by Cisco IOS 43 and by any more or less complete UNIX routing daemon, f.e \fBgated\fR. 44 Or, \fBrdisc\fR can act as responder, if compiled with -DRDISC_SERVER. 45 .SH "OPTIONS" 46 .TP 47 \fB-a\fR 48 Accept all routers independently of the preference they have in their 49 \fBadvertise\fR messages. 50 Normally \fBrdisc\fR only accepts (and enters in the kernel routing 51 tables) the router or routers with the highest preference. 52 .TP 53 \fB-b\fR 54 Opposite to \fB-a\fR, i.e. install only router with the best 55 preference value. It is default behaviour. 56 .TP 57 \fB-d\fR 58 Send debugging messages to syslog. 59 .TP 60 \fB-f\fR 61 Run \fBrdisc\fR forever even if no routers are found. 62 Normally \fBrdisc\fR gives up if it has not received any 63 \fBadvertise\fR message after after soliciting three times, 64 in which case it exits with a non-zero exit code. 65 If \fB-f\fR is not specified in the first form then 66 \fB-s\fR must be specified. 67 .TP 68 \fB-r\fR 69 Responder mode, available only if compiled with -DRDISC_SERVER. 70 .TP 71 \fB-s\fR 72 Send three \fBsolicitation\fR messages initially to quickly discover 73 the routers when the system is booted. 74 When \fB-s\fR is specified \fBrdisc\fR 75 exits with a non-zero exit code if it can not find any routers. 76 This can be overridden with the \fB-f\fR option. 77 .TP 78 \fB-p \fIpreference\fB\fR 79 Set preference in advertisement. 80 Available only with -r option. 81 .TP 82 \fB-T \fImax_interval\fB\fR 83 Set maximum advertisement interval in seconds. Default is 600 secs. 84 Available only with -r option. 85 .TP 86 \fB-t\fR 87 Test mode. Do not go to background. 88 .TP 89 \fB-v\fR 90 Be verbose i.e. send lots of debugging messages to syslog. 91 .TP 92 \fB-V\fR 93 Print version and exit. 94 .SH "HISTORY" 95 .PP 96 This program was developed by Sun Microsystems (see copyright 97 notice in source file). It was ported to Linux by 98 Alexey Kuznetsov 99 <kuznet@ms2.inr.ac.ru>. 100 It is now maintained by 101 YOSHIFUJI Hideaki 102 <yoshfuji@skbuff.net>. 103 .SH "SEE ALSO" 104 .PP 105 \fBicmp\fR(7), 106 \fBinet\fR(7), 107 \fBping\fR(8). 108 .SH "REFERENCES" 109 .PP 110 Deering, S.E.,ed "ICMP Router Discovery Messages", 111 RFC1256, Network Information Center, SRI International, 112 Menlo Park, Calif., September 1991. 113 .SH "SECURITY" 114 .PP 115 \fBrdisc\fR requires CAP_NET_RAW to listen 116 and send ICMP messages and capability CAP_NET_ADMIN 117 to update routing tables. 118 .SH "AVAILABILITY" 119 .PP 120 \fBrdisc\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. -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/t1.html iputils-s20161105/doc/t1.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >iputils: documentation directory</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="NEXT" 10 TITLE="Historical notes" 11 HREF="x34.html"></HEAD 12 ><BODY 13 CLASS="ARTICLE" 14 BGCOLOR="#FFFFFF" 15 TEXT="#000000" 16 LINK="#0000FF" 17 VLINK="#840084" 18 ALINK="#0000FF" 19 ><DIV 20 CLASS="ARTICLE" 21 ><DIV 22 CLASS="TITLEPAGE" 23 ><H1 24 CLASS="TITLE" 25 ><A 26 NAME="AEN2" 27 >iputils: documentation directory</A 28 ></H1 29 ><HR 30 WIDTH="75%" 31 ALIGN="CENTER" 32 COLOR="#000000" 33 SIZE="1"></DIV 34 ><DIV 35 CLASS="TOC" 36 ><DL 37 ><DT 38 ><B 39 >Table of Contents</B 40 ></DT 41 ><DT 42 ><A 43 HREF="t1.html#AEN4" 44 >Index</A 45 ></DT 46 ><DT 47 ><A 48 HREF="x34.html" 49 >Historical notes</A 50 ></DT 51 ><DT 52 ><A 53 HREF="x89.html" 54 >Installation notes</A 55 ></DT 56 ><DT 57 ><A 58 HREF="x109.html" 59 >Availability</A 60 ></DT 61 ><DT 62 ><A 63 HREF="x114.html" 64 >Copying</A 65 ></DT 66 ></DL 67 ></DIV 68 ><DIV 69 CLASS="SECT1" 70 ><H1 71 CLASS="SECT1" 72 ><A 73 NAME="AEN4" 74 >Index</A 75 ></H1 76 ><P 77 ></P 78 ><UL 79 ><LI 80 ><P 81 > <A 82 HREF="ping.html" 83 TARGET="_top" 84 >ping</A 85 >. 86 </P 87 ></LI 88 ><LI 89 ><P 90 > <A 91 HREF="arping.html" 92 TARGET="_top" 93 >arping</A 94 >. 95 </P 96 ></LI 97 ><LI 98 ><P 99 > <A 100 HREF="clockdiff.html" 101 TARGET="_top" 102 >clockdiff</A 103 >. 104 </P 105 ></LI 106 ><LI 107 ><P 108 > <A 109 HREF="rarpd.html" 110 TARGET="_top" 111 >rarpd</A 112 >. 113 </P 114 ></LI 115 ><LI 116 ><P 117 > <A 118 HREF="tracepath.html" 119 TARGET="_top" 120 >tracepath</A 121 >. 122 </P 123 ></LI 124 ><LI 125 ><P 126 > <A 127 HREF="traceroute6.html" 128 TARGET="_top" 129 >traceroute6</A 130 >. 131 </P 132 ></LI 133 ><LI 134 ><P 135 > <A 136 HREF="rdisc.html" 137 TARGET="_top" 138 >rdisc</A 139 >. 140 </P 141 ></LI 142 ><LI 143 ><P 144 > <A 145 HREF="tftpd.html" 146 TARGET="_top" 147 >tftpd</A 148 >. 149 </P 150 ></LI 151 ><LI 152 ><P 153 > <A 154 HREF="pg3.html" 155 TARGET="_top" 156 >pg3, ipg, pgset</A 157 >. 158 </P 159 ></LI 160 ></UL 161 ></DIV 162 ></DIV 163 ><DIV 164 CLASS="NAVFOOTER" 165 ><HR 166 ALIGN="LEFT" 167 WIDTH="100%"><TABLE 168 SUMMARY="Footer navigation table" 169 WIDTH="100%" 170 BORDER="0" 171 CELLPADDING="0" 172 CELLSPACING="0" 173 ><TR 174 ><TD 175 WIDTH="33%" 176 ALIGN="left" 177 VALIGN="top" 178 > </TD 179 ><TD 180 WIDTH="34%" 181 ALIGN="center" 182 VALIGN="top" 183 > </TD 184 ><TD 185 WIDTH="33%" 186 ALIGN="right" 187 VALIGN="top" 188 ><A 189 HREF="x34.html" 190 ACCESSKEY="N" 191 >Next >>></A 192 ></TD 193 ></TR 194 ><TR 195 ><TD 196 WIDTH="33%" 197 ALIGN="left" 198 VALIGN="top" 199 > </TD 200 ><TD 201 WIDTH="34%" 202 ALIGN="center" 203 VALIGN="top" 204 > </TD 205 ><TD 206 WIDTH="33%" 207 ALIGN="right" 208 VALIGN="top" 209 >Historical notes</TD 210 ></TR 211 ></TABLE 212 ></DIV 213 ></BODY 214 ></HTML 215 > 216 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/tftpd.8 iputils-s20161105/doc/tftpd.8
old new 1 .\" This manpage has been automatically generated by docbook2man 2 .\" from a DocBook document. This tool can be found at: 3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 4 .\" Please send any bug reports, improvements, comments, patches, 5 .\" etc. to Steve Cheng <steve@ggi-project.org>. 6 .TH "TFTPD" "8" "" "iputils-161105" "System Manager's Manual: iputils" 7 .SH NAME 8 tftpd \- Trivial File Transfer Protocol server 9 .SH SYNOPSIS 10 11 \fBtftpd\fR \fB\fIdirectory\fB\fR 12 13 .SH "DESCRIPTION" 14 .PP 15 \fBtftpd\fR is a server which supports the DARPA 16 Trivial File Transfer Protocol 17 (RFC1350). 18 The TFTP server is started 19 by \fBinetd\fR(8). 20 .PP 21 \fIdirectory\fR is required argument; if it is not given 22 \fBtftpd\fR aborts. This path is prepended to any file name requested 23 via TFTP protocol, effectively chrooting \fBtftpd\fR to this directory. 24 File names are validated not to escape out of this directory, however 25 administrator may configure such escape using symbolic links. 26 .PP 27 It is in difference of variants of \fBtftpd\fR usually distributed 28 with unix-like systems, which take a list of directories and match 29 file names to start from one of given prefixes or to some random 30 default, when no arguments were given. There are two reasons not to 31 behave in this way: first, it is inconvenient, clients are not expected 32 to know something about layout of filesystem on server host. 33 And second, TFTP protocol is not a tool for browsing of server's filesystem, 34 it is just an agent allowing to boot dumb clients. 35 .PP 36 In the case when \fBtftpd\fR is used together with 37 \fBrarpd\fR(8), 38 tftp directories in these services should coincide and it is expected 39 that each client booted via TFTP has boot image corresponding 40 its IP address with an architecture suffix following Sun Microsystems 41 conventions. See 42 \fBrarpd\fR(8) 43 for more details. 44 .SH "SECURITY" 45 .PP 46 TFTP protocol does not provide any authentication. 47 Due to this capital flaw \fBtftpd\fR is not able to restrict 48 access to files and will allow only publically readable 49 files to be accessed. Files may be written only if they already 50 exist and are publically writable. 51 .PP 52 Impact is evident, directory exported via TFTP \fBmust not\fR 53 contain sensitive information of any kind, everyone is allowed 54 to read it as soon as a client is allowed. Boot images do not contain 55 such information as rule, however you should think twice before 56 publishing f.e. Cisco IOS config files via TFTP, they contain 57 \fBunencrypted\fR passwords and may contain some information 58 about the network, which you were not going to make public. 59 .PP 60 The \fBtftpd\fR server should be executed by \fBinetd\fR 61 with dropped root privileges, namely with a user ID giving minimal 62 access to files published in tftp directory. If it is executed 63 as superuser occasionally, \fBtftpd\fR drops its UID and GID 64 to 65534, which is most likely not the thing which you expect. 65 However, this is not very essential; remember, only files accessible 66 for everyone can be read or written via TFTP. 67 .SH "SEE ALSO" 68 .PP 69 \fBrarpd\fR(8), 70 \fBtftp\fR(1), 71 \fBinetd\fR(8). 72 .SH "HISTORY" 73 .PP 74 The \fBtftpd\fR command appeared in 4.2BSD. The source in iputils 75 is cleaned up both syntactically (ANSIized) and semantically (UDP socket IO). 76 .PP 77 It is distributed with iputils mostly as good demo of an interesting feature 78 (MSG_CONFIRM) allowing to boot long images by dumb clients 79 not answering ARP requests until they are finally booted. 80 However, this is full functional and can be used in production. 81 .SH "AVAILABILITY" 82 .PP 83 \fBtftpd\fR is part of \fIiputils\fR package 84 and the latest versions are available in source form at 85 http://www.skbuff.net/iputils/iputils-current.tar.bz2. -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/tracepath.8 iputils-s20161105/doc/tracepath.8
old new 1 .\" This manpage has been automatically generated by docbook2man 2 .\" from a DocBook document. This tool can be found at: 3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 4 .\" Please send any bug reports, improvements, comments, patches, 5 .\" etc. to Steve Cheng <steve@ggi-project.org>. 6 .TH "TRACEPATH" "8" "" "iputils-161105" "System Manager's Manual: iputils" 7 .SH NAME 8 tracepath, tracepath6 \- traces path to a network host discovering MTU along this path 9 .SH SYNOPSIS 10 11 \fBtracepath\fR [\fB-n\fR] [\fB-b\fR] [\fB-l \fIpktlen\fB\fR] [\fB-m \fImax_hops\fB\fR] [\fB-p \fIport\fB\fR] \fB\fIdestination\fB\fR 12 13 .SH "DESCRIPTION" 14 .PP 15 It traces path to \fIdestination\fR discovering MTU along this path. 16 It uses UDP port \fIport\fR or some random port. 17 It is similar to \fBtraceroute\fR, only does not require superuser 18 privileges and has no fancy options. 19 .PP 20 \fBtracepath6\fR is good replacement for \fBtraceroute6\fR 21 and classic example of application of Linux error queues. 22 The situation with IPv4 is worse, because commercial 23 IP routers do not return enough information in ICMP error messages. 24 Probably, it will change, when they will be updated. 25 For now it uses Van Jacobson's trick, sweeping a range 26 of UDP ports to maintain trace history. 27 .SH "OPTIONS" 28 .TP 29 \fB-n\fR 30 Print primarily IP addresses numerically. 31 .TP 32 \fB-b\fR 33 Print both of host names and IP addresses. 34 .TP 35 \fB-l\fR 36 Sets the initial packet length to \fIpktlen\fR instead of 37 65535 for \fBtracepath\fR or 128000 for \fBtracepath6\fR. 38 .TP 39 \fB-m\fR 40 Set maximum hops (or maximum TTLs) to \fImax_hops\fR 41 instead of 30. 42 .TP 43 \fB-p\fR 44 Sets the initial destination port to use. 45 .SH "OUTPUT" 46 .PP 47 48 .nf 49 root@mops:~ # tracepath6 3ffe:2400:0:109::2 50 1?: [LOCALHOST] pmtu 1500 51 1: dust.inr.ac.ru 0.411ms 52 2: dust.inr.ac.ru asymm 1 0.390ms pmtu 1480 53 2: 3ffe:2400:0:109::2 463.514ms reached 54 Resume: pmtu 1480 hops 2 back 2 55 .fi 56 .PP 57 The first column shows TTL of the probe, followed by colon. 58 Usually value of TTL is obtained from reply from network, 59 but sometimes reply does not contain necessary information and 60 we have to guess it. In this case the number is followed by ?. 61 .PP 62 The second column shows the network hop, which replied to the probe. 63 It is either address of router or word [LOCALHOST], if 64 the probe was not sent to the network. 65 .PP 66 The rest of line shows miscellaneous information about path to 67 the correspinding network hop. As rule it contains value of RTT. 68 Additionally, it can show Path MTU, when it changes. 69 If the path is asymmetric 70 or the probe finishes before it reach prescribed hop, difference 71 between number of hops in forward and backward direction is shown 72 following keyword async. This information is not reliable. 73 F.e. the third line shows asymmetry of 1, it is because the first probe 74 with TTL of 2 was rejected at the first hop due to Path MTU Discovery. 75 .PP 76 The last line summarizes information about all the path to the destination, 77 it shows detected Path MTU, amount of hops to the destination and our 78 guess about amount of hops from the destination to us, which can be 79 different when the path is asymmetric. 80 .SH "SEE ALSO" 81 .PP 82 \fBtraceroute\fR(8), 83 \fBtraceroute6\fR(8), 84 \fBping\fR(8). 85 .SH "AUTHOR" 86 .PP 87 \fBtracepath\fR was written by 88 Alexey Kuznetsov 89 <kuznet@ms2.inr.ac.ru>. 90 .SH "SECURITY" 91 .PP 92 No security issues. 93 .PP 94 This lapidary deserves to be elaborated. 95 \fBtracepath\fR is not a privileged program, unlike 96 \fBtraceroute\fR, \fBping\fR and other beasts of this kind. 97 \fBtracepath\fR may be executed by everyone who has some access 98 to network, enough to send UDP datagrams to investigated destination 99 using given port. 100 .SH "AVAILABILITY" 101 .PP 102 \fBtracepath\fR is part of \fIiputils\fR package 103 and the latest versions are available in source form at 104 http://www.skbuff.net/iputils/iputils-current.tar.bz2. -
doc/traceroute6.8
diff -Naur iputils-s20161105.orig/doc/traceroute6.8 iputils-s20161105/doc/traceroute6.8
old new 1 .\" This manpage has been automatically generated by docbook2man 2 .\" from a DocBook document. This tool can be found at: 3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 4 .\" Please send any bug reports, improvements, comments, patches, 5 .\" etc. to Steve Cheng <steve@ggi-project.org>. 6 .TH "TRACEROUTE6" "8" "" "iputils-161105" "System Manager's Manual: iputils" 7 .SH NAME 8 traceroute6 \- traces path to a network host 9 .SH SYNOPSIS 10 11 \fBtraceroute6\fR [\fB-dnrvV\fR] [\fB-i \fIinterface\fB\fR] [\fB-m \fImax_ttl\fB\fR] [\fB-p \fIport\fB\fR] [\fB-q \fImax_probes\fB\fR] [\fB-s \fIsource\fB\fR] [\fB-w \fIwait time\fB\fR] \fB\fIdestination\fB\fR [\fB\fIsize\fB\fR] 12 13 .SH "DESCRIPTION" 14 .PP 15 Description can be found in 16 \fBtraceroute\fR(8), 17 all the references to IP replaced to IPv6. It is needless to copy 18 the description from there. 19 .SH "SEE ALSO" 20 .PP 21 \fBtraceroute\fR(8), 22 \fBtracepath\fR(8), 23 \fBping\fR(8). 24 .SH "HISTORY" 25 .PP 26 This program has long history. Author of \fBtraceroute\fR 27 is Van Jacobson and it first appeared in 1988. This clone is 28 based on a port of \fBtraceroute\fR to IPv6 published 29 in NRL IPv6 distribution in 1996. In turn, it was ported 30 to Linux by Pedro Roque. After this it was kept in sync by 31 Alexey Kuznetsov 32 <kuznet@ms2.inr.ac.ru>. And eventually entered 33 \fBiputils\fR package. 34 .SH "SECURITY" 35 .PP 36 \fBtracepath6\fR requires CAP_NET_RAW capability 37 to be executed. It is safe to be used as set-uid root. 38 .SH "AVAILABILITY" 39 .PP 40 \fBtraceroute6\fR is part of \fIiputils\fR package 41 and the latest versions are available in source form at 42 http://www.skbuff.net/iputils/iputils-current.tar.bz2. -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/x109.html iputils-s20161105/doc/x109.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >Availability</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="iputils: documentation directory" 11 HREF="t1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="Installation notes" 14 HREF="x89.html"><LINK 15 REL="NEXT" 16 TITLE="Copying" 17 HREF="x114.html"></HEAD 18 ><BODY 19 CLASS="SECT1" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >iputils: documentation directory</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="x89.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="x114.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><DIV 69 CLASS="SECT1" 70 ><H1 71 CLASS="SECT1" 72 ><A 73 NAME="AEN109" 74 >Availability</A 75 ></H1 76 ><P 77 >The collection of documents is part of <TT 78 CLASS="FILENAME" 79 >iputils</TT 80 > package 81 and the latest versions are available in source form at 82 <A 83 HREF="http://www.skbuff.net/iputils/iputils-current.tar.bz2" 84 TARGET="_top" 85 >http://www.skbuff.net/iputils/iputils-current.tar.bz2</A 86 >.</P 87 ></DIV 88 ><DIV 89 CLASS="NAVFOOTER" 90 ><HR 91 ALIGN="LEFT" 92 WIDTH="100%"><TABLE 93 SUMMARY="Footer navigation table" 94 WIDTH="100%" 95 BORDER="0" 96 CELLPADDING="0" 97 CELLSPACING="0" 98 ><TR 99 ><TD 100 WIDTH="33%" 101 ALIGN="left" 102 VALIGN="top" 103 ><A 104 HREF="x89.html" 105 ACCESSKEY="P" 106 ><<< Previous</A 107 ></TD 108 ><TD 109 WIDTH="34%" 110 ALIGN="center" 111 VALIGN="top" 112 ><A 113 HREF="t1.html" 114 ACCESSKEY="H" 115 >Home</A 116 ></TD 117 ><TD 118 WIDTH="33%" 119 ALIGN="right" 120 VALIGN="top" 121 ><A 122 HREF="x114.html" 123 ACCESSKEY="N" 124 >Next >>></A 125 ></TD 126 ></TR 127 ><TR 128 ><TD 129 WIDTH="33%" 130 ALIGN="left" 131 VALIGN="top" 132 >Installation notes</TD 133 ><TD 134 WIDTH="34%" 135 ALIGN="center" 136 VALIGN="top" 137 > </TD 138 ><TD 139 WIDTH="33%" 140 ALIGN="right" 141 VALIGN="top" 142 >Copying</TD 143 ></TR 144 ></TABLE 145 ></DIV 146 ></BODY 147 ></HTML 148 > 149 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/x114.html iputils-s20161105/doc/x114.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >Copying</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="iputils: documentation directory" 11 HREF="t1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="Availability" 14 HREF="x109.html"></HEAD 15 ><BODY 16 CLASS="SECT1" 17 BGCOLOR="#FFFFFF" 18 TEXT="#000000" 19 LINK="#0000FF" 20 VLINK="#840084" 21 ALINK="#0000FF" 22 ><DIV 23 CLASS="NAVHEADER" 24 ><TABLE 25 SUMMARY="Header navigation table" 26 WIDTH="100%" 27 BORDER="0" 28 CELLPADDING="0" 29 CELLSPACING="0" 30 ><TR 31 ><TH 32 COLSPAN="3" 33 ALIGN="center" 34 >iputils: documentation directory</TH 35 ></TR 36 ><TR 37 ><TD 38 WIDTH="10%" 39 ALIGN="left" 40 VALIGN="bottom" 41 ><A 42 HREF="x109.html" 43 ACCESSKEY="P" 44 ><<< Previous</A 45 ></TD 46 ><TD 47 WIDTH="80%" 48 ALIGN="center" 49 VALIGN="bottom" 50 ></TD 51 ><TD 52 WIDTH="10%" 53 ALIGN="right" 54 VALIGN="bottom" 55 > </TD 56 ></TR 57 ></TABLE 58 ><HR 59 ALIGN="LEFT" 60 WIDTH="100%"></DIV 61 ><DIV 62 CLASS="SECT1" 63 ><H1 64 CLASS="SECT1" 65 ><A 66 NAME="AEN114" 67 >Copying</A 68 ></H1 69 ><P 70 >Different files are copyrighted by different persons and organizations 71 and distributed under different licenses. For details look into corresponding 72 source files.</P 73 ></DIV 74 ><DIV 75 CLASS="NAVFOOTER" 76 ><HR 77 ALIGN="LEFT" 78 WIDTH="100%"><TABLE 79 SUMMARY="Footer navigation table" 80 WIDTH="100%" 81 BORDER="0" 82 CELLPADDING="0" 83 CELLSPACING="0" 84 ><TR 85 ><TD 86 WIDTH="33%" 87 ALIGN="left" 88 VALIGN="top" 89 ><A 90 HREF="x109.html" 91 ACCESSKEY="P" 92 ><<< Previous</A 93 ></TD 94 ><TD 95 WIDTH="34%" 96 ALIGN="center" 97 VALIGN="top" 98 ><A 99 HREF="t1.html" 100 ACCESSKEY="H" 101 >Home</A 102 ></TD 103 ><TD 104 WIDTH="33%" 105 ALIGN="right" 106 VALIGN="top" 107 > </TD 108 ></TR 109 ><TR 110 ><TD 111 WIDTH="33%" 112 ALIGN="left" 113 VALIGN="top" 114 >Availability</TD 115 ><TD 116 WIDTH="34%" 117 ALIGN="center" 118 VALIGN="top" 119 > </TD 120 ><TD 121 WIDTH="33%" 122 ALIGN="right" 123 VALIGN="top" 124 > </TD 125 ></TR 126 ></TABLE 127 ></DIV 128 ></BODY 129 ></HTML 130 > 131 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/x34.html iputils-s20161105/doc/x34.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >Historical notes</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="iputils: documentation directory" 11 HREF="t1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="iputils: documentation directory" 14 HREF="t1.html"><LINK 15 REL="NEXT" 16 TITLE="Installation notes" 17 HREF="x89.html"></HEAD 18 ><BODY 19 CLASS="SECT1" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >iputils: documentation directory</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="t1.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="x89.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><DIV 69 CLASS="SECT1" 70 ><H1 71 CLASS="SECT1" 72 ><A 73 NAME="AEN34" 74 >Historical notes</A 75 ></H1 76 ><P 77 >This package appeared as a desperate attempt to bring some life 78 to state of basic networking applets: <B 79 CLASS="COMMAND" 80 >ping</B 81 >, <B 82 CLASS="COMMAND" 83 >traceroute</B 84 > 85 etc. Though it was known that port of BSD <B 86 CLASS="COMMAND" 87 >ping</B 88 > to Linux 89 was basically broken, neither maintainers of well known (and superb) 90 Linux net-tools package nor maintainers of Linux distributions 91 worried about fixing well known bugs, which were reported in linux-kernel 92 and linux-net mail lists for ages, were identified and nevertheless 93 not repaired. So, one day 1001th resuming of the subject happened 94 to be the last straw to break camel's back, I just parsed my hard disks 95 and collected a set of utilities, which shared the following properties:</P 96 ><P 97 ></P 98 ><UL 99 ><LI 100 ><P 101 >Small 102 </P 103 ></LI 104 ><LI 105 ><P 106 >Useful despite of this 107 </P 108 ></LI 109 ><LI 110 ><P 111 >I never seen it was made right 112 </P 113 ></LI 114 ><LI 115 ><P 116 >Not quite trivial 117 </P 118 ></LI 119 ><LI 120 ><P 121 >Demonstrating some important feature of Linux 122 </P 123 ></LI 124 ><LI 125 ><P 126 >The last but not the least, I use it more or less regularly 127 </P 128 ></LI 129 ></UL 130 ><P 131 >This utility set was not supposed to be a reference set or something like 132 that. Most of them were cloned from some originals: 133 <DIV 134 CLASS="INFORMALTABLE" 135 ><P 136 ></P 137 ><A 138 NAME="AEN54" 139 ></A 140 ><TABLE 141 BORDER="1" 142 BGCOLOR="#E0E0E0" 143 CELLSPACING="0" 144 CELLPADDING="4" 145 CLASS="CALSTABLE" 146 ><TBODY 147 ><TR 148 ><TD 149 >ping</TD 150 ><TD 151 >cloned of an ancient NetTools-B-xx</TD 152 ></TR 153 ><TR 154 ><TD 155 >ping6</TD 156 ><TD 157 >cloned of a very old Pedro's utility set</TD 158 ></TR 159 ><TR 160 ><TD 161 >traceroute6</TD 162 ><TD 163 >cloned of NRL Sep 96 distribution</TD 164 ></TR 165 ><TR 166 ><TD 167 >rdisc</TD 168 ><TD 169 >cloned of SUN in.rdisc</TD 170 ></TR 171 ><TR 172 ><TD 173 >clockdiff</TD 174 ><TD 175 >broken out of some BSD timed</TD 176 ></TR 177 ><TR 178 ><TD 179 >tftpd</TD 180 ><TD 181 >it is clone of some ancient NetKit package</TD 182 ></TR 183 ></TBODY 184 ></TABLE 185 ><P 186 ></P 187 ></DIV 188 ></P 189 ><P 190 >Also I added some utilities written from scratch, namely 191 <B 192 CLASS="COMMAND" 193 >tracepath</B 194 >, <B 195 CLASS="COMMAND" 196 >arping</B 197 > and later <B 198 CLASS="COMMAND" 199 >rarpd</B 200 > 201 (the last one does not satisfy all the criteria, I used it two or three 202 times).</P 203 ><P 204 >Hesitated a bit I overcame temptation to add <B 205 CLASS="COMMAND" 206 >traceroute</B 207 >. 208 The variant released by LBNL to that time was mostly sane and bugs 209 in it were mostly not specific to Linux, but main reason was that 210 the latest version of LBNL <B 211 CLASS="COMMAND" 212 >traceroute</B 213 > was not 214 <I 215 CLASS="EMPHASIS" 216 >small</I 217 >, it consisted of several files, 218 used a wicked (and failing with Linux :-)) autoconfiguration etc. 219 So, instead I assembled to iputils a simplistic <B 220 CLASS="COMMAND" 221 >tracepath</B 222 > utility 223 and IPv6 version of traceroute, and published my 224 <A 225 HREF="ftp://ftp.inr.ac.ru/ip-routing/lbl-tools" 226 TARGET="_top" 227 > patches</A 228 >. 229 to LBNL <B 230 CLASS="COMMAND" 231 >traceroute</B 232 > separately.<A 233 NAME="AEN86" 234 HREF="#FTN.AEN86" 235 ><SPAN 236 CLASS="footnote" 237 >[1]</SPAN 238 ></A 239 ></P 240 ></DIV 241 ><H3 242 CLASS="FOOTNOTES" 243 >Notes</H3 244 ><TABLE 245 BORDER="0" 246 CLASS="FOOTNOTES" 247 WIDTH="100%" 248 ><TR 249 ><TD 250 ALIGN="LEFT" 251 VALIGN="TOP" 252 WIDTH="5%" 253 ><A 254 NAME="FTN.AEN86" 255 HREF="x34.html#AEN86" 256 ><SPAN 257 CLASS="footnote" 258 >[1]</SPAN 259 ></A 260 ></TD 261 ><TD 262 ALIGN="LEFT" 263 VALIGN="TOP" 264 WIDTH="95%" 265 ><P 266 >This was mistake. 267 Due to this <B 268 CLASS="COMMAND" 269 >traceroute</B 270 > was in a sad state until recently. 271 Good news, redhat-7.2 seems to add these patches to their traceroute 272 rpm eventually. So, I think I will refrain of suicide for awhile.</P 273 ></TD 274 ></TR 275 ></TABLE 276 ><DIV 277 CLASS="NAVFOOTER" 278 ><HR 279 ALIGN="LEFT" 280 WIDTH="100%"><TABLE 281 SUMMARY="Footer navigation table" 282 WIDTH="100%" 283 BORDER="0" 284 CELLPADDING="0" 285 CELLSPACING="0" 286 ><TR 287 ><TD 288 WIDTH="33%" 289 ALIGN="left" 290 VALIGN="top" 291 ><A 292 HREF="t1.html" 293 ACCESSKEY="P" 294 ><<< Previous</A 295 ></TD 296 ><TD 297 WIDTH="34%" 298 ALIGN="center" 299 VALIGN="top" 300 ><A 301 HREF="t1.html" 302 ACCESSKEY="H" 303 >Home</A 304 ></TD 305 ><TD 306 WIDTH="33%" 307 ALIGN="right" 308 VALIGN="top" 309 ><A 310 HREF="x89.html" 311 ACCESSKEY="N" 312 >Next >>></A 313 ></TD 314 ></TR 315 ><TR 316 ><TD 317 WIDTH="33%" 318 ALIGN="left" 319 VALIGN="top" 320 >iputils: documentation directory</TD 321 ><TD 322 WIDTH="34%" 323 ALIGN="center" 324 VALIGN="top" 325 > </TD 326 ><TD 327 WIDTH="33%" 328 ALIGN="right" 329 VALIGN="top" 330 >Installation notes</TD 331 ></TR 332 ></TABLE 333 ></DIV 334 ></BODY 335 ></HTML 336 > 337 No newline at end of file -
iputils-s20161105
diff -Naur iputils-s20161105.orig/doc/x89.html iputils-s20161105/doc/x89.html
old new 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2 <HTML 3 ><HEAD 4 ><TITLE 5 >Installation notes</TITLE 6 ><META 7 NAME="GENERATOR" 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9 REL="HOME" 10 TITLE="iputils: documentation directory" 11 HREF="t1.html"><LINK 12 REL="PREVIOUS" 13 TITLE="Historical notes" 14 HREF="x34.html"><LINK 15 REL="NEXT" 16 TITLE="Availability" 17 HREF="x109.html"></HEAD 18 ><BODY 19 CLASS="SECT1" 20 BGCOLOR="#FFFFFF" 21 TEXT="#000000" 22 LINK="#0000FF" 23 VLINK="#840084" 24 ALINK="#0000FF" 25 ><DIV 26 CLASS="NAVHEADER" 27 ><TABLE 28 SUMMARY="Header navigation table" 29 WIDTH="100%" 30 BORDER="0" 31 CELLPADDING="0" 32 CELLSPACING="0" 33 ><TR 34 ><TH 35 COLSPAN="3" 36 ALIGN="center" 37 >iputils: documentation directory</TH 38 ></TR 39 ><TR 40 ><TD 41 WIDTH="10%" 42 ALIGN="left" 43 VALIGN="bottom" 44 ><A 45 HREF="x34.html" 46 ACCESSKEY="P" 47 ><<< Previous</A 48 ></TD 49 ><TD 50 WIDTH="80%" 51 ALIGN="center" 52 VALIGN="bottom" 53 ></TD 54 ><TD 55 WIDTH="10%" 56 ALIGN="right" 57 VALIGN="bottom" 58 ><A 59 HREF="x109.html" 60 ACCESSKEY="N" 61 >Next >>></A 62 ></TD 63 ></TR 64 ></TABLE 65 ><HR 66 ALIGN="LEFT" 67 WIDTH="100%"></DIV 68 ><DIV 69 CLASS="SECT1" 70 ><H1 71 CLASS="SECT1" 72 ><A 73 NAME="AEN89" 74 >Installation notes</A 75 ></H1 76 ><P 77 ><KBD 78 CLASS="USERINPUT" 79 >make</KBD 80 > to compile utilities. <KBD 81 CLASS="USERINPUT" 82 >make html</KBD 83 > to prepare 84 html documentation, <KBD 85 CLASS="USERINPUT" 86 >make man</KBD 87 > if you prefer man pages. 88 Nothing fancy, provided you have DocBook package installed.</P 89 ><P 90 ><KBD 91 CLASS="USERINPUT" 92 >make install</KBD 93 > installs <I 94 CLASS="EMPHASIS" 95 >only</I 96 > HTML documentation 97 to <TT 98 CLASS="FILENAME" 99 >/usr/doc/iputils</TT 100 >. It even does not try 101 to install binaries and man pages. If you read historical 102 notes above, the reason should be evident. Most of utilities 103 intersect with utilities distributed in another packages, and 104 making such target rewriting existing installation would be a crime 105 from my side. The decision what variant of <B 106 CLASS="COMMAND" 107 >ping</B 108 > is preferred, 109 how to resolve the conflicts etc. is left to you or to person who 110 assembled an rpm. I vote for variant from <B 111 CLASS="COMMAND" 112 >iputils</B 113 > of course.</P 114 ><P 115 >Anyway, select utilities which you like and install them to the places 116 which you prefer together with their man pages.</P 117 ><P 118 >It is possible that compilation will fail, if you use some 119 funny Linux distribution mangling header files in some unexpected ways 120 (expected ones are the ways of redhat of course :-)). 121 I validate iputils against <A 122 HREF="http://www.asplinux.ru" 123 TARGET="_top" 124 >asplinux</A 125 > 126 distribution, which is inevitably followed by validity with respect 127 to <A 128 HREF="http://www.redhat.com" 129 TARGET="_top" 130 >redhat</A 131 >. 132 If your distribution is one of widely known ones, suse or debian, 133 it also will compile provided snapshot is elder than month or so and 134 someone reported all the problems, if they took place at all.</P 135 ><P 136 ><I 137 CLASS="EMPHASIS" 138 >Anyway, please, do not abuse me complaining about some compilation problems 139 in any distribution different of asplinux or redhat. 140 If you have a fix, please, send it to 141 <A 142 HREF="mailto:kuznet@ms2.inr.ac.ru" 143 TARGET="_top" 144 >me</A 145 >, 146 I will check that it does not break distributions mentioned above 147 and apply it. But I am not going to undertake any investigations, 148 bare reports are deemed to be routed to <TT 149 CLASS="FILENAME" 150 >/dev/null</TT 151 >.</I 152 ></P 153 ></DIV 154 ><DIV 155 CLASS="NAVFOOTER" 156 ><HR 157 ALIGN="LEFT" 158 WIDTH="100%"><TABLE 159 SUMMARY="Footer navigation table" 160 WIDTH="100%" 161 BORDER="0" 162 CELLPADDING="0" 163 CELLSPACING="0" 164 ><TR 165 ><TD 166 WIDTH="33%" 167 ALIGN="left" 168 VALIGN="top" 169 ><A 170 HREF="x34.html" 171 ACCESSKEY="P" 172 ><<< Previous</A 173 ></TD 174 ><TD 175 WIDTH="34%" 176 ALIGN="center" 177 VALIGN="top" 178 ><A 179 HREF="t1.html" 180 ACCESSKEY="H" 181 >Home</A 182 ></TD 183 ><TD 184 WIDTH="33%" 185 ALIGN="right" 186 VALIGN="top" 187 ><A 188 HREF="x109.html" 189 ACCESSKEY="N" 190 >Next >>></A 191 ></TD 192 ></TR 193 ><TR 194 ><TD 195 WIDTH="33%" 196 ALIGN="left" 197 VALIGN="top" 198 >Historical notes</TD 199 ><TD 200 WIDTH="34%" 201 ALIGN="center" 202 VALIGN="top" 203 > </TD 204 ><TD 205 WIDTH="33%" 206 ALIGN="right" 207 VALIGN="top" 208 >Availability</TD 209 ></TR 210 ></TABLE 211 ></DIV 212 ></BODY 213 ></HTML 214 > 215 No newline at end of file