+/**
+ * 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 )
+{
+ 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, const char *ID )
+{
+ assert( Client != NULL );
+ assert( ID != NULL );
+
+ 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, const char *User, bool Idented )
+{
+ /* set clients username */
+
+ assert( Client != NULL );
+ assert( User != NULL );
+
+ 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] = '~';
+ strlcpy(Client->user + 1, User, sizeof(Client->user) - 1);
+ }
+} /* Client_SetUser */
+
+
+/**
+ * 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)
+{
+ 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 );
+
+ 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, const char *Modes )
+{
+ assert( Client != NULL );
+ assert( Modes != NULL );
+
+ strlcpy(Client->modes, Modes, sizeof( Client->modes ));
+} /* Client_SetModes */
+
+
+GLOBAL void
+Client_SetFlags( CLIENT *Client, const char *Flags )
+{
+ assert( Client != NULL );
+ assert( Flags != NULL );
+
+ strlcpy(Client->flags, Flags, sizeof(Client->flags));
+} /* Client_SetFlags */
+
+
+GLOBAL void
+Client_SetAway( CLIENT *Client, const char *Txt )
+{
+ /* Set AWAY reason of client */
+
+ assert( Client != NULL );
+ assert( Txt != NULL );
+
+ 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 )
+{
+ 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 )
+{
+ assert( Client != NULL );
+ Client->hops = Hops;
+} /* Client_SetHops */
+
+
+GLOBAL void
+Client_SetToken( CLIENT *Client, int Token )
+{
+ assert( Client != NULL );
+ Client->token = Token;
+} /* Client_SetToken */
+
+
+GLOBAL void
+Client_SetIntroducer( CLIENT *Client, CLIENT *Introducer )
+{
+ assert( Client != NULL );
+ assert( Introducer != NULL );
+ Client->introducer = Introducer;
+} /* Client_SetIntroducer */
+
+
+GLOBAL void
+Client_SetOperByMe( CLIENT *Client, bool OperByMe )
+{
+ assert( Client != NULL );
+ Client->oper_by_me = OperByMe;
+} /* Client_SetOperByMe */
+
+
+GLOBAL bool
+Client_ModeAdd( CLIENT *Client, char Mode )
+{
+ /* Set Mode.
+ * If Client already had Mode, return false.
+ * If the Mode was newly set, return true.
+ */
+
+ char x[2];
+
+ assert( Client != NULL );
+
+ x[0] = Mode; x[1] = '\0';
+ if (!Client_HasMode(Client, x[0])) {
+ strlcat( Client->modes, x, sizeof( Client->modes ));
+ return true;
+ }
+ else return false;
+} /* Client_ModeAdd */
+
+
+GLOBAL bool
+Client_ModeDel( CLIENT *Client, char Mode )
+{
+ /* Delete Mode.
+ * If Mode was removed, return true.
+ * If Client did not have Mode, return false.
+ */
+
+ char x[2], *p;
+
+ assert( Client != NULL );
+
+ x[0] = Mode; x[1] = '\0';
+
+ p = strchr( Client->modes, x[0] );
+ if( ! p ) return false;
+
+ /* Client has Mode -> delete */
+ while( *p )
+ {
+ *p = *(p + 1);
+ p++;
+ }
+ return true;
+} /* Client_ModeDel */
+
+
+/**
+ * Search CLIENT structure of a given nick name.
+ *
+ * @return Pointer to CLIENT structure or NULL if not found.
+ */
+GLOBAL CLIENT *
+Client_Search( const char *Nick )
+{
+ char search_id[CLIENT_ID_LEN], *ptr;
+ CLIENT *c = NULL;
+ UINT32 search_hash;
+
+ assert( Nick != NULL );
+
+ /* 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);
+
+ c = My_Clients;
+ while (c) {
+ if (c->hash == search_hash && strcasecmp(c->id, search_id) == 0)
+ return c;
+ c = (CLIENT *)c->next;
+ }
+ return NULL;
+}
+
+
+/**
+ * Search first CLIENT structure matching a given mask of a server.
+ *
+ * The order of servers is arbitrary, but this function makes sure that the
+ * local server is always returned if the mask matches it.
+ *
+ * @return Pointer to CLIENT structure or NULL if no server could be found.
+ */
+GLOBAL CLIENT *
+Client_SearchServer(const char *Mask)
+{
+ CLIENT *c;
+
+ assert(Mask != NULL);
+
+ /* First check if mask matches the local server */
+ if (MatchCaseInsensitive(Mask, Client_ID(Client_ThisServer())))
+ return Client_ThisServer();
+
+ c = My_Clients;
+ while (c) {
+ if (Client_Type(c) == CLIENT_SERVER) {
+ /* This is a server: check if Mask matches */
+ if (MatchCaseInsensitive(Mask, c->id))
+ return c;
+ }
+ c = (CLIENT *)c->next;
+ }
+ return NULL;
+}
+
+
+/**
+ * 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 *c;
+
+ assert( Client != NULL );
+
+ if (!Token)
+ return NULL;
+
+ c = My_Clients;
+ 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
+Client_Type( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->type;
+} /* Client_Type */
+
+
+GLOBAL CONN_ID
+Client_Conn( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->conn_id;
+} /* Client_Conn */
+
+
+GLOBAL char *
+Client_ID( CLIENT *Client )
+{
+ assert( Client != NULL );
+
+#ifdef DEBUG
+ if(Client->type == CLIENT_USER)
+ assert(strlen(Client->id) < Conf_MaxNickLength);
+#endif
+
+ if( Client->id[0] ) return Client->id;
+ else return "*";
+} /* Client_ID */
+
+
+GLOBAL char *
+Client_Info( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->info;
+} /* Client_Info */
+
+
+GLOBAL char *
+Client_User( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->user[0] ? Client->user : "~";
+} /* Client_User */
+
+
+#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);
+ return Client->host;
+}
+
+/**
+ * Return the cloaked hostname of a client, if set.
+ * @param Client Pointer to the client structure.
+ * @return Pointer to the cloaked hostname or NULL if not set.
+ */
+GLOBAL char *
+Client_HostnameCloaked(CLIENT *Client)
+{
+ assert(Client != NULL);
+ return Client->cloaked;
+}
+
+/**
+ * Get (potentially cloaked) hostname of a client to display it to other users.
+ *
+ * If the client has not enabled cloaking, the real hostname is used.
+ *
+ * @param Client Pointer to client structure
+ * @return Pointer to client hostname
+ */
+GLOBAL char *
+Client_HostnameDisplayed(CLIENT *Client)
+{
+ assert(Client != NULL);
+
+ /* Client isn't cloaked at all, return real hostname: */
+ if (!Client_HasMode(Client, 'x'))
+ return Client_Hostname(Client);
+
+ /* Use an already saved cloaked hostname, if there is one */
+ if (Client->cloaked)
+ return Client->cloaked;
+
+ Client_UpdateCloakedHostname(Client, NULL, NULL);
+ return Client->cloaked;
+}
+
+/**
+ * Update (and generate, if necessary) the cloaked hostname of a client.
+ *
+ * The newly set cloaked hostname is announced in the network using METADATA
+ * commands to peers that support this feature.
+ *
+ * @param Client The client of which the cloaked hostname should be updated.
+ * @param Origin The originator of the hostname change, or NULL if this server.
+ * @param Hostname The new cloaked hostname, or NULL if it should be generated.
+ */
+GLOBAL void
+Client_UpdateCloakedHostname(CLIENT *Client, CLIENT *Origin,
+ const char *Hostname)
+{
+ char Cloak_Buffer[CLIENT_HOST_LEN];
+
+ assert(Client != NULL);
+ if (!Origin)
+ Origin = Client_ThisServer();
+
+ if (!Client->cloaked) {
+ Client->cloaked = malloc(CLIENT_HOST_LEN);
+ if (!Client->cloaked)
+ return;
+ }
+
+ if (!Hostname) {
+ /* Generate new cloaked hostname */
+ if (*Conf_CloakHostModeX) {
+ strlcpy(Cloak_Buffer, Client->host,
+ sizeof(Cloak_Buffer));
+ strlcat(Cloak_Buffer, Conf_CloakHostSalt,
+ sizeof(Cloak_Buffer));
+ snprintf(Client->cloaked, CLIENT_HOST_LEN,
+ Conf_CloakHostModeX, Hash(Cloak_Buffer));
+ } else
+ strlcpy(Client->cloaked, Client_ID(Client->introducer),
+ CLIENT_HOST_LEN);
+ } else
+ strlcpy(Client->cloaked, Hostname, CLIENT_HOST_LEN);
+ LogDebug("Cloaked hostname of \"%s\" updated to \"%s\"",
+ Client_ID(Client), Client->cloaked);
+
+ /* Inform other servers in the network */
+ IRC_WriteStrServersPrefixFlag(Client_NextHop(Origin), Origin, 'M',
+ "METADATA %s cloakhost :%s",
+ Client_ID(Client), Client->cloaked);
+}
+
+GLOBAL char *
+Client_Modes( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->modes;
+} /* Client_Modes */
+
+
+GLOBAL char *
+Client_Flags( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->flags;
+} /* Client_Flags */
+
+
+GLOBAL bool
+Client_OperByMe( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->oper_by_me;
+} /* Client_OperByMe */
+
+
+GLOBAL int
+Client_Hops( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->hops;
+} /* Client_Hops */
+
+
+GLOBAL int
+Client_Token( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->token;
+} /* Client_Token */
+
+
+GLOBAL int
+Client_MyToken( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->mytoken;
+} /* Client_MyToken */
+
+
+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;
+
+ return c;
+} /* Client_NextHop */
+
+
+/**
+ * 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 )
+{
+ static char Mask_Buffer[GETID_LEN];
+
+ assert (Client != NULL);
+
+ /* 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_HostnameDisplayed(Client));
+
+ return Mask_Buffer;
+} /* Client_MaskCloaked */
+
+
+GLOBAL CLIENT *
+Client_Introducer( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->introducer;
+} /* Client_Introducer */
+
+
+GLOBAL CLIENT *
+Client_TopServer( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->topserver;
+} /* Client_TopServer */
+
+
+GLOBAL bool
+Client_HasMode( CLIENT *Client, char Mode )
+{
+ assert( Client != NULL );
+ return strchr( Client->modes, Mode ) != NULL;
+} /* Client_HasMode */
+
+
+GLOBAL bool
+Client_HasFlag( CLIENT *Client, char Flag )
+{
+ assert( Client != NULL );
+ return strchr( Client->flags, Flag ) != NULL;
+} /* Client_HasFlag */
+
+
+GLOBAL char *
+Client_Away( CLIENT *Client )
+{
+ assert( Client != NULL );
+ return Client->away;
+} /* Client_Away */
+
+
+/**
+ * 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 nickname.
+ * @returns true if nickname is valid, false otherwise.
+ */
+GLOBAL bool
+Client_CheckNick(CLIENT *Client, char *Nick)