Welcome to the Wonderfully Ancient World of CP/M
Cpmtools Executables for Windows Users
The Wild Turkey Distribution

Getting Started

Introduction
Customizations
Features
Licence
Disclaimer

cpmtools Program Documentation

CPM - CP/M disk and file system format
Entry Level Commands

cpmchattr - change file attributes on CP/M files
cpmchmod - change file mode on CP/M files
cpmcp - copy files from and to CP/M disks
cpmls - list sorted contents of directory
cpmrm - remove files on CP/M disks

Expert Level Commands

fsck.cpm - check a CP/M file system
fsed.cpm - edit a CP/M file system
mkfs.cpm - make a CP/M file system

Downloads and Links

cpmtools source code
cpmtools Native Win32 Executables
CP/M Resources

Introduction
Cpmtools is a suite of command line utilities which allow access to CP/M file systems. It is available on many platforms. This document is targetted at the use of the cpmtools Win32 executables at the Windows command prompt by Windows users who know how to use command line utilities and disk images and who may not wish to create cpmtools executables from source code... just to use them.
Cpmtools is copyright 1997-2013 Michael Haardt <michael@moria.de> and copyright 2000, 2001, 2011 John Elliott <jce@seasip.demon.co.uk>.
<< Back to Top

Licence
Cpmtools 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.
Cpmtools 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 receive a copy of the GNU General Public License along with cpmtools. If not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
The contents of this document are either part of cpmtools or provide additional information about using cmptools. You can redistribute 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.
<< Back to Top

Downloads
The source for the latest "official" version of cpmtools is available as a GNU zipped tape archive from:
http://www.moria.de/~michael/cpmtools/
Cpmtools For Windows Users
A Forked Version
The Wild Turkey Distribution of cpmtools has been forked from the "official" version and was "cooked-up" by Tom Burnett (using gcc under MinGW) with a recipe that we believe better suits the native Windows environment. Unlike earlier binaries that were distributed from this website which were built under cygwin, MinGW's binaries are free from dependence on "dll-hell" bloatware baggage, and run more quickly using MinGW's native Windows calls. We also believe Wild Turkey is less likely to cause other problems under Windows (like "gobbling-up" memory) than the "official" cpmtools source. (Tom's Alloc became Turkey Alloc as Thanksgiving 2013 and his MinGW solution roughly coincided.)
Native Win32 cpmtools Binaries (Executables) are available from the www.cpm8680.com Website in a zip file format:
http://www.cpm8680.com/cpmtools/cpmtoolsWin32.zip
The cpmtools source used to build the Windows binaries (Executables) is included in the zip file.
To install cpmtools, just unzip with pathnames intact to the root of your local drive (usually C:). A Windows XP Shortcut has been added to the \cpmtools directory for Windows XP, Vista, and Windows 7 Users.
To run cpmtools, just click on this shortcut in Windows Explorer. This shortcut can also be copied to the desktop. Users of earlier versions of Windows that support Win32 can run cpmtools from the Windows command prompt in the \cpmtools directory or by running cpmtools.bat (also provided). The \cpmtools direcory can also be added to the Windows path environment variable.
The document you are reading and the program description documents that it links to are included in the Windows zip file. To use them just click-on them from Windows explorer in the \cpmtools\docs directory and they will load into your favorite web browser.
<< Back to Top
The Wild Turkey Distribution has the following customizations:
The default disk image format is apple-do. This means that if you are working with Apple II DOS 3.3 order disk images you never need to include the -f apple-do format option when typing in your command line.
The diskdefs file is called \cpmtools\diskdefs. This has been hardcoded into the executables.
<< Back to Top
The Wild Turkey Distribution has the following features:

* HTML documentation with additional information and examples for Windows Users.
* Runs Without Compiling (no need to be a programmer).
* Runs in Native Windows (no need for non-native shells or additional DLL's).
* Runs Under Windows XP - 31% of Desktop Computers Worldwide (November 2013).
* Runs Under Windows 7 - 46% of Desktop Computers Worldwide (November 2013).
* Pre-configured for Apple II CP/M (the single most popular platform to run CP/M).

<< Back to Top

CP/M Resources
Compilers

Aztec C compilers
Aztec C compilers for making programs in Windows, MS-DOS, and CP/M that will run in CP/M are available from the Aztec C Museum Website for Fair Use and for free by hobbyists and enthusiasts. These are no longer commercially available and are offered with the permission of the Copyright holder.
Using MS-DOS Emulators like DOSBox and DOSEMU, Aztec C CP/M 80 and CP/M 86 cross-compilers that run in Windows and MS-DOS will run in Ubuntu and other Linux distros and on other platforms that support MS-DOS emulators.
Peter Dassow's C Compiler Site
What compiler should somebody use for programming CP/M applications? Peter's C Compiler site offers native mode CP/M 80 C Compilers that are hard to impossible to find anywhere else.
Lee Bradley's MaxZ80 Tutorial Project
CP/M Emulators like Simeon Cran's MyZ80 can be used under Windows to build programs using a native mode CP/M 80 compiler like the Aztec C native mode CP/M 80 compiler or other CP/M 80 compilers in general independently from a real CP/M machine. Cpmtools can be used to move programs between a MyZ80 disk image and the Windows or Linux (and other) filesystems where cpmtools runs.
In the spirit of providing a rewarding educational experience for Windows users interested in developing their personal understanding of the history of CP/M, Lee Bradley has rebundled the full version of MyZ80 including many programming tools such as Turbo Pascal and Leor Zolman's BDSC C compiler. Lee calls his tutorial project MaxZ80. The link above is for his tutorial and the one below is for the MaxZ80 download. When you run Lee's tutorial the web page is fussy about how it should be used. Click on a topic in the list, then press the TAB key followed by the ENTER key to select a topic.
http://primepuzzle.com/mouse/maxz80.zip
Leor Zolman's BDS C Compiler

<< Back to Top
Other CP/M Resources
CP/M resources on the Internet that can be used in conjunction with cpmtools are too numerous to mention. Some are listed below:

Michael Haardt's cpmtools Main Page
Willi Kusche's Apple CPM Group on Yahoo
The Microsoft Softcard
The Apple II CP/M Archives at ftp.apple.asimov.net
The comp.sys.apple2 Newsgroup on google
The comp.os.cpm Newsgroup on google
Peter Dassow's Website at z80.eu
John Elliot's CP/M Pages
Gaby's Unofficial CP/M Website
Gaby Chaudry's Home Page
Gaby's FTP Server
Harte Technologies CP/M-80 Information and Download Page
Commercial CP/M Software Archive

<< Back to Top

Caveat Emptor
The contents of this document are either part of cpmtools or provide additional information about using cpmtools. It is targetted primarily at Windows users but most of it applies to all users of cpmtools.
It is provided 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. In particular, Bill Buckels has no warranty obligations or liability resulting from its use in any way whatsoever. If you don't agree then don't read it.