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