Commit of the new UDP Connection methods and

the rewrite of the retroshare core networking stack.

This check-in commits the changes to the rsiface code.

Addition of new Retroshare Interface for Peer/Neighbour control.
Mods to notifytxt to use new interface.



git-svn-id: http://svn.code.sf.net/p/retroshare/code/trunk@315 b45a01b8-16f6-495d-af2f-9b41ad6348cc

libretroshare/src/rsiface/rspeers.h

@@ -0,0 +1,147 @@
+#ifndef RETROSHARE_PEER_GUI_INTERFACE_H
+#define RETROSHARE_PEER_GUI_INTERFACE_H
+
+/*
+ * libretroshare/src/rsiface: rspeer.h
+ *
+ * RetroShare C++ Interface.
+ *
+ * Copyright 2004-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".
+ *
+ */
+
+#include <inttypes.h>
+#include <string>
+#include <list>
+
+/* The Main Interface Class - for information about your Peers */
+class RsPeers;
+extern RsPeers   *rsPeers;
+
+/* Trust Levels */
+const uint32_t RS_TRUST_LVL_UNKNOWN	= 0x0001;
+const uint32_t RS_TRUST_LVL_MARGINAL	= 0x0002;
+const uint32_t RS_TRUST_LVL_GOOD	= 0x0003;
+
+
+/* Net Mode */
+const uint32_t RS_NETMODE_UDP		= 0x0001;
+const uint32_t RS_NETMODE_UPNP		= 0x0002;
+const uint32_t RS_NETMODE_EXT		= 0x0003;
+
+/* State */
+const uint32_t RS_PEER_STATE_FRIEND	= 0x0001;
+const uint32_t RS_PEER_STATE_ONLINE	= 0x0002;
+const uint32_t RS_PEER_STATE_CONNECTED  = 0x0004;
+
+/* A couple of helper functions for translating the numbers games */
+
+std::string RsPeerTrustString(uint32_t trustLvl);
+std::string RsPeerStateString(uint32_t state);
+std::string RsPeerNetModeString(uint32_t netModel);
+std::string RsPeerLastConnectString(uint32_t lastConnect);
+
+
+/* Details class */
+class RsPeerDetails
+{
+	public:
+
+	RsPeerDetails();
+
+	/* Auth details */
+	std::string id;
+	std::string name;
+	std::string email;
+	std::string location;
+	std::string org;
+	
+	std::string fpr; /* fingerprint */
+	std::string authcode; 
+	std::list<std::string> signers;
+
+	uint32_t trustLvl;
+
+	bool ownsign; /* we have signed certificate */
+	bool trusted; /* we trust their signature on others */
+
+	/* Network details (only valid if friend) */
+	uint32_t		state;
+
+        std::string             localAddr;
+        uint16_t                localPort;
+        std::string             extAddr;
+        uint16_t                extPort;
+
+	uint32_t		netMode;
+
+	/* basic stats */
+	uint32_t		lastConnect; /* how long ago */
+	uint32_t		connectPeriod; 
+};
+
+std::ostream &operator<<(std::ostream &out, const RsPeerDetails &detail);
+
+class RsPeers 
+{
+	public:
+
+	RsPeers()  { return; }
+virtual ~RsPeers() { return; }
+
+	/* Updates ... */
+virtual bool FriendsChanged() 					= 0;
+virtual bool OthersChanged() 					= 0;
+
+	/* Peer Details (Net & Auth) */
+virtual std::string getOwnId()					= 0;
+
+virtual bool	getOnlineList(std::list<std::string> &ids)	= 0;
+virtual bool	getFriendList(std::list<std::string> &ids)	= 0;
+virtual bool	getOthersList(std::list<std::string> &ids)	= 0;
+
+virtual bool    isFriend(std::string id)			= 0;
+virtual std::string getPeerName(std::string id)			= 0;
+virtual bool	getPeerDetails(std::string id, RsPeerDetails &d) = 0;
+
+	/* Add/Remove Friends */
+virtual	bool addFriend(std::string id)        			= 0;
+virtual	bool removeFriend(std::string id)  			= 0;
+
+	/* Network Stuff */
+virtual	bool connectAttempt(std::string id)			= 0;
+virtual	bool setLocalAddress(std::string id, std::string addr, uint16_t port) = 0;
+virtual	bool setExtAddress(  std::string id, std::string addr, uint16_t port) = 0;
+virtual	bool setNetworkMode(std::string id, uint32_t netMode) 	= 0;
+
+	/* Auth Stuff */
+virtual	std::string GetRetroshareInvite() 			= 0;
+
+virtual	bool LoadCertificateFromFile(std::string fname, std::string &id)  = 0;
+virtual	bool LoadCertificateFromString(std::string cert, std::string &id)  = 0;
+virtual	bool SaveCertificateToFile(std::string id, std::string fname)  = 0;
+virtual	std::string SaveCertificateToString(std::string id)  	= 0;
+
+virtual	bool AuthCertificate(std::string id, std::string code) 	= 0;
+virtual	bool SignCertificate(std::string id)                   	= 0;
+virtual	bool TrustCertificate(std::string id, bool trust) 	= 0;
+
+};
+
+#endif