lbt/I2P_Website
1
0
Fork 0
forked from I2P_Developers/i2p.www
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Blockfile spec: Add missing info for version 4 format

Browse Source
This commit is contained in:
zzz
2019-11-20 13:36:09 +00:00
parent 82dcd04670
commit d9c2d173e9
1 changed files with 28 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
i2p2www/spec/blockfile.rst
View File

@@ -2,8 +2,8 @@
Blockfile and Hosts Database Specification Blockfile and Hosts Database Specification
========================================== ==========================================
.. meta:: .. meta::
:lastupdated: November 2014 :lastupdated: November 2019
:accuratefor: 0.9.17 :accuratefor: 0.9.43
.. contents:: .. contents::
@@ -172,10 +172,10 @@ Properties Skiplist
entries containing only one entry: entries containing only one entry:
info info
a Properties (UTF-9 String/String Map), serialized as a [Mapping]_: a Properties (UTF-8 String/String Map), serialized as a [Mapping]_:
version version
"3" "4"
created created
Java long time (ms) Java long time (ms)
@@ -211,12 +211,25 @@ hosts.txt, userhosts.txt, and privatehosts.txt Skiplists
-------------------------------------------------------- --------------------------------------------------------
For each host database, there is a skiplist containing the hosts for that For each host database, there is a skiplist containing the hosts for that
database. The keys/values in these skiplists are as follows: database. Note that the version 4 format supports multiple Destinations
per hostname. This format was introduced in I2P release 0.9.26.
Version 3 databases are automatically migrated to verrsion 4.
The keys/values in these skiplists are as follows:
key key
a UTF-8 String (the hostname) a UTF-8 String (the hostname)
value value
Database version 4:
A DestEntry, which is:
A one-byte number of Properties/Destination pairs to follow
That number of pairs of:
A Properties (a UTF-8 String/String Map)
serialized as a [Mapping]_ followed by a binary [Destination]_
(serialized as usual).
Database version 3:
a DestEntry, which is a Properties (a UTF-8 String/String Map) a DestEntry, which is a Properties (a UTF-8 String/String Map)
serialized as a [Mapping]_ followed by a binary [Destination]_ serialized as a [Mapping]_ followed by a binary [Destination]_
(serialized as usual). (serialized as usual).
@@ -226,10 +239,20 @@ The DestEntry Properties typically contains:
"a" "a"
The time added (Java long time in ms) The time added (Java long time in ms)
"a"
The time added (Java long time in ms)
"notes"
User-supplied comments
"s" "s"
The original source of the entry (typically a file name or subscription The original source of the entry (typically a file name or subscription
URL) URL)
"v"
If the signature of the entry was verified, "true" or "false"
Hostname keys are stored in lower-case and always end in ".i2p". Hostname keys are stored in lower-case and always end in ".i2p".