2 * InspIRCd -- Internet Relay Chat Daemon
4 * Copyright (C) 2009 Daniel De Graaf <danieldg@inspircd.org>
5 * Copyright (C) 2007-2008 Robin Burchell <robin+git@viroteck.net>
6 * Copyright (C) 2008 Thomas Stagner <aquanight@inspircd.org>
7 * Copyright (C) 2003-2007 Craig Edwards <craigedwards@brainbox.cc>
8 * Copyright (C) 2007 Burlex <???@???>
9 * Copyright (C) 2007 Dennis Friis <peavey@inspircd.org>
11 * This file is part of InspIRCd. InspIRCd is free software: you can
12 * redistribute it and/or modify it under the terms of the GNU General Public
13 * License as published by the Free Software Foundation, version 2.
15 * This program is distributed in the hope that it will be useful, but WITHOUT
16 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
17 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
20 * You should have received a copy of the GNU General Public License
21 * along with this program. If not, see <http://www.gnu.org/licenses/>.
28 #include "inspsocket.h"
30 #include "membership.h"
32 /** connect class types
39 /** named connect block (for opers, etc) */
43 /** Registration state of a user, e.g.
44 * have they sent USER, NICK, PASS yet?
46 enum RegistrationState {
48 #ifndef _WIN32 // Burlex: This is already defined in win32, luckily it is still 0.
49 REG_NONE = 0, /* Has sent nothing */
52 REG_USER = 1, /* Has sent USER */
53 REG_NICK = 2, /* Has sent NICK */
54 REG_NICKUSER = 3, /* Bitwise combination of REG_NICK and REG_USER */
55 REG_ALL = 7 /* REG_NICKUSER plus next bit along */
64 /** Holds information relevent to <connect allow> and <connect deny> tags in the config file.
66 struct CoreExport ConnectClass : public refcountbase
68 reference<ConfigTag> config;
69 /** Type of line, either CC_ALLOW or CC_DENY
73 /** True if this class uses fake lag to manage flood, false if it kills */
76 /** Connect class name
80 /** Max time to register the connection in seconds
82 unsigned int registration_timeout;
84 /** Host mask for this line
88 /** Number of seconds between pings for this line
90 unsigned int pingtime;
92 /** Maximum size of sendq for users in this class (bytes)
93 * Users cannot send commands if they go over this limit
95 unsigned long softsendqmax;
97 /** Maximum size of sendq for users in this class (bytes)
98 * Users are killed if they go over this limit
100 unsigned long hardsendqmax;
102 /** Maximum size of recvq for users in this class (bytes)
104 unsigned long recvqmax;
106 /** Seconds worth of penalty before penalty system activates
108 unsigned int penaltythreshold;
110 /** Maximum rate of commands (units: millicommands per second) */
111 unsigned int commandrate;
113 /** Local max when connecting by this connection class
115 unsigned long maxlocal;
117 /** Global max when connecting by this connection class
119 unsigned long maxglobal;
121 /** True if max connections for this class is hit and a warning is wanted
125 /** Max channels for this class
127 unsigned int maxchans;
129 /** How many users may be in this connect class before they are refused?
130 * (0 = no limit = default)
134 /** If set to true, no user DNS lookups are to be performed
136 bool resolvehostnames;
138 /** Create a new connect class with no settings.
140 ConnectClass(ConfigTag* tag, char type, const std::string& mask);
141 /** Create a new connect class with inherited settings.
143 ConnectClass(ConfigTag* tag, char type, const std::string& mask, const ConnectClass& parent);
145 /** Update the settings in this block to match the given block */
146 void Update(const ConnectClass* newSettings);
148 const std::string& GetName() { return name; }
149 const std::string& GetHost() { return host; }
151 /** Returns the registration timeout
153 time_t GetRegTimeout()
155 return (registration_timeout ? registration_timeout : 90);
158 /** Returns the ping frequency
160 unsigned int GetPingTime()
162 return (pingtime ? pingtime : 120);
165 /** Returns the maximum sendq value (soft limit)
166 * Note that this is in addition to internal OS buffers
168 unsigned long GetSendqSoftMax()
170 return (softsendqmax ? softsendqmax : 4096);
173 /** Returns the maximum sendq value (hard limit)
175 unsigned long GetSendqHardMax()
177 return (hardsendqmax ? hardsendqmax : 0x100000);
180 /** Returns the maximum recvq value
182 unsigned long GetRecvqMax()
184 return (recvqmax ? recvqmax : 4096);
187 /** Returns the penalty threshold value
189 unsigned int GetPenaltyThreshold()
191 return penaltythreshold ? penaltythreshold : (fakelag ? 10 : 20);
194 unsigned int GetCommandRate()
196 return commandrate ? commandrate : 1000;
199 /** Return the maximum number of local sessions
201 unsigned long GetMaxLocal()
206 /** Returns the maximum number of global sessions
208 unsigned long GetMaxGlobal()
214 /** Holds all information about a user
215 * This class stores all information about a user connected to the irc server. Everything about a
216 * connection is stored here primarily, from the user's socket ID (file descriptor) through to the
217 * user's nickname and hostname.
219 class CoreExport User : public Extensible
222 /** Cached nick!ident@dhost value using the displayed hostname
224 std::string cached_fullhost;
226 /** Cached ident@ip value using the real IP address
228 std::string cached_hostip;
230 /** Cached ident@realhost value using the real hostname
232 std::string cached_makehost;
234 /** Cached nick!ident@realhost value using the real hostname
236 std::string cached_fullrealhost;
238 /** Set by GetIPString() to avoid constantly re-grabbing IP via sockets voodoo.
240 std::string cachedip;
242 /** The user's mode list.
243 * Much love to the STL for giving us an easy to use bitset, saving us RAM.
244 * if (modes[modeid]) is set, then the mode is set.
245 * For example, to work out if mode +i is set, we check the field
246 * User::modes[invisiblemode->modeid] == true.
248 std::bitset<ModeParser::MODEID_MAX> modes;
252 /** Hostname of connection.
253 * This should be valid as per RFC1035.
257 /** Time that the object was instantiated (used for TS calculation etc)
261 /** Time the connection was created, set in the constructor. This
262 * may be different from the time the user's classbase object was
267 /** Client address that the user is connected from.
268 * Do not modify this value directly, use SetClientIP() to change it.
269 * Port is not valid for remote users.
271 irc::sockets::sockaddrs client_sa;
273 /** The users nickname.
274 * An invalid nickname indicates an unregistered connection prior to the NICK command.
275 * Use InspIRCd::IsNick() to validate nicknames.
279 /** The user's unique identifier.
280 * This is the unique identifier which the user has across the network.
282 const std::string uuid;
284 /** The users ident reply.
285 * Two characters are added to the user-defined limit to compensate for the tilde etc.
289 /** The host displayed to non-opers (used for cloaking etc).
290 * This usually matches the value of User::host.
294 /** The users full name (GECOS).
296 std::string fullname;
298 /** What snomasks are set on this user.
299 * This functions the same as the above modes.
301 std::bitset<64> snomasks;
303 /** Channels this user is on
307 /** The server the user is connected to.
311 /** The user's away message.
312 * If this string is empty, the user is not marked as away.
316 /** Time the user last went away.
317 * This is ONLY RELIABLE if user IsAway()!
321 /** The oper type they logged in as, if they are an oper.
323 reference<OperInfo> oper;
325 /** Used by User to indicate the registration status of the connection
326 * It is a bitfield of the REG_NICK, REG_USER and REG_ALL bits to indicate
327 * the connection state.
329 unsigned int registered:3;
331 /** If this is set to true, then all socket operations for the user
332 * are dropped into the bit-bucket.
333 * This value is set by QuitUser, and is not needed seperately from that call.
334 * Please note that setting this value alone will NOT cause the user to quit.
336 unsigned int quitting:1;
338 /** What type of user is this? */
339 const unsigned int usertype:2;
341 /** Get client IP string from sockaddr, using static internal buffer
342 * @return The IP string
344 const std::string& GetIPString();
346 /** Get CIDR mask, using default range, for this user
348 irc::sockets::cidr_mask GetCIDRMask();
350 /** Sets the client IP for this user
351 * @return true if the conversion was successful
353 virtual bool SetClientIP(const char* sip, bool recheck_eline = true);
355 virtual void SetClientIP(const irc::sockets::sockaddrs& sa, bool recheck_eline = true);
358 * @throw CoreException if the UID allocated to the user already exists
360 User(const std::string& uid, Server* srv, int objtype);
362 /** Returns the full displayed host of the user
363 * This member function returns the hostname of the user as seen by other users
364 * on the server, in nick!ident\@host form.
365 * @return The full masked host of the user
367 virtual const std::string& GetFullHost();
369 /** Returns the full real host of the user
370 * This member function returns the hostname of the user as seen by other users
371 * on the server, in nick!ident\@host form. If any form of hostname cloaking is in operation,
372 * e.g. through a module, then this method will ignore it and return the true hostname.
373 * @return The full real host of the user
375 virtual const std::string& GetFullRealHost();
377 /** This clears any cached results that are used for GetFullRealHost() etc.
378 * The results of these calls are cached as generating them can be generally expensive.
380 void InvalidateCache();
382 /** Returns whether this user is currently away or not. If true,
383 * further information can be found in User::awaymsg and User::awaytime
384 * @return True if the user is away, false otherwise
386 bool IsAway() const { return (!awaymsg.empty()); }
388 /** Returns whether this user is an oper or not. If true,
389 * oper information can be obtained from User::oper
390 * @return True if the user is an oper, false otherwise
392 bool IsOper() const { return oper; }
394 /** Returns true if a notice mask is set
395 * @param sm A notice mask character to check
396 * @return True if the notice mask is set
398 bool IsNoticeMaskSet(unsigned char sm);
400 /** Create a displayable mode string for this users umodes
401 * @param showparameters The mode string
403 const char* FormatModes(bool showparameters = false);
405 /** Returns true if a specific mode is set
406 * @param m The user mode
407 * @return True if the mode is set
409 bool IsModeSet(unsigned char m);
410 bool IsModeSet(ModeHandler* mh);
411 bool IsModeSet(ModeHandler& mh) { return IsModeSet(&mh); }
412 bool IsModeSet(UserModeReference& moderef);
414 /** Set a specific usermode to on or off
415 * @param m The user mode
416 * @param value On or off setting of the mode
418 void SetMode(ModeHandler* mh, bool value);
419 void SetMode(ModeHandler& mh, bool value) { SetMode(&mh, value); }
421 /** Returns true or false for if a user can execute a privilaged oper command.
422 * This is done by looking up their oper type from User::oper, then referencing
423 * this to their oper classes and checking the commands they can execute.
424 * @param command A command (should be all CAPS)
425 * @return True if this user can execute the command
427 virtual bool HasPermission(const std::string &command);
429 /** Returns true if a user has a given permission.
430 * This is used to check whether or not users may perform certain actions which admins may not wish to give to
431 * all operators, yet are not commands. An example might be oper override, mass messaging (/notice $*), etc.
433 * @param privstr The priv to chec, e.g. "users/override/topic". These are loaded free-form from the config file.
434 * @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.
435 * @return True if this user has the permission in question.
437 virtual bool HasPrivPermission(const std::string &privstr, bool noisy = false);
439 /** Returns true or false if a user can set a privileged user or channel mode.
440 * This is done by looking up their oper type from User::oper, then referencing
441 * this to their oper classes, and checking the modes they can set.
442 * @param mode The mode the check
443 * @param type ModeType (MODETYPE_CHANNEL or MODETYPE_USER).
444 * @return True if the user can set or unset this mode.
446 virtual bool HasModePermission(unsigned char mode, ModeType type);
448 /** Creates a usermask with real host.
449 * Takes a buffer to use and fills the given buffer with the hostmask in the format user\@host
450 * @return the usermask in the format user\@host
452 const std::string& MakeHost();
454 /** Creates a usermask with real ip.
455 * Takes a buffer to use and fills the given buffer with the ipmask in the format user\@ip
456 * @return the usermask in the format user\@ip
458 const std::string& MakeHostIP();
460 /** Oper up the user using the given opertype.
461 * This will also give the +o usermode.
463 void Oper(OperInfo* info);
466 * This will clear the +o usermode and unset the user's oper type
470 /** Write text to this user, appending CR/LF. Works on local users only.
471 * @param text A std::string to send to the user
473 virtual void Write(const std::string &text);
475 /** Write text to this user, appending CR/LF.
476 * Works on local users only.
477 * @param text The format string for text to send to the user
478 * @param ... POD-type format arguments
480 virtual void Write(const char *text, ...) CUSTOM_PRINTF(2, 3);
482 /** Write text to this user, appending CR/LF and prepending :server.name
483 * Works on local users only.
484 * @param text A std::string to send to the user
486 void WriteServ(const std::string& text);
488 /** Write text to this user, appending CR/LF and prepending :server.name
489 * Works on local users only.
490 * @param text The format string for text to send to the user
491 * @param ... POD-type format arguments
493 void WriteServ(const char* text, ...) CUSTOM_PRINTF(2, 3);
495 /** Sends a command to this user.
496 * @param command The command to be sent.
497 * @param text The message to send.
499 void WriteCommand(const char* command, const std::string& text);
501 /** Sends a server notice to this user.
502 * @param text The contents of the message to send.
504 void WriteNotice(const std::string& text) { this->WriteCommand("NOTICE", ":" + text); }
506 void WriteNumeric(unsigned int numeric, const char* text, ...) CUSTOM_PRINTF(3, 4);
508 void WriteNumeric(unsigned int numeric, const std::string &text);
510 /** Write text to this user, appending CR/LF and prepending :nick!user\@host of the user provided in the first parameter.
511 * @param user The user to prepend the :nick!user\@host of
512 * @param text A std::string to send to the user
514 void WriteFrom(User *user, const std::string &text);
516 /** Write text to this user, appending CR/LF and prepending :nick!user\@host of the user provided in the first parameter.
517 * @param user The user to prepend the :nick!user\@host of
518 * @param text The format string for text to send to the user
519 * @param ... POD-type format arguments
521 void WriteFrom(User *user, const char* text, ...) CUSTOM_PRINTF(3, 4);
523 /** Write to all users that can see this user (including this user in the list if include_self is true), appending CR/LF
524 * @param line A std::string to send to the users
525 * @param include_self Should the message be sent back to the author?
527 void WriteCommonRaw(const std::string &line, bool include_self = true);
529 /** Write to all users that can see this user (including this user in the list), appending CR/LF
530 * @param text The format string for text to send to the users
531 * @param ... POD-type format arguments
533 void WriteCommon(const char* text, ...) CUSTOM_PRINTF(2, 3);
535 /** Write a quit message to all common users, as in User::WriteCommonExcept but with a specific
536 * quit message for opers only.
537 * @param normal_text Normal user quit message
538 * @param oper_text Oper only quit message
540 void WriteCommonQuit(const std::string &normal_text, const std::string &oper_text);
542 /** Dump text to a user target, splitting it appropriately to fit
543 * @param linePrefix text to prefix each complete line with
544 * @param textStream the text to send to the user
546 void SendText(const std::string& linePrefix, std::stringstream& textStream);
548 /** Write to the user, routing the line if the user is remote.
550 virtual void SendText(const std::string& line) = 0;
552 /** Write to the user, routing the line if the user is remote.
554 void SendText(const char* text, ...) CUSTOM_PRINTF(2, 3);
556 /** Return true if the user shares at least one channel with another user
557 * @param other The other user to compare the channel list against
558 * @return True if the given user shares at least one channel with this user
560 bool SharesChannelWith(User *other);
562 /** Change the displayed host of a user.
563 * ALWAYS use this function, rather than writing User::dhost directly,
564 * as this triggers module events allowing the change to be syncronized to
566 * @param host The new hostname to set
567 * @return True if the change succeeded, false if it didn't
568 * (a module vetoed the change).
570 bool ChangeDisplayedHost(const std::string& host);
572 /** Change the ident (username) of a user.
573 * ALWAYS use this function, rather than writing User::ident directly,
574 * as this triggers module events allowing the change to be syncronized to
576 * @param newident The new ident to set
577 * @return True if the change succeeded, false if it didn't
579 bool ChangeIdent(const std::string& newident);
581 /** Change a users realname field.
582 * ALWAYS use this function, rather than writing User::fullname directly,
583 * as this triggers module events allowing the change to be syncronized to
585 * @param gecos The user's new realname
586 * @return True if the change succeeded, false if otherwise
588 bool ChangeName(const std::string& gecos);
590 /** Change a user's nick
591 * @param newnick The new nick
592 * @return True if the change succeeded
594 bool ChangeNick(const std::string& newnick, time_t newts = 0);
596 /** Remove this user from all channels they are on, and delete any that are now empty.
597 * This is used by QUIT, and will not send part messages!
599 void PurgeEmptyChannels();
601 /** Default destructor
604 virtual CullResult cull();
607 class CoreExport UserIOHandler : public StreamSocket
610 LocalUser* const user;
611 UserIOHandler(LocalUser* me) : user(me) {}
613 void OnError(BufferedSocketError error);
615 /** Adds to the user's write buffer.
616 * You may add any amount of text up to this users sendq value, if you exceed the
617 * sendq value, the user will be removed, and further buffer adds will be dropped.
618 * @param data The data to add to the write buffer
620 void AddWriteBuf(const std::string &data);
623 typedef unsigned int already_sent_t;
625 class CoreExport LocalUser : public User, public InviteBase<LocalUser>, public intrusive_list_node<LocalUser>
628 LocalUser(int fd, irc::sockets::sockaddrs* client, irc::sockets::sockaddrs* server);
633 /** Stats counter for bytes inbound
635 unsigned int bytes_in;
637 /** Stats counter for bytes outbound
639 unsigned int bytes_out;
641 /** Stats counter for commands inbound
643 unsigned int cmds_in;
645 /** Stats counter for commands outbound
647 unsigned int cmds_out;
649 /** Password specified by the user when they registered (if any).
650 * This is stored even if the \<connect> block doesnt need a password, so that
651 * modules may check it.
653 std::string password;
655 /** Contains a pointer to the connect class a user is on from
657 reference<ConnectClass> MyClass;
659 /** Get the connect class which this user belongs to.
660 * @return A pointer to this user's connect class.
662 ConnectClass* GetClass() const { return MyClass; }
664 /** Call this method to find the matching \<connect> for a user, and to check them against it.
666 void CheckClass(bool clone_count = true);
668 /** Server address and port that this user is connected to.
670 irc::sockets::sockaddrs server_sa;
673 * @return The port number of this user.
677 /** Recursion fix: user is out of SendQ and will be quit as soon as possible.
678 * This can't be handled normally because QuitUser itself calls Write on other
679 * users, which could trigger their SendQ to overrun.
681 unsigned int quitting_sendq:1;
683 /** has the user responded to their previous ping?
685 unsigned int lastping:1;
687 /** This is true if the user matched an exception (E:Line). It is used to save time on ban checks.
689 unsigned int exempt:1;
691 /** Used by PING checking code
695 /** Time that the connection last sent a message, used to calculate idle time
699 /** This value contains how far into the penalty threshold the user is.
700 * This is used either to enable fake lag or for excess flood quits
702 unsigned int CommandFloodPenalty;
704 static already_sent_t already_sent_id;
705 already_sent_t already_sent;
707 /** Check if the user matches a G or K line, and disconnect them if they do.
708 * @param doZline True if ZLines should be checked (if IP has changed since initial connect)
709 * Returns true if the user matched a ban, false else.
711 bool CheckLines(bool doZline = false);
713 /** Use this method to fully connect a user.
714 * This will send the message of the day, check G/K/E lines, etc.
718 /** Set the connect class to which this user belongs to.
719 * @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.
720 * @return A reference to this user's current connect class.
722 void SetClass(const std::string &explicit_name = "");
724 bool SetClientIP(const char* sip, bool recheck_eline = true);
726 void SetClientIP(const irc::sockets::sockaddrs& sa, bool recheck_eline = true);
728 void SendText(const std::string& line);
729 void Write(const std::string& text);
730 void Write(const char*, ...) CUSTOM_PRINTF(2, 3);
732 /** Returns the list of channels this user has been invited to but has not yet joined.
733 * @return A list of channels the user is invited to
735 InviteList& GetInviteList();
737 /** Returns true if a user is invited to a channel.
738 * @param chan A channel to look up
739 * @return True if the user is invited to the given channel
741 bool IsInvited(Channel* chan) { return (Invitation::Find(chan, this) != NULL); }
743 /** Removes a channel from a users invite list.
744 * This member function is called on successfully joining an invite only channel
745 * to which the user has previously been invited, to clear the invitation.
746 * @param chan The channel to remove the invite to
747 * @return True if the user was invited to the channel and the invite was erased, false if the user wasn't invited
749 bool RemoveInvite(Channel* chan);
751 void RemoveExpiredInvites();
753 /** Returns true or false for if a user can execute a privilaged oper command.
754 * This is done by looking up their oper type from User::oper, then referencing
755 * this to their oper classes and checking the commands they can execute.
756 * @param command A command (should be all CAPS)
757 * @return True if this user can execute the command
759 bool HasPermission(const std::string &command);
761 /** Returns true if a user has a given permission.
762 * This is used to check whether or not users may perform certain actions which admins may not wish to give to
763 * all operators, yet are not commands. An example might be oper override, mass messaging (/notice $*), etc.
765 * @param privstr The priv to chec, e.g. "users/override/topic". These are loaded free-form from the config file.
766 * @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.
767 * @return True if this user has the permission in question.
769 bool HasPrivPermission(const std::string &privstr, bool noisy = false);
771 /** Returns true or false if a user can set a privileged user or channel mode.
772 * This is done by looking up their oper type from User::oper, then referencing
773 * this to their oper classes, and checking the modes they can set.
774 * @param mode The mode the check
775 * @param type ModeType (MODETYPE_CHANNEL or MODETYPE_USER).
776 * @return True if the user can set or unset this mode.
778 bool HasModePermission(unsigned char mode, ModeType type);
781 class CoreExport RemoteUser : public User
784 RemoteUser(const std::string& uid, Server* srv) : User(uid, srv, USERTYPE_REMOTE)
787 virtual void SendText(const std::string& line);
790 class CoreExport FakeUser : public User
793 FakeUser(const std::string& uid, Server* srv) : User(uid, srv, USERTYPE_SERVER)
795 nick = srv->GetName();
798 FakeUser(const std::string& uid, const std::string& sname, const std::string& sdesc)
799 : User(uid, new Server(sname, sdesc), USERTYPE_SERVER)
804 virtual CullResult cull();
805 virtual void SendText(const std::string& line);
806 virtual const std::string& GetFullHost();
807 virtual const std::string& GetFullRealHost();
810 /* Faster than dynamic_cast */
811 /** Is a local user */
812 inline LocalUser* IS_LOCAL(User* u)
814 return u->usertype == USERTYPE_LOCAL ? static_cast<LocalUser*>(u) : NULL;
816 /** Is a remote user */
817 inline RemoteUser* IS_REMOTE(User* u)
819 return u->usertype == USERTYPE_REMOTE ? static_cast<RemoteUser*>(u) : NULL;
821 /** Is a server fakeuser */
822 inline FakeUser* IS_SERVER(User* u)
824 return u->usertype == USERTYPE_SERVER ? static_cast<FakeUser*>(u) : NULL;
827 inline bool User::IsModeSet(ModeHandler* mh)
829 return (modes[mh->GetId()]);
832 inline bool User::IsModeSet(UserModeReference& moderef)
836 return IsModeSet(*moderef);
839 inline void User::SetMode(ModeHandler* mh, bool value)
841 modes[mh->GetId()] = value;