Difference between revisions of "Ed2k link"

From AMule Project FAQ
Jump to: navigation, search
m (Reverted edit of Xaignar, changed back to last version by DeltaHF)
(Add info that aMule doesn't support http URLs in ED2K links)
 
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
<center>
 +
'''English''' |
 +
[[Ed2k_link-de|Deutsch]] |
 +
[[Ed2k_link-it|Italiano]]
 +
</center>
 +
 
== [[FAQ_eD2k-Kademlia|eD2k]] links ==
 
== [[FAQ_eD2k-Kademlia|eD2k]] links ==
  
Line 11: Line 17:
 
This are the meanings of each field:
 
This are the meanings of each field:
  
−
*''ed2k://'' -> This is the protocol handler. It shows that the link refers to an [[FAQ_eD2k-Kademlia|eD2k]] file.
+
*''ed2k://'' -&gt; This is the protocol handler. It shows that the link refers to an [[FAQ_eD2k-Kademlia|eD2k]] file.
−
*TYPE -> This indicates the kind of link it is. It's value might be ''file'' when it refers to a file, or ''server'' when it refers to a server.
+
*TYPE -&gt; This indicates the kind of link it is. Its value might be ''file'' when it refers to a file, or ''server'' when it refers to a server.
−
*REST-OF-FIELDS -> This fields will depend on the type of link it is (describbed below).
+
*REST-OF-FIELDS -&gt; This fields will depend on the type of link it is (described below).
  
−
== File links ==
+
== [[File]] links ==
  
 
This links add a file to your download list.
 
This links add a file to your download list.
Line 23: Line 29:
 
''ed2k://|file|NAME|SIZE|[[MD4_hash|MD4-HASH]]|/''
 
''ed2k://|file|NAME|SIZE|[[MD4_hash|MD4-HASH]]|/''
  
−
*NAME -> This will contain the name of the file the link is refering to.
+
*NAME -&gt; This will contain the name of the file the link is refering to.
−
*SIZE -> This field contains the size of the file in bytes.
+
*SIZE -&gt; This field contains the size of the file in bytes.
−
*[[MD4_hash|MD4-HASH]] -> This field contains the [[MD4_hash|MD4-Hash]] of the file.
+
*[[MD4_hash|MD4-HASH]] -&gt; This field contains the [[MD4_hash|MD4-Hash]] of the file.
 +
 
 +
Aditionally, some other fields can be added after the [[MD4_hash|MD4-HASH]] field. Here are some (these fields are extensible depending on the client you are using):
 +
*PartHashes -&gt; It will show the [[MD4_hash|MD4 hash]] of each [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] in the file. It's format is ''p='''hash1''':'''hash2''':'''hash3''''' with as many hashes as the file needs.
 +
*Sources -&gt; It informs about possible known [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] of the file. It's format is "''sources,'''IP:Port''','''IP:Port''','''IP:Port'''''" with as many sources as desired. Note that a hostname may be specified instead of an IP address. Also note that that source fields differ from other types of fields, see the syntax in the example below.
 +
*URLs -&gt; It may happen that the file in the link can be downloaded from some URL. In such cases, it can be told in the link by putting a field like ''s=URL'' and if more than one URL must be written, each will be indicated in a separate field. (aMule does not support this feature and silently ignores the URL.)
 +
*Root Hash -&gt; The [[Root Hash]] of the file (please read about [[AICH]] to know what a [[Root Hash]] is) may be specified in the link by putting a filed like ''h=RootHash''
  
−
Adittionally, some other fields can be added after the [[MD4_hash|MD4-HASH]] field. Here are some (this fields are extensible depending on the client you are using):
+
Examples:
−
*PartHashes -> It will show the [[MD4_hash|MD4 hash]] of each [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] in the file. It's format is ''p='''hash1''':'''hash2''':'''hash3''''' with as many hashes as the file needs.
+
''ed2k://|file|NAME|SIZE|[[MD4_hash|MD4-HASH]]|p=HASH1:HASH2:...|/''
−
*Sources -> It informs about possible known [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] of the file. It's format is ''sources,'''source1-IP''':'''source1-Port''','''source2-IP''':'''source2-Port''','''source3-IP''':'''source3-Port''''' with as many sources as desired.
+
''ed2k://|file|NAME|SIZE|[[MD4_hash|MD4-HASH]]|h=HASH|/''
−
*URLs -> It may happen that the file in the link can be downloaded from some URL. In such cases, it can be told in the link by putting a field like ''s=URL'' and if more than one URL must be written, each will be indicated in a separate field.
+
''ed2k://|file|NAME|SIZE|[[MD4_hash|MD4-HASH]]|/|sources,&lt;IP:Port&gt;,&lt;IP:Port&gt;,...|/''
−
*Root Hash -> The [[Root Hash]] of the file (please read about [[AICH]] to know what a [[Root Hash]] is) may be specified in the link by putting a filed like ''h=RootHash''
+
  
 
== Server links ==
 
== Server links ==
Line 41: Line 52:
 
''ed2k://|server|IP|PORT|/''
 
''ed2k://|server|IP|PORT|/''
  
−
*IP -> IP of the server to connect to.
+
*IP -&gt; IP of the server to connect to.
−
*PORT -> Port where the server is listening for incomming [[FAQ_eD2k-Kademlia|eD2k]] connections
+
*PORT -&gt; Port where the server is listening for incomming [[FAQ_eD2k-Kademlia|eD2k]] connections
  
 
== Serverlist links ==
 
== Serverlist links ==
  
−
This links add a whole serverlist to your current serverlist if you had one. It will just be used as your serverlist if you had no preious serverlist.
+
This links add a whole serverlist to your current serverlist if you had one. It will just be used as your serverlist if you had no previous serverlist.
  
 
They have the follwing format:
 
They have the follwing format:
Line 52: Line 63:
 
''ed2k://|serverlist|ADDRESS|/''
 
''ed2k://|serverlist|ADDRESS|/''
  
−
*ADDRESS -> Full address to the serverlist file (including the serverlist's filename).
+
*ADDRESS -&gt; Full address to the serverlist file (including the serverlist's filename).

Latest revision as of 22:28, 4 January 2012

English | Deutsch | Italiano

eD2k links

eD2k links are links which refer to some file or server in the eD2k network.

They have the follwing format:

ed2k://|TYPE|REST-OF-FIELDS|/

Note that each field is separated from the others by a pipe character (|).

This are the meanings of each field:

  • ed2k:// -> This is the protocol handler. It shows that the link refers to an eD2k file.
  • TYPE -> This indicates the kind of link it is. Its value might be file when it refers to a file, or server when it refers to a server.
  • REST-OF-FIELDS -> This fields will depend on the type of link it is (described below).

File links

This links add a file to your download list.

They have the follwing format:

ed2k://|file|NAME|SIZE|MD4-HASH|/

  • NAME -> This will contain the name of the file the link is refering to.
  • SIZE -> This field contains the size of the file in bytes.
  • MD4-HASH -> This field contains the MD4-Hash of the file.

Aditionally, some other fields can be added after the MD4-HASH field. Here are some (these fields are extensible depending on the client you are using):

  • PartHashes -> It will show the MD4 hash of each chunk in the file. It's format is p=hash1:hash2:hash3 with as many hashes as the file needs.
  • Sources -> It informs about possible known sources of the file. It's format is "sources,IP:Port,IP:Port,IP:Port" with as many sources as desired. Note that a hostname may be specified instead of an IP address. Also note that that source fields differ from other types of fields, see the syntax in the example below.
  • URLs -> It may happen that the file in the link can be downloaded from some URL. In such cases, it can be told in the link by putting a field like s=URL and if more than one URL must be written, each will be indicated in a separate field. (aMule does not support this feature and silently ignores the URL.)
  • Root Hash -> The Root Hash of the file (please read about AICH to know what a Root Hash is) may be specified in the link by putting a filed like h=RootHash

Examples: 

ed2k://|file|NAME|SIZE|MD4-HASH|p=HASH1:HASH2:...|/
ed2k://|file|NAME|SIZE|MD4-HASH|h=HASH|/
ed2k://|file|NAME|SIZE|MD4-HASH|/|sources,<IP:Port>,<IP:Port>,...|/

Server links

This links add a server (the specified server in the server link) to your serverlist.

They have the follwing format:

ed2k://|server|IP|PORT|/

  • IP -> IP of the server to connect to.
  • PORT -> Port where the server is listening for incomming eD2k connections

Serverlist links

This links add a whole serverlist to your current serverlist if you had one. It will just be used as your serverlist if you had no previous serverlist.

They have the follwing format:

ed2k://|serverlist|ADDRESS|/

  • ADDRESS -> Full address to the serverlist file (including the serverlist's filename).
Retrieved from "http://wiki.amule.org/w/index.php?title=Ed2k_link&oldid=28410"