File

#summary Manually specify SRV records
#labels Stage-Beta

= 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};`.

The special remote hostname `"*"` can be used as a wildcard:
{{{
	srvinjection = { ["*"] = {"xmpp-server.l.google.com", 5269} } -- Use Google's XMPP server for all hostnames
}}}

= 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.8||Works||
||0.7||Works||
||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.