Difference between revisions of "Ed2k link"

From AMule Project FAQ
Jump to: navigation, search
m (wrong links)
m (in vision of porting wiki as aMule docs with tarball, fixing issues)
Line 1: Line 1:
== [[FAQ_eD2k/Kademlia|eD2k]] links ==
+
== [[FAQ_eD2k-Kademlia|eD2k]] links ==
  
[[FAQ_eD2k/Kademlia|eD2k]] links are links which refer to some file or server in the [[FAQ_eD2k/Kademlia|eD2k network]].<br>
+
[[FAQ_eD2k-Kademlia|eD2k]] links are links which refer to some file or server in the [[FAQ_eD2k-Kademlia|eD2k network]].<br>
 
They have the follwing format:
 
They have the follwing format:
  
 
''ed2k://|TYPE|REST-OF-FIELDS/''
 
''ed2k://|TYPE|REST-OF-FIELDS/''
  
Note that eah field is spearated from the others by a pipe characte (''|'').<br>
+
Note that eah field is spearated from the others by a pipe character (''|'').<br>
 
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://'' -> 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 -> 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).
 
*REST-OF-FIELDS -> This fields will depend on the type of link it is (describbed below).
Line 24: Line 24:
  
 
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):
 
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):
*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,'''source1-IP''':source1-Port''','''source2-IP''':source2-Port''','''source3-IP''':'''source3-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,'''source1-IP''':source1-Port''','''source2-IP''':source2-Port''','''source3-IP''':'''source3-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 fild like ''s=URL'' and if more than one URL must be written, each will be indicated in a separate field.
 
*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 fild like ''s=URL'' and if more than one URL must be written, each will be indicated in a separate field.
  
Line 35: Line 35:
  
 
*IP -> IP of the server to connect to.
 
*IP -> IP of the server to connect to.
*PORT -> Port where the server is listening for incomming [[FAQ_eD2k/Kademlia|eD2k]] connections
+
*PORT -> Port where the server is listening for incomming [[FAQ_eD2k-Kademlia|eD2k]] connections

Revision as of 08:07, 6 September 2004

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 eah field is spearated 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

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.

Adittionally, 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,source1-IP:source1-Port,source2-IP:source2-Port,source3-IP:source3-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 fild like s=URL and if more than one URL must be written, each will be indicated in a separate field.

Server links

They have the follwing format:

ed2k://|file|IP|PORT|/

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