[SCM] GNU Inetutils branch, master, updated. inetutils-1_9_1-270-gef002d9

[Mats Erik Andersson]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU Inetutils ".

The branch, master has been updated
       via  ef002d90516083a93d34d341f383153eadd1c409 (commit)
      from  6e8595711a161a4be05ff091796d6ddc901246e5 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://git.savannah.gnu.org/cgit/inetutils.git/commit/?id=ef002d90516083a93d34d341f383153eadd1c409


commit ef002d90516083a93d34d341f383153eadd1c409
Author: Mats Erik Andersson <address@hidden>
Date:   Wed Apr 10 21:27:06 2013 +0200

    Documentation

diff --git a/ChangeLog b/ChangeLog
index 07caf91..3a5ad04 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2013-04-10  Mats Erik Andersson  <address@hidden>
+
+       * doc/inetutils.texi <main menu>: Order invocation
+       nodes in lexicographical order.
+       <ping6 invocation>: New node.
+
 2013-04-09  Mats Erik Andersson  <address@hidden>
 
        telnet, telnetd: Termcap buffer length recommendation.
diff --git a/doc/inetutils.texi b/doc/inetutils.texi
index 33b779d..ad7870a 100644
--- a/doc/inetutils.texi
+++ b/doc/inetutils.texi
@@ -36,6 +36,7 @@
 * inetd: (inetutils)inetd invocation.             Internet super-server.
 * logger: (inetutils)logger invocation.           Send messages to the system 
log.
 * ping: (inetutils)ping invocation.               Packets to network hosts.
+* ping6: (inetutils)ping6 invocation.             Packets to IPv6 network 
hosts.
 * rcp: (inetutils)rcp invocation.                 Remote copy
 * rexec: (inetutils)rexec invocation.             Remote execution client.
 * rexecd: (inetutils)rexecd invocation.           Remote execution server.
@@ -99,35 +100,36 @@ Documentation License''.
 
 Diagnostic programs
 
-* hostname invocation::                Show or set system host name.
 * dnsdomainname invocation::           Show DNS domain name.
+* hostname invocation::                Show or set system host name.
 * logger invocation::                  Send messages to system log.
 * ping invocation::                    Packets to network hosts.
+* ping6 invocation::                   Packets to IPv6 network hosts.
 * traceroute invocation::              Trace the route to a host.
 * whois invocation::                   Whois user interface.
 
 Clients
 
 * ftp invocation::                     FTP client.
-* tftp invocation::                    TFTP client.
-* rsh invocation::                     Remote shell.
-* rlogin invocation::                  Remote login.
 * rcp invocation::                     Remote copy
 * rexec invocation::                   Remote execution client.
+* rlogin invocation::                  Remote login.
+* rsh invocation::                     Remote shell.
 * talk invocation::                    Talk client.
 * telnet invocation::                  User interface to TELNET.
+* tftp invocation::                    TFTP client.
 
 Daemons
 
-* inetd invocation::                   Internet super-server.
-* syslogd invocation::                 Syslog server.
 * ftpd invocation::                    FTP Daemon.
-* tftpd invocation::                   TFTP server.
-* rshd invocation::                    Remote shell server.
-* rlogind invocation::                 Remote login server.
+* inetd invocation::                   Internet super-server.
 * rexecd invocation::                  Remote execution server.
+* rlogind invocation::                 Remote login server.
+* rshd invocation::                    Remote shell server.
+* syslogd invocation::                 Syslog server.
 * talkd invocation::                   Talk server.
 * telnetd invocation::                 Telnet server.
+* tftpd invocation::                   TFTP server.
 * uucpd invocation::                   Unix to Unix Copy.
 
 * GNU Free Documentation License::     The license for this manual.
@@ -504,7 +506,7 @@ an arbitrary number of @dfn{padding} bytes used to fill out 
the packet.
 Synopsis:
 
 @example
-ping address@hidden@dots{}] @address@hidden
+ping address@hidden@dots{}] @var{host}
 @end example
 
 @noindent
@@ -591,7 +593,7 @@ Stop after sending and receiving answers to a total of
 @var{n} packets.
 
 @item -d
address@hidden -debug
address@hidden --debug
 @opindex -d
 @opindex --debug
 Set the SO_DEBUG option on the socket being used.
@@ -861,6 +863,164 @@ to ICMP_MASKREQ packets, but in general, Unices are 
designed either
 to answer the request with a valid netmask, or to drop the request,
 causing @command{ping} to wait for a timeout condition.
 
address@hidden ping6 invocation
address@hidden @command{ping6}: Packets to IPv6 network hosts
address@hidden ping6
+
address@hidden uses ICMPv6 datagrams to get a response
+from the chosen destination host.
+The most common use is to probe whether the remote
+system is responsive.
+Observe that this program only uses IPv6 datagrams.
+
+Each datagram, of type @code{ECHO_REQUEST}, carries some header
+information and some additional payload, usually a time stamp.
+Making a suitable choice of payload, it is possible to probe
+different host or router properties on the way as the emitted
+datagram travels to its destination.
+
address@hidden
+Synopsis:
+
address@hidden
+ping6 address@hidden@dots{}] @var{host}
address@hidden example
+
address@hidden
+Sending simple, timed echo requests is the standard use
+of @command{ping6}, but is by far not the only use case.
+
+This command is a close parallel to @command{ping},
+except that it handles IPv6 and is thus not able
+to handle peculiarities of IPv4.
+
address@hidden Command line options
address@hidden options}
+
address@hidden @option
address@hidden -c @var{n}
address@hidden address@hidden
address@hidden -c
address@hidden --count
+Stop after sending and receiving answers to a total of
address@hidden packets.
+
address@hidden -d
address@hidden --debug
address@hidden -d
address@hidden --debug
+Set the SO_DEBUG option on the socket being used.
+
address@hidden -f
address@hidden --flood
address@hidden -f
address@hidden --flood
+Flood ping.
+Outputs packets as fast as they come back,
+or one hundred times per second, whichever is more.
+For every ECHO_REQUEST packet sent, a period @samp{.} is printed,
+while for every ECHO_REPLY received in reply, a backspace is printed.
+
+This provides a rapid display of how many packets are being dropped.
+Only the super-user may use this option.
+This mode can be very hard on a network.
+It should be used with caution!
+
address@hidden address@hidden
address@hidden --hoplimit
+Limit maximal distance to @var{n}.
+Acceptable values are 1 to 255, inclusive.
+
address@hidden -i @var{n}
address@hidden address@hidden
address@hidden -i
address@hidden --interval
+Wait @var{n} seconds until sending next packet.
+The default is to wait for one second between packets.
+This option is incompatible with the option @option{-f}.
+
address@hidden -l @var{n}
address@hidden address@hidden
address@hidden -l
address@hidden --preload
+Sends @var{n} packets as fast as possible before falling
+back to the normal mode of operation.
+
address@hidden -n
address@hidden --numeric
address@hidden -n
address@hidden --numeric
+Numeric output only.
+No attempt will be made to resolve symbolic names for host addresses.
+
address@hidden -p @var{pattern}
address@hidden address@hidden
address@hidden -p
address@hidden --pattern
+Up to 16 hexadecimal pad bytes are given as @var{pattern}.
+These are use for filling out the packets you send.
+This option is useful for diagnosing data-dependent problems
+within a network.
+As an example, @option{-p ff} will cause the sent packets
+to have payloads with every bit set to one.
+
address@hidden -q
address@hidden --quiet
address@hidden -q
address@hidden --quiet
+Do not print timing result of each transmitted packet.
+
address@hidden -r
address@hidden --ignore-routing
address@hidden -r
address@hidden --ignore-routing-log
+Bypass the normal routing tables and send directly
+to a host on an attached network.
+If the host is not on a directly attached network,
+an error is returned.
+This option can be used to ping a local host
+through an interface, for which there is no
+assigned route, such as when the interface
+was dropped by @command{routed}.
+
address@hidden -s @var{n}
address@hidden address@hidden
address@hidden -s
address@hidden --size
+Specifies the number of data bytes to be sent.  The default is 56,
+which translates into address@hidden data bytes, taking
+the address@hidden of ICMP header data into account.
+
address@hidden -T @var{num}
address@hidden address@hidden
address@hidden -T
address@hidden --tos
+Set the traffic class to @var{num} on transmitted packets.
+
address@hidden address@hidden
address@hidden --ttl
+Synonym for @option{--hoplimit}.
+
address@hidden -v
address@hidden --verbose
address@hidden -v
address@hidden --verbose
+Produce more verbose output, giving more statistics.
+
address@hidden -w @var{n}
address@hidden address@hidden
address@hidden -w
address@hidden --timeout
+Stop after @var{n} seconds.
address@hidden table
+
+The documentation of @command{ping} provides several
+pieces of information, and discussions, relevant to
+the use of @command{ping6}.
+Keep in mind, though, that the differing address family
+causes some discrepancy.
address@hidden invocation}.
+
 @node traceroute invocation
 @chapter @command{traceroute}: Trace the route to a host
 @cindex traceroute

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog          |    6 ++
 doc/inetutils.texi |  182 ++++++++++++++++++++++++++++++++++++++++++++++++---
 2 files changed, 177 insertions(+), 11 deletions(-)


hooks/post-receive
-- 
GNU Inetutils