Enhanced CTorrent Code

Brought to you by: dholmes999
[r134]: / ctcs / trunk / ctcs.html Maximize Restore History

816 lines (733 with data), 34.6 kB

<HTML>
<HEAD>
<TITLE>CTorrent Control Server</TITLE>
</HEAD>
<BODY>
<CENTER>
<H1>CTorrent Control Server</H1>
</CENTER>
<P>
CTorrent Control Server (CTCS) is an interface for monitoring and managing
<A HREF="http://www.rahul.net/dholmes/ctorrent/">Enhanced CTorrent</A>
clients.  It can manage allocation of
bandwidth, provide status information, and allow changes to the
running configuration of each client.  Communication with CTorrent is
via a TCP connection, and the user interface is a web browser.

<P>The current version is implemented in <A HREF="http://www.perl.org/">Perl</A>
since that was used to develop the original prototype.  It may be
reimplemented in C at some later date, but the Perl version is fully
functional.  You will need to install a Perl interpreter if your system does
not already have one.

<H3>Contents</H3>
<P>
<UL compact>
<LI><A HREF="#download">Download</A>
<LI><A HREF="#usage">Usage</A>
<LI><A HREF="#alltorrents">All Torrents</A> screen
<LI><A HREF="#details">Torrent Details</A> screen
<LI><A HREF="#alimits">Advanced Limits</A> screen
<LI><A href="ctcs-protocol.html">Protocol</A>
</UL>


<H2><HR><A NAME="download">Download</A></H2>
<P>
The preferred download mechanism is now the
<A HREF="http://sourceforge.net/project/showfiles.php?group_id=202532">
SourceForge File Release</A> page.  All new files will be available there for
convenient downloading from a mirror site near to you.

<P>
<A HREF="ctcs-1.4.1.tar.gz">ctcs-1.4.1.tar.gz</A>:
CTCS version 1.4.1.  List of changes:
<UL compact>
<LI>
  Additional color-coding of peer interested/choked status
<LI>
  Fixed error displaying Torrent Details screen when a file has zero size.
<LI>
  Fixed problems handling POST form input.
<LI>
  Boost client's limit only if bandwidth is shared.
<LI>
  On details screen for terminated torrent, Torrent table showed "Start Time".
</UL>

<P>
<A HREF="ctcs-1.4.tar.gz">ctcs-1.4.tar.gz</A>:
CTCS version 1.4.  List of changes:
<UL compact>
<LI>
  Protocol 3 support
  <UL compact>
  <LI>
    Auto-configuration of client configuration options
  <LI>
    File download priority
  <LI>
    Updated block start messages for consistency
  </UL>
<LI>
  New client configuration options as provided by client version 3.1 and later.
<LI>
  Each file's download priority is shown in the list and can be set as an
  alternative method to changning the "-n" option value.
</UL>

<P>
<A HREF="ctcs-1.3.tar.gz">ctcs-1.3.tar.gz</A>:
CTCS version 1.3.  List of changes:
<UL compact>
<LI>
  Protocol 2 support
  <UL compact>
  <LI>
    Cache size configuration option
  <LI>
    Removal of option to exit when peers=0
  <LI>
    Total seeders & leechers in the swarm, and connecting peers, are shown.
  <LI>
    File availability is shown.
  </UL>
<LI>
  Bandwidth management changes
  <UL compact>
  <LI>
    Works correctly with Enhanced CTorrent dnh3
  <LI>
    Adjusted the threshold for increasing a limit
  <LI>
    Wait a few minutes after a client becomes seed to reduce the download
    limit.  This allows duplicate slices still "in flight" to be received and
    thus cleared from the connection.
  <LI>
    The average bandwidth available per client is now regarded as an implied
    minimum.  A client limit will generally not be reduced below this value,
    though unused bandwidth will be allocated to other clients.  This avoids a
    slow and difficult ramp-up period when an idle client suddenly acquires an
    active peer.
  </UL>
<LI>
  Cosmetic updates
  <UL compact>
  <LI>
    Configuration values are highlighted at certain times for visibility or
    attention.
  <LI>
    Zero peer rates and transfer amounts are not shown, for clarity.
  <LI>
    Peer completeness is shaded red by value (0%=red, 100%=white).
  <LI>
    Uninterested states are indicated in gray.
  <LI>
    Peer IP address is centered in the cell.
  <LI>
    Peer transfer rates and totals are shaded purple by scale (B/K/M).
  </UL>
</UL>

<P>
<A HREF="ctcs-1.2.tar.gz">ctcs-1.2.tar.gz</A>:
CTCS version 1.2.  List of changes:
<UL compact>
<LI>
  Version number is now displayed at bottom of main page.
<LI>
  Added a few client ID strings.
<LI>
  The maximum limit "boost" value is now based on the global limit and number
  of torrents.  Previously it was always 1K; now it will be less if bandwidth
  is constrained.
<LI>
  Improved handling of minimum limits.  Now a torrent's limit will never be
  reduced below its minimum, but unused bandwidth will still be borrowed for
  other torrents.  This is more stable with the new seeding algorithm.
<LI>
  Eliminated the checkboxes to change current limits on the Advanced Limits
  screen.  Each limit is changed only if a new value is entered for it.
<LI>
  Added an option to limit a torrent's max upload rate based on share ratio.
  (See the Advanced Limits screen.)
<LI>
  In the Advanced Limits screen, options related to downloading are now
  disabled for torrents that are seeding.
<LI>
  Message indication: 
  An exclamation point (!) is shown next to the torrent title if messages are
  present.  The torrent title is highlighted based on message severity.
<LI>
  Messages that include a severity (added in dnh2.2) will be highlighted in
  red (sev 1) or yellow (sev 2).  Sev 3 and no-severity (pre-dnh2.2) messages
  are not highlighted.
<LI>
  Enabled a Torrent Details page for terminated torrents.
<LI>
  Avoid crashing if a user stops/reloads too quickly.
  Resolved with a SIGPIPE handler, which may not work on all platforms.  If
  you know how to handle this situation on your platform, please let me know.
  I found that checking the return code from print/printf was not particularly
  reliable.
<LI>
  If the hostname is unresolvable, the program will now fall back to
  "localhost" or 127.0.0.1.  Previously this could result in an error.
<LI>
  Cleaned up HTML print statements (code formatting).
</UL>

<P>
<A HREF="ctcs-1.1.tar.gz">ctcs-1.1.tar.gz</A>:
CTCS version 1.1.  List of changes:
<UL compact>
<LI>
  Use "\r\n" as newline.
<LI>
  Added a few client ID strings.
<LI>
  Fixed data sending (user interaction) on Linux.
<LI>
  Fixed error when all upload or download limits are zero.
</UL>
<P>
<A HREF="ctcs-1.0a.tar.gz">ctcs-1.0a.tar.gz</A>:
CTCS version 1.0a

<P>
<A HREF="ctcs-1.0a.diff">ctcs-1.0a.diff</A>:
Patch file for 1.0<BR>
There was a minor bug in the original release that prevented the
Messages feature from working (messages were discarded).  If you
previously downloaded version 1.0, please apply this small patch to
enable the feature.


<H2><HR><A NAME="usage">Usage</A></H2>
<P>
<PRE>
ctcs [-d &lt;dlimit&gt;] [-u &lt;ulimit&gt;] [-i &lt;interval&gt;] [-p &lt;port&gt;] [-P]
</PRE>
<DL>
<DT>-d <U>dlimit</U>
<DD>Overall download bandwidth limit, in KB/s (default 100).
<DT>-u <U>ulimit</U>
<DD>Overall upload bandwidth limit, in KB/s (default 25).  Use a value
    that is less than the maximum capacity of your network line.
<DT>-i <U>interval</U>
<DD>Bandwidth management change interval, in seconds (default 5).  The
    recommended minimum value is 3.  Higher values will reduce oscillation
    of individual torrent limits, but a value that is too high will cause
    very slow reactions to changes in bandwidth usage.
<DT>-p <U>port</U>
<DD>The TCP port on which to listen for connections (default 2780).
<DT>-P
<DD>Prompt for an authorization password.
</DL>

If your system does not have perl available at /usr/bin/perl, you will
need to change the path in the first line of the file.

<P>To connect Enhanced CTorrent (release dnh2 or later) clients to CTCS,
use the "-S" command-line option, e.g. "-S localhost:2780".  To use a
web browser to view or change status, enter the same host and port as
the location, e.g. "http://localhost:2780/".

<H3>Security</H3>
<P>
Though there is a basic option, security is <B>very minimal</B>.
Running CTCS on a computer or network with untrusted users is not
recommended.  It should go without saying that the CTCS listening port
should not be made openly accessible from the public Internet (but there,
it's said anyway).

<P>The "-P" option will cause CTCS to prompt for a password when starting.
This password will be used to authenticate CTorrent clients.  It is
intended that the same password will be used to authenticate web
browser connections also, but this has not yet been implemented.
Using a colon at the end of the -S parameter to CTorrent (as in "-S
localhost:2780:") will cause the client to prompt for a password to
send to CTCS when connecting.


<H2><HR><A NAME="alltorrents">All Torrents screen</A></H2>
<P>
This is the main CTCS display, which shows overall bandwidth status
and provides a summary of each torrent.

<H3>Bandwidth Management</H3>
<P>
The top portion of the display provides the bandwidth management
interface.

<CENTER><HR width=50%></CENTER>
<FORM METHOD=GET ACTION="#/">
<CENTER><TABLE BORDER=0>
<TR><TD width=40%>Current DL = <B>7</B> K/s
	<TD width=40% align=right>DL Limit: <INPUT NAME="dlimit" TYPE="text" align=right SIZE=4 VALUE="100">K/s
	<TD width=20% ROWSPAN=3 align=right><INPUT TYPE="submit" VALUE="Change">
</TR>
<TR><TD>Current UL = <B>34</B> K/s
	<TD align=right>UL Limit: <INPUT NAME="ulimit" TYPE="text" align=right SIZE=4 VALUE="35">K/s
</TR>
<TR><TD><TD align=right>Change interval: <INPUT name="bwinterval" type="text" align=right size=3 value="5">sec</TR>
</TABLE></CENTER></FORM>

<CENTER><A HREF="#/alimits">Advanced Limits</A></CENTER>
<CENTER><HR width=50%></CENTER>

The current aggregate download and upload rates are shown at the left
(determined by adding together the rates reported by each client).  To
the right of this the overall limits and change interval can be changed.
To do this, enter the desired values and click the Change button.

<P>The Advanced Limits function is covered further below.


<P><BR>
<H3>Active Torrents</H3>
<P>
The next section of the display is a list of all active clients that
are reporting to CTCS, and status information on the torrents they are
running.

<CENTER><HR width=50%></CENTER>
<A HREF="#/peers">Show peers</A>

<P>
<TABLE BORDER width=100%>
<TR bgcolor="#cccccc"><TD colspan=5><B>Torrent</B>
	<TD colspan=3 align=right>Start Time</TR>
<TR bgcolor="#cccccc"><TD>Seed<TD>Leech<TD>Complete
	<TD align=right>DL Rate<TD align=right>UL Rate
	<TD align=right>DL Total<TD align=right>UL Total
	<TD align=right>Limit D/U</TR>

<TR bgcolor="#ccccff"><TD colspan=5><A HREF="#/torrent/-CD0202-%7B0xD529E46881CF5DD4E37DF6"><B>Example 1.torrent</B></A>
	<TD colspan=3 align=right>Tue Jan  3 21:24:27 2006</TR>
<TR><TD>S: 0/3<TD>L: 7/7<TD>100%
	<TD align=right>D= 0 B/s<TD align=right>U= 11 K/s
	<TD align=right>D= 393&nbsp;M<TD align=right>U= 1111&nbsp;M
	<TD align=right>0 / 11 K/s</TR>


<TR bgcolor="#ccccff"><TD colspan=5><A HREF="#/torrent/-CD0202-P0xE9C43CD51BA8C5B319601A"><B>Example 2.torrent</B></A>
	<TD colspan=3 align=right>Tue Jan  3 20:24:06 2006</TR>
<TR><TD>S: 0/25<TD>L: 44/52 +2<TD>100%
	<TD align=right>D= 0 B/s<TD align=right>U= 12 K/s
	<TD align=right>D= 380&nbsp;M<TD align=right>U= 972&nbsp;M
	<TD align=right>0 / 12 K/s</TR>


<TR bgcolor="#ccccff"><TD colspan=5><A HREF="#/torrent/-CD0202-0xCCEFB5B7D53349B364737755"><B>Example 3.torrent</B></A>
	<TD colspan=3 align=right>Wed Jan  4 22:13:55 2006</TR>
<TR><TD>S: 1/2<TD>L: 1/2<TD> 20% (100% Avail)
	<TD align=right>D= 7372 B/s<TD align=right>U= 12 K/s
	<TD align=right>D= 188&nbsp;M<TD align=right>U= 254&nbsp;M
	<TD align=right>100 / 12 K/s</TR>

</TABLE>
<CENTER><HR width=50%></CENTER>

Each torrent is listed in blue along with the time the client was
started, with its status information shown
below it in white.  The first two fields are the number of seeders
and leechers connected (out of the tracker's totals), plus connections
in progress if any.  This is followed by the percentage of the torrent
that you have; if it is not complete then the amount that is currently
available from all connected peers is shown in parentheses.  The
current download and upload rates are shown in bytes, kilobytes, or
megabytes per second, as are the total amounts downloaded and uploaded
by the client.  The bandwidth allocated to the client is shown in the
last column, in kilobytes per second.  Note that bandwidth is managed
to a finer degree than this, so if you see a zero value it just means
that less than 1K has been allocated.  This is also why it may appear
that the total is wrong if you add the displayed values yourself.

<P>Clicking a torrent title will take you to the Torrent Details screen
for that torrent.  If CTCS has received any status messages from a
client, an exclamation point (<B>!</B>) will be shown next to the
title.  If there are potentially severe messages, the title will be
highlighted in yellow or red.  (If the client is an older version not
supporting severity, the title will be highlighted in yellow when any
messages are present.) These messages can
be read on the Torrent Details screen.  Bandwidth limits may also be
highlighted in yellow or green if they have been adjusted on the
Advanced Limits screen.

<P>The "Show peers" option will list each torrent's peers below the
torrent's status information.  For more information, see the Torrent Details
screen description below.


<P><BR>
<H3>Terminated Torrents</H3>
<P>
Clients that have disconnected from CTCS (assumed to have terminated)
are listed in the lower portion of the display.

<CENTER><HR width=50%></CENTER>
<FORM METHOD=POST ACTION="#/dead">
<TABLE BORDER width=100%>
<TR bgcolor="#cccccc"><TD colspan=5>[Del] <B>Torrent</B>
	<TD colspan=3 align=right>End Time</TR>
<TR bgcolor="#cccccc"><TD>Seed<TD>Leech<TD>Complete
	<TD align=right>DL Rate<TD align=right>UL Rate
	<TD align=right>DL Total<TD align=right>UL Total
	<TD align=right>Limit D/U</TR>


<TR bgcolor="#ccccff"><TD colspan=5><input type=hidden name="t2id" value="-CD0202-B0x98A9186CAB0D40611122D1"><input type=checkbox name="t2del" value=1> <A HREF="#/torrent/-CD0202-B0x98A9186CAB0D40611122D1"><B>Finished example 4.torrent</B></A>
	<TD colspan=3 align=right>Sat Dec 24 19:09:55 2005</TR>
<TR><TD>S: 0/1<TD>L: 5/5<TD>100%
	<TD align=right>D= 0 B/s<TD align=right>U= 16 K/s
	<TD align=right>D= 720&nbsp;M<TD align=right>U= 136&nbsp;M
	<TD align=right>0 / 15 K/s</TR>


<TR bgcolor="#ccccff"><TD colspan=5><input type=hidden name="t3id" value="-CD0202-0x834894CA549155083E4635F1"><input type=checkbox name="t3del" value=1> <A HREF="#/torrent/-CD0202-0x834894CA549155083E4635F1"><B>Dead example 5.torrent</B></A>
	<TD colspan=3 align=right>Sun Jan  1 23:37:15 2006</TR>
<TR><TD>S: 0/2<TD>L: 13/14<TD>100%
	<TD align=right>D= 0 B/s<TD align=right>U= 14 K/s
	<TD align=right>D= 435&nbsp;M<TD align=right>U= 1937&nbsp;M
	<TD align=right>0 / 13 K/s</TR>

</TABLE>
<TABLE BORDER=0 width=100%><TR>
	<TD align=left><input type=submit name=submit value="Delete">
	<TD align=right><input type=submit name=submit value="Delete All">
</TABLE>
</FORM>
<CENTER><HR width=50%></CENTER>

This is just like the list of active torrents except that the end time
replaces the start time.  The last known status information is shown,
which is normally the final status unless the client terminated
abnormally (crashed).  The Torrent Details screen (click the title) is
an abbreviated version, allowing you to see the share ratio and any
messages.

<P>To remove a torrent from the list, check the box next to it and click
the Delete button at the bottom left of the list.  To clear the entire
list, click the Delete All button at the bottom right.


<H2><HR><A NAME="details">Torrent Details</A></H2>
<P>
This screen shows detailed information about a particular client.

<CENTER><HR width=50%></CENTER>
<CENTER>
Upload/Download Ratio:  <B>2.83</B>
<BR>Seed time remaining: <B> 54 hours 11 minutes</B>
</CENTER>
<CENTER><HR width=50%></CENTER>

If nothing has been downloaded, the full size of the torrent is used
as the amount downloaded; if you are only seeding, then the ratio
effectively shows how many times you have uploaded the torrent.

<P>The time remaining is an estimate based on the current download rate,
current upload rate and target ratio, or actual seed time remaining.

<P><BR>
<H3>Configuration</H3>
<P>
Several configuration parameters can be changed in this part of the
display.

<CENTER><HR width=50%></CENTER>
<FORM METHOD=POST ACTION="/torrent/-CD0301-%7B0xD529E46881CF5DD4E37DF6">
<CENTER><TABLE BORDER>
<TR bgcolor="cccccc"><TD colspan=3 align=center>Configuration</TR>
<TR><TD>Verbose output [-v]
   <TD align=center><INPUT type="checkbox" name="verbose" value="0">
   <TD>Disabled</TR>
<TR><TD>Seed time [-e]
   <TD align=center><INPUT type="text" size=5 name="seed_time" value="72">
   <TD>~hours remaining (-e 72)</TR>
<TR><TD>Seed ratio [-E]
   <TD align=center><INPUT type="text" size=5 name="seed_ratio" value="0.00">
   <TD>Upload:Download</TR>
<TR><TD>Max peers [-M]
   <TD align=center><INPUT type="text" size=5 name="max_peers" value="100">
   <TD>Current peers: 5</TR>
<TR><TD>Min peers [-m]
   <TD align=center><INPUT type="text" size=5 name="min_peers" value="1">
   <TD>Current peers: 5</TR>
<TR><TD>Download files [-n]
   <TD colspan=2 align=center><INPUT type="text" size=30 maxlength=1024 name="file_list" value="">
   </TR>
<TR><TD>Cache size [-C]
   <TD align=center><INPUT type="text" size=5 name="cache" value="16">
   <TD>MB; 3552KB now in use</TR>
<TR><TD>Pause torrent
   <TD align=center><INPUT type="checkbox" name="pause" value="0">
   <TD>Stop upload/download</TR>
<TR><TD>Completion command [-X]
   <TD colspan=2 align=center><INPUT type="text" size=30 maxlength=1024 name="user_exit" value="">
   </TR>
<TR><TD>Normal/status output
   <TD colspan=2 align=center><INPUT type="text" size=30 maxlength=1024 name="out_normal" value="stdout">
   </TR>
<TR><TD>Interactive output
   <TD colspan=2 align=center><INPUT type="text" size=30 maxlength=1024 name="out_interact" value="stdout">
   </TR>
<TR><TD>Error/warning output
   <TD colspan=2 align=center><INPUT type="text" size=30 maxlength=1024 name="out_error" value="stderr">
   </TR>
<TR><TD>Debug/verbose output
   <TD colspan=2 align=center><INPUT type="text" size=30 maxlength=1024 name="out_debug" value="stderr">
   </TR>
<TR><TD>Console input
   <TD colspan=2 align=center><INPUT type="text" size=30 maxlength=1024 name="input" value="stdin">
   </TR>
<TR><TD>CTCS server
   <TD colspan=2 align=center><INPUT type="text" size=30 maxlength=1024 name="ctcs_server" value="localhost:2780">
   </TR>
<TR><TD colspan=3 align=center><INPUT TYPE="submit" NAME="ctconfig" VALUE="Submit"></TR>
</TABLE></CENTER></FORM>
<CENTER><HR width=50%></CENTER>

Note that the available options and their descriptions are now determined
by the client and are only presented by CTCS.  For details, see the
Enhanced CTorrent User's Guide (command-line options and operator menu).

<P>For parameters that have a corresponding command-line option, the
option letter is shown in brackets next to the parameter name.
Certain items may be highlighted when active or to draw attention;
this does not indicate a problem.

<P>Note that for "Seed time" an approximation of the number of hours
remaining is shown, and a new value entered will be interpreted the
same way.  While a decimal value may be shown, the current client will
use only the integer portion of any new value entered.
The total number of seed hours (as it would have been given
on the command line when starting the program), of dubious
usefulness, is given in parentheses.

<P>Other features are:
<DL>
<DT>Pause torrent
<DD>This will cause the client to temporarily stop transferring data
(uploading and downloading torrent content).
<DT>I/O channel redirection
<DD>The targets for the console input and output channels can be changed.
</DL>


<P><BR>
<H3>Actions</H3>
<P>
This section allows you to cause the client to perform an action.

<CENTER><HR width=50%></CENTER>
<FORM METHOD=GET ACTION="#/tracker/-CD0202-%7B0xD529E46881CF5DD4E37DF6">
<CENTER><TABLE BORDER>
<TR bgcolor="cccccc"><TD colspan=3 align=center>Actions</TR>
<TR><TD>Update
	<TD align=center><INPUT type="radio" name="tracker" value="update" checked>
	<TD>Update tracker stats &amp; get peers</TR>
<TR><TD>Restart
	<TD align=center><INPUT type="radio" name="tracker" value="restart">
	<TD>Restart the tracker session</TR>
<TR><TD>Terminate
	<TD align=center bgcolor="#ff6666"><INPUT type="radio" name="tracker" value="quit">
	<TD>Stop torrent (quit)</TR>
<TR><TD colspan=3 align=center><INPUT TYPE="submit" VALUE="Perform"></TR>
</TABLE></CENTER></FORM>
<CENTER><HR width=50%></CENTER>

<DL>
<DT>Update
<DD>Force a normal update connection to the tracker.
<DT>Restart
<DD>This may be handy if messages from the tracker indicate that your client is
    no longer registered.  You will connect to the tracker as if the client
    just started.
<DT>Terminate
<DD>Stop the client in a normal manner (as when seeding has completed or the
    user hits control-c).  This option is tinted red to help avoid
    accidental selection.
</DL>


<P><BR>
<H3>Messages</H3>
<P>
If any status messages have been received from the client, they are
listed next.  Messages are color-coded according to severity (supported
with Enhanced CTorrent dnh2.2 and later).

<CENTER><HR width=50%></CENTER>
<FORM METHOD=GET ACTION="#/torrent/-CD0202-0x8E7D7F9BDCAC13A83DEE524A/clearmsgs">
<CENTER><TABLE BORDER>
<TR bgcolor="#cccccc"><TD align=center>Messages</TD></TR>
<TR bgcolor="#ffff66"><TD align=left><PRE style="margin-bottom: 0pt;">
Tue Jan  3 23:24:47 2006 warn, connect to tracker failed:  Operation timed out
Tue Jan  3 23:19:04 2006 warn, received nothing from tracker!
</PRE></TD></TR>
<TR><TD align=center><INPUT TYPE="submit" VALUE="Clear"></TR>
</TABLE></CENTER></FORM>
<CENTER><HR width=50%></CENTER>

To acknowledge the messages (which clears the list from CTCS memory),
click the Clear button.


<P><BR>
<H3>Files</H3>
<P>
The component files of the torrent are listed next.

<CENTER><HR width=50%></CENTER>
<FORM METHOD=POST ACTION="/files/-CD0301-%7B0xD529E46881CF5DD4E37DF6">
<CENTER><TABLE BORDER>
<TR bgcolor="#cccccc"><TD align=right>File
	<TD>Name<TD align=right>Size<TD align=right>Complete
	<TD align=right>Available<TD align=center>Priority</TR>
<TR><TD align=right>1<TD>Main.dat
   <TD align=right>393&nbsp;M<TD align=right>90%<TD align=right>100%<TD align=center><INPUT type="text" name="f1pri" size=5 value=""></TR>
<TR bgcolor="#ccffcc"><TD align=right>2<TD>readme.txt
   <TD align=right>2&nbsp;K<TD align=right>100%<TD align=right>100%<TD align=center><INPUT type="text" name="f2pri" size=5 value=""></TR>
<TR><TD colspan=2>Total<TD align=right>393&nbsp;M<TD colspan=2><TD align=center ><INPUT TYPE="submit" VALUE="Set"></TR>
</TABLE></CENTER>
<CENTER><HR width=50%></CENTER>

The file number, name, size (scaled to bytes, kilobytes, or megabytes),
percentage complete, and percentage available are shown.
Files which are complete (all available pieces have been downloaded) are
tinted green.  Partial availability is indicated by yellow tint; zero
availability is indicated by red.
If using the "-n" option to download specific files, the current files in
progress are tinted blue.

<P>If the "-n" option is in use, the prority of each file is indicated
in the rightmost column.  Files with priority "1" are included in the
first group to be downloaded; files of the same priority will be
downloaded together.  The priorities can be altered by changing the
values and clicking the "Set" button.  This is equivalent to changing
the "-n" configuration option, and the changes will be reflected in
that value as well.


<P><BR>
<H3>Status and Peers</H3>
<P>
This section is similar to what is displayed on the All Torrents
screen.

<CENTER><HR width=50%></CENTER>
<TABLE BORDER width=100%>
<TR bgcolor="#cccccc"><TD colspan=5><B>Torrent</B>
	<TD colspan=3 align=right>Start Time</TR>
<TR bgcolor="#cccccc"><TD>Seed<TD>Leech<TD>Complete
	<TD align=right>DL Rate<TD align=right>UL Rate
	<TD align=right>DL Total<TD align=right>UL Total
	<TD align=right>Limit D/U</TR>

<TR bgcolor="#ccccff"><TD colspan=5><A HREF="#/torrent/-CD0202-%7B0xD529E46881CF5DD4E37DF6"><B>Example 1.torrent</B></A>
	<TD colspan=3 align=right>Tue Jan  3 21:24:27 2006</TR>
<TR bgcolor="#ccccff"><TD>S: 0/4<TD>L: 8/9<TD>100%
	<TD align=right>D= 0 B/s<TD align=right>U= 15 K/s
	<TD align=right>D= 393&nbsp;M<TD align=right>U= 1113&nbsp;M
	<TD align=right>0 / 17 K/s</TR>

<TR bgcolor="#ccffcc"><TD colspan=5>-BC0060-0x1B5809A843282B5EE23CEC0F<TD colspan=2>00.131.203.0<TD>BitComet 0060</TR>
<TR><TD bgcolor="#909090" align=center>Cn<TD bgcolor="#d0d0d0" align=center>Ci
	<TD bgcolor="#ffbfbf" align=right> 77%
	<TD align=right>-<TD align=right>-
	<TD align=right>-<TD align=right>-
<TR bgcolor="#ccffcc"><TD colspan=5>-BC0060-5)0x9881006F56E31AA742F8<TD align=center colspan=2>0.255.161.000<TD>BitComet 0060</TR>
<TR><TD bgcolor="#909090" align=center>Cn<TD bgcolor="#d0d0d0" align=center>Ci
	<TD bgcolor="#ff3333" align=right> 20%
	<TD align=right>-<TD align=right>-
	<TD align=right>-<TD bgcolor="#e0bbff" align=right>U= 192&nbsp;K</TR>
<TR bgcolor="#ccffcc"><TD colspan=5>-BC0060-0x09645C51208ADDB8D53E29F7<TD align=center colspan=2>00.171.219.0<TD>BitComet 0060</TR>
<TR><TD bgcolor="#909090" align=center>Cn<TD align=center>Ui
	<TD bgcolor="#ff0000" align=right>  2%
	<TD align=right>-<TD bgcolor="#cc88ff" align=right>U= 2457&nbsp;B/s
	<TD align=right>-<TD bgcolor="#e0bbff" align=right>U= 496&nbsp;K</TR>
<TR bgcolor="#ccffcc"><TD colspan=5>-BC0060-0x01DE4ED5BB6797CC6C58EF1E<TD align=center colspan=2>0.48.201.000<TD>BitComet 0060</TR>
<TR><TD bgcolor="#909090" align=center>Cn<TD align=center>Ui
	<TD bgcolor="#ff1919" align=right> 10%
	<TD align=right>-<TD bgcolor="#cc88ff" align=right>U= 7372&nbsp;B/s
	<TD align=right>-<TD bgcolor="#e0bbff" align=right>U= 4320&nbsp;K</TR>
<TR bgcolor="#ccffcc"><TD colspan=5>-BC0059-0xE507A66333F2A020E7DBFC42<TD align=center colspan=2>00.245.89.00<TD>BitComet 0059</TR>
<TR><TD bgcolor="#909090" align=center>Cn<TD bgcolor="#d0d0d0" align=center>Ci
	<TD bgcolor="#ffa5a5" align=right> 65%
	<TD align=right>-<TD align=right>-
	<TD align=right>-<TD bgcolor="#e0bbff" align=right>U= 1072&nbsp;K</TR>
<TR bgcolor="#ccffcc"><TD colspan=5>exbc0x01014C4F524497240602B5B8E07B3AA3<TD align=center colspan=2>0.95.210.00<TD>BitLord 1.1</TR>
<TR><TD bgcolor="#909090" align=center>Cn<TD align=center>Ui
	<TD bgcolor="#ff3333" align=right> 23%
	<TD align=right>-<TD bgcolor="#cc88ff" align=right>U= 1638&nbsp;B/s
	<TD align=right>-<TD bgcolor="#e0bbff" align=right>U= 8592&nbsp;K</TR>
<TR bgcolor="#ccffcc"><TD colspan=5>-BC0059-0x9F1995D00E3BA5EF9ABEE4F8<TD align=center colspan=2>0.74.215.00<TD>BitComet 0059</TR>
<TR><TD bgcolor="#909090" align=center>Cn<TD bgcolor="#d0d0d0" align=center>Ci
	<TD bgcolor="#ff7272" align=right> 49%
	<TD align=right>-<TD align=right>-
	<TD align=right>-<TD bgcolor="#f5e5ff" align=right>U= 11&nbsp;M</TR>
<TR bgcolor="#ccffcc"><TD colspan=5>-AZ2306-kW66DYIl3XoE<TD align=center colspan=2>00.183.31.0<TD>Azureus 2306</TR>
<TR><TD bgcolor="#909090" align=center>Cn<TD align=center>Ui
	<TD bgcolor="#ffe5e5" align=right> 93%
	<TD align=right>-<TD bgcolor="#cc88ff" align=right>U= 5734&nbsp;B/s
	<TD align=right>-<TD bgcolor="#f5e5ff" align=right>U= 38&nbsp;M</TR>
</TABLE>
<CENTER><HR width=50%></CENTER>

The currently connected peers are listed below the client status
information.  The peer ID, IP address, and software name and version
(if identified) are tinted green.  Below this (mostly in white) is status
information for that peer.  The first field shows "C" or "U" to
indicate whether the connection is choked or unchoked for downloading,
followed by "i" or "n" to indicate whether your client is interested
(or not) in downloading from the peer.  The second field shows the
same information for uploading to the peer (whether you have choked the peer
and whether he is interested in your data).  The third field is the
percentage of pieces that the peer has.  The next two fields
are your client's current download and upload rates to the peer, and
the last two are the total amount your client has downloaded from and
uploaded to the peer.
<P>
Some information is color-coded to make it easier to interpret.
Uninterested ("n") connections are shaded light gray.  The percentage
complete is shaded red according to its value, with 0% being pure red and
100% being white.  The transfer rates and totals are shaded purple according
to scale: white for a blank (zero) entry, light for M, medium for K, and
dark for B.  This should make it easier to visually compare numbers of
similar magnitude.


<H2><HR><A NAME="alimits">Advanced Limits</A></H2>
<P>
This screen allows fine-tuning of the client bandwidth limits.

<CENTER><HR width=50%></CENTER>
<FORM METHOD=POST ACTION=#/alimits>
<CENTER>
<TABLE BORDER>
<TR bgcolor="#cccccc"><TD rowspan=2>Torrent
   <TD colspan=2 align=center>Current Rate
   <TD colspan=2 align=center>Limit
   <TD colspan=2 align=center>Minimum
   <TD colspan=3 align=center>Maximum
   <TD colspan=2 align=center>Shared
</TR>
<TR bgcolor="#cccccc">
   <TD align=center>DL<TD align=center>UL
   <TD align=center>DL<TD align=center>UL
   <TD align=center>DL<TD align=center>UL
   <TD align=center>DL<TD align=center>UL<TD align=center>SR
   <TD align=center>DL<TD align=center>UL
</TR>
<TR><TD>Example 2.torrent
	<input type=hidden name="t1id" value="-CD0202-P0xE9C43CD51BA8C5B319601A">
	<TD align=right>0
	<TD align=right>13
	<TD align=right><input type=text size=4 align=right name="t1dlimit" value=0 disabled><input type=hidden name="t1xdlimit" value=0>
	<TD align=right><input type=text size=4 align=right name="t1ulimit" value=13><input type=hidden name="t1xulimit" value=13>
	<TD align=right><input type=text size=4 align=right name="t1mindl" value=0 disabled>
	<TD align=right><input type=text size=4 align=right name="t1minul" value=0>
	<TD align=right><input type=text size=4 align=right name="t1maxdl" value=0 disabled>
	<TD align=right><input type=text size=4 align=right name="t1maxul" value=0>
	<TD align=left><input type=checkbox name="t1maxratio" value=1 disabled>
	<TD align=center><input type=checkbox name="t1sharedl" value=1 disabled>
	<TD align=center><input type=checkbox name="t1shareul" value=1 checked>
</TR>
<TR><TD>Example 1.torrent
	<input type=hidden name="t2id" value="-CD0202-%7B0xD529E46881CF5DD4E37DF6">
	<TD align=right>0
	<TD align=right>11
	<TD align=right><input type=text size=4 align=right name="t2dlimit" value=0 disabled><input type=hidden name="t2xdlimit" value=0>
	<TD align=right><input type=text size=4 align=right name="t2ulimit" value=10><input type=hidden name="t2xulimit" value=10>
	<TD align=right><input type=text size=4 align=right name="t2mindl" value=0 disabled>
	<TD align=right><input type=text size=4 align=right name="t2minul" value=0>
	<TD align=right><input type=text size=4 align=right name="t2maxdl" value=0 disabled>
	<TD align=right><input type=text size=4 align=right name="t2maxul" value=0>
	<TD align=left><input type=checkbox name="t2maxratio" value=1 disabled>
	<TD align=center><input type=checkbox name="t2sharedl" value=1 disabled>
	<TD align=center><input type=checkbox name="t2shareul" value=1 checked>
</TR>
<TR><TD>Example 3.torrent
	<input type=hidden name="t3id" value="-CD0202-0xCCEFB5B7D53349B364737755">
	<TD align=right>8
	<TD align=right>12
	<TD align=right><input type=text size=4 align=right name="t3dlimit" value=100><input type=hidden name="t3xdlimit" value=100>
	<TD align=right><input type=text size=4 align=right name="t3ulimit" value=12><input type=hidden name="t3xulimit" value=12>
	<TD align=right><input type=text size=4 align=right name="t3mindl" value=0>
	<TD align=right><input type=text size=4 align=right name="t3minul" value=0>
	<TD align=right><input type=text size=4 align=right name="t3maxdl" value=0>
	<TD align=right><input type=text size=4 align=right name="t3maxul" value=0>
	<TD align=left><input type=checkbox name="t3maxratio" value=1>0
	<TD align=center><input type=checkbox name="t3sharedl" value=1 checked>
	<TD align=center><input type=checkbox name="t3shareul" value=1 checked>
</TR>
</TABLE>
<BR><input type=submit value="Submit">
</CENTER></FORM>
<CENTER><HR width=50%></CENTER>

Due to the complexity of these options, usage notes are displayed
directly on the screen:
<P><B>Notes</B><BR>
<UL>
<LI>All values are in kilobytes per second (KB/s).
<LI>Options related to downloading are disabled for torrents that are seeding.
<LI>Use caution when changing current limits to below the current rate--small
  increments are recommended.
<LI>"Minimum" and "Maximum" are soft limits.  They will be enforced when there
  is competition for bandwidth; otherwise the torrent is free to give or take
  unused bandwidth.
	<UL>
	<LI>Minimum:  If the torrent wants bandwidth up to this level, it will
     receive it at the expense of other torrents.  It will not be forced or
     held below this level if it wants (is using) the bandwidth.  Use to
     high-prioritize a torrent, or to guarantee a bandwidth allocation amount
     to a torrent.
	<LI>Maximum:  The torrent will be forced down to this level if other
     torrents want bandwidth.  Use to low-prioritize a torrent, or to limit the
     amount of bandwidth this torrent is allowed to consume at the expense of
     other torrents.
	<LI>SR:  The maximum upload limit will be adjusted based on the torrent's
     seed ratio ("-E" option, shown), current share ratio, and current
     download rate.  It will not be increased above the Maximum or decreased
     below the Minimum, if specified.  This option does not apply when seeding,
     and has no effect if the seed ratio is unset (zero).  Use to avoid giving  
     away too much upload bandwidth when you have other torrents running that   
     could use it more fairly.
	</UL>
<LI>"Shared" indicates whether the torrent's bandwidth is counted against the
  shared pool represented by the global limit on the main CTCS page.  CTCS will
  dynamically manage the client's bandwidth only if the Shared option is
  checked.
<LI>Use a value of 0 to disable/remove a limit.
<LI>Non-default settings are highlighted in yellow and green.  The limit field
  in torrent status displays will also be highlighted as a reminder.  Red
  highlight indicates an unknown value; you should refresh before making
  changes.
<LI>After submitting changes, you may need to refresh the page after a second
  or two in order to see the resulting updates.
</UL>

<P><HR>
</BODY></HTML>