Welcome to the Wonderfully Ancient World of CP/M
Cpmtools 2.9 Executables for Windows Users
Getting Started
Program Documentation
Downloads and Links
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-2008 Michael Haardt <michael@moria.de> and
copyright 2000, 2001 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 version of cpmtools is available as
a GNU zipped tape archive from:
http://www.moria.de/~michael/cpmtools/
The cpmtools source used in cygwin to build both the Windows binary (Executable) versions of
cpmtools 2.9 noted below is available from the
www.cpm8680.com Website in a zip file format:
http://www.cpm8680.com/cpmtools/cpmtools-2.9.zip
README.win32.cygwin.txt included in the source
and binary executables that I have built and offer here documents building
under cygwin in Windows.
For Windows Users who do not wish to make working programs from source code, a compiled
Native Win32 Binary (Executable) version of cpmtools 2.9 is available from the
www.cpm8680.com Website in a zip file format:
http://www.cpm8680.com/cpmtools/cpmtools-2.9-Win32.zip
Just unzip with pathnames intact to the root of your local drive (usually C:)
and open-up a cmd prompt in the \cpmtools directory (Windows XP and Vista users
can click-on the cpmtools XP Shortcut)
and you should be good to go. 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 and
in the \cpmtools\docs directory and
they will load into your favorite web browser.
The distribution noted above 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. This means that you can add the \cpmtools directory
to your PATH and the disk and disk image format definitions file will be found.
Users of earlier versions of Windows than XP that support Win32 will need to open a command
prompt and run \cpmtools\cpmtools.bat to set their PATH.
A Windows XP Shortcut has been added for Windows XP Users. This should
also work in Windows Vista. This means that Windows XP and Vista users can just
click on this shortcut in Windows Explorer or the Shortcut can be copied to
the desktop.
<< Back to Top
For cygwin Users who do not wish to make working programs from source code, a compiled
cygwin 5 Binary (Executable) version of cpmtools 2.9 is available from the
www.cpm8680.com Website in a zip file format:
http://www.cpm8680.com/cpmtools/cpmtools-2.9-cygwin.zip
Outside cygwin just unzip with pathnames intact to the root of the drive that the cygwin
version 5 directory is installed on (\cygwin is assumed). If you are doing this inside cygwin
using zip and cygwin is installed on C:, then cd \cygdrive\c before un-zipping.
The cygwin installation comes complete with the manpages but not the html manual.
It overlays your cygwin installation so review the zip before installing.
The distribution noted above has the following customization:
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.
Other than that, it is what you would get if you built from scratch then installed
using "make install". If you wish to know more you should download
the source as well.
<< 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:
<< Back to Top
Caveat Emptor
This document was written and formatted by hand by Bill Buckels. Its
contents are either part of cpmtools or provide additional information about using cmptools. 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.