]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/users.h
Move MODENOTICE command to a command module
[user/henk/code/inspircd.git] / include / users.h
index c60d5f0330b0c3c383b9309408f5d7a723868b93..ed649f1b9758c7d5d6e166d34edc4b03b694e11d 100644 (file)
@@ -56,10 +56,11 @@ enum RegistrationState {
        REG_ALL = 7             /* REG_NICKUSER plus next bit along */
 };
 
-/* Required forward declaration */
-class Channel;
-class UserResolver;
-struct ConfigTag;
+enum UserType {
+       USERTYPE_LOCAL = 1,
+       USERTYPE_REMOTE = 2,
+       USERTYPE_SERVER = 3
+};
 
 /** Holds information relevent to <connect allow> and <connect deny> tags in the config file.
  */
@@ -207,26 +208,6 @@ struct CoreExport ConnectClass : public refcountbase
        }
 };
 
-/** Holds a complete list of all channels to which a user has been invited and has not yet joined, and the time at which they'll expire.
- */
-CoreExport typedef std::vector< std::pair<irc::string, time_t> > InvitedList;
-
-/** Holds a complete list of all allow and deny tags from the configuration file (connection classes)
- */
-CoreExport typedef std::vector<reference<ConnectClass> > ClassVector;
-
-/** Typedef for the list of user-channel records for a user
- */
-CoreExport typedef std::set<Channel*> UserChanList;
-
-/** Shorthand for an iterator into a UserChanList
- */
-CoreExport typedef UserChanList::iterator UCListIter;
-
-/* Required forward declaration
- */
-class User;
-
 /** Holds all information about a user
  * This class stores all information about a user connected to the irc server. Everything about a
  * connection is stored here primarily, from the user's socket ID (file descriptor) through to the
@@ -235,12 +216,6 @@ class User;
 class CoreExport User : public StreamSocket
 {
  private:
-       /** A list of channels the user has a pending invite to.
-        * Upon INVITE channels are added, and upon JOIN, the
-        * channels are removed from this list.
-        */
-       InvitedList invites;
-
        /** Cached nick!ident@dhost value using the displayed hostname
         */
        std::string cached_fullhost;
@@ -266,46 +241,13 @@ class CoreExport User : public StreamSocket
         * mode characters this user is making use of.
         */
        void DecrementModes();
-
-       std::set<std::string> *AllowedOperCommands;
-       std::set<std::string> *AllowedPrivs;
-
-       /** Allowed user modes from oper classes. */
-       std::bitset<64> AllowedUserModes;
-
-       /** Allowed channel modes from oper classes. */
-       std::bitset<64> AllowedChanModes;
-
  public:
-       /** Contains a pointer to the connect class a user is on from - this will be NULL for remote connections.
-        */
-       reference<ConnectClass> MyClass;
 
        /** Hostname of connection.
         * This should be valid as per RFC1035.
         */
        std::string host;
 
-       /** Stats counter for bytes inbound
-        */
-       int bytes_in;
-
-       /** Stats counter for bytes outbound
-        */
-       int bytes_out;
-
-       /** Stats counter for commands inbound
-        */
-       int cmds_in;
-
-       /** Stats counter for commands outbound
-        */
-       int cmds_out;
-
-       /** Time the connection was last pinged
-        */
-       time_t lastping;
-
        /** Time that the object was instantiated (used for TS calculation etc)
        */
        time_t age;
@@ -320,19 +262,11 @@ class CoreExport User : public StreamSocket
         */
        time_t idle_lastmsg;
 
-       /** Used by PING checking code
-        */
-       time_t nping;
-
-       /** Stored reverse lookup from res_forward. Should not be used after resolution.
-        */
-       std::string stored_host;
-
-       /** Starts a DNS lookup of the user's IP.
-        * This will cause two UserResolver classes to be instantiated.
-        * When complete, these objects set User::dns_done to true.
+       /** Client address that the user is connected from.
+        * Do not modify this value directly, use SetClientIP() to change it.
+        * Port is not valid for remote users.
         */
-       void StartDNSLookup();
+       irc::sockets::sockaddrs client_sa;
 
        /** The users nickname.
         * An invalid nickname indicates an unregistered connection prior to the NICK command.
@@ -343,7 +277,7 @@ class CoreExport User : public StreamSocket
        /** The user's unique identifier.
         * This is the unique identifier which the user has across the network.
         */
-       std::string uuid;
+       const std::string uuid;
 
        /** The users ident reply.
         * Two characters are added to the user-defined limit to compensate for the tilde etc.
@@ -376,13 +310,13 @@ class CoreExport User : public StreamSocket
         */
        std::bitset<64> snomasks;
 
-       /** Channels this user is on, and the permissions they have there
+       /** Channels this user is on
         */
        UserChanList chans;
 
        /** The server the user is connected to.
         */
-       std::string server;
+       const std::string server;
 
        /** The user's away message.
         * If this string is empty, the user is not marked as away.
@@ -395,22 +329,8 @@ class CoreExport User : public StreamSocket
        time_t awaytime;
 
        /** The oper type they logged in as, if they are an oper.
-        * This is used to check permissions in operclasses, so that
-        * we can say 'yay' or 'nay' to any commands they issue.
-        * The value of this is the value of a valid 'type name=' tag.
-        */
-       std::string oper;
-
-       /** Password specified by the user when they registered.
-        * This is stored even if the <connect> block doesnt need a password, so that
-        * modules may check it.
-        */
-       std::string password;
-
-       /** This value contains how far into the penalty threshold the user is. Once its over
-        * the penalty threshold then commands are held and processed on-timer.
         */
-       int Penalty;
+       reference<OperInfo> oper;
 
        /** Used by User to indicate the registration status of the connection
         * It is a bitfield of the REG_NICK, REG_USER and REG_ALL bits to indicate
@@ -439,47 +359,31 @@ class CoreExport User : public StreamSocket
         */
        unsigned int exempt:1;
 
-       /** Server address and port that this user is connected to.
-        * If unknown, address family is AF_UNKNOWN
+       /** has the user responded to their previous ping?
         */
-       irc::sockets::sockaddrs server_sa;
-       /** Client address that the user is connected from.
-        * Port number is only valid if local.
-        *
-        * Do not modify this value directly, use SetClientIP() to change it
-        */
-       irc::sockets::sockaddrs client_sa;
+       unsigned int lastping:1;
 
-       /** Sets the client IP for this user
-        * @return true if the conversion was successful
-        */
-       bool SetClientIP(const char* sip);
-
-       /**
-        * @return The port number of this user.
-        */
-       int GetServerPort();
+       /** What type of user is this? */
+       const unsigned int usertype:2;
 
        /** Get client IP string from sockaddr, using static internal buffer
         * @return The IP string
         */
        const char* GetIPString();
 
-       /** Get a CIDR mask from the IP of this user, using a static internal buffer.
-        * e.g., GetCIDRMask(16) for 223.254.214.52 returns 223.254.0.0/16
-        * This may be used for CIDR clone detection, etc.
-        *
-        * (XXX, brief note: when we do the sockets rewrite, this should move down a
-        * level so it may be used on more derived objects. -- w00t)
+       /** Get CIDR mask, using default range, for this user
         */
-       const char *GetCIDRMask(int range);
+       irc::sockets::cidr_mask GetCIDRMask();
 
-       /** Default constructor
+       /** Sets the client IP for this user
+        * @return true if the conversion was successful
+        */
+       bool SetClientIP(const char* sip);
+
+       /** Constructor
         * @throw CoreException if the UID allocated to the user already exists
-        * @param Instance Creator instance
-        * @param uid User UUID, or empty to allocate one automatically
         */
-       User(const std::string &uid);
+       User(const std::string &uid, const std::string& srv, int objtype);
 
        /** Check if the user matches a G or K line, and disconnect them if they do.
         * @param doZline True if ZLines should be checked (if IP has changed since initial connect)
@@ -492,7 +396,7 @@ class CoreExport User : public StreamSocket
         * on the server, in nick!ident&at;host form.
         * @return The full masked host of the user
         */
-       virtual const std::string GetFullHost();
+       virtual const std::string& GetFullHost();
 
        /** Returns the full real host of the user
         * This member function returns the hostname of the user as seen by other users
@@ -500,7 +404,7 @@ class CoreExport User : public StreamSocket
         * e.g. through a module, then this method will ignore it and return the true hostname.
         * @return The full real host of the user
         */
-       virtual const std::string GetFullRealHost();
+       virtual const std::string& GetFullRealHost();
 
        /** This clears any cached results that are used for GetFullRealHost() etc.
         * The results of these calls are cached as generating them can be generally expensive.
@@ -549,32 +453,13 @@ class CoreExport User : public StreamSocket
         */
        void SetMode(unsigned char m, bool value);
 
-       /** Returns true if a user is invited to a channel.
-        * @param channel A channel name to look up
-        * @return True if the user is invited to the given channel
-        */
-       virtual bool IsInvited(const irc::string &channel);
-
-       /** Adds a channel to a users invite list (invites them to a channel)
-        * @param channel A channel name to add
-        * @param timeout When the invite should expire (0 == never)
-        */
-       virtual void InviteTo(const irc::string &channel, time_t timeout);
-
-       /** Removes a channel from a users invite list.
-        * This member function is called on successfully joining an invite only channel
-        * to which the user has previously been invited, to clear the invitation.
-        * @param channel The channel to remove the invite to
-        */
-       virtual void RemoveInvite(const irc::string &channel);
-
        /** Returns true or false for if a user can execute a privilaged oper command.
         * This is done by looking up their oper type from User::oper, then referencing
         * this to their oper classes and checking the commands they can execute.
         * @param command A command (should be all CAPS)
         * @return True if this user can execute the command
         */
-       bool HasPermission(const std::string &command);
+       virtual bool HasPermission(const std::string &command);
 
        /** Returns true if a user has a given permission.
         * This is used to check whether or not users may perform certain actions which admins may not wish to give to
@@ -584,7 +469,7 @@ class CoreExport User : public StreamSocket
         * @param noisy If set to true, the user is notified that they do not have the specified permission where applicable. If false, no notification is sent.
         * @return True if this user has the permission in question.
         */
-       bool HasPrivPermission(const std::string &privstr, bool noisy = false);
+       virtual bool HasPrivPermission(const std::string &privstr, bool noisy = false);
 
        /** Returns true or false if a user can set a privileged user or channel mode.
         * This is done by looking up their oper type from User::oper, then referencing
@@ -593,19 +478,7 @@ class CoreExport User : public StreamSocket
         * @param type ModeType (MODETYPE_CHANNEL or MODETYPE_USER).
         * @return True if the user can set or unset this mode.
         */
-       bool HasModePermission(unsigned char mode, ModeType type);
-
-       /** Adds to the user's write buffer.
-        * You may add any amount of text up to this users sendq value, if you exceed the
-        * sendq value, the user will be removed, and further buffer adds will be dropped.
-        * @param data The data to add to the write buffer
-        */
-       void AddWriteBuf(const std::string &data);
-
-       /** Returns the list of channels this user has been invited to but has not yet joined.
-        * @return A list of channels the user is invited to
-        */
-       InvitedList* GetInviteList();
+       virtual bool HasModePermission(unsigned char mode, ModeType type);
 
        /** Creates a wildcard host.
         * Takes a buffer to use and fills the given buffer with the host in the format *!*@hostname
@@ -631,18 +504,8 @@ class CoreExport User : public StreamSocket
 
        /** Oper up the user using the given opertype.
         * This will also give the +o usermode.
-        * @param opertype The oper type to oper as
         */
-       void Oper(const std::string &opertype, const std::string &opername);
-
-       /** Call this method to find the matching <connect> for a user, and to check them against it.
-        */
-       void CheckClass();
-
-       /** Use this method to fully connect a user.
-        * This will send the message of the day, check G/K/E lines, etc.
-        */
-       void FullConnect();
+       void Oper(OperInfo* info);
 
        /** Change this users hash key to a new string.
         * You should not call this function directly. It is used by the core
@@ -669,14 +532,14 @@ class CoreExport User : public StreamSocket
        /** Write text to this user, appending CR/LF. Works on local users only.
         * @param text A std::string to send to the user
         */
-       void Write(const std::string &text);
+       virtual void Write(const std::string &text);
 
        /** Write text to this user, appending CR/LF.
         * Works on local users only.
         * @param text The format string for text to send to the user
         * @param ... POD-type format arguments
         */
-       void Write(const char *text, ...) CUSTOM_PRINTF(2, 3);
+       virtual void Write(const char *text, ...) CUSTOM_PRINTF(2, 3);
 
        /** Write text to this user, appending CR/LF and prepending :server.name
         * Works on local users only.
@@ -830,16 +693,10 @@ class CoreExport User : public StreamSocket
         */
        void PurgeEmptyChannels();
 
-       /** Get the connect class which this user belongs to.
-        * @return A pointer to this user's connect class
+       /** Get the connect class which this user belongs to. NULL for remote users.
+        * @return A pointer to this user's connect class.
         */
-       ConnectClass *GetClass();
-
-       /** Set the connect class to which this user belongs to.
-        * @param explicit_name Set this string to tie the user to a specific class name. Otherwise, the class is fitted by checking <connect> tags from the configuration file.
-        * @return A reference to this user's current connect class.
-        */
-       ConnectClass *SetClass(const std::string &explicit_name = "");
+       virtual ConnectClass* GetClass();
 
        /** Show the message of the day to this user
         */
@@ -849,55 +706,166 @@ class CoreExport User : public StreamSocket
         */
        void ShowRULES();
 
-       /** Increases a user's command penalty by a set amount.
-        */
-       void IncreasePenalty(int increase);
-
-       void OnDataReady();
-       void OnError(BufferedSocketError error);
-
+       virtual void OnDataReady();
+       virtual void OnError(BufferedSocketError error);
        /** Default destructor
         */
        virtual ~User();
        virtual CullResult cull();
 };
 
-/** Represents a non-local user.
- * (in fact, any FD less than -1 does)
- */
-#define FD_MAGIC_NUMBER -42
-/** Represents a fake user (i.e. a server)
- */
-#define FD_FAKEUSER_NUMBER -7
-
-/* Useful macros */
-
-/** Is a local user */
-#define IS_LOCAL(x) (x->GetFd() > -1)
-/** Is a remote user */
-#define IS_REMOTE(x) (x->GetFd() < 0)
-/** Is a fake user */
-#define IS_SERVER(x) (x->GetFd() == FD_FAKEUSER_NUMBER)
-/** Is a module created user */
-#define IS_MODULE_CREATED(x) (x->GetFd() == FD_MAGIC_NUMBER)
-/** Is an oper */
-#define IS_OPER(x) (!x->oper.empty())
-/** Is away */
-#define IS_AWAY(x) (!x->awaymsg.empty())
-
 class CoreExport LocalUser : public User
 {
+       /** A list of channels the user has a pending invite to.
+        * Upon INVITE channels are added, and upon JOIN, the
+        * channels are removed from this list.
+        */
+       InvitedList invites;
+
  public:
-       LocalUser();
-       virtual void SendText(const std::string& line);
+       LocalUser(int fd, irc::sockets::sockaddrs* client, irc::sockets::sockaddrs* server);
+       CullResult cull();
+
+       /** Stats counter for bytes inbound
+        */
+       int bytes_in;
+
+       /** Stats counter for bytes outbound
+        */
+       int bytes_out;
+
+       /** Stats counter for commands inbound
+        */
+       int cmds_in;
+
+       /** Stats counter for commands outbound
+        */
+       int cmds_out;
+
+       /** Password specified by the user when they registered (if any).
+        * This is stored even if the <connect> block doesnt need a password, so that
+        * modules may check it.
+        */
+       std::string password;
+
+       /** Contains a pointer to the connect class a user is on from
+        */
+       reference<ConnectClass> MyClass;
+
+       ConnectClass* GetClass();
+
+       /** Call this method to find the matching <connect> for a user, and to check them against it.
+        */
+       void CheckClass();
+
+       /** Server address and port that this user is connected to.
+        */
+       irc::sockets::sockaddrs server_sa;
+
+       /**
+        * @return The port number of this user.
+        */
+       int GetServerPort();
+
+       /** Used by PING checking code
+        */
+       time_t nping;
+
+       /** This value contains how far into the penalty threshold the user is. Once its over
+        * the penalty threshold then commands are held and processed on-timer.
+        */
+       int Penalty;
+
+       /** Stored reverse lookup from res_forward. Should not be used after resolution.
+        */
+       std::string stored_host;
+
+       /** Starts a DNS lookup of the user's IP.
+        * This will cause two UserResolver classes to be instantiated.
+        * When complete, these objects set User::dns_done to true.
+        */
+       void StartDNSLookup();
+
+       /** Use this method to fully connect a user.
+        * This will send the message of the day, check G/K/E lines, etc.
+        */
+       void FullConnect();
+
+       /** Set the connect class to which this user belongs to.
+        * @param explicit_name Set this string to tie the user to a specific class name. Otherwise, the class is fitted by checking <connect> tags from the configuration file.
+        * @return A reference to this user's current connect class.
+        */
+       void SetClass(const std::string &explicit_name = "");
+
+       void OnDataReady();
+       void SendText(const std::string& line);
+       void Write(const std::string& text);
+       void Write(const char*, ...) CUSTOM_PRINTF(2, 3);
+
+       /** Adds to the user's write buffer.
+        * You may add any amount of text up to this users sendq value, if you exceed the
+        * sendq value, the user will be removed, and further buffer adds will be dropped.
+        * @param data The data to add to the write buffer
+        */
+       void AddWriteBuf(const std::string &data);
+
+       /** Returns the list of channels this user has been invited to but has not yet joined.
+        * @return A list of channels the user is invited to
+        */
+       InvitedList* GetInviteList();
+
+       /** Returns true if a user is invited to a channel.
+        * @param channel A channel name to look up
+        * @return True if the user is invited to the given channel
+        */
+       bool IsInvited(const irc::string &channel);
+
+       /** Adds a channel to a users invite list (invites them to a channel)
+        * @param channel A channel name to add
+        * @param timeout When the invite should expire (0 == never)
+        */
+       void InviteTo(const irc::string &channel, time_t timeout);
+
+       /** Removes a channel from a users invite list.
+        * This member function is called on successfully joining an invite only channel
+        * to which the user has previously been invited, to clear the invitation.
+        * @param channel The channel to remove the invite to
+        */
+       void RemoveInvite(const irc::string &channel);
+
+       /** Returns true or false for if a user can execute a privilaged oper command.
+        * This is done by looking up their oper type from User::oper, then referencing
+        * this to their oper classes and checking the commands they can execute.
+        * @param command A command (should be all CAPS)
+        * @return True if this user can execute the command
+        */
+       bool HasPermission(const std::string &command);
+
+       /** Returns true if a user has a given permission.
+        * This is used to check whether or not users may perform certain actions which admins may not wish to give to
+        * all operators, yet are not commands. An example might be oper override, mass messaging (/notice $*), etc.
+        *
+        * @param privstr The priv to chec, e.g. "users/override/topic". These are loaded free-form from the config file.
+        * @param noisy If set to true, the user is notified that they do not have the specified permission where applicable. If false, no notification is sent.
+        * @return True if this user has the permission in question.
+        */
+       bool HasPrivPermission(const std::string &privstr, bool noisy = false);
+
+       /** Returns true or false if a user can set a privileged user or channel mode.
+        * This is done by looking up their oper type from User::oper, then referencing
+        * this to their oper classes, and checking the modes they can set.
+        * @param mode The mode the check
+        * @param type ModeType (MODETYPE_CHANNEL or MODETYPE_USER).
+        * @return True if the user can set or unset this mode.
+        */
+       bool HasModePermission(unsigned char mode, ModeType type);
 };
 
 class CoreExport RemoteUser : public User
 {
  public:
-       RemoteUser(const std::string& uid) : User(uid)
+       RemoteUser(const std::string& uid, const std::string& srv) : User(uid, srv, USERTYPE_REMOTE)
        {
-               SetFd(FD_MAGIC_NUMBER);
        }
        virtual void SendText(const std::string& line);
 };
@@ -905,17 +873,38 @@ class CoreExport RemoteUser : public User
 class CoreExport FakeUser : public User
 {
  public:
-       FakeUser(const std::string &uid) : User(uid)
+       FakeUser(const std::string &uid, const std::string& srv) : User(uid, srv, USERTYPE_SERVER)
        {
-               SetFd(FD_FAKEUSER_NUMBER);
+               nick = srv;
        }
 
+       virtual CullResult cull();
        virtual void SendText(const std::string& line);
-       virtual const std::string GetFullHost();
-       virtual const std::string GetFullRealHost();
-       void SetFakeServer(std::string name);
+       virtual const std::string& GetFullHost();
+       virtual const std::string& GetFullRealHost();
 };
 
+/* Faster than dynamic_cast */
+/** Is a local user */
+inline LocalUser* IS_LOCAL(User* u)
+{
+       return u->usertype == USERTYPE_LOCAL ? static_cast<LocalUser*>(u) : NULL;
+}
+/** Is a remote user */
+inline RemoteUser* IS_REMOTE(User* u)
+{
+       return u->usertype == USERTYPE_REMOTE ? static_cast<RemoteUser*>(u) : NULL;
+}
+/** Is a server fakeuser */
+inline FakeUser* IS_SERVER(User* u)
+{
+       return u->usertype == USERTYPE_SERVER ? static_cast<FakeUser*>(u) : NULL;
+}
+/** Is an oper */
+#define IS_OPER(x) (x->oper)
+/** Is away */
+#define IS_AWAY(x) (!x->awaymsg.empty())
+
 /** Derived from Resolver, and performs user forward/reverse lookups.
  */
 class CoreExport UserResolver : public Resolver
@@ -923,7 +912,7 @@ class CoreExport UserResolver : public Resolver
  private:
        /** User this class is 'attached' to.
         */
-       User* bound_user;
+       LocalUser* bound_user;
        /** File descriptor teh lookup is bound to
         */
        int bound_fd;
@@ -938,7 +927,7 @@ class CoreExport UserResolver : public Resolver
         * @param qt The query type
         * @param cache Modified by the constructor if the result was cached
         */
-       UserResolver(User* user, std::string to_resolve, QueryType qt, bool &cache);
+       UserResolver(LocalUser* user, std::string to_resolve, QueryType qt, bool &cache);
 
        /** Called on successful lookup
         * @param result Result string