/* * Copyright (c) Contributors, http://opensimulator.org/ * See CONTRIBUTORS.TXT for a full list of copyright holders. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the OpenSimulator Project nor the * names of its contributors may be used to endorse or promote products * derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ using System; using System.Collections.Generic; using System.Reflection; using System.Net; using System.Text; using log4net; using OpenSim.Framework; using OpenSim.Framework.Console; using OpenSim.Framework.Servers.HttpServer; namespace OpenSim.Framework.Servers { public class MainServer { // private static readonly ILog m_log = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType); private static BaseHttpServer instance = null; private static BaseHttpServer unsecureinstance = null; private static Dictionary m_Servers = new Dictionary(); /// /// Control the printing of certain debug messages. /// /// /// If DebugLevel >= 1 then short warnings are logged when receiving bad input data. /// If DebugLevel >= 2 then long warnings are logged when receiving bad input data. /// If DebugLevel >= 3 then short notices about all incoming non-poll HTTP requests are logged. /// If DebugLevel >= 4 then the time taken to fulfill the request is logged. /// If DebugLevel >= 5 then the start of the body of incoming non-poll HTTP requests will be logged. /// If DebugLevel >= 6 then the entire body of incoming non-poll HTTP requests will be logged. /// public static int DebugLevel { get { return s_debugLevel; } set { s_debugLevel = value; lock (m_Servers) foreach (BaseHttpServer server in m_Servers.Values) server.DebugLevel = s_debugLevel; } } private static int s_debugLevel; /// /// Set the main HTTP server instance. /// /// /// This will be used to register all handlers that listen to the default port. /// /// /// Thrown if the HTTP server has not already been registered via AddHttpServer() /// public static BaseHttpServer Instance { get { return instance; } set { lock (m_Servers) { if (!m_Servers.ContainsValue(value)) throw new Exception("HTTP server must already have been registered to be set as the main instance"); instance = value; } } } public static BaseHttpServer UnSecureInstance { get { return unsecureinstance; } set { lock (m_Servers) if (!m_Servers.ContainsValue(value)) throw new Exception("HTTP server must already have been registered to be set as the main instance"); unsecureinstance = value; } } /// /// Get all the registered servers. /// /// /// Returns a copy of the dictionary so this can be iterated through without locking. /// /// public static Dictionary Servers { get { return new Dictionary(m_Servers); } } public static void RegisterHttpConsoleCommands(ICommandConsole console) { console.Commands.AddCommand( "Comms", false, "show http-handlers", "show http-handlers", "Show all registered http handlers", HandleShowHttpHandlersCommand); console.Commands.AddCommand( "Debug", false, "debug http", "debug http []", "Turn on http request logging.", "If in or all and\n" + " level <= 0 then no extra logging is done.\n" + " level >= 1 then short warnings are logged when receiving bad input data.\n" + " level >= 2 then long warnings are logged when receiving bad input data.\n" + " level >= 3 then short notices about all incoming non-poll HTTP requests are logged.\n" + " level >= 4 then the time taken to fulfill the request is logged.\n" + " level >= 5 then a sample from the beginning of the data is logged.\n" + " level >= 6 then the entire data is logged.\n" + " no level is specified then the current level is returned.\n\n" + "If out or all and\n" + " level >= 3 then short notices about all outgoing requests going through WebUtil are logged.\n" + " level >= 4 then the time taken to fulfill the request is logged.\n" + " level >= 5 then a sample from the beginning of the data is logged.\n" + " level >= 6 then the entire data is logged.\n", HandleDebugHttpCommand); } /// /// Turn on some debugging values for OpenSim. /// /// private static void HandleDebugHttpCommand(string module, string[] cmdparams) { if (cmdparams.Length < 3) { MainConsole.Instance.Output("Usage: debug http 0..6"); return; } bool inReqs = false; bool outReqs = false; bool allReqs = false; string subCommand = cmdparams[2]; if (subCommand.ToLower() == "in") { inReqs = true; } else if (subCommand.ToLower() == "out") { outReqs = true; } else if (subCommand.ToLower() == "all") { allReqs = true; } else { MainConsole.Instance.Output("You must specify in, out or all"); return; } if (cmdparams.Length >= 4) { string rawNewDebug = cmdparams[3]; int newDebug; if (!int.TryParse(rawNewDebug, out newDebug)) { MainConsole.Instance.Output("{0} is not a valid debug level", rawNewDebug); return; } if (newDebug < 0 || newDebug > 6) { MainConsole.Instance.Output("{0} is outside the valid debug level range of 0..6", newDebug); return; } if (allReqs || inReqs) { MainServer.DebugLevel = newDebug; MainConsole.Instance.Output("IN debug level set to {0}", newDebug); } if (allReqs || outReqs) { WebUtil.DebugLevel = newDebug; MainConsole.Instance.Output("OUT debug level set to {0}", newDebug); } } else { if (allReqs || inReqs) MainConsole.Instance.Output("Current IN debug level is {0}", DebugLevel); if (allReqs || outReqs) MainConsole.Instance.Output("Current OUT debug level is {0}", WebUtil.DebugLevel); } } private static void HandleShowHttpHandlersCommand(string module, string[] args) { if (args.Length != 2) { MainConsole.Instance.Output("Usage: show http-handlers"); return; } StringBuilder handlers = new StringBuilder(); lock (m_Servers) { foreach (BaseHttpServer httpServer in m_Servers.Values) { handlers.AppendFormat( "Registered HTTP Handlers for server at {0}:{1}\n", httpServer.ListenIPAddress, httpServer.Port); List lst = httpServer.GetGLobalMethodsKeys(); if (lst.Count > 0) { handlers.AppendFormat("* Global query methods ({0}):\n", lst.Count); foreach (string s in lst) handlers.AppendFormat("\t***:{0}\n", s); } lst = httpServer.GetXmlRpcHandlerKeys(); if (lst.Count > 0) { handlers.AppendFormat("* XMLRPC methods ({0}):\n",lst.Count); foreach (string s in lst) handlers.AppendFormat("\t{0}\n", s); } lst = httpServer.GetJsonRpcHandlerKeys(); if (lst.Count > 0) { handlers.AppendFormat("* JSONRPC methods ({0}):\n", lst.Count); foreach (string s in lst) handlers.AppendFormat("\t{0}\n", s); } lst = httpServer.GetIndexPHPHandlerKeys(); if (lst.Count > 0) { handlers.AppendFormat("* index.php methods ({0}):\n", lst.Count); foreach (string s in lst) handlers.AppendFormat("\t{0}\n", s); } lst = httpServer.GetHTTPHandlerKeys(); if (lst.Count > 0) { handlers.AppendFormat("* HTTP ({0}):\n", lst.Count); foreach (string s in lst) handlers.AppendFormat("\t{0}\n", s); } lst = httpServer.GetPollServiceHandlerKeys(); if (lst.Count > 0) { handlers.AppendFormat("* HTTP poll ({0}):\n", lst.Count); foreach (string s in lst) handlers.AppendFormat("\t{0}\n", s); } lst = httpServer.GetLLSDHandlerKeys(); if (lst.Count > 0) { handlers.AppendFormat("* LLSD ({0}):\n", lst.Count); foreach (string s in lst) handlers.AppendFormat("\t{0}\n", s); } lst = httpServer.GetStreamHandlerKeys(); if (lst.Count > 0) { handlers.AppendFormat("* StreamHandlers ({0}):\n", lst.Count); foreach (string s in lst) handlers.AppendFormat("\t{0}\n", s); } lst = httpServer.GetSimpleStreamHandlerKeys(); if (lst.Count > 0) { handlers.AppendFormat("* SimpleStreamHandlers ({0}):\n", lst.Count); foreach (string s in lst) handlers.AppendFormat("\t***:{0}\n", s); } handlers.Append("\n"); } } MainConsole.Instance.Output(handlers.ToString()); } /// /// Register an already started HTTP server to the collection of known servers. /// /// public static void AddHttpServer(BaseHttpServer server) { lock (m_Servers) { if (m_Servers.ContainsKey(server.Port)) throw new Exception(string.Format("HTTP server for port {0} already exists.", server.Port)); m_Servers.Add(server.Port, server); } } /// /// Removes the http server listening on the given port. /// /// /// It is the responsibility of the caller to do clean up. /// /// /// public static bool RemoveHttpServer(uint port) { lock (m_Servers) { if (instance != null && instance.Port == port) instance = null; return m_Servers.Remove(port); } } /// /// Does this collection of servers contain one with the given port? /// /// /// Unlike GetHttpServer, this will not instantiate a server if one does not exist on that port. /// /// /// true if a server with the given port is registered, false otherwise. public static bool ContainsHttpServer(uint port) { lock (m_Servers) return m_Servers.ContainsKey(port); } /// /// Get the default http server or an http server for a specific port. /// /// /// If the requested HTTP server doesn't already exist then a new one is instantiated and started. /// /// /// If 0 then the default HTTP server is returned. public static IHttpServer GetHttpServer(uint port) { return GetHttpServer(port, null); } /// /// Get the default http server, an http server for a specific port /// and/or an http server bound to a specific address /// /// /// If the requested HTTP server doesn't already exist then a new one is instantiated and started. /// /// /// If 0 then the default HTTP server is returned. /// A specific IP address to bind to. If null then the default IP address is used. public static IHttpServer GetHttpServer(uint port, IPAddress ipaddr) { if (port == 0) return Instance; if (instance != null && port == Instance.Port) return Instance; lock (m_Servers) { if (m_Servers.ContainsKey(port)) return m_Servers[port]; m_Servers[port] = new BaseHttpServer(port); if (ipaddr != null) m_Servers[port].ListenIPAddress = ipaddr; m_Servers[port].Start(); return m_Servers[port]; } } public static void Stop() { lock (m_Servers) { foreach (BaseHttpServer httpServer in m_Servers.Values) { httpServer.Stop(true); } } } } }