Welcome to the Wonderfully Ancient World of CP/M
Cpmtools 2.9 Executables for Windows Users

Getting Started

Introduction
Licence
Disclaimer

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
cpmtools cygwin 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-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
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
Aztec C CP/M 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.
The Aztec C Museum Website is only one of many free CP/M resources on the Internet too numerous to mention that can be used in conjunction with cpmtools. Some of these include:

The Microsoft Softcard
The Apple II CP/M Archives at ftp.apple.asimov.net
John Elliot's CP/M Pages Site
The Unofficial CP/M Website aka Gaby Chaudry's Site
Harte Technologies CP/M-80 Information and Download Page
Commercial CP/M Software Archive

<< 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.