diff -u ctorrent-1.3.4-dnh3.3.2/debian/ctorrent.sgml ctorrent-1.3.4-dnh3.3.2/debian/ctorrent.sgml --- ctorrent-1.3.4-dnh3.3.2/debian/ctorrent.sgml +++ ctorrent-1.3.4-dnh3.3.2/debian/ctorrent.sgml @@ -63,75 +63,259 @@ &dhpackage; - - - -s new_filename - - - - example_torrent + 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. - 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 documents briefly the - &dhpackage; and bar - commands. - - This manual page was written for the &debian; distribution - because the original program does not have a manual page. - Instead, it has documentation in the &gnu; - Info format; see below. - - &dhpackage; is a program that allows you to download bittorrent files using a terminal, without having X support - + 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. + - OPTIONS + GENERAL OPTIONS + + + + + + Show this message + + + + + + + Decode metainfo (torrent) file only, don't download + + + + + + + Check pieces only, don't download + + + + + + + Verbose output (for debugging) + + + + - These programs follow the usual &gnu; command line syntax, - with long options starting with two dashes (`-'). A summary of - options is included below. For a complete description, see the - Info files. + + DOWNLOAD OPTIONS + + + + + + Exit while seed hours later (default 72 hours) + + + + + + + Exit after seeding to ratio (UL:DL) + + + + + + + Listen for connections on specific IP address (default all/any) + + + + + + + Listen port (default 2706 -> 2106) + + + + + + + Download ("save as") to a different file or directory + + + + + + + Cache size, unit MB (default 16MB) + + + + + + + Force saved bitfield or seed mode (skip initial hash check) + + + + + + + Specify bitfield save file (default is torrent+".bf") + + + + + + + Max peers count (default 100) + + + + + + + Min peers count (default 1) + + + + + + + Download slice/block size, unit KB (default 16, max 128) + + + + + + + Specify file number(s) to download + + + + + + + Max bandwidth down (unit KB/s) + + + + + + + Max bandwidth up (unit KB/s) + + + + + + + Set Peer ID prefix (default "-CD0302-") + + + + + + + Set User-Agent header (default "Enhanced-CTorrent/dnh3.2") + + + + + + + Use CTCS server at host:port + + + + + + + Preallocate files on disk + + + + + + + Convert foreign filenames to printable text + + + + + + + Run command upon download completion ("user exit") + + + + + + + Daemon mode (fork to background) + + + + + + MAKE TORRENT OPTIONS - - + - Show summary of options. + Create a new torrent file - - + + + Tracker's url + + + + - Show version of program. + Piece length (default 262144) + + + + + + + Specify metainfo file name + - AUTHOR + Examples - This manual page was written by &dhusername; &dhemail; for - the &debian; system (but may be used by others). Permission is - granted to copy, distribute and/or modify this document under - the terms of the &gnu; General Public License, Version 2 any - later version published by the Free Software Foundation. + 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 - - On Debian systems, the complete text of the GNU General Public - License can be found in /usr/share/common-licenses/GPL. - + 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. diff -u ctorrent-1.3.4-dnh3.3.2/debian/changelog ctorrent-1.3.4-dnh3.3.2/debian/changelog --- ctorrent-1.3.4-dnh3.3.2/debian/changelog +++ ctorrent-1.3.4-dnh3.3.2/debian/changelog @@ -1,3 +1,11 @@ +ctorrent (1.3.4-dnh3.3.2-0ubuntu2) intrepid; urgency=low + + * New upstream release (LP: #293722) + * Additions and updates to debian/ctorrent.sgml to correct invalid details + in manpage + + -- Jay Tulathimutte Sun, 04 Jan 2009 23:34:13 -0800 + ctorrent (1.3.4-dnh3.3.2-0ubuntu1) intrepid; urgency=low * New upstream release (LP: #255036) only in patch2: unchanged: --- ctorrent-1.3.4-dnh3.3.2.orig/debian/watte.1 +++ ctorrent-1.3.4-dnh3.3.2/debian/watte.1 @@ -0,0 +1,109 @@ +.TH "CTORRENT" "1" +.SH "NAME" +ctorrent \(em program that allows a user to download bittorrent files by using a terminal, even used remotely with an ssh access +.SH "SYNOPSIS" +.PP +\fBctorrent\fR [\fIGeneral Options\fR\fP] [\fIDownload Options\fR\fP] [\fIMake Torrent Options\fR\fP] file.torrent +.PP +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. +.PP +This manual page was written for the \fBDebian\fP distribution +because the original program does not have a manual page. +.SH "OPTIONS" +.PP +Ctorrent uses short-style options. It can be run in two modes: \fBdownload mode\fP (where +it parses a torrent file and acts as a peer or seeder to transfer files), and \fBmake torrent\fP +mode (where it creates a torrent control file out of given files). Additionally, there are a few +\fBgeneral options\fP that are always valid. +.PP +.SH "GENERAL OPTIONS" +.LP +\fB\-h/\-H\fP Show this message +.br +\fB\-x\fP Decode metainfo (torrent) file only, don't download +.br +\fB\-c\fP Check pieces only, don't download +.br +\fB\-v\fP Verbose output (for debugging) +.PP +.SH "DOWNLOAD OPTIONS" +.LP +\fB\-e int\fR Exit while seed hours later (default 72 hours) +.br +\fB\-E num\fR Exit after seeding to ratio (UL:DL) +.br +\fB\-i ip\fR Listen for connections on specific IP address (default all/any) +.br +\fB\-p port\fR Listen port (default 2706 -> 2106) +.br +\fB\-s filename\fR Download ("save as") to a different file or directory +.br +\fB\-C cache_size\fR Cache size, unit MB (default 16MB) +.br +\fB\-f\fR Force saved bitfield or seed mode (skip initial hash check) +.br +\fB\-b filename\fR Specify bitfield save file (default is torrent+".bf") +.br +\fB\-M max_peers\fR Max peers count (default 100) +.br +\fB\-m min_peers\fR Min peers count (default 1) +.br +\fB\-z slice_size\fR Download slice/block size, unit KB (default 16, max 128) +.br +\fB\-n file_list\fR Specify file number(s) to download +.br +\fB\-D rate\fR Max bandwidth down (unit KB/s) +.br +\fB\-U rate\fR Max bandwidth up (unit KB/s) +.br +\fB\-P peer_id\fR Set Peer ID prefix (default "-CD0302-") +.br +\fB\-A user_agent\fR Set User-Agent header (default "Enhanced-CTorrent/dnh3.2") +.br +\fB\-S host:port\fR Use CTCS server at host:port +.br +\fB\-a\fR Preallocate files on disk +.br +\fB\-T\fR Convert foreign filenames to printable text +.br +\fB\-X command\fR Run command upon download completion ("user exit") +.br +\fB\-d\fR Daemon mode (fork to background) +.PP +.SH "Make Torrent Options" +.LP +.br +\fB\-t\fR Create a new torrent file +.br +\fB\-u url\fR Tracker's url +.br +\fB\-l piece_len\fR Piece length (default 262144) +.br +\fB\-s filename\fR Specify metainfo file name +.PP +.SH "Examples" +.LP +Download a torrent with a different file name, in foreground (interactive) mode: +.br +\fBctorrent\fR -s new_filename -e 12 -C 32 -p 6881 example.torrent +.LP +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): +.br +\fBwget\fR http://some.server.net/some.torrent +.br +\fBctorrent\fR -E 1.5 -p 12000 -U 20 -P -AZ2304- -d some.torrent +.PP +home page: http://ctorrent.sourceforge.net/ +.br see also: http://www.rahul.net/dholmes/ctorrent/ +.br bug report: dholmes@ct.boxmail.com +.SH "AUTHOR" +.PP +original author: bsdi@sina.com +.PP +This manual page was written for +the \fBDebian\fP system (but may be used by others). This document is put into the public +domain by its author. +