[SCM] GNU Inetutils branch, master, updated. inetutils-1_9_2-55-g6b95da1

[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  6b95da18a8c6cff38bc212a20a6bd9d1333ee956 (commit)
      from  fa3245ac8c288b87139a0da8249d0a408c4dfb87 (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=6b95da18a8c6cff38bc212a20a6bd9d1333ee956


commit 6b95da18a8c6cff38bc212a20a6bd9d1333ee956
Author: Mats Erik Andersson <address@hidden>
Date:   Fri Mar 20 14:34:59 2015 +0100

    telnetd: Texinfo documentation.

diff --git a/ChangeLog b/ChangeLog
index 6f868c3..a0e7a58 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2015-03-20  Mats Erik Andersson  <address@hidden>
+
+       telnetd: Texinfo documentation.
+
+       * doc/inetutils.texi (telnetd invocation): Add a section
+       on the use of replacement tokens in the execution string.
+
 2015-03-19  Mats Erik Andersson  <address@hidden>
 
        telnetd: Enable autologin in legacy mode.
diff --git a/doc/inetutils.texi b/doc/inetutils.texi
index ef7e74c..bd82a7c 100644
--- a/doc/inetutils.texi
+++ b/doc/inetutils.texi
@@ -4980,6 +4980,112 @@ is to be disabled.  Standard choices are @samp{null},
 @samp{kerberos_v4}, and @samp{kerberos_v5}.
 @end table
 
address@hidden Crafting an execution string.
+
+The server @command{telnetd} contains a built-in execution string
+which invokes @command{login} with arguments suitable for the
+operating system at hand.  This preset choice corresponds to the
+standard use case of the service.  For specialized purposes
+this implementation also offers a command line option @option{-E},
+or @option{--exec-login}, to override the built-in execution of
address@hidden, thus allowing almost any choice of handler.
+
address@hidden
+A custom execution string could look like
+
address@hidden
+telnetd -h -E '/usr/local/sbin/avrop  %t %U'
address@hidden example
+
address@hidden
+The execution string must as its first part provide an absolute
+path to an executable file.  After that may follow arbitrary
+additional arguments.
+For this latter part, @command{telnetd} offers some replacement
+tokens that dynamically are replaced by content.  All are of
+the form @code{%<var>}, where @samp{<var>} is a single letter
+from the following collection of selectors.
+A valid letter is called @dfn{variable}.
+The mark @emph{conditional}, appearing below, indicates that the
+corresponding variable is conditionally assigned a value.
+
address@hidden @code
address@hidden %a
address@hidden %a
+Returns @samp{ok} whenever authentication is complete. @emph{conditional}
+
address@hidden %d
address@hidden %d
+Produces a time and date string.
+
address@hidden %h
address@hidden %h
+Gives the remote host name in canonical form.
+
address@hidden %l
address@hidden %l
+States the local host name, also in canonical form.
+
address@hidden %L
address@hidden %L
+Returns the path of the pseudo terminal assigned to the client.
+
address@hidden %t
address@hidden %t
+Gives the terminal device stripped of the leading @samp{/dev/}.
+
address@hidden %T
address@hidden %T
+States the terminal type, like @samp{xterm}. @emph{conditional}
+
address@hidden %u
address@hidden %u
+Provides the authenticated user name. @emph{conditional}
+
address@hidden %U
address@hidden %U
+Returns the user name passed as an environment variable @env{USER}
+by the remote client software.  The value is empty, should the
+environment not provide a value.
+
address@hidden table
+
+In addition, a conditional construct is able to take one action
+in case a variable has an assigned value, and optionally to take
+another action in the opposite case.  The contruct is
+
address@hidden
+%?<var>@address@hidden@address@hidden
address@hidden example
+
address@hidden
+The braces are here mandatory, while the brackets enclose the optional
+else-clause and are not included in actual use.
+The initial, motivating example, could thus be expanded to read
+
address@hidden
+telnetd -h -E '/usr/local/sbin/avrop  %t address@hidden 
address@hidden@address@hidden'
address@hidden example
+
address@hidden
+In case authentication was completed as user @samp{sigge},
+the execution string would resolve to
+
address@hidden
+/usr/local/sbin/avrop  pts/1 sigge krb5
address@hidden smallexample
+
address@hidden
+In all other cases the result would be
+
address@hidden
+/usr/local/sbin/avrop  pts/1 $USER
address@hidden smallexample
+
address@hidden
+where @code{$USER} is the value of the corresponding environment
+variable and could possibly be empty.
+
 @node uucpd invocation
 @chapter @command{uucpd}: Unix to Unix Copy relay daemon.
 @cindex uucpd

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

Summary of changes:
 ChangeLog          |    7 +++
 doc/inetutils.texi |  106 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 113 insertions(+), 0 deletions(-)


hooks/post-receive
-- 
GNU Inetutils