[SCM] GNU Inetutils branch, master, updated. inetutils-1_9_4-14-gd898738

[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  d898738601cf65e6f6d9fb98c4ee9aa938d4899d (commit)
      from  7655d892c2a10adb6b1a8681253a96cf610cff46 (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=d898738601cf65e6f6d9fb98c4ee9aa938d4899d


commit d898738601cf65e6f6d9fb98c4ee9aa938d4899d
Author: Mats Erik Andersson <address@hidden>
Date:   Tue Sep 15 18:17:30 2015 +0200

    First documentation of ifconfig.

diff --git a/ChangeLog b/ChangeLog
index 6ef514f..c3302ef 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2015-09-15  Mats Erik Andersson  <address@hidden>
+
+       * doc/inetutils.texi (ifconfig invocation): New chapter.
+
 2015-08-19  Mats Erik Andersson  <address@hidden>
 
        AIX systems have a system call send_file().  Rename our calls.
diff --git a/doc/inetutils.texi b/doc/inetutils.texi
index 775b9a8..bc88a20 100644
--- a/doc/inetutils.texi
+++ b/doc/inetutils.texi
@@ -31,6 +31,7 @@
 * ftp: (inetutils)ftp invocation.                 FTP client.
 * ftpd: (inetutils)ftpd invocation.               FTP Daemon.
 * hostname: (inetutils)hostname invocation.       Show or set system host name.
+* ifconfig: (inetutils)ifconfig invocation.       Configure network interfaces.
 * inetd: (inetutils)inetd invocation.             Internet super-server.
 * logger: (inetutils)logger invocation.           Send messages to the system 
log.
 * ping6: (inetutils)ping6 invocation.             Packets to IPv6 network 
hosts.
@@ -99,6 +100,7 @@ Diagnostic programs
 
 * dnsdomainname invocation::           Show DNS domain name.
 * hostname invocation::                Show or set system host name.
+* ifconfig invocation::                Configure network interfaces.
 * logger invocation::                  Send messages to system log.
 * ping invocation::                    Packets to network hosts.
 * ping6 invocation::                   Packets to IPv6 network hosts.
@@ -321,6 +323,202 @@ Get short host name.
 Get NIS/YP domain name.
 @end table
 
address@hidden ifconfig invocation
address@hidden @command{ifconfig}: Configure network interfaces
address@hidden ifconfig
+
address@hidden is a program to retrieve and to set selected
+properties of network interfaces.  It is best viewed as a tool to
+get information, rather than for changing the behaviour of adapters,
+since it is hard to support property setting in a portable manner.
+
address@hidden
+Synopsis:
+
address@hidden
+ifconfig @var{iface} address@hidden@dots{}]
+ifconfig -i @var{iface} address@hidden@dots{}] [-i @var{iface2} 
address@hidden@dots{}]]
address@hidden example
+
address@hidden Command line options
address@hidden options}
+
address@hidden @option
address@hidden -a
address@hidden --all
address@hidden -a
address@hidden --all
+Display all available interfaces, including those that not are
+marked as `up', i.e., also the inactive interfaces.
+
address@hidden -A @var{addr}
address@hidden address@hidden
address@hidden -A
address@hidden --address
+Set address of selected interface to @var{addr}.
+
address@hidden -b @var{addr}
address@hidden -B @var{addr}
address@hidden address@hidden
address@hidden address@hidden
address@hidden -b
address@hidden -B
address@hidden --brdaddr
address@hidden --broadcast
+Set broadcast address of selected interface to @var{addr}.
+
address@hidden -d @var{addr}
address@hidden -p @var{addr}
address@hidden address@hidden
address@hidden address@hidden
address@hidden -d
address@hidden -p
address@hidden --dstaddr
address@hidden --peer
+Set destination (peer) address of selected interface.
+
address@hidden --down
address@hidden --down
+Deactivate the selected interface.
+
address@hidden -F @var{list}
address@hidden address@hidden
address@hidden -F
address@hidden --flags
+Change those interface flags mentioned in @var{list}.
+The argument is a comma separated list of one ore more
+flag names to be set, or in case the name is prepended
+with @samp{no}, the corresponding flag is cleared.
+The output of @command{ifconfig} with the option @option{--help}
+contains a list of available flag names.
+
address@hidden address@hidden
address@hidden --format
+Select output format; the value @samp{help} prints a list
+of all available formats.
+
address@hidden -i @var{name}
address@hidden address@hidden
address@hidden -i
address@hidden --interface
+Select the named interface for any following action.
+
address@hidden -l
address@hidden --list
address@hidden -l
address@hidden --list
+List, with name only, all available interfaces, or only those
+selected should at least one option @option{-i} have specified.
+
address@hidden -m @var{mask}
address@hidden address@hidden
address@hidden -m
address@hidden --netmask
+Set netmask of selected interface to @var{mask}.
+
address@hidden address@hidden
address@hidden --metric
+Set the metric of selected interface to the number @var{n}.
+
address@hidden -M @var{n}
address@hidden address@hidden
address@hidden -M
address@hidden --mtu
+Set MTU of selected interface to the number @var{n}.
+
address@hidden -s
address@hidden --short
address@hidden -s
address@hidden --short
+Use short output format.  This is identical to specifying
address@hidden
+
address@hidden --up
address@hidden --up
+Activate the selected interface.
+
address@hidden -v
address@hidden --verbose
address@hidden -v
address@hidden --verbose
+Print informational messages when configuring an interface.
address@hidden table
+
+Observe that the use of program options is the only manner
+in which @command{ifconfig} is able to handle multiple
+interfaces in one invocation.  Once a particular interface
+has been selected using @option{-i}, it is affected by any
+following option until replaced by another interface selector.
+This is also the main cause, that @command{ifconfig} is
+unable to treat options independently of their order, as is
+mostly the case in other GNU software.
+
address@hidden Formatted status output
address@hidden formats}
+
+The status of one or more interfaces can be presented in a number
+of different formats.  A list of them is printed by the option
address@hidden  In the following table the valid formats
+are given, each is used in the form @address@hidden
+
address@hidden @asis
address@hidden check
address@hidden check-existence
address@hidden ?
+Place holders for the ability to check whether the interfaces
+selected by one or more options @option{-i} are determining
+existing interfaces in the running system.  No output in case
+of success, an error message in case of a failure.
+
address@hidden gnu
address@hidden default
+Standard GNU output format.
+
address@hidden gnu-one-entry
+Like the previous format, but with intermediary newlines removed.
+
address@hidden help
+Display a list of valid formats, together with a short description
+for each choice.
+
address@hidden net-tools
+Imitation of presentation used by the implementation in @samp{net-tools}.
+Default format for GNU/Linux.
+
address@hidden netstat
+Terse output with statistics, similar to that of @code{netstat -i}.
+
address@hidden osf
+Format variant of @samp{unix} preferred by OSF's implementation.
+
address@hidden unix
+Traditional UNIX type format.  Default for BSD, HPUX and Solaris.
address@hidden table
+
address@hidden Legacy syntax
address@hidden legacy syntax}
+
+The traditional mode of invoking @command{ifconfig} is via
+a parsed command line, without all use of program switches
+and options, relying fully on argument parsing.  This mode
+of use is supported also in the present implementation,
+but keep in mind that only one interface can be manipulated
+using this legacy syntax.
+
address@hidden
+ifconfig NAME [ADDR [DSTADDR]] [broadcast BRDADDR] [netmask MASK]
+         [metric N] [mtu N] [up|down]
address@hidden example
+
+As is conventional, only the primary address and possibly the
+peer destination address are stated as bare arguments, without
+a specifying keyword.
+Some slight variation on this syntax will depend on the target
+system for which the program is being built, as not all platforms
+support identical abilities.
+The best information is found via the usage massage
address@hidden --usage}.
+
 @node logger invocation
 @chapter @command{logger}: Send messages to system log
 @pindex logger

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

Summary of changes:
 ChangeLog          |    4 +
 doc/inetutils.texi |  198 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 202 insertions(+), 0 deletions(-)


hooks/post-receive
-- 
GNU Inetutils