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 "send.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);

  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);
  }
  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.head)
  {
    struct Whowas *whowas = client_p->whowas.head->data;

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

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