This package allows to access CP/M file systems similar to the well-known
mtools package, which accesses MSDOS file systems.  I use it for file
exchange with a Z80-PC simulator, but it works on floppy devices as well.
Currently it contains:

o  cpmls - list sorted directory with output similar to ls, DIR, P2DOS
   DIR and CP/M3 DIR[FULL]
o  cpmcp - copy files from and to CP/M file systems
o  cpmrm - erase files from CP/M file systems
o  cpmchmod - change file permissions
o  cpmchattr - change file attributes
o  mkfs.cpm - make a CP/M file system
o  fsck.cpm - check and repair a CP/M file system (only simple errors
   can be repaired so far).  Some images of broken file systems are provided
   for testing.
o  fsed.cpm - view CP/M file system
o  manual pages for everything including the CP/M file system format

All CP/M file system features are supported.  Password protection
is ignored, because passwords are easy to decrypt, but a pseudo file
[passwd] contains them, if you are curious what your old password has
been.  The disk label is read as special file [label].  User numbers
are specified as user:file.

Cpmtools should compile and work out of the box on each POSIX compliant
system.  It can be additionally compiled for Win32 systems.  The source
is available as a GNU zipped tape archive from:

  http://www.moria.de/~michael/cpmtools/

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 3 of the License, or (at your
option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License along
with this program.  If not, write to the Free Software Foundation, Inc.,
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

  Under Windows 95/98, if a program name has more than one dot, you have to
add the ".exe" extension to the command. So you should use "fsck.cpm.exe"
rather than just "fsck.cpm".

  If you have appropriate rights, the CPMTOOLS should be able to access
the floppy drive by using "A:" or "B:" as the name of the disc image.
"mkfs.cpm" and "fsed.cpm" don't have this capability.

John Elliott, 18 June 2000