The eMule Protocol Specification

The eMule Protocol Speciﬁcation

Yoram Kulbak and Danny Bickson

Email:

{

yorkol,daniel51

}

@cs.huji.ac.il

Academic supervisor: Prof. Scott KirkpatrickDANSS (Distributed Algorithms, Networking and Secure Systems) LabSchool of Computer Science and EngineeringThe Hebrew University of Jerusalem, IsraelJanuary 20, 2005

http://www.cs.huji.ac.il/labs/danss/p2p/eMule/

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the FreeSoftware Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-CoverTexts. A copy of the license is included in the section entitle ”GNU Free DocumentationLicense”.1

Contents

1 Introduction5

1.1 Purpose and scope. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2.1 Client to server connection. . . . . . . . . . . . . . . . . . . . . . . . 51.2.2 Client to client connection. . . . . . . . . . . . . . . . . . . . . . . . . 71.3 Client ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.4 User ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.5 File ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.5.1 File hash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.5.2 Root hash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.6 eMule protocol extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.7 Soft and hard limits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2 Client server TCP Communication10

2.1 Connection establishment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.2 Connection startup message exchange. . . . . . . . . . . . . . . . . . . . . . 122.3 File search. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.4 Callback mechanism. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

3 Client server UDP Communication15

3.1 Server keep alive and status information. . . . . . . . . . . . . . . . . . . . . 153.2 Enhanced ﬁle search. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.3 Enhanced ﬁle-source searches. . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4 Client to Client TCP Communication17

4.1 Initial handshake. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174.2 Secure user identiﬁcation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184.2.1 The credit system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184.3 Requesting ﬁles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.3.1 Basic message exchange. . . . . . . . . . . . . . . . . . . . . . . . . . 194.3.2 File not found scenario. . . . . . . . . . . . . . . . . . . . . . . . . . . 194.3.3 Enlisting to the upload queue. . . . . . . . . . . . . . . . . . . . . . . 204.3.4 Upload queue management. . . . . . . . . . . . . . . . . . . . . . . . 204.3.5 Reaching the top of the upload queue. . . . . . . . . . . . . . . . . . 214.4 Data transfer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.4.1 The data packet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Category:	Research > Math & Engineering
Rating:	(2 Ratings)
Upload Date:	02/28/2008
Copyright:	Attribution Non-commercial
Tags:	Specification emule protocol Specification emule protocol (fewer)

Documents

People