Imported Upstream version 2.17
[debian/cpmtools] / README
1 This package allows to access CP/M file systems similar to the well-known
2 mtools package, which accesses MSDOS file systems.  I use it for file
3 exchange with a Z80-PC simulator, but it works on floppy devices as well.
4 Currently it contains:
5
6 o  cpmls - list sorted directory with output similar to ls, DIR, P2DOS
7    DIR and CP/M3 DIR[FULL]
8 o  cpmcp - copy files from and to CP/M file systems
9 o  cpmrm - erase files from CP/M file systems
10 o  cpmchmod - change file permissions
11 o  cpmchattr - change file attributes
12 o  mkfs.cpm - make a CP/M file system
13 o  fsck.cpm - check and repair a CP/M file system (only simple errors
14    can be repaired so far).  Some images of broken file systems are provided
15    for testing.
16 o  fsed.cpm - view CP/M file system
17 o  manual pages for everything including the CP/M file system format
18
19 All CP/M file system features are supported.  Password protection
20 is ignored, because passwords are easy to decrypt, but a pseudo file
21 [passwd] contains them, if you are curious what your old password has
22 been.  The disk label is read as special file [label].  User numbers
23 are specified as user:file.
24
25 Cpmtools should compile and work out of the box on each POSIX compliant
26 system.  It can be additionally compiled for Win32 systems.  The source
27 is available as a GNU zipped tape archive from:
28
29   http://www.moria.de/~michael/cpmtools/
30
31 This program is free software; you can redistribute it and/or modify it
32 under the terms of the GNU General Public License as published by the
33 Free Software Foundation; either version 3 of the License, or (at your
34 option) any later version.
35
36 This program is distributed in the hope that it will be useful, but
37 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
38 or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
39 for more details.
40
41 You should have received a copy of the GNU General Public License along
42 with this program.  If not, write to the Free Software Foundation, Inc.,
43 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.