CD-DISCID
=========
cd-discid is a backend utility to get CDDB discid information from a CD-ROM
disc. It was originally designed for cdgrab, but can be used for any purpose
requiring CDDB data.

Using cd-discid is very simple. It accepts one command line parameter, the
device name of the CD-ROM drive to look up. For example:

$ cd-discid /dev/cdrom
a20b250d 13 15037 33615 47637 64202 80665 99150 112272 129287 150072 167990 187560 199785 218482 3053

The information returned is, in order:

* 32-bit hex CDDB disc-id. The first byte of this is the track checksum, the
  next two are the length of the CD in seconds, and the last is the number
  of tracks
* Number of tracks
* Frame offset of each track
* Second offset for the leadout track (length of the CD in seconds)

The (lack of) inspiration behind this output format was the CDDB database
server. It accepts requests like so:

http://cddb.cddb.com/~cddb/cddb.cgi?cmd=cddb+query+a20b250d+13+15037+33615+
47637+64202+80665+99150+112272+129287+150072+167990+187560+199785+218482+
3053&hello=user+hostname+program+version&proto=4

cd-discid was developed with attention to the CDDB specifications, available
at http://www.cddb.com/, using portions of their sample code. If you come
across a CD that cd-discid does not properly identify, please let me know.
--
Robert Woodcock <rcw@debian.org>
