]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/users.h
Add a module which implements the HAProxy PROXY v2 protocol.
[user/henk/code/inspircd.git] / include / users.h
index 8cf78a585c890807a12318c0924434932d88a8aa..88858b160f9352a6f78d0fa3de0847b1e9541b43 100644 (file)
@@ -244,6 +244,12 @@ class CoreExport User : public Extensible
         */
        std::string cachedip;
 
+       /** If set then the hostname which is displayed to users. */
+       std::string displayhost;
+
+       /** The real hostname of this user. */
+       std::string realhost;
+
        /** The user's mode list.
         * Much love to the STL for giving us an easy to use bitset, saving us RAM.
         * if (modes[modeid]) is set, then the mode is set.
@@ -270,11 +276,6 @@ class CoreExport User : public Extensible
         */
        typedef insp::intrusive_list<Membership> ChanList;
 
-       /** Hostname of connection.
-        * This should be valid as per RFC1035.
-        */
-       std::string host;
-
        /** Time that the object was instantiated (used for TS calculation etc)
        */
        time_t age;
@@ -307,11 +308,6 @@ class CoreExport User : public Extensible
         */
        std::string ident;
 
-       /** The host displayed to non-opers (used for cloaking etc).
-        * This usually matches the value of User::host.
-        */
-       std::string dhost;
-
        /** The users full name (GECOS).
         */
        std::string fullname;
@@ -357,13 +353,24 @@ class CoreExport User : public Extensible
        unsigned int quitting:1;
 
        /** What type of user is this? */
-       const unsigned int usertype:2;
+       const UserType usertype:2;
 
        /** Get client IP string from sockaddr, using static internal buffer
         * @return The IP string
         */
        const std::string& GetIPString();
 
+       /** Retrieves this user's hostname.
+        * @param uncloak If true then return the real host; otherwise, the display host.
+        */
+       const std::string& GetHost(bool uncloak) const;
+
+       /** Retrieves this user's displayed hostname. */
+       const std::string& GetDisplayedHost() const;
+
+       /** Retrieves this user's real hostname. */
+       const std::string& GetRealHost() const;
+
        /** Get CIDR mask, using default range, for this user
         */
        irc::sockets::cidr_mask GetCIDRMask();
@@ -371,14 +378,14 @@ class CoreExport User : public Extensible
        /** Sets the client IP for this user
         * @return true if the conversion was successful
         */
-       virtual bool SetClientIP(const char* sip, bool recheck_eline = true);
+       virtual bool SetClientIP(const std::string& address, bool recheck_eline = true);
 
        virtual void SetClientIP(const irc::sockets::sockaddrs& sa, bool recheck_eline = true);
 
        /** Constructor
         * @throw CoreException if the UID allocated to the user already exists
         */
-       User(const std::string& uid, Server* srv, int objtype);
+       User(const std::string& uid, Server* srv, UserType objtype);
 
        /** Returns the full displayed host of the user
         * This member function returns the hostname of the user as seen by other users
@@ -418,22 +425,24 @@ class CoreExport User : public Extensible
         */
        bool IsNoticeMaskSet(unsigned char sm);
 
-       /** Create a displayable mode string for this users umodes
-        * @param showparameters The mode string
+       /** Get the mode letters of modes set on the user as a string.
+        * @param includeparams True to get the parameters of the modes as well. Defaults to false.
+        * @return Mode letters of modes set on the user and optionally the parameters of those modes, if any.
+        * The returned string always begins with a '+' character. If the user has no modes set, "+" is returned.
         */
-       const char* FormatModes(bool showparameters = false);
+       std::string GetModeLetters(bool includeparams = false) const;
 
        /** Returns true if a specific mode is set
         * @param m The user mode
         * @return True if the mode is set
         */
-       bool IsModeSet(unsigned char m);
-       bool IsModeSet(ModeHandler* mh);
-       bool IsModeSet(ModeHandler& mh) { return IsModeSet(&mh); }
-       bool IsModeSet(UserModeReference& moderef);
+       bool IsModeSet(unsigned char m) const;
+       bool IsModeSet(const ModeHandler* mh) const;
+       bool IsModeSet(const ModeHandler& mh) const { return IsModeSet(&mh); }
+       bool IsModeSet(UserModeReference& moderef) const;
 
        /** Set a specific usermode to on or off
-        * @param m The user mode
+        * @param mh The user mode
         * @param value On or off setting of the mode
         */
        void SetMode(ModeHandler* mh, bool value);
@@ -673,16 +682,18 @@ class CoreExport User : public Extensible
         */
        bool SharesChannelWith(User *other);
 
-       /** Change the displayed host of a user.
-        * ALWAYS use this function, rather than writing User::dhost directly,
-        * as this triggers module events allowing the change to be syncronized to
-        * remote servers.
-        * @param host The new hostname to set
-        * @return True if the change succeeded, false if it didn't
-        * (a module vetoed the change).
+       /** Change the displayed hostname of this user.
+        * @param host The new displayed hostname of this user.
+        * @return True if the hostname was changed successfully; otherwise, false.
         */
        bool ChangeDisplayedHost(const std::string& host);
 
+       /** Change the real hostname of this user.
+        * @param host The new real hostname of this user.
+        * @param resetdisplay Whether to reset the display host to this value.
+        */
+       void ChangeRealHost(const std::string& host, bool resetdisplay);
+
        /** Change the ident (username) of a user.
         * ALWAYS use this function, rather than writing User::ident directly,
         * as this triggers module events allowing the change to be syncronized to
@@ -703,6 +714,7 @@ class CoreExport User : public Extensible
 
        /** Change a user's nick
         * @param newnick The new nick. If equal to the users uuid, the nick change always succeeds.
+        * @param newts The time at which this nick change happened.
         * @return True if the change succeeded
         */
        bool ChangeNick(const std::string& newnick, time_t newts = 0);
@@ -715,7 +727,7 @@ class CoreExport User : public Extensible
        /** Default destructor
         */
        virtual ~User();
-       virtual CullResult cull();
+       CullResult cull() CXX11_OVERRIDE;
 };
 
 class CoreExport UserIOHandler : public StreamSocket
@@ -723,8 +735,9 @@ class CoreExport UserIOHandler : public StreamSocket
  public:
        LocalUser* const user;
        UserIOHandler(LocalUser* me) : user(me) {}
-       void OnDataReady();
-       void OnError(BufferedSocketError error);
+       void OnDataReady() CXX11_OVERRIDE;
+       void OnSetEndPoint(const irc::sockets::sockaddrs& local, const irc::sockets::sockaddrs& remote) CXX11_OVERRIDE;
+       void OnError(BufferedSocketError error) CXX11_OVERRIDE;
 
        /** Adds to the user's write buffer.
         * You may add any amount of text up to this users sendq value, if you exceed the
@@ -740,7 +753,7 @@ class CoreExport LocalUser : public User, public insp::intrusive_list_node<Local
 {
  public:
        LocalUser(int fd, irc::sockets::sockaddrs* client, irc::sockets::sockaddrs* server);
-       CullResult cull();
+       CullResult cull() CXX11_OVERRIDE;
 
        UserIOHandler eh;
 
@@ -834,12 +847,12 @@ class CoreExport LocalUser : public User, public insp::intrusive_list_node<Local
         */
        void SetClass(const std::string &explicit_name = "");
 
-       bool SetClientIP(const char* sip, bool recheck_eline = true);
+       bool SetClientIP(const std::string& address, bool recheck_eline = true) CXX11_OVERRIDE;
 
-       void SetClientIP(const irc::sockets::sockaddrs& sa, bool recheck_eline = true);
+       void SetClientIP(const irc::sockets::sockaddrs& sa, bool recheck_eline = true) CXX11_OVERRIDE;
 
-       void Write(const std::string& text);
-       void Write(const char*, ...) CUSTOM_PRINTF(2, 3);
+       void Write(const std::string& text) CXX11_OVERRIDE;
+       void Write(const char*, ...) CXX11_OVERRIDE CUSTOM_PRINTF(2, 3);
 
        /** Send a NOTICE message from the local server to the user.
         * The message will be sent even if the user is connected to a remote server.
@@ -853,7 +866,7 @@ class CoreExport LocalUser : public User, public insp::intrusive_list_node<Local
         * @param command A command (should be all CAPS)
         * @return True if this user can execute the command
         */
-       bool HasPermission(const std::string &command);
+       bool HasPermission(const std::string &command) CXX11_OVERRIDE;
 
        /** 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
@@ -863,7 +876,7 @@ class CoreExport LocalUser : public User, public insp::intrusive_list_node<Local
         * @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);
+       bool HasPrivPermission(const std::string &privstr, bool noisy = false) CXX11_OVERRIDE;
 
        /** 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
@@ -871,7 +884,7 @@ class CoreExport LocalUser : public User, public insp::intrusive_list_node<Local
         * @param mh Mode to check
         * @return True if the user can set or unset this mode.
         */
-       bool HasModePermission(const ModeHandler* mh) const;
+       bool HasModePermission(const ModeHandler* mh) const CXX11_OVERRIDE;
 
        /** Change nick to uuid, unset REG_NICK and send a nickname overruled numeric.
         * This is called when another user (either local or remote) needs the nick of this user and this user
@@ -902,9 +915,9 @@ class CoreExport FakeUser : public User
                nick = sname;
        }
 
-       virtual CullResult cull();
-       virtual const std::string& GetFullHost();
-       virtual const std::string& GetFullRealHost();
+       CullResult cull() CXX11_OVERRIDE;
+       const std::string& GetFullHost() CXX11_OVERRIDE;
+       const std::string& GetFullRealHost() CXX11_OVERRIDE;
 };
 
 /* Faster than dynamic_cast */
@@ -924,12 +937,12 @@ inline FakeUser* IS_SERVER(User* u)
        return u->usertype == USERTYPE_SERVER ? static_cast<FakeUser*>(u) : NULL;
 }
 
-inline bool User::IsModeSet(ModeHandler* mh)
+inline bool User::IsModeSet(const ModeHandler* mh) const
 {
        return (modes[mh->GetId()]);
 }
 
-inline bool User::IsModeSet(UserModeReference& moderef)
+inline bool User::IsModeSet(UserModeReference& moderef) const
 {
        if (!moderef)
                return false;