***********************
**	DConnect Daemon
**	dcd 0.2.9
***********************


What is it?
-----------

DConnect Daemon is a D*rect Connect Hub clone for Linux. It allow people to
share their resources, i.e.: programs, graphics, all files ...


Features
--------

* fast, pure C implementation
* libwrap support (hosts.allow, hosts.deny)
* low memory per user consumption
* uses threads (no forking)
* nick pattern matching
* simple administration throught telnet console
* should work on every Unix system (tested in Linux and Solaris)


License
-------

GPL version 2. See COPYRIGHT file shipped with sources for details.


Requirements
------------

To compile DConnect Daemon, you will need:

* libwrap
* libpthread
* automake (recommended min. 1.6)
* autoconf >= 2.50
* libtool
* gettext (not used now...)

Instalation
-----------

In most cases this procedure should work:

$ cd dcd-0.2.9
$ ./configure
$ make
$ make install

You may propably use some traditional configure options.
There are dcd-specific options, but you propably don't have to worry 
about it.

   --with-config-dir=PATH	- where to look for configuration file. 
   				You can use --sysconfdir too - there is no 
				difference.
   --with-libwrap-path=LIBPATH	- Where to look for libwrap?
   
   --with-log-dir=DIR		- Where should be logs placed. Default
     				location is /var/log/dcd - you shouldn't have
				to change it.

   --with-user=USER		- Set default user. We STRONGLY advise to make
   				your own user and put it here. Default is daemon,
				because it's present in every Unix system.

   --with-group=GROUP		- Set default group. You should make your own group.
   				Default is set to daemon, because this group is
				present on every Unix system.


Usage
-----

In directory ${prefix}/etc you have config files. Most of them have sufficient
comments :)
console.allow	- from which hosts you can login to telnet console. By default
		here is only 127.0.0.1, but you may add other hosts too.
		Remember that this is clean tekst login!! Do this only in 
		trusted networks.
console.users	- file with users accounts. Syntax:
		login:password:e-mail:description:permissions
		login - you know what is that :)
		password - written in clean text password. There will be soon
			option to put here crypted or somehow encrypted
			password.
		e-mail - this e-mail will be shown on userlist
		description - this will be shown on userlist too
		permisions - what this user can do on hub:
			c - access to console
			a - administrator
			none - regular user
dcd.banned	- users that are banned. Syntax:
		IP:reason
		When user tries to enter he is disconnected after receiving
		reason.
dcd.conf	- main configuration of daemon. Look in config comments for
		details.
dcd.motd	- message that user will see after logging in.
dcd.welcome	- message sent before login. Usefull to put rules.
nicks.allow	- patterns that nicks must match. Every line is one rule.

By default daemon binds to port 411 and telnet console to 511. You can login
to console:
$ telnet localhost 511

To know what command you have avaible, type help.

You can reconfigure dcd sending HUP signal to the process or rehash
command from telnet console.


Bugs
----

We know that there are a lot of them... see BUGS
If you find any - tell us about it: dc-hub@ds.pg.gda.pl
