Document UDP tracker in manual

pull/57/head
Tatsuhiro Tsujikawa 2013-03-03 18:28:25 +09:00
parent baaa3a4fb2
commit 66a85777ad
3 changed files with 25 additions and 14 deletions

View File

@ -54,7 +54,8 @@ Here is a list of features:
* Persistent Connections support * Persistent Connections support
* FTP through HTTP Proxy * FTP through HTTP Proxy
* Download/Upload speed throttling * Download/Upload speed throttling
* BitTorrent extensions: Fast extension, DHT, PEX, MSE/PSE, Multi-Tracker * BitTorrent extensions: Fast extension, DHT, PEX, MSE/PSE,
Multi-Tracker, UDP tracker
* BitTorrent `WEB-Seeding <http://getright.com/seedtorrent.html>`_. aria2 * BitTorrent `WEB-Seeding <http://getright.com/seedtorrent.html>`_. aria2
requests chunks more than piece size to reduce the request requests chunks more than piece size to reduce the request
overhead. It also supports pipelined requests with piece size. overhead. It also supports pipelined requests with piece size.
@ -365,6 +366,13 @@ for IPv4 DHT is saved to ``$HOME/.aria2/dht.dat`` and the routing
table for IPv6 DHT is saved to ``$HOME/.aria2/dht6.dat``. aria2 uses table for IPv6 DHT is saved to ``$HOME/.aria2/dht6.dat``. aria2 uses
same port number to listen on for both IPv4 and IPv6 DHT. same port number to listen on for both IPv4 and IPv6 DHT.
UDP tracker
~~~~~~~~~~~
UDP tracker support is enabled when IPv4 DHT is enabled. The port
number of UDP tracker is shared with DHT. Use ``--dht-listen-port``
option to change the port number.
Other things should be noted Other things should be noted
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

View File

@ -727,10 +727,10 @@ BitTorrent Specific Options
.. option:: --dht-listen-port=<PORT>... .. option:: --dht-listen-port=<PORT>...
Set UDP listening port for both IPv4 and IPv6 DHT. Set UDP listening port used by DHT(IPv4, IPv6) and UDP tracker.
Multiple ports can be specified by using ``,``, for example: ``6881,6885``. Multiple ports can be specified by using ``,``, for example:
You can also use ``-`` to specify a range: ``6881-6999``. ``,`` and ``-`` can be used ``6881,6885``. You can also use ``-`` to specify a range:
together. ``6881-6999``. ``,`` and ``-`` can be used together.
Default: ``6881-6999`` Default: ``6881-6999``
.. note:: .. note::
@ -743,9 +743,9 @@ BitTorrent Specific Options
.. option:: --enable-dht[=true|false] .. option:: --enable-dht[=true|false]
Enable IPv4 DHT functionality. If a private flag is set in a Enable IPv4 DHT functionality. It also enables UDP tracker
torrent, aria2 doesn't use DHT for that download even if ``true`` is support. If a private flag is set in a torrent, aria2 doesn't use
given. Default: ``true`` DHT for that download even if ``true`` is given. Default: ``true``
.. option:: --enable-dht6[=true|false] .. option:: --enable-dht6[=true|false]

View File

@ -309,13 +309,16 @@
#define TEXT_ENABLE_PEER_EXCHANGE \ #define TEXT_ENABLE_PEER_EXCHANGE \
_(" --enable-peer-exchange[=true|false] Enable Peer Exchange extension.") _(" --enable-peer-exchange[=true|false] Enable Peer Exchange extension.")
#define TEXT_ENABLE_DHT \ #define TEXT_ENABLE_DHT \
_(" --enable-dht[=true|false] Enable IPv4 DHT functionality.") _(" --enable-dht[=true|false] Enable IPv4 DHT functionality. It also enables\n" \
" UDP tracker support. If a private flag is set\n" \
" in a torrent, aria2 doesn't use DHT for that\n" \
" download even if ``true`` is given.")
#define TEXT_DHT_LISTEN_PORT \ #define TEXT_DHT_LISTEN_PORT \
_(" --dht-listen-port=PORT... Set UDP listening port for both IPv4 and IPv6\n" \ _(" --dht-listen-port=PORT... Set UDP listening port used by DHT(IPv4, IPv6)\n" \
" DHT. Multiple ports can be specified by using\n" \ " and UDP tracker. Multiple ports can be specified\n" \
" ',', for example: \"6881,6885\". You can also\n" \ " by using ',', for example: \"6881,6885\". You can\n" \
" use '-' to specify a range: \"6881-6999\". ','\n" \ " also use '-' to specify a range: \"6881-6999\".\n" \
" and '-' can be used together.") " ',' and '-' can be used together.")
#define TEXT_DHT_ENTRY_POINT \ #define TEXT_DHT_ENTRY_POINT \
_(" --dht-entry-point=HOST:PORT Set host and port as an entry point to IPv4 DHT\n" \ _(" --dht-entry-point=HOST:PORT Set host and port as an entry point to IPv4 DHT\n" \
" network.") " network.")