FSCK.CPM

Section: User commands (1)
Updated: December 1, 2013

Index   Return to Main Contents   Disclaimer  

  NAME fsck.cpm - check a CP/M file system.

  SYNOPSIS

fsck.cpm [-f format] [-n] image

  DESCRIPTION

Fsck.cpm is used to check and repair a CP/M file system.

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

fsck.cpm can not yet repair all errors.

  OPTIONS

-f
Use the given CP/M disk format instead of the default format.

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 -f apple-do or -f apple-po.

-n
Open the file system read-only and do not repair any errors.

  RETURN VALUE - Upon successful completion, exit code 0 is returned.

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.

  ERRORS - Any errors are indicated by exit code 1.

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.

  FILES - diskdefs - CP/M disk format definitions

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

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.

If it's not found the current (work) directory is then searched for a file called diskdefs.

The Windows distro uses \cpmtools\diskdefs as a default.

On a unix-like system, a ${prefix}/share/ style path like /usr/local/share/ is a possible place that cpmtools will first look for diskdefs.

In a Win32 system 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.

  DIAGNOSTICS - image: used/total files (n.n% non-contiguos), used/total blocks

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.

  AUTHORS

This program is copyright 1997-2013 Michael Haardt <michael@moria.de>. The Windows port is copyright 2000, 2001, 2011 John Elliott <jce@seasip.demon.co.uk>.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

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 GNU General Public License for more details.

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.

  SEE ALSO

mkfs.cpm(1), cpm(5)

 Index

NAME fsck.cpm - check a CP/M file system.
SYNOPSIS
DESCRIPTION
OPTIONS
RETURN VALUE
ERRORS
FILES
DIAGNOSTICS
AUTHORS
SEE ALSO
Caveat Emptor

The contents of this document are either part of cpmtools or provide additional information about using cmptools. You can redistribute it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

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.