]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/users.h
Rename User::nping to nextping for consistency with lastping.
[user/henk/code/inspircd.git] / include / users.h
index 4c8df549dce07346a6b09a0a640215de38697c13..39e7e90f00d08a10da2107176f280bc530ddb515 100644 (file)
@@ -244,6 +244,15 @@ 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 real name of this user. */
+       std::string realname;
+
        /** 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 +279,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,15 +311,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;
-
        /** What snomasks are set on this user.
         * This functions the same as the above modes.
         */
@@ -357,13 +352,27 @@ 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;
+
+       /** Retrieves this user's real name. */
+       const std::string& GetRealName() const;
+
        /** Get CIDR mask, using default range, for this user
         */
        irc::sockets::cidr_mask GetCIDRMask();
@@ -371,14 +380,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);
 
-       virtual void SetClientIP(const irc::sockets::sockaddrs& sa, bool recheck_eline = true);
+       virtual void SetClientIP(const irc::sockets::sockaddrs& sa);
 
        /** 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
@@ -435,7 +444,7 @@ class CoreExport User : public Extensible
        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);
@@ -489,41 +498,10 @@ class CoreExport User : public Extensible
         */
        void UnOper();
 
-       /** Write text to this user, appending CR/LF. Works on local users only.
-        * @param text A std::string to send to the user
-        */
-       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
-        */
-       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.
-        * @param text A std::string to send to the user
-        */
-       void WriteServ(const std::string& text);
-
-       /** Write text to this user, appending CR/LF and prepending :server.name
-        * Works on local users only.
-        * @param text The format string for text to send to the user
-        * @param ... POD-type format arguments
-        */
-       void WriteServ(const char* text, ...) CUSTOM_PRINTF(2, 3);
-
-       /** Sends a command to this user.
-        * @param command The command to be sent.
-        * @param text The message to send.
-        */
-       void WriteCommand(const char* command, const std::string& text);
-
        /** Sends a server notice to this user.
         * @param text The contents of the message to send.
         */
-       void WriteNotice(const std::string& text) { this->WriteCommand("NOTICE", ":" + text); }
+       void WriteNotice(const std::string& text);
 
        /** Send a NOTICE message from the local server to the user.
         * @param text Text to send
@@ -634,30 +612,11 @@ class CoreExport User : public Extensible
                WriteNumeric(n);
        }
 
-       /** Write text to this user, appending CR/LF and prepending :nick!user\@host of the user provided in the first parameter.
-        * @param user The user to prepend the :nick!user\@host of
-        * @param text A std::string to send to the user
-        */
-       void WriteFrom(User *user, const std::string &text);
-
-       /** Write text to this user, appending CR/LF and prepending :nick!user\@host of the user provided in the first parameter.
-        * @param user The user to prepend the :nick!user\@host of
-        * @param text The format string for text to send to the user
-        * @param ... POD-type format arguments
-        */
-       void WriteFrom(User *user, const char* text, ...) CUSTOM_PRINTF(3, 4);
-
        /** Write to all users that can see this user (including this user in the list if include_self is true), appending CR/LF
-        * @param line A std::string to send to the users
+        * @param protoev Protocol event to send, may contain any number of messages.
         * @param include_self Should the message be sent back to the author?
         */
-       void WriteCommonRaw(const std::string &line, bool include_self = true);
-
-       /** Write to all users that can see this user (including this user in the list), appending CR/LF
-        * @param text The format string for text to send to the users
-        * @param ... POD-type format arguments
-        */
-       void WriteCommon(const char* text, ...) CUSTOM_PRINTF(2, 3);
+       void WriteCommonRaw(ClientProtocol::Event& protoev, bool include_self = true);
 
        /** Execute a function once for each local neighbor of this user. By default, the neighbors of a user are the users
         * who have at least one common channel with the user. Modules are allowed to alter the set of neighbors freely.
@@ -675,16 +634,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
@@ -695,16 +656,14 @@ class CoreExport User : public Extensible
        bool ChangeIdent(const std::string& newident);
 
        /** Change a users realname field.
-        * ALWAYS use this function, rather than writing User::fullname directly,
-        * as this triggers module events allowing the change to be syncronized to
-        * remote servers.
-        * @param gecos The user's new realname
+        * @param real The user's new real name
         * @return True if the change succeeded, false if otherwise
         */
-       bool ChangeName(const std::string& gecos);
+       bool ChangeRealName(const std::string& real);
 
        /** 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);
@@ -717,16 +676,24 @@ class CoreExport User : public Extensible
        /** Default destructor
         */
        virtual ~User();
-       virtual CullResult cull() CXX11_OVERRIDE;
+       CullResult cull() CXX11_OVERRIDE;
 };
 
 class CoreExport UserIOHandler : public StreamSocket
 {
+ private:
+        size_t checked_until;
  public:
        LocalUser* const user;
-       UserIOHandler(LocalUser* me) : user(me) {}
-       void OnDataReady();
-       void OnError(BufferedSocketError error);
+       UserIOHandler(LocalUser* me)
+               : StreamSocket(StreamSocket::SS_USER)
+               , checked_until(0)
+               , user(me)
+       {
+       }
+       void OnDataReady() CXX11_OVERRIDE;
+       bool 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,12 +707,32 @@ typedef unsigned int already_sent_t;
 
 class CoreExport LocalUser : public User, public insp::intrusive_list_node<LocalUser>
 {
+       /** Add a serialized message to the send queue of the user.
+        * @param serialized Bytes to add.
+        */
+       void Write(const ClientProtocol::SerializedMessage& serialized);
+
+       /** Send a protocol event to the user, consisting of one or more messages.
+        * @param protoev Event to send, may contain any number of messages.
+        * @param msglist Message list used temporarily internally to pass to hooks and store messages
+        * before Write().
+        */
+       void Send(ClientProtocol::Event& protoev, ClientProtocol::MessageList& msglist);
+
+       /** Message list, can be passed to the two parameter Send().
+        */
+       static ClientProtocol::MessageList sendmsglist;
+
  public:
        LocalUser(int fd, irc::sockets::sockaddrs* client, irc::sockets::sockaddrs* server);
        CullResult cull() CXX11_OVERRIDE;
 
        UserIOHandler eh;
 
+       /** Serializer to use when communicating with the user
+        */
+       ClientProtocol::Serializer* serializer;
+
        /** Stats counter for bytes inbound
         */
        unsigned int bytes_in;
@@ -800,13 +787,12 @@ class CoreExport LocalUser : public User, public insp::intrusive_list_node<Local
         */
        unsigned int lastping:1;
 
-       /** This is true if the user matched an exception (E:Line). It is used to save time on ban checks.
+       /** This is true if the user matched an exception (E-line). It is used to save time on ban checks.
         */
        unsigned int exempt:1;
 
-       /** Used by PING checking code
-        */
-       time_t nping;
+       /** The time at which this user should be pinged next. */
+       time_t nextping;
 
        /** Time that the connection last sent a message, used to calculate idle time
         */
@@ -819,14 +805,14 @@ class CoreExport LocalUser : public User, public insp::intrusive_list_node<Local
 
        already_sent_t already_sent;
 
-       /** 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)
+       /** Check if the user matches a G- or K-line, and disconnect them if they do.
+        * @param doZline True if Z-lines should be checked (if IP has changed since initial connect)
         * Returns true if the user matched a ban, false else.
         */
        bool CheckLines(bool doZline = false);
 
        /** Use this method to fully connect a user.
-        * This will send the message of the day, check G/K/E lines, etc.
+        * This will send the message of the day, check G/K/E-lines, etc.
         */
        void FullConnect();
 
@@ -836,12 +822,9 @@ 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) CXX11_OVERRIDE;
-
-       void SetClientIP(const irc::sockets::sockaddrs& sa, bool recheck_eline = true) CXX11_OVERRIDE;
+       bool SetClientIP(const std::string& address) CXX11_OVERRIDE;
 
-       void Write(const std::string& text) CXX11_OVERRIDE;
-       void Write(const char*, ...) CXX11_OVERRIDE CUSTOM_PRINTF(2, 3);
+       void SetClientIP(const irc::sockets::sockaddrs& sa) CXX11_OVERRIDE;
 
        /** 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.
@@ -880,6 +863,17 @@ class CoreExport LocalUser : public User, public insp::intrusive_list_node<Local
         * isn't registered.
         */
        void OverruleNick();
+
+       /** Send a protocol event to the user, consisting of one or more messages.
+        * @param protoev Event to send, may contain any number of messages.
+        */
+       void Send(ClientProtocol::Event& protoev);
+
+       /** Send a single message to the user.
+        * @param protoevprov Protocol event provider.
+        * @param msg Message to send.
+        */
+       void Send(ClientProtocol::EventProvider& protoevprov, ClientProtocol::Message& msg);
 };
 
 class RemoteUser : public User
@@ -904,9 +898,9 @@ class CoreExport FakeUser : public User
                nick = sname;
        }
 
-       virtual CullResult cull() CXX11_OVERRIDE;
-       virtual const std::string& GetFullHost() CXX11_OVERRIDE;
-       virtual const std::string& GetFullRealHost() CXX11_OVERRIDE;
+       CullResult cull() CXX11_OVERRIDE;
+       const std::string& GetFullHost() CXX11_OVERRIDE;
+       const std::string& GetFullRealHost() CXX11_OVERRIDE;
 };
 
 /* Faster than dynamic_cast */
@@ -928,7 +922,7 @@ inline FakeUser* IS_SERVER(User* u)
 
 inline bool User::IsModeSet(const ModeHandler* mh) const
 {
-       return (modes[mh->GetId()]);
+       return ((mh->GetId() != ModeParser::MODEID_MAX) && (modes[mh->GetId()]));
 }
 
 inline bool User::IsModeSet(UserModeReference& moderef) const
@@ -940,5 +934,6 @@ inline bool User::IsModeSet(UserModeReference& moderef) const
 
 inline void User::SetMode(ModeHandler* mh, bool value)
 {
-       modes[mh->GetId()] = value;
+       if (mh && mh->GetId() != ModeParser::MODEID_MAX)
+               modes[mh->GetId()] = value;
 }