
README for the crocodiles package

(c) Alexander Feldman, April 1999

ABSTRACT
========

This file describes the crocodiles suite, hereafter reffered to as THE PROGRAM.
It is a client/server package allowing Internet Server Providers to sell time
and traffic.
The server package is developed on Slackware 3.5 platform but there is a small
probability to fail on other linux distributions. I hope I'll receive more
information when it is installed on other platforms to comment here.
The crocodiles package attempts to automate the work of an ISP. It has an
accounting server and uses its own scheme to manage logins and log outs.
Once you have installed this software you can sell online time and traffic
to all kind of users - statically linked to your network like Ethernet
workstations or dial-up ones.
Now there are cgi based clients to manage accounts but another clients are
planned as follows:
	In version 0.02 - X based client
	In version 0.03 - ncurses based client
	In version 0.04 - Windows32 based graphical client
	In version 0.05 - Linux command line oriented client
New features are planed in the next versions:
	In version 0.06 - New login replacement for dial-up users.
	In version 0.07 - E-mail notification to users for used time and traffic.

Remember to visit the crocodiles home-page at
 
	http://www.varna.net/~alex/crocodiles/
	
for the latest information.

REQUIREMENTS
============

To be able to use crocodiles, you need several things:

 1. Linux firewall host. Perhaps you already have this.
 2. Kernel 2.0.0 or newer for the firewall host.
 3. Passwdd-0.02 or newer. This is a free replacement of NIS and you can
    download it from ftp://ftp.varna.net/pub/linux/passwdd or from
	 ftp://metalab.unc.edu/pub/Linux/security.
 4. Web server and PERL interpreter to be able to use the cgi based client.

VERSION
=======

This is development version 0.01. The first stable version will be 0.1.

INSTALLATION
============
To compile and install passwdd daemon and client for linux, on all clients
and servers please do a

edit top lines of Makefile.in in the root of the archive
./configure
make
su
make install
make install-cgi (for the cgi client)
edit /etc/alligator.conf
edit /etc/mugger.conf
edit /erc/alligator-client.conf

Note you have to be root to install server because passwdd needs sticky bit
to be set-up to be able to write to the shadow file.

For more information or if you have any questions:
alex@varna.net

PLATFORMS
=========

Slackware Linux 3.5

I'll make all my best to port this software for other platforms but for now I
do not know whether I'll have the ability.

TODO
====

A lot of things.

WHERE TO GET
============

ftp://ftp.varna.net/pub/linux/crocodiles

COPYING
=======

Crocodiles is Shareware which means that you can use it legally for 21 days
free of charge to evaluate it. If during, or at the end of, that period you
decide that you would like to continue using it, please register your copy.
Your registration will license you to use your copy of crocodiles, will
support work on future versions, new features, and bug fixes, and will
provide you with technical support via email.

ONCE YOU REGISTER YOU WILL RECEIVE VERSIONS UP TO AND INCLUDING 0.07 AT NO
CHARGE. YOU CAN READ THE ABOVE SECTION WHAT FEATURES WILL BE INCLUDED THERE.

THE DISTRIBUTION OF THIS SOFTWARE IN BULGARIA MEETS SPECIAL RULES.

ALL OTHER COUNTRIES MEETS THE STANDARD CONDITIONS.

Crocodiles may be freely distributed subject to, but not limited to,
the following terms: Crocodiles may not be sold or resold, distributed
as a part of any commercial package, used in a commercial environment,
used or distributed in support of a commercial service, or used or
distributed to support any kind of profit-generating activity, even if
it is being distributed freely.

If you would like to distribute Crocodiles as part of a share-ware
distribution, magazine, Internet book, CD ROM, etc. please contact me for
permission.

All commercial use interests in crocodiles should be directed to
alex@varna.net

crocodiles is provided "AS IS" without warranty of any kind, either
express or implied, including but not limited to the implied warranties of
merchantability and fitness for a particular purpose. In no event shall
Alexander Feldman be liable for any damages whatsoever including direct,
indirect, incidental, consequential, loss of business profits or special
damages, even if Alexander Feldman has been advised of the possibility of
such damages.

To register crocodiles you have to send USD 75 (seventy five united states
dollars) to:

Alexander Feldman
60, Radko Dimitriev Str.
9000 Varna
Bulgaria

You can use all kind of cheques.

Special rules applies only to territory of Bulgaria:

Contact the author for more information.