github
/
aria2
mirror of https://github.com/aria2/aria2
1
0
Fork 0
Code Issues Releases Wiki Activity

Fixed markup

pull/25/merge
Tatsuhiro Tsujikawa 2012-08-11 21:17:03 +09:00
parent 8f1049c15f
commit 27e44439ea
1 changed files with 0 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
doc/manual-src/en/technical-notes.rst
View File

@ -36,7 +36,6 @@ a download. Here is the diagram for each field::
Repeated in (NUM IN-FLIGHT) PIECE times Repeated in (NUM IN-FLIGHT) PIECE times
``VER`` (VERSION): 2 bytes ``VER`` (VERSION): 2 bytes
Should be either version 0(0x0000) or version 1(0x0001). In Should be either version 0(0x0000) or version 1(0x0001). In
version 1, all multi-byte integers are saved in network byte version 1, all multi-byte integers are saved in network byte
order(big endian). In version 0, all multi-byte integers are saved order(big endian). In version 0, all multi-byte integers are saved
@ -45,45 +44,36 @@ a download. Here is the diagram for each field::
be disappear in the future version. be disappear in the future version.
``EXT`` (EXTENSION): 4 bytes ``EXT`` (EXTENSION): 4 bytes
If LSB is 1(i.e. ``EXT[3]&1 == 1``), aria2 checks whether the saved If LSB is 1(i.e. ``EXT[3]&1 == 1``), aria2 checks whether the saved
!InfoHash and current downloading one are the same. If they are not !InfoHash and current downloading one are the same. If they are not
the same, an exception is thrown. This is called "infoHashCheck" the same, an exception is thrown. This is called "infoHashCheck"
extension. extension.
``INFO HASH LENGTH``: 4 bytes ``INFO HASH LENGTH``: 4 bytes
The length of InfoHash that is located after this field. If The length of InfoHash that is located after this field. If
"infoHashCheck" extension is enabled, if this value is 0, then an "infoHashCheck" extension is enabled, if this value is 0, then an
exception is thrown. For http/ftp downloads, this value should be exception is thrown. For http/ftp downloads, this value should be
0. 0.
``INFO HASH``: ``(INFO HASH LENGTH)`` bytes ``INFO HASH``: ``(INFO HASH LENGTH)`` bytes
BitTorrent InfoHash. BitTorrent InfoHash.
``PIECE LENGTH``: 4 bytes ``PIECE LENGTH``: 4 bytes
The length of the piece. The length of the piece.
``TOTAL LENGTH``: 8 bytes ``TOTAL LENGTH``: 8 bytes
The total length of the download. The total length of the download.
``UPLOAD LENGTH``: 8 bytes ``UPLOAD LENGTH``: 8 bytes
The uploaded length in this download. The uploaded length in this download.
``BITFIELD LENGTH``: 4 bytes ``BITFIELD LENGTH``: 4 bytes
The length of bitfield. The length of bitfield.
``BITFIELD``: ``(BITFIELD LENGTH)`` bytes ``BITFIELD``: ``(BITFIELD LENGTH)`` bytes
This is the bitfield which represents current download progress. This is the bitfield which represents current download progress.
``NUM IN-FLIGHT PIECE``: 4 bytes ``NUM IN-FLIGHT PIECE``: 4 bytes
The number of in-flight pieces. These piece is not marked The number of in-flight pieces. These piece is not marked
'downloaded' in the bitfield, but it has at least one downloaded 'downloaded' in the bitfield, but it has at least one downloaded
chunk. chunk.
@ -92,19 +82,15 @@ The following 4 fields are repeated in ``(NUM IN-FLIGHT PIECE)``
times. times.
``INDEX``: 4 bytes ``INDEX``: 4 bytes
The index of the piece. The index of the piece.
``LENGTH``: 4 bytes ``LENGTH``: 4 bytes
The length of the piece. The length of the piece.
``PIECE BITFIELD LENGTH``: 4 bytes ``PIECE BITFIELD LENGTH``: 4 bytes
The length of bitfield of this piece. The length of bitfield of this piece.
``PIECE BITFIELD``: ``(PIECE BITFIELD LENGTH)`` bytes ``PIECE BITFIELD``: ``(PIECE BITFIELD LENGTH)`` bytes
The bitfield of this piece. The each bit represents 16KiB chunk. The bitfield of this piece. The each bit represents 16KiB chunk.
DHT routing table file format DHT routing table file format
@ -140,28 +126,22 @@ they should be all zeros::
(NUM NODE) times. (NUM NODE) times.
``MGC`` (MAGIC): 2 bytes ``MGC`` (MAGIC): 2 bytes
It must be ``0xa1 0xa2``. It must be ``0xa1 0xa2``.
``FMT`` (FORMAT ID): 1 byte ``FMT`` (FORMAT ID): 1 byte
The format ID should be ``0x02``. The format ID should be ``0x02``.
``VER`` (VERSION): 2 bytes ``VER`` (VERSION): 2 bytes
The version number should be ``0x00 0x03``. The version number should be ``0x00 0x03``.
``MTIME``: 8 bytes ``MTIME``: 8 bytes
This is the time when aria2 saved the file. The value is the time This is the time when aria2 saved the file. The value is the time
since the Epoch(1970/1/1 00:00:00) in 64 bits integer. since the Epoch(1970/1/1 00:00:00) in 64 bits integer.
``LOCALNODE ID``: 20 bytes ``LOCALNODE ID``: 20 bytes
Node ID of the client. Node ID of the client.
``NUM NODE``: 4 bytes ``NUM NODE``: 4 bytes
The number of nodes the routing table has. ``NUM NODE`` node The number of nodes the routing table has. ``NUM NODE`` node
information follows. information follows.
@ -170,14 +150,11 @@ stored in the following fields. They are repeated in ``NUM NODE``
times. times.
``PLEN`` (COMPACT PEER INFO LENGTH): 1 byte ``PLEN`` (COMPACT PEER INFO LENGTH): 1 byte
The length of compact peer info. For IPv4 DHT, it must be 6. For The length of compact peer info. For IPv4 DHT, it must be 6. For
IPv6 DHT, it must be 18. IPv6 DHT, it must be 18.
``COMPACT PEER INFO``: ``(PLEN)`` bytes ``COMPACT PEER INFO``: ``(PLEN)`` bytes
The address and port of peer in compact peer format. The address and port of peer in compact peer format.
``NODE ID``: 20 bytes ``NODE ID``: 20 bytes
The node ID of this node. The node ID of this node.