# HG changeset patch
# User Waqas Hussain <waqas20@gmail.com>
# Date 1258994408 -18000
# Node ID 90b363bc0fb849c580d5ea5d8bb3b2839b0b61b9
# Parent  f18d4607c52d1a062e21df251d815497c43b4f7a
mod_srvinjection: Initial documentation commit.

diff -r f18d4607c52d -r 90b363bc0fb8 mod_srvinjection.wiki
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_srvinjection.wiki	Mon Nov 23 21:40:08 2009 +0500
@@ -0,0 +1,38 @@
+#summary Manually specify SRV records
+#labels Stage-Alpha
+
+= Introduction =
+This Prosody plugin lets you manually override SRV records used for a remote host.
+
+= Usage =
+Simply add `"srvinjection"` to your `modules_enabled` list to enable. Then add the `srvinjection` option to the global section.
+
+= Configuration =
+The `srvinjection` option can be used as follows:
+
+{{{
+srvinjection = {
+  ["example.com"] = {"localhost", 5000};
+  ["jabber.org"] = {"localhost", 5001};
+};
+}}}
+
+The format for individual items is `["remote-hostname"] = {"srv-hostname", srv-port};`.
+
+= Reloading =
+The module can be reloaded via the telnet console. Edit the config file to make any updates.
+
+You can reload the configuration from disk:
+{{{
+config:reload()
+}}}
+And then reload the module to apply the configuration changes:
+{{{
+module:reload("srvinjection", "*")
+}}}
+
+= Compatibility =
+||0.6||Works||
+
+= How it works =
+The module replaces the `lookup` function of the `net.adns` module with its own. The original is set back when the module is unloaded.