003-threads.pl - Trivial Demonstration of a Multi-threaded Client
This is a demonstration of
Net::BitTorrent can be used in a thre-- ((sigh)) ya know, if you really want to try this, I can't stop you, but don't bug me if mixing threads and
Net::BitTorrent turns your RAM into dark matter or causes you to foam at the mouth.
This section only makes sense when you view the source.
- Line 5-6
When Net::BitTorrent sees that threads::shared has been used, it tries its best to keep things organized. There is a limited subset of data that's actually shared between threads; just enough to be of some use but not enough to let you ruin everything.
- Line 10
Creates a new thread. And this is where your sanity ends.
- Line 12
Just a short delay to make it obvious that we're in the child.
- Line 13-14
Sets callbacks to make it obvious that the data is being hashchecked.
- Line 15
Steps aside for a moment.
- Line 16
Validates data. As this starts, connections to peers related to this torrent in the parent thread are closed. While the child does the checking, our bitfield is kept in sync with the parent (thanks to threads::shared), and our status goes through some changes.
- Line 17
Child says goodbye now that (s)he is finished.
- Line 20
Works until we're finished downloading everything.
Net::BitTorrentwill continue to seed the torrent after download is complete.
Unless someone sends me a few good patches (hint, hint) threads will probably never be completely supported by Net::BitTorrent but there are a few things you can do with them.
Note: The data shared between threads is undocumented and subject to change.
Sanko Robinson <email@example.com> - http://sankorobinson.com/
CPAN ID: SANKO
Copyright (C) 2008-2009 by Sanko Robinson <firstname.lastname@example.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.