view mod_srvinjection.wiki @ 96:90b363bc0fb8

mod_srvinjection: Initial documentation commit.
author Waqas Hussain <waqas20@gmail.com>
date Mon, 23 Nov 2009 21:40:08 +0500
parents
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.