Files
rtorrent/doc/faq.xml
T
rakshasa 528646cc02 Adding more faq entries.
git-svn-id: svn://rakshasa.no/libtorrent/trunk/rtorrent@439 e378c898-3ddf-0310-93e7-cc216c733640
2005-05-15 02:19:20 +00:00

94 lines
3.3 KiB
XML

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<article>
<title>rTorrent Frequently Asked Questions</title>
<para>
This is the user FAQ for Rakshasa's BitTorrent client. RTorrent is
an ncurses based client that uses libTorrent and is written in
C++. Efficiency and good code is the main goal of both projects.
</para>
<qandaset>
<qandaentry>
<question><para>
How do I add new torrents while the client is running?
</para></question>
<answer><para>
Use the backspace key to enter file input mode. The bottom
line will change into a prompt which allows you to enter URL's
or file paths to torrents. File name completion and directory
listing is supported with the tab key.
</para></answer>
</qandaentry>
<qandaentry>
<question><para>
I got the message "Could not create download, failed to parse the bencoded data" when adding a torrent, what does it mean?
</para></question>
<answer><para>
The torrent data the library received was not a valid torrent
file. If this was a direct http download, try downloading the
torrent file and add it manually. This usually happens when
the torrent link uses some form of redirection that libcurl
does not automatically redirect. If the failure still happens,
make sure the file is infact an uncorrupted torrent.
</para></answer>
</qandaentry>
<qandaentry>
<question><para>
How does the session feature work?
</para></question>
<answer><para>
When you start the client you can use the "-s" switch to
specify a session directory. The client will save all
currently running torrents in the session directory and fast
resume data will be written when the client exits. Upon
restarting the client it will resume all the torrents in the
session directory.
</para></answer>
</qandaentry>
<qandaentry>
<question><para>
How do i query the tracker for more peers?
</para></question>
<answer><para>
Go into the download view screen and press 't' to initiate a
new tracker request. If the tracker requires a minimum timeout
between requests you can override this by using the capital
'T'. Don't abuse this feature.
</para></answer>
</qandaentry>
<qandaentry>
<question><para>
Why do I sometimes need to press ctrl-Q twice to exit the client?
</para></question>
<answer><para>
The first time you press ctrl-q you initiate the
shutdown. This causes rTorrent to send a stop message to the
trackers of each torrent, and if the tracker is slow it might
take more than a few seconds or until the requests time
out. The second time ctrl-q is pressed forces the client to
shutdown.
</para></answer>
</qandaentry>
<qandaentry>
<question><para>
It doesn't help how much i press ctrl-q, it still won't quit.
</para></question>
<answer><para>
Perhaps your terminal sends a different key-code to the
application. There's no configuration files for keys yet, so
modify rtorrent/src/ui/root.cc:56 to use whatever key you want
for quitting.
</para></answer>
</qandaentry>
</qandaset>
</article>