Fichier Torrent: Difference between revisions

Revision as of 19:52, 31 March 2014

Un fichier torrent stocke les métadonnée utilisées pour BitTorrent. Il est défini dans les spécifications de BitTorrent. Lors d'un téléchargement classique sur Internet, un fichier (ou groupe de fichiers) est transmis d'un ordinateur (généralement un serveur) à un autre ordinateur (un client). Les données sont conservées dans un emplacement centralisé et est récupéré à la demande d'un seul utilisateur.

Un fichier torrent contient les adresses internet (URL) de multiples trackers et l'intégrité des métadonnée de toutes les pièces composant le téléchargement. Il peut également contenir des métadonnées supplémentaires définis dans les extensions de la spécification BitTorrent. Connus sous l'appellation "BitTorrent Enhancement Proposals" (Propositions Accessoires BitTorrent). Par exemple une de ces propositions de métadonnée accessoire est d'indiquer qui a créé le torrent et quand...

Structure du fichier

Un fichier torrent est un dictionnaire bencode avec les clés suivantes :

announce - L'adresse du tracker
info - cela correspond à un dictionnaire dont les clés sont à charge si un ou plusieurs fichiers sont partagés:
- name - suggère le nom de répertoire où le(s) fichier(s) doit/doivent être sauvé
- piece length - Nombre d’octet par morceaux. Cela est communément <math>2^{18}</math> = 256Kio = 262144B.
- pieces - concaténation de chaque pièce du hache SHA-1. Si SHA-1 retourne un hache de 160-bit, pieces sera une chaîne dont la longueur est un multiple de 160-bits
- length - Taille du fichier (en octet) seulement quand un seul fichier est partagé.
- files - une liste de dictionnaires (chaque dictionnaire correspond à un fichier) avec les clés suivantes :
  - path - une liste de chaînes correspondant à des noms de sous-répertoires, dont le dernier est le nom du fichier
  - length - Taille du fichier (en octet).

Toutes les chaînes doivent être codées en UTF-8.

Examples

Torrent à un seul fichier

Voici un fichier torrent de-bencoded avec piece length 256Kio = 262144 octets pour un fichier debian-503-amd64-CD-1.iso dont la taille est 647 Mio = 678301696 octet) :

{'announce': 'http://bttracker.debian.org:6969/announce'
'info': {'name': 'debian-503-amd64-CD-1.iso',
'piece length': 262144,
'length': 678301696,
'pieces': '841ae846bc5b6d7bd6e9aa3dd9e551559c82abc1 ... d14f1631d776008f83772ee170c42411618190a4'
}
}

Remarque : pieces est ici un plafond(length/piece length) * 160-bit = plafond(678301696/262144) * 160-bit = plafond(2587.515625) * 160-bit = 2588 * 160-bit = 414080-bit = 51Kio.

Torrent à fichiers Multiples

Voici un fichier torrent de-bencoded avec piece length 256Kio = 262144) pour deux fichiers : 111.txt & 222.txt :

{'announce': 'http://tracker.site1.com/announce',
'info: {'name': 'directoryName',
'piece length': 262144,
'files': [ {'path': '111.txt', 'length': 111},
{'path': '222.txt', 'length': 222}
],
'pieces': '6a8af7eda90ba9f851831073c48ea6b7b7e9feeb...8a43d9d965a47f75488d3fb47d2c586337a20b9f'
}
}

References

http://en.wikipedia.org/wiki/Torrent_file

@@ Line 1: / Line 1: @@
 Un '''fichier torrent''' stocke les [[metadata/fr|métadonnée]] utilisées pour [[BitTorrent/fr|BitTorrent]]. Il est défini dans les spécifications de BitTorrent. Lors d'un téléchargement classique sur Internet, un fichier (ou groupe de fichiers) est transmis d'un ordinateur (généralement un serveur) à un autre ordinateur (un client). Les données sont conservées dans un emplacement centralisé et est récupéré à la demande d'un seul utilisateur.
-BitTorrent distribue les données différemment à plusieurs niveaux. Tout d'abord, un fichier *.torrent qui n'est pas le véritable fichier que l'on souhaite télécharger. Le fichier torrent est simplement un fichier de données qui contient les informations sur le fichier que l'on souhaite télécharger. Le torrent divise le fichier cible en une série de morceaux de dimensions égales qui sont affectés une somme de contrôle d'identification.
+Un fichier torrent contient les adresses  internet (URL) de multiples [[BitTorrent/fr#Vocabulaire|trackers]] et l'intégrité des [[metadata/fr|métadonnée]] de toutes les pièces composant le téléchargement. Il peut également contenir des métadonnées supplémentaires définis dans les extensions de la spécification BitTorrent. Connus sous l'appellation "''BitTorrent Enhancement Proposals''" (Propositions Accessoires BitTorrent). Par exemple une de ces propositions de métadonnée accessoire est d'indiquer qui a créé le torrent et quand...
-Le transfert du fichier torrent se fait entre différents et nombreux pairs.
+==Structure du fichier==
+Un fichier torrent est un dictionnaire [http://fr.wikipedia.org/wiki/Bencode bencode] avec les clés suivantes :
-Plutôt que les données transférées d'une machine à l'autre, les diverses pièces du dossier sont tenues sur plusieurs ordinateurs différents. Le client torrent communiquer avec d'autres pairs afin de vérifier quelles pièces ils disposent et les échanges pour ceux dont ils ont besoin. De cette façon, le transfert de fichiers via un torrent est un peu comme un éclair rapide, jeu numérique automatisé de "Go Fish". Pairs échangent des morceaux de fichiers avec autant d'ordinateurs différents que possible et, éventuellement, de combiner les différentes parties dans l'ensemble, la demande de fichier.
+* '''<tt>announce</tt>''' - L'adresse du tracker
+* '''<tt>info</tt>''' - cela correspond à un dictionnaire dont les clés sont à charge si un ou plusieurs fichiers sont partagés:
+** '''<tt>name</tt>''' - suggère le nom de répertoire où le(s) fichier(s) doit/doivent être sauvé
+** '''<tt>piece length</tt>''' - Nombre d’octet par morceaux. Cela est communément <math>2^{18}</math> = 256Kio = 262144B.
+** '''<tt>pieces</tt>''' - concaténation de chaque pièce du hache [http://fr.wikipedia.org/wiki/SHA-1 SHA-1]. Si SHA-1 retourne un hache de 160-bit, '''<tt>pieces</tt>''' sera une chaîne dont la longueur est un multiple de 160-bits
+** '''<tt>length</tt>''' - Taille du fichier (en octet) seulement quand un seul fichier est partagé.
+** '''<tt>files</tt>''' - une liste de dictionnaires (chaque dictionnaire correspond à un fichier) avec les clés suivantes :
+*** '''<tt>path</tt>''' - une liste de chaînes correspondant à des noms de sous-répertoires, dont le dernier est le nom du fichier
+*** '''<tt>length</tt>''' - Taille du fichier (en octet).
+Toutes les chaînes doivent être codées en UTF-8.
-The transfer of the torrent file is done between many different peers. Rather than the data being transferred from one machine to the next, the various pieces of the file are held on many different computers. The torrent client communicate with other peers in order to check which pieces they have and exchanges them for the ones they need. In this way, transferring files via a torrent is sort of like a lightning fast, digitally automated game of "Go Fish." Peers swap pieces of files with as many different computers as possible and eventually combine the various parts into the whole, requested file.
+==Examples==
-A torrent file contains the URLs of multiple [[BitTorrent tracker|trackers]] and integrity metadata about all the pieces. It can also contain additional metadata defined in extensions to the BitTorrent specification.<ref>{{cite web|url=http://www.bittorrent.org/beps/bep_0000.html |title=BEP-0000: Index of BitTorrent Enhancement Proposals |publisher=Bittorrent.org |date= |accessdate=2009-10-22}}</ref> These are known as "BitTorrent Enhancement Proposals". Examples of such proposals include metadata for stating who created the torrent, and when.
-==File structure==
-A torrent file is a [[bencode]]d dictionary with the following keys:
-* <tt>announce</tt> - the URL of the tracker
-* <tt>info</tt> - this maps to a dictionary whose keys are dependent on whether one or more files are being shared:
-** <tt>name</tt> - suggested file/directory name where the file(s) is/are to be saved
-** <tt>piece length</tt> - number of bytes per piece. This is commonly <math>2^{18}</math> = 256KiB = 262144B.
-** <tt>pieces</tt> - concatenation of each piece's [[SHA-1]] hash. As SHA-1 returns a 160-bit hash, <tt>pieces</tt> will be a string whose length is a multiple of 160-bits.
-And exactly one of <tt>length</tt> (corresponds to when only one file is being shared) or <tt>files</tt> (corresponds to when multiple files are being shared):
-** <tt>length</tt> - size of the file (in bytes)
-** <tt>files</tt> - a list of dictionaries (each dictionary corresponds to a file) with the following keys:
-*** <tt>path</tt> - a list of strings corresponding to subdirectory names, the last of which is the actual file name
-*** <tt>length</tt> - size of the file (in bytes).
-All strings must be UTF-8 encoded.
-==Extensions==
-===Draft extensions===
-These [[extensions]] are under consideration for standardization.
-====Distributed hash tables====
-BEP-0005<ref>{{cite web|url=http://www.bittorrent.org/beps/bep_0005.html |title=BEP-0005: DHT Protocol |publisher=Bittorrent.org |date= |accessdate=2009-10-22}}</ref> extends BitTorrent to support [[distributed hash table]]s.
-A trackerless torrent dictionary does not have an <tt>announce</tt> key. Instead, a trackerless torrent has a <tt>nodes</tt> key:
- {
- ...
- 'nodes': [["<host>", <port>], ["<host>", <port>], ...]
- ...
- }
-For example,
- 'nodes': [["127.0.0.1", 6881], ["your.router.node", 4804]]
-The specification recommends that <tt>nodes</tt> "should be set to the K closest nodes in the torrent generating client's routing table. Alternatively, the key could be set to a known good node such as one operated by the person generating the torrent."
-====Multiple trackers====
-BEP-0012<ref>{{cite web|url=http://www.bittorrent.org/beps/bep_0012.html |title=BEP-0012: Multitracker Metadata Extension |publisher=Bittorrent.org |date= |accessdate=2009-10-22}}</ref> extends BitTorrent to support multiple trackers.
-A new key, <tt>announce-list</tt>, is placed in the top-most list (i.e. with <tt>announce</tt> and <tt>info</tt>). This key's value is a list of tracker "tiers". Each tier is a list of URLs:
- {
- ...
- 'announce-list': [["<nowiki>http://tracker.site1.com/announce</nowiki>"], ["<nowiki>http://tracker.site2.com/announce</nowiki>"]]
- ...
- }
-====HTTP seeds====
-BEP-0017<ref>{{cite web|url=http://www.bittorrent.org/beps/bep_0017.html |title=BEP-0017: HTTP Seeding |publisher=Bittorrent.org |date= |accessdate=2009-10-22}}</ref> extends BitTorrent to support HTTP seeds.
-A new key, <tt>httpseeds</tt>, is placed in the top-most list (i.e. with <tt>announce</tt> and <tt>info</tt>). This key's value is a list of web addresses where torrent data can be retrieved:
- {
- ...
- 'httpseeds': ['<nowiki>http://www.site1.com/source1.php</nowiki>', '<nowiki>http://www.site2.com/source2.php</nowiki>']
- ...
- }
-====Private torrents====
-BEP-0027<ref>{{cite web|url=http://www.bittorrent.org/beps/bep_0027.html |title=BEP-0027: Private Torrents |publisher=Bittorrent.org |date= |accessdate=2009-10-22}}</ref> extends BitTorrent to support private torrents.
-A new key, <tt>private</tt>, is placed in the <tt>info</tt> dictionary. This key's value is 1 if the torrent is private:
- {
- ...
- 'private': 1
- ...
- }
-====Merkle trees====
-BEP-0030<ref>{{cite web|url=http://www.bittorrent.org/beps/bep_0030.html |title=BEP-0030: Merkle hash torrent extension |publisher=Bittorrent.org |date= |accessdate=2009-10-22}}</ref> extends BitTorrent to support [[Merkle trees]].
-A torrent file using Merkle trees does not have a <tt>pieces</tt> key in the <tt>info</tt> list. Instead, such a torrent file has a <tt>root hash</tt> key in the <tt>info</tt> list. This key's value is the root hash of the Merkle hash:
- {
+===Torrent à un seul fichier===
- ...
+Voici un fichier torrent de-bencoded avec <tt>piece length</tt> 256Kio = 262144 octets pour un fichier <tt>debian-503-amd64-CD-1.iso</tt> dont la taille est 647 Mio = 678301696 octet) :
- 'info': {
- ...
- 'root hash': e6bdebcc5d55da0a77f4bb1b57d88de794838577
- ...
- }
- ...
- }
-==Examples==
-===Single file===
-Here is what a de-bencoded torrent file (with <tt>piece length</tt> 256KiB = 262144 bytes) for a file <tt>debian-503-amd64-CD-1.iso</tt> (whose size is 647MiB = 678301696 bytes) might look like:
   {'announce': 'http://bttracker.debian.org:6969/announce'
   'info': {'name': 'debian-503-amd64-CD-1.iso',
@@ Line 102: / Line 30: @@
   }
   }
-Note: <tt>pieces</tt> here would be a ceil(<tt>length</tt>/<tt>piece length</tt>) * 160-bit = ceil(678301696/262144) * 160-bit = ceil(2587.515625) * 160-bit = 2588 * 160-bit = 414080-bit = 51KiB value.
+Remarque : <tt>pieces</tt> est ici un plafond(<tt>length</tt>/<tt>piece length</tt>) * 160-bit = plafond(678301696/262144) * 160-bit = plafond(2587.515625) * 160-bit = 2588 * 160-bit = 414080-bit = 51Kio.
-===Multiple files===
+===Torrent à fichiers Multiples===
-Here is what a de-bencoded torrent file (with <tt>piece length</tt> 256KiB = 262144) for two files, 111.txt & 222.txt, might look like:
+Voici un fichier torrent de-bencoded avec <tt>piece length</tt> 256Kio = 262144) pour deux fichiers : 111.txt & 222.txt :
   {'announce': 'http://tracker.site1.com/announce',
   'info: {'name': 'directoryName',
@@ Line 117: / Line 46: @@
 ==References==
-{{reflist}}
+http://en.wikipedia.org/wiki/Torrent_file
-==External links==
-* [http://www.bittorrent.org/beps/bep_0003.html Official BitTorrent Specification]
-* [http://wiki.theory.org/BitTorrentSpecification#Metainfo_File_Structure Unofficial documentation of BitTorrent and its extensions]
-{{BitTorrent}}