/******************************************************************************* * libretroshare/src/rsserver: p3peers.h * * * * libretroshare: retroshare core library * * * * Copyright 2004-2008 by Robert Fernie * * * * This program is free software: you can redistribute it and/or modify * * it under the terms of the GNU Lesser General Public License as * * published by the Free Software Foundation, either version 3 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 Lesser General Public License for more details. * * * * You should have received a copy of the GNU Lesser General Public License * * along with this program. If not, see . * * * *******************************************************************************/ #ifndef RETROSHARE_P3_PEER_INTERFACE_H #define RETROSHARE_P3_PEER_INTERFACE_H /* get OS-specific definitions for: * struct sockaddr_storage */ #ifndef WINDOWS_SYS #include #else #include #endif #include "retroshare/rspeers.h" #include "util/rsurl.h" #include "util/rsdeprecate.h" #include "util/rsdebug.h" class p3LinkMgr; class p3PeerMgr; class p3NetMgr; class p3Peers: public RsPeers { public: p3Peers(p3LinkMgr *lm, p3PeerMgr *pm, p3NetMgr *nm); virtual ~p3Peers() {} /* Updates ... */ virtual bool FriendsChanged(); virtual bool OthersChanged(); /* Peer Details (Net & Auth) */ virtual const RsPeerId& getOwnId(); virtual bool haveSecretKey(const RsPgpId& gpg_id) ; virtual bool getOnlineList(std::list &ids); virtual bool getFriendList(std::list &ids); virtual bool getPeersCount( uint32_t& peersCount, uint32_t& onlinePeersCount, bool countLocations ); RS_DEPRECATED virtual bool getPeerCount (unsigned int *friendCount, unsigned int *onlineCount, bool ssl); virtual bool isOnline(const RsPeerId &id); virtual bool isFriend(const RsPeerId &id); virtual bool isPgpFriend(const RsPgpId& pgpId); RS_DEPRECATED_FOR(isPgpFriend) virtual bool isGPGAccepted(const RsPgpId &gpg_id_is_friend); virtual std::string getGPGName(const RsPgpId &gpg_id); virtual std::string getPeerName(const RsPeerId& ssl_or_gpg_id); virtual bool getPeerDetails(const RsPeerId& ssl_or_gpg_id, RsPeerDetails &d); /* Using PGP Ids */ virtual const RsPgpId& getGPGOwnId(); virtual RsPgpId getGPGId(const RsPeerId &ssl_id); virtual bool isKeySupported(const RsPgpId& ids); virtual bool getGPGAcceptedList(std::list &ids); virtual bool getGPGSignedList(std::list &ids); virtual bool getGPGValidList(std::list &ids); virtual bool getGPGAllList(std::list &ids); virtual bool getGPGDetails(const RsPgpId &id, RsPeerDetails &d); virtual bool getAssociatedSSLIds(const RsPgpId& gpg_id, std::list &ids); virtual bool gpgSignData(const void *data, const uint32_t len, unsigned char *sign, unsigned int *signlen, std::string reason = "") ; /* Add/Remove Friends */ virtual bool addFriend(const RsPeerId &ssl_id, const RsPgpId &gpg_id,ServicePermissionFlags flags = RS_NODE_PERM_DEFAULT); virtual bool removeFriend(const RsPgpId& gpgid); virtual bool removeFriendLocation(const RsPeerId& sslId); /* keyring management */ virtual bool removeKeysFromPGPKeyring(const std::set &pgp_ids,std::string& backup_file,uint32_t& error_code); /* Network Stuff */ virtual bool connectAttempt(const RsPeerId &id); virtual bool setLocation(const RsPeerId &ssl_id, const std::string &location);//location is shown in the gui to differentiate ssl certs virtual bool setHiddenNode(const RsPeerId &id, const std::string &hidden_node_address); virtual bool setHiddenNode(const RsPeerId &id, const std::string &address, uint16_t port); virtual bool isHiddenNode(const RsPeerId &id); virtual bool addPeerLocator(const RsPeerId &ssl_id, const RsUrl& locator); virtual bool setLocalAddress(const RsPeerId &id, const std::string &addr, uint16_t port); virtual bool setExtAddress(const RsPeerId &id, const std::string &addr, uint16_t port); virtual bool setDynDNS(const RsPeerId &id, const std::string &dyndns); virtual bool setNetworkMode(const RsPeerId &id, uint32_t netMode); virtual bool setVisState(const RsPeerId &id, uint16_t vs_disc, uint16_t vs_dht); virtual bool getProxyServer(const uint32_t type, std::string &addr, uint16_t &port,uint32_t& status); virtual bool setProxyServer(const uint32_t type, const std::string &addr, const uint16_t port); virtual bool isProxyAddress(const uint32_t type, const sockaddr_storage &addr); virtual void getIPServersList(std::list& ip_servers); virtual void allowServerIPDetermination(bool); virtual bool getAllowServerIPDetermination(); virtual bool resetOwnExternalAddressList(); /* Auth Stuff */ // Get the invitation (GPG cert + local/ext address + SSL id for the given peer) virtual std::string GetRetroshareInvite( const RsPeerId& ssl_id = RsPeerId(), bool include_signatures = false, bool includeExtraLocators = true ); virtual std::string getPGPKey(const RsPgpId& pgp_id,bool include_signatures); virtual bool GetPGPBase64StringAndCheckSum(const RsPgpId& gpg_id,std::string& gpg_base64_string,std::string& gpg_base64_checksum); /// @see RsPeers::acceptInvite virtual bool acceptInvite( const std::string& invite, ServicePermissionFlags flags = RS_NODE_PERM_DEFAULT ); virtual bool hasExportMinimal(); virtual bool loadCertificateFromString(const std::string& cert, RsPeerId& ssl_id,RsPgpId& pgp_id, std::string& error_string); virtual bool loadDetailsFromStringCert(const std::string &cert, RsPeerDetails &pd, uint32_t& error_code); virtual bool cleanCertificate(const std::string &certstr, std::string &cleanCert,int& error_code); virtual bool saveCertificateToFile(const RsPeerId &id, const std::string &fname); virtual std::string saveCertificateToString(const RsPeerId &id); virtual bool signGPGCertificate(const RsPgpId &id); virtual bool trustGPGCertificate(const RsPgpId &id, uint32_t trustlvl); /* Group Stuff */ virtual bool addGroup(RsGroupInfo &groupInfo); virtual bool editGroup(const RsNodeGroupId &groupId, RsGroupInfo &groupInfo); virtual bool removeGroup(const RsNodeGroupId &groupId); virtual bool getGroupInfo(const RsNodeGroupId &groupId, RsGroupInfo &groupInfo); virtual bool getGroupInfoByName(const std::string& groupName, RsGroupInfo& groupInfo); virtual bool getGroupInfoList(std::list &groupInfoList); virtual bool assignPeerToGroup(const RsNodeGroupId &groupId, const RsPgpId &peerId, bool assign); virtual bool assignPeersToGroup(const RsNodeGroupId &groupId, const std::list& peerIds, bool assign); virtual FileSearchFlags computePeerPermissionFlags(const RsPeerId& peer_id, FileStorageFlags share_flags, const std::list &parent_groups); // service permission stuff virtual ServicePermissionFlags servicePermissionFlags(const RsPgpId& gpg_id); virtual ServicePermissionFlags servicePermissionFlags(const RsPeerId & ssl_id); virtual void setServicePermissionFlags(const RsPgpId& gpg_id,const ServicePermissionFlags& flags); virtual bool setPeerMaximumRates(const RsPgpId& pid,uint32_t maxUploadRate,uint32_t maxDownloadRate); virtual bool getPeerMaximumRates(const RsPgpId& pid,uint32_t& maxUploadRate,uint32_t& maxDownloadRate); virtual bool getPeerMaximumRates(const RsPeerId& pid,uint32_t& maxUploadRate,uint32_t& maxDownloadRate); private: p3LinkMgr *mLinkMgr; p3PeerMgr *mPeerMgr; p3NetMgr *mNetMgr; RS_SET_CONTEXT_DEBUG_LEVEL(1) }; #endif