trunk/src/whowas.c

/*
 *  ircd-hybrid: an advanced, lightweight Internet Relay Chat Daemon (ircd)
 *
 *  Copyright (c) 1997-2016 ircd-hybrid development team
 *
 *  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.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
 *  USA
 */

/*! \file whowas.c
 * \brief WHOWAS user cache.
 * \version $Id$
 */

#include "stdinc.h"
#include "list.h"
#include "mempool.h"
#include "whowas.h"
#include "client.h"
#include "hash.h"
#include "irc_string.h"
#include "ircd.h"
#include "conf.h"


static mp_pool_t *whowas_pool;

static dlink_list whowas_list;  /*! Chain of struct Whowas pointers */
static dlink_list whowas_hash[HASHSIZE];


/*! \brief Initializes the whowas memory pool.
 */
void
whowas_init(void)
{
  whowas_pool = mp_pool_new(sizeof(struct Whowas), MP_CHUNK_SIZE_WHOWAS);
}

/*! \brief Returns a slot of the whowas_hash by the hash value associated with it.
 * \param hashv Hash value.
 */
const dlink_list *
whowas_get_hash(unsigned int hashv)
{
  if (hashv >= HASHSIZE)
    return NULL;

  return &whowas_hash[hashv];
}

/*! \brief Unlinks a Whowas struct from its associated lists.
 * \param whowas Pointer to Whowas struct to be unlinked.
 */
static struct Whowas *
whowas_unlink(struct Whowas *whowas)
{
  if (!whowas)  /* Can be NULL. */
    return NULL;

  if (whowas->online)
    dlinkDelete(&whowas->cnode, &whowas->online->whowas_list);

  dlinkDelete(&whowas->hnode, &whowas_hash[whowas->hashv]);
  dlinkDelete(&whowas->lnode, &whowas_list);

  return whowas;
}

/*! \brief Unlinks a Whowas struct from its associated lists
 *         and returns memory back to the pooling allocator.
 * \param whowas Pointer to Whowas struct to be unlinked and freed.
 */
static void
whowas_free(struct Whowas *whowas)
{
  whowas_unlink(whowas);
  mp_pool_release(whowas);
}

/*! \brief Returns a Whowas struct for further use. Either allocates
 *         a new one, or returns the oldest entry from the whowas_list
 *         if it ran over ConfigGeneral.whowas_history_length
 */
static struct Whowas *
whowas_make(void)
{
  struct Whowas *whowas;

  if (dlink_list_length(&whowas_list) >= ConfigGeneral.whowas_history_length)
    whowas = whowas_unlink(whowas_list.tail->data);  /* Re-use oldest item */
  else
    whowas = mp_pool_get(whowas_pool);

  return whowas;
}

/*! \brief Trims the whowas_list if necessary until there are no
 *         more than ConfigGeneral.whowas_history_length Whowas
 *         struct items.
 */
void
whowas_trim(void)
{
  while (dlink_list_length(&whowas_list) >= ConfigGeneral.whowas_history_length)
  {
    if (!whowas_list.tail->data)
      return;  /* whowas_list is now empty. No more items can be freed. */

    whowas_free(whowas_list.tail->data);
  }
}

/*! \brief Adds the currently defined name of the client to history.
 *         Usually called before changing to a new name (nick).
 *         Client must be a fully registered user.
 * \param client_p Pointer to Client struct to add to whowas history
 * \param online   Either 1 if it's a nick change or 0 on client exit
 */
void
whowas_add_history(struct Client *client_p, const int online)
{
  struct Whowas *whowas = whowas_make();

  if (!whowas)  /* Can be NULL. */
    return;

  assert(IsClient(client_p));

  whowas->hashv = strhash(client_p->name);
  whowas->shide = IsHidden(client_p->servptr) != 0;
  whowas->logoff = CurrentTime;

  strlcpy(whowas->account, client_p->account, sizeof(whowas->account));
  strlcpy(whowas->name, client_p->name, sizeof(whowas->name));
  strlcpy(whowas->username, client_p->username, sizeof(whowas->username));
  strlcpy(whowas->hostname, client_p->host, sizeof(whowas->hostname));
  strlcpy(whowas->sockhost, client_p->sockhost, sizeof(whowas->sockhost));
  strlcpy(whowas->realname, client_p->info, sizeof(whowas->realname));
  strlcpy(whowas->servername, client_p->servptr->name, sizeof(whowas->servername));

  if (online)
  {
    whowas->online = client_p;
    dlinkAdd(whowas, &whowas->cnode, &client_p->whowas_list);
  }
  else
    whowas->online = NULL;

  dlinkAdd(whowas, &whowas->hnode, &whowas_hash[whowas->hashv]);
  dlinkAdd(whowas, &whowas->lnode, &whowas_list);
}

/*! \brief This must be called when the client structure is about to
 *         be released. History mechanism keeps pointers to client
 *         structures and it must know when they cease to exist.
 * \param client_p Pointer to Client struct
 */
void
whowas_off_history(struct Client *client_p)
{
  while (client_p->whowas_list.head)
  {
    struct Whowas *whowas = client_p->whowas_list.head->data;

    whowas->online = NULL;
    dlinkDelete(&whowas->cnode, &client_p->whowas_list);
  }
}

/*! \brief Returns the current client that was using the given
 *         nickname within the timelimit. Returns NULL, if no
 *         one found.
 * \param name      Name of the nick
 * \param timelimit Maximum age for a client since log-off
 */
struct Client *
whowas_get_history(const char *name, uintmax_t timelimit)
{
  dlink_node *node = NULL;

  timelimit = CurrentTime - timelimit;

  DLINK_FOREACH(node, whowas_hash[strhash(name)].head)
  {
    struct Whowas *whowas = node->data;

    if (whowas->logoff < timelimit)
      continue;
    if (irccmp(name, whowas->name))
      continue;
    return whowas->online;
  }

  return NULL;
}

/*! \brief For debugging. Counts allocated structures stored in whowas_list
 */
void
whowas_count_memory(unsigned int *const count, size_t *const bytes)
{
  (*count) = dlink_list_length(&whowas_list);
  (*bytes) = dlink_list_length(&whowas_list) * sizeof(struct Whowas);
}
Revision:	7486
Committed:	Wed Mar 16 10:45:17 2016 UTC (9 years, 5 months ago) by michael
Content type:	text/x-csrc
File size:	6184 byte(s)
Log Message:	- Rename Client::whowas to Client::whowas_list
#	User	Rev	Content
1	adx	30	/*
2	michael	2916	* ircd-hybrid: an advanced, lightweight Internet Relay Chat Daemon (ircd)
3	adx	30	*
4	michael	7006	* Copyright (c) 1997-2016 ircd-hybrid development team
5	adx	30	*
6			* This program is free software; you can redistribute it and/or modify
7			* it under the terms of the GNU General Public License as published by
8			* the Free Software Foundation; either version 2 of the License, or
9			* (at your option) any later version.
10			*
11			* This program is distributed in the hope that it will be useful,
12			* but WITHOUT ANY WARRANTY; without even the implied warranty of
13			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14			* GNU General Public License for more details.
15			*
16			* You should have received a copy of the GNU General Public License
17			* along with this program; if not, write to the Free Software
18	michael	4565	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
19	adx	30	* USA
20			*/
21
22	michael	2916	/*! \file whowas.c
23			* \brief WHOWAS user cache.
24			* \version $Id$
25			*/
26
27	adx	30	#include "stdinc.h"
28	michael	1358	#include "list.h"
29	michael	7437	#include "mempool.h"
30	adx	30	#include "whowas.h"
31			#include "client.h"
32			#include "hash.h"
33			#include "irc_string.h"
34			#include "ircd.h"
35	michael	7437	#include "conf.h"
36	adx	30
37
38	michael	7437	static mp_pool_t *whowas_pool;
39
40			static dlink_list whowas_list; /! Chain of struct Whowas pointers /
41	michael	7449	static dlink_list whowas_hash[HASHSIZE];
42	adx	30
43
44	michael	7442	/*! \brief Initializes the whowas memory pool.
45	michael	7393	*/
46	adx	30	void
47	michael	1997	whowas_init(void)
48			{
49	michael	7442	whowas_pool = mp_pool_new(sizeof(struct Whowas), MP_CHUNK_SIZE_WHOWAS);
50	michael	1997	}
51
52	michael	7449	/*! \brief Returns a slot of the whowas_hash by the hash value associated with it.
53			* \param hashv Hash value.
54			*/
55			const dlink_list *
56			whowas_get_hash(unsigned int hashv)
57			{
58			if (hashv >= HASHSIZE)
59			return NULL;
60
61			return &whowas_hash[hashv];
62			}
63
64	michael	7437	/*! \brief Unlinks a Whowas struct from its associated lists.
65	michael	7442	* \param whowas Pointer to Whowas struct to be unlinked.
66	michael	7437	*/
67			static struct Whowas *
68			whowas_unlink(struct Whowas *whowas)
69			{
70			if (!whowas) /* Can be NULL. */
71			return NULL;
72
73			if (whowas->online)
74	michael	7486	dlinkDelete(&whowas->cnode, &whowas->online->whowas_list);
75	michael	7437
76	michael	7449	dlinkDelete(&whowas->hnode, &whowas_hash[whowas->hashv]);
77	michael	7437	dlinkDelete(&whowas->lnode, &whowas_list);
78
79			return whowas;
80			}
81
82			/*! \brief Unlinks a Whowas struct from its associated lists
83			* and returns memory back to the pooling allocator.
84	michael	7442	* \param whowas Pointer to Whowas struct to be unlinked and freed.
85	michael	7437	*/
86			static void
87			whowas_free(struct Whowas *whowas)
88			{
89			whowas_unlink(whowas);
90			mp_pool_release(whowas);
91			}
92
93			/*! \brief Returns a Whowas struct for further use. Either allocates
94			* a new one, or returns the oldest entry from the whowas_list
95			* if it ran over ConfigGeneral.whowas_history_length
96			*/
97			static struct Whowas *
98			whowas_make(void)
99			{
100			struct Whowas *whowas;
101
102			if (dlink_list_length(&whowas_list) >= ConfigGeneral.whowas_history_length)
103	michael	7441	whowas = whowas_unlink(whowas_list.tail->data); /* Re-use oldest item */
104	michael	7437	else
105			whowas = mp_pool_get(whowas_pool);
106
107			return whowas;
108			}
109
110			/*! \brief Trims the whowas_list if necessary until there are no
111			* more than ConfigGeneral.whowas_history_length Whowas
112			* struct items.
113			*/
114			void
115			whowas_trim(void)
116			{
117			while (dlink_list_length(&whowas_list) >= ConfigGeneral.whowas_history_length)
118			{
119			if (!whowas_list.tail->data)
120			return; /* whowas_list is now empty. No more items can be freed. */
121
122			whowas_free(whowas_list.tail->data);
123			}
124			}
125
126	michael	7393	/*! \brief Adds the currently defined name of the client to history.
127			* Usually called before changing to a new name (nick).
128			* Client must be a fully registered user.
129	michael	7442	* \param client_p Pointer to Client struct to add to whowas history
130			* \param online Either 1 if it's a nick change or 0 on client exit
131	michael	7393	*/
132	michael	1997	void
133	michael	2300	whowas_add_history(struct Client *client_p, const int online)
134	adx	30	{
135	michael	7437	struct Whowas *whowas = whowas_make();
136	adx	30
137	michael	7437	if (!whowas) /* Can be NULL. */
138			return;
139
140	michael	3273	assert(IsClient(client_p));
141	adx	30
142	michael	6654	whowas->hashv = strhash(client_p->name);
143			whowas->shide = IsHidden(client_p->servptr) != 0;
144			whowas->logoff = CurrentTime;
145	adx	30
146	michael	6654	strlcpy(whowas->account, client_p->account, sizeof(whowas->account));
147			strlcpy(whowas->name, client_p->name, sizeof(whowas->name));
148			strlcpy(whowas->username, client_p->username, sizeof(whowas->username));
149			strlcpy(whowas->hostname, client_p->host, sizeof(whowas->hostname));
150			strlcpy(whowas->sockhost, client_p->sockhost, sizeof(whowas->sockhost));
151			strlcpy(whowas->realname, client_p->info, sizeof(whowas->realname));
152			strlcpy(whowas->servername, client_p->servptr->name, sizeof(whowas->servername));
153	adx	30
154			if (online)
155			{
156	michael	6654	whowas->online = client_p;
157	michael	7486	dlinkAdd(whowas, &whowas->cnode, &client_p->whowas_list);
158	adx	30	}
159			else
160	michael	6654	whowas->online = NULL;
161	adx	30
162	michael	7449	dlinkAdd(whowas, &whowas->hnode, &whowas_hash[whowas->hashv]);
163	michael	7437	dlinkAdd(whowas, &whowas->lnode, &whowas_list);
164	adx	30	}
165
166	michael	7393	/*! \brief This must be called when the client structure is about to
167			* be released. History mechanism keeps pointers to client
168			* structures and it must know when they cease to exist.
169	michael	7442	* \param client_p Pointer to Client struct
170	michael	7393	*/
171	adx	30	void
172	michael	2300	whowas_off_history(struct Client *client_p)
173	adx	30	{
174	michael	7486	while (client_p->whowas_list.head)
175	adx	30	{
176	michael	7486	struct Whowas *whowas = client_p->whowas_list.head->data;
177	michael	1358
178	michael	6654	whowas->online = NULL;
179	michael	7486	dlinkDelete(&whowas->cnode, &client_p->whowas_list);
180	adx	30	}
181			}
182
183	michael	7393	/*! \brief Returns the current client that was using the given
184			* nickname within the timelimit. Returns NULL, if no
185	michael	7437	* one found.
186	michael	7442	* \param name Name of the nick
187			* \param timelimit Maximum age for a client since log-off
188	michael	7393	*/
189	adx	30	struct Client *
190	michael	7394	whowas_get_history(const char *name, uintmax_t timelimit)
191	adx	30	{
192	michael	4800	dlink_node *node = NULL;
193	adx	30
194			timelimit = CurrentTime - timelimit;
195
196	michael	7449	DLINK_FOREACH(node, whowas_hash[strhash(name)].head)
197	adx	30	{
198	michael	6654	struct Whowas *whowas = node->data;
199	michael	1358
200	michael	6654	if (whowas->logoff < timelimit)
201	michael	1358	continue;
202	michael	7394	if (irccmp(name, whowas->name))
203	adx	30	continue;
204	michael	6654	return whowas->online;
205	adx	30	}
206
207	michael	1298	return NULL;
208	adx	30	}
209
210	michael	7437	/*! \brief For debugging. Counts allocated structures stored in whowas_list
211	michael	7393	*/
212	adx	30	void
213	michael	6719	whowas_count_memory(unsigned int const count, size_t const bytes)
214	adx	30	{
215	michael	7437	(*count) = dlink_list_length(&whowas_list);
216			(bytes) = dlink_list_length(&whowas_list) sizeof(struct Whowas);
217	adx	30	}