core/portmanager.lua

   1 local config = require "core.configmanager";
   2 local certmanager = require "core.certmanager";
   3 local server = require "net.server";
   4
   5 local log = require "util.logger".init("portmanager");
   6 local multitable = require "util.multitable";
   7 local set = require "util.set";
   8
   9 local table = table;
  10 local setmetatable, rawset, rawget = setmetatable, rawset, rawget;
  11 local type, tonumber, ipairs, pairs = type, tonumber, ipairs, pairs;
  12
  13 local prosody = prosody;
  14 local fire_event = prosody.events.fire_event;
  15
  16 module "portmanager";
  17
  18 --- Config
  19
  20 local default_interfaces = { "*" };
  21 local default_local_interfaces = { "127.0.0.1" };
  22 if config.get("*", "use_ipv6") then
  23         table.insert(default_interfaces, "::");
  24         table.insert(default_local_interfaces, "::1");
  25 end
  26
  27 --- Private state
  28
  29 -- service_name -> { service_info, ... }
  30 local services = setmetatable({}, { __index = function (t, k) rawset(t, k, {}); return rawget(t, k); end });
  31
  32 -- service_name, interface (string), port (number)
  33 local active_services = multitable.new();
  34
  35 --- Private helpers
  36
  37 local function error_to_friendly_message(service_name, port, err)
  38         local friendly_message = err;
  39         if err:match(" in use") then
  40                 -- FIXME: Use service_name here
  41                 if port == 5222 or port == 5223 or port == 5269 then
  42                         friendly_message = "check that Prosody or another XMPP server is "
  43                                 .."not already running and using this port";
  44                 elseif port == 80 or port == 81 then
  45                         friendly_message = "check that a HTTP server is not already using "
  46                                 .."this port";
  47                 elseif port == 5280 then
  48                         friendly_message = "check that Prosody or a BOSH connection manager "
  49                                 .."is not already running";
  50                 else
  51                         friendly_message = "this port is in use by another application";
  52                 end
  53         elseif err:match("permission") then
  54                 friendly_message = "Prosody does not have sufficient privileges to use this port";
  55         end
  56         return friendly_message;
  57 end
  58
  59 prosody.events.add_handler("item-added/net-provider", function (event)
  60         local item = event.item;
  61         register_service(item.name, item);
  62 end);
  63 prosody.events.add_handler("item-removed/net-provider", function (event)
  64         local item = event.item;
  65         unregister_service(item.name, item);
  66 end);
  67
  68 --- Public API
  69
  70 function activate(service_name)
  71         local service_info = services[service_name][1];
  72         if not service_info then
  73                 return nil, "Unknown service: "..service_name;
  74         end
  75
  76         local listener = service_info.listener;
  77
  78         local config_prefix = (service_info.config_prefix or service_name).."_";
  79         if config_prefix == "_" then
  80                 config_prefix = "";
  81         end
  82
  83         local bind_interfaces = config.get("*", config_prefix.."interfaces")
  84                 or config.get("*", config_prefix.."interface") -- COMPAT w/pre-0.9
  85                 or (service_info.private and default_local_interfaces)
  86                 or config.get("*", "interfaces")
  87                 or config.get("*", "interface") -- COMPAT w/pre-0.9
  88                 or listener.default_interface -- COMPAT w/pre0.9
  89                 or default_interfaces
  90         bind_interfaces = set.new(type(bind_interfaces)~="table" and {bind_interfaces} or bind_interfaces);
  91
  92         local bind_ports = set.new(config.get("*", config_prefix.."ports")
  93                 or service_info.default_ports
  94                 or {service_info.default_port
  95                     or listener.default_port -- COMPAT w/pre-0.9
  96                    });
  97
  98         local mode, ssl = listener.default_mode or "*a";
  99
 100         for interface in bind_interfaces do
 101                 for port in bind_ports do
 102                         port = tonumber(port);
 103                         if #active_services:search(nil, interface, port) > 0 then
 104                                 log("error", "Multiple services configured to listen on the same port ([%s]:%d): %s, %s", interface, port, active_services:search(nil, interface, port)[1][1].service.name or "<unnamed>", service_name or "<unnamed>");
 105                         else
 106                                 local err;
 107                                 -- Create SSL context for this service/port
 108                                 if service_info.encryption == "ssl" then
 109                                         local ssl_config = config.get("*", config_prefix.."ssl");
 110                                         ssl, err = certmanager.create_context(service_info.name.." port "..port, "server", ssl_config and (ssl_config[port]
 111                                                 or (ssl_config.certificate and ssl_config)));
 112                                         if not ssl then
 113                                                 log("error", "Error binding encrypted port for %s: %s", service_info.name, error_to_friendly_message(service_name, port, err) or "unknown error");
 114                                         end
 115                                 end
 116                                 if not err then
 117                                         -- Start listening on interface+port
 118                                         local handler, err = server.addserver(interface, port, listener, mode, ssl);
 119                                         if not handler then
 120                                                 log("error", "Failed to open server port %d on %s, %s", port, interface, error_to_friendly_message(service_name, port, err));
 121                                         else
 122                                                 log("debug", "Added listening service %s to [%s]:%d", service_name, interface, port);
 123                                                 active_services:add(service_name, interface, port, {
 124                                                         server = handler;
 125                                                         service = service_info;
 126                                                 });
 127                                         end
 128                                 end
 129                         end
 130                 end
 131         end
 132         log("info", "Activated service '%s'", service_name);
 133         return true;
 134 end
 135
 136 function deactivate(service_name, service_info)
 137         for name, interface, port, n, active_service
 138                 in active_services:iter(service_name or service_info and service_info.name, nil, nil, nil) do
 139                 if service_info == nil or active_service.service == service_info then
 140                         close(interface, port);
 141                 end
 142         end
 143         log("info", "Deactivated service '%s'", service_name or service_info.name);
 144 end
 145
 146 function register_service(service_name, service_info)
 147         table.insert(services[service_name], service_info);
 148
 149         if not active_services:get(service_name) then
 150                 log("debug", "No active service for %s, activating...", service_name);
 151                 local ok, err = activate(service_name);
 152                 if not ok then
 153                         log("error", "Failed to activate service '%s': %s", service_name, err or "unknown error");
 154                 end
 155         end
 156
 157         fire_event("service-added", { name = service_name, service = service_info });
 158         return true;
 159 end
 160
 161 function unregister_service(service_name, service_info)
 162         log("debug", "Unregistering service: %s", service_name);
 163         local service_info_list = services[service_name];
 164         for i, service in ipairs(service_info_list) do
 165                 if service == service_info then
 166                         table.remove(service_info_list, i);
 167                 end
 168         end
 169         deactivate(nil, service_info);
 170         if #service_info_list > 0 then -- Other services registered with this name
 171                 activate(service_name); -- Re-activate with the next available one
 172         end
 173         fire_event("service-removed", { name = service_name, service = service_info });
 174 end
 175
 176 function close(interface, port)
 177         local service, server = get_service_at(interface, port);
 178         if not service then
 179                 return false, "port-not-open";
 180         end
 181         server:close();
 182         active_services:remove(service.name, interface, port);
 183         log("debug", "Removed listening service %s from [%s]:%d", service.name, interface, port);
 184         return true;
 185 end
 186
 187 function get_service_at(interface, port)
 188         local data = active_services:search(nil, interface, port)[1][1];
 189         return data.service, data.server;
 190 end
 191
 192 function get_service(service_name)
 193         return services[service_name];
 194 end
 195
 196 function get_active_services(...)
 197         return active_services;
 198 end
 199
 200 function get_registered_services()
 201         return services;
 202 end
 203
 204 return _M;