Diff

mod_compression/README.markdown @ 2482:c96a53b0b820

mod_compression: Import from Prosody, revision 0c69305ab525
author Kim Alvefur <zash@zash.se>
date Sun, 05 Feb 2017 14:40:51 +0100
child 2483:b3097323278f
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_compression/README.markdown	Sun Feb 05 14:40:51 2017 +0100
@@ -0,0 +1,51 @@
+While the bandwidth usage of XMPP isn't great, compressing the data sent
+to/from your server can give significant benefits to those on slow
+connections, such as dial-up or mobile networks. Prosody supports
+compression for client-to-server (if your client supports it) and
+server-to-server streams using the mod\_compression plugin.
+
+# Details
+
+mod\_compression implements
+[XEP-0138](http://xmpp.org/extensions/xep-0138.html "http://xmpp.org/extensions/xep-0138.html"){.urlextern},
+and supports the zlib compression algorithm.
+
+## Dependencies
+
+The XMPP protocol specifies that all clients and servers supporting
+compression must support the "zlib" compression method, and this is what
+Prosody uses. However you will need to install zlib support for Lua on
+your system. There are different ways of doing this depending on your
+system. If in doubt whether it is installed correctly, the command \`lua
+-lzlib\` in a console should open a Lua prompt with no errors.
+
+For more information on obtaining lua-zlib for your platform, see our
+[dependencies page](/doc/depends#lua-zlib "doc:depends"){.wikilink1}.
+
+# Usage
+
+``` lua
+modules_enabled = {
+    -- Other modules
+    "compression"; -- Enable mod_compression
+}
+```
+
+Configuration
+-------------
+
+  Option               Default   Notes
+  -------------------- --------- --------------------------------------------------------------------------------------------------------------------
+  compression\_level   7         Can be a number from 1 to 9, where 9 is best. Higher compression levels will use more resources but less bandwidth
+
+Example
+-------
+
+``` lua
+modules_enabled = {
+    -- Other modules
+    "compression"; -- Enable mod_compression
+}

+compression_level = 5
+```