trunk/include/whowas.h

/*
 *  ircd-hybrid: an advanced, lightweight Internet Relay Chat Daemon (ircd)
 *
 *  Copyright (c) 1997-2015 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.h
 * \brief A header for the whowas functions.
 * \version $Id$
 */

#ifndef INCLUDED_whowas_h
#define INCLUDED_whowas_h

#include "ircd_defs.h"
#include "client.h"
#include "config.h"


struct Whowas
{
  int hashv;
  int shide;
  time_t logoff;
  char account[NICKLEN + 1];  /**< Services account */
  char name[NICKLEN + 1];
  char username[USERLEN + 1];
  char hostname[HOSTLEN + 1];
  char realname[REALLEN + 1];
  char servername[HOSTLEN + 1];
  struct Client *online; /* Pointer to new nickname for chasing or NULL */
  dlink_node tnode;      /* for hash table...                           */
  dlink_node cnode;      /* for client struct linked list               */
};

/*
** initwhowas
*/
extern void whowas_init(void);

/*
** whowas_add_history
**      Add 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.
*/
extern void whowas_add_history(struct Client *, const int);

/*
** whowas_off_history
**      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. This
**      also implicitly calls AddHistory.
*/
extern void whowas_off_history(struct Client *);

/*
** whowas_get_history
**      Return the current client that was using the given
**      nickname within the timelimit. Returns NULL, if no
**      one found...
*/
extern struct Client *whowas_get_history(const char *, time_t);

/*
** for debugging...counts related structures stored in whowas array.
*/
extern void whowas_count_memory(unsigned int *const, uint64_t *const);
extern dlink_list WHOWASHASH[];
#endif /* INCLUDED_whowas_h */
Revision:	5347
Committed:	Sun Jan 11 12:42:20 2015 UTC (11 years, 7 months ago) by michael
Content type:	text/x-chdr
File size:	2646 byte(s)
Log Message:	- Update copyright years
#	User	Rev	Content
1	adx	30	/*
2	michael	2865	* ircd-hybrid: an advanced, lightweight Internet Relay Chat Daemon (ircd)
3	adx	30	*
4	michael	5347	* Copyright (c) 1997-2015 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	2865	/*! \file whowas.h
23			* \brief A header for the whowas functions.
24			* \version $Id$
25			*/
26
27	adx	30	#ifndef INCLUDED_whowas_h
28			#define INCLUDED_whowas_h
29
30			#include "ircd_defs.h"
31			#include "client.h"
32	michael	912	#include "config.h"
33	adx	30
34	michael	1358
35	adx	30	struct Whowas
36			{
37			int hashv;
38	michael	2748	int shide;
39	adx	30	time_t logoff;
40	michael	4819	char account[NICKLEN + 1]; /*< Services account /
41	michael	1431	char name[NICKLEN + 1];
42	michael	1358	char username[USERLEN + 1];
43	adx	30	char hostname[HOSTLEN + 1];
44			char realname[REALLEN + 1];
45			char servername[HOSTLEN + 1];
46			struct Client online; / Pointer to new nickname for chasing or NULL */
47	michael	1358	dlink_node tnode; /* for hash table... */
48			dlink_node cnode; /* for client struct linked list */
49	adx	30	};
50
51			/*
52			** initwhowas
53			*/
54	michael	1358	extern void whowas_init(void);
55	adx	30
56			/*
57	michael	2300	** whowas_add_history
58	adx	30	** Add the currently defined name of the client to history.
59			** usually called before changing to a new name (nick).
60			** Client must be a fully registered user.
61			*/
62	michael	2300	extern void whowas_add_history(struct Client *, const int);
63	adx	30
64			/*
65	michael	2300	** whowas_off_history
66	adx	30	** This must be called when the client structure is about to
67			** be released. History mechanism keeps pointers to client
68			** structures and it must know when they cease to exist. This
69			** also implicitly calls AddHistory.
70			*/
71	michael	2300	extern void whowas_off_history(struct Client *);
72	adx	30
73			/*
74	michael	2300	** whowas_get_history
75	adx	30	** Return the current client that was using the given
76			** nickname within the timelimit. Returns NULL, if no
77			** one found...
78			*/
79	michael	2300	extern struct Client whowas_get_history(const char , time_t);
80	adx	30
81			/*
82			** for debugging...counts related structures stored in whowas array.
83			*/
84	michael	2297	extern void whowas_count_memory(unsigned int const, uint64_t const);
85	michael	1358	extern dlink_list WHOWASHASH[];
86	adx	30	#endif /* INCLUDED_whowas_h */