[freenet-cvs] r15271 - trunk/freenet/src/freenet/node

2007-09-22 Thread [email protected]
Author: toad
Date: 2007-09-22 16:30:08 + (Sat, 22 Sep 2007)
New Revision: 15271

Modified:
   trunk/freenet/src/freenet/node/PeerNode.java
Log:
More detailed javadocs for completedHandshake()

Modified: trunk/freenet/src/freenet/node/PeerNode.java
===
--- trunk/freenet/src/freenet/node/PeerNode.java2007-09-22 15:42:00 UTC 
(rev 15270)
+++ trunk/freenet/src/freenet/node/PeerNode.java2007-09-22 16:30:08 UTC 
(rev 15271)
@@ -1388,7 +1388,18 @@
 /**
  * Called when we have completed a handshake, and have a new session key.
  * Creates a new tracker and demotes the old one. Deletes the old one if
- * the bootID isn't recognized.
+ * the bootID isn't recognized, since if the node has restarted we cannot
+ * recover old messages. In more detail:
+ * 
+ * Process the new noderef (check if it's valid, pick up any new 
information etc).
+ * Handle version conflicts (if the node is too old, or we are too 
old, we mark it as 
+ * non-routable, but some messages will still be exchanged e.g. Update 
Over Mandatory stuff).
+ * Deal with key trackers (if we just got message 4, the new key 
tracker becomes current; 
+ * if we just got message 3, it's possible that our message 4 will be lost 
in transit, so we 
+ * make the new tracker unverified. It will be promoted to current if we 
get a packet on it..
+ * if the node has restarted, we dump the old key trackers, otherwise 
current becomes previous).
+ * Complete the connection process: update the node's status, send 
initial messages, update
+ * the last-received-packet timestamp, etc.
  * @param thisBootID The boot ID of the peer we have just connected to.
  * This is simply a random number regenerated on every startup of the node.
  * We use it to determine whether the node has restarted since we last saw 




[freenet-cvs] r15271 - trunk/freenet/src/freenet/node

2007-09-22 Thread toad
Author: toad
Date: 2007-09-22 16:30:08 + (Sat, 22 Sep 2007)
New Revision: 15271

Modified:
   trunk/freenet/src/freenet/node/PeerNode.java
Log:
More detailed javadocs for completedHandshake()

Modified: trunk/freenet/src/freenet/node/PeerNode.java
===
--- trunk/freenet/src/freenet/node/PeerNode.java2007-09-22 15:42:00 UTC 
(rev 15270)
+++ trunk/freenet/src/freenet/node/PeerNode.java2007-09-22 16:30:08 UTC 
(rev 15271)
@@ -1388,7 +1388,18 @@
 /**
  * Called when we have completed a handshake, and have a new session key.
  * Creates a new tracker and demotes the old one. Deletes the old one if
- * the bootID isn't recognized.
+ * the bootID isn't recognized, since if the node has restarted we cannot
+ * recover old messages. In more detail:
+ * 
+ * Process the new noderef (check if it's valid, pick up any new 
information etc).
+ * Handle version conflicts (if the node is too old, or we are too 
old, we mark it as 
+ * non-routable, but some messages will still be exchanged e.g. Update 
Over Mandatory stuff).
+ * Deal with key trackers (if we just got message 4, the new key 
tracker becomes current; 
+ * if we just got message 3, it's possible that our message 4 will be lost 
in transit, so we 
+ * make the new tracker unverified. It will be promoted to current if we 
get a packet on it..
+ * if the node has restarted, we dump the old key trackers, otherwise 
current becomes previous).
+ * Complete the connection process: update the node's status, send 
initial messages, update
+ * the last-received-packet timestamp, etc.
  * @param thisBootID The boot ID of the peer we have just connected to.
  * This is simply a random number regenerated on every startup of the node.
  * We use it to determine whether the node has restarted since we last saw 

___
cvs mailing list
[email protected]
http://emu.freenetproject.org/cgi-bin/mailman/listinfo/cvs