-----------------------------------------------------------------------------
ECM (Error Code Modeler) encode/decode utilities
Version 1.0
Copyright 2002 Neill Corlett
Distributed under the terms of the GNU GPL; read source code for details
-----------------------------------------------------------------------------

Introduction
------------

The ECM format allows you to reduce the size of a typical CD image file
(BIN, CDI, NRG, CCD, or any other format that uses raw sectors; results may
vary).

It works by eliminating the Error Correction/Detection Codes (ECC/EDC) from
each sector whenever possible.  The encoder automatically adjusts to
different sector types and automatically skips any headers it encounters.

The results will vary depending on how much redundant ECC/EDC data is
present.  Note that for "cooked" ISO files, there will be no reduction.


Setup / Usage
-------------

Run ECM with no parameters to see a simple usage reference:

    usage: ecm cdimagefile [ecmfile]

Where "cdimagefile" is the name of the CD image file, and "ecmfile"
(optional) is the name of the ECM file.  If you don't specify ecmfile, it
defaults to cdimagefile plus a .ecm suffix.

UNECM works the same way, but in reverse:

    usage: unecm ecmfile [outputfile]

"ecmfile" must end in .ecm.  If outputfile is not specified, it defaults
to ecmfile minus the .ecm suffix.


Thanks to
---------

ProtoCat for inspiring me to write this.


Where to find me
----------------

email: corlett()lfx.org
www:   http://lfx.org/~corlett/

-----------------------------------------------------------------------------

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                26601   64428  41.3% -lh5- 8485 Oct  5  2006 ECM/AmigaOS4/ECM.exe
[generic]                26648   63664  41.9% -lh5- 1e2e Oct  5  2006 ECM/AmigaOS4/UnECM.exe
[generic]                 2074    6353  32.6% -lh5- 3762 Jun 16  2002 ECM/Docs/format.txt
[generic]                 7119   18349  38.8% -lh5- d933 Jun 16  2002 ECM/Docs/gpl.txt
[generic]                  750    1606  46.7% -lh5- d171 Oct  5  2006 ECM/Docs/readme.txt
[generic]                23257   58388  39.8% -lh5- ad85 Jun 24 09:49 ECM/MorphOS/ECM
[generic]                22498   56008  40.2% -lh5- 9c14 Jun 24 09:49 ECM/MorphOS/UnECM
[generic]                 3721   13976  26.6% -lh5- 7730 Jun 16  2002 ECM/Source/ecm.c
[generic]                 3078   10643  28.9% -lh5- 26cb Jun 16  2002 ECM/Source/unecm.c
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         9 files  115746  293415  39.4%            Jun 24 06:46