3 * =============================================================================
5 * Copyright (C) 2004-2007 AlliedModders LLC. All rights reserved.
6 * =============================================================================
8 * This program is free software; you can redistribute it and/or modify it under
9 * the terms of the GNU General Public License, version 3.0, as published by the
10 * Free Software Foundation.
12 * This program is distributed in the hope that it will be useful, but WITHOUT
13 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
17 * You should have received a copy of the GNU General Public License along with
18 * this program. If not, see <http://www.gnu.org/licenses/>.
20 * As a special exception, AlliedModders LLC gives you permission to link the
21 * code of this program (as well as its derivative works) to "Half-Life 2," the
22 * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
23 * by the Valve Corporation. You must obey the GNU General Public License in
24 * all respects for all other code used. Additionally, AlliedModders LLC grants
25 * this exception to all derivative works. AlliedModders LLC defines further
26 * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
27 * or <http://www.sourcemod.net/license.php>.
32 #ifndef _INCLUDE_SOURCEMOD_ADMINCACHE_H_
33 #define _INCLUDE_SOURCEMOD_ADMINCACHE_H_
35 #include "sm_memtable.h"
38 #include <sh_string.h>
39 #include <IAdminSystem.h>
40 #include "sm_globals.h"
41 #include <IForwardSys.h>
43 using namespace SourceHook;
45 #define GRP_MAGIC_SET 0xDEADFADE
46 #define GRP_MAGIC_UNSET 0xFACEFACE
47 #define USR_MAGIC_SET 0xDEADFACE
48 #define USR_MAGIC_UNSET 0xFADEDEAD
52 uint32_t magic; /* Magic flag, for memory validation (ugh) */
53 bool immune_global; /* Global immunity? */
54 bool immune_default; /* Default immunity? */
55 /* Immune from target table (-1 = nonexistent)
56 * [0] = number of entries
57 * [1...N] = immune targets
60 Trie *pCmdTable; /* Command override table (can be NULL) */
61 Trie *pCmdGrpTable; /* Command group override table (can be NULL) */
62 int next_grp; /* Next group in the chain */
63 int prev_grp; /* Previous group in the chain */
64 int nameidx; /* Name */
65 FlagBits addflags; /* Additive flags */
76 unsigned int index; /* Index into auth table */
77 int identidx; /* Index into the string table */
82 uint32_t magic; /* Magic flag, for memory validation */
83 FlagBits flags; /* Flags */
84 FlagBits eflags; /* Effective flags */
85 int nameidx; /* Name index */
86 int password; /* Password index */
87 unsigned int grp_count; /* Number of groups */
88 unsigned int grp_size; /* Size of groups table */
89 int grp_table; /* Group table itself */
90 int next_user; /* Next user in the list */
91 int prev_user; /* Previous user in the list */
92 UserAuth auth; /* Auth method for this user */
93 bool immune_global; /* Whether globally immune */
94 bool immune_default; /* Whether defaultly immune */
95 unsigned int serialchange; /* Serial # for changes */
105 public: //SMGlobalClass
106 void OnSourceModStartup(bool late);
107 void OnSourceModAllInitialized();
108 void OnSourceModLevelChange(const char *mapName);
109 void OnSourceModShutdown();
110 void OnSourceModPluginsLoaded();
111 public: //IAdminSystem
112 /** Command cache stuff */
113 void AddCommandOverride(const char *cmd, OverrideType type, FlagBits flags);
114 bool GetCommandOverride(const char *cmd, OverrideType type, FlagBits *flags);
115 void UnsetCommandOverride(const char *cmd, OverrideType type);
116 /** Group cache stuff */
117 GroupId AddGroup(const char *group_name);
118 GroupId FindGroupByName(const char *group_name);
119 void SetGroupAddFlag(GroupId id, AdminFlag flag, bool enabled);
120 bool GetGroupAddFlag(GroupId id, AdminFlag flag);
121 FlagBits GetGroupAddFlags(GroupId id);
122 void SetGroupGenericImmunity(GroupId id, ImmunityType type, bool enabled);
123 bool GetGroupGenericImmunity(GroupId id, ImmunityType type);
124 void InvalidateGroup(GroupId id);
125 void AddGroupImmunity(GroupId id, GroupId other_id);
126 unsigned int GetGroupImmunityCount(GroupId id);
127 GroupId GetGroupImmunity(GroupId id, unsigned int number);
128 void AddGroupCommandOverride(GroupId id, const char *name, OverrideType type, OverrideRule rule);
129 bool GetGroupCommandOverride(GroupId id, const char *name, OverrideType type, OverrideRule *pRule);
130 void DumpAdminCache(AdminCachePart part, bool rebuild);
131 void AddAdminListener(IAdminListener *pListener);
132 void RemoveAdminListener(IAdminListener *pListener);
134 void RegisterAuthIdentType(const char *name);
135 AdminId CreateAdmin(const char *name);
136 const char *GetAdminName(AdminId id);
137 bool BindAdminIdentity(AdminId id, const char *auth, const char *ident);
138 virtual void SetAdminFlag(AdminId id, AdminFlag flag, bool enabled);
139 bool GetAdminFlag(AdminId id, AdminFlag flag, AccessMode mode);
140 FlagBits GetAdminFlags(AdminId id, AccessMode mode);
141 bool AdminInheritGroup(AdminId id, GroupId gid);
142 unsigned int GetAdminGroupCount(AdminId id);
143 GroupId GetAdminGroup(AdminId id, unsigned int index, const char **name);
144 void SetAdminPassword(AdminId id, const char *password);
145 const char *GetAdminPassword(AdminId id);
146 AdminId FindAdminByIdentity(const char *auth, const char *identity);
147 bool InvalidateAdmin(AdminId id);
148 unsigned int FlagBitsToBitArray(FlagBits bits, bool array[], unsigned int maxSize);
149 FlagBits FlagBitArrayToBits(const bool array[], unsigned int maxSize);
150 FlagBits FlagArrayToBits(const AdminFlag array[], unsigned int numFlags);
151 unsigned int FlagBitsToArray(FlagBits bits, AdminFlag array[], unsigned int maxSize);
152 bool CheckAdminFlags(AdminId id, FlagBits bits);
153 bool CanAdminTarget(AdminId id, AdminId target);
154 void SetAdminFlags(AdminId id, AccessMode mode, FlagBits bits);
155 bool FindFlag(const char *str, AdminFlag *pFlag);
156 bool FindFlag(char c, AdminFlag *pAdmFlag);
157 FlagBits ReadFlagString(const char *flags, const char **end);
158 unsigned int GetAdminSerialChange(AdminId id);
159 bool CanAdminUseCommand(int client, const char *cmd);
161 bool IsValidAdmin(AdminId id);
163 void _UnsetCommandOverride(const char *cmd);
164 void _UnsetCommandGroupOverride(const char *group);
165 void InvalidateGroupCache();
166 void InvalidateAdminCache(bool unlink_admins);
167 void DumpCommandOverrideCache(OverrideType type);
168 Trie *GetMethodByIndex(unsigned int index);
169 bool GetMethodIndex(const char *name, unsigned int *_index);
170 void NameFlag(const char *str, AdminFlag flag);
172 BaseStringTable *m_pStrings;
173 BaseMemTable *m_pMemory;
174 Trie *m_pCmdOverrides;
175 Trie *m_pCmdGrpOverrides;
180 List<IAdminListener *> m_hooks;
181 List<AuthMethod> m_AuthMethods;
183 IForward *m_pCacheFwd;
187 bool m_InvalidatingAdmins;
192 extern AdminCache g_Admins;
194 #endif //_INCLUDE_SOURCEMOD_ADMINCACHE_H_