core/AdminCache.h
author David Anderson <dvander@alliedmods.net>
Sun Aug 19 18:34:36 2007 +0000 (2007-08-19)
changeset 1361 591f6d2fd11d
parent 1356 4688fae59bcf
child 1403 ecb9c66fd4bb
permissions -rw-r--r--
added helper function for panel text
     1 /**
     2  * vim: set ts=4 :
     3  * =============================================================================
     4  * SourceMod
     5  * Copyright (C) 2004-2007 AlliedModders LLC.  All rights reserved.
     6  * =============================================================================
     7  *
     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.
    11  * 
    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
    15  * details.
    16  *
    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/>.
    19  *
    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>.
    28  *
    29  * Version: $Id$
    30  */
    31 
    32 #ifndef _INCLUDE_SOURCEMOD_ADMINCACHE_H_
    33 #define _INCLUDE_SOURCEMOD_ADMINCACHE_H_
    34 
    35 #include "sm_memtable.h"
    36 #include <sm_trie.h>
    37 #include <sh_list.h>
    38 #include <sh_string.h>
    39 #include <IAdminSystem.h>
    40 #include "sm_globals.h"
    41 #include <IForwardSys.h>
    42 
    43 using namespace SourceHook;
    44 
    45 #define GRP_MAGIC_SET		0xDEADFADE
    46 #define GRP_MAGIC_UNSET		0xFACEFACE
    47 #define USR_MAGIC_SET		0xDEADFACE
    48 #define USR_MAGIC_UNSET		0xFADEDEAD
    49 
    50 struct AdminGroup
    51 {
    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
    58 	 */
    59 	int immune_table;			
    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 */
    66 };
    67 
    68 struct AuthMethod
    69 {
    70 	String name;
    71 	Trie *table;
    72 };
    73 
    74 struct UserAuth
    75 {
    76 	unsigned int index;				/* Index into auth table */
    77 	int identidx;					/* Index into the string table */
    78 };
    79 
    80 struct AdminUser
    81 {
    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 */
    96 };
    97 
    98 class AdminCache : 
    99 	public IAdminSystem,
   100 	public SMGlobalClass
   101 {
   102 public:
   103 	AdminCache();
   104 	~AdminCache();
   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);
   133 	/** User stuff */
   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);
   160 	const char *GetGroupName(GroupId gid);
   161 public:
   162 	bool IsValidAdmin(AdminId id);
   163 private:
   164 	void _UnsetCommandOverride(const char *cmd);
   165 	void _UnsetCommandGroupOverride(const char *group);
   166 	void InvalidateGroupCache();
   167 	void InvalidateAdminCache(bool unlink_admins);
   168 	void DumpCommandOverrideCache(OverrideType type);
   169 	Trie *GetMethodByIndex(unsigned int index);
   170 	bool GetMethodIndex(const char *name, unsigned int *_index);
   171 	void NameFlag(const char *str, AdminFlag flag);
   172 public:
   173 	BaseStringTable *m_pStrings;
   174 	BaseMemTable *m_pMemory;
   175 	Trie *m_pCmdOverrides;
   176 	Trie *m_pCmdGrpOverrides;
   177 	int m_FirstGroup;
   178 	int m_LastGroup;
   179 	int m_FreeGroupList;
   180 	Trie *m_pGroups;
   181 	List<IAdminListener *> m_hooks;
   182 	List<AuthMethod> m_AuthMethods;
   183 	Trie *m_pAuthTables;
   184 	IForward *m_pCacheFwd;
   185 	int m_FirstUser;
   186 	int m_LastUser;
   187 	int m_FreeUserList;
   188 	bool m_InvalidatingAdmins;
   189 	bool m_destroying;
   190 	Trie *m_pLevelNames;
   191 };
   192 
   193 extern AdminCache g_Admins;
   194 
   195 #endif //_INCLUDE_SOURCEMOD_ADMINCACHE_H_