/* * libretroshare/src/pqi: p3cfgmgr.h * * 3P/PQI network interface for RetroShare. * * Copyright 2007-2008 by Robert Fernie. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License Version 2 as published by the Free Software Foundation. * * This library 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 * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 * USA. * * Please report all bugs and problems to "retroshare@lunamutt.com". * */ #ifndef P3_CONFIG_MGR_HEADER #define P3_CONFIG_MGR_HEADER #include #include #include "pqi/pqi_base.h" #include "pqi/pqiindic.h" #include "pqi/pqinetwork.h" #include "util/rsthreads.h" /***** Configuration Management ***** * * we need to store: * (1) Certificates. * (2) List of Friends / Net Configuration * (3) Stun List. / DHT peers. * (4) general config. * * * At top level we need: * * - type / filename / size / hash - * and the file signed... * * */ /**** THESE are STORED in CONFIGURATION FILES.... * Cannot be changed * *********************/ const uint32_t CONFIG_TYPE_GENERAL = 0x0001; const uint32_t CONFIG_TYPE_PEERS = 0x0002; const uint32_t CONFIG_TYPE_FSERVER = 0x0003; const uint32_t CONFIG_TYPE_MSGS = 0x0004; const uint32_t CONFIG_TYPE_CACHE = 0x0005; const uint32_t CONFIG_TYPE_RANK_LINK = 0x0011; const uint32_t CONFIG_TYPE_QBLOG = 0x0012; const uint32_t CONFIG_TYPE_FORUMS = 0x0013; class p3ConfigMgr; class p3AuthMgr; class pqiConfig { public: pqiConfig(uint32_t t); virtual ~pqiConfig(); virtual bool loadConfiguration(std::string &loadHash) = 0; virtual bool saveConfiguration() = 0; uint32_t Type(); std::string Filename(); std::string Hash(); protected: void IndicateConfigChanged(); void setHash(std::string h); RsMutex cfgMtx; private: void setFilename(std::string name); bool HasConfigChanged(uint16_t idx); Indicator ConfInd; uint32_t type; std::string filename; std::string hash; friend class p3ConfigMgr; /* so it can access: * setFilename() and HasConfigChanged() */ }; /**** MUTEX NOTE * None - because no-one calls any functions * besides tick() when the system is running. */ class p3ConfigMgr { public: p3ConfigMgr(p3AuthMgr *am, std::string bdir, std::string fname, std::string signame); void tick(); void saveConfiguration(); void loadConfiguration(); void addConfiguration(std::string file, pqiConfig *conf); /* saves config, and disables further saving * used for exiting the system */ void completeConfiguration(); private: /* these are constants - so shouldn't need mutex */ p3AuthMgr *mAuthMgr; const std::string basedir; const std::string metafname; const std::string metasigfname; RsMutex cfgMtx; /* below is protected */ bool mConfigSaveActive; std::map configs; }; class p3Config: public pqiConfig { public: p3Config(uint32_t t); virtual bool loadConfiguration(std::string &loadHash); virtual bool saveConfiguration(); protected: /* Key Functions to be overloaded for Full Configuration */ virtual RsSerialiser *setupSerialiser() = 0; virtual std::list saveList(bool &cleanup) = 0; virtual bool loadList(std::list load) = 0; /** * callback for mutex unlocking * in derived classes (should only be needed if cleanup = false) */ virtual void saveDone() { return; } }; /* end of p3Config */ class p3GeneralConfig: public p3Config { public: p3GeneralConfig(); // General Configuration System std::string getSetting(std::string opt); void setSetting(std::string opt, std::string val); protected: /* Key Functions to be overloaded for Full Configuration */ virtual RsSerialiser *setupSerialiser(); virtual std::list saveList(bool &cleanup); virtual bool loadList(std::list load); private: /* protected by pqiConfig mutex as well! */ std::map settings; }; #endif // P3_CONFIG_MGR_HEADER