GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::BITTORRENT::DHT (3)

.ds Aq ’

NAME

Net::BitTorrent::DHT - Kademlia based Distributed Hash Table

CONTENTS

Constructor

new ( [ARGS] ) Creates a Net::BitTorrent::DHT object. This constructor should not be used directly.

Methods

add_node ( { [...] } ) Adds a single node to the routing table. Expects a hashref with the following keys:
ip The hostname/IP address of the remote node.
port The port the remote node has open for DHT.

This is an advanced method and should not (normally) should not be used.

node_id ( ) Get the Node ID used to identify this client in the DHT swarm.
nodes ( ) Returns a list of nodes from the routing table in a format suitable for handing off to add_node( ) one by one.
as_string ( [ VERBOSE ] ) Returns a ’ready to print’ dump of the object’s data structure. If called in void context, the structure is printed to STDERR. VERBOSE is a boolean value.

Bugs

In this alpha, there are a number of places where I break away from the specification. These will all be fixed in a future version.
o The routing table is flat.

Notes

While bandwidth to/from DHT nodes will probably never be limited like other traffic, in the future, it will be taken into account and drained from the rate limiter. If there’s a burst of DHT traffic, the peer traffic may be limited to avoid the total to exceed the global limit.

See Also

I have used a number of references for implementation second opinions:
The Kademlia Paper http://pdos.csail.mit.edu/~petar/papers/maymounkov-kademlia-lncs.pdf
BEP 5: DHT http://www.bittorrent.org/beps/bep_0005.html
Notes about the BitTorrent DHT Protocol from GetRight http://getright.com/torrentdev.html

Author

Sanko Robinson <sanko@cpan.org> - http://sankorobinson.com/

CPAN ID: SANKO

License and Legal

Copyright (C) 2008-2009 by Sanko Robinson <sanko@cpan.org>

This program is free software; you can redistribute it and/or modify it under the terms of The Artistic License 2.0. See the LICENSE file included with this distribution or http://www.perlfoundation.org/artistic_license_2_0. For clarification, see http://www.perlfoundation.org/artistic_2_0_notes.

When separated from the distribution, all POD documentation is covered by the Creative Commons Attribution-Share Alike 3.0 License. See http://creativecommons.org/licenses/by-sa/3.0/us/legalcode. For clarification, see http://creativecommons.org/licenses/by-sa/3.0/us/.

Neither this module nor the Author is affiliated with BitTorrent, Inc.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::BITTORRENT::DHT (3) 2016-03-18

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.