premiere-libtorrent/docs/examples.rst

261 lines
6.1 KiB
ReStructuredText
Raw Normal View History

2006-08-28 02:36:00 +02:00
===================
libtorrent Examples
===================
:Author: Arvid Norberg, arvid@rasterbar.com
.. contents:: Table of contents
:depth: 2
:backlinks: none
examples
========
Except for the example programs in this manual, there's also a bigger example
of a (little bit) more complete client, ``client_test``. There are separate
instructions for how to use it here__ if you'd like to try it. Note that building
``client_test`` also requires boost.regex and boost.program_options library.
2006-08-28 02:36:00 +02:00
__ client_test.html
dump_torrent
------------
This is an example of a program that will take a torrent-file as a parameter and
print information about it to std out::
#include <iostream>
#include <fstream>
#include <iterator>
#include <iomanip>
2008-08-09 09:34:12 +02:00
2006-08-28 02:36:00 +02:00
#include "libtorrent/entry.hpp"
#include "libtorrent/bencode.hpp"
#include "libtorrent/torrent_info.hpp"
2008-08-09 09:34:12 +02:00
#include "libtorrent/lazy_entry.hpp"
#include <boost/filesystem/operations.hpp>
2006-08-28 02:36:00 +02:00
int main(int argc, char* argv[])
{
using namespace libtorrent;
2008-08-09 09:34:12 +02:00
using namespace boost::filesystem;
2006-08-28 02:36:00 +02:00
if (argc != 2)
{
std::cerr << "usage: dump_torrent torrent-file\n";
return 1;
}
2008-08-09 09:34:12 +02:00
#if BOOST_VERSION < 103400
boost::filesystem::path::default_name_check(boost::filesystem::no_check);
#endif
#ifndef BOOST_NO_EXCEPTIONS
2006-08-28 02:36:00 +02:00
try
{
2008-08-09 09:34:12 +02:00
#endif
int size = file_size(argv[1]);
if (size > 10 * 1000000)
{
std::cerr << "file too big (" << size << "), aborting\n";
return 1;
}
std::vector<char> buf(size);
std::ifstream(argv[1], std::ios_base::binary).read(&buf[0], size);
lazy_entry e;
int ret = lazy_bdecode(&buf[0], &buf[0] + buf.size(), e);
if (ret != 0)
{
std::cerr << "invalid bencoding: " << ret << std::endl;
return 1;
}
2006-08-28 02:36:00 +02:00
std::cout << "\n\n----- raw info -----\n\n";
2008-08-09 09:34:12 +02:00
std::cout << e << std::endl;
2006-08-28 02:36:00 +02:00
torrent_info t(e);
// print info about torrent
std::cout << "\n\n----- torrent file info -----\n\n";
std::cout << "nodes:\n";
typedef std::vector<std::pair<std::string, int> > node_vec;
node_vec const& nodes = t.nodes();
for (node_vec::const_iterator i = nodes.begin(), end(nodes.end());
i != end; ++i)
{
std::cout << i->first << ":" << i->second << "\n";
}
2006-08-28 02:36:00 +02:00
std::cout << "trackers:\n";
2008-08-09 09:34:12 +02:00
for (std::vector<announce_entry>::const_iterator i = t.trackers().begin();
i != t.trackers().end(); ++i)
2006-08-28 02:36:00 +02:00
{
std::cout << i->tier << ": " << i->url << "\n";
}
2008-08-09 09:34:12 +02:00
2006-08-28 02:36:00 +02:00
std::cout << "number of pieces: " << t.num_pieces() << "\n";
std::cout << "piece length: " << t.piece_length() << "\n";
std::cout << "info hash: " << t.info_hash() << "\n";
std::cout << "comment: " << t.comment() << "\n";
std::cout << "created by: " << t.creator() << "\n";
std::cout << "files:\n";
2008-08-09 09:34:12 +02:00
int index = 0;
2006-08-28 02:36:00 +02:00
for (torrent_info::file_iterator i = t.begin_files();
2008-08-09 09:34:12 +02:00
i != t.end_files(); ++i, ++index)
2006-08-28 02:36:00 +02:00
{
2008-08-09 09:34:12 +02:00
int first = t.map_file(index, 0, 1).piece;
int last = t.map_file(index, i->size - 1, 1).piece;
2006-08-28 02:36:00 +02:00
std::cout << " " << std::setw(11) << i->size
2008-08-09 09:34:12 +02:00
<< " " << i->path.string() << "[ " << first << ", "
<< last << " ]\n";
2006-08-28 02:36:00 +02:00
}
2008-08-09 09:34:12 +02:00
#ifndef BOOST_NO_EXCEPTIONS
2006-08-28 02:36:00 +02:00
}
catch (std::exception& e)
{
std::cout << e.what() << "\n";
}
2008-08-09 09:34:12 +02:00
#endif
2006-08-28 02:36:00 +02:00
return 0;
}
simple client
-------------
This is a simple client. It doesn't have much output to keep it simple::
int main(int argc, char* argv[])
{
using namespace libtorrent;
2008-08-09 09:34:12 +02:00
#if BOOST_VERSION < 103400
namespace fs = boost::filesystem;
fs::path::default_name_check(fs::no_check);
#endif
2006-08-28 02:36:00 +02:00
2008-08-09 09:34:12 +02:00
if (argc != 2)
{
std::cerr << "usage: ./simple_client torrent-file\n"
"to stop the client, press return.\n";
return 1;
}
#ifndef BOOST_NO_EXCEPTIONS
2006-08-28 02:36:00 +02:00
try
2008-08-09 09:34:12 +02:00
#endif
2006-08-28 02:36:00 +02:00
{
session s;
s.listen_on(std::make_pair(6881, 6889));
2008-08-09 09:34:12 +02:00
add_torrent_params p;
p.save_path = "./";
p.ti = new torrent_info(argv[1]);
s.add_torrent(p);
2006-08-28 02:36:00 +02:00
// wait for the user to end
char a;
std::cin.unsetf(std::ios_base::skipws);
std::cin >> a;
}
2008-08-09 09:34:12 +02:00
#ifndef BOOST_NO_EXCEPTIONS
2006-08-28 02:36:00 +02:00
catch (std::exception& e)
{
std::cout << e.what() << "\n";
}
2008-08-09 09:34:12 +02:00
#endif
2006-08-28 02:36:00 +02:00
return 0;
}
make_torrent
------------
Shows how to create a torrent from a directory tree::
#include <iostream>
#include <fstream>
#include <iterator>
#include <iomanip>
2006-08-28 02:36:00 +02:00
#include "libtorrent/entry.hpp"
#include "libtorrent/bencode.hpp"
#include "libtorrent/torrent_info.hpp"
#include "libtorrent/file.hpp"
#include "libtorrent/storage.hpp"
#include "libtorrent/hasher.hpp"
2008-08-09 09:34:12 +02:00
#include "libtorrent/create_torrent.hpp"
2006-08-28 02:36:00 +02:00
#include <boost/filesystem/operations.hpp>
#include <boost/filesystem/path.hpp>
#include <boost/filesystem/fstream.hpp>
2008-08-09 09:34:12 +02:00
#include <boost/bind.hpp>
2006-08-28 02:36:00 +02:00
using namespace boost::filesystem;
using namespace libtorrent;
2008-08-09 09:34:12 +02:00
// do not include files and folders whose
// name starts with a .
bool file_filter(boost::filesystem::path const& filename)
2006-08-28 02:36:00 +02:00
{
2008-08-09 09:34:12 +02:00
if (filename.leaf()[0] == '.') return false;
std::cerr << filename << std::endl;
return true;
}
void print_progress(int i, int num)
{
std::cerr << "\r" << (i+1) << "/" << num;
2006-08-28 02:36:00 +02:00
}
2006-08-28 02:36:00 +02:00
int main(int argc, char* argv[])
{
using namespace libtorrent;
using namespace boost::filesystem;
2008-08-09 09:34:12 +02:00
int piece_size = 256 * 1024;
char const* creator_str = "libtorrent";
path::default_name_check(no_check);
2008-08-09 09:34:12 +02:00
if (argc != 4 && argc != 5)
2006-08-28 02:36:00 +02:00
{
std::cerr << "usage: make_torrent <output torrent-file> "
2008-08-09 09:34:12 +02:00
"<announce url> <file or directory to create torrent from> "
"[url-seed]\n";
return 1;
}
2008-08-09 09:34:12 +02:00
#ifndef BOOST_NO_EXCEPTIONS
2006-08-28 02:36:00 +02:00
try
{
2008-08-09 09:34:12 +02:00
#endif
file_storage fs;
file_pool fp;
path full_path = complete(path(argv[3]));
2008-08-09 09:34:12 +02:00
add_files(fs, full_path, file_filter);
2008-08-09 09:34:12 +02:00
create_torrent t(fs, piece_size);
2006-08-28 02:36:00 +02:00
t.add_tracker(argv[2]);
2008-08-09 09:34:12 +02:00
set_piece_hashes(t, full_path.branch_path()
, boost::bind(&print_progress, _1, t.num_pieces()));
std::cerr << std::endl;
2006-08-28 02:36:00 +02:00
t.set_creator(creator_str);
2008-08-09 09:34:12 +02:00
if (argc == 5) t.add_url_seed(argv[4]);
2006-08-28 02:36:00 +02:00
// create the torrent and print it to out
2008-08-09 09:34:12 +02:00
ofstream out(complete(path(argv[1])), std::ios_base::binary);
bencode(std::ostream_iterator<char>(out), t.generate());
#ifndef BOOST_NO_EXCEPTIONS
}
catch (std::exception& e)
2006-08-28 02:36:00 +02:00
{
std::cerr << e.what() << "\n";
}
2008-08-09 09:34:12 +02:00
#endif
2006-08-28 02:36:00 +02:00
return 0;
}