]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/configreader.h
Change to virtual
[user/henk/code/inspircd.git] / include / configreader.h
index c4275ab5f03eebbb3b2a16511705bfa0a5c8ad56..022978766850785dc143ac4c4d5d7c4368279515 100644 (file)
 #ifndef INSPIRCD_CONFIGREADER
 #define INSPIRCD_CONFIGREADER
 
+/* handy defines */
+
+/** Determines if a channel op is exempt from given mode m,
+ * in config of server instance s. 
+ */
+#define CHANOPS_EXEMPT(s, m) (s->Config->ExemptChanOps[(unsigned char)m])
+
 #include <sstream>
 #include <string>
 #include <vector>
@@ -24,6 +31,7 @@
 #include "socketengine.h"
 #include "socket.h"
 
+/* Required forward definitions */
 class ServerConfig;
 class InspIRCd;
 class InspSocket;
@@ -32,11 +40,11 @@ class InspSocket;
  */
 enum ConfigDataType
 {
-       DT_NOTHING       = 0,
-       DT_INTEGER       = 1,
-       DT_CHARPTR       = 2,
-       DT_BOOLEAN       = 3,
-       DT_ALLOW_NEWLINE = 128
+       DT_NOTHING       = 0,           /* No data */
+       DT_INTEGER       = 1,           /* Integer */
+       DT_CHARPTR       = 2,           /* Char pointer */
+       DT_BOOLEAN       = 3,           /* Boolean */
+       DT_ALLOW_NEWLINE = 128          /* New line characters allowed */
 };
 
 /** Holds a config value, either string, integer or boolean.
@@ -47,16 +55,26 @@ enum ConfigDataType
  */
 class ValueItem
 {
+       /** Actual data */
        std::string v;
  public:
+       /** Initialize with an int */
        ValueItem(int value);
+       /** Initialize with a bool */
        ValueItem(bool value);
+       /** Initialize with a char pointer */
        ValueItem(char* value);
+       /** Change value to a char pointer */
        void Set(char* value);
+       /** Change value to a const char pointer */
        void Set(const char* val);
+       /** Change value to an int */
        void Set(int value);
+       /** Get value as an int */
        int GetInteger();
+       /** Get value as a string */
        char* GetString();
+       /** Get value as a bool */
        bool GetBool();
 };
 
@@ -66,7 +84,9 @@ class ValueItem
 class ValueContainerBase
 {
  public:
+       /** Constructor */
        ValueContainerBase() { }
+       /** Destructor */
        virtual ~ValueContainerBase() { }
 };
 
@@ -80,20 +100,23 @@ class ValueContainerBase
  */
 template<typename T> class ValueContainer : public ValueContainerBase
 {
+       /** Contained item */
        T val;
-
  public:
 
+       /** Initialize with nothing */
        ValueContainer()
        {
                val = NULL;
        }
 
+       /** Initialize with a value of type T */
        ValueContainer(T Val)
        {
                val = Val;
        }
 
+       /** Change value to type T of size s */
        void Set(T newval, size_t s)
        {
                memcpy(val, newval, s);
@@ -137,11 +160,17 @@ typedef bool (*MultiNotify)(ServerConfig* conf, const char*);
  */
 struct InitialConfig
 {
+       /** Tag name */
        char* tag;
+       /** Value name */
        char* value;
+       /** Default, if not defined */
        char* default_value;
+       /** Value containers */
        ValueContainerBase* val;
+       /** Data types */
        ConfigDataType datatype;
+       /** Validation function */
        Validator validation_function;
 };
 
@@ -150,12 +179,19 @@ struct InitialConfig
  */
 struct MultiConfig
 {
+       /** Tag name */
        const char*     tag;
+       /** One or more items within tag */
        char*           items[13];
+       /** One or more defaults for items within tags */
        char*           items_default[13];
+       /** One or more data types */
        int             datatype[13];
+       /** Initialization function */
        MultiNotify     init_function;
+       /** Validation function */
        MultiValidator  validation_function;
+       /** Completion function */
        MultiNotify     finish_function;
 };
 
@@ -173,10 +209,10 @@ typedef std::map<irc::string,char*> operclass_t;
  * and storage of the configuration data needed to run the ircd, such as
  * the servername, connect classes, /ADMIN data, MOTDs and filenames etc.
  */
-class ServerConfig : public Extensible
+class CoreExport ServerConfig : public Extensible
 {
   private:
-       /** Creator/owner
+       /** Creator/owner pointer
         */
        InspIRCd* ServerInstance;
 
@@ -203,6 +239,9 @@ class ServerConfig : public Extensible
   
   public:
 
+       /* Pointer to function that validates dns server addresses (can be changed depending on platform) */
+       Validator DNSServerValidator;
+
        InspIRCd* GetInstance();
          
        /** This holds all the information in the config file,
@@ -227,6 +266,10 @@ class ServerConfig : public Extensible
         * as defined by the administrator.
         */
        char ServerName[MAXBUF];
+
+       /** Notice to give to users when they are Xlined
+        */
+       char MoronBanner[MAXBUF];
        
        /* Holds the network name the local server
         * belongs to. This is an arbitary field defined
@@ -355,6 +398,11 @@ class ServerConfig : public Extensible
         */
        bool HideModeLists[256];
 
+       /** If this is set to true, then channel operators
+        * are exempt from this channel mode. Used for +Sc etc.
+        */
+       bool ExemptChanOps[256];
+
        /** The number of seconds the DNS subsystem
         * will wait before timing out any request.
         */
@@ -422,10 +470,9 @@ class ServerConfig : public Extensible
         */
        char HideWhoisServer[MAXBUF];
 
-       /** A list of IP addresses the server is listening
-        * on.
+       /** Set to a non empty string to obfuscate nicknames prepended to a KILL.
         */
-       char addrs[MAXBUF][255];
+       char HideKillsServer[MAXBUF];
 
        /** The MOTD file, cached in a file_cache type.
         */
@@ -449,13 +496,9 @@ class ServerConfig : public Extensible
         */
        std::vector<std::string> module_names;
 
-       /** A list of ports which the server is listening on
-        */
-       int ports[255];
-
-       /** A list of the file descriptors for the listening client ports
+       /** A list of the classes for listening client ports
         */
-       ListenSocket* openSockfd[255];
+       std::vector<ListenSocket*> ports;
 
        /** Boolean sets of which modules implement which functions
         */
@@ -476,6 +519,9 @@ class ServerConfig : public Extensible
         * modules.
         */
        std::string data005;
+
+       /** isupport strings
+        */
        std::vector<std::string> isupport;
 
        /** STATS characters in this list are available
@@ -487,6 +533,10 @@ class ServerConfig : public Extensible
         */
        std::string logpath;
 
+       /** Default channel modes
+        */
+       char DefaultModes[MAXBUF];
+
        /** Custom version string, which if defined can replace the system info in VERSION.
         */
        char CustomVersion[MAXBUF];
@@ -497,7 +547,7 @@ class ServerConfig : public Extensible
 
        /** Max banlist sizes for channels (the std::string is a glob)
         */
-       std::map<std::string,int> maxbans;
+       std::map<std::string, int> maxbans;
 
        /** Directory where the inspircd binary resides
         */
@@ -576,10 +626,6 @@ class ServerConfig : public Extensible
         */
        bool ReadFile(file_cache &F, const char* fname);
 
-       /** Load 'filename' into 'target', with the new config parser everything is parsed into
-        * tag/key/value at load-time rather than at read-value time.
-        */
-
        /** Report a configuration error given in errormessage.
         * @param bail If this is set to true, the error is sent to the console, and the program exits
         * @param user If this is set to a non-null value, and bail is false, the errors are spooled to
@@ -603,29 +649,41 @@ class ServerConfig : public Extensible
        /** Writes 'length' chars into 'result' as a string
         */
        bool ConfValue(ConfigDataHash &target, const char* tag, const char* var, int index, char* result, int length, bool allow_linefeeds = false);
+       /** Writes 'length' chars into 'result' as a string
+        */
        bool ConfValue(ConfigDataHash &target, const char* tag, const char* var, const char* default_value, int index, char* result, int length, bool allow_linefeeds = false);
 
        /** Writes 'length' chars into 'result' as a string
         */
        bool ConfValue(ConfigDataHash &target, const std::string &tag, const std::string &var, int index, std::string &result, bool allow_linefeeds = false);
+       /** Writes 'length' chars into 'result' as a string
+        */
        bool ConfValue(ConfigDataHash &target, const std::string &tag, const std::string &var, const std::string &default_value, int index, std::string &result, bool allow_linefeeds = false);
        
        /** Tries to convert the value to an integer and write it to 'result'
         */
        bool ConfValueInteger(ConfigDataHash &target, const char* tag, const char* var, int index, int &result);
+       /** Tries to convert the value to an integer and write it to 'result'
+        */
        bool ConfValueInteger(ConfigDataHash &target, const char* tag, const char* var, const char* default_value, int index, int &result);
        /** Tries to convert the value to an integer and write it to 'result'
         */
        bool ConfValueInteger(ConfigDataHash &target, const std::string &tag, const std::string &var, int index, int &result);
+       /** Tries to convert the value to an integer and write it to 'result'
+        */
        bool ConfValueInteger(ConfigDataHash &target, const std::string &tag, const std::string &var, const std::string &default_value, int index, int &result);
        
        /** Returns true if the value exists and has a true value, false otherwise
         */
        bool ConfValueBool(ConfigDataHash &target, const char* tag, const char* var, int index);
+       /** Returns true if the value exists and has a true value, false otherwise
+        */
        bool ConfValueBool(ConfigDataHash &target, const char* tag, const char* var, const char* default_value, int index);
        /** Returns true if the value exists and has a true value, false otherwise
         */
        bool ConfValueBool(ConfigDataHash &target, const std::string &tag, const std::string &var, int index);
+       /** Returns true if the value exists and has a true value, false otherwise
+        */
        bool ConfValueBool(ConfigDataHash &target, const std::string &tag, const std::string &var, const std::string &default_value, int index);
        
        /** Returns the number of occurences of tag in the config file
@@ -642,26 +700,94 @@ class ServerConfig : public Extensible
         */
        int ConfVarEnum(ConfigDataHash &target, const std::string &tag, int index);
        
+       /** Get a pointer to the module which has hooked the given port.
+        * @parameter port Port number
+        * @return Returns a pointer to the hooking module, or NULL
+        */
        Module* GetIOHook(int port);
+
+       /** Hook a module to a client port, so that it can receive notifications
+        * of low-level port activity.
+        * @param port The port number
+        * @param Module the module to hook to the port
+        * @return True if the hook was successful.
+        */
        bool AddIOHook(int port, Module* iomod);
+
+       /** Delete a module hook from a client port.
+        * @param port The port to detatch from
+        * @return True if successful
+        */
        bool DelIOHook(int port);
+       
+       /** Get a pointer to the module which has hooked the given InspSocket class.
+        * @parameter port Port number
+        * @return Returns a pointer to the hooking module, or NULL
+        */
        Module* GetIOHook(InspSocket* is);
+
+       /** Hook a module to an InspSocket class, so that it can receive notifications
+        * of low-level socket activity.
+        * @param iomod The module to hook to the socket
+        * @param is The InspSocket to attach to
+        * @return True if the hook was successful.
+        */
        bool AddIOHook(Module* iomod, InspSocket* is);
+
+       /** Delete a module hook from an InspSocket.
+        * @param is The InspSocket to detatch from.
+        * @return True if the unhook was successful
+        */
        bool DelIOHook(InspSocket* is);
 
-       static std::string GetFullProgDir(char** argv, int argc);
+       /** Returns the fully qualified path to the inspircd directory
+        * @return The full program directory
+        */
+       std::string GetFullProgDir();
+
+       /** Returns true if a directory is valid (within the modules directory).
+        * @param dirandfile The directory and filename to check
+        * @return True if the directory is valid
+        */
        static bool DirValid(const char* dirandfile);
+
+       /** Clean a filename, stripping the directories (and drives) from string.
+        * @param name Directory to tidy
+        * @return The cleaned filename
+        */
        static char* CleanFilename(char* name);
+
+       /** Check if a file exists.
+        * @param file The full path to a file
+        * @return True if the file exists and is readable.
+        */
        static bool FileExists(const char* file);
        
 };
 
-bool InitializeDisabledCommands(const char* data, InspIRCd* ServerInstance);
+/** Initialize the disabled commands list
+ */
+CoreExport bool InitializeDisabledCommands(const char* data, InspIRCd* ServerInstance);
 
+/** Initialize the oper types
+ */
 bool InitTypes(ServerConfig* conf, const char* tag);
+
+/** Initialize the oper classes
+ */
 bool InitClasses(ServerConfig* conf, const char* tag);
+
+/** Initialize an oper type 
+ */
 bool DoType(ServerConfig* conf, const char* tag, char** entries, ValueList &values, int* types);
+
+/** Initialize an oper class
+ */
 bool DoClass(ServerConfig* conf, const char* tag, char** entries, ValueList &values, int* types);
+
+/** Finish initializing the oper types and classes
+ */
 bool DoneClassesAndTypes(ServerConfig* conf, const char* tag);
 
 #endif
+