1 #summary Manually specify SRV records

     2 #labels Stage-Beta

     3 

     4 = Introduction =

     5 This Prosody plugin lets you manually override SRV records used for a remote host.

     6 

     7 = Usage =

     8 Simply add `"srvinjection"` to your `modules_enabled` list to enable. Then add the `srvinjection` option to the global section.

     9 

    10 = Configuration =

    11 The `srvinjection` option can be used as follows:

    12 

    13 {{{

    14 srvinjection = {

    15   ["example.com"] = {"localhost", 5000};

    16   ["jabber.org"] = {"localhost", 5001};

    17 };

    18 }}}

    19 

    20 The format for individual items is `["remote-hostname"] = {"srv-hostname", srv-port};`.

    21 

    22 The special remote hostname `"*"` can be used as a wildcard:

    23 {{{

    24 	srvinjection = { ["*"] = {"xmpp-server.l.google.com", 5269} } -- Use Google's XMPP server for all hostnames

    25 }}}

    26 

    27 = Reloading =

    28 The module can be reloaded via the telnet console. Edit the config file to make any updates.

    29 

    30 You can reload the configuration from disk:

    31 {{{

    32 config:reload()

    33 }}}

    34 And then reload the module to apply the configuration changes:

    35 {{{

    36 module:reload("srvinjection", "*")

    37 }}}

    38 

    39 = Compatibility =

    40 ||0.8||Works||

    41 ||0.7||Works||

    42 ||0.6||Works||

    43 

    44 = How it works =

    45 The module replaces the `lookup` function of the `net.adns` module with its own. The original is set back when the module is unloaded.