---| CCCP 0.9
Red Connect Console Program
by: hampa@chello.se
Licence: GPL 2
http://members.chello.se/hampasfirma/cccp/index.html


1. About
2. Installing
3. Scripting
4. Getting Started 
5. Contributors


---| About

CCCP is a console front end to Direct Connect Text Client. 

Direct Connect is a filesharing program made by
neo modus (http://www.neo-modus.com).


---| Installing

First make sure you have DCTC on your system,
cccp uses dctc which can be found at:
http://ac2i.tzo.com/dctc/

Then install CCCP:
make && make install


---| Scripting

With installtion comes some example scripts that uses cccp. Check
the /scripts/SCRIPTS file for a complete description of all scripts.


---| Getting Started

Searching:
---------
usage:
cccp -s pattern filetype
filetypes are 1-any, 2=audio,3=compressed,4=document,5=exe,6=picture,7=video,8=folder

Ex:
Search for divx movies:
cccp -s divx 7

Downloading:
------------
cccp -d *nick*[localfile]*remotefile*filesize

Ex:
1. Download Blockbuster.mpg from the user hampa and save it as the same name:
cccp -d "*hampa**c:\DirectConnect\File share\Blockbuster.mpg*6723444"

Scripting:
The dlsearchresult script will download all files that are piped to it in
the format that -s outputs.

Ex:
cccp -s divx 7 | grep Lord | ./dlsearchresult

Queues:
-------
cccp -q
This will output your command queue.

Scripting:
the clearqueue script will clear all queued commands.
the dq script will show a list of queues and let you specify which one to stop.

Transfers:
----------
cccp -t
This will output your current and pending downloads.

Users:
-----
List all users;
cccp -u

Show user info:
cccp -n nickname

List all files from a user:
cccp -l nickname

Scripting:
the listall script will list all files from all users. This can take a long
time and will output alot of files. On my hub that I am testing this on now
I get aproximately 1000000 lines (yes.. one million files).

ex:
./listall
this will produce a listall.log file with all the files.

Segmented downloading:
------------------

With segmented downloading you can download from several sources at the same time.

List your segmented downloads and queues:
cccp -gq		Group Quick List
cccp -gl 	Group List (this list has more information)

Create a new segmented group:
cccp -gn gdlid filesize filename

Add file to group download:
cccp -ga gdlid nickname remotefilename remotefilesize

Remove segmented groups and downloads:
cccp -gd gdlid   Delete download
cccp -ge gdlid   End group download



Other switches:
---------------

-h		Print usage 
--help print usage
-o		This will print the output from dctc to stdout.
-O		This will suppres output (-o is default with -s -q)
-N		This will suppres all errors from DCTC (ERR ""]).
-t		This will set the timeout on searches. -t 5 means that
		if a search has not returned any more results for the 
		past 5 seconds cccp will exit. Default is 10 seconds.

-H 	use hub with the substring.
		It is possible to start several instances of dctc. This switch lets
		you specify which one to connect to. You only need to specify a substring
		of the hubname you wish to connect to.

-L		List the hubnames dctc clients are connected to.
-S		TimeStamp output. if -o flag this will put an timestamp on output.
-x		make DCTC client exit. Wait for dl to finnish first.
-X		force DCTC to exit. Dont wait for dl to finnish first.
		
example:
[hampa@chello]$ cccp -L
dctc-00031Ef-startrekworld.sytes.net
dctc-00003571-kronprinsen71.dns2go.com
[hampa@chello]$ cccp -H kron

-r		This will send the specifyed string to dctc. All commands in dctc are
		not implemented as swiches in cccp.

example:
$cccp -r "DESC 10 gig love"
this will change your description to a new one.

$cccp -r "OFFSET 1000000"
This will add 1 million bytes to the size of your shared data.

For more commands. See the dctc/Documentation/commands file.


5. Contributors
---------------

Great thanks to the people who have helped with patches, scripts and
suggestions. If I have forgotten anyone, please let me know.

Grzegorz Prokopski <gadek@debian.org> - debian package maintainer
SlvWolf <slvwolf@furry.2y.net> - helped me with scripts 
Blues <blues@ds6.pg.gda.pl> - rpm package and Makefile
Robert Winder <r.winder@home.nl> - bug report
Aubin Paul <aubin@debian.org> - bug fixes
Charles Simpson <archknyght@yahoo.com> - bug fixes




