The Internet CD Database Server (cddbd v1.4) README

Copyright (c) 1996  Steve Scherf
A Moondog Software Production

Original version by Steve Scherf (steve@moonsoft.com)

Updated by freedb team in March 2001
Email:	info@freedb.org


INTRODUCTION
------------

The CD Database Server (cddbd) is a program designed to allow remote access
of xmcd-style Compact Disc database entries via the Internet. Xmcd is an
X11/Motif-based CD player utility written by Ti Kan, which, as of version
2.0 supports remote access of CDDB protocol servers. This server also
supports cda 2.0, a command-line driven, non-graphical CD player also
written by Ti Kan.

There's a lot of other client software as well! The list is growing fast.
You can get an actual list at www.freedb.org

Please see the file COPYING for the GNU General Public License.
Please see the file MANIFEST for the list of files in the CDDB server package.
Please see the file CDDBD_HOWTO for information on running the CDDB daemon.
Please see the files CDDBPROTO and DBFORMAT for information on using the
server from an application.

"CD Database Server", "Internet CD Database Server", "CD Server", "Internet
CD Server", "CDDB Protocol Server" and "CDDB Server", are all copyright (c)
1996 by Steve Scherf.

Permission for products to use the source code, text and/or interface
definitions provided in this package is granted with the following
restrictions: products that incorporate use of the CD database server package
in any way must adhere to the language of the GNU GPL, and must explicitly
give credit to the author both in all documentation and when the product is
operating. The latter need not appear conspicuously, but should be
viewable by the user through some obvious means.


NEW FEATURES
------------

New features in cddbd version 1.1:

- The "motd" command. This command will display the contents of the file
  designated by the server administrator as containing the "message of the
  day". This file is intended to contain information relevant to the local
  cddbd site, such as the administrator's email address, et cetera.

- The "log" command. This command displays statistics gathered from the
  message log, such as the total number of messages, the number of
  connections, errors and database accesses.

- Also, several minor fixes were made for portability purposes.


New features in cddbd version 1.2:

- Fuzzy matching of database entries for the "query" command has been
  implemented. If a query fails, cddbd now attempts to find close matches
  in the database and presents the list of matches, if any, to the client.
  Clients such as xmcd will offer the list of alternate choices to the
  user. Different pressings of the same CD may vary slightly in timing,
  so this algorithm is often able to locate database entries that were
  based on a different release of the same CD. So far fuzzy matching seems
  to work well based on this idea.

- The "log" commmand now provides information on the number of successful
  queries and fuzzy matches.


New features in cddbd version 1.3:

- Several enhancements to the "log" command. Log statistics now include
  more information. Log stats for the last day can be displayed with the
  "log day" command. The log file itself can be displayed with the "log get"
  command.

- Auto-truncation of the log file.

- Locking of critical files.

- Support for multiple protocol levels for future enhancements.

- Support for quoted arguments to commands.

- Permission to access the database, post DB entries, et cetera can now
  be controlled based on the user's Internet address.

- Improved the fuzzy match hashing algorithm so that duplicate links
  are excluded from the hash file.

- Complete database management capability.

- Ability to transmit and receive new database entries.

- Standalone server mode.

- Too many other features to list.


New features in cddbd version 1.3.1:

- Support for certain parts of the MIME protocol when processing email.

- Mail test mode which allows clients to submit email test entries
  without adding them to the database.

- Support for varying levels of strictness when verifying database entries.

- Certain reliability enhancements, to thwart malicious users.

- Fix for BSD-based systems to clean up zombie children in standalone mode.


New features in cddbd version 1.4b39:

- support for access via http using cddb.cgi

- Improved database check- and correction-options

- Option to find fuzzy matching files that should possibly be linked

- Many other features


New features/fixes in cddbd version 1.4b39PL1:

- detect bogus CDex DTITLE and TTITLE fields (no artist/no title/AudioTrackXX)
  during cddbd -c

- fixed Y2K problem in logging routines; years are now formatted correctly 

- increased allowable line size in db submissions from 80 to 256 characters

- misc. cleanup to reduce gcc -Wall output (primarily adding missing #includes)

- Updated all documentation-files


New features/fixes in cddbd version 1.4b40

- Added support for protocol level 4 (see CDDBPROTO for details)

- Added "cddb lscat" command to protocol level 1

- Some minor fixes 

New features/fixes in cddbd version 1.4b41

- Added the discid command


SUPPORTED PLATFORMS
-------------------

The server should compile and run on just about any Unix or Unix-like
system. At the time of this release, cddbd has been successfully tested
on numerous platforms, including:

AIX
FreeBSD 2.x
HP-UX 9.x and 10.x
Linux 1.x
OSF/1
SCO UNIX 3.2v4.x or Open Server 5.x
Solaris 2.x
Stratus SVR4 FTX 3.x
SunOS 4.1.x
UnixWare 2.x


ACKNOWLEDGEMENTS
----------------

Credit must go to:
Ti Kan (ti@amb.org) for creating cddb, the CD database, and coming up with the
idea of using the Internet to give users access to the database. His prototype
is the basis for cddbd. 
Steve Scherf (steve@moonsoft.com) for creating the cddbd-server-software.
Without his efford, freedb would not be.
Jeffery Sumler for sending the patch for cddbd version 1.4b39PL1
Oliver Fleischmann for implementing protocol level 4, the lscat and the discid
command.

Thanks go to the many system administrators who have volunteered the use of
their sites as public CD database servers. Without them this probably would
not have become so popular! Thanks also go to the many users who use the
servers every day.


WHERE TO GET CDDBD
------------------

Cddbd servers are maintained at numerous sites on the Internet, but if you
would like to start your own this package contains the source code needed
to do so. This package can be obtained at www.freedb.org in the
downloads-section. The submit.cgi, which is needed for accepting http-submits
can be obtained separately.

The CD database itself is a rather large package that can be acquired
separately. The freedb public CD database is available via anonymous FTP from

        ftp://ftp.freedb.org/pub/freedb/ 

and many other mirror-sites which are listed at www.freedb.org in the
downloads-section.


HELP WITH CDDBD
---------------

If you have any questions or comments about cddbd, the freedb team can be
reached via email at:

info@freedb.org
