view mod_srvinjection.wiki @ 155:7aa92b889524

Expand introduction and note that this plugin is not needed for 0.8+
author MWild1
date Sat, 16 Oct 2010 18:47:19 +0000
parents 90b363bc0fb8
children 5417e7610ad4
line wrap: on
line source

#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.