premiere-libtorrent/docs/examples.html

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.11: http://docutils.sourceforge.net/" />
<title>libtorrent Examples</title>
<meta name="author" content="Arvid Norberg, arvid&#64;rasterbar.com" />
<link rel="stylesheet" type="text/css" href="base.css" />
<link rel="stylesheet" type="text/css" href="rst.css" />
<script type="text/javascript">
/* <![CDATA[ */
    (function() {
        var s = document.createElement('script'), t = document.getElementsByTagName('script')[0];
        s.type = 'text/javascript';
        s.async = true;
        s.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';
        t.parentNode.insertBefore(s, t);
    })();
/* ]]> */
</script>
<link rel="stylesheet" href="style.css" type="text/css" />
<style type="text/css">
/* Hides from IE-mac \*/
* html pre { height: 1%; }
/* End hide from IE-mac */
</style>
</head>
<body>
<div class="document" id="libtorrent-examples">
    <div id="container">
    <div id="header">
    <div id="orange"></div>
    <div id="logo"></div>
    </div>
    <div id="main">
<h1 class="title">libtorrent Examples</h1>
<table class="docinfo" frame="void" rules="none">
<col class="docinfo-name" />
<col class="docinfo-content" />
<tbody valign="top">
<tr><th class="docinfo-name">Author:</th>
<td>Arvid Norberg, <a class="last reference external" href="mailto:arvid&#64;rasterbar.com">arvid&#64;rasterbar.com</a></td></tr>
</tbody>
</table>
<div class="contents topic" id="table-of-contents">
<p class="topic-title first">Table of contents</p>
<ul class="simple">
<li><a class="reference internal" href="#examples" id="id2">examples</a><ul>
<li><a class="reference internal" href="#dump-torrent" id="id3">dump_torrent</a></li>
<li><a class="reference internal" href="#simple-client" id="id4">simple client</a></li>
<li><a class="reference internal" href="#make-torrent" id="id5">make_torrent</a></li>
</ul>
</li>
</ul>
</div>
<div class="section" id="examples">
<h1>examples</h1>
<p>Except for the example programs in this manual, there's also a bigger example
of a (little bit) more complete client, <tt class="docutils literal">client_test</tt>. There are separate
instructions for how to use it <a class="reference external" href="client_test.html">here</a> if you'd like to try it. Note that building
<tt class="docutils literal">client_test</tt> also requires boost.regex and boost.program_options library.</p>
<div class="section" id="dump-torrent">
<h2>dump_torrent</h2>
<p>This is an example of a program that will take a torrent-file as a parameter and
print information about it to std out:</p>
<pre class="literal-block">
#include &lt;iostream&gt;
#include &lt;fstream&gt;
#include &lt;iterator&gt;
#include &lt;iomanip&gt;

#include &quot;libtorrent/entry.hpp&quot;
#include &quot;libtorrent/bencode.hpp&quot;
#include &quot;libtorrent/torrent_info.hpp&quot;
#include &quot;libtorrent/lazy_entry.hpp&quot;
#include &lt;boost/filesystem/operations.hpp&gt;


int main(int argc, char* argv[])
{
        using namespace libtorrent;
        using namespace boost::filesystem;

        if (argc != 2)
        {
                std::cerr &lt;&lt; &quot;usage: dump_torrent torrent-file\n&quot;;
                return 1;
        }
#if BOOST_VERSION &lt; 103400
        boost::filesystem::path::default_name_check(boost::filesystem::no_check);
#endif

#ifndef BOOST_NO_EXCEPTIONS
        try
        {
#endif

                int size = file_size(argv[1]);
                if (size &gt; 10 * 1000000)
                {
                        std::cerr &lt;&lt; &quot;file too big (&quot; &lt;&lt; size &lt;&lt; &quot;), aborting\n&quot;;
                        return 1;
                }
                std::vector&lt;char&gt; buf(size);
                std::ifstream(argv[1], std::ios_base::binary).read(&amp;buf[0], size);
                lazy_entry e;
                int ret = lazy_bdecode(&amp;buf[0], &amp;buf[0] + buf.size(), e);

                if (ret != 0)
                {
                        std::cerr &lt;&lt; &quot;invalid bencoding: &quot; &lt;&lt; ret &lt;&lt; std::endl;
                        return 1;
                }

                std::cout &lt;&lt; &quot;\n\n----- raw info -----\n\n&quot;;
                std::cout &lt;&lt; e &lt;&lt; std::endl;

                torrent_info t(e);

                // print info about torrent
                std::cout &lt;&lt; &quot;\n\n----- torrent file info -----\n\n&quot;;
                std::cout &lt;&lt; &quot;nodes:\n&quot;;
                typedef std::vector&lt;std::pair&lt;std::string, int&gt; &gt; node_vec;
                node_vec const&amp; nodes = t.nodes();
                for (node_vec::const_iterator i = nodes.begin(), end(nodes.end());
                        i != end; ++i)
                {
                        std::cout &lt;&lt; i-&gt;first &lt;&lt; &quot;:&quot; &lt;&lt; i-&gt;second &lt;&lt; &quot;\n&quot;;
                }
                std::cout &lt;&lt; &quot;trackers:\n&quot;;
                for (std::vector&lt;announce_entry&gt;::const_iterator i = t.trackers().begin();
                        i != t.trackers().end(); ++i)
                {
                        std::cout &lt;&lt; i-&gt;tier &lt;&lt; &quot;: &quot; &lt;&lt; i-&gt;url &lt;&lt; &quot;\n&quot;;
                }

                std::cout &lt;&lt; &quot;number of pieces: &quot; &lt;&lt; t.num_pieces() &lt;&lt; &quot;\n&quot;;
                std::cout &lt;&lt; &quot;piece length: &quot; &lt;&lt; t.piece_length() &lt;&lt; &quot;\n&quot;;
                std::cout &lt;&lt; &quot;info hash: &quot; &lt;&lt; t.info_hash() &lt;&lt; &quot;\n&quot;;
                std::cout &lt;&lt; &quot;comment: &quot; &lt;&lt; t.comment() &lt;&lt; &quot;\n&quot;;
                std::cout &lt;&lt; &quot;created by: &quot; &lt;&lt; t.creator() &lt;&lt; &quot;\n&quot;;
                std::cout &lt;&lt; &quot;files:\n&quot;;
                int index = 0;
                for (torrent_info::file_iterator i = t.begin_files();
                        i != t.end_files(); ++i, ++index)
                {
                        int first = t.map_file(index, 0, 1).piece;
                        int last = t.map_file(index, i-&gt;size - 1, 1).piece;
                        std::cout &lt;&lt; &quot;  &quot; &lt;&lt; std::setw(11) &lt;&lt; i-&gt;size
                                &lt;&lt; &quot; &quot; &lt;&lt; i-&gt;path.string() &lt;&lt; &quot;[ &quot; &lt;&lt; first &lt;&lt; &quot;, &quot;
                                &lt;&lt; last &lt;&lt; &quot; ]\n&quot;;
                }

#ifndef BOOST_NO_EXCEPTIONS
        }
        catch (std::exception&amp; e)
        {
                std::cout &lt;&lt; e.what() &lt;&lt; &quot;\n&quot;;
        }
#endif

        return 0;
}
</pre>
</div>
<div class="section" id="simple-client">
<h2>simple client</h2>
<p>This is a simple client. It doesn't have much output to keep it simple:</p>
<pre class="literal-block">
int main(int argc, char* argv[])
{
        using namespace libtorrent;

        if (argc != 2)
        {
                fputs(&quot;usage: ./simple_client torrent-file\n&quot;
                        &quot;to stop the client, press return.\n&quot;, stderr);
                return 1;
        }

        session s;
        error_code ec;
        s.listen_on(std::make_pair(6881, 6889), ec);
        if (ec)
        {
                fprintf(stderr, &quot;failed to open listen socket: %s\n&quot;, ec.message().c_str());
                return 1;
        }
        add_torrent_params p;
        p.save_path = &quot;./&quot;;
        p.ti = boost::make_shared&lt;torrent_info&gt;(argv[1], ec);
        if (ec)
        {
                fprintf(stderr, &quot;%s\n&quot;, ec.message().c_str());
                return 1;
        }
        s.add_torrent(p, ec);
        if (ec)
        {
                fprintf(stderr, &quot;%s\n&quot;, ec.message().c_str());
                return 1;
        }

        // wait for the user to end
        char a;
        scanf(&quot;%c\n&quot;, &amp;a);
        return 0;
}
</pre>
</div>
<div class="section" id="make-torrent">
<h2>make_torrent</h2>
<p>Shows how to create a torrent from a directory tree:</p>
<pre class="literal-block">
#include &lt;iostream&gt;
#include &lt;fstream&gt;
#include &lt;iterator&gt;
#include &lt;iomanip&gt;

#include &quot;libtorrent/entry.hpp&quot;
#include &quot;libtorrent/bencode.hpp&quot;
#include &quot;libtorrent/torrent_info.hpp&quot;
#include &quot;libtorrent/file.hpp&quot;
#include &quot;libtorrent/storage.hpp&quot;
#include &quot;libtorrent/hasher.hpp&quot;
#include &quot;libtorrent/create_torrent.hpp&quot;

#include &lt;boost/filesystem/operations.hpp&gt;
#include &lt;boost/filesystem/path.hpp&gt;
#include &lt;boost/filesystem/fstream.hpp&gt;
#include &lt;boost/bind.hpp&gt;

using namespace boost::filesystem;
using namespace libtorrent;

// do not include files and folders whose
// name starts with a .
bool file_filter(boost::filesystem::path const&amp; filename)
{
        if (filename.leaf()[0] == '.') return false;
        std::cerr &lt;&lt; filename &lt;&lt; std::endl;
        return true;
}

void print_progress(int i, int num)
{
        std::cerr &lt;&lt; &quot;\r&quot; &lt;&lt; (i+1) &lt;&lt; &quot;/&quot; &lt;&lt; num;
}

int main(int argc, char* argv[])
{
        using namespace libtorrent;
        using namespace boost::filesystem;

        int piece_size = 256 * 1024;
        char const* creator_str = &quot;libtorrent&quot;;

        path::default_name_check(no_check);

        if (argc != 4 &amp;&amp; argc != 5)
        {
                std::cerr &lt;&lt; &quot;usage: make_torrent &lt;output torrent-file&gt; &quot;
                &quot;&lt;announce url&gt; &lt;file or directory to create torrent from&gt; &quot;
                &quot;[url-seed]\n&quot;;
        return 1;
}

#ifndef BOOST_NO_EXCEPTIONS
        try
        {
#endif
                file_storage fs;
                file_pool fp;
                path full_path = complete(path(argv[3]));

                add_files(fs, full_path, file_filter);

                create_torrent t(fs, piece_size);
                t.add_tracker(argv[2]);
                set_piece_hashes(t, full_path.branch_path()
                        , boost::bind(&amp;print_progress, _1, t.num_pieces()));
                std::cerr &lt;&lt; std::endl;
                t.set_creator(creator_str);

                if (argc == 5) t.add_url_seed(argv[4]);

                // create the torrent and print it to out
                ofstream out(complete(path(argv[1])), std::ios_base::binary);
                bencode(std::ostream_iterator&lt;char&gt;(out), t.generate());
#ifndef BOOST_NO_EXCEPTIONS
        }
        catch (std::exception&amp; e)
        {
                std::cerr &lt;&lt; e.what() &lt;&lt; &quot;\n&quot;;
        }
#endif

        return 0;
}
</pre>
</div>
</div>
</div>
</body>
</html>
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`<?xml version="1.0" encoding="utf-8" ?>`
			`<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">`
			`<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">`
			`<head>`
regenerated documentation 2012-01-16 03:09:07 +01:00			`<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />`
update and regenerate documentation 2014-05-12 08:28:47 +02:00			`<meta name="generator" content="Docutils 0.11: http://docutils.sourceforge.net/" />`
regenerated documentation 2012-01-16 03:09:07 +01:00			`<title>libtorrent Examples</title>`
			`<meta name="author" content="Arvid Norberg, arvid@rasterbar.com" />`
merged fixes from RC_1_0 2014-08-26 05:14:32 +02:00			`<link rel="stylesheet" type="text/css" href="base.css" />`
			`<link rel="stylesheet" type="text/css" href="rst.css" />`
regenerated docs and replaced paypal button 2010-12-08 05:44:20 +01:00			`<script type="text/javascript">`
			`/* <![CDATA[ */`
			`(function() {`
			`var s = document.createElement('script'), t = document.getElementsByTagName('script')[0];`
			`s.type = 'text/javascript';`
			`s.async = true;`
			`s.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';`
			`t.parentNode.insertBefore(s, t);`
			`})();`
			`/* ]]> */`
			`</script>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`<link rel="stylesheet" href="style.css" type="text/css" />`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 05:23:30 +02:00			`<style type="text/css">`
			`/* Hides from IE-mac \*/`
			`* html pre { height: 1%; }`
			`/* End hide from IE-mac */`
			`</style>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`</head>`
			`<body>`
			`<div class="document" id="libtorrent-examples">`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 05:23:30 +02:00			`<div id="container">`
			`<div id="header">`
fix reference documentation generation 2013-08-04 11:02:19 +02:00			`<div id="orange"></div>`
			`<div id="logo"></div>`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 05:23:30 +02:00			`</div>`
			`<div id="main">`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`<h1 class="title">libtorrent Examples</h1>`
			`<table class="docinfo" frame="void" rules="none">`
			`<col class="docinfo-name" />`
			`<col class="docinfo-content" />`
			`<tbody valign="top">`
			`<tr><th class="docinfo-name">Author:</th>`
regenerated html 2009-03-21 05:36:46 +01:00			`<td>Arvid Norberg, <a class="last reference external" href="mailto:arvid@rasterbar.com">arvid@rasterbar.com</a></td></tr>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`</tbody>`
			`</table>`
			`<div class="contents topic" id="table-of-contents">`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 05:23:30 +02:00			`<p class="topic-title first">Table of contents</p>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`<ul class="simple">`
regenerated html 2009-03-21 05:36:46 +01:00			`<li><a class="reference internal" href="#examples" id="id2">examples</a><ul>`
			`<li><a class="reference internal" href="#dump-torrent" id="id3">dump_torrent</a></li>`
			`<li><a class="reference internal" href="#simple-client" id="id4">simple client</a></li>`
			`<li><a class="reference internal" href="#make-torrent" id="id5">make_torrent</a></li>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`</ul>`
			`</li>`
			`</ul>`
			`</div>`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 05:23:30 +02:00			`<div class="section" id="examples">`
			`<h1>examples</h1>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`<p>Except for the example programs in this manual, there's also a bigger example`
update docs 2013-01-21 20:13:24 +01:00			`of a (little bit) more complete client, <tt class="docutils literal">client_test</tt>. There are separate`
regenerated html 2009-03-21 05:36:46 +01:00			`instructions for how to use it <a class="reference external" href="client_test.html">here</a> if you'd like to try it. Note that building`
update docs 2013-01-21 20:13:24 +01:00			`<tt class="docutils literal">client_test</tt> also requires boost.regex and boost.program_options library.</p>`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 05:23:30 +02:00			`<div class="section" id="dump-torrent">`
			`<h2>dump_torrent</h2>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`<p>This is an example of a program that will take a torrent-file as a parameter and`
			`print information about it to std out:</p>`
			`<pre class="literal-block">`
			`#include <iostream>`
			`#include <fstream>`
			`#include <iterator>`
			`#include <iomanip>`

			`#include "libtorrent/entry.hpp"`
			`#include "libtorrent/bencode.hpp"`
			`#include "libtorrent/torrent_info.hpp"`
updated examples page 2008-08-09 09:34:12 +02:00			`#include "libtorrent/lazy_entry.hpp"`
			`#include <boost/filesystem/operations.hpp>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00

			`int main(int argc, char* argv[])`
			`{`
			`using namespace libtorrent;`
updated examples page 2008-08-09 09:34:12 +02:00			`using namespace boost::filesystem;`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
			`if (argc != 2)`
			`{`
			`std::cerr << "usage: dump_torrent torrent-file\n";`
			`return 1;`
			`}`
updated examples page 2008-08-09 09:34:12 +02:00			`#if BOOST_VERSION < 103400`
			`boost::filesystem::path::default_name_check(boost::filesystem::no_check);`
			`#endif`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
updated examples page 2008-08-09 09:34:12 +02:00			`#ifndef BOOST_NO_EXCEPTIONS`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`try`
			`{`
updated examples page 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;`
			`}`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
			`std::cout << "\n\n----- raw info -----\n\n";`
updated examples page 2008-08-09 09:34:12 +02:00			`std::cout << e << std::endl;`
split the documentation up a bit 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";`
updated dump_torrent examples to print DHT nodes from the torrent file 2006-09-03 21:53:19 +02:00			`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";`
			`}`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`std::cout << "trackers:\n";`
updated examples page 2008-08-09 09:34:12 +02:00			`for (std::vector<announce_entry>::const_iterator i = t.trackers().begin();`
			`i != t.trackers().end(); ++i)`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`{`
			`std::cout << i->tier << ": " << i->url << "\n";`
			`}`

			`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";`
updated examples page 2008-08-09 09:34:12 +02:00			`int index = 0;`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`for (torrent_info::file_iterator i = t.begin_files();`
updated examples page 2008-08-09 09:34:12 +02:00			`i != t.end_files(); ++i, ++index)`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`{`
updated examples page 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;`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`std::cout << " " << std::setw(11) << i->size`
updated examples page 2008-08-09 09:34:12 +02:00			`<< " " << i->path.string() << "[ " << first << ", "`
			`<< last << " ]\n";`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`}`
fixed incorrectly named members of session_status, fixed compilation error in ut_pex, documentation updates 2006-11-28 19:18:37 +01:00
updated examples page 2008-08-09 09:34:12 +02:00			`#ifndef BOOST_NO_EXCEPTIONS`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`}`
			`catch (std::exception& e)`
			`{`
			`std::cout << e.what() << "\n";`
			`}`
updated examples page 2008-08-09 09:34:12 +02:00			`#endif`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
			`return 0;`
			`}`
			`</pre>`
			`</div>`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 05:23:30 +02:00			`<div class="section" id="simple-client">`
			`<h2>simple client</h2>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`<p>This is a simple client. It doesn't have much output to keep it simple:</p>`
			`<pre class="literal-block">`
			`int main(int argc, char* argv[])`
			`{`
			`using namespace libtorrent;`

land libtorrent_aio branch in trunk 2014-07-06 21:18:00 +02:00			`if (argc != 2)`
			`{`
			`fputs("usage: ./simple_client torrent-file\n"`
			`"to stop the client, press return.\n", stderr);`
			`return 1;`
			`}`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
land libtorrent_aio branch in trunk 2014-07-06 21:18:00 +02:00			`session s;`
			`error_code ec;`
			`s.listen_on(std::make_pair(6881, 6889), ec);`
			`if (ec)`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`{`
land libtorrent_aio branch in trunk 2014-07-06 21:18:00 +02:00			`fprintf(stderr, "failed to open listen socket: %s\n", ec.message().c_str());`
			`return 1;`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`}`
land libtorrent_aio branch in trunk 2014-07-06 21:18:00 +02:00			`add_torrent_params p;`
			`p.save_path = "./";`
			`p.ti = boost::make_shared<torrent_info>(argv[1], ec);`
			`if (ec)`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`{`
land libtorrent_aio branch in trunk 2014-07-06 21:18:00 +02:00			`fprintf(stderr, "%s\n", ec.message().c_str());`
			`return 1;`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`}`
land libtorrent_aio branch in trunk 2014-07-06 21:18:00 +02:00			`s.add_torrent(p, ec);`
			`if (ec)`
			`{`
			`fprintf(stderr, "%s\n", ec.message().c_str());`
			`return 1;`
			`}`

			`// wait for the user to end`
			`char a;`
			`scanf("%c\n", &a);`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`return 0;`
			`}`
			`</pre>`
			`</div>`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 05:23:30 +02:00			`<div class="section" id="make-torrent">`
			`<h2>make_torrent</h2>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`<p>Shows how to create a torrent from a directory tree:</p>`
			`<pre class="literal-block">`
			`#include <iostream>`
			`#include <fstream>`
			`#include <iterator>`
			`#include <iomanip>`

			`#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"`
updated examples page 2008-08-09 09:34:12 +02:00			`#include "libtorrent/create_torrent.hpp"`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
			`#include <boost/filesystem/operations.hpp>`
			`#include <boost/filesystem/path.hpp>`
			`#include <boost/filesystem/fstream.hpp>`
updated examples page 2008-08-09 09:34:12 +02:00			`#include <boost/bind.hpp>`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
			`using namespace boost::filesystem;`
			`using namespace libtorrent;`

updated examples page 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)`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`{`
updated examples page 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;`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`}`

			`int main(int argc, char* argv[])`
			`{`
			`using namespace libtorrent;`
			`using namespace boost::filesystem;`

updated examples page 2008-08-09 09:34:12 +02:00			`int piece_size = 256 * 1024;`
			`char const* creator_str = "libtorrent";`

the file pool has been moved to the session and its size can be controlled via session_settings. Added untested option to allow multiple connections from the same IP. 2006-11-14 16:53:38 +01:00			`path::default_name_check(no_check);`

updated examples page 2008-08-09 09:34:12 +02:00			`if (argc != 4 && argc != 5)`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`{`
			`std::cerr << "usage: make_torrent <output torrent-file> "`
updated examples page 2008-08-09 09:34:12 +02:00			`"<announce url> <file or directory to create torrent from> "`
			`"[url-seed]\n";`
			`return 1;`
			`}`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
updated examples page 2008-08-09 09:34:12 +02:00			`#ifndef BOOST_NO_EXCEPTIONS`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`try`
			`{`
updated examples page 2008-08-09 09:34:12 +02:00			`#endif`
			`file_storage fs;`
			`file_pool fp;`
the file pool has been moved to the session and its size can be controlled via session_settings. Added untested option to allow multiple connections from the same IP. 2006-11-14 16:53:38 +01:00			`path full_path = complete(path(argv[3]));`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
updated examples page 2008-08-09 09:34:12 +02:00			`add_files(fs, full_path, file_filter);`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
updated examples page 2008-08-09 09:34:12 +02:00			`create_torrent t(fs, piece_size);`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`t.add_tracker(argv[2]);`
updated examples page 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;`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`t.set_creator(creator_str);`

updated examples page 2008-08-09 09:34:12 +02:00			`if (argc == 5) t.add_url_seed(argv[4]);`

split the documentation up a bit 2006-08-28 02:36:00 +02:00			`// create the torrent and print it to out`
updated examples page 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)`
split the documentation up a bit 2006-08-28 02:36:00 +02:00			`{`
			`std::cerr << e.what() << "\n";`
			`}`
updated examples page 2008-08-09 09:34:12 +02:00			`#endif`
split the documentation up a bit 2006-08-28 02:36:00 +02:00
			`return 0;`
			`}`
			`</pre>`
			`</div>`
			`</div>`
			`</div>`
			`</body>`
			`</html>`