Bencode
From Wikipedia, the free encyclopedia
Bencode bzw. als Verb bencoding ist ein Datenaustauschformat, welches für das Filesharing-Protokoll BitTorrent entwickelt wurde.[1] Es verwendet eine effiziente, ASCII-basierte Kodierung, kann aber Binärdaten enthalten. Insofern ist Bencode anders als Formate wie XML, JSON oder YAML nicht grundsätzlich menschenlesbar. Das Format unterstützt vier Datentypen: Ganze Zahlen, Zeichenketten variabler Länge, Listen und assoziative Listen.[2]
| Metainfo | |
|---|---|
| Dateiendung: | .torrent |
| Entwickelt von: | Bram Cohen, BitTorrent-Entwickler |
| Erstveröffentlichung: | 2001 |
| Art: | Tracker-Information zum Abruf von Dateien über das BitTorrent-Netzwerk |
| Standard(s): | BEP 3 |
| https://www.bittorrent.org/beps/bep_0003.html | |
Bencode wird unter anderem in .torrent-Dateien (offiziell Metainfo-Dateien) verwendet.
Bencode ist ein recht einfaches Format mit einer strikten Definition. Für jeden Datensatz gibt es nur eine gültige Darstellung in Bencode. Dies vereinfacht das Parsing und die Implementierung. Allerdings wird zum Bearbeiten ein spezialisierter Editor benötigt, da Texteditoren wegen enthaltener Binärdaten im Allgemeinen nicht zur Bearbeitung geeignet sind.
Format
Zahlen
Zahlen werden als i<zahl>e codiert. Dabei ist <zahl> die dezimale ASCII-Darstellung der Zahl. Negative Zahlen werden wie üblich mit einem vorangestellten Bindestrich (ASCII-Zeichen 45) ausgegeben. Bencode unterstützt nur ganze Zahlen.
| Zahl | Bencode |
|---|---|
| −234 | i-234e |
| 0 | i0e |
| 29410 | i29410e |
Zeichenketten
Zeichenketten werden als <länge>:<inhalt> ausgegeben. Dabei ist <länge> die Länge, zur Basis 10, und <inhalt> die Zeichenkette an sich. Leere Zeichenketten werden mit der Länge Null ausgegeben. Zeichenketten haben keinen definierten Zeichensatz und können auch binäre Daten enthalten. In Metainfo-Dateien sind alle Texte UTF-8-kodiert.
| Zeichenkette | Bencode |
|---|---|
| (leere Zeichenkette) | 0: |
| Hallo Welt | 10:Hallo Welt |
Listen
Listen werden als l<inhalt>e ausgegeben. <inhalt> besteht aus den aneinandergereihten, bencodeten Elementen der Liste. Eine Liste kann eine Mischung unterschiedlicher Datentypen beinhalten (z. B. sowohl Zahlen als auch Zeichenketten). Eine leere Liste hat die Darstellung le.
| Liste | Bencode |
|---|---|
| [] | le |
| [595] | li595ee |
| [Hallo] | l5:Halloe |
| [-343, Hallo, 555, [], [5]] | li-343e5:Halloi555eleli5eee |
Assoziative Listen
Assoziative Listen (dictionaries) werden, ähnlich wie normale Listen, in der Form d<inhalt>e ausgegeben. Dabei besteht der Inhalt aus aneinandergereihten Schlüssel-Wert-Paaren. Die Paare müssen in lexikographischer Ordnung aufgeführt sein, womit die Darstellung jeder assoziativen Liste eindeutig ist. Eine leere assoziative Liste wird als de ausgegeben.
| Assoziative Liste | Bencode |
|---|---|
| {} | de |
| {Name => Thomas, Alter => 34} | d5:Alteri34e4:Name6:Thomase |
Weblinks
- Spezifikation von Bencode als Teil der BitTorrent-Spezifikation (Abschnitt „bencoding“)
- Torrent File Editor, ein Open-Source-Bearbeitungsprogramm für Bencode-Daten