1 /* +------------------------------------+
2 * | Inspire Internet Relay Chat Daemon |
3 * +------------------------------------+
5 * InspIRCd: (C) 2002-2007 InspIRCd Development Team
6 * See: http://www.inspircd.org/wiki/index.php/Credits
8 * This program is free but copyrighted software; see
9 * the file COPYING for details.
11 * ---------------------------------------------------
15 #include "configreader.h"
19 #include "socketengine.h"
22 #include "commands/cmd_whowas.h"
24 static unsigned long already_sent[MAX_DESCRIPTORS] = {0};
26 /* XXX: Used for speeding up WriteCommon operations */
27 unsigned long uniq_id = 0;
29 bool InitTypes(ServerConfig* conf, const char* tag)
31 if (conf->opertypes.size())
33 for (opertype_t::iterator n = conf->opertypes.begin(); n != conf->opertypes.end(); n++)
40 conf->opertypes.clear();
44 bool InitClasses(ServerConfig* conf, const char* tag)
46 if (conf->operclass.size())
48 for (operclass_t::iterator n = conf->operclass.begin(); n != conf->operclass.end(); n++)
55 conf->operclass.clear();
59 bool DoType(ServerConfig* conf, const char* tag, char** entries, ValueList &values, int* types)
61 const char* TypeName = values[0].GetString();
62 const char* Classes = values[1].GetString();
64 conf->opertypes[TypeName] = strnewdup(Classes);
68 bool DoClass(ServerConfig* conf, const char* tag, char** entries, ValueList &values, int* types)
70 const char* ClassName = values[0].GetString();
71 const char* CommandList = values[1].GetString();
73 conf->operclass[ClassName] = strnewdup(CommandList);
77 bool DoneClassesAndTypes(ServerConfig* conf, const char* tag)
82 std::string userrec::ProcessNoticeMasks(const char *sm)
84 bool adding = true, oldadding = false;
99 for (unsigned char d = 'A'; d <= 'z'; d++)
101 if (ServerInstance->SNO->IsEnabled(d))
103 if ((!IsNoticeMaskSet(d) && adding) || (IsNoticeMaskSet(d) && !adding))
105 if ((oldadding != adding) || (!output.length()))
106 output += (adding ? '+' : '-');
108 this->SetNoticeMask(d, adding);
117 if ((*c >= 'A') && (*c <= 'z') && (ServerInstance->SNO->IsEnabled(*c)))
119 if ((!IsNoticeMaskSet(*c) && adding) || (IsNoticeMaskSet(*c) && !adding))
121 if ((oldadding != adding) || (!output.length()))
122 output += (adding ? '+' : '-');
124 this->SetNoticeMask(*c, adding);
139 void userrec::StartDNSLookup()
144 const char* ip = this->GetIPString();
146 /* Special case for 4in6 (Have i mentioned i HATE 4in6?) */
147 if (!strncmp(ip, "0::ffff:", 8))
148 res_reverse = new UserResolver(this->ServerInstance, this, ip + 8, DNS_QUERY_PTR4, cached);
150 res_reverse = new UserResolver(this->ServerInstance, this, ip, this->GetProtocolFamily() == AF_INET ? DNS_QUERY_PTR4 : DNS_QUERY_PTR6, cached);
152 this->ServerInstance->AddResolver(res_reverse, cached);
154 catch (CoreException& e)
156 ServerInstance->Log(DEBUG,"Error in resolver: %s",e.GetReason());
160 UserResolver::UserResolver(InspIRCd* Instance, userrec* user, std::string to_resolve, QueryType qt, bool &cache) :
161 Resolver(Instance, to_resolve, qt, cache), bound_user(user)
163 this->fwd = (qt == DNS_QUERY_A || qt == DNS_QUERY_AAAA);
164 this->bound_fd = user->GetFd();
167 void UserResolver::OnLookupComplete(const std::string &result, unsigned int ttl, bool cached)
169 if ((!this->fwd) && (ServerInstance->SE->GetRef(this->bound_fd) == this->bound_user))
171 this->bound_user->stored_host = result;
174 /* Check we didnt time out */
175 if (this->bound_user->registered != REG_ALL)
179 if (this->bound_user->GetProtocolFamily() == AF_INET6)
181 /* IPV6 forward lookup (with possibility of 4in6) */
182 const char* ip = this->bound_user->GetIPString();
183 bound_user->res_forward = new UserResolver(this->ServerInstance, this->bound_user, result, (!strncmp(ip, "0::ffff:", 8) ? DNS_QUERY_A : DNS_QUERY_AAAA), cached);
186 /* IPV4 lookup (mixed protocol mode) */
188 /* IPV4 lookup (ipv4 only mode) */
189 bound_user->res_forward = new UserResolver(this->ServerInstance, this->bound_user, result, DNS_QUERY_A, cached);
190 this->ServerInstance->AddResolver(bound_user->res_forward, cached);
193 catch (CoreException& e)
195 ServerInstance->Log(DEBUG,"Error in resolver: %s",e.GetReason());
198 else if ((this->fwd) && (ServerInstance->SE->GetRef(this->bound_fd) == this->bound_user))
200 /* Both lookups completed */
201 std::string result2("0::ffff:");
202 result2.append(result);
203 if (this->bound_user->GetIPString() == result || this->bound_user->GetIPString() == result2)
205 std::string hostname = this->bound_user->stored_host;
206 if (hostname.length() < 65)
208 /* Check we didnt time out */
209 if ((this->bound_user->registered != REG_ALL) && (!this->bound_user->dns_done))
211 /* Hostnames starting with : are not a good thing (tm) */
212 if (*(hostname.c_str()) == ':')
213 hostname.insert(0, "0");
215 this->bound_user->WriteServ("NOTICE Auth :*** Found your hostname (%s)%s", hostname.c_str(), (cached ? " -- cached" : ""));
216 this->bound_user->dns_done = true;
217 strlcpy(this->bound_user->dhost, hostname.c_str(),64);
218 strlcpy(this->bound_user->host, hostname.c_str(),64);
219 /* Invalidate cache */
220 this->bound_user->InvalidateCache();
225 if (!this->bound_user->dns_done)
227 this->bound_user->WriteServ("NOTICE Auth :*** Your hostname is longer than the maximum of 64 characters, using your IP address (%s) instead.", this->bound_user->GetIPString());
228 this->bound_user->dns_done = true;
234 if (!this->bound_user->dns_done)
236 this->bound_user->WriteServ("NOTICE Auth :*** Your hostname does not match up with your IP address. Sorry, using your IP address (%s) instead.", this->bound_user->GetIPString());
237 this->bound_user->dns_done = true;
243 void UserResolver::OnError(ResolverError e, const std::string &errormessage)
245 if (ServerInstance->SE->GetRef(this->bound_fd) == this->bound_user)
247 /* Since dns timeout is implemented outside of the resolver, this was a race condition that could result in this message being sent *after*
248 * the user was fully connected. This check fixes that issue - Special */
249 if (!this->bound_user->dns_done)
251 /* Error message here */
252 this->bound_user->WriteServ("NOTICE Auth :*** Could not resolve your hostname: %s; using your IP address (%s) instead.", errormessage.c_str(), this->bound_user->GetIPString());
253 this->bound_user->dns_done = true;
259 bool userrec::IsNoticeMaskSet(unsigned char sm)
261 return (snomasks[sm-65]);
264 void userrec::SetNoticeMask(unsigned char sm, bool value)
266 snomasks[sm-65] = value;
269 const char* userrec::FormatNoticeMasks()
271 static char data[MAXBUF];
274 for (int n = 0; n < 64; n++)
277 data[offset++] = n+65;
286 bool userrec::IsModeSet(unsigned char m)
288 return (modes[m-65]);
291 void userrec::SetMode(unsigned char m, bool value)
296 const char* userrec::FormatModes()
298 static char data[MAXBUF];
300 for (int n = 0; n < 64; n++)
303 data[offset++] = n+65;
309 void userrec::DecrementModes()
311 for (int n = 0; n < 64; n++)
315 ModeHandler* mh = ServerInstance->Modes->FindMode(n+65, MODETYPE_USER);
322 userrec::userrec(InspIRCd* Instance) : ServerInstance(Instance)
324 // the PROPER way to do it, AVOID bzero at *ALL* costs
325 *password = *nick = *ident = *host = *dhost = *fullname = *awaymsg = *oper = 0;
326 server = (char*)Instance->FindServerNamePtr(Instance->Config->ServerName);
327 reset_due = ServerInstance->Time();
328 age = ServerInstance->Time(true);
329 lines_in = lastping = signon = idle_lastmsg = nping = registered = 0;
330 ChannelCount = timeout = flood = bytes_in = bytes_out = cmds_in = cmds_out = 0;
331 muted = exempt = haspassed = dns_done = false;
336 res_forward = res_reverse = NULL;
341 memset(modes,0,sizeof(modes));
342 memset(snomasks,0,sizeof(snomasks));
343 /* Invalidate cache */
344 operquit = cached_fullhost = cached_hostip = cached_makehost = cached_fullrealhost = NULL;
349 this->InvalidateCache();
350 this->DecrementModes();
355 clonemap::iterator x = ServerInstance->local_clones.find(this->GetIPString());
356 if (x != ServerInstance->local_clones.end())
361 ServerInstance->local_clones.erase(x);
365 clonemap::iterator y = ServerInstance->global_clones.find(this->GetIPString());
366 if (y != ServerInstance->global_clones.end())
371 ServerInstance->global_clones.erase(y);
375 if (this->GetProtocolFamily() == AF_INET)
377 delete (sockaddr_in*)ip;
379 #ifdef SUPPORT_IP6LINKS
382 delete (sockaddr_in6*)ip;
388 char* userrec::MakeHost()
390 if (this->cached_makehost)
391 return this->cached_makehost;
394 /* This is much faster than snprintf */
396 for(char* n = ident; *n; n++)
399 for(char* n = host; *n; n++)
403 this->cached_makehost = strdup(nhost);
405 return this->cached_makehost;
408 char* userrec::MakeHostIP()
410 if (this->cached_hostip)
411 return this->cached_hostip;
414 /* This is much faster than snprintf */
416 for(char* n = ident; *n; n++)
419 for(const char* n = this->GetIPString(); *n; n++)
423 this->cached_hostip = strdup(ihost);
425 return this->cached_hostip;
428 void userrec::CloseSocket()
430 shutdown(this->fd,2);
434 char* userrec::GetFullHost()
436 if (this->cached_fullhost)
437 return this->cached_fullhost;
441 for(char* n = nick; *n; n++)
444 for(char* n = ident; *n; n++)
447 for(char* n = dhost; *n; n++)
451 this->cached_fullhost = strdup(result);
453 return this->cached_fullhost;
456 char* userrec::MakeWildHost()
458 static char nresult[MAXBUF];
460 *t++ = '*'; *t++ = '!';
461 *t++ = '*'; *t++ = '@';
462 for(char* n = dhost; *n; n++)
468 int userrec::ReadData(void* buffer, size_t size)
473 return read(this->fd, buffer, size);
475 return recv(this->fd, (char*)buffer, size, 0);
483 char* userrec::GetFullRealHost()
485 if (this->cached_fullrealhost)
486 return this->cached_fullrealhost;
488 char fresult[MAXBUF];
490 for(char* n = nick; *n; n++)
493 for(char* n = ident; *n; n++)
496 for(char* n = host; *n; n++)
500 this->cached_fullrealhost = strdup(fresult);
502 return this->cached_fullrealhost;
505 bool userrec::IsInvited(const irc::string &channel)
507 for (InvitedList::iterator i = invites.begin(); i != invites.end(); i++)
517 InvitedList* userrec::GetInviteList()
522 void userrec::InviteTo(const irc::string &channel)
524 invites.push_back(channel);
527 void userrec::RemoveInvite(const irc::string &channel)
529 for (InvitedList::iterator i = invites.begin(); i != invites.end(); i++)
539 bool userrec::HasPermission(const std::string &command)
546 * users on remote servers can completely bypass all permissions based checks.
547 * This prevents desyncs when one server has different type/class tags to another.
548 * That having been said, this does open things up to the possibility of source changes
549 * allowing remote kills, etc - but if they have access to the src, they most likely have
550 * access to the conf - so it's an end to a means either way.
555 // are they even an oper at all?
558 opertype_t::iterator iter_opertype = ServerInstance->Config->opertypes.find(this->oper);
559 if (iter_opertype != ServerInstance->Config->opertypes.end())
561 char* Classes = strdup(iter_opertype->second);
562 char* myclass = strtok_r(Classes," ",&savept);
565 operclass_t::iterator iter_operclass = ServerInstance->Config->operclass.find(myclass);
566 if (iter_operclass != ServerInstance->Config->operclass.end())
568 char* CommandList = strdup(iter_operclass->second);
569 mycmd = strtok_r(CommandList," ",&savept2);
572 if ((!strcasecmp(mycmd,command.c_str())) || (*mycmd == '*'))
578 mycmd = strtok_r(NULL," ",&savept2);
582 myclass = strtok_r(NULL," ",&savept);
590 /** NOTE: We cannot pass a const reference to this method.
591 * The string is changed by the workings of the method,
592 * so that if we pass const ref, we end up copying it to
593 * something we can change anyway. Makes sense to just let
594 * the compiler do that copy for us.
596 bool userrec::AddBuffer(std::string a)
600 std::string::size_type i = a.rfind('\r');
602 while (i != std::string::npos)
611 if (recvq.length() > (unsigned)this->recvqmax)
613 this->SetWriteError("RecvQ exceeded");
614 ServerInstance->WriteOpers("*** User %s RecvQ of %d exceeds connect class maximum of %d",this->nick,recvq.length(),this->recvqmax);
623 ServerInstance->Log(DEBUG,"Exception in userrec::AddBuffer()");
628 bool userrec::BufferIsReady()
630 return (recvq.find('\n') != std::string::npos);
633 void userrec::ClearBuffer()
638 std::string userrec::GetBuffer()
645 /* Strip any leading \r or \n off the string.
646 * Usually there are only one or two of these,
647 * so its is computationally cheap to do.
649 std::string::iterator t = recvq.begin();
650 while (t != recvq.end() && (*t == '\r' || *t == '\n'))
656 for (std::string::iterator x = recvq.begin(); x != recvq.end(); x++)
658 /* Find the first complete line, return it as the
659 * result, and leave the recvq as whats left
663 std::string ret = std::string(recvq.begin(), x);
664 recvq.erase(recvq.begin(), x + 1);
673 ServerInstance->Log(DEBUG,"Exception in userrec::GetBuffer()");
678 void userrec::AddWriteBuf(const std::string &data)
680 if (*this->GetWriteError())
683 if (sendq.length() + data.length() > (unsigned)this->sendqmax)
686 * Fix by brain - Set the error text BEFORE calling writeopers, because
687 * if we dont it'll recursively call here over and over again trying
688 * to repeatedly add the text to the sendq!
690 this->SetWriteError("SendQ exceeded");
691 ServerInstance->WriteOpers("*** User %s SendQ of %d exceeds connect class maximum of %d",this->nick,sendq.length() + data.length(),this->sendqmax);
697 if (data.length() > MAXBUF - 2) /* MAXBUF has a value of 514, to account for line terminators */
698 sendq.append(data.substr(0,MAXBUF - 4)).append("\r\n"); /* MAXBUF-4 = 510 */
704 this->SetWriteError("SendQ exceeded");
705 ServerInstance->WriteOpers("*** User %s SendQ got an exception",this->nick);
709 // send AS MUCH OF THE USERS SENDQ as we are able to (might not be all of it)
710 void userrec::FlushWriteBuf()
714 if ((this->fd == FD_MAGIC_NUMBER) || (*this->GetWriteError()))
718 if ((sendq.length()) && (this->fd != FD_MAGIC_NUMBER))
720 int old_sendq_length = sendq.length();
722 int n_sent = write(this->fd, this->sendq.data(), this->sendq.length());
724 int n_sent = send(this->fd, (const char*)this->sendq.data(), this->sendq.length(), 0);
730 /* The socket buffer is full. This isnt fatal,
733 this->ServerInstance->SE->WantWrite(this);
737 /* Fatal error, set write error and bail
739 this->SetWriteError(strerror(errno));
745 /* advance the queue */
747 this->sendq = this->sendq.substr(n_sent);
748 /* update the user's stats counters */
749 this->bytes_out += n_sent;
751 if (n_sent != old_sendq_length)
752 this->ServerInstance->SE->WantWrite(this);
759 ServerInstance->Log(DEBUG,"Exception in userrec::FlushWriteBuf()");
762 if (this->sendq.empty())
764 FOREACH_MOD(I_OnBufferFlushed,OnBufferFlushed(this));
768 void userrec::SetWriteError(const std::string &error)
772 // don't try to set the error twice, its already set take the first string.
773 if (this->WriteError.empty())
774 this->WriteError = error;
779 ServerInstance->Log(DEBUG,"Exception in userrec::SetWriteError()");
783 const char* userrec::GetWriteError()
785 return this->WriteError.c_str();
788 void userrec::Oper(const std::string &opertype)
792 this->modes[UM_OPERATOR] = 1;
793 this->WriteServ("MODE %s :+o", this->nick);
794 FOREACH_MOD(I_OnOper, OnOper(this, opertype));
795 ServerInstance->Log(DEFAULT,"OPER: %s!%s@%s opered as type: %s", this->nick, this->ident, this->host, opertype.c_str());
796 strlcpy(this->oper, opertype.c_str(), NICKMAX - 1);
797 ServerInstance->all_opers.push_back(this);
798 FOREACH_MOD(I_OnPostOper,OnPostOper(this, opertype));
803 ServerInstance->Log(DEBUG,"Exception in userrec::Oper()");
807 void userrec::UnOper()
813 // unset their oper type (what IS_OPER checks), and remove +o
815 this->modes[UM_OPERATOR] = 0;
817 // remove them from the opers list.
818 for (std::vector<userrec*>::iterator a = ServerInstance->all_opers.begin(); a < ServerInstance->all_opers.end(); a++)
822 ServerInstance->all_opers.erase(a);
831 ServerInstance->Log(DEBUG,"Exception in userrec::UnOper()");
835 void userrec::QuitUser(InspIRCd* Instance, userrec *user, const std::string &quitreason, const char* operreason)
838 Instance->GlobalCulls.AddItem(user, quitreason.c_str(), operreason);
841 /* adds or updates an entry in the whowas list */
842 void userrec::AddToWhoWas()
844 command_t* whowas_command = ServerInstance->Parser->GetHandler("WHOWAS");
847 std::deque<classbase*> params;
848 params.push_back(this);
849 whowas_command->HandleInternal(WHOWAS_ADD, params);
853 /* add a client connection to the sockets list */
854 void userrec::AddClient(InspIRCd* Instance, int socket, int port, bool iscached, int socketfamily, sockaddr* ip)
856 std::string tempnick = ConvToStr(socket) + "-unknown";
857 user_hash::iterator iter = Instance->clientlist->find(tempnick);
860 if (socketfamily == AF_INET6)
861 inet_ntop(AF_INET6, &((const sockaddr_in6*)ip)->sin6_addr, ipaddr, sizeof(ipaddr));
864 inet_ntop(AF_INET, &((const sockaddr_in*)ip)->sin_addr, ipaddr, sizeof(ipaddr));
868 Instance->unregistered_count++;
872 * as these nicknames are 'RFC impossible', we can be sure nobody is going to be
873 * using one as a registered connection. As they are per fd, we can also safely assume
874 * that we wont have collisions. Therefore, if the nick exists in the list, its only
875 * used by a dead socket, erase the iterator so that the new client may reclaim it.
876 * this was probably the cause of 'server ignores me when i hammer it with reconnects'
877 * issue in earlier alphas/betas
879 if (iter != Instance->clientlist->end())
881 userrec* goner = iter->second;
883 Instance->clientlist->erase(iter);
886 New = new userrec(Instance);
887 (*(Instance->clientlist))[tempnick] = New;
889 strlcpy(New->nick,tempnick.c_str(),NICKMAX-1);
891 New->server = Instance->FindServerNamePtr(Instance->Config->ServerName);
892 /* We don't need range checking here, we KNOW 'unknown\0' will fit into the ident field. */
893 strcpy(New->ident, "unknown");
895 New->registered = REG_NONE;
896 New->signon = Instance->Time() + Instance->Config->dns_timeout;
899 New->SetSockAddr(socketfamily, ipaddr, port);
901 /* Smarter than your average bear^H^H^H^Hset of strlcpys. */
902 for (const char* temp = New->GetIPString(); *temp && j < 64; temp++, j++)
903 New->dhost[j] = New->host[j] = *temp;
904 New->dhost[j] = New->host[j] = 0;
906 Instance->AddLocalClone(New);
907 Instance->AddGlobalClone(New);
910 * First class check. We do this again in FullConnect after DNS is done, and NICK/USER is recieved.
911 * See my note down there for why this is required. DO NOT REMOVE. :) -- w00t
913 ConnectClass* i = New->GetClass();
917 userrec::QuitUser(Instance, New, "Access denied by configuration");
923 New->pingmax = i->GetPingTime();
924 New->nping = Instance->Time() + i->GetPingTime() + Instance->Config->dns_timeout;
925 New->timeout = Instance->Time() + i->GetRegTimeout();
926 New->flood = i->GetFlood();
927 New->threshold = i->GetThreshold();
928 New->sendqmax = i->GetSendqMax();
929 New->recvqmax = i->GetRecvqMax();
931 Instance->local_users.push_back(New);
933 if ((Instance->local_users.size() > Instance->Config->SoftLimit) || (Instance->local_users.size() >= MAXCLIENTS))
935 Instance->WriteOpers("*** Warning: softlimit value has been reached: %d clients", Instance->Config->SoftLimit);
936 userrec::QuitUser(Instance, New,"No more connections allowed");
942 * this is done as a safety check to keep the file descriptors within range of fd_ref_table.
943 * its a pretty big but for the moment valid assumption:
944 * file descriptors are handed out starting at 0, and are recycled as theyre freed.
945 * therefore if there is ever an fd over 65535, 65536 clients must be connected to the
946 * irc server at once (or the irc server otherwise initiating this many connections, files etc)
947 * which for the time being is a physical impossibility (even the largest networks dont have more
948 * than about 10,000 users on ONE server!)
951 if ((unsigned int)socket >= MAX_DESCRIPTORS)
953 userrec::QuitUser(Instance, New, "Server is full");
958 New->exempt = (Instance->XLines->matches_exception(New) != NULL);
961 ZLine* r = Instance->XLines->matches_zline(ipaddr);
965 if (*Instance->Config->MoronBanner)
966 New->WriteServ("NOTICE %s :*** %s", New->nick, Instance->Config->MoronBanner);
967 snprintf(reason,MAXBUF,"Z-Lined: %s",r->reason);
968 userrec::QuitUser(Instance, New, reason);
975 if (!Instance->SE->AddFd(New))
977 userrec::QuitUser(Instance, New, "Internal error handling connection");
982 /* NOTE: even if dns lookups are *off*, we still need to display this.
983 * BOPM and other stuff requires it.
985 New->WriteServ("NOTICE Auth :*** Looking up your hostname...");
988 unsigned long userrec::GlobalCloneCount()
990 clonemap::iterator x = ServerInstance->global_clones.find(this->GetIPString());
991 if (x != ServerInstance->global_clones.end())
997 unsigned long userrec::LocalCloneCount()
999 clonemap::iterator x = ServerInstance->local_clones.find(this->GetIPString());
1000 if (x != ServerInstance->local_clones.end())
1007 * Check class restrictions
1009 void userrec::CheckClass()
1011 ConnectClass* a = this->GetClass();
1013 if ((!a) || (a->GetType() == CC_DENY))
1015 userrec::QuitUser(ServerInstance, this, "Unauthorised connection");
1018 else if ((a->GetMaxLocal()) && (this->LocalCloneCount() > a->GetMaxLocal()))
1020 userrec::QuitUser(ServerInstance, this, "No more connections allowed from your host via this connect class (local)");
1021 ServerInstance->WriteOpers("*** WARNING: maximum LOCAL connections (%ld) exceeded for IP %s", a->GetMaxLocal(), this->GetIPString());
1024 else if ((a->GetMaxGlobal()) && (this->GlobalCloneCount() > a->GetMaxGlobal()))
1026 userrec::QuitUser(ServerInstance, this, "No more connections allowed from your host via this connect class (global)");
1027 ServerInstance->WriteOpers("*** WARNING: maximum GLOBAL connections (%ld) exceeded for IP %s", a->GetMaxGlobal(), this->GetIPString());
1032 void userrec::FullConnect()
1034 ServerInstance->stats->statsConnects++;
1035 this->idle_lastmsg = ServerInstance->Time();
1038 * You may be thinking "wtf, we checked this in userrec::AddClient!" - and yes, we did, BUT.
1039 * At the time AddClient is called, we don't have a resolved host, by here we probably do - which
1040 * may put the user into a totally seperate class with different restrictions! so we *must* check again.
1041 * Don't remove this! -- w00t
1045 /* Check the password, if one is required by the user's connect class.
1046 * This CANNOT be in CheckClass(), because that is called prior to PASS as well!
1048 if ((!this->GetClass()->GetPass().empty()) && (!this->haspassed))
1050 userrec::QuitUser(ServerInstance, this, "Invalid password");
1056 GLine* r = ServerInstance->XLines->matches_gline(this);
1061 char reason[MAXBUF];
1062 if (*ServerInstance->Config->MoronBanner)
1063 this->WriteServ("NOTICE %s :*** %s", this->nick, ServerInstance->Config->MoronBanner);
1064 snprintf(reason,MAXBUF,"G-Lined: %s",r->reason);
1065 ServerInstance->GlobalCulls.AddItem(this, reason);
1069 KLine* n = ServerInstance->XLines->matches_kline(this);
1074 char reason[MAXBUF];
1075 if (*ServerInstance->Config->MoronBanner)
1076 this->WriteServ("NOTICE %s :*** %s", this, ServerInstance->Config->MoronBanner);
1077 snprintf(reason,MAXBUF,"K-Lined: %s",n->reason);
1078 ServerInstance->GlobalCulls.AddItem(this, reason);
1083 this->WriteServ("NOTICE Auth :Welcome to \002%s\002!",ServerInstance->Config->Network);
1084 this->WriteServ("001 %s :Welcome to the %s IRC Network %s!%s@%s",this->nick, ServerInstance->Config->Network, this->nick, this->ident, this->host);
1085 this->WriteServ("002 %s :Your host is %s, running version %s",this->nick,ServerInstance->Config->ServerName,VERSION);
1086 this->WriteServ("003 %s :This server was created %s %s", this->nick, __TIME__, __DATE__);
1087 this->WriteServ("004 %s %s %s %s %s %s", this->nick, ServerInstance->Config->ServerName, VERSION, ServerInstance->Modes->UserModeList().c_str(), ServerInstance->Modes->ChannelModeList().c_str(), ServerInstance->Modes->ParaModeList().c_str());
1089 ServerInstance->Config->Send005(this);
1093 /* Now registered */
1094 if (ServerInstance->unregistered_count)
1095 ServerInstance->unregistered_count--;
1097 /* Trigger LUSERS output, give modules a chance too */
1099 FOREACH_RESULT(I_OnPreCommand, OnPreCommand("LUSERS", NULL, 0, this, true, "LUSERS"));
1101 ServerInstance->CallCommandHandler("LUSERS", NULL, 0, this);
1104 * fix 3 by brain, move registered = 7 below these so that spurious modes and host
1105 * changes dont go out onto the network and produce 'fake direction'.
1107 FOREACH_MOD(I_OnUserConnect,OnUserConnect(this));
1109 this->registered = REG_ALL;
1111 FOREACH_MOD(I_OnPostConnect,OnPostConnect(this));
1113 ServerInstance->SNO->WriteToSnoMask('c',"Client connecting on port %d: %s!%s@%s [%s] [%s]", this->GetPort(), this->nick, this->ident, this->host, this->GetIPString(), this->fullname);
1116 /** userrec::UpdateNick()
1117 * re-allocates a nick in the user_hash after they change nicknames,
1118 * returns a pointer to the new user as it may have moved
1120 userrec* userrec::UpdateNickHash(const char* New)
1124 //user_hash::iterator newnick;
1125 user_hash::iterator oldnick = ServerInstance->clientlist->find(this->nick);
1127 if (!strcasecmp(this->nick,New))
1128 return oldnick->second;
1130 if (oldnick == ServerInstance->clientlist->end())
1131 return NULL; /* doesnt exist */
1133 userrec* olduser = oldnick->second;
1134 (*(ServerInstance->clientlist))[New] = olduser;
1135 ServerInstance->clientlist->erase(oldnick);
1141 ServerInstance->Log(DEBUG,"Exception in userrec::UpdateNickHash()");
1146 void userrec::InvalidateCache()
1148 /* Invalidate cache */
1149 if (cached_fullhost)
1150 free(cached_fullhost);
1152 free(cached_hostip);
1153 if (cached_makehost)
1154 free(cached_makehost);
1155 if (cached_fullrealhost)
1156 free(cached_fullrealhost);
1157 cached_fullhost = cached_hostip = cached_makehost = cached_fullrealhost = NULL;
1160 bool userrec::ForceNickChange(const char* newnick)
1166 this->InvalidateCache();
1168 FOREACH_RESULT(I_OnUserPreNick,OnUserPreNick(this, newnick));
1172 ServerInstance->stats->statsCollisions++;
1176 if (ServerInstance->XLines->matches_qline(newnick))
1178 ServerInstance->stats->statsCollisions++;
1182 if (this->registered == REG_ALL)
1184 return (ServerInstance->Parser->CallHandler("NICK", &newnick, 1, this) == CMD_SUCCESS);
1191 ServerInstance->Log(DEBUG,"Exception in userrec::ForceNickChange()");
1196 void userrec::SetSockAddr(int protocol_family, const char* ip, int port)
1198 switch (protocol_family)
1200 #ifdef SUPPORT_IP6LINKS
1203 sockaddr_in6* sin = new sockaddr_in6;
1204 sin->sin6_family = AF_INET6;
1205 sin->sin6_port = port;
1206 inet_pton(AF_INET6, ip, &sin->sin6_addr);
1207 this->ip = (sockaddr*)sin;
1213 sockaddr_in* sin = new sockaddr_in;
1214 sin->sin_family = AF_INET;
1215 sin->sin_port = port;
1216 inet_pton(AF_INET, ip, &sin->sin_addr);
1217 this->ip = (sockaddr*)sin;
1221 ServerInstance->Log(DEBUG,"Ut oh, I dont know protocol %d to be set on '%s'!", protocol_family, this->nick);
1226 int userrec::GetPort()
1228 if (this->ip == NULL)
1231 switch (this->GetProtocolFamily())
1233 #ifdef SUPPORT_IP6LINKS
1236 sockaddr_in6* sin = (sockaddr_in6*)this->ip;
1237 return sin->sin6_port;
1243 sockaddr_in* sin = (sockaddr_in*)this->ip;
1244 return sin->sin_port;
1253 int userrec::GetProtocolFamily()
1255 if (this->ip == NULL)
1258 sockaddr_in* sin = (sockaddr_in*)this->ip;
1259 return sin->sin_family;
1262 const char* userrec::GetIPString()
1264 static char buf[1024];
1266 if (this->ip == NULL)
1269 switch (this->GetProtocolFamily())
1271 #ifdef SUPPORT_IP6LINKS
1274 static char temp[1024];
1276 sockaddr_in6* sin = (sockaddr_in6*)this->ip;
1277 inet_ntop(sin->sin6_family, &sin->sin6_addr, buf, sizeof(buf));
1278 /* IP addresses starting with a : on irc are a Bad Thing (tm) */
1281 strlcpy(&temp[1], buf, sizeof(temp) - 1);
1291 sockaddr_in* sin = (sockaddr_in*)this->ip;
1292 inet_ntop(sin->sin_family, &sin->sin_addr, buf, sizeof(buf));
1302 const char* userrec::GetIPString(char* buf)
1304 if (this->ip == NULL)
1310 switch (this->GetProtocolFamily())
1312 #ifdef SUPPORT_IP6LINKS
1315 static char temp[1024];
1317 sockaddr_in6* sin = (sockaddr_in6*)this->ip;
1318 inet_ntop(sin->sin6_family, &sin->sin6_addr, buf, sizeof(buf));
1319 /* IP addresses starting with a : on irc are a Bad Thing (tm) */
1322 strlcpy(&temp[1], buf, sizeof(temp) - 1);
1324 strlcpy(buf, temp, sizeof(temp));
1332 sockaddr_in* sin = (sockaddr_in*)this->ip;
1333 inet_ntop(sin->sin_family, &sin->sin_addr, buf, sizeof(buf));
1344 /** NOTE: We cannot pass a const reference to this method.
1345 * The string is changed by the workings of the method,
1346 * so that if we pass const ref, we end up copying it to
1347 * something we can change anyway. Makes sense to just let
1348 * the compiler do that copy for us.
1350 void userrec::Write(std::string text)
1353 if ((this->fd < 0) || (this->m_internalFd > MAX_DESCRIPTORS))
1355 if ((this->fd < 0) || (this->fd > MAX_DESCRIPTORS))
1361 /* ServerInstance->Log(DEBUG,"C[%d] <- %s", this->GetFd(), text.c_str());
1362 * WARNING: The above debug line is VERY loud, do NOT
1363 * enable it till we have a good way of filtering it
1364 * out of the logs (e.g. 1.2 would be good).
1366 text.append("\r\n");
1370 ServerInstance->Log(DEBUG,"Exception in userrec::Write() std::string::append");
1374 if (ServerInstance->Config->GetIOHook(this->GetPort()))
1378 ServerInstance->Config->GetIOHook(this->GetPort())->OnRawSocketWrite(this->fd, text.data(), text.length());
1380 catch (CoreException& modexcept)
1382 ServerInstance->Log(DEBUG, "%s threw an exception: %s", modexcept.GetSource(), modexcept.GetReason());
1387 this->AddWriteBuf(text);
1389 ServerInstance->stats->statsSent += text.length();
1390 this->ServerInstance->SE->WantWrite(this);
1395 void userrec::Write(const char *text, ...)
1398 char textbuffer[MAXBUF];
1400 va_start(argsPtr, text);
1401 vsnprintf(textbuffer, MAXBUF, text, argsPtr);
1404 this->Write(std::string(textbuffer));
1407 void userrec::WriteServ(const std::string& text)
1409 char textbuffer[MAXBUF];
1411 snprintf(textbuffer,MAXBUF,":%s %s",ServerInstance->Config->ServerName,text.c_str());
1412 this->Write(std::string(textbuffer));
1416 * Same as Write(), except `text' is prefixed with `:server.name '.
1418 void userrec::WriteServ(const char* text, ...)
1421 char textbuffer[MAXBUF];
1423 va_start(argsPtr, text);
1424 vsnprintf(textbuffer, MAXBUF, text, argsPtr);
1427 this->WriteServ(std::string(textbuffer));
1431 void userrec::WriteFrom(userrec *user, const std::string &text)
1435 snprintf(tb,MAXBUF,":%s %s",user->GetFullHost(),text.c_str());
1437 this->Write(std::string(tb));
1441 /* write text from an originating user to originating user */
1443 void userrec::WriteFrom(userrec *user, const char* text, ...)
1446 char textbuffer[MAXBUF];
1448 va_start(argsPtr, text);
1449 vsnprintf(textbuffer, MAXBUF, text, argsPtr);
1452 this->WriteFrom(user, std::string(textbuffer));
1456 /* write text to an destination user from a source user (e.g. user privmsg) */
1458 void userrec::WriteTo(userrec *dest, const char *data, ...)
1460 char textbuffer[MAXBUF];
1463 va_start(argsPtr, data);
1464 vsnprintf(textbuffer, MAXBUF, data, argsPtr);
1467 this->WriteTo(dest, std::string(textbuffer));
1470 void userrec::WriteTo(userrec *dest, const std::string &data)
1472 dest->WriteFrom(this, data);
1476 void userrec::WriteCommon(const char* text, ...)
1478 char textbuffer[MAXBUF];
1481 if (this->registered != REG_ALL)
1484 va_start(argsPtr, text);
1485 vsnprintf(textbuffer, MAXBUF, text, argsPtr);
1488 this->WriteCommon(std::string(textbuffer));
1491 void userrec::WriteCommon(const std::string &text)
1495 bool sent_to_at_least_one = false;
1498 if (this->registered != REG_ALL)
1503 /* We dont want to be doing this n times, just once */
1504 snprintf(tb,MAXBUF,":%s %s",this->GetFullHost(),text.c_str());
1505 std::string out = tb;
1507 for (UCListIter v = this->chans.begin(); v != this->chans.end(); v++)
1509 CUList* ulist = v->first->GetUsers();
1510 for (CUList::iterator i = ulist->begin(); i != ulist->end(); i++)
1512 if ((IS_LOCAL(i->first)) && (already_sent[i->first->fd] != uniq_id))
1514 already_sent[i->first->fd] = uniq_id;
1515 i->first->Write(out);
1516 sent_to_at_least_one = true;
1522 * if the user was not in any channels, no users will receive the text. Make sure the user
1523 * receives their OWN message for WriteCommon
1525 if (!sent_to_at_least_one)
1527 this->Write(std::string(tb));
1533 ServerInstance->Log(DEBUG,"Exception in userrec::WriteCommon()");
1538 /* write a formatted string to all users who share at least one common
1539 * channel, NOT including the source user e.g. for use in QUIT
1542 void userrec::WriteCommonExcept(const char* text, ...)
1544 char textbuffer[MAXBUF];
1547 va_start(argsPtr, text);
1548 vsnprintf(textbuffer, MAXBUF, text, argsPtr);
1551 this->WriteCommonExcept(std::string(textbuffer));
1554 void userrec::WriteCommonQuit(const std::string &normal_text, const std::string &oper_text)
1559 if (this->registered != REG_ALL)
1563 snprintf(tb1,MAXBUF,":%s QUIT :%s",this->GetFullHost(),normal_text.c_str());
1564 snprintf(tb2,MAXBUF,":%s QUIT :%s",this->GetFullHost(),oper_text.c_str());
1565 std::string out1 = tb1;
1566 std::string out2 = tb2;
1568 for (UCListIter v = this->chans.begin(); v != this->chans.end(); v++)
1570 CUList *ulist = v->first->GetUsers();
1571 for (CUList::iterator i = ulist->begin(); i != ulist->end(); i++)
1573 if (this != i->first)
1575 if ((IS_LOCAL(i->first)) && (already_sent[i->first->fd] != uniq_id))
1577 already_sent[i->first->fd] = uniq_id;
1578 i->first->Write(IS_OPER(i->first) ? out2 : out1);
1585 void userrec::WriteCommonExcept(const std::string &text)
1590 if (this->registered != REG_ALL)
1594 snprintf(tb1,MAXBUF,":%s %s",this->GetFullHost(),text.c_str());
1597 for (UCListIter v = this->chans.begin(); v != this->chans.end(); v++)
1599 CUList *ulist = v->first->GetUsers();
1600 for (CUList::iterator i = ulist->begin(); i != ulist->end(); i++)
1602 if (this != i->first)
1604 if ((IS_LOCAL(i->first)) && (already_sent[i->first->fd] != uniq_id))
1606 already_sent[i->first->fd] = uniq_id;
1607 i->first->Write(out1);
1615 void userrec::WriteWallOps(const std::string &text)
1617 if (!IS_OPER(this) && IS_LOCAL(this))
1620 std::string wallop("WALLOPS :");
1621 wallop.append(text);
1623 for (std::vector<userrec*>::const_iterator i = ServerInstance->local_users.begin(); i != ServerInstance->local_users.end(); i++)
1626 if (t->modes[UM_WALLOPS])
1627 this->WriteTo(t,wallop);
1631 void userrec::WriteWallOps(const char* text, ...)
1633 char textbuffer[MAXBUF];
1636 va_start(argsPtr, text);
1637 vsnprintf(textbuffer, MAXBUF, text, argsPtr);
1640 this->WriteWallOps(std::string(textbuffer));
1643 /* return 0 or 1 depending if users u and u2 share one or more common channels
1644 * (used by QUIT, NICK etc which arent channel specific notices)
1646 * The old algorithm in 1.0 for this was relatively inefficient, iterating over
1647 * the first users channels then the second users channels within the outer loop,
1648 * therefore it was a maximum of x*y iterations (upon returning 0 and checking
1649 * all possible iterations). However this new function instead checks against the
1650 * channel's userlist in the inner loop which is a std::map<userrec*,userrec*>
1651 * and saves us time as we already know what pointer value we are after.
1652 * Don't quote me on the maths as i am not a mathematician or computer scientist,
1653 * but i believe this algorithm is now x+(log y) maximum iterations instead.
1655 bool userrec::SharesChannelWith(userrec *other)
1657 if ((!other) || (this->registered != REG_ALL) || (other->registered != REG_ALL))
1661 for (UCListIter i = this->chans.begin(); i != this->chans.end(); i++)
1663 /* Eliminate the inner loop (which used to be ~equal in size to the outer loop)
1664 * by replacing it with a map::find which *should* be more efficient
1666 if (i->first->HasUser(other))
1672 bool userrec::ChangeName(const char* gecos)
1674 if (!strcmp(gecos, this->fullname))
1680 FOREACH_RESULT(I_OnChangeLocalUserGECOS,OnChangeLocalUserGECOS(this,gecos));
1683 FOREACH_MOD(I_OnChangeName,OnChangeName(this,gecos));
1685 strlcpy(this->fullname,gecos,MAXGECOS+1);
1690 bool userrec::ChangeDisplayedHost(const char* host)
1692 if (!strcmp(host, this->dhost))
1698 FOREACH_RESULT(I_OnChangeLocalUserHost,OnChangeLocalUserHost(this,host));
1701 FOREACH_MOD(I_OnChangeHost,OnChangeHost(this,host));
1703 if (this->ServerInstance->Config->CycleHosts)
1704 this->WriteCommonExcept("QUIT :Changing hosts");
1706 /* Fix by Om: userrec::dhost is 65 long, this was truncating some long hosts */
1707 strlcpy(this->dhost,host,64);
1709 this->InvalidateCache();
1711 if (this->ServerInstance->Config->CycleHosts)
1713 for (UCListIter i = this->chans.begin(); i != this->chans.end(); i++)
1715 i->first->WriteAllExceptSender(this, false, 0, "JOIN %s", i->first->name);
1716 std::string n = this->ServerInstance->Modes->ModeString(this, i->first);
1718 i->first->WriteAllExceptSender(this, true, 0, "MODE %s +%s", i->first->name, n.c_str());
1723 this->WriteServ("396 %s %s :is now your displayed host",this->nick,this->dhost);
1728 bool userrec::ChangeIdent(const char* newident)
1730 if (!strcmp(newident, this->ident))
1733 if (this->ServerInstance->Config->CycleHosts)
1734 this->WriteCommonExcept("%s","QUIT :Changing ident");
1736 strlcpy(this->ident, newident, IDENTMAX+2);
1738 this->InvalidateCache();
1740 if (this->ServerInstance->Config->CycleHosts)
1742 for (UCListIter i = this->chans.begin(); i != this->chans.end(); i++)
1744 i->first->WriteAllExceptSender(this, false, 0, "JOIN %s", i->first->name);
1745 std::string n = this->ServerInstance->Modes->ModeString(this, i->first);
1747 i->first->WriteAllExceptSender(this, true, 0, "MODE %s +%s", i->first->name, n.c_str());
1754 void userrec::SendAll(const char* command, char* text, ...)
1756 char textbuffer[MAXBUF];
1757 char formatbuffer[MAXBUF];
1760 va_start(argsPtr, text);
1761 vsnprintf(textbuffer, MAXBUF, text, argsPtr);
1764 snprintf(formatbuffer,MAXBUF,":%s %s $* :%s", this->GetFullHost(), command, textbuffer);
1765 std::string fmt = formatbuffer;
1767 for (std::vector<userrec*>::const_iterator i = ServerInstance->local_users.begin(); i != ServerInstance->local_users.end(); i++)
1774 std::string userrec::ChannelList(userrec* source)
1779 for (UCListIter i = this->chans.begin(); i != this->chans.end(); i++)
1781 /* If the target is the same as the sender, let them see all their channels.
1782 * If the channel is NOT private/secret OR the user shares a common channel
1783 * If the user is an oper, and the <options:operspywhois> option is set.
1785 if ((source == this) || (IS_OPER(source) && ServerInstance->Config->OperSpyWhois) || (((!i->first->modes[CM_PRIVATE]) && (!i->first->modes[CM_SECRET])) || (i->first->HasUser(source))))
1787 list.append(i->first->GetPrefixChar(this)).append(i->first->name).append(" ");
1794 ServerInstance->Log(DEBUG,"Exception in userrec::ChannelList()");
1799 void userrec::SplitChanList(userrec* dest, const std::string &cl)
1802 std::ostringstream prefix;
1803 std::string::size_type start, pos, length;
1807 prefix << this->nick << " " << dest->nick << " :";
1808 line = prefix.str();
1809 int namelen = strlen(ServerInstance->Config->ServerName) + 6;
1811 for (start = 0; (pos = cl.find(' ', start)) != std::string::npos; start = pos+1)
1813 length = (pos == std::string::npos) ? cl.length() : pos;
1815 if (line.length() + namelen + length - start > 510)
1817 ServerInstance->SendWhoisLine(this, dest, 319, "%s", line.c_str());
1818 line = prefix.str();
1821 if(pos == std::string::npos)
1823 line.append(cl.substr(start, length - start));
1828 line.append(cl.substr(start, length - start + 1));
1834 ServerInstance->SendWhoisLine(this, dest, 319, "%s", line.c_str());
1840 ServerInstance->Log(DEBUG,"Exception in userrec::SplitChanList()");
1845 /* looks up a users password for their connection class (<ALLOW>/<DENY> tags)
1846 * NOTE: If the <ALLOW> or <DENY> tag specifies an ip, and this user resolves,
1847 * then their ip will be taken as 'priority' anyway, so for example,
1848 * <connect allow="127.0.0.1"> will match joe!bloggs@localhost
1850 ConnectClass* userrec::GetClass()
1852 for (ClassVector::iterator i = ServerInstance->Config->Classes.begin(); i != ServerInstance->Config->Classes.end(); i++)
1854 if (((match(this->GetIPString(),i->GetHost().c_str(),true)) || (match(this->host,i->GetHost().c_str()))))
1858 if (this->GetPort() == i->GetPort())
1870 void userrec::PurgeEmptyChannels()
1872 std::vector<chanrec*> to_delete;
1874 // firstly decrement the count on each channel
1875 for (UCListIter f = this->chans.begin(); f != this->chans.end(); f++)
1877 f->first->RemoveAllPrefixes(this);
1878 if (f->first->DelUser(this) == 0)
1880 /* No users left in here, mark it for deletion */
1883 to_delete.push_back(f->first);
1887 ServerInstance->Log(DEBUG,"Exception in userrec::PurgeEmptyChannels to_delete.push_back()");
1892 for (std::vector<chanrec*>::iterator n = to_delete.begin(); n != to_delete.end(); n++)
1894 chanrec* thischan = *n;
1895 chan_hash::iterator i2 = ServerInstance->chanlist->find(thischan->name);
1896 if (i2 != ServerInstance->chanlist->end())
1898 FOREACH_MOD(I_OnChannelDelete,OnChannelDelete(i2->second));
1900 ServerInstance->chanlist->erase(i2);
1901 this->chans.erase(*n);
1908 void userrec::ShowMOTD()
1910 if (!ServerInstance->Config->MOTD.size())
1912 this->WriteServ("422 %s :Message of the day file is missing.",this->nick);
1915 this->WriteServ("375 %s :%s message of the day", this->nick, ServerInstance->Config->ServerName);
1917 for (file_cache::iterator i = ServerInstance->Config->MOTD.begin(); i != ServerInstance->Config->MOTD.end(); i++)
1918 this->WriteServ("372 %s :- %s",this->nick,i->c_str());
1920 this->WriteServ("376 %s :End of message of the day.", this->nick);
1923 void userrec::ShowRULES()
1925 if (!ServerInstance->Config->RULES.size())
1927 this->WriteServ("NOTICE %s :Rules file is missing.",this->nick);
1930 this->WriteServ("NOTICE %s :%s rules",this->nick,ServerInstance->Config->ServerName);
1932 for (file_cache::iterator i = ServerInstance->Config->RULES.begin(); i != ServerInstance->Config->RULES.end(); i++)
1933 this->WriteServ("NOTICE %s :%s",this->nick,i->c_str());
1935 this->WriteServ("NOTICE %s :End of %s rules.",this->nick,ServerInstance->Config->ServerName);
1938 void userrec::HandleEvent(EventType et, int errornum)
1940 /* WARNING: May delete this user! */
1941 int thisfd = this->GetFd();
1948 ServerInstance->ProcessUser(this);
1951 this->FlushWriteBuf();
1954 /** This should be safe, but dont DARE do anything after it -- Brain */
1955 this->SetWriteError(errornum ? strerror(errornum) : "EOF from client");
1961 ServerInstance->Log(DEBUG,"Exception in userrec::HandleEvent intercepted");
1964 /* If the user has raised an error whilst being processed, quit them now we're safe to */
1965 if ((ServerInstance->SE->GetRef(thisfd) == this))
1967 if (!WriteError.empty())
1969 userrec::QuitUser(ServerInstance, this, GetWriteError());
1974 void userrec::SetOperQuit(const std::string &oquit)
1979 operquit = strdup(oquit.c_str());
1982 const char* userrec::GetOperQuit()
1984 return operquit ? operquit : "";
1995 bool VisData::VisibleTo(userrec* user)