ctorrent

Langue: en

Version: 312130 (ubuntu - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

ctorrent --- program that allows a user to download bittorrent files by using a terminal, even used remotely with an ssh access

SYNOPSIS

ctorrent [General Options] [Download Options] [Make Torrent Options] file.torrent

CTorrent is a BitTorrent Client written in C that doesn't require any graphical component, such as an X server. It's built as a console program and it can be even used remotely in a machine that provides outside ssh access.

This manual page was written for the Debian distribution because the original program does not have a manual page.

OPTIONS

Ctorrent uses short-style options. It can be run in two modes: Download mode (where it parses a torrent file and acts as a peer or seeder to transfer files), and Make Torrent mode (where it creates a torrent control file out of given files). Additionally, there are a few General Options that are always valid.

GENERAL OPTIONS

-h/-H
Show this message
-x
Decode metainfo (torrent) file only, don't download
-c
Check pieces only, don't download
-v
Verbose output (for debugging)

DOWNLOAD OPTIONS

-e int
Exit while seed hours later (default 72 hours)
-E num
Exit after seeding to ratio (UL:DL)
-i ip
Listen for connections on specific IP address (default all/any)
-p port
Listen port (default 2706 -> 2106)
-s filename
Download ("save as") to a different file or directory
-C cache_size
Cache size, unit MB (default 16MB)
-f
Force saved bitfield or seed mode (skip initial hash check)
-b filename
Specify bitfield save file (default is torrent+".bf")
-M max_peers
Max peers count (default 100)
-m min_peers
Min peers count (default 1)
-z slice_size
Download slice/block size, unit KB (default 16, max 128)
-n file_list
Specify file number(s) to download
-D rate
Max bandwidth down (unit KB/s)
-U rate
Max bandwidth up (unit KB/s)
-P peer_id
Set Peer ID prefix (default "-CD0302-")
-A user_agent
Set User-Agent header (default "Enhanced-CTorrent/dnh3.2")
-S host:port
Use CTCS server at host:port
-a
Preallocate files on disk
-T
Convert foreign filenames to printable text
-X command
Run command upon download completion ("user exit")
-d
Daemon mode (fork to background)

MAKE TORRENT OPTIONS

-t
Create a new torrent file
-u url
Tracker's url
-l piece_len
Piece length (default 262144)
-s filename
Specify metainfo file name

Examples

Download a torrent with a different file name, in foreground (interactive) mode:


ctorrent -s new_filename -e 12 -C 32 -p 6881 example.torrent

Get a torrent file from a server, and start downloading in the background (there won't be a good way to test whether it's done):


wget http://some.server.net/some.torrent
ctorrent -E 1.5 -p 12000 -U 20 -P -AZ2304- -d some.torrent

home page: http://ctorrent.sourceforge.net/

AUTHOR

original author: bsdi@sina.com

This manual page was written for the Debian system (but may be used by others). This document is put into the public domain by its author.