Reintegrate wbw -> trunk

This commit is contained in:
wwarthen
2014-08-30 20:09:07 +00:00
parent d211dc2222
commit 3396ba3513
582 changed files with 84502 additions and 58938 deletions

View File

@@ -1,518 +0,0 @@
README.win32.cygwin.txt
-----------------------
Building cpmtools-2.9 in Windows XP using:
- cpmtools http://www.moria.de/~michael/cpmtools/
- cygwin and the ncurses library - http://www.cygwin.com/
"The experts will always complain about shorter documents that do do not
provide enough details to confuse the rest of us, and longer documents that
do not omit enough details to confuse the rest of us. No documentation is
needed for people of that calibre."
- Bill Buckels, November 2008
This document 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.
Introduction
------------
This document is intended as a general guideline. An annotated summary is
provided directly below especially for expert users followed by annotated
details.
Please review the other documentation and source code that comes with
cpmtools for more information about cpmtools. Please review the cygwin
documentation for more information about cygwin.
At time of this writing, I have used the latest versions of the packages
listed above to build the latest version of cpmtools in its entirety. I have
documented the steps I followed below.
Although there are probably other environments and compilers that can build
cpmtools for Windows I have not been successful in using the other several I
tried. Using a complete cygwin installation I had no problems and I had
cpmtools built in moments after I had cygwin installed and the cpmtools
source in place as documented below.
Intended Audience
-----------------
This document takes two tracks for installing cpmtools binary executables
after they have been built in cygwin:
1. End users who will run cpmtools from within the cygwin shell. This
includes unix users who do not want to use the native Windows command line.
2. End users who will run cpmtools from the native Windows command line. The
average Windows user does not have cygwin, and probably won't want to install
cygwin or learn a unix-like shell to use cpmtools.
The consideration here is where cpmtools looks for its CP/M disk format
definitions file (diskdefs) when not in a unix-like environment like cygwin
and this consideration will affect the way you build cpmtools since this path
is hardcoded into the binary executables.
My hope is that this document will help address the needs of both types of
Windows end users and those who wish to provide cpmtools to them.
Summary
-------
- Install cygwin with ncurses.
- Download cpmtools-2.9.tar.tar to your cygwin home directory.
- Start cygwin from the shortcut on the Windows desktop.
- Enter the following commands:
tar -xvf cpmtools.tar.tar
cd cpmtools-2.9
./configure --with-diskdefs=/usr/local/share/diskdefs
make
mkdir /usr/local/share
mkdir /usr/local/share/man
mkdir /usr/local/share/man/man1
mkdir /usr/local/share/man/man5
make install
Assumptions
-----------
The above builds cpmtools under cygwin for end users who will use cpmtools in
the cygwin shell and who will use the default installation.
I am assuming in this summary that all has gone well and that anyone who
deviates from what I have done or who has customized their cygwin
installation will be able to troubleshoot their own problems,
I therefore make the following related assumptions in this summary:
- That compiler related programs and libraries required to build cpmtools
under cygwin (including ncurses) are installed.
- That you wish to download into and work under your home directory. You may
also consider whether a better place to download is in /usr/local/src and
whether you should install in the binaries in /opt/cpmtools/ and things of
that nature.
Default Format
--------------
You can change the default format to accomodate the special needs of your
users so they don't need to type their favorite format. The following line
can be entered to configure for an apple-do default format:
./configure --with-defformat="apple-do" --with-diskdefs=/usr/local/share/diskdefs
Native Windows Installation
---------------------------
If you wish to distribute your binaries to Windows end users who will not
have the cygwin shell and who will use the Windows command line, you have 2
options:
1. Require your users to always work in the same directory as diskdefs.
- or -
2. Hardcode the default diskdefs path into your binary executables and
require your users to always use the expected directory for diskdefs.
The following line shows how to configure for an apple-do default format and
to set the default diskdefs path in a mannner that is acceptable to Windows
to a relative path from the root of the current drive:
./configure --with-defformat="apple-do" --with-diskdefs=/cpmtools/diskdefs
Cross-Cygwin Binary Installation
--------------------------------
You can still use the binaries built as above and installed using "make
install" in cygwin if you add the following line to /etc/fstab (assuming your
cygdrive is the Windows C:drive):
c:\cygwin\usr\local\share /cpmtools
Making a Zip Installation for Native Windows Users
--------------------------------------------------
If your target is the Windows user who does not have cygwin you can do the
following in cygwin in your build directory to create a zip file that will
contain the cpmtools binary executables:
- mkdir cpmtools
- cp *.exe cpmtools/.
- cp diskdefs cpmtools/.
- cp /bin/cygwin1.dll cpmtools/.
- cp /bin/cygncurses-8.dll cpmtools/.
- zip -R cpmtools/*.*
Making Documentation for Native Windows Users
---------------------------------------------
If you wish to provide the cpmtools manual pages in html format you can use
man2html to generate your html in ugly format and redirect to a file and edit
by hand. Here's an example:
man2html -r cpm.5 > cpm.html
If you wish to avoid html and provide the cpmtools manual pages in text
format you can use troff to generate your text in ugly format and redirect to
a file and edit by hand. Here's an example:
troff -a cpm.5 > cpm.txt
This concludes the summary.
Details, Alternatives, and Other Fluff
--------------------------------------
1.cygwin
--------
Cygwin gave me a complete and free environment to both configure and build
cpmtools in its entirety.
I installed cygwin from http://www.cygwin.com/ in its entirety which included
the ncurses library and when prompted to select a download site I chose
ftp://mirrors.kernel.org/sourceware/cygwin/
The site you pick will depend on your own preference and how much of cygwin
you decide to install will be up to you. I have a good Internet connection
and a large hard disk so installing ALL of cygwin was no problem for me.
Those who don't may wish to attempt an incremental installation which I
personally found to be annoying and tedious.
It is not necessary to install ALL cygwin options. Another alternative is to
take the minimalistic approach and just install the compiler related
programs and libraries required to build cpmtools (including ncurses). If you
have missed something you will still be able to select additional components
via Cygwin Setup.
By default cygwin installs into c:\cygwin and puts a shortcut on the Windows
desktop. By default the cygwin shell starts in your cygwin home directory
under c:\cygwin\home\. I used the cygwin default paths for my installation of
cygwin.
2. cpmtoools
------------
I then downloaded Download cpmtools-2.9 from
http://www.moria.de/~michael/cpmtools/
and used WinRAR to extract cpmtools-2.9 to
C:\cygwin\home\bbuckels\cpmtools-2.9\
I have noted in the summary that tar can be used. Use whatever you are
comfortable with to handle things from unix of a tarball nature.
3. Building
-----------
3.1. I started cygwin by clicking on the cygwin shortcut on my desktop which
placed me into my cygwin home directory in the cygwin shell.
3.2 Now in the cygwin shell, I changed to the cpmtools directory by typing
the following and pressing the [Enter] key:
cd cpmtools-2.9
3.3 Running the configure script
--------------------------------
Before making cpmtools, the configure script must be run to create the
cpmtools makefile and the config.h header file required by cpmtools.
I ran the configure script with two options; to set the default format for
cpmtools to Apple II DOS 3.3 disk images and to tell cpmtools where to find
the diskdefs format definitions file (which is required to run cpmtools. See
far below.)
3.3.2 Building for use in the cygwin shell
------------------------------------------
If I was building for use in the cygwin shell and I was using the default
paths used by "make install" noted far below, to be certain that my diskdefs
file would be found and to set my default format to "apple-do" I would type
the following and press the [Enter] key:
./configure --with-defformat="apple-do" --with-diskdefs=/usr/local/share/diskdefs
3.3.1 Building for the Native Windows command line
---------------------------------------------------
To set the default format to "apple-do" and to provide a relative path for
native Windows to my diskefs file which I would later copy to C:\cpmtools\ ,
I typed the following and pressed the [Enter] key:
./configure --with-defformat="apple-do" --with-diskdefs=/cpmtools/diskdefs
Note: Windows paths are typed into the Windows native command line with
backslashes in the MS- DOS tradition. Historically the forward slash used by
unix as a path separator was used as a switch character in MS-DOS utilities
and this has carried forward with the commands that come with Windows. But in
a program, local Windows paths can be used with forward slashes instead and
they still work. Backslashes will cause problems for configure so use forward
slashes.
3.4. The configure script created my cpmtools makefile and config.h with the
options I chose. I then ran make by typing the following and pressing the
[Enter] Key.
make
This concludes the first part of the details section of this document and I
have covered the basic steps that I followed to build cpmtools. What you do
will likely be a close variation.
4. Installing
-------------
4.1 Some of this is also noted in the summary. Also keep in mind that if
cpmtools is used outside of cygwin access to the documentation which is in
the form of unix-style man pages will not be available unless reformatted to
a media type that Windows users are familiar with.
4.1.1 Installing for the cygwin shell
-----------------------------------
You can review the summary and the cpmtools INSTALL document for more
information on unix-like installations. Installation of cpmtools for use in
the cygwin shell follows those conventions.
If installing cpmtools to be used in cygwin using the cpmtools defaults and
assuming the directories below don't already exist, you will need to manually
create the following directories using the mkdir command as follows:
mkdir /usr/local/share
mkdir /usr/local/share/man
mkdir /usr/local/share/man/man1
mkdir /usr/local/share/man/man5
This is because the manual pages (man pages) will not be installed if you
don't. If you install the man pages, then when you need help on cpmtools in
cygwin, you can just enter "man cpmls" or "man cpmchmod", etc.
After you make the directories above enter the following command:
make install
Assuming all has gone well, cpmtools is now part of your cygwin installation
and can be used wherever you work in cygwin.
4.1.2 Installing for Use Outside Cygwin
---------------------------------------
Please also read the summary.
The requirements of my installation were to create a directory structure for
a binary executable version of cpmtools targetted at Apple II disk image
users that would run at the native Windows cmd prompt. I offer the following
for general reference. The cygwin paths are based on my installation of
cygwin and are presented using conventional windows pathname notation.
4.1.2.1 Dll's
-------------
Two dll's from the c:\cygwin\bin\ directory were required:
cygwin1.dll
cygncurses-8.dll
Regardless of installation, for this cygwin and this ncurses version access
to these dll's will be required by this version of the cpmtools excecutables.
4.2 Manually Placing Files for Use Outside Cygwin
-------------------------------------------------
I did my installation by hand.
My executables were created in c:\cygwin\home\bbuckels\cpmtools-2.9\ (my
cygwin home directory) which is also where the diskdefs file was.
I used Windows Explorer to manually do the following:
4.2.1 create c:\cpmtools\ directory.
4.2.2 copy all 8 exes into c:\cpmtools\
4.2.3 copy both dll's listed above into c:\cpmtools\
4.2.4 copy diskdefs into c:\cpmtools\
This gave me my directory structure and files for testing and distribution.
I also placed an Apple II CP/M disk image called EXMPLCPM.dsk in c:\cpmtools\
as a test target.
5. Additional Notes
-------------------
5.1 diskdefs - CP/M disk format definitions
--------------------------------------------
The diskdefs file is a plain ascii text file that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk image formats
apple-do and apple-po are available.
The possible locations where cpmtools first looks for the diskdefs file:
- Can vary depending on the preferences of the person who builds the cpmtools
binaries (executables) from the source code.
- The location is also installation dependent and the diskdefs file may also
have been renamed (but we hope not).
If it's not found the current (work) directory is then searched for a file
called diskdefs.
On a unix-like system, a ${prefix}/share/ style path like /usr/local/share/
is a possible place that cpmtools could be made to first look for diskdefs.
In a Win32 system sometimes unix-like shells like cygwin are used to run
cpmtools instead of Windows cmd. For those installations unix-like
conventions probably should apply.
For cpmtools installations targetted at the average Windows user who does not
have a unix-like shell and uses the Windows cmd prompt to run cpmtools there
is no standard shared place that cpmtools can be made to first look for
diskdefs. Pathed File names like \cpm\diskdefs or even c:\cpmtools\diskdefs
are possible.
5.2 Difficulties in using the Windows File System
---------------------------------------------------
This is not a troubleshooting guide. Unless you wish to find-out for yourself
as I did just how many problems you can face with all of this, or you are
really an expert, please do yourself a favour and try to stay within what I
am suggesting as standard or alternative ways of building cpmtools.
Missing libaries and compiler tools can be solved by trial and error and
reading the cygwin and cpmtools documentation.
There are however some things about path names and file names that you need
to be aware of, some of which I have mentioned throughout this document and
some which I deliberately did not mention yet, like avoiding absolute paths
and drive letters.
If you use a drive letter like C: when hardcoding a path to diskdefs you are
making several assumptions:
First off, you are assuming that your build of cpmtools will only be run from
within Windows cmd shell on the local drive C:, (not from a bash-like shell
like cygwin which doesn't support drive letters the same way Windows cmd and
Windows itself does), and that diskdefs will not be on another drive, and
that drive C: exists in the first place, and that diskdefs is not on a
Windows network either unless drive C:,X:,Y:,Z:,etc is a mapped network
drive. It is questionable whether cpmtools build process for diskdefs pathing
supports UNC pathing anyway. I couldn't get \\ to work since the first slash
disappears in the configure script and the second slash becomes an escape
sequence for the next letter.
Relative pathing will work and if you want to use conventions like
/cpmtools-2.9/diskedefs this will work. Environments like ${USERPROFILE}
aren't a good idea even if I could have got them to work since they are not
portable for several reasons and I will say no more on this except I
recommend that any path that you decide to use for diskdefs will only be
almost portable between shells if off the root directory and contains forward
slashes and no drive letters or colons.
I hope what I have said proved less confusing to read than to write if you
have bothered to read it. If you are not confused yet read further.
- Since cpmtools has special meanings for A: and B: as command line targets
it probably isn't a good idea to use these drives especially.
- Some programmers and users have no difficulty in shifts between unix-like
and Windows pathing. Some will be familiar with how colons are used on
systems like Mac OSX. I think the only point to be made here is to consider
your target audience and all the things you can anticipate going wrong with
interoperability of all of this, (cpmtools being a set of command line
tools), and build cpmtools accordingly for the needs of you or your users,
then test what you have built with all this in mind.
5.3 Testing your build of cpmtools
----------------------------------
To test what you have built I suggest you start with cpmls and cpmcp and an
apple disk image or equivalent.
John Elliot said "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.". I say don't bother mucking with your physical disk drive unless you
have a physical CP/M disk of a format supported by cpmtools safely in the
drive.
Get an apple CP/M disk image and use it for testing is what I suggest. The
following examples assume you have an Apple II DOS 3.3 order disk image
called EXMPLCPM.dsk for testing.
To list the files:
cpmls -f apple-do EXMPLCPM.dsk
The following example shows how to copy a file from an Apple II DOS 3.3 order
cpm disk image to the current directory:
cpmcp -f apple-do EXMPLCPM.dsk bhead.c 0:bhead.c
The following example shows how to copy a file to an Apple II DOS 3.3 order
cpm disk image from the current directory:
cpmcp -f apple-do EXMPLCPM.dsk 0:bhead.c bhead.c
To test the other utilities in cpmtools like cpmrm, cpmchattr, cpmchmod,
fsck.cpm and fsed.cpm, review the appropriate manpages for usage.
Those are simple tests as well using an apple-do format disk image. For
mkfs.cpm I will leave it to those more capable than I to decide what to do
there. Compared to them I am merely dangerous.
Acknowledgements and Stuff
--------------------------
Michael Haardt - for cpmtools in the first place and for his tireless and
ongoing efforts in supporting cpmtools in the second.
John Elliot - for bringing cpmtools to Windows.
My focus is on Windows XP (and other Windows) users and making this available
to them. At this point in time my focus is also on Apple II Z80 Softcard
users. Thankfully Michael Haardt has considered Apple II disk images in
cpmtools. My focus is also on the Aztec C Z80 MS-DOS cross-compiler which
creates Apple II CP/M programs in Windows XP.
Between Michael and John, with cpmtools I can now easily get these onto an
Apple disk image and transfer the disk image over to my real Apple II which
has a Z80 softcard clone using my Microdrive with a CF card and make a real
CP/M disk from the image with DISKMAKER.8 or DSK2FILE then run my Aztec C
CP/M programs using the real thing. I can also use the emulator that came
with Apple II Oasis to run the disk image.
Apparently nothing is missing from cpmtools for Windows XP that is available
on cpmtools for unix-like systems and I am thankful for that. Hopefully you
will be too.
I would also like to acknowledge the following individuals from the
comp.os.cpm and apple2.sys usenet newsgroups who gave their experience,
thoughts and encouragement during my adventure with all of this and in no
particular order:
David Schmidt - for cygwin feedback.
Udo Munk - for cygwin feedback.
Peter Dassow - for cygwin feedback.
Stevo Tarkin - for msys feedback.
Volker Pohlers - for msys and pdcurses feedback.
Rolf Harmann - for linux feedback.
Richard Brady - who may or may not know watfor:)
If I missed anyone, I thank them too. I am somewhat new to some of this and
needed all the help I received. cygwin is now my friend.
Bill Buckels
bbuckels@mts.net
November 2008

View File

@@ -0,0 +1,12 @@
2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpm.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpm.htm
2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpmchattr.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpmchattr.htm
2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpmchmod.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpmchmod.htm
2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpmcp.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpmcp.htm
2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpmls.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpmls.htm
2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpmrm.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpmrm.htm
2013.12.01 19:45 A C:\cpmtoolsWin32\docs\fsck.cpm.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools fsck.cpm.htm
2013.12.01 19:45 A C:\cpmtoolsWin32\docs\fsed.cpm.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools fsed.cpm.htm
2013.12.01 19:45 A C:\cpmtoolsWin32\docs\index.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools index.htm
2013.12.01 19:45 A C:\cpmtoolsWin32\docs\mkfs.cpm.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools mkfs.cpm.htm
2013.12.01 19:45 B C:\cpmtoolsWin32\docs\turkey.gif --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools turkey.gif
2013.12.01 19:45 B C:\cpmtoolsWin32\docs\wturkey.gif --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools wturkey.gif

View File

@@ -1,357 +1,425 @@
<HTML><HEAD><TITLE>CPM - CP/M disk and file system format</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPM</A></H2>
Section: File formats (5)<BR>
Updated: June 16, 2008<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpm - CP/M disk and file system format.</B><BR><BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<A NAME="lbAE">&nbsp;</A>
<B>Characteristic sizes - Each CP/M disk format is described by the following specific sizes:</B>
<BR>
<DL COMPACT><DT><DD>
Sector size in bytes
<BR>
Number of tracks
<BR>
Number of sectors
<BR>
Block size
<BR>
Number of directory entries
<BR>
Logical sector skew
<BR>
Number of reserved system tracks
<BR><BR>
</DL>
A block is the smallest allocatable storage unit. CP/M supports block
sizes of 1024, 2048, 4096, 8192 and 16384 bytes. Unfortunately, this
format specification is not stored on the disk and there are lots of
formats. Accessing a block is performed by accessing its sectors, which
are stored with the given software skew.
<BR><BR>
<A NAME="lbAF">&nbsp;</A>
<B>Device areas - A CP/M disk contains three areas:</B><BR>
<DL COMPACT><DT><DD>
System tracks (optional)
<BR>
Directory
<BR>
Data
<BR><BR>
</DL>
The system tracks store the boot loader and CP/M itself. In order to save
disk space, there are non-bootable formats which omit those system tracks.
The term <I>disk capacity</I> always excludes the space for system tracks.
Note that there is no bitmap or list for free blocks. When accessing a
drive for the first time, CP/M builds this bitmap in core from the directory.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>Directory entries - The directory is a sequence of directory entries (also called extents),
which contain 32 bytes of the following structure:</B><BR>
<DL COMPACT><DT><DD>
St<TT>&nbsp;</TT>F0<TT>&nbsp;</TT>F1<TT>&nbsp;</TT>F2<TT>&nbsp;</TT>F3<TT>&nbsp;</TT>F4<TT>&nbsp;</TT>F5<TT>&nbsp;</TT>F6<TT>&nbsp;</TT>F7<TT>&nbsp;</TT>E0<TT>&nbsp;</TT>E1<TT>&nbsp;</TT>E2<TT>&nbsp;</TT>Xl<TT>&nbsp;</TT>Bc<TT>&nbsp;</TT>Xh<TT>&nbsp;</TT>Rc<BR>
<BR>
Al<TT>&nbsp;&nbsp;&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>AlAl<BR>
<BR>
</DL>
<B>St</B> is the status; possible values are:<BR>
<DL COMPACT><DT><DD>
0-15: used for file, status is the user number
<BR>
16-31: used for file, status is the user number (P2DOS)
or used for password extent (CP/M 3 or higher)
<BR>
32: disc label
<BR>
33: time stamp (P2DOS)
<BR>
0xE5: unused
<BR><BR>
</DL>
<B>F0-E2</B> are the file name and its extension. They may consist of
any printable 7 bit ASCII character but: <B>&lt; &gt; . , ; : = ? * [ ]</B>.
The file name must not be empty, the extension may be empty. Both are
padded with blanks. The highest bit of each character of the file name
and extension is used as attribute. The attributes have the following
meaning:<BR>
<DL COMPACT><DT><DD>
F0: requires set wheel byte (Backgrounder II)
<BR>
F1: public file (P2DOS, ZSDOS), forground-only command (Backgrounder II)
<BR>
F2: date stamp (ZSDOS), background-only commands (Backgrounder II)
<BR>
F7: wheel protect (ZSDOS)
<BR>
E0: read-only
<BR>
E1: system file
<BR>
E2: archived
<BR><BR>
</DL>
Public files (visible under each user number) are not supported by CP/M
2.2, but there is a patch and some free CP/M clones support them without
any patches.
<BR><BR>
The wheel byte is (by default) the memory location at 0x4b. If it is
zero, only non-privileged commands may be executed.
<BR><BR>
<B>Xl</B> and <B>Xh</B> store the extent number. A file may use more than
one directory entry, if it contains more blocks than an extent can hold.
In this case, more extents are allocated and each of them is numbered
sequentially with an extent number. If a physical extent stores more than
16k, it is considered to contain multiple logical extents, each pointing
to 16k data, and the extent number of the last used logical extent
is stored. Note: Some formats decided to always store only one logical
extent in a physical extent, thus wasting extent space. CP/M 2.2 allows
512 extents per file, CP/M 3 and higher allow up to 2048. Bit 5-7 of
Xl are 0, bit 0-4 store the lower bits of the extent number. Bit 6
and 7 of Xh are 0, bit 0-5 store the higher bits of the extent number.
<BR><BR>
<B>Rc</B> and <B>Bc</B> determine the length of the data used by this extent. The
physical extent is divided into logical extents, each of them being 16k
in size (a physical extent must hold at least one logical extent, e.g. a
blocksize of 1024 byte with two-byte block pointers is not allowed).
Rc stores the number of 128 byte records of the last used logical extent.
Bc stores the number of bytes in the last used record. The value 0 means
128 for backward compatibility with CP/M 2.2, which did not support Bc.
<BR><BR>
<B>Al</B> stores block pointers. If the disk capacity is less than 256 blocks,
Al is interpreted as 16 byte-values, otherwise as 8 double-byte-values.
A block pointer of 0 marks a hole in the file. If a hole
covers the range of a full extent, the extent will not be allocated. In particular,
the first extent of a file does not neccessarily have extent number 0.
A file may not share blocks with other files, as its blocks would be freed
if the other files is erased without a following disk system reset. CP/M returns
EOF when it reaches a hole, whereas UNIX returns zero-value bytes, which makes
holes invisible.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>Time stamps - P2DOS and CP/M Plus support time stamps, which are stored in each fourth
directory entry.
</B><BR><BR>
This entry contains the time stamps for
the extents using the previous three directory entries. Note that you
really have time stamps for each extent, no matter if it is the first
extent of a file or not. The structure of time stamp entries is:<BR>
<DL COMPACT><DT><DD>
1 byte status 0x21
<BR>
8 bytes time stamp for third-last directory entry
<BR>
2 bytes unused
<BR>
8 bytes time stamp for second-last directory entry
<BR>
2 bytes unused
<BR>
8 bytes time stamp for last directory entry
<BR><BR>
</DL>
A time stamp consists of two dates: Creation and modification date (the
latter being recorded when the file is closed). CP/M Plus further
allows optionally to record the access instead of creation date as first
time stamp.<BR>
<DL COMPACT><DT><DD>
2 bytes (little-endian) days starting with 1 at 01-01-1978
<BR>
1 byte hour in BCD format
<BR>
1 byte minute in BCD format
<BR><BR>
</DL>
<A NAME="lbAI">&nbsp;</A>
<B>Disc labels - CP/M Plus supports disc labels, which are stored in an arbitrary directory
entry.</B>
<BR><BR>
The structure of disc labels is:<BR>
<DL COMPACT><DT><DD>
1 byte status 0x20
<BR>
<B>F0-E2</B> are the disc label
<BR>
1 byte mode: bit 7 activates password protection, bit 6 causes time stamps on
access, but 5 causes time stamps on modifications, bit 4 causes time stamps on
creation and bit 0 is set when a label exists. Bit 4 and 6 are exclusively set.
<BR>
1 byte password decode byte: To decode the password, xor this byte with the password
bytes in reverse order. To encode a password, add its characters to get the
decode byte.
<BR>
2 reserved bytes
<BR>
8 password bytes
<BR>
4 bytes label creation time stamp
<BR>
4 bytes label modification time stamp
<BR><BR>
</DL>
<A NAME="lbAJ">&nbsp;</A>
<B>Passwords - CP/M Plus supports passwords, which are stored in an arbitrary directory entry.</B>
<BR><BR>
The structure of these entries is:<BR>
<DL COMPACT><DT><DD>
1 byte status (user number plus 16)
<BR>
<B>F0-E2</B> are the file name and its extension.
<BR>
1 byte password mode: bit 7 means password required for reading, bit 6 for writing
and bit 5 for deleting.
<BR>
1 byte password decode byte: To decode the password, xor this byte with the password
bytes in reverse order. To encode a password, add its characters to get the
decode byte.
<BR>
2 reserved bytes
<BR>
8 password bytes
<BR><BR>
</DL>
<A NAME="lbAK">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF=" ./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
<I><A HREF=" ./fsck.cpm.htm">fsck.cpm</A></I>(1),
<I><A HREF=" ./fsed.cpm.htm">fsed.cpm</A></I>(1),
<I><A HREF=" ./cpmls.htm">cpmls</A></I>(1)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B><BR>
<DL>
<DT><A HREF="#lbAA">NAME cpm - CP/M disk and file system format</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">Characteristic sizes</A><DD>
<DT><A HREF="#lbAF">Device areas</A><DD>
<DT><A HREF="#lbAG">Directory entries</A><DD>
<DT><A HREF="#lbAH">Time stamps</A><DD>
<DT><A HREF="#lbAI">Disc labels </A><DD>
<DT><A HREF="#lbAJ">Passwords</A><DD>
</DL>
<DT><A HREF="#lbAK">SEE ALSO</A><DD>
</DL>
<HR>
<b>Gradus ad Parnassum</b>
<br>
<br>
An ugly version of this document was initially created by man2html on November 14, 2008
using the cpmtools version 2.8 manual pages
then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
<br>
<br>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>
<HTML><HEAD><TITLE>CPM - CP/M disk and file system format</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPM</A></H2>
Section: File formats (5)<BR>
Updated: December 1, 2013<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpm - CP/M disk and file system format.</B><BR><BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<A NAME="lbAE">&nbsp;</A>
<B>Characteristic sizes - Each CP/M disk format is described by the following specific sizes:</B>
<BR>
<DL COMPACT><DT><DD>
Sector size in bytes
<BR>
Number of tracks
<BR>
Number of sectors
<BR>
Block size
<BR>
Number of directory entries
<BR>
Logical sector skew
<BR>
Number of reserved system tracks (optional)
<BR>
Offset to start of volume (optional)
<BR><BR>
</DL>
A block is the smallest allocatable storage unit.
CP/M supports block sizes of 1024, 2048, 4096, 8192 and 16384 bytes.
Unfortunately, this format specification is not stored on the disk and
there are lots of formats. Accessing a block is performed by
accessing its sectors, which are stored with the given software skew.
<BR><BR>
<A NAME="lbAF">&nbsp;</A>
<B>Device areas - A CP/M disk contains these areas:</B><BR>
<DL COMPACT><DT><DD>
Volume Offset (optional)
<BR>
System tracks (optional)
<BR>
Directory
<BR>
Data
<BR><BR>
</DL>
The system tracks store the boot loader and CP/M itself. In order to save
disk space, there are non-bootable formats which omit those system tracks.
The term <I>disk capacity</I> always excludes the space for system tracks.
Note that there is no bitmap or list for free blocks. When accessing a
drive for the first time, CP/M builds this bitmap in core from the directory.
<BR><BR>
A hard disk can have the additional notion of a <I>volume offset</I> to
locate the start of the drive image (which may or may not have system
tracks associated with it). The base unit for volume offset is byte
count from the beginning of the physical disk, but specifiers of
<I>K</I>, <I>M</I>, <I>T</I> or <I>S</I> may be appended to denote
kilobytes, megabytes, tracks or sectors. If provided, a specifier
must immediately follow the numeric value with no whitespace. For
convenience upper and lower case are both accepted and only the first
letter is significant, thus 2KB, 8MB, 1000trk and 16sec are valid
values. Offset must appear subsequent to track, sector and sector
length values.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>Directory entries - The directory is a sequence of directory entries (also called extents),
which contain 32 bytes of the following structure:</B><BR>
<DL COMPACT><DT><DD>
St<TT>&nbsp;</TT>F0<TT>&nbsp;</TT>F1<TT>&nbsp;</TT>F2<TT>&nbsp;</TT>F3<TT>&nbsp;</TT>F4<TT>&nbsp;</TT>F5<TT>&nbsp;</TT>F6<TT>&nbsp;</TT>F7<TT>&nbsp;</TT>E0<TT>&nbsp;</TT>E1<TT>&nbsp;</TT>E2<TT>&nbsp;</TT>Xl<TT>&nbsp;</TT>Bc<TT>&nbsp;</TT>Xh<TT>&nbsp;</TT>Rc<BR>
<BR>
Al<TT>&nbsp;&nbsp;&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>AlAl<BR>
<BR>
</DL>
<B>St</B> is the status; possible values are:<BR>
<DL COMPACT><DT><DD>
0-15: used for file, status is the user number
<BR>
16-31: used for file, status is the user number (P2DOS)
or used for password extent (CP/M 3 or higher)
<BR>
32: disc label
<BR>
33: time stamp (P2DOS)
<BR>
0xE5: unused
<BR><BR>
</DL>
<B>F0-E2</B> are the file name and its extension. They may consist of
any printable 7 bit ASCII character but: <B>&lt; &gt; . , ; : = ? * [ ]</B>.
The file name must not be empty, the extension may be empty. Both are
padded with blanks. The highest bit of each character of the file name
and extension is used as attribute. The attributes have the following
meaning:<BR>
<DL COMPACT><DT><DD>
F0: requires set wheel byte (Backgrounder II)
<BR>
F1: public file (P2DOS, ZSDOS), foreground-only command (Backgrounder II)
<BR>
F2: date stamp (ZSDOS), background-only commands (Backgrounder II)
<BR>
F7: wheel protect (ZSDOS)
<BR>
E0: read-only
<BR>
E1: system file
<BR>
E2: archived
<BR><BR>
</DL>
Public files (visible under each user number) are not supported by CP/M
2.2, but there is a patch and some free CP/M clones support them without
any patches.
<BR><BR>
The wheel byte is (by default) the memory location at 0x4b. If it is
zero, only non-privileged commands may be executed.
<BR><BR>
<B>Xl</B> and <B>Xh</B> store the extent number. A file may use more than
one directory entry, if it contains more blocks than an extent can hold.
In this case, more extents are allocated and each of them is numbered
sequentially with an extent number. If a physical extent stores more than
16k, it is considered to contain multiple logical extents, each pointing
to 16k data, and the extent number of the last used logical extent
is stored. Note: Some formats decided to always store only one logical
extent in a physical extent, thus wasting extent space. CP/M 2.2 allows
512 extents per file, CP/M 3 and higher allow up to 2048. Bit 5-7 of
Xl are 0, bit 0-4 store the lower bits of the extent number. Bit 6
and 7 of Xh are 0, bit 0-5 store the higher bits of the extent number.
<BR><BR>
<B>Rc</B> and <B>Bc</B> determine the length of the data used by this extent.
The physical extent is divided into logical extents, each of them being 16k
in size (a physical extent must hold at least one logical extent, e.g.
a blocksize of 1024 byte with two-byte block pointers is not allowed).
Rc stores the number of 128 byte records of the last used logical
extent. Bc stores the number of bytes in the last used record. The
value 0 means 128 for backward compatibility with CP/M 2.2, which did
not support Bc. ISX records the number of unused instead of used bytes
in Bc.
<BR><BR>
<B>Al</B> stores block pointers. If the disk capacity minus boot tracks but
including the directory area is less than 256 blocks, Al is interpreted
as 16 byte-values, otherwise as 8 double-byte-values. Since the direc-
tory area is not subtracted, the directory area starts with block 0 and
files can never allocate block 0, which is why this value can be given
a new meaning: A block pointer of 0 marks a hole in the file. If a
hole covers the range of a full extent, the extent will not be allo-
cated. In particular, the first extent of a file does not neccessarily
have extent number 0. A file may not share blocks with other files, as
its blocks would be freed if the other files were erased without a fol-
lowing disk system reset. CP/M returns EOF when it reaches a hole,
whereas UNIX returns zero-value bytes, which makes holes invisible.
<BR><BR>
<A NAME="lbAH0">&nbsp;</A>
<B>Native Time stamps</B><BR><BR>
P2DOS and CP/M Plus support time stamps, which are stored in each
fourth directory entry. This entry contains the time stamps for the
extents using the previous three directory entries. Note that you
really have time stamps for each extent, no matter if it is the first
extent of a file or not. The structure of time stamp entries is:<BR>
<DL COMPACT><DT><DD>
1 byte status 0x21
<BR>
8 bytes time stamp for third-last directory entry
<BR>
2 bytes unused
<BR>
8 bytes time stamp for second-last directory entry
<BR>
2 bytes unused
<BR>
8 bytes time stamp for last directory entry
<BR><BR>
</DL>
A time stamp consists of two dates: Creation and modification date (the
latter being recorded when the file is closed). CP/M Plus further
allows optionally to record the access instead of creation date as first
time stamp.<BR>
<DL COMPACT><DT><DD>
2 bytes (little-endian) days starting with 1 at 01-01-1978
<BR>
1 byte hour in BCD format
<BR>
1 byte minute in BCD format
<BR><BR>
</DL>
<A NAME="lbAH">&nbsp;</A>
<B>DateStamper Time stamps</B><BR><BR>
The DateStamper software added functions to the BDOS to manage
time stamps by allocating a read only file with the name "!!!TIME&.DAT"
in the very first directory entry, covering the very first data blocks.
(The first 7 characters of this read-only file name is the magic number.)
<BR>
<BR>
It contains one entry per directory entry with the following
structure of 16 bytes: <BR>
<DL COMPACT><DT><DD>
5 bytes create datefield
<BR>
5 bytes access datefield
<BR>
5 bytes modify datefield
<BR>
1 byte magic number/checksum
<BR><BR>
</DL>
The magic number is used for the first 7 entries of each 128-byte
record and contains the characters !, !, !, T, I, M and E (<b>!!!TIME</b>).
The check-sum is used on every 8th entry (last entry in 128-byte record) and is
the sum of the first 127 bytes of the record. Each datefield has this
structure:<BR>
<DL COMPACT><DT><DD>
1 byte BCD coded year (no century, so it is sane assuming any year < 70 means 21st century)
<BR>
1 byte BCD coded month
<BR>
1 byte BCD coded day
<BR>
1 byte BCD coded hour or, if the high bit is set, the high byte of a counter for systems without real time clock
<BR>
1 byte BCD coded minute, or the low byte of the counter
<BR><BR>
</DL>
<A NAME="lbAI">&nbsp;</A>
<B>Disc labels - CP/M Plus supports disc labels, which are stored in an arbitrary directory
entry.</B>
<BR><BR>
The structure of disc labels is:<BR>
<DL COMPACT><DT><DD>
1 byte status 0x20
<BR>
<B>F0-E2</B> are the disc label
<BR>
1 byte mode: bit 7 activates password protection, bit 6 causes time stamps on
access, but 5 causes time stamps on modifications, bit 4 causes time stamps on
creation and bit 0 is set when a label exists. Bit 4 and 6 are exclusively set.
<BR>
1 byte password decode byte: To decode the password, xor this byte with the password
bytes in reverse order. To encode a password, add its characters to get the
decode byte.
<BR>
2 reserved bytes
<BR>
8 password bytes
<BR>
4 bytes label creation time stamp
<BR>
4 bytes label modification time stamp
<BR><BR>
</DL>
<A NAME="lbAJ">&nbsp;</A>
<B>Passwords - CP/M Plus supports passwords, which are stored in an arbitrary directory entry.</B>
<BR><BR>
The structure of these entries is:<BR>
<DL COMPACT><DT><DD>
1 byte status (user number plus 16)
<BR>
<B>F0-E2</B> are the file name and its extension.
<BR>
1 byte password mode: bit 7 means password required for reading, bit 6 for writing
and bit 5 for deleting.
<BR>
1 byte password decode byte: To decode the password, xor this byte with the password
bytes in reverse order. To encode a password, add its characters to get the
decode byte.
<BR>
2 reserved bytes
<BR>
8 password bytes
<BR><BR>
</DL>
<A NAME="lbAK">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF=" ./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
<I><A HREF=" ./fsck.cpm.htm">fsck.cpm</A></I>(1),
<I><A HREF=" ./fsed.cpm.htm">fsed.cpm</A></I>(1),
<I><A HREF=" ./cpmls.htm">cpmls</A></I>(1)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B><BR>
<DL>
<DT><A HREF="#lbAA">NAME cpm - CP/M disk and file system format</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">Characteristic sizes</A><DD>
<DT><A HREF="#lbAF">Device areas</A><DD>
<DT><A HREF="#lbAG">Directory entries</A><DD>
<DT><A HREF="#lbAH0">Native Time stamps</A><DD>
<DT><A HREF="#lbAH">DateStamper Time stamps</A><DD>
<DT><A HREF="#lbAI">Disc labels </A><DD>
<DT><A HREF="#lbAJ">Passwords</A><DD>
</DL>
<DT><A HREF="#lbAK">SEE ALSO</A><DD>
</DL>
<HR>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>

View File

@@ -1,256 +1,249 @@
<HTML><HEAD><TITLE>CPMCHATTR - change file attributes on CP/M files</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPMCHATTR</A></H2>
Section: User commands (1)<BR>
Updated: June 16, 2008<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpmchattr - change file attributes on CP/M files.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>cpmchattr</B>
[<B>-f</B>
<I>format</I>]
<I>image</I>
<I>attrib</I>
<I>file-pattern</I>
...
<BR><BR>
<b>Note: Wildcards like *.com should be preceded with the user number
using a pattern like 0:*.com.</b>
<br>
<br>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Cpmchattr changes the file attributes for files on CP/M disks.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
<b>For Apple II CP/M 80 users the cpmchattr command may have no practical
effect. Try
<A HREF=" ./cpmchmod.htm">cpmchmod</A> instead for setting read only
attributes.</b>
<BR><BR>
<DT><b>attrib</b> Set the file attributes as given.<DD>
<BR>
</DL>
<A NAME="lbAF">&nbsp;</A>
<B>FILE ATTRIBUTES - The file attribute string can contain the characters
1,2,3,4,s,a,N and M.</B><BR><BR>
The meanings of these are:
<DL COMPACT>
<DT><B>1-4</B><BR>
<DD>
The CP/M &quot;user attributes&quot; F1-F4. CP/M does not assign any
meaning to these attributes, though MP/M does.
<BR>
<DT><B>s</B><BR>
<DD>
The file is a system file. This attribute can also be set by
<I><A HREF=" ./cpmchmod.htm">cpmchmod</A>(1).</I>
<DT><B>a</B><BR>
<DD>
The file has been backed up.
<DT><B>N</B><BR>
<DD>
Reset all attributes to zero. So the string &quot;N1r&quot; resets all attributes and
then sets F1 and Read-Only.
<DT><B>M</B><BR>
<DD>
Attributes after an M are unset rather than set. The string &quot;12M34&quot; sets
atttributes F1 and F2, and unsets F3 and F4.
<BR><BR>
</DL>
<A NAME="lbAG">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system the
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system the
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAI">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR><BR>
<b>For Apple II CP/M 80 users the cpmchattr command may have no
practical effect. Try
<A HREF=" ./cpmchmod.htm">cpmchmod</A> instead for setting read only
attributes.</b>
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
- Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR><BR>
- The location is also installation dependent and the diskdefs file
may also have been renamed.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to run cpmtools instead of Windows cmd. For those installations
unix-like conventions probably apply.
<br>
<br>
For cpmtools installations targetted at the average
Windows user who does not have a unix-like shell and uses the Windows cmd
prompt to run cpmtools there is no standard shared place that cpmtools will first
look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
even <b>c:\cpmtools\diskdefs</b> are possible.
<BR>
<BR>
<A NAME="lbAJ">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAK">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF="./cpmls.htm">cmpls</A></I>(1),
<I><A HREF="./cpmchmod.htm">cpmchmod</A></I>(1),
<I><A HREF="./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME cpmchattr - change file attributes on CP/M files.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">FILE ATTRIBUTES</A><DD>
<DT><A HREF="#lbAG">RETURN VALUE</A><DD>
<DT><A HREF="#lbAH">ERRORS</A><DD>
<DT><A HREF="#lbAI">FILES</A><DD>
</DL>
<DT><A HREF="#lbAJ">AUTHORS</A><DD>
<DT><A HREF="#lbAK">SEE ALSO</A><DD>
</DL>
<HR>
<b>Gradus ad Parnassum</b>
<br>
<br>
An ugly version of this document was initially created by man2html on November 14, 2008
using the cpmtools version 2.8 manual pages
then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
<br>
<br>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>
<HTML><HEAD><TITLE>CPMCHATTR - change file attributes on CP/M files</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPMCHATTR</A></H2>
Section: User commands (1)<BR>
Updated: December 1, 2013<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpmchattr - change file attributes on CP/M files.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>cpmchattr</B>
[<B>-f</B>
<I>format</I>]
<I>image</I>
<I>attrib</I>
<I>file-pattern</I>
...
<BR><BR>
<b>Note: Wildcards like *.com should be preceded with the user number
using a pattern like 0:*.com.</b>
<br>
<br>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Cpmchattr changes the file attributes for files on CP/M disks.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
<b>For Apple II CP/M 80 users the cpmchattr command may have no practical
effect. Try
<A HREF=" ./cpmchmod.htm">cpmchmod</A> instead for setting read only
attributes.</b>
<BR><BR>
<DT><b>attrib</b> Set the file attributes as given.<DD>
<BR>
</DL>
<A NAME="lbAF">&nbsp;</A>
<B>The file attribute string can contain the characters 1,2,3,4,r,s,a,n
and m.</B><BR><BR>
The meanings of these are:
<DL COMPACT>
<DT><B>1-4</B><BR>
<DD>
The CP/M &quot;user attributes&quot; F1-F4. CP/M does not assign any
meaning to these attributes, though MP/M does.
<BR>
<DT><B>r</B><BR>
<DD>
The file is read-only. This is the same as using
<I><A HREF=" ./cpmchmod.htm">cpmchmod</A>(1).</I> to
revoke write permissions.
<DT><B>s</B><BR>
<DD>
The file is a system file. This attribute can also be set by
<I><A HREF=" ./cpmchmod.htm">cpmchmod</A>(1).</I>
<DT><B>a</B><BR>
<DD>
The file has been backed up.
<DT><B>n</B><BR>
<DD>
Reset all attributes to zero. So the string &quot;n1r&quot; resets all attributes and
then sets F1 and Read-Only.
<DT><B>m</B><BR>
<DD>
Attributes after an m are unset rather than set. The string &quot;12m34&quot; sets
atttributes F1 and F2, and unsets F3 and F4.
<BR><BR>
</DL>
<A NAME="lbAG">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system the
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system the
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAI">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR>
To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
included in the Windows distro of the cpmtools binaries. These are included so you
can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
does not edit "unix" text.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<br>
<br>
The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to build and run cpmtools instead of Windows cmd. For those installations
unix-like conventions may apply.
<BR>
<BR>
<A NAME="lbAJ">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAK">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF="./cpmls.htm">cmpls</A></I>(1),
<I><A HREF="./cpmchmod.htm">cpmchmod</A></I>(1),
<I><A HREF="./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME cpmchattr - change file attributes on CP/M files.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">FILE ATTRIBUTES</A><DD>
<DT><A HREF="#lbAG">RETURN VALUE</A><DD>
<DT><A HREF="#lbAH">ERRORS</A><DD>
<DT><A HREF="#lbAI">FILES</A><DD>
</DL>
<DT><A HREF="#lbAJ">AUTHORS</A><DD>
<DT><A HREF="#lbAK">SEE ALSO</A><DD>
</DL>
<HR>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>

View File

@@ -1,251 +1,242 @@
<HTML><HEAD><TITLE>CPMCHMOD - change file mode on CP/M files</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPMCHMOD</A></H2>
Section: User commands (1)<BR>
Updated: June 16, 2008<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpmchmod - change file mode on CP/M files.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>cpmchmod</B>
[<B>-f</B>
<I>format</I>]
<I>image</I>
<I>mode</I>
<I>file-pattern</I>
...
<BR><BR>
<b>Note: Wildcards like *.com should be preceded with the user number
using a pattern like 0:*.com.</b>
<br>
<br>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Cpmchmod changes the file mode for files on CP/M disks.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
<DT><b>mode</b> Octal file mode, as used in the <b>unix command chmod</b>.<DD>
<BR>
<b>Numeric (Octal) file mode:</b>
<br>
<br>
From one to four octal digits. Any omitted digits are assumed to be leading zeros.
<br>
<br>
<b>chmod Examples:</b>
<br>
<br>
chmod 400 file - Read by owner<br>
chmod 040 file - Read by group<br>
chmod 004 file - Read by world
<br>
<br>
chmod 200 file - Write by owner<br>
chmod 020 file - Write by group<br>
chmod 002 file - Write by world
<br>
<br>
chmod 100 file - execute by owner<br>
chmod 010 file - execute by group<br>
chmod 001 file - execute by world
<br>
<br>
To combine these, just add the numbers together:
<br>
<br>
chmod 444 file - Allow read permission to owner and group and world<br>
chmod 777 file - Allow everyone to read, write, and execute file
<br>
<BR>
</DL>
<b>cmpchmod Examples:</b>
<BR>
<BR>
The following example shows how to change a file on an Apple II DOS 3.3
order cpm disk image to read only:
<BR>
<BR>
cpmchmod -f apple-do exmplcpm.dsk 444 bhead.c
<BR>
<BR>
The following example shows how to change a file on an Apple II DOS 3.3
order cpm disk image to read/write:
<BR>
<BR>
cpmchmod -f apple-do exmplcpm.dsk 666 bhead.c
<BR>
<BR>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system the
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system the
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
- Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR><BR>
- The location is also installation dependent and the diskdefs file
may also have been renamed.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to run cpmtools instead of Windows cmd. For those installations
unix-like conventions probably apply.
<br>
<br>
For cpmtools installations targetted at the average
Windows user who does not have a unix-like shell and uses the Windows cmd
prompt to run cpmtools there is no standard shared place that cpmtools will first
look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
even <b>c:\cpmtools\diskdefs</b> are possible.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF=" ./cpmls.htm">cmpls</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME cpmchmod - change file mode on CP/M files.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<b>Gradus ad Parnassum</b>
<br>
<br>
An ugly version of this document was initially created by man2html on November 14, 2008
using the cpmtools version 2.8 manual pages
then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
<br>
<br>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>
<HTML><HEAD><TITLE>CPMCHMOD - change file mode on CP/M files</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPMCHMOD</A></H2>
Section: User commands (1)<BR>
Updated: December 1, 2013<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpmchmod - change file mode on CP/M files.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>cpmchmod</B>
[<B>-f</B>
<I>format</I>]
<I>image</I>
<I>mode</I>
<I>file-pattern</I>
...
<BR><BR>
<b>Note: Wildcards like *.com should be preceded with the user number
using a pattern like 0:*.com.</b>
<br>
<br>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Cpmchmod changes the file mode for files on CP/M disks.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
<DT><b>mode</b> Octal file mode, as used in the <b>unix command chmod</b>.<DD>
<BR>
<b>Numeric (Octal) file mode:</b>
<br>
<br>
From one to four octal digits. Any omitted digits are assumed to be leading zeros.
<br>
<br>
<b>chmod Examples:</b>
<br>
<br>
chmod 400 file - Read by owner<br>
chmod 040 file - Read by group<br>
chmod 004 file - Read by world
<br>
<br>
chmod 200 file - Write by owner<br>
chmod 020 file - Write by group<br>
chmod 002 file - Write by world
<br>
<br>
chmod 100 file - execute by owner<br>
chmod 010 file - execute by group<br>
chmod 001 file - execute by world
<br>
<br>
To combine these, just add the numbers together:
<br>
<br>
chmod 444 file - Allow read permission to owner and group and world<br>
chmod 777 file - Allow everyone to read, write, and execute file
<br>
<BR>
</DL>
<b>cmpchmod Examples:</b>
<BR>
<BR>
The following example shows how to change a file on an Apple II DOS 3.3
order cpm disk image to read only:
<BR>
<BR>
cpmchmod -f apple-do exmplcpm.dsk 444 bhead.c
<BR>
<BR>
The following example shows how to change a file on an Apple II DOS 3.3
order cpm disk image to read/write:
<BR>
<BR>
cpmchmod -f apple-do exmplcpm.dsk 666 bhead.c
<BR>
<BR>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system the
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system the
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR>
To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
included in the Windows distro of the cpmtools binaries. These are included so you
can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
does not edit "unix" text.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<br>
<br>
The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to build and run cpmtools instead of Windows cmd. For those installations
unix-like conventions may apply.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF=" ./cpmls.htm">cmpls</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME cpmchmod - change file mode on CP/M files.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>

View File

@@ -1,290 +1,281 @@
<HTML><HEAD><TITLE>CPMCP - copy files from and to CP/M disks</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPMCP</A></H2>
Section: User commands (1)<BR>
Updated: June 16, 2008<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpmcp - copy files from and to CP/M disks.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>cpmcp</B>
[<B>-f</B>
<I>format</I>]
[<B>-p</B>]
[<B>-t</B>]
<I>image</I>
<I>user</I><B>:</B><I>file</I> <I>file</I>
<BR>
<BR>
<B>cpmcp</B>
[<B>-f</B>
<I>format</I>]
[<B>-p</B>]
[<B>-t</B>]
<I>image</I>
<I>user</I><B>:</B><I>file</I> ... <I>directory</I>
<BR>
<BR>
<B>cpmcp</B>
[<B>-f</B>
<I>format</I>]
[<B>-p</B>]
[<B>-t</B>]
<I>image</I>
<I>file</I> <I>user</I><B>:</B><I>file</I>
<BR>
<BR>
<B>cpmcp</B>
[<B>-f</B>
<I>format</I>]
[<B>-p</B>]
[<B>-t</B>]
<I>image</I>
<I>file</I> ... <I>user</I><B>:</B>
<BR><BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Cpmcp copies one or more files to or from a CP/M disk.</B>
<BR>
<BR>
When copying multiple files, the last argument must be a drive or directory.
The drive letter does not matter because the device is specified by the
image, it is only used to specify which direction you want to copy. The user
number is specified after the drive letter, if omitted user 0 is used.
<BR><BR>
You can use <B>*</B> and <B>?</B> as <b>"wildcards"</b> in CP/M file names,
which have the same meaning in unix-like shells, and also on the MS-DOS
and Windows command lines for file name patterns.
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR><BR>
<DT><B>-p</B><DD>
Preserve time stamps when copying files from CP/M to UNIX (not
implemented for copying the other way so far).
<BR>
<BR>
<DT><B>-t</B><DD>
Convert text files between CP/M and UNIX conventions.
<BR>
</DL>
<b>Examples:</b>
<BR>
<BR>
The following example shows how to copy a file from an Apple II DOS 3.3 order cpm disk image
to the current directory:
<BR>
<BR>
<b>cpmcp -f apple-do exmplcpm.dsk bhead.c 0:bhead.c</b>
<BR>
<BR>
The following example shows how to copy a file to an Apple II DOS 3.3 order cpm disk image
from the current directory:
<BR>
<BR>
<b>cpmcp -f apple-do exmplcpm.dsk 0:bhead.c bhead.c</b>
<BR>
<BR>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file that serves as a database of
disk and disk image format definitions. It can be reviewed for available
CP/M formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
- Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR><BR>
- The location is also installation dependent and the diskdefs file
may also have been renamed.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to run cpmtools instead of Windows cmd. For those installations
unix-like conventions probably apply.
<br>
<br>
For cpmtools installations targetted at the average
Windows user who does not have a unix-like shell and uses the Windows cmd
prompt to run cpmtools there is no standard shared place that cpmtools will first
look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
even <b>c:\cpmtools\diskdefs</b> are possible.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF=" ./cpmls.htm">cmpls</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME cpmcp - copy files from and to CP/M disks.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<b>Gradus ad Parnassum</b>
<br>
<br>
An ugly version of this document was initially created by man2html on November 14, 2008
using the cpmtools version 2.8 manual pages
then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
<br>
<br>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>
<HTML><HEAD><TITLE>CPMCP - copy files from and to CP/M disks</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPMCP</A></H2>
Section: User commands (1)<BR>
Updated: December 1, 2013<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpmcp - copy files from and to CP/M disks.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>cpmcp</B>
[<B>-f</B>
<I>format</I>]
[<B>-p</B>]
[<B>-t</B>]
<I>image</I>
<I>user</I><B>:</B><I>file</I> <I>file</I>
<BR>
<BR>
<B>cpmcp</B>
[<B>-f</B>
<I>format</I>]
[<B>-p</B>]
[<B>-t</B>]
<I>image</I>
<I>user</I><B>:</B><I>file</I> ... <I>directory</I>
<BR>
<BR>
<B>cpmcp</B>
[<B>-f</B>
<I>format</I>]
[<B>-p</B>]
[<B>-t</B>]
<I>image</I>
<I>file</I> <I>user</I><B>:</B><I>file</I>
<BR>
<BR>
<B>cpmcp</B>
[<B>-f</B>
<I>format</I>]
[<B>-p</B>]
[<B>-t</B>]
<I>image</I>
<I>file</I> ... <I>user</I><B>:</B>
<BR><BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Cpmcp copies one or more files to or from a CP/M disk.</B>
<BR>
<BR>
When copying multiple files, the last argument must be a drive or directory.
The drive letter does not matter because the device is specified by the
image, it is only used to specify which direction you want to copy. The user
number is specified after the drive letter, if omitted user 0 is used.
<BR><BR>
You can use <B>*</B> and <B>?</B> as <b>"wildcards"</b> in CP/M file names,
which have the same meaning in unix-like shells, and also on the MS-DOS
and Windows command lines for file name patterns.
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR><BR>
<DT><B>-p</B><DD>
Preserve time stamps when copying files from CP/M to UNIX (not
implemented for copying the other way so far).
<BR>
<BR>
<DT><B>-t</B><DD>
Convert text files between CP/M and UNIX conventions.
<BR>
</DL>
<b>Examples:</b>
<BR>
<BR>
The following example shows how to copy a file from an Apple II DOS 3.3 order cpm disk image
to the current directory:
<BR>
<BR>
<b>cpmcp -f apple-do exmplcpm.dsk 0:bhead.c bhead.c</b>
<BR>
<BR>
The following example shows how to copy a file to an Apple II DOS 3.3 order cpm disk image
from the current directory:
<BR>
<BR>
<b>cpmcp -f apple-do exmplcpm.dsk bhead.c 0:bhead.c</b>
<BR>
<BR>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR>
To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
included in the Windows distro of the cpmtools binaries. These are included so you
can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
does not edit "unix" text.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<br>
<br>
The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to build and run cpmtools instead of Windows cmd. For those installations
unix-like conventions may apply.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF=" ./cpmls.htm">cmpls</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME cpmcp - copy files from and to CP/M disks.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>

View File

@@ -1,235 +1,226 @@
<HTML><HEAD><TITLE>CPMLS - list sorted contents of directory</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPMLS</A></H2>
Section: User commands (1)<BR>
Updated: June 16, 2008<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpmls - list sorted contents of directory</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>cpmls</B>
[<B>-d</B>|<B>-D</B>|<B>-F</B>|<B>-A</B>|<B>-l</B>[<B>-c</B>][<B>-i</B>]]
[<B>-f</B>
<I>format</I>]
<I>image</I>
[<I>file-pattern</I>...]
<BR><BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Cpmls lists the sorted contents of the directory.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR><BR>
<DT><B>-d</B><BR><DD>
Old CP/M 2.2 dir output.
<BR><BR>
<DT><B>-D</B><BR><DD>
P2DOS 2.3 ddir-like output.
<BR><BR>
<DT><B>-F</B><BR><DD>
CP/M 3.x dir output.
<BR><BR>
<DT><B>-A</B><BR><DD>
E2fs lsattr-like output.
<BR><BR>
<DT><B>-l</B><BR><DD>
Long UNIX-style directory listing including size, time stamp and user number.
<BR><BR>
<DT><B>-c</B><BR><DD>
Output the creation time, not the modification time.
<BR><BR>
<DT><B>-i</B><BR><DD>
Print index number of each file.
<BR>
</DL>
<b>Example:</b>
<BR>
<BR>
The following example shows how to list the files on an Apple II DOS 3.3
order cpm disk image using a unix-like output:
<BR>
<BR>
<b>cpmls -f apple-do -l exmplcpm.dsk</b>
<BR>
<BR>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system the
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file that serves as a database of
disk and disk image format definitions. It can be reviewed for available
CP/M formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
- Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR><BR>
- The location is also installation dependent and the diskdefs file
may also have been renamed.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to run cpmtools instead of Windows cmd. For those installations
unix-like conventions probably apply.
<br>
<br>
For cpmtools installations targetted at the average
Windows user who does not have a unix-like shell and uses the Windows cmd
prompt to run cpmtools there is no standard shared place that cpmtools will first
look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
even <b>c:\cpmtools\diskdefs</b> are possible.
<BR>
<BR>
<A NAME="lbAJ">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF=" ./cpmcp.htm">cpmcp</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME cpmls - list sorted contents of directory.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<b>Gradus ad Parnassum</b>
<br>
<br>
An ugly version of this document was initially created by man2html on November 14, 2008
using the cpmtools version 2.8 manual pages
then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
<br>
<br>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>
<HTML><HEAD><TITLE>CPMLS - list sorted contents of directory</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPMLS</A></H2>
Section: User commands (1)<BR>
Updated: December 1, 2013<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpmls - list sorted contents of directory</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>cpmls</B>
[<B>-d</B>|<B>-D</B>|<B>-F</B>|<B>-A</B>|<B>-l</B>[<B>-c</B>][<B>-i</B>]]
[<B>-f</B>
<I>format</I>]
<I>image</I>
[<I>file-pattern</I>...]
<BR><BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Cpmls lists the sorted contents of the directory.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR><BR>
<DT><B>-d</B><BR><DD>
Old CP/M 2.2 dir output.
<BR><BR>
<DT><B>-D</B><BR><DD>
P2DOS 2.3 ddir-like output.
<BR><BR>
<DT><B>-F</B><BR><DD>
CP/M 3.x dir output.
<BR><BR>
<DT><B>-A</B><BR><DD>
E2fs lsattr-like output.
<BR><BR>
<DT><B>-l</B><BR><DD>
Long UNIX-style directory listing including size, time stamp and user number.
<BR><BR>
<DT><B>-c</B><BR><DD>
Output the creation time, not the modification time.
<BR><BR>
<DT><B>-i</B><BR><DD>
Print index number of each file.
<BR>
</DL>
<b>Example:</b>
<BR>
<BR>
The following example shows how to list the files on an Apple II DOS 3.3
order cpm disk image using a unix-like output:
<BR>
<BR>
<b>cpmls -f apple-do -l exmplcpm.dsk</b>
<BR>
<BR>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system the
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR>
To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
included in the Windows distro of the cpmtools binaries. These are included so you
can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
does not edit "unix" text.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<br>
<br>
The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to build and run cpmtools instead of Windows cmd. For those installations
unix-like conventions may apply.
<BR>
<BR>
<A NAME="lbAJ">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF=" ./cpmcp.htm">cpmcp</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME cpmls - list sorted contents of directory.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>

View File

@@ -1,203 +1,196 @@
<HTML><HEAD><TITLE>CPMRM - remove files on CP/M disks</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPMRM</H2>
Section: User commands (1)<BR>
Updated: June 16, 2008<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpmrm - remove files on CP/M disks.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>cpmrm</B>
[<B>-f</B>
<I>format</I>]
<I>image</I>
<I>file-pattern</I>
...
<BR><BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Cpmrm removes files from CP/M disks.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR>
<BR>
</DL>
<b>Example:</b>
<BR>
<BR>
The following example shows how to remove a file on an Apple II DOS 3.3
order cpm disk image:
<BR>
<BR>
<b>cpmrm -f apple-do exmplcpm.dsk 0:bhead.c</b>
<BR>
<BR>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file that serves as a database of
disk and disk image format definitions. It can be reviewed for available
CP/M formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
- Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR><BR>
- The location is also installation dependent and the diskdefs file
may also have been renamed.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to run cpmtools instead of Windows cmd. For those installations
unix-like conventions probably apply.
<br>
<br>
For cpmtools installations targetted at the average
Windows user who does not have a unix-like shell and uses the Windows cmd
prompt to run cpmtools there is no standard shared place that cpmtools will first
look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
even <b>c:\cpmtools\diskdefs</b> are possible.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME cpmrm - remove files on CP/M disks.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<b>Gradus ad Parnassum</b>
<br>
<br>
An ugly version of this document was initially created by man2html on November 14, 2008
using the cpmtools version 2.8 manual pages
then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
<br>
<br>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>
<HTML><HEAD><TITLE>CPMRM - remove files on CP/M disks</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">CPMRM</H2>
Section: User commands (1)<BR>
Updated: December 1, 2013<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME cpmrm - remove files on CP/M disks.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>cpmrm</B>
[<B>-f</B>
<I>format</I>]
<I>image</I>
<I>file-pattern</I>
...
<BR><BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Cpmrm removes files from CP/M disks.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR>
<BR>
</DL>
<b>Example:</b>
<BR>
<BR>
The following example shows how to remove a file on an Apple II DOS 3.3
order cpm disk image:
<BR>
<BR>
<b>cpmrm -f apple-do exmplcpm.dsk 0:bhead.c</b>
<BR>
<BR>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR>
To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
included in the Windows distro of the cpmtools binaries. These are included so you
can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
does not edit "unix" text.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<br>
<br>
The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to build and run cpmtools instead of Windows cmd. For those installations
unix-like conventions may apply.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF="./cpmls.htm">cpmls</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME cpmrm - remove files on CP/M disks.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>

View File

@@ -1,228 +1,218 @@
<HTML><HEAD><TITLE>FSCK.CPM - check a CP/M file system</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">FSCK.CPM</A></H2>
Section: User commands (1)<BR>
Updated: June 16, 2008<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME fsck.cpm - check a CP/M file system.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>fsck.cpm</B>
[<B>-f</B>
<I>format</I>]
[<B>-n</B>]
<I>image</I>
<BR><BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Fsck.cpm is used to check and repair a CP/M file system.</B>
<BR>
<BR>
After reading the directory, it makes two passes. The first pass checks
extent fields for range and format violations (bad status, extent number,
last record byte count, file name, extension, block number, record count,
size of .COM files, time stamp format, invalid password characters, invalid
time stamp mode). The second pass checks extent connectivity (multiple
allocated blocks and duplicate directory entries).
<BR>
<BR>
<B>fsck.cpm can not yet repair all errors.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR><BR>
<DT><B>-n</B><DD>
Open the file system read-only and do not repair any errors.
<BR>
<BR>
</DL>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file that serves as a database of
disk and disk image format definitions. It can be reviewed for available
CP/M formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
- Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR><BR>
- The location is also installation dependent and the diskdefs file
may also have been renamed.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to run cpmtools instead of Windows cmd. For those installations
unix-like conventions probably apply.
<br>
<br>
For cpmtools installations targetted at the average
Windows user who does not have a unix-like shell and uses the Windows cmd
prompt to run cpmtools there is no standard shared place that cpmtools will first
look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
even <b>c:\cpmtools\diskdefs</b> are possible.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>DIAGNOSTICS - <I>image</I>: used/total files (n.n% non-contiguos), used/total blocks</B>
<BR>
<BR>
No inconsistencies could be found. The number of used files actually
is the number of used extents. Since a file may use more than
one extent, this may be greater than the actual number of files, but a
correct measure would not reflect how many files could still be created
at most. A file is considered fragmented, if sequential data blocks
pointed to by the same extent do not have sequential block numbers.
The number of used blocks includes the blocks used for system tracks
and the directory.
<BR>
<BR>
<A NAME="lbAJ">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAK">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF="./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME fsck.cpm - check a CP/M file system.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
<DT><A HREF="#lbAI">DIAGNOSTICS</A><DD>
</DL>
<DT><A HREF="#lbAJ">AUTHORS</A><DD>
<DT><A HREF="#lbAK">SEE ALSO</A><DD>
</DL>
<HR>
<b>Gradus ad Parnassum</b>
<br>
<br>
An ugly version of this document was initially created by man2html on November 14, 2008
using the cpmtools version 2.8 manual pages
then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
<br>
<br>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>
<HTML><HEAD><TITLE>FSCK.CPM - check a CP/M file system</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">FSCK.CPM</A></H2>
Section: User commands (1)<BR>
Updated: December 1, 2013<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME fsck.cpm - check a CP/M file system.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>fsck.cpm</B>
[<B>-f</B>
<I>format</I>]
[<B>-n</B>]
<I>image</I>
<BR><BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Fsck.cpm is used to check and repair a CP/M file system.</B>
<BR>
<BR>
After reading the directory, it makes two passes. The first pass checks
extent fields for range and format violations (bad status, extent number,
last record byte count, file name, extension, block number, record count,
size of .COM files, time stamp format, invalid password characters, invalid
time stamp mode). The second pass checks extent connectivity (multiple
allocated blocks and duplicate directory entries).
<BR>
<BR>
<B>fsck.cpm can not yet repair all errors.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR><BR>
<DT><B>-n</B><DD>
Open the file system read-only and do not repair any errors.
<BR>
<BR>
</DL>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR>
To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
included in the Windows distro of the cpmtools binaries. These are included so you
can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
does not edit "unix" text.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<br>
<br>
The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to build and run cpmtools instead of Windows cmd. For those installations
unix-like conventions may apply.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>DIAGNOSTICS - <I>image</I>: used/total files (n.n% non-contiguos), used/total blocks</B>
<BR>
<BR>
No inconsistencies could be found. The number of used files actually
is the number of used extents. Since a file may use more than
one extent, this may be greater than the actual number of files, but a
correct measure would not reflect how many files could still be created
at most. A file is considered fragmented, if sequential data blocks
pointed to by the same extent do not have sequential block numbers.
The number of used blocks includes the blocks used for system tracks
and the directory.
<BR>
<BR>
<A NAME="lbAJ">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAK">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF="./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME fsck.cpm - check a CP/M file system.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
<DT><A HREF="#lbAI">DIAGNOSTICS</A><DD>
</DL>
<DT><A HREF="#lbAJ">AUTHORS</A><DD>
<DT><A HREF="#lbAK">SEE ALSO</A><DD>
</DL>
<HR>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>

View File

@@ -1,202 +1,193 @@
<HTML><HEAD><TITLE>FSED.CPM - edit a CP/M file system</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">FSED.CPM</A></H2>
Section: User commands (1)<BR>
Updated: June 16, 2008<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME fsed.cpm - edit a CP/M file system.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>fsed.cpm</B>
[<B>-f</B>
<I>format</I>]
<I>image</I>
<BR>
<BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Fsed.cpm edits a CP/M file system on an image file or device.</B>
<BR>
<BR>
It knows about the system, directory and data area, using sector skew on
the last two. Directory entries are decoded. The interactive usage is
self-explanatory, provided you are familiar with programming tools like
hexadecimal editors. If you are not then you should work with this program
and familiarize yourself with its usage.
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR><BR>
</DL>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file that serves as a database of
disk and disk image format definitions. It can be reviewed for available
CP/M formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
- Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR><BR>
- The location is also installation dependent and the diskdefs file
may also have been renamed.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to run cpmtools instead of Windows cmd. For those installations
unix-like conventions probably apply.
<br>
<br>
For cpmtools installations targetted at the average
Windows user who does not have a unix-like shell and uses the Windows cmd
prompt to run cpmtools there is no standard shared place that cpmtools will first
look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
even <b>c:\cpmtools\diskdefs</b> are possible.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF="./fsck.cpm.htm">mkfs.cpm</A></I>(1),
<I><A HREF="./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
<I><A HREF="./cpmls.htm">cpmls</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME fsed.cpm - edit a CP/M file system.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<b>Gradus ad Parnassum</b>
<br>
<br>
An ugly version of this document was initially created by man2html on November 14, 2008
using the cpmtools version 2.8 manual pages
then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
<br>
<br>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>
<HTML><HEAD><TITLE>FSED.CPM - edit a CP/M file system</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">FSED.CPM</A></H2>
Section: User commands (1)<BR>
Updated: December 1, 2013<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME fsed.cpm - edit a CP/M file system.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>fsed.cpm</B>
[<B>-f</B>
<I>format</I>]
<I>image</I>
<BR>
<BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Fsed.cpm edits a CP/M file system on an image file or device.</B>
<BR>
<BR>
It knows about the system, directory and data area, using sector skew on
the last two. Directory entries are decoded. The interactive usage is
self-explanatory, provided you are familiar with programming tools like
hexadecimal editors. If you are not then you should work with this program
and familiarize yourself with its usage.
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR><BR>
</DL>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR>
To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
included in the Windows distro of the cpmtools binaries. These are included so you
can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
does not edit "unix" text.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<br>
<br>
The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to build and run cpmtools instead of Windows cmd. For those installations
unix-like conventions may apply.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF="./fsck.cpm.htm">fsck.cpm</A></I>(1),
<I><A HREF="./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
<I><A HREF="./cpmls.htm">cpmls</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME fsed.cpm - edit a CP/M file system.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>

View File

@@ -1,11 +1,14 @@
<HTML><HEAD><TITLE>Cpmtools 2.9 Executables for Windows Users</TITLE>
<HTML><HEAD><TITLE>Wild Turkey - Cpmtools Executables for Windows Users</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<a name=topmenu></a><FONT FACE="Arial" SIZE=3><P>
<center>
<B>Welcome to the Wonderfully Ancient World of CP/M<br></B>
Cpmtools 2.9 Executables for Windows Users<br></FONT>
Cpmtools Executables for Windows Users<br>
<img src="./wturkey.gif" alt="Wild Turkey" BORDER="0" ALIGN="middle"><br>
The Wild Turkey Distribution<br>
</FONT>
</center>
<FONT FACE="Arial" SIZE=2 COLOR="#000000">
<UL>
@@ -13,11 +16,13 @@ Cpmtools 2.9 Executables for Windows Users<br></FONT>
<br>
<UL>
<a href="./index.htm#intro">Introduction</a><br>
<a href="./index.htm#custom">Customizations</a><br>
<a href="./index.htm#features">Features</a><br>
<a href="./index.htm#licence">Licence</a><br>
<a href="./index.htm#disclaimer">Disclaimer</a><br>
</UL>
<br>
<a name=programs></a><b>Program Documentation</b><br>
<a name=programs></a><b>cpmtools Program Documentation</b><br>
<br>
<UL>
<a href="./cpm.htm">CPM - CP/M disk and file system format</a><br>
@@ -45,7 +50,6 @@ Cpmtools 2.9 Executables for Windows Users<br></FONT>
<UL>
<a href="./index.htm#unix">cpmtools source code</a><br>
<a href="./index.htm#windows">cpmtools Native Win32 Executables</a><br>
<a href="./index.htm#cygwin">cpmtools cygwin Win32 Executables</a><br>
<a href="./index.htm#resources">CP/M Resources</a><br>
</UL>
</UL>
@@ -64,8 +68,8 @@ source code... just to use them.</b>
</FONT>
<BR>
<BR>
Cpmtools is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
Cpmtools is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR>
<BR>
<a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
@@ -109,7 +113,7 @@ option) any later version.
<a name="unix"></a><b>Downloads</b>
<br>
<br>
The source for the <b>latest version of cpmtools</b> is available as
The source for the <b>latest "official" version of cpmtools</b> is available as
a GNU zipped tape archive from:
<br>
<br>
@@ -118,37 +122,59 @@ a GNU zipped tape archive from:
</b>
<br>
<br>
The cpmtools source used in cygwin to build both the Windows binary (Executable) versions of
cpmtools 2.9 noted below is available from the
<a name="windows"></a><b>Cpmtools For Windows Users</b>
<br>
<br>
<center>
<img src="./turkey.gif" alt="Cooked Turkey" BORDER="0" ALIGN="middle"><br>
<b>A Forked Version</b>
</center>
<br>
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.
<I>(Tom's Alloc became Turkey Alloc as Thanksgiving 2013 and his MinGW solution roughly coincided.)</I>
<br>
<br>
<b>Native Win32 cpmtools Binaries (Executables)</b> are available from the
<a href="http://www.cpm8680.com/">www.cpm8680.com Website</a> in a zip file format:
<br>
<br>
<b>
<a href="http://www.cpm8680.com/cpmtools/cpmtools-2.9.zip">http://www.cpm8680.com/cpmtools/cpmtools-2.9.zip</a>
<a href="http://www.cpm8680.com/cpmtools/cpmtoolsWin32.zip">http://www.cpm8680.com/cpmtools/cpmtoolsWin32.zip</a>
</b>
<br>
<br>
<a name="windows"></a><b>For Windows Users</b> who do not wish to make working programs from source code, a compiled
<b>Native Win32 Binary (Executable)</b> version of cpmtools 2.9 is available from the
<a href="http://www.cpm8680.com/">www.cpm8680.com Website</a> in a zip file format:
The cpmtools source used to build the Windows binaries (Executables) is included in the zip file.
<br>
<br>
<b>
<a href="http://www.cpm8680.com/cpmtools/cpmtools-2.9-Win32.zip">http://www.cpm8680.com/cpmtools/cpmtools-2.9-Win32.zip</a>
</b>
<b>To install cpmtools</b>, 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.
<br>
<br>
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.
<b>To run cpmtools</b>, 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.
<br>
<br>
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.
<BR>
<BR>
<FONT FACE="Arial" SIZE=2 COLOR="#0000ff"><b>
The distribution noted above has the following customizations:</b>
<a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
<BR>
<BR>
<a name=custom></a><b>The Wild Turkey Distribution has the following customizations:</b>
<FONT FACE="Arial" SIZE=2 COLOR="#0000ff">
<br>
<br>
<b>The default disk image format is apple-do</b>. This means that if you are working
@@ -157,79 +183,106 @@ format option when typing in your command line.
<br>
<br>
<b>The diskdefs file is called \cpmtools\diskdefs</b>. 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.
<br>
<br>
<b>A Windows XP Shortcut has been added for Windows XP Users</b>. 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.
</FONT>
<BR>
<BR>
<a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
<br>
<br>
<a name="cygwin"></a><b>For cygwin Users</b> who do not wish to make working programs from source code, a compiled
<b>cygwin 5 Binary (Executable)</b> version of cpmtools 2.9 is available from the
<a href="http://www.cpm8680.com/">www.cpm8680.com Website</a> in a zip file format:
<br>
<br>
<b>
<a href="http://www.cpm8680.com/cpmtools/cpmtools-2.9-cygwin.zip">http://www.cpm8680.com/cpmtools/cpmtools-2.9-cygwin.zip</a>
into the executables.
</b>
<br>
<br>
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.
<br>
<br>
The cygwin installation comes complete with the manpages but not the html manual.
It overlays your cygwin installation so review the zip before installing.
<BR>
<BR>
<FONT FACE="Arial" SIZE=2 COLOR="#0000ff"><b>
The distribution noted above has the following customization:</b>
<br>
<br>
<b>The default disk image format is apple-do</b>. 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.
<br>
<br>
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.
</FONT>
<BR>
<BR>
<a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
<br>
<br>
<BR>
<BR>
<a name=features></a><B>The Wild Turkey Distribution has the following features:</B>
<BR>
<UL>
* HTML documentation with additional information and examples for Windows Users.<BR>
* Runs Without Compiling (no need to be a programmer).<BR>
* Runs in Native Windows (no need for non-native shells or additional DLL's).<BR>
* Runs Under Windows XP - 31% of Desktop Computers Worldwide (November 2013).<BR>
* Runs Under Windows 7 - 46% of Desktop Computers Worldwide (November 2013).<BR>
* Pre-configured for Apple II CP/M (the single most popular platform to run CP/M).<BR>
</UL>
<a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
<HR>
<a name="resources"><b>CP/M Resources</b></a>
<BR>
<BR>
<a href="http://www.aztecmuseum.ca/index.htm#cpm">Aztec C CP/M compilers</a> for
making programs in Windows, MS-DOS, and CP/M that will run in CP/M are available
from the <a href="http://www.aztecmuseum.ca/">Aztec C Museum Website</a> 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.
<b>Compilers</b><br><br>
<UL>
<a href="http://www.aztecmuseum.ca/index.htm#cpm"><b>Aztec C compilers</b></a>
<br>
<br>
The <a href="http://www.aztecmuseum.ca/">Aztec C Museum Website</a> is only one of many free
CP/M resources on the Internet <b>too numerous to mention</b> that can be used in conjunction with
cpmtools. Some of these include:
Aztec C compilers for making programs in Windows, MS-DOS, and CP/M that will
run in CP/M are available from
the <a href="http://www.aztecmuseum.ca/">Aztec C Museum Website</a> 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.
<br>
<br>
Using <b>MS-DOS Emulators</b> like <a href="http://www.dosbox.com/">DOSBox</a>
and <a href="http://dosemu.sourceforge.net/">DOSEMU</a>,
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.
<br>
<br>
<a href="http://www.z80.eu/c-compiler.html"><b>Peter Dassow's C Compiler Site</b></a>
<br>
<br>
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.
<br>
<br>
<a href="http://primepuzzle.com/mouse/hints0.htm"><b>Lee Bradley's MaxZ80 Tutorial Project</b></a>
<br>
<br>
<b>CP/M Emulators</b> 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.
<br>
<br>
In the spirit of providing a <b>rewarding educational experience</b> 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. </b>Click on a
topic in the list, then press the TAB key followed by the ENTER key to select
a topic</b>.
<br>
<br>
<a href="http://primepuzzle.com/mouse/maxz80.zip">http://primepuzzle.com/mouse/maxz80.zip</a>
<br>
<br>
<a href="http://www.bdsoft.com/resources/bdsc.html"><b>Leor Zolman's BDS C Compiler</b></a>
<br>
</UL>
<a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
<br>
<br>
<b>Other CP/M Resources</b>
<br>
<br>
CP/M resources on the Internet that can be used in conjunction with
cpmtools are <b>too numerous to mention</b>. Some are listed below:
<br>
<UL>
<A HREF="http://www.moria.de/~michael/cpmtools/"><b>Michael Haardt's cpmtools Main Page</b></a><br>
<A HREF="http://tech.groups.yahoo.com/group/applecpm/">Willi Kusche's Apple CPM Group on Yahoo</a><br>
<a href="http://www.apple2info.net/hardware/softcard/softcard.htm">The Microsoft Softcard</a><br>
<a href="ftp://ftp.apple.asimov.net/pub/apple_II/images/cpm/">The Apple II CP/M Archives at ftp.apple.asimov.net</a><br>
<a href="http://www.seasip.info/Cpm/index.html">John Elliot's CP/M Pages Site</a><br>
<a href="http://www.cpm.z80.de/index.html">The Unofficial CP/M Website aka Gaby Chaudry's Site</a><br>
<a href="http://groups.google.com/group/comp.sys.apple2/topics">The comp.sys.apple2 Newsgroup on google</b><br>
<a href="http://groups.google.com/group/comp.os.cpm/topics">The comp.os.cpm Newsgroup on google</b><br>
<a href="http://www.z80.eu/">Peter Dassow's Website at z80.eu</a><br>
<a href="http://www.seasip.info/Cpm/index.html"><b>John Elliot's CP/M Pages</b></a><br>
<a href="http://www.cpm.z80.de/index.html">Gaby's Unofficial CP/M Website</a><br>
<a href="http://www.gaby.de/ehome.htm">Gaby Chaudry's Home Page</a><br>
<a href="http://ftp.gaby.de/">Gaby's FTP Server</b><br>
<a href="http://www.cpm80.com/">Harte Technologies CP/M-80 Information and Download Page</a><br>
<a href="http://www.retroarchive.org/cpm/">Commercial CP/M Software Archive</a><br>
</UL>
@@ -240,8 +293,8 @@ cpmtools. Some of these include:
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
This document was written and formatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>. Its
contents are either part of cpmtools or provide additional information about using cmptools. It is targetted primarily
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.
<br>
<br>

View File

@@ -1,215 +1,214 @@
<HTML><HEAD><TITLE>MKFS.CPM - make a CP/M file system</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">MKFS.CPM</A></H2>
Section: User commands (1)<BR>
Updated: June 16, 2008<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME mkfs.cpm - make a CP/M file system.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>mkfs.cpm</B>
[<B>-f</B>
<I>format</I>]
[<B>-b</B>
<I>boot</I>]
[<B>-L</B>
<I>label</I>]
<I>image</I>
<BR>
<BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Mkfs.cpm makes a CP/M file system on an image file or device.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR><BR>
<DT><B>-b</B> <I>bootblock</I><DD>
<BR>
Write the contents of the file <I>bootblock</I> to the system tracks
instead of filling them with 0xe5. This option can be used up to four
times. The file contents (typically boot block, CCP, BDOS and BIOS)
are written to sequential sectors, padding with 0xe5 if needed.
<BR>
<BR>
<DT><B>-L</B> <I>label</I><DD>
<BR>
Label the file system. This is only supported by CP/M Plus.
<BR><BR>
</DL>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file that serves as a database of
disk and disk image format definitions. It can be reviewed for available
CP/M formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
- Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR><BR>
- The location is also installation dependent and the diskdefs file
may also have been renamed.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to run cpmtools instead of Windows cmd. For those installations
unix-like conventions probably apply.
<br>
<br>
For cpmtools installations targetted at the average
Windows user who does not have a unix-like shell and uses the Windows cmd
prompt to run cpmtools there is no standard shared place that cpmtools will first
look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
even <b>c:\cpmtools\diskdefs</b> are possible.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF="./cpmls.htm">cpmls</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME mkfs.cpm - make a CP/M file system.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<b>Gradus ad Parnassum</b>
<br>
<br>
An ugly version of this document was initially created by man2html on November 14, 2008
using the cpmtools version 2.8 manual pages
then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
<br>
<br>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>
<HTML><HEAD><TITLE>MKFS.CPM - make a CP/M file system</TITLE>
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
<FONT FACE="Arial" SIZE=2>
<H2><A NAME="lbAA">MKFS.CPM</A></H2>
Section: User commands (1)<BR>
Updated: December 1, 2013<BR><BR>
<A HREF="#index">Index&nbsp;&nbsp;</A>
<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
<A NAME="lbAB">&nbsp;</A>
<B>NAME mkfs.cpm - make a CP/M file system.</B><BR><BR>
<A NAME="lbAC">&nbsp;</A>
<B>SYNOPSIS</B><BR><BR>
<B>mkfs.cpm</B>
[<B>-f</B>
<I>format</I>]
[<B>-b</B>
<I>boot</I>]
[<B>-L</B>
<I>label</I>]
[<B>-t</B>]
<I>image</I>
<BR>
<BR>
<A NAME="lbAD">&nbsp;</A>
<B>DESCRIPTION</B><BR><BR>
<B>Mkfs.cpm makes a CP/M file system on an image file or device.</B>
<BR>
<BR>
<A NAME="lbAE">&nbsp;</A>
<B>OPTIONS</B><BR><BR>
<DL COMPACT><DT><DD>
<DT><B>-f</B><BR><DD>
Use the given CP/M disk <I>format</I> instead of the default format.
<BR><BR>
For Apple II CP/M 80
users the disk image formats apple-do and apple-po are available. These
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
<BR><BR>
<DT><B>-b</B> <I>bootblock</I><DD>
<BR>
Write the contents of the file <I>bootblock</I> to the system tracks
instead of filling them with 0xe5. This option can be used up to four
times. The file contents (typically boot block, CCP, BDOS and BIOS)
are written to sequential sectors, padding with 0xe5 if needed.
<BR>
<BR>
<DT><B>-L</B> <I>label</I><DD>
<BR>
Label the file system. This is only supported by CP/M Plus.
<BR><BR>
<DT><B>-t</B><DD>
Create time stamps.
<BR><BR>
</DL>
<A NAME="lbAF">&nbsp;</A>
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAG">&nbsp;</A>
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
This will likely only be of interest to programmers. In a Win32 system
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
return value when run from another Win32 console program written in a
language like C.
<BR><BR>
<A NAME="lbAH">&nbsp;</A>
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
that serves as a database of
disk and disk image format definitions. It can be reviewed for available CP/M
formats and their names. For Apple II CP/M 80 users the disk
image formats apple-do and apple-po are available.
<BR>
To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
included in the Windows distro of the cpmtools binaries. These are included so you
can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
does not edit "unix" text.
<BR><BR>
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
<BR>
<BR>
Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
<BR>
<BR>
<b>If it's not found the current (work) directory is then searched for a
file called diskdefs.</b>
<br>
<br>
The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
<BR>
<BR>
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
look for diskdefs.
<BR>
<BR>
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
are used to build and run cpmtools instead of Windows cmd. For those installations
unix-like conventions may apply.
<BR>
<BR>
<A NAME="lbAI">&nbsp;</A>
<B>AUTHORS</B>
<BR>
<BR>
This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
The Windows port is
copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
<BR><BR>
This program is free software; you can redistribute it and/or modify
it under the terms of
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<BR><BR>
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
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
<BR><BR>
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.
<BR><BR>
<A NAME="lbAJ">&nbsp;</A>
<B>SEE ALSO</B><BR><BR>
<I><A HREF="./fsck.cpm.htm">fsck.cpm</A></I>(1),
<I><A HREF="./cpmls.htm">cpmls</A></I>(1),
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
<BR><BR>
<HR>
<A NAME="index">&nbsp;</A><B>Index</B>
<BR>
<BR>
<DL>
<DT><A HREF="#lbAA">NAME mkfs.cpm - make a CP/M file system.</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
<DT><A HREF="#lbAG">ERRORS</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
</DL>
<DT><A HREF="#lbAI">AUTHORS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
<a name="disclaimer"><b>Caveat Emptor</b></a>
<br>
<br>
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 <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
<br>
<br>
Bill Buckels has no warranty
obligations or liability resulting from this document's use in any way whatsoever. If you don't
agree then don't read it.
</FONT></BODY>
</HTML>

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB