Difference between revisions of "Ed2k link"

From AMule Project FAQ
Jump to: navigation, search
(Clarify the "sources" part of file links.)
Line 15: Line 15:
 
*REST-OF-FIELDS -> This fields will depend on the type of link it is (describbed below).
 
*REST-OF-FIELDS -> This fields will depend on the type of link it is (describbed below).
  
== File links ==
+
== [[File]] links ==
  
 
This links add a file to your download list.
 
This links add a file to your download list.
Line 27: Line 27:
 
*[[MD4_hash|MD4-HASH]] -> This field contains the [[MD4_hash|MD4-Hash]] of the file.
 
*[[MD4_hash|MD4-HASH]] -> This field contains the [[MD4_hash|MD4-Hash]] of the file.
  
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):
+
Aditionally, 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):
 
*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.
 
*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.
 
*Sources -> 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.
 
*Sources -> 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.

Revision as of 15:17, 14 November 2005

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. It's 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).

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 (this 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.
  • 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.
  • 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

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 preious serverlist.

They have the follwing format:

ed2k://|serverlist|ADDRESS|/

  • ADDRESS -> Full address to the serverlist file (including the serverlist's filename).