<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>rTorrent Frequently Asked Questions</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN1"
>rTorrent Frequently Asked Questions</A
></H1
><HR></DIV
><P
> 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.
</P
><DIV
CLASS="QANDASET"
><DL
><DT
>1. <A
HREF="index.html#AEN6"
> How do I add new torrents while the client is running?
</A
></DT
><DT
>2. <A
HREF="index.html#AEN11"
> I got the message "Could not create download, failed to parse the bencoded data" when adding a torrent, what does it mean?
</A
></DT
><DT
>3. <A
HREF="index.html#AEN16"
> How does the session feature work?
</A
></DT
><DT
>4. <A
HREF="index.html#AEN21"
> How do i query the tracker for more peers?
</A
></DT
><DT
>5. <A
HREF="index.html#AEN26"
> Why do I sometimes need to press ctrl-Q twice to exit the client?
</A
></DT
><DT
>6. <A
HREF="index.html#AEN31"
> It doesn't help how much i press ctrl-q, it still won't quit.
</A
></DT
><DT
>7. <A
HREF="index.html#AEN36"
> When I try downloading a torrent the client aborts (SIGABRT), what should I do?
</A
></DT
></DL
><DIV
CLASS="QANDAENTRY"
><DIV
CLASS="QUESTION"
><P
><A
NAME="AEN6"
></A
><B
>1. </B
> How do I add new torrents while the client is running?
</P
></DIV
><DIV
CLASS="ANSWER"
><P
><B
> </B
> 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.
</P
></DIV
></DIV
><DIV
CLASS="QANDAENTRY"
><DIV
CLASS="QUESTION"
><P
><A
NAME="AEN11"
></A
><B
>2. </B
> I got the message "Could not create download, failed to parse the bencoded data" when adding a torrent, what does it mean?
</P
></DIV
><DIV
CLASS="ANSWER"
><P
><B
> </B
> 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.
</P
></DIV
></DIV
><DIV
CLASS="QANDAENTRY"
><DIV
CLASS="QUESTION"
><P
><A
NAME="AEN16"
></A
><B
>3. </B
> How does the session feature work?
</P
></DIV
><DIV
CLASS="ANSWER"
><P
><B
> </B
> 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.
</P
></DIV
></DIV
><DIV
CLASS="QANDAENTRY"
><DIV
CLASS="QUESTION"
><P
><A
NAME="AEN21"
></A
><B
>4. </B
> How do i query the tracker for more peers?
</P
></DIV
><DIV
CLASS="ANSWER"
><P
><B
> </B
> 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.
</P
></DIV
></DIV
><DIV
CLASS="QANDAENTRY"
><DIV
CLASS="QUESTION"
><P
><A
NAME="AEN26"
></A
><B
>5. </B
> Why do I sometimes need to press ctrl-Q twice to exit the client?
</P
></DIV
><DIV
CLASS="ANSWER"
><P
><B
> </B
> 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.
</P
></DIV
></DIV
><DIV
CLASS="QANDAENTRY"
><DIV
CLASS="QUESTION"
><P
><A
NAME="AEN31"
></A
><B
>6. </B
> It doesn't help how much i press ctrl-q, it still won't quit.
</P
></DIV
><DIV
CLASS="ANSWER"
><P
><B
> </B
> 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.
</P
></DIV
></DIV
><DIV
CLASS="QANDAENTRY"
><DIV
CLASS="QUESTION"
><P
><A
NAME="AEN36"
></A
><B
>7. </B
> When I try downloading a torrent the client aborts (SIGABRT), what should I do?
</P
></DIV
><DIV
CLASS="ANSWER"
><P
><B
> </B
> Make sure you arn't using "-fomit-frame-pointer" when
compiling libtorrent and rtorrent, this is known to produce
bad code for C++ exception handling. If this doesn't help, run
the client in gdb and use "bt -20" to get a backtrace. Send
this with a bug report.
</P
></DIV
></DIV
></DIV
></DIV
></BODY
></HTML
>
