Changeset 3237

Timestamp:

Sep 29, 2007, 11:58:37 PM (15 years ago)

Author:

charles

Message:

update ltep documentation

File:

• trunk/doc/extended-messaging.txt (modified) (3 diffs)

trunk/doc/extended-messaging.txt

@@ -12 +12 @@
 supported and what their extended id will be.  The message payload is
 a bencoded dictionary which may have some of the following keys:
+    e
+        int, 1 or 0. a flag to denote whether the peer prefers
+        encrypted connections.  This is used in ut_pex's "added.f".
+    m
+        dict containing supported extended messages and the extended id used
+    p
+        int, tcp port for incoming peer connections
     v
         string, client name and version.  eg: Transmission 0.7
-    p
-        int, tcp port for incoming peer connections
-    m
-        dict containing supported extended messages and the extended id used
 
 A peer may re-send the handshake message at any time to add new
@@ -23 +26 @@
 their extended id.
 
-µTorrent peer exchange messages use the key ut_pex in the m
-dictionary.  Peer exchanges messages should be sent approximately once
-every minute.  The payload of a peer exchange message is a bencoded
-dictionary with the following keys:
+uTorrent peer exchange messages use the key "ut_pex" in the m
+dictionary.  If the uTorrent peer has pex disabled, this key
+will not be present.  Exchanges messages should be sent approximately
+once every minute.  The payload of a peer exchange message is a
+bencoded dictionary with the following keys:
+
     added
         string, contains peers in the compact tracker format
         (ie: 6 bytes for IPv4 address and port in network byte order)
         added since the last peer exchange message
+
     added.f
         string, one byte of flags for each peer in the above added string.
@@ -36 +42 @@
         0x01 - peer supports encryption
         0x02 - peer is a seed
+
     dropped
         same format as added, contains peers dropped since last peer exchange
+
+In contrast to Azureus' maximum of 50 peers per pex burst, uTorrent will
+hold up to 200.  alus reports: "uT stores max 200 from other peers, but it
+will send everything it has."