[bug-inetutils] Re: Incomplete usage info for telnetd

[Simon Josefsson]

Mats Erik Andersson <address@hidden> writes:

> Hello,
>
> the Texinfo page for Telnetd is seriously lacking essential
> information. Let me propose the following additions. They
> have been compiled from the source 'telnetd/telnetd.c'.

Hi.  Thanks for the patch.  I installed it after fixing a small typo,
see complete patch below.  I suspect there is much more to be added for
the man pages, though!  More patches welcome.

Btw, if you want to contribute more, you will need to sign over the
copyright on your contributions to the FSF.  I can send you forms
privately.  (Or did you already do this?)

Thanks,
/Simon

diff --git a/ChangeLog b/ChangeLog
index c057134..cc71dbc 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2010-08-20  Simon Josefsson  <address@hidden>
 
+       * doc/inetutils.texi (telnetd invocation): Document --authmode and
+       --debug values.  Tiny patch from Mats Erik Andersson
+       <address@hidden>.
+
+2010-08-20  Simon Josefsson  <address@hidden>
+
        * src/logger.c: Include sys/uio.h for writev.  Suggested by Mats
        Erik Andersson <address@hidden>.
 
diff --git a/doc/inetutils.texi b/doc/inetutils.texi
index bf3537c..72f5980 100644
--- a/doc/inetutils.texi
+++ b/doc/inetutils.texi
@@ -3316,11 +3316,25 @@ telnetd address@hidden@dots{}
 @table @option
 @item -a AUTHMODE
 @itemx --authmode=AUTHMODE
-Specify what mode to use for authentication.
+Specify what mode to use for authentication. Allowed values
+are: @samp{none}, @samp{other}, @samp{user}, @samp{valid},
+and @samp{off}.
 
 @item -D[LEVEL]
 @itemx --debug=[LEVEL]
-Set debugging level.
+Set the debugging level. The argument is a comma separated list
+of the categories: @samp{options}, @samp{report}, @samp{netdata},
address@hidden, and @samp{auth}. All these may be used in the
+form @samp{name[=level]}. Omission of @samp{level} implies the
+maximal possible debugging for that particular category.
+
+There is one additional category @samp{tcp}, that does not allow
+the additional level indicator, but is instead equivalent to
+setting the socket option @samp{SO_DEBUG} for debugging the
+complete traffic.
+
+The outcome is the file @file{/var/telnet.debug}, to which
+data is incrementally added as time passes.
 
 @item    -E
 @itemx --exec-login=STRING