]> arthur.barton.de Git - ngircd-alex.git/blobdiff - src/ngircd/client.c
Always cloak client hostname, if needed
[ngircd-alex.git] / src / ngircd / client.c
index 3c6d3aebfbc596cd7a38cfe202a15c354e9bec6f..4728c7a4672ac802d944dc599d23031f75e50d60 100644 (file)
@@ -1,40 +1,33 @@
 /*
  * ngIRCd -- The Next Generation IRC Daemon
- * Copyright (c)2001,2002 by Alexander Barton (alex@barton.de)
+ * Copyright (c)2001-2012 Alexander Barton (alex@barton.de)
  *
- * Dieses Programm ist freie Software. Sie koennen es unter den Bedingungen
- * der GNU General Public License (GPL), wie von der Free Software Foundation
- * herausgegeben, weitergeben und/oder modifizieren, entweder unter Version 2
- * der Lizenz oder (wenn Sie es wuenschen) jeder spaeteren Version.
- * Naehere Informationen entnehmen Sie bitter der Datei COPYING. Eine Liste
- * der an ngIRCd beteiligten Autoren finden Sie in der Datei AUTHORS.
- *
- * $Id: client.c,v 1.55 2002/05/27 13:09:26 alex Exp $
- *
- * client.c: Management aller Clients
- *
- * Der Begriff "Client" ist in diesem Fall evtl. etwas verwirrend: Clients sind
- * alle Verbindungen, die im gesamten(!) IRC-Netzwerk bekannt sind. Das sind IRC-
- * Clients (User), andere Server und IRC-Services.
- * Ueber welchen IRC-Server die Verbindung nun tatsaechlich in das Netzwerk her-
- * gestellt wurde, muss der jeweiligen Struktur entnommen werden. Ist es dieser
- * Server gewesen, so existiert eine entsprechende CONNECTION-Struktur.
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ * Please read the file COPYING, README and AUTHORS for more information.
  */
 
-
 #define __client_c__
 
-
 #include "portab.h"
 
+/**
+ * @file
+ * Client management.
+ */
+
 #include "imp.h"
 #include <assert.h>
 #include <unistd.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
+#include <strings.h>
 #include <netdb.h>
 
+#include "defines.h"
 #include "conn.h"
 
 #include "exp.h"
@@ -43,8 +36,8 @@
 #include <imp.h>
 #include "ngircd.h"
 #include "channel.h"
-#include "resolve.h"
 #include "conf.h"
+#include "conn-func.h"
 #include "hash.h"
 #include "irc-write.h"
 #include "log.h"
 
 #include <exp.h>
 
+#define GETID_LEN (CLIENT_NICK_LEN-1) + 1 + (CLIENT_USER_LEN-1) + 1 + (CLIENT_HOST_LEN-1) + 1
+
+static CLIENT *This_Server, *My_Clients;
+
+static WHOWAS My_Whowas[MAX_WHOWAS];
+static int Last_Whowas = -1;
+static long Max_Users, My_Max_Users;
 
-LOCAL CLIENT *This_Server, *My_Clients;
-LOCAL CHAR GetID_Buffer[CLIENT_ID_LEN];
 
+static unsigned long Count PARAMS(( CLIENT_TYPE Type ));
+static unsigned long MyCount PARAMS(( CLIENT_TYPE Type ));
 
-LOCAL INT Count PARAMS(( CLIENT_TYPE Type ));
-LOCAL INT MyCount PARAMS(( CLIENT_TYPE Type ));
+static CLIENT *New_Client_Struct PARAMS(( void ));
+static void Generate_MyToken PARAMS(( CLIENT *Client ));
+static void Adjust_Counters PARAMS(( CLIENT *Client ));
 
-LOCAL CLIENT *New_Client_Struct PARAMS(( VOID ));
-LOCAL VOID Generate_MyToken PARAMS(( CLIENT *Client ));
+static CLIENT *Init_New_Client PARAMS((CONN_ID Idx, CLIENT *Introducer,
+                                      CLIENT *TopServer, int Type, const char *ID,
+                                      const char *User, const char *Hostname, const char *Info,
+                                      int Hops, int Token, const char *Modes,
+                                      bool Idented));
 
+static void Destroy_UserOrService PARAMS((CLIENT *Client,const char *Txt, const char *FwdMsg,
+                                       bool SendQuit));
 
-GLOBAL VOID
-Client_Init( VOID )
+static void cb_introduceClient PARAMS((CLIENT *Client, CLIENT *Prefix,
+                                      void *i));
+
+GLOBAL void
+Client_Init( void )
 {
        struct hostent *h;
        
@@ -73,7 +82,7 @@ Client_Init( VOID )
        if( ! This_Server )
        {
                Log( LOG_EMERG, "Can't allocate client structure for server! Going down." );
-               Log( LOG_ALERT, PACKAGE" exiting due to fatal errors!" );
+               Log( LOG_ALERT, "%s exiting due to fatal errors!", PACKAGE_NAME );
                exit( 1 );
        }
 
@@ -86,23 +95,27 @@ Client_Init( VOID )
        This_Server->hops = 0;
 
        gethostname( This_Server->host, CLIENT_HOST_LEN );
-       h = gethostbyname( This_Server->host );
-       if( h ) strcpy( This_Server->host, h->h_name );
-
+       if (Conf_DNS) {
+               h = gethostbyname( This_Server->host );
+               if (h) strlcpy(This_Server->host, h->h_name, sizeof(This_Server->host));
+       }
        Client_SetID( This_Server, Conf_ServerName );
        Client_SetInfo( This_Server, Conf_ServerInfo );
 
        My_Clients = This_Server;
+       
+       memset( &My_Whowas, 0, sizeof( My_Whowas ));
 } /* Client_Init */
 
 
-GLOBAL VOID
-Client_Exit( VOID )
+GLOBAL void
+Client_Exit( void )
 {
        CLIENT *c, *next;
-       INT cnt;
+       int cnt;
 
-       Client_Destroy( This_Server, "Server going down.", NULL, FALSE );
+       if( NGIRCd_SignalRestart ) Client_Destroy( This_Server, "Server going down (restarting).", NULL, false );
+       else Client_Destroy( This_Server, "Server going down.", NULL, false );
        
        cnt = 0;
        c = My_Clients;
@@ -118,80 +131,111 @@ Client_Exit( VOID )
 
 
 GLOBAL CLIENT *
-Client_ThisServer( VOID )
+Client_ThisServer( void )
 {
        return This_Server;
 } /* Client_ThisServer */
 
 
+/**
+ * Initialize new local client; wrapper function for Init_New_Client().
+ * @return New CLIENT structure.
+ */
 GLOBAL CLIENT *
-Client_NewLocal( CONN_ID Idx, CHAR *Hostname, INT Type, BOOLEAN Idented )
+Client_NewLocal(CONN_ID Idx, const char *Hostname, int Type, bool Idented)
 {
-       /* Neuen lokalen Client erzeugen: Wrapper-Funktion fuer Client_New(). */
-       return Client_New( Idx, This_Server, NULL, Type, NULL, NULL, Hostname, NULL, 0, 0, NULL, Idented );
+       return Init_New_Client(Idx, This_Server, NULL, Type, NULL, NULL,
+               Hostname, NULL, 0, 0, NULL, Idented);
 } /* Client_NewLocal */
 
 
+/**
+ * Initialize new remote server; wrapper function for Init_New_Client().
+ * @return New CLIENT structure.
+ */
 GLOBAL CLIENT *
-Client_NewRemoteServer( CLIENT *Introducer, CHAR *Hostname, CLIENT *TopServer, INT Hops, INT Token, CHAR *Info, BOOLEAN Idented )
+Client_NewRemoteServer(CLIENT *Introducer, const char *Hostname, CLIENT *TopServer,
+ int Hops, int Token, const char *Info, bool Idented)
 {
-       /* Neuen Remote-Client erzeugen: Wrapper-Funktion fuer Client_New (). */
-       return Client_New( NONE, Introducer, TopServer, CLIENT_SERVER, Hostname, NULL, Hostname, Info, Hops, Token, NULL, Idented );
+       return Init_New_Client(NONE, Introducer, TopServer, CLIENT_SERVER,
+               Hostname, NULL, Hostname, Info, Hops, Token, NULL, Idented);
 } /* Client_NewRemoteServer */
 
 
+/**
+ * Initialize new remote client; wrapper function for Init_New_Client().
+ * @return New CLIENT structure.
+ */
 GLOBAL CLIENT *
-Client_NewRemoteUser( CLIENT *Introducer, CHAR *Nick, INT Hops, CHAR *User, CHAR *Hostname, INT Token, CHAR *Modes, CHAR *Info, BOOLEAN Idented )
+Client_NewRemoteUser(CLIENT *Introducer, const char *Nick, int Hops, const char *User,
+ const char *Hostname, int Token, const char *Modes, const char *Info, bool Idented)
 {
-       /* Neuen Remote-Client erzeugen: Wrapper-Funktion fuer Client_New (). */
-       return Client_New( NONE, Introducer, NULL, CLIENT_USER, Nick, User, Hostname, Info, Hops, Token, Modes, Idented );
+       return Init_New_Client(NONE, Introducer, NULL, CLIENT_USER, Nick,
+               User, Hostname, Info, Hops, Token, Modes, Idented);
 } /* Client_NewRemoteUser */
 
 
-GLOBAL CLIENT *
-Client_New( CONN_ID Idx, CLIENT *Introducer, CLIENT *TopServer, INT Type, CHAR *ID, CHAR *User, CHAR *Hostname, CHAR *Info, INT Hops, INT Token, CHAR *Modes, BOOLEAN Idented )
+/**
+ * Initialize new client and set up the given parameters like client type,
+ * user name, host name, introducing server etc. ...
+ * @return New CLIENT structure.
+ */
+static CLIENT *
+Init_New_Client(CONN_ID Idx, CLIENT *Introducer, CLIENT *TopServer,
+  int Type, const char *ID, const char *User, const char *Hostname,
+  const char *Info, int Hops, int Token, const char *Modes, bool Idented)
 {
        CLIENT *client;
 
-       assert( Idx >= NONE );
-       assert( Introducer != NULL );
-       assert( Hostname != NULL );
+       assert(Idx >= NONE);
+       assert(Introducer != NULL);
 
-       client = New_Client_Struct( );
-       if( ! client ) return NULL;
+       client = New_Client_Struct();
+       if (!client)
+               return NULL;
 
-       /* Initialisieren */
+       client->starttime = time(NULL);
        client->conn_id = Idx;
        client->introducer = Introducer;
        client->topserver = TopServer;
        client->type = Type;
-       if( ID ) Client_SetID( client, ID );
-       if( User ) Client_SetUser( client, User, Idented );
-       if( Hostname ) Client_SetHostname( client, Hostname );
-       if( Info ) Client_SetInfo( client, Info );
+       if (ID)
+               Client_SetID(client, ID);
+       if (User) {
+               Client_SetUser(client, User, Idented);
+               Client_SetOrigUser(client, User);
+       }
+       if (Hostname)
+               Client_SetHostname(client, Hostname);
+       if (Info)
+               Client_SetInfo(client, Info);
        client->hops = Hops;
        client->token = Token;
-       if( Modes ) Client_SetModes( client, Modes );
-       if( Type == CLIENT_SERVER ) Generate_MyToken( client );
+       if (Modes)
+               Client_SetModes(client, Modes);
+       if (Type == CLIENT_SERVER)
+               Generate_MyToken(client);
 
-       /* ist der User away? */
-       if( strchr( client->modes, 'a' )) strcpy( client->away, DEFAULT_AWAY_MSG );
+       if (strchr(client->modes, 'a'))
+               strlcpy(client->away, DEFAULT_AWAY_MSG, sizeof(client->away));
 
-       /* Verketten */
        client->next = (POINTER *)My_Clients;
        My_Clients = client;
 
+       Adjust_Counters(client);
+
        return client;
-} /* Client_New */
+} /* Init_New_Client */
 
 
-GLOBAL VOID
-Client_Destroy( CLIENT *Client, CHAR *LogMsg, CHAR *FwdMsg, BOOLEAN SendQuit )
+GLOBAL void
+Client_Destroy( CLIENT *Client, const char *LogMsg, const char *FwdMsg, bool SendQuit )
 {
-       /* Client entfernen. */
+       /* remove a client */
        
        CLIENT *last, *c;
-       CHAR msg[LINE_LEN], *txt;
+       char msg[LINE_LEN];
+       const char *txt;
 
        assert( Client != NULL );
 
@@ -199,8 +243,12 @@ Client_Destroy( CLIENT *Client, CHAR *LogMsg, CHAR *FwdMsg, BOOLEAN SendQuit )
        else txt = FwdMsg;
        if( ! txt ) txt = "Reason unknown.";
 
-       /* Netz-Split-Nachricht vorbereiten (noch nicht optimal) */
-       if( Client->type == CLIENT_SERVER ) sprintf( msg, "%s: lost server %s", This_Server->id, Client->id );
+       /* netsplit message */
+       if( Client->type == CLIENT_SERVER ) {
+               strlcpy(msg, This_Server->id, sizeof (msg));
+               strlcat(msg, " ", sizeof (msg));
+               strlcat(msg, Client->id, sizeof (msg));
+       }
 
        last = NULL;
        c = My_Clients;
@@ -208,49 +256,29 @@ Client_Destroy( CLIENT *Client, CHAR *LogMsg, CHAR *FwdMsg, BOOLEAN SendQuit )
        {
                if(( Client->type == CLIENT_SERVER ) && ( c->introducer == Client ) && ( c != Client ))
                {
-                       /* der Client, der geloescht wird ist ein Server. Der Client, den wir gerade
-                        * pruefen, ist ein Child von diesem und muss daher auch entfernt werden */
-                       Client_Destroy( c, NULL, msg, FALSE );
+                       /*
+                        * The client that is about to be removed is a server,
+                        * the client we are checking right now is a child of that
+                        * server and thus has to be removed, too.
+                        *
+                        * Call Client_Destroy() recursively with the server as the
+                        * new "object to be removed". This starts the cycle again, until
+                        * all servers that are linked via the original server have been
+                        * removed.
+                        */
+                       Client_Destroy( c, NULL, msg, false );
                        last = NULL;
                        c = My_Clients;
                        continue;
                }
                if( c == Client )
                {
-                       /* Wir haben den Client gefunden: entfernen */
+                       /* found  the client: remove it */
                        if( last ) last->next = c->next;
                        else My_Clients = (CLIENT *)c->next;
 
-                       if( c->type == CLIENT_USER )
-                       {
-                               if( c->conn_id != NONE )
-                               {
-                                       /* Ein lokaler User */
-                                       Log( LOG_NOTICE, "User \"%s\" unregistered (connection %d): %s", Client_Mask( c ), c->conn_id, txt );
-
-                                       if( SendQuit )
-                                       {
-                                               /* Alle andere Server informieren! */
-                                               if( FwdMsg ) IRC_WriteStrServersPrefix( NULL, c, "QUIT :%s", FwdMsg );
-                                               else IRC_WriteStrServersPrefix( NULL, c, "QUIT :" );
-                                       }
-                               }
-                               else
-                               {
-                                       /* Remote User */
-                                       Log( LOG_DEBUG, "User \"%s\" unregistered: %s", Client_Mask( c ), txt );
-
-                                       if( SendQuit )
-                                       {
-                                               /* Andere Server informieren, ausser denen, die "in
-                                                * Richtung dem liegen", auf dem der User registriert
-                                                * ist. Von denen haben wir das QUIT ja wohl bekommen. */
-                                               if( FwdMsg ) IRC_WriteStrServersPrefix( Client_NextHop( c ), c, "QUIT :%s", FwdMsg );
-                                               else IRC_WriteStrServersPrefix( Client_NextHop( c ), c, "QUIT :" );
-                                       }
-                               }
-                               Channel_RemoveClient( c, FwdMsg ? FwdMsg : c->id );
-                       }
+                       if(c->type == CLIENT_USER || c->type == CLIENT_SERVICE)
+                               Destroy_UserOrService(c, txt, FwdMsg, SendQuit);
                        else if( c->type == CLIENT_SERVER )
                        {
                                if( c != This_Server )
@@ -259,8 +287,8 @@ Client_Destroy( CLIENT *Client, CHAR *LogMsg, CHAR *FwdMsg, BOOLEAN SendQuit )
                                        else Log( LOG_NOTICE|LOG_snotice, "Server \"%s\" unregistered: %s", c->id, txt );
                                }
 
-                               /* andere Server informieren */
-                               if( ! NGIRCd_Quit )
+                               /* inform other servers */
+                               if( ! NGIRCd_SignalQuit )
                                {
                                        if( FwdMsg ) IRC_WriteStrServersPrefix( Client_NextHop( c ), c, "SQUIT %s :%s", c->id, FwdMsg );
                                        else IRC_WriteStrServersPrefix( Client_NextHop( c ), c, "SQUIT %s :", c->id );
@@ -272,11 +300,9 @@ Client_Destroy( CLIENT *Client, CHAR *LogMsg, CHAR *FwdMsg, BOOLEAN SendQuit )
                                {
                                        if( c->id[0] ) Log( LOG_NOTICE, "Client \"%s\" unregistered (connection %d): %s", c->id, c->conn_id, txt );
                                        else Log( LOG_NOTICE, "Client unregistered (connection %d): %s", c->conn_id, txt );
-                               }
-                               else
-                               {
-                                       if( c->id[0] ) Log( LOG_WARNING, "Unregistered unknown client \"%s\": %s", c->id, txt );
-                                       else Log( LOG_WARNING, "Unregistered unknown client: %s", c->id, txt );
+                               } else {
+                                       Log(LOG_WARNING, "Unregistered unknown client \"%s\": %s",
+                                                               c->id[0] ? c->id : "(No Nick)", txt );
                                }
                        }
 
@@ -289,142 +315,172 @@ Client_Destroy( CLIENT *Client, CHAR *LogMsg, CHAR *FwdMsg, BOOLEAN SendQuit )
 } /* Client_Destroy */
 
 
-GLOBAL VOID
-Client_SetHostname( CLIENT *Client, CHAR *Hostname )
+/**
+ * Set client hostname.
+ *
+ * If global hostname cloaking is in effect, don't set the real hostname
+ * but the configured one.
+ *
+ * @param Client The client of which the hostname should be set.
+ * @param Hostname The new hostname.
+ */
+GLOBAL void
+Client_SetHostname( CLIENT *Client, const char *Hostname )
 {
-       /* Hostname eines Clients setzen */
-       
-       assert( Client != NULL );
-       assert( Hostname != NULL );
-       
-       strncpy( Client->host, Hostname, CLIENT_HOST_LEN - 1 );
-       Client->host[CLIENT_HOST_LEN - 1] = '\0';
+       assert(Client != NULL);
+       assert(Hostname != NULL);
+
+       if (strlen(Conf_CloakHost)) {
+               char cloak[GETID_LEN];
+
+               strlcpy(cloak, Hostname, GETID_LEN);
+               strlcat(cloak, Conf_CloakHostSalt, GETID_LEN);
+               snprintf(cloak, GETID_LEN, Conf_CloakHost, Hash(cloak));
+
+               LogDebug("Updating hostname of \"%s\": \"%s\" -> \"%s\"",
+                       Client_ID(Client), Client->host, cloak);
+               strlcpy(Client->host, cloak, sizeof(Client->host));
+       } else {
+               LogDebug("Updating hostname of \"%s\": \"%s\" -> \"%s\"",
+                        Client_ID(Client), Client->host, Hostname);
+               strlcpy(Client->host, Hostname, sizeof(Client->host));
+       }
 } /* Client_SetHostname */
 
 
-GLOBAL VOID
-Client_SetID( CLIENT *Client, CHAR *ID )
+GLOBAL void
+Client_SetID( CLIENT *Client, const char *ID )
 {
-       /* Hostname eines Clients setzen, Hash-Wert berechnen */
-
        assert( Client != NULL );
        assert( ID != NULL );
        
-       strncpy( Client->id, ID, CLIENT_ID_LEN - 1 );
-       Client->id[CLIENT_ID_LEN - 1] = '\0';
+       strlcpy( Client->id, ID, sizeof( Client->id ));
+
+       if (Conf_CloakUserToNick) {
+               strlcpy( Client->user, ID, sizeof( Client->user ));
+               strlcpy( Client->info, ID, sizeof( Client->info ));
+       }
 
        /* Hash */
        Client->hash = Hash( Client->id );
 } /* Client_SetID */
 
 
-GLOBAL VOID
-Client_SetUser( CLIENT *Client, CHAR *User, BOOLEAN Idented )
+GLOBAL void
+Client_SetUser( CLIENT *Client, const char *User, bool Idented )
 {
-       /* Username eines Clients setzen */
+       /* set clients username */
 
        assert( Client != NULL );
        assert( User != NULL );
-       
-       if( Idented ) strncpy( Client->user, User, CLIENT_USER_LEN - 1 );
-       else
-       {
+
+       if (Conf_CloakUserToNick) {
+               strlcpy(Client->user, Client->id, sizeof(Client->user));
+       } else if (Idented) {
+               strlcpy(Client->user, User, sizeof(Client->user));
+       } else {
                Client->user[0] = '~';
-               strncpy( Client->user + 1, User, CLIENT_USER_LEN - 2 );
+               strlcpy(Client->user + 1, User, sizeof(Client->user) - 1);
        }
-       Client->user[CLIENT_USER_LEN - 1] = '\0';
 } /* Client_SetUser */
 
 
-GLOBAL VOID
-Client_SetInfo( CLIENT *Client, CHAR *Info )
+/**
+ * Set "original" user name of a client.
+ * This function saves the "original" user name, the user name specified by
+ * the peer using the USER command, into the CLIENT structure. This user
+ * name may be used for authentication, for example.
+ * @param Client The client.
+ * @param User User name to set.
+ */
+GLOBAL void
+Client_SetOrigUser(CLIENT UNUSED *Client, const char UNUSED *User)
 {
-       /* Hostname eines Clients setzen */
+       assert(Client != NULL);
+       assert(User != NULL);
+
+#if defined(PAM) && defined(IDENTAUTH)
+       strlcpy(Client->orig_user, User, sizeof(Client->orig_user));
+#endif
+} /* Client_SetOrigUser */
+
+
+GLOBAL void
+Client_SetInfo( CLIENT *Client, const char *Info )
+{
+       /* set client hostname */
 
        assert( Client != NULL );
        assert( Info != NULL );
-       
-       strncpy( Client->info, Info, CLIENT_INFO_LEN - 1 );
-       Client->info[CLIENT_INFO_LEN - 1] = '\0';
+
+       if (Conf_CloakUserToNick)
+               strlcpy(Client->info, Client->id, sizeof(Client->info));
+       else
+               strlcpy(Client->info, Info, sizeof(Client->info));
 } /* Client_SetInfo */
 
 
-GLOBAL VOID
-Client_SetModes( CLIENT *Client, CHAR *Modes )
+GLOBAL void
+Client_SetModes( CLIENT *Client, const char *Modes )
 {
-       /* Hostname eines Clients setzen */
-
        assert( Client != NULL );
        assert( Modes != NULL );
 
-       strncpy( Client->modes, Modes, CLIENT_MODE_LEN - 1 );
-       Client->modes[CLIENT_MODE_LEN - 1] = '\0';
+       strlcpy(Client->modes, Modes, sizeof( Client->modes ));
 } /* Client_SetModes */
 
 
-GLOBAL VOID
-Client_SetPassword( CLIENT *Client, CHAR *Pwd )
+GLOBAL void
+Client_SetFlags( CLIENT *Client, const char *Flags )
 {
-       /* Von einem Client geliefertes Passwort */
-
        assert( Client != NULL );
-       assert( Pwd != NULL );
-       
-       strncpy( Client->pwd, Pwd, CLIENT_PASS_LEN - 1 );
-       Client->pwd[CLIENT_PASS_LEN - 1] = '\0';
-} /* Client_SetPassword */
+       assert( Flags != NULL );
 
+       strlcpy(Client->flags, Flags, sizeof(Client->flags));
+} /* Client_SetFlags */
 
-GLOBAL VOID
-Client_SetAway( CLIENT *Client, CHAR *Txt )
+
+GLOBAL void
+Client_SetAway( CLIENT *Client, const char *Txt )
 {
-       /* Von einem Client gelieferte AWAY-Nachricht */
+       /* Set AWAY reason of client */
 
        assert( Client != NULL );
+       assert( Txt != NULL );
 
-       if( Txt )
-       {
-               /* Client AWAY setzen */
-               strncpy( Client->away, Txt, CLIENT_AWAY_LEN - 1 );
-               Client->away[CLIENT_AWAY_LEN - 1] = '\0';
-               Client_ModeAdd( Client, 'a' );
-               Log( LOG_DEBUG, "User \"%s\" is away: %s", Client_Mask( Client ), Txt );
-       }
-       else
-       {
-               /* AWAY loeschen */
-               Client_ModeDel( Client, 'a' );
-               Log( LOG_DEBUG, "User \"%s\" is no longer away.", Client_Mask( Client ));
-       }
+       strlcpy( Client->away, Txt, sizeof( Client->away ));
+       LogDebug("%s \"%s\" is away: %s", Client_TypeText(Client),
+                Client_Mask(Client), Txt);
 } /* Client_SetAway */
 
 
-GLOBAL VOID
-Client_SetType( CLIENT *Client, INT Type )
+GLOBAL void
+Client_SetType( CLIENT *Client, int Type )
 {
        assert( Client != NULL );
        Client->type = Type;
        if( Type == CLIENT_SERVER ) Generate_MyToken( Client );
+       Adjust_Counters( Client );
 } /* Client_SetType */
 
 
-GLOBAL VOID
-Client_SetHops( CLIENT *Client, INT Hops )
+GLOBAL void
+Client_SetHops( CLIENT *Client, int Hops )
 {
        assert( Client != NULL );
        Client->hops = Hops;
 } /* Client_SetHops */
 
 
-GLOBAL VOID
-Client_SetToken( CLIENT *Client, INT Token )
+GLOBAL void
+Client_SetToken( CLIENT *Client, int Token )
 {
        assert( Client != NULL );
        Client->token = Token;
 } /* Client_SetToken */
 
 
-GLOBAL VOID
+GLOBAL void
 Client_SetIntroducer( CLIENT *Client, CLIENT *Introducer )
 {
        assert( Client != NULL );
@@ -433,139 +489,118 @@ Client_SetIntroducer( CLIENT *Client, CLIENT *Introducer )
 } /* Client_SetIntroducer */
 
 
-GLOBAL VOID
-Client_SetOperByMe( CLIENT *Client, BOOLEAN OperByMe )
+GLOBAL void
+Client_SetOperByMe( CLIENT *Client, bool OperByMe )
 {
        assert( Client != NULL );
        Client->oper_by_me = OperByMe;
 } /* Client_SetOperByMe */
 
 
-GLOBAL BOOLEAN
-Client_ModeAdd( CLIENT *Client, CHAR Mode )
+GLOBAL bool
+Client_ModeAdd( CLIENT *Client, char Mode )
 {
-       /* Mode soll gesetzt werden. TRUE wird geliefert, wenn der
-        * Mode neu gesetzt wurde, FALSE, wenn der Client den Mode
-        * bereits hatte. */
+       /* Set Mode.
+        * If Client already alread had Mode, return false.
+        * If the Mode was newly set, return true.
+        */
+
+       char x[2];
 
-       CHAR x[2];
-       
        assert( Client != NULL );
 
        x[0] = Mode; x[1] = '\0';
-       if( ! strchr( Client->modes, x[0] ))
-       {
-               /* Client hat den Mode noch nicht -> setzen */
-               strcat( Client->modes, x );
-               return TRUE;
+       if (!strchr( Client->modes, x[0])) {
+               strlcat( Client->modes, x, sizeof( Client->modes ));
+               return true;
        }
-       else return FALSE;
+       else return false;
 } /* Client_ModeAdd */
 
 
-GLOBAL BOOLEAN
-Client_ModeDel( CLIENT *Client, CHAR Mode )
+GLOBAL bool
+Client_ModeDel( CLIENT *Client, char Mode )
 {
-       /* Mode soll geloescht werden. TRUE wird geliefert, wenn der
-       * Mode entfernt wurde, FALSE, wenn der Client den Mode
-       * ueberhaupt nicht hatte. */
+       /* Delete Mode.
+        * If Mode was removed, return true.
+        * If Client did not have Mode, return false.
+        */
 
-       CHAR x[2], *p;
+       char x[2], *p;
 
        assert( Client != NULL );
 
        x[0] = Mode; x[1] = '\0';
 
        p = strchr( Client->modes, x[0] );
-       if( ! p ) return FALSE;
+       if( ! p ) return false;
 
-       /* Client hat den Mode -> loeschen */
+       /* Client has Mode -> delete */
        while( *p )
        {
                *p = *(p + 1);
                p++;
        }
-       return TRUE;
+       return true;
 } /* Client_ModeDel */
 
 
 GLOBAL CLIENT *
-Client_GetFromConn( CONN_ID Idx )
+Client_Search( const char *Nick )
 {
-       /* Client-Struktur, die zur lokalen Verbindung Idx gehoert,
-        * liefern. Wird keine gefunden, so wird NULL geliefert. */
-
-       CLIENT *c;
+       /* return Client-Structure that has the corresponding Nick.
+        * If none is found, return NULL.
+        */
 
-       assert( Idx >= 0 );
-       
-       c = My_Clients;
-       while( c )
-       {
-               if( c->conn_id == Idx ) return c;
-               c = (CLIENT *)c->next;
-       }
-       return NULL;
-} /* Client_GetFromConn */
-
-
-GLOBAL CLIENT *
-Client_Search( CHAR *Nick )
-{
-       /* Client-Struktur, die den entsprechenden Nick hat, liefern.
-        * Wird keine gefunden, so wird NULL geliefert. */
-
-       CHAR search_id[CLIENT_ID_LEN], *ptr;
+       char search_id[CLIENT_ID_LEN], *ptr;
        CLIENT *c = NULL;
        UINT32 search_hash;
 
        assert( Nick != NULL );
 
-       /* Nick kopieren und ggf. Host-Mask abschneiden */
-       strncpy( search_id, Nick, CLIENT_ID_LEN - 1 );
-       search_id[CLIENT_ID_LEN - 1] = '\0';
+       /* copy Nick and truncate hostmask if necessary */
+       strlcpy( search_id, Nick, sizeof( search_id ));
        ptr = strchr( search_id, '!' );
        if( ptr ) *ptr = '\0';
 
-       search_hash = Hash( search_id );
+       search_hash = Hash(search_id);
 
        c = My_Clients;
-       while( c )
-       {
-               if( c->hash == search_hash )
-               {
-                       /* lt. Hash-Wert: Treffer! */
-                       if( strcasecmp( c->id, search_id ) == 0 ) return c;
-               }
+       while (c) {
+               if (c->hash == search_hash && strcasecmp(c->id, search_id) == 0)
+                       return c;
                c = (CLIENT *)c->next;
        }
        return NULL;
 } /* Client_Search */
 
 
+/**
+ * Get client structure ("introducer") identfied by a server token.
+ * @return CLIENT structure or NULL if none could be found.
+ */
 GLOBAL CLIENT *
-Client_GetFromToken( CLIENT *Client, INT Token )
+Client_GetFromToken( CLIENT *Client, int Token )
 {
-       /* Client-Struktur, die den entsprechenden Introducer (=Client)
-        * und das gegebene Token hat, liefern. Wird keine gefunden,
-        * so wird NULL geliefert. */
-
        CLIENT *c;
 
        assert( Client != NULL );
-       assert( Token > 0 );
+
+       if (!Token)
+               return NULL;
 
        c = My_Clients;
-       while( c )
-       {
-               if(( c->type == CLIENT_SERVER ) && ( c->introducer == Client ) && ( c->token == Token )) return c;
+       while (c) {
+               if ((c->type == CLIENT_SERVER) && (c->introducer == Client) &&
+                       (c->token == Token))
+                               return c;
                c = (CLIENT *)c->next;
        }
        return NULL;
 } /* Client_GetFromToken */
 
 
-GLOBAL INT
+GLOBAL int
 Client_Type( CLIENT *Client )
 {
        assert( Client != NULL );
@@ -581,13 +616,14 @@ Client_Conn( CLIENT *Client )
 } /* Client_Conn */
 
 
-GLOBAL CHAR *
+GLOBAL char *
 Client_ID( CLIENT *Client )
 {
        assert( Client != NULL );
 
 #ifdef DEBUG
-       if( Client->type == CLIENT_USER ) assert( strlen( Client->id ) < CLIENT_NICK_LEN );
+       if(Client->type == CLIENT_USER)
+               assert(strlen(Client->id) < Conf_MaxNickLength);
 #endif
                                                   
        if( Client->id[0] ) return Client->id;
@@ -595,7 +631,7 @@ Client_ID( CLIENT *Client )
 } /* Client_ID */
 
 
-GLOBAL CHAR *
+GLOBAL char *
 Client_Info( CLIENT *Client )
 {
        assert( Client != NULL );
@@ -603,32 +639,87 @@ Client_Info( CLIENT *Client )
 } /* Client_Info */
 
 
-GLOBAL CHAR *
+GLOBAL char *
 Client_User( CLIENT *Client )
 {
        assert( Client != NULL );
-       if( Client->user[0] ) return Client->user;
-       else return "~";
+       return Client->user[0] ? Client->user : "~";
 } /* Client_User */
 
 
-GLOBAL CHAR *
-Client_Hostname( CLIENT *Client )
+#ifdef PAM
+
+/**
+ * Get the "original" user name as supplied by the USER command.
+ * The user name as given by the client is used for authentication instead
+ * of the one detected using IDENT requests.
+ * @param Client The client.
+ * @return Original user name.
+ */
+GLOBAL char *
+Client_OrigUser(CLIENT *Client) {
+#ifndef IDENTAUTH
+       char *user = Client->user;
+
+       if (user[0] == '~')
+               user++;
+       return user;
+#else
+       return Client->orig_user;
+#endif
+} /* Client_OrigUser */
+
+#endif
+
+
+/**
+ * Return the hostname of a client.
+ * @param Client Pointer to client structure
+ * @return Pointer to client hostname
+ */
+GLOBAL char *
+Client_Hostname(CLIENT *Client)
 {
-       assert( Client != NULL );
+       assert (Client != NULL);
        return Client->host;
 } /* Client_Hostname */
 
 
-GLOBAL CHAR *
-Client_Password( CLIENT *Client )
+/**
+ * Get potentially cloaked hostname of a client.
+ *
+ * If the client has not enabled cloaking, the real hostname is used.
+ * Please note that this function uses a global static buffer, so you can't
+ * nest invocations without overwriting earlier results!
+ *
+ * @param Client Pointer to client structure
+ * @return Pointer to client hostname
+ */
+GLOBAL char *
+Client_HostnameCloaked(CLIENT *Client)
 {
-       assert( Client != NULL );
-       return Client->pwd;
-} /* Client_Password */
+       static char Cloak_Buffer[CLIENT_HOST_LEN];
+
+       assert(Client != NULL);
+
+       if (!Client_HasMode(Client, 'x'))
+               return Client_Hostname(Client);
+
+       /* Do simple mapping to the server ID? */
+       if (!*Conf_CloakHostModeX)
+               return Client_ID(Client->introducer);
+
+       strlcpy(Cloak_Buffer, Client->host, CLIENT_HOST_LEN);
+       strlcat(Cloak_Buffer, Conf_CloakHostSalt, CLIENT_HOST_LEN);
 
+       snprintf(Cloak_Buffer, CLIENT_HOST_LEN, Conf_CloakHostModeX,
+                Hash(Cloak_Buffer));
 
-GLOBAL CHAR *
+       return Cloak_Buffer;
+} /* Client_HostnameCloaked */
+
+
+GLOBAL char *
 Client_Modes( CLIENT *Client )
 {
        assert( Client != NULL );
@@ -636,7 +727,15 @@ Client_Modes( CLIENT *Client )
 } /* Client_Modes */
 
 
-GLOBAL BOOLEAN
+GLOBAL char *
+Client_Flags( CLIENT *Client )
+{
+       assert( Client != NULL );
+       return Client->flags;
+} /* Client_Flags */
+
+
+GLOBAL bool
 Client_OperByMe( CLIENT *Client )
 {
        assert( Client != NULL );
@@ -644,7 +743,7 @@ Client_OperByMe( CLIENT *Client )
 } /* Client_OperByMe */
 
 
-GLOBAL INT
+GLOBAL int
 Client_Hops( CLIENT *Client )
 {
        assert( Client != NULL );
@@ -652,7 +751,7 @@ Client_Hops( CLIENT *Client )
 } /* Client_Hops */
 
 
-GLOBAL INT
+GLOBAL int
 Client_Token( CLIENT *Client )
 {
        assert( Client != NULL );
@@ -660,7 +759,7 @@ Client_Token( CLIENT *Client )
 } /* Client_Token */
 
 
-GLOBAL INT
+GLOBAL int
 Client_MyToken( CLIENT *Client )
 {
        assert( Client != NULL );
@@ -672,30 +771,71 @@ GLOBAL CLIENT *
 Client_NextHop( CLIENT *Client )
 {
        CLIENT *c;
-       
+
        assert( Client != NULL );
 
        c = Client;
-       while( c->introducer && ( c->introducer != c ) && ( c->introducer != This_Server )) c = c->introducer;
+       while( c->introducer && ( c->introducer != c ) && ( c->introducer != This_Server ))
+               c = c->introducer;
+
        return c;
 } /* Client_NextHop */
 
 
-GLOBAL CHAR *
+/**
+ * Return ID of a client: "client!user@host"
+ * This client ID is used for IRC prefixes, for example.
+ * Please note that this function uses a global static buffer, so you can't
+ * nest invocations without overwriting earlier results!
+ * @param Client Pointer to client structure
+ * @return Pointer to global buffer containing the client ID
+ */
+GLOBAL char *
 Client_Mask( CLIENT *Client )
 {
-       /* Client-"ID" liefern, wie sie z.B. fuer
-        * Prefixe benoetigt wird. */
+       static char Mask_Buffer[GETID_LEN];
 
-       assert( Client != NULL );
-       
-       if( Client->type == CLIENT_SERVER ) return Client->id;
+       assert (Client != NULL);
 
-       sprintf( GetID_Buffer, "%s!%s@%s", Client->id, Client->user, Client->host );
-       return GetID_Buffer;
+       /* Servers: return name only, there is no "mask" */
+       if (Client->type == CLIENT_SERVER)
+               return Client->id;
+
+       snprintf(Mask_Buffer, GETID_LEN, "%s!%s@%s",
+                Client->id, Client->user, Client->host);
+       return Mask_Buffer;
 } /* Client_Mask */
 
 
+/**
+ * Return ID of a client with cloaked hostname: "client!user@server-name"
+ *
+ * This client ID is used for IRC prefixes, for example.
+ * Please note that this function uses a global static buffer, so you can't
+ * nest invocations without overwriting earlier results!
+ * If the client has not enabled cloaking, the real hostname is used.
+ *
+ * @param Client Pointer to client structure
+ * @return Pointer to global buffer containing the client ID
+ */
+GLOBAL char *
+Client_MaskCloaked(CLIENT *Client)
+{
+       static char Mask_Buffer[GETID_LEN];
+
+       assert (Client != NULL);
+
+       /* Is the client using cloaking at all? */
+       if (!Client_HasMode(Client, 'x'))
+               return Client_Mask(Client);
+
+       snprintf(Mask_Buffer, GETID_LEN, "%s!%s@%s", Client->id, Client->user,
+                Client_HostnameCloaked(Client));
+
+       return Mask_Buffer;
+} /* Client_MaskCloaked */
+
+
 GLOBAL CLIENT *
 Client_Introducer( CLIENT *Client )
 {
@@ -712,94 +852,108 @@ Client_TopServer( CLIENT *Client )
 } /* Client_TopServer */
 
 
-GLOBAL BOOLEAN
-Client_HasMode( CLIENT *Client, CHAR Mode )
+GLOBAL bool
+Client_HasMode( CLIENT *Client, char Mode )
 {
        assert( Client != NULL );
        return strchr( Client->modes, Mode ) != NULL;
 } /* Client_HasMode */
 
 
-GLOBAL CHAR *
+GLOBAL char *
 Client_Away( CLIENT *Client )
 {
-       /* AWAY-Text liefern */
-
        assert( Client != NULL );
        return Client->away;
 } /* Client_Away */
 
 
-GLOBAL BOOLEAN
-Client_CheckNick( CLIENT *Client, CHAR *Nick )
+/**
+ * Make sure that a given nickname is valid.
+ *
+ * If the nickname is not valid for the given client, this function sends back
+ * the appropriate error messages.
+ *
+ * @param      Client Client that wants to change the nickname.
+ * @param      Nick New nick name.
+ * @returns    true if nickname is valid, false otherwise.
+ */
+GLOBAL bool
+Client_CheckNick(CLIENT *Client, char *Nick)
 {
-       /* Nick ueberpruefen */
+       assert(Client != NULL);
+       assert(Nick != NULL);
+
+       if (!Client_IsValidNick(Nick)) {
+               if (strlen(Nick ) >= Conf_MaxNickLength)
+                       IRC_WriteStrClient(Client, ERR_NICKNAMETOOLONG_MSG,
+                                          Client_ID(Client), Nick,
+                                          Conf_MaxNickLength - 1);
+               else
+                       IRC_WriteStrClient(Client, ERR_ERRONEUSNICKNAME_MSG,
+                                          Client_ID(Client), Nick);
+               return false;
+       }
 
-       assert( Client != NULL );
-       assert( Nick != NULL );
-       
-       /* Nick ungueltig? */
-       if( ! Client_IsValidNick( Nick ))
-       {
-               IRC_WriteStrClient( Client, ERR_ERRONEUSNICKNAME_MSG, Client_ID( Client ), Nick );
-               return FALSE;
+       if (Client_Type(Client) != CLIENT_SERVER
+           && Client_Type(Client) != CLIENT_SERVICE) {
+               /* Make sure that this isn't a restricted/forbidden nick name */
+               if (Conf_NickIsBlocked(Nick)) {
+                       IRC_WriteStrClient(Client, ERR_FORBIDDENNICKNAME_MSG,
+                                          Client_ID(Client), Nick);
+                       return false;
+               }
        }
 
-       /* Nick bereits vergeben? */
-       if( Client_Search( Nick ))
-       {
-               /* den Nick gibt es bereits */
-               IRC_WriteStrClient( Client, ERR_NICKNAMEINUSE_MSG, Client_ID( Client ), Nick );
-               return FALSE;
+       /* Nickname already registered? */
+       if (Client_Search(Nick)) {
+               IRC_WriteStrClient(Client, ERR_NICKNAMEINUSE_MSG,
+                       Client_ID(Client), Nick);
+               return false;
        }
 
-       return TRUE;
+       return true;
 } /* Client_CheckNick */
 
 
-GLOBAL BOOLEAN
-Client_CheckID( CLIENT *Client, CHAR *ID )
+GLOBAL bool
+Client_CheckID( CLIENT *Client, char *ID )
 {
-       /* Nick ueberpruefen */
-
-       CHAR str[COMMAND_LEN];
+       char str[COMMAND_LEN];
        CLIENT *c;
 
        assert( Client != NULL );
        assert( Client->conn_id > NONE );
        assert( ID != NULL );
 
-       /* Nick zu lang? */
-       if( strlen( ID ) > CLIENT_ID_LEN )
-       {
-               IRC_WriteStrClient( Client, ERR_ERRONEUSNICKNAME_MSG, Client_ID( Client ), ID );
-               return FALSE;
+       /* ID too long? */
+       if (strlen(ID) > CLIENT_ID_LEN) {
+               IRC_WriteStrClient(Client, ERR_ERRONEUSNICKNAME_MSG, Client_ID(Client), ID);
+               return false;
        }
 
-       /* ID bereits vergeben? */
+       /* ID already in use? */
        c = My_Clients;
-       while( c )
-       {
-               if( strcasecmp( c->id, ID ) == 0 )
-               {
-                       /* die Server-ID gibt es bereits */
-                       sprintf( str, "ID \"%s\" already registered!", ID );
-                       Log( LOG_ERR, "%s (on connection %d)", str, Client->conn_id );
-                       Conn_Close( Client->conn_id, str, str, TRUE );
-                       return FALSE;
+       while (c) {
+               if (strcasecmp(c->id, ID) == 0) {
+                       snprintf(str, sizeof(str), "ID \"%s\" already registered", ID);
+                       if (c->conn_id != NONE)
+                               Log(LOG_ERR, "%s (on connection %d)!", str, c->conn_id);
+                       else
+                               Log(LOG_ERR, "%s (via network)!", str);
+                       Conn_Close(Client->conn_id, str, str, true);
+                       return false;
                }
                c = (CLIENT *)c->next;
        }
 
-       return TRUE;
+       return true;
 } /* Client_CheckID */
 
 
 GLOBAL CLIENT *
-Client_First( VOID )
+Client_First( void )
 {
-       /* Ersten Client liefern. */
-
        return My_Clients;
 } /* Client_First */
 
@@ -807,56 +961,52 @@ Client_First( VOID )
 GLOBAL CLIENT *
 Client_Next( CLIENT *c )
 {
-       /* Naechsten Client liefern. Existiert keiner,
-        * so wird NULL geliefert. */
-
        assert( c != NULL );
        return (CLIENT *)c->next;
 } /* Client_Next */
 
 
-GLOBAL INT
-Client_UserCount( VOID )
+GLOBAL long
+Client_UserCount( void )
 {
        return Count( CLIENT_USER );
 } /* Client_UserCount */
 
 
-GLOBAL INT
-Client_ServiceCount( VOID )
+GLOBAL long
+Client_ServiceCount( void )
 {
        return Count( CLIENT_SERVICE );;
 } /* Client_ServiceCount */
 
 
-GLOBAL INT
-Client_ServerCount( VOID )
+GLOBAL long
+Client_ServerCount( void )
 {
        return Count( CLIENT_SERVER );
 } /* Client_ServerCount */
 
 
-GLOBAL INT
-Client_MyUserCount( VOID )
+GLOBAL long
+Client_MyUserCount( void )
 {
        return MyCount( CLIENT_USER );
 } /* Client_MyUserCount */
 
 
-GLOBAL INT
-Client_MyServiceCount( VOID )
+GLOBAL long
+Client_MyServiceCount( void )
 {
        return MyCount( CLIENT_SERVICE );
 } /* Client_MyServiceCount */
 
 
-GLOBAL INT
-Client_MyServerCount( VOID )
+GLOBAL unsigned long
+Client_MyServerCount( void )
 {
        CLIENT *c;
-       INT cnt;
+       unsigned long cnt = 0;
 
-       cnt = 0;
        c = My_Clients;
        while( c )
        {
@@ -867,13 +1017,12 @@ Client_MyServerCount( VOID )
 } /* Client_MyServerCount */
 
 
-GLOBAL INT
-Client_OperCount( VOID )
+GLOBAL unsigned long
+Client_OperCount( void )
 {
        CLIENT *c;
-       INT cnt;
+       unsigned long cnt = 0;
 
-       cnt = 0;
        c = My_Clients;
        while( c )
        {
@@ -884,55 +1033,180 @@ Client_OperCount( VOID )
 } /* Client_OperCount */
 
 
-GLOBAL INT
-Client_UnknownCount( VOID )
+GLOBAL unsigned long
+Client_UnknownCount( void )
 {
        CLIENT *c;
-       INT cnt;
+       unsigned long cnt = 0;
 
-       cnt = 0;
        c = My_Clients;
        while( c )
        {
                if( c && ( c->type != CLIENT_USER ) && ( c->type != CLIENT_SERVICE ) && ( c->type != CLIENT_SERVER )) cnt++;
                c = (CLIENT *)c->next;
        }
+
        return cnt;
 } /* Client_UnknownCount */
 
 
-GLOBAL BOOLEAN
-Client_IsValidNick( CHAR *Nick )
+GLOBAL long
+Client_MaxUserCount( void )
 {
-       /* Ist der Nick gueltig? */
+       return Max_Users;
+} /* Client_MaxUserCount */
 
-       CHAR *ptr, goodchars[] = ";0123456789-";
-       
-       assert( Nick != NULL );
 
-       if( Nick[0] == '#' ) return FALSE;
-       if( strchr( goodchars, Nick[0] )) return FALSE;
-       if( strlen( Nick ) >= CLIENT_NICK_LEN ) return FALSE;
+GLOBAL long
+Client_MyMaxUserCount( void )
+{
+       return My_Max_Users;
+} /* Client_MyMaxUserCount */
+
+
+/**
+ * Check that a given nickname is valid.
+ *
+ * @param      Nick the nickname to check.
+ * @returns    true if nickname is valid, false otherwise.
+ */
+GLOBAL bool
+Client_IsValidNick(const char *Nick)
+{
+       const char *ptr;
+       static const char goodchars[] = ";0123456789-";
+
+       assert (Nick != NULL);
+
+       if (strchr(goodchars, Nick[0]))
+               return false;
+       if (strlen(Nick ) >= Conf_MaxNickLength)
+               return false;
 
        ptr = Nick;
-       while( *ptr )
-       {
-               if(( *ptr < 'A' ) && ( ! strchr( goodchars, *ptr ))) return FALSE;
-               if(( *ptr > '}' ) && ( ! strchr( goodchars, *ptr ))) return FALSE;
+       while (*ptr) {
+               if (*ptr < 'A' && !strchr(goodchars, *ptr ))
+                       return false;
+               if (*ptr > '}')
+                       return false;
                ptr++;
        }
-       
-       return TRUE;
+
+       return true;
 } /* Client_IsValidNick */
 
 
-LOCAL INT
+/**
+ * Return pointer to "My_Whowas" structure.
+ */
+GLOBAL WHOWAS *
+Client_GetWhowas( void )
+{
+       return My_Whowas;
+} /* Client_GetWhowas */
+
+/**
+ * Return the index of the last used WHOWAS entry.
+ */
+GLOBAL int
+Client_GetLastWhowasIndex( void )
+{
+       return Last_Whowas;
+} /* Client_GetLastWhowasIndex */
+
+
+/**
+ * Get the start time of this client.
+ * The result is the start time in seconds since 1970-01-01, as reported
+ * by the C function time(NULL).
+ */
+GLOBAL time_t
+Client_StartTime(CLIENT *Client)
+{
+       assert( Client != NULL );
+       return Client->starttime;
+} /* Client_Uptime */
+
+
+/**
+ * Reject a client when logging in.
+ *
+ * This function is called when a client isn't allowed to connect to this
+ * server. Possible reasons are bad server password, bad PAM password,
+ * or that the client is G/K-Line'd.
+ *
+ * After calling this function, the client isn't connected any more.
+ *
+ * @param Client The client to reject.
+ * @param Reason The reason why the client has been rejected.
+ * @param InformClient If true, send the exact reason to the client.
+ */
+GLOBAL void
+Client_Reject(CLIENT *Client, const char *Reason, bool InformClient)
+{
+       char info[COMMAND_LEN];
+
+       assert(Client != NULL);
+       assert(Reason != NULL);
+
+       if (InformClient)
+               snprintf(info, sizeof(info), "Access denied: %s", Reason);
+       else
+               strcpy(info, "Access denied: Bad password?");
+
+       Log(LOG_ERR,
+           "User \"%s\" rejected (connection %d): %s!",
+           Client_Mask(Client), Client_Conn(Client), Reason);
+       Conn_Close(Client_Conn(Client), Reason, info, true);
+}
+
+
+/**
+ * Introduce a new user or service client in the network.
+ *
+ * @param From Remote server introducing the client or NULL (local).
+ * @param Client New client.
+ * @param Type Type of the client (CLIENT_USER or CLIENT_SERVICE).
+ */
+GLOBAL void
+Client_Introduce(CLIENT *From, CLIENT *Client, int Type)
+{
+       /* Set client type (user or service) */
+       Client_SetType(Client, Type);
+
+       if (From) {
+               if (Conf_NickIsService(Conf_GetServer(Client_Conn(From)),
+                                  Client_ID(Client)))
+                       Client_SetType(Client, CLIENT_SERVICE);
+               LogDebug("%s \"%s\" (+%s) registered (via %s, on %s, %d hop%s).",
+                        Client_TypeText(Client), Client_Mask(Client),
+                        Client_Modes(Client), Client_ID(From),
+                        Client_ID(Client_Introducer(Client)),
+                        Client_Hops(Client), Client_Hops(Client) > 1 ? "s": "");
+       } else {
+               Log(LOG_NOTICE, "%s \"%s\" registered (connection %d).",
+                   Client_TypeText(Client), Client_Mask(Client),
+                   Client_Conn(Client));
+               Log_ServerNotice('c', "Client connecting: %s (%s@%s) [%s] - %s",
+                                Client_ID(Client), Client_User(Client),
+                                Client_Hostname(Client),
+                                Conn_IPA(Client_Conn(Client)),
+                                Client_TypeText(Client));
+       }
+
+       /* Inform other servers */
+       IRC_WriteStrServersPrefixFlag_CB(From,
+                               From != NULL ? From : Client_ThisServer(),
+                               '\0', cb_introduceClient, (void *)Client);
+} /* Client_Introduce */
+
+
+static unsigned long
 Count( CLIENT_TYPE Type )
 {
        CLIENT *c;
-       INT cnt;
+       unsigned long cnt = 0;
 
-       cnt = 0;
        c = My_Clients;
        while( c )
        {
@@ -943,13 +1217,12 @@ Count( CLIENT_TYPE Type )
 } /* Count */
 
 
-LOCAL INT
+static unsigned long
 MyCount( CLIENT_TYPE Type )
 {
        CLIENT *c;
-       INT cnt;
+       unsigned long cnt = 0;
 
-       cnt = 0;
        c = My_Clients;
        while( c )
        {
@@ -960,47 +1233,38 @@ MyCount( CLIENT_TYPE Type )
 } /* MyCount */
 
 
-LOCAL CLIENT *
-New_Client_Struct( VOID )
+static CLIENT *
+New_Client_Struct( void )
 {
        /* Neue CLIENT-Struktur pre-initialisieren */
-       
+
        CLIENT *c;
-       
-       c = malloc( sizeof( CLIENT ));
+
+       c = (CLIENT *)malloc( sizeof( CLIENT ));
        if( ! c )
        {
-               Log( LOG_EMERG, "Can't allocate memory!" );
+               Log( LOG_EMERG, "Can't allocate memory! [New_Client_Struct]" );
                return NULL;
        }
 
-       c->next = NULL;
-       c->hash = 0;
+       memset( c, 0, sizeof ( CLIENT ));
+
        c->type = CLIENT_UNKNOWN;
        c->conn_id = NONE;
-       c->introducer = NULL;
-       c->topserver = NULL;
-       strcpy( c->id, "" );
-       strcpy( c->pwd, "" );
-       strcpy( c->host, "" );
-       strcpy( c->user, "" );
-       strcpy( c->info, "" );
-       strcpy( c->modes, "" );
-       c->oper_by_me = FALSE;
+       c->oper_by_me = false;
        c->hops = -1;
        c->token = -1;
        c->mytoken = -1;
-       strcpy( c->away, "" );
 
        return c;
 } /* New_Client */
 
 
-LOCAL VOID
+static void
 Generate_MyToken( CLIENT *Client )
 {
        CLIENT *c;
-       INT token;
+       int token;
 
        c = My_Clients;
        token = 2;
@@ -1016,8 +1280,219 @@ Generate_MyToken( CLIENT *Client )
                else c = (CLIENT *)c->next;
        }
        Client->mytoken = token;
-       Log( LOG_DEBUG, "Assigned token %d to server \"%s\".", token, Client->id );
+       LogDebug("Assigned token %d to server \"%s\".", token, Client->id);
 } /* Generate_MyToken */
 
 
+static void
+Adjust_Counters( CLIENT *Client )
+{
+       long count;
+
+       assert( Client != NULL );
+
+       if( Client->type != CLIENT_USER ) return;
+
+       if( Client->conn_id != NONE )
+       {
+               /* Local connection */
+               count = Client_MyUserCount( );
+               if( count > My_Max_Users ) My_Max_Users = count;
+       }
+       count = Client_UserCount( );
+       if( count > Max_Users ) Max_Users = count;
+} /* Adjust_Counters */
+
+
+/**
+ * Register client in My_Whowas structure for further recall by WHOWAS.
+ * Note: Only clients that have been connected at least 30 seconds will be
+ * registered to prevent automated IRC bots to "destroy" a nice server
+ * history database.
+ */
+GLOBAL void
+Client_RegisterWhowas( CLIENT *Client )
+{
+       int slot;
+       time_t now;
+
+       assert( Client != NULL );
+
+       /* Don't register WHOWAS information when "MorePrivacy" is enabled. */
+       if (Conf_MorePrivacy)
+               return;
+
+       now = time(NULL);
+       /* Don't register clients that were connected less than 30 seconds. */
+       if( now - Client->starttime < 30 )
+               return;
+
+       slot = Last_Whowas + 1;
+       if( slot >= MAX_WHOWAS || slot < 0 ) slot = 0;
+
+#ifdef DEBUG
+       Log( LOG_DEBUG, "Saving WHOWAS information to slot %d ...", slot );
+#endif
+
+       My_Whowas[slot].time = now;
+       strlcpy( My_Whowas[slot].id, Client_ID( Client ),
+                sizeof( My_Whowas[slot].id ));
+       strlcpy( My_Whowas[slot].user, Client_User( Client ),
+                sizeof( My_Whowas[slot].user ));
+       strlcpy( My_Whowas[slot].host, Client_HostnameCloaked( Client ),
+                sizeof( My_Whowas[slot].host ));
+       strlcpy( My_Whowas[slot].info, Client_Info( Client ),
+                sizeof( My_Whowas[slot].info ));
+       strlcpy( My_Whowas[slot].server, Client_ID( Client_Introducer( Client )),
+                sizeof( My_Whowas[slot].server ));
+
+       Last_Whowas = slot;
+} /* Client_RegisterWhowas */
+
+
+GLOBAL const char *
+Client_TypeText(CLIENT *Client)
+{
+       assert(Client != NULL);
+       switch (Client_Type(Client)) {
+               case CLIENT_USER:
+                       return "User";
+                       break;
+               case CLIENT_SERVICE:
+                       return "Service";
+                       break;
+               case CLIENT_SERVER:
+                       return "Server";
+                       break;
+               default:
+                       return "Client";
+       }
+} /* Client_TypeText */
+
+
+/**
+ * Destroy user or service client.
+ */
+static void
+Destroy_UserOrService(CLIENT *Client, const char *Txt, const char *FwdMsg, bool SendQuit)
+{
+       if(Client->conn_id != NONE) {
+               /* Local (directly connected) client */
+               Log(LOG_NOTICE,
+                   "%s \"%s\" unregistered (connection %d): %s",
+                   Client_TypeText(Client), Client_Mask(Client),
+                   Client->conn_id, Txt);
+               Log_ServerNotice('c', "Client exiting: %s (%s@%s) [%s]",
+                                Client_ID(Client), Client_User(Client),
+                                Client_Hostname(Client), Txt);
+
+               if (SendQuit) {
+                       /* Inforam all the other servers */
+                       if (FwdMsg)
+                               IRC_WriteStrServersPrefix(NULL,
+                                               Client, "QUIT :%s", FwdMsg );
+                       else
+                               IRC_WriteStrServersPrefix(NULL,
+                                               Client, "QUIT :");
+               }
+       } else {
+               /* Remote client */
+               LogDebug("%s \"%s\" unregistered: %s",
+                        Client_TypeText(Client), Client_Mask(Client), Txt);
+
+               if(SendQuit) {
+                       /* Inform all the other servers, but the ones in the
+                        * direction we got the QUIT from */
+                       if(FwdMsg)
+                               IRC_WriteStrServersPrefix(Client_NextHop(Client),
+                                               Client, "QUIT :%s", FwdMsg );
+                       else
+                               IRC_WriteStrServersPrefix(Client_NextHop(Client),
+                                               Client, "QUIT :" );
+               }
+       }
+
+       /* Unregister client from channels */
+       Channel_Quit(Client, FwdMsg ? FwdMsg : Client->id);
+
+       /* Register client in My_Whowas structure */
+       Client_RegisterWhowas(Client);
+} /* Destroy_UserOrService */
+
+
+/**
+ * Introduce a new user or service client to a remote server.
+ *
+ * This function differentiates between RFC1459 and RFC2813 server links and
+ * generates the appropriate commands to register the new user or service.
+ *
+ * @param To           The remote server to inform.
+ * @param Prefix       Prefix for the generated commands.
+ * @param data         CLIENT structure of the new client.
+ */
+static void
+cb_introduceClient(CLIENT *To, CLIENT *Prefix, void *data)
+{
+       CLIENT *c = (CLIENT *)data;
+       CONN_ID conn;
+       char *modes, *user, *host;
+
+       modes = Client_Modes(c);
+       user = Client_User(c) ? Client_User(c) : "-";
+       host = Client_Hostname(c) ? Client_Hostname(c) : "-";
+
+       conn = Client_Conn(To);
+       if (Conn_Options(conn) & CONN_RFC1459) {
+               /* RFC 1459 mode: separate NICK and USER commands */
+               Conn_WriteStr(conn, "NICK %s :%d", Client_ID(c),
+                             Client_Hops(c) + 1);
+               Conn_WriteStr(conn, ":%s USER %s %s %s :%s",
+                             Client_ID(c), user, host,
+                             Client_ID(Client_Introducer(c)), Client_Info(c));
+               if (modes[0])
+                       Conn_WriteStr(conn, ":%s MODE %s +%s",
+                                     Client_ID(c), Client_ID(c), modes);
+       } else {
+               /* RFC 2813 mode: one combined NICK or SERVICE command */
+               if (Client_Type(c) == CLIENT_SERVICE
+                   && strchr(Client_Flags(To), 'S'))
+                       IRC_WriteStrClientPrefix(To, Prefix,
+                                                "SERVICE %s %d * +%s %d :%s",
+                                                Client_Mask(c),
+                                                Client_MyToken(Client_Introducer(c)),
+                                                Client_Modes(c), Client_Hops(c) + 1,
+                                                Client_Info(c));
+               else
+                       IRC_WriteStrClientPrefix(To, Prefix,
+                                                "NICK %s %d %s %s %d +%s :%s",
+                                                Client_ID(c), Client_Hops(c) + 1,
+                                                user, host,
+                                                Client_MyToken(Client_Introducer(c)),
+                                                modes, Client_Info(c));
+       }
+} /* cb_introduceClient */
+
+
+#ifdef DEBUG
+
+GLOBAL void
+Client_DebugDump(void)
+{
+       CLIENT *c;
+
+       Log(LOG_DEBUG, "Client status:");
+       c = My_Clients;
+       while (c) {
+               Log(LOG_DEBUG,
+                   " - %s: type=%d, host=%s, user=%s, conn=%d, start=%ld, flags=%s",
+                   Client_ID(c), Client_Type(c), Client_Hostname(c),
+                   Client_User(c), Client_Conn(c), Client_StartTime(c),
+                   Client_Flags(c));
+               c = (CLIENT *)c->next;
+       }
+} /* Client_DumpClients */
+
+#endif
+
+
 /* -eof- */