--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_telnet_tlsinfo/README.markdown	Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,58 @@
+---
+summary: Telnet command for showing TLS info
+...
+
+Introduction
+============
+
+This module adds two commands to the telnet console, `c2s:showtls()` and
+`s2s:showtls()`. These commands shows TLS parameters, such as ciphers
+and key agreement protocols, of all c2s or s2s connections.
+
+Configuration
+=============
+
+Just add the module to the `modules_enabled` list. There is no other
+configuration.
+
+        modules_enabled = {
+            ...
+                "telnet_tlsinfo";
+        }
+
+Usage
+=====
+
+Simply type `c2s:showtls()` to show client connections or
+`s2s:showtls()` for server-to-server connections. These commands can
+also take a JID for limiting output to matching users or servers.
+
+    s2s:showtls("prosody.im")
+    | example.com   ->  prosody.im
+    |             protocol: TLSv1.1
+    |               cipher: DHE-RSA-AES256-SHA
+    |           encryption: AES(256)
+    |              algbits: 256
+    |                 bits: 256
+    |       authentication: RSA
+    |                  key: DH
+    |                  mac: SHA1
+    |               export: false
+
+  Field            Description
+  ---------------- -------------------------------------------------------------------------------------------------
+  protocol         The protocol used. **Note**: With older LuaSec, this is the protocol that added the used cipher
+  cipher           The OpenSSL cipher string for the currently used cipher
+  encryption       Encryption algorithm used
+  bits, algbits    Secret bits involved in the cipher
+  authentication   The authentication algoritm used
+  mac              Message authentication algorithm used
+  key              Key exchange mechanism used.
+  export           Whethere an export cipher is used
+
+Compatibility
+=============
+
+  --------------------- -------
+  0.9 with LuaSec 0.5   Works
+  --------------------- -------