Improve the clean-up of outdated IAuth instances on rehash (SF bug #2789656).
[ircu2.10.12-pk.git] / include / querycmds.h
index 22a9c839ca81c20fff30dac76f8a3f6edda957f0..6f96c54757e4a54e45b28b9654e81a0b0db04d6b 100644 (file)
@@ -1,75 +1,99 @@
-#ifndef QUERYCMDS_H
-#define QUERYCMDS_H
+/** @file
+ * @brief Interface and declarations for client counting functions.
+ * @version $Id$
+ */
+#ifndef INCLUDED_querycmds_h
+#define INCLUDED_querycmds_h
+
+#ifndef INCLUDED_ircd_features_h
+#include "ircd_features.h"     /* feature_str() */
+#endif
+
+struct Client;
 
-/*=============================================================================
+/*
  * Structs
  */
 
-struct lusers_st {
+/** Counts types of clients, servers, etc.\ on the network. */
+struct UserStatistics {
   /* Local connections: */
-  unsigned int unknowns;       /* IsUnknown() || IsConnecting() || IsHandshake() */
-  unsigned int local_servers;  /* IsServer() && MyConnect() */
-  unsigned int local_clients;  /* IsUser() && MyConnect() */
+  unsigned int unknowns;  /**< Clients of types: unknown, connecting, handshake */
+  unsigned int local_servers;   /**< Directly connected servers. */
+  unsigned int local_clients;   /**< Directly connected clients. */
+
   /* Global counts: */
-  unsigned int servers;                /* IsServer() || IsMe() */
-  unsigned int clients;                /* IsUser() */
+  unsigned int servers;         /**< Known servers, including #me. */
+  unsigned int clients;         /**< Registered users. */
+
   /* Global user mode changes: */
-  unsigned int inv_clients;    /* IsUser() && IsInvisible() */
-  unsigned int opers;          /* IsUser() && IsOper() */
+  unsigned int inv_clients;     /**< Registered invisible users. */
+  unsigned int opers;           /**< Registered IRC operators. */
+
   /* Misc: */
-  unsigned int channels;
+  unsigned int channels;        /**< Existing channels. */
 };
 
-/*=============================================================================
+extern struct UserStatistics UserStats;
+
+/*
  * Macros
  */
 
 /* Macros for remote connections: */
-#define Count_newremoteclient(nrof)            (++nrof.clients)
-#define Count_newremoteserver(nrof)            (++nrof.servers)
-#define Count_remoteclientquits(nrof)          (--nrof.clients)
-#define Count_remoteserverquits(nrof)          (--nrof.servers)
+/** Count \a cptr as a new remote client. */
+#define Count_newremoteclient(UserStats, cptr)  (++UserStats.clients, ++(cli_serv(cptr)->clients))
+/** Count a new remote server. */
+#define Count_newremoteserver(UserStats)  (++UserStats.servers)
+
+/** Count a remote user quit. */
+#define Count_remoteclientquits(UserStats,cptr)                \
+  do { \
+    --UserStats.clients; \
+    if (!IsServer(cptr)) \
+      --(cli_serv(cli_user(cptr)->server)->clients); \
+  } while (0)
+
+/** Count a remote server quit. */
+#define Count_remoteserverquits(UserStats)      (--UserStats.servers)
 
 /* Macros for local connections: */
-#define Count_newunknown(nrof)                 (++nrof.unknowns)
-#define Count_unknownbecomesclient(cptr, nrof) \
+/** Count a new local unknown connection. */
+#define Count_newunknown(UserStats)                     (++UserStats.unknowns)
+/** Update counters when \a cptr goes from unknown to registered. */
+#define Count_unknownbecomesclient(cptr, UserStats) \
   do { \
-    --nrof.unknowns; ++nrof.local_clients; ++nrof.clients; \
-    if (match("*" DOMAINNAME, cptr->sockhost) == 0) \
+    --UserStats.unknowns; ++UserStats.local_clients; ++UserStats.clients; \
+    if (match(feature_str(FEAT_DOMAINNAME), cli_sockhost(cptr)) == 0) \
       ++current_load.local_count; \
-    if (nrof.local_clients > max_client_count) \
-      max_client_count = nrof.local_clients; \
-    if (nrof.local_clients + nrof.local_servers > max_connection_count) \
+    if (UserStats.local_clients > max_client_count) \
+      max_client_count = UserStats.local_clients; \
+    if (UserStats.local_clients + UserStats.local_servers > max_connection_count) \
     { \
-      max_connection_count = nrof.local_clients + nrof.local_servers; \
+      max_connection_count = UserStats.local_clients + UserStats.local_servers; \
       if (max_connection_count % 10 == 0) \
-        sendto_ops("Maximum connections: %d (%d clients)", \
-           max_connection_count, max_client_count); \
+        sendto_opmask_butone(0, SNO_OLDSNO, "Maximum connections: %d (%d clients)", \
+            max_connection_count, max_client_count); \
     } \
   } while(0)
-#define Count_unknownbecomesserver(nrof)       do { --nrof.unknowns; ++nrof.local_servers; ++nrof.servers; } while(0)
-#define Count_clientdisconnects(cptr, nrof) \
+/** Update counters when \a cptr goes from unknown to server. */
+#define Count_unknownbecomesserver(UserStats)   do { --UserStats.unknowns; ++UserStats.local_servers; ++UserStats.servers; } while(0)
+/** Update counters when \a cptr (a local user) disconnects. */
+#define Count_clientdisconnects(cptr, UserStats) \
   do \
   { \
-    --nrof.local_clients; --nrof.clients; \
-    if (match("*" DOMAINNAME, cptr->sockhost) == 0) \
+    --UserStats.local_clients; --UserStats.clients; \
+    if (match(feature_str(FEAT_DOMAINNAME), cli_sockhost(cptr)) == 0) \
       --current_load.local_count; \
   } while(0)
-#define Count_serverdisconnects(nrof)          do { --nrof.local_servers; --nrof.servers; } while(0)
-#define Count_unknowndisconnects(nrof)         (--nrof.unknowns)
+/** Update counters when a local server disconnects. */
+#define Count_serverdisconnects(UserStats)              do { --UserStats.local_servers; --UserStats.servers; } while(0)
+/** Update counters when an unknown client disconnects. */
+#define Count_unknowndisconnects(UserStats)             (--UserStats.unknowns)
 
-/*=============================================================================
- * Proto types
+/*
+ * Prototypes
  */
 
-extern int m_version(aClient *cptr, aClient *sptr, int parc, char *parv[]);
-extern int m_info(aClient *cptr, aClient *sptr, int parc, char *parv[]);
-extern int m_links(aClient *cptr, aClient *sptr, int parc, char *parv[]);
-extern int m_help(aClient *cptr, aClient *sptr, int parc, char *parv[]);
-extern int m_lusers(aClient *cptr, aClient *sptr, int parc, char *parv[]);
-extern int m_admin(aClient *cptr, aClient *sptr, int parc, char *parv[]);
-extern int m_motd(aClient *cptr, aClient *sptr, int parc, char *parv[]);
-
-extern struct lusers_st nrof;
 
-#endif /* QUERYCMDS_H */
+#endif /* INCLUDED_querycmds_h */