+++ /dev/null
-.\" Believe it or not, reportedly there are nroffs which do not know \(en
-.if n .ds en -
-.if t .ds en \(en
-.TH CPM 5 "October 10, 2022" "CP/M tools" "File formats"
-.SH NAME \"{{{roff}}}\"{{{
-cpm \- CP/M disk and file system format
-.\"}}}
-.SH DESCRIPTION \"{{{
-.SS "Characteristic sizes" \"{{{
-Each CP/M disk format is described by the following specific sizes:
-.RS
-.sp
-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 and not covered by operating system,
-but disk driver specific)
-.sp
-.RE
-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. \fBcpmtools\fP always counts
-sectors starting with 0, as it deals with logical sectors. CP/M uses physical
-sectors in the skew table, which often start with 1.
-.\"}}}
-.SS "Device areas" \"{{{
-A CP/M disk contains four areas:
-.RS
-.sp
-Volume offset (optional and not covered by operating system, but disk driver specific)
-.br
-System tracks (optional)
-.br
-Directory
-.br
-Data
-.sp
-.RE
-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 \fIdisk capacity\fP 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.
-.LP
-A hard disk can have the additional notion of a \fIvolume offset\fP 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
-\fIK\fP, \fIM\fP, \fIT\fP or \fIS\fP 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. The \fBoffset\fP must appear subsequent to track, sector and sector
-length values for the sector and track units to work.
-.LP
-Note that it is possible to reserve space between the directory and
-the beginning of data. Although typically data follows the directory,
-some systems used this to store extra data instead of using more
-system tracks (see the fields \fBALV0\fP and \fBALV1\fP in the
-DPB).
-.LP
-There are disk formats that map multiple logical tracks onto a physical
-track, which allows a little bit more capacity in case the system image
-size does not match the physical track capacity well.
-.\"}}}
-.SS "Directory entries" \"{{{
-The directory is a sequence of directory entries (also called extents),
-which contain 32 bytes of the following structure:
-.RS
-.sp
-.ta 3n 6n 9n 12n 15n 18n 21n 24n 27n 30n 33n 36n 39n 42n 45n
-St F0 F1 F2 F3 F4 F5 F6 F7 E0 E1 E2 Xl Bc Xh Rc
-.br
-Al Al Al Al Al Al Al Al Al Al Al Al Al Al Al Al
-.sp
-.RE
-.\"{{{ St = status
-\fBSt\fP is the status; possible values are:
-.RS
-.sp
-0\*(en15: used for file, status is the user number. CP/M 2.2 only documents
-0\*(en15 and CCP and PIP only offer those, but the BDOS allows to use 0\*(en31.
-.br
-16\*(en31: used for file, status is the user number (P2DOS, CP/M 2.2)
-or used for password extent (CP/M 3 or higher)
-.br
-32: disc label
-.br
-33: time stamp (P2DOS)
-.br
-0xE5: unused
-.sp
-.RE
-.\"}}}
-.LP
-.\"{{{ F0-E2 = file name and extension
-\fBF0\*(enE2\fP are the file name and its extension. They may consist of
-any printable 7 bit ASCII character but: \fB< > . , ; : = ? * [ ]\fP.
-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:
-.RS
-.sp
-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
-.sp
-.RE
-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.
-.LP
-The wheel byte is (by default) the memory location at 0x4b. If it is
-zero, only non-privileged commands may be executed.
-.\"}}}
-.LP
-.\"{{{ Xl, Xh = extent number
-\fBXl\fP and \fBXh\fP 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\*(en7 of
-Xl are 0, bit 0\*(en4 store the lower bits of the extent number. Bit 6
-and 7 of Xh are 0, bit 0\*(en5 store the higher bits of the extent number.
-.\"}}}
-.LP
-.\"{{{ Rc, Bc = record count, byte count
-\fBRc\fP and \fBBc\fP 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.
-This only applies to files with allocated blocks. For an empty file, no
-block is allocated and Bc 0 has no meaning.
-.\"}}}
-.LP
-.\"{{{ Al = allocated blocks
-\fBAl\fP stores block pointers. If the disk capacity minus boot
-tracks but including the directory area is less than or equal to 256 blocks, Al
-is interpreted as 16 byte-values, otherwise as 8 double-byte-values.
-Since the directory 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 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.
-.\"}}}
-.\"}}}
-.SS "Native time stamps" \"{{{
-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:
-.RS
-.sp
-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
-.sp
-.RE
-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.
-.RS
-.sp
-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
-.sp
-.RE
-All time stamps are stored in local time.
-.\"}}}
-.SS "DateStamper time stamps" \"{{{
-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. It contains one entry per directory entry with the
-following structure of 16 bytes:
-.RS
-.sp
-5 bytes create datefield
-.br
-5 bytes access datefield
-.br
-5 bytes modify datefield
-.br
-1 byte magic number/checksum
-.sp
-.RE
-The magic number is used for the first 7 entries of each 128-byte record
-and contains the characters \fB!\fP, \fB!\fP, \fB!\fP, \fBT\fP, \fBI\fP,
-\fBM\fP and \fBE\fP. The checksum 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:
-.RS
-.sp
-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
-.sp
-.DE
-.\"}}}
-.SS "Disc labels" \"{{{
-CP/M Plus support disc labels, which are stored in an arbitrary directory
-entry.
-The structure of disc labels is:
-.RS
-.sp
-1 byte status 0x20
-.br
-\fBF0\*(enE2\fP 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
-.sp
-.RE
-.\"}}}
-.SS "Passwords" \"{{{
-CP/M Plus supports passwords, which are stored in an arbitrary directory
-entry.
-The structure of these entries is:
-.RS
-.sp
-1 byte status (user number plus 16)
-.br
-\fBF0\*(enE2\fP 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
-.sp
-.RE
-.\"}}}
-.\"}}}
-.SH "SEE ALSO" \"{{{
-.IR mkfs.cpm (1),
-.IR fsck.cpm (1),
-.IR fsed.cpm (1),
-.IR cpmls (1)
-.\"}}}
+++ /dev/null
-.TH CPMCHATTR 1 "October 10, 2022" "CP/M tools" "User commands"
-.SH NAME \"{{{roff}}}\"{{{
-cpmchattr \- change file attributes on CP/M files
-.\"}}}
-.SH SYNOPSIS \"{{{
-.ad l
-.B cpmchattr
-.RB [ \-f
-.IR format ]
-.RB [ \-u ]
-.I image
-.I attrib
-.I file-pattern
-\&...
-.ad b
-.\"}}}
-.SH DESCRIPTION \"{{{
-\fBCpmchattr\fP changes the file attributes for files on CP/M disks.
-.\"}}}
-.SH OPTIONS \"{{{
-.IP "\fB\-f\fP \fIformat\fP"
-Use the given CP/M disk \fIformat\fP instead of the default format.
-.IP "\fB\-T\fP \fIlibdsk-type\fP"
-libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images
-(requires building cpmtools with support for libdsk).
-.IP "\fB\-u\fP"
-Show all CP/M file names in upper case.
-.IP "\fIattrib\fP"
-Set the file attributes as given.
-.\"}}}
-.SH "FILE ATTRIBUTES" \"{{{
-The file attribute string can contain the characters
-1,2,3,4,r,s,a,n and m.
-The meanings of these are:
-.TP
-.B 1-4
-The CP/M "user attributes" F1-F4. CP/M does not assign any
-meaning to these attributes, though MP/M does.
-.TP
-.B r
-The file is read-only. This is the same as using
-.I cpmchmod(1)
-to revoke write permissions.
-.TP
-.B s
-The file is a system file. This attribute can also be set by
-.I cpmchmod(1).
-.TP
-.B a
-The file has been backed up.
-.TP
-.B n
-Reset all attributes to zero. So the string "n1r" resets all attributes and
-then sets F1 and Read-Only.
-.TP
-.B m
-Attributes after an m are unset rather than set. The string "12m34" sets
-atttributes F1 and F2, and unsets F3 and F4.
-.\"}}}
-.SH "RETURN VALUE" \"{{{
-Upon successful completion, exit code 0 is returned.
-.\"}}}
-.SH ERRORS \"{{{
-Any errors are indicated by exit code 1.
-.\"}}}
-.SH ENVIRONMENT \"{{{
-CPMTOOLSFMT Default format
-.\"}}}
-.SH FILES \"{{{
-${prefix}/share/diskdefs CP/M disk format definitions
-.\"}}}
-.SH AUTHORS \"{{{
-This program is copyright 1997\(en2021 Michael Haardt
-<michael@moria.de> and copyright 2000, 2001, 2011 John Elliott
-<jce@seasip.demon.co.uk>.
-.PP
-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.
-.PP
-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.
-.PP
-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.
-.\"}}}
-.SH "SEE ALSO" \"{{{
-.IR cpmls (1),
-.IR cpmchmod (1),
-.IR cpm (5)
-.\"}}}
+++ /dev/null
-.TH CPMCHMOD 1 "October 10, 2022" "CP/M tools" "User commands"
-.SH NAME \"{{{roff}}}\"{{{
-cpmchmod \- change file mode on CP/M files
-.\"}}}
-.SH SYNOPSIS \"{{{
-.ad l
-.B cpmchmod
-.RB [ \-f
-.IR format ]
-.RB [ \-u ]
-.I image
-.I mode
-.I file-pattern
-\&...
-.ad b
-.\"}}}
-.SH DESCRIPTION \"{{{
-\fBCpmchmod\fP changes the file mode for files on CP/M files.
-.\"}}}
-.SH OPTIONS \"{{{
-.IP "\fB\-f\fP \fIformat\fP"
-Use the given CP/M disk \fIformat\fP instead of the default format.
-.IP "\fB\-T\fP \fIlibdsk-type\fP"
-libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images
-(requires building cpmtools with support for libdsk).
-.IP "\fB\-u\fP"
-Show all CP/M file names in upper case.
-.IP "\fImode\fP"
-Octal file mode, as used in \fIchmod\fP(1).
-.\"}}}
-.SH "RETURN VALUE" \"{{{
-Upon successful completion, exit code 0 is returned.
-.\"}}}
-.SH ERRORS \"{{{
-Any errors are indicated by exit code 1.
-.\"}}}
-.SH ENVIRONMENT \"{{{
-CPMTOOLSFMT Default format
-.\"}}}
-.SH FILES \"{{{
-${prefix}/share/diskdefs CP/M disk format definitions
-.\"}}}
-.SH AUTHORS \"{{{
-This program is copyright 1997\(en2021 Michael Haardt
-<michael@moria.de> and copyright 2000, 2001, 2011 John Elliott
-<jce@seasip.demon.co.uk>.
-.PP
-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.
-.PP
-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.
-.PP
-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.
-.\"}}}
-.SH "SEE ALSO" \"{{{
-.IR cpmls (1),
-.IR chmod (1),
-.IR cpm (5)
-.\"}}}
+++ /dev/null
-.TH CPMCP 1 "October 10, 2022" "CP/M tools" "User commands"
-.SH NAME \"{{{roff}}}\"{{{
-cpmcp \- copy files from and to CP/M disks
-.\"}}}
-.SH SYNOPSIS \"{{{
-.ad l
-.B cpmcp
-.RB [ \-f
-.IR format ]
-.RB [ \-p ]
-.RB [ \-t ]
-.I image
-.RB [ \-u ]
-\fIuser\fP\fB:\fP\fIfile\fP \fIfile\fP
-.br
-.B cpmcp
-.RB [ \-f
-.IR format ]
-.RB [ \-p ]
-.RB [ \-t ]
-.I image
-.RB [ \-u ]
-\fIuser\fP\fB:\fP\fIfile\fP ... \fIdirectory\fP
-.br
-.B cpmcp
-.RB [ \-f
-.IR format ]
-.RB [ \-p ]
-.RB [ \-t ]
-.I image
-.RB [ \-u ]
-\fIfile\fP \fIuser\fP\fB:\fP\fIfile\fP
-.br
-.B cpmcp
-.RB [ \-f
-.IR format ]
-.RB [ \-p ]
-.RB [ \-t ]
-.I image
-.RB [ \-u ]
-\fIfile\fP ... \fIuser\fP\fB:\fP
-.ad b
-.\"}}}
-.SH DESCRIPTION \"{{{
-\fBcpmcp\fP copies one or more files to or from a CP/M disk. 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.
-.PP
-You can use \fB*\fP and \fB?\fP in CP/M file names, which have the same
-meaning in
-.IR sh (1)
-file name patterns.
-.PP
-On CP/M, the slash is a legal file name character. When copying such files
-to the host, it is translated to a comma. Filenames with a comma have that
-translated back to a slash on CP/M. That is no restriction, because a comma
-is not a legal CP/M filename character.
-.\"}}}
-.SH OPTIONS \"{{{
-.IP "\fB\-f\fP \fIformat\fP"
-Use the given CP/M disk \fIformat\fP instead of the default format.
-.IP "\fB\-T\fP \fIlibdsk-type\fP"
-libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images
-(requires building cpmtools with support for libdsk).
-.IP \fB\-p\fP
-Preserve time stamps when copying files from CP/M to UNIX (not
-implemented for copying the other way so far).
-.IP \fB\-t\fP
-Convert text files between CP/M and UNIX conventions.
-.IP "\fB\-u\fP"
-Show all CP/M file names in upper case.
-.\"}}}
-.SH "RETURN VALUE" \"{{{
-Upon successful completion, exit code 0 is returned.
-.\"}}}
-.SH ERRORS \"{{{
-Any errors are indicated by exit code 1.
-.\"}}}
-.SH ENVIRONMENT \"{{{
-CPMTOOLSFMT Default format
-.\"}}}
-.SH FILES \"{{{
-${prefix}/share/diskdefs CP/M disk format definitions
-.\"}}}
-.SH AUTHORS \"{{{
-This program is copyright 1997\(en2021 Michael Haardt
-<michael@moria.de>. The Windows port is copyright 2000, 2001, 2011 John Elliott
-<jce@seasip.demon.co.uk>.
-.PP
-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.
-.PP
-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.
-.PP
-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.
-.\"}}}
-.SH "SEE ALSO" \"{{{
-.IR cpmls (1),
-.IR cpm (5)
-.\"}}}
+++ /dev/null
-.TH CPMLS 1 "October 10, 2022" "CP/M tools" "User commands"
-.SH NAME \"{{{roff}}}\"{{{
-cpmls \- list sorted contents of directory
-.\"}}}
-.SH SYNOPSIS \"{{{
-.ad l
-.B cpmls
-.RB [ \-f
-.IR format ]
-.RB [ \-T
-.IR libdsk-type ]
-.RB [ \-d | \-D | \-F | \-A | \-l [ \-c ][ \-i ]]
-.RB [ \-u ]
-.I image
-.RI [ file-pattern "...]"
-.ad b
-.\"}}}
-.SH DESCRIPTION \"{{{
-\fBCpmls\fP lists the sorted contents of the directory.
-.\"}}}
-.SH OPTIONS \"{{{
-.IP "\fB\-f\fP \fIformat\fP"
-Use the given CP/M disk \fIformat\fP instead of the default format.
-.IP "\fB\-T\fP \fIlibdsk-type\fP"
-libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images
-(requires building cpmtools with support for libdsk).
-.IP \fB\-d\fP
-Old CP/M 2.2 dir output.
-.IP \fB\-D\fP
-P2DOS 2.3 ddir-like output.
-.IP \fB\-F\fp
-CP/M 3.x dir output.
-.IP \fB\-A\fp
-E2fs lsattr-like output.
-.IP \fB\-l\fP
-Long UNIX-style directory listing including size, time stamp and user number.
-.IP \fB\-c\fP
-Output the creation time, not the modification time.
-.IP \fB\-i\fP
-Print index number of each file.
-.IP "\fB\-u\fP"
-Show all CP/M file names in upper case.
-.\"}}}
-.SH "RETURN VALUE" \"{{{
-Upon successful completion, exit code 0 is returned.
-.\"}}}
-.SH ERRORS \"{{{
-Any errors are indicated by exit code 1.
-.\"}}}
-.SH ENVIRONMENT \"{{{
-CPMTOOLSFMT Default format
-.\"}}}
-.SH FILES \"{{{
-${prefix}/share/diskdefs CP/M disk format definitions
-.\"}}}
-.SH AUTHORS \"{{{
-This program is copyright 1997\(en2021 Michael Haardt
-<michael@moria.de>. The Windows port is copyright 2000, 2001, 2011 John Elliott
-<jce@seasip.demon.co.uk>.
-.PP
-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.
-.PP
-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.
-.PP
-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.
-.\"}}}
-.SH "SEE ALSO" \"{{{
-.IR cpmcp (1),
-.IR cpm (5)
-.\"}}}
+++ /dev/null
-.TH CPMRM 1 "October 10, 2022" "CP/M tools" "User commands"
-.SH NAME \"{{{roff}}}\"{{{
-cpmrm \- remove files on CP/M disks
-.\"}}}
-.SH SYNOPSIS \"{{{
-.ad l
-.B cpmrm
-.RB [ \-f
-.IR format ]
-.RB [ \-u ]
-.I image
-.I file-pattern
-\&...
-.ad b
-.\"}}}
-.SH DESCRIPTION \"{{{
-\fBcpmrm\fP removes files from CP/M disks.
-.\"}}}
-.SH OPTIONS \"{{{
-.IP "\fB\-f\fP \fIformat\fP"
-Use the given CP/M disk \fIformat\fP instead of the default format.
-.IP "\fB\-T\fP \fIlibdsk-type\fP"
-libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images
-(requires building cpmtools with support for libdsk).
-.IP "\fB\-u\fP"
-Show all CP/M file names in upper case.
-.\"}}}
-.SH "RETURN VALUE" \"{{{
-Upon successful completion, exit code 0 is returned.
-.\"}}}
-.SH ERRORS \"{{{
-Any errors are indicated by exit code 1.
-.\"}}}
-.SH ENVIRONMENT \"{{{
-CPMTOOLSFMT Default format
-.\"}}}
-.SH FILES \"{{{
-${prefix}/share/diskdefs CP/M disk format definitions
-.\"}}}
-.SH AUTHORS \"{{{
-This program is copyright 1997\(en2021 Michael Haardt
-<michael@moria.de>. The Windows port is copyright 2000, 2001, 2011 John Elliott
-<jce@seasip.demon.co.uk>.
-.PP
-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.
-.PP
-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.
-.PP
-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.
-.\"}}}
-.SH "SEE ALSO" \"{{{
-.IR cpmls (1),
-.IR cpm (5)
-.\"}}}
+++ /dev/null
-.\" Believe it or not, reportedly there are nroffs which do not know \(en
-.if n .ds en -
-.if t .ds en \(en
-.TH DISKDEFS 5 "October 10, 2022" "CP/M tools" "File formats"
-.SH NAME \"{{{roff}}}\"{{{
-diskdefs \- CP/M disk and file system format definitions
-.\"}}}
-.SH DESCRIPTION \"{{{
-The diskdefs file contains CP/M format descriptions,
-because CP/M in general does not store those in the file system and there are
-no standards of any kind.
-.PP
-A diskdefs file consists of one or more entries of the format:
-.PP
-.nf
-.RS
-\fBdiskdef\fP \fIname\fP
- \fBseclen\fP \fIsize\fP
- \fBtracks\fP \fIcount\fP
- \fBsectrk\fP \fIcount\fP
- \fBblocksize\fP \fIsize\fP
- \fBmaxdir\fP \fIcount\fP
- [\fBdirblks\fP \fIcount\fP]
- \fBboottrk\fP \fInumber\fP
- [\fBbootsec\fP \fInumber\fP]
- [\fBskew\fP \fInumber\fP]
- [\fBskewtab\fP \fIsector\fP[\fB,\fP\fIsector\fP]...]
- [\fBos\fP \fB2.2\fP|\fB3\fP|\fBisx\fP|\fBp2dos\fP|\fBzsys\fP]
- [\fBoffset\fP \fIsize\fP]
- [\fBlogicalextents\fP \fIcount\fP]
- [\fBlibdsk:format\fP \fIname\fP]
-\fBend\fP
-.RE
-.fi
-.PP
-\fBskew\fP and \fBskewtab\fP must only be used exclusively.
-.PP
-Comments are marked with a leading hash or semicolon and extend to the
-end of the line.
-.PP
-It is possible to reserve space after the directory beyond \fBmaxdir\fP
-using an inflated DPB ALV0. If the format makes use of that,
-\fBdirblks\fP must be set.
-.PP
-\fBbootsec\fP contains the total number of sectors used by the boot area.
-This is for CP/M systems that map multiple logical tracks onto a physical
-track. While raw disk images can be configured for doing the same,
-accessing libdsk images needs to be done by physical tracks.
-.\"}}}
-.SH "SEE ALSO" \"{{{
-.IR cpm (5)
-.\"}}}
+++ /dev/null
-.TH FSCK.CPM 1 "October 10, 2022" "CP/M tools" "User commands"
-.SH NAME ..\"{{{roff}}}\"{{{
-fsck.cpm \- check a CP/M file system
-.\"}}}
-.SH SYNOPSIS .\"{{{
-.ad l
-.B fsck.cpm
-.RB [ \-f
-.IR format ]
-.RB [ \-n ]
-.RB [ \-u ]
-.I image
-.ad b
-.\"}}}
-.SH DESCRIPTION .\"{{{
-\fBfsck.cpm\fP 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).
-.P
-\fBfsck.cpm\fP can not yet repair all errors.
-.\"}}}
-.SH OPTIONS .\"{{{
-.IP "\fB\-f\fP \fIformat\fP"
-Use the given CP/M disk \fIformat\fP instead of the default format.
-.IP "\fB\-T\fP \fIlibdsk-type\fP"
-libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images
-(requires building cpmtools with support for libdsk).
-.IP "\fB\-n\fP"
-Open the file system read-only and do not repair any errors.
-.IP "\fB\-u\fP"
-Show all CP/M file names in upper case.
-.\"}}}
-.SH "RETURN VALUE" .\"{{{
-Upon successful completion, exit code 0 is returned.
-.\"}}}
-.SH ERRORS .\"{{{
-Any errors are indicated by exit code 1.
-.\"}}}
-.SH FILES .\"{{{
-${prefix}/share/diskdefs CP/M disk format definitions
-.\"}}}
-.SH ENVIRONMENT \"{{{
-CPMTOOLSFMT Default format
-.\"}}}
-.SH DIAGNOSTICS .\"{{{
-.IP "\fIimage\fP: \fIused\fP/\fItotal\fP files (\fIn\fP.\fIn\fP% non-contiguos), \fIused\fP/\fItotal\fP 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 greather 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.
-.\"}}}
-.SH AUTHORS .\"{{{
-This program is copyright 1997\(en2021 Michael Haardt
-<michael@moria.de>. The Windows port is copyright 2000, 2001, 2011 John Elliott
-<jce@seasip.demon.co.uk>.
-.PP
-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.
-.PP
-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.
-.PP
-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.
-.\"}}}
-.SH "SEE ALSO" .\"{{{
-.IR fsck (8),
-.IR mkfs.cpm (1),
-.IR cpm (5)
-.\"}}}
+++ /dev/null
-.TH FSED.CPM 1 "October 10, 2022" "CP/M tools" "User commands"
-.SH NAME ..\"{{{roff}}}\"{{{
-fsed.cpm \- edit a CP/M file system
-.\"}}}
-.SH SYNOPSIS .\"{{{
-.ad l
-.B fsed.cpm
-.RB [ \-f
-.IR format ]
-.RB [ \-u ]
-.I image
-.ad b
-.\"}}}
-.SH DESCRIPTION .\"{{{
-\fBfsed.cpm\fP edits a CP/M file system on an image file or device.
-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.
-.\"}}}
-.SH OPTIONS .\"{{{
-.IP "\fB\-f\fP \fIformat\fP"
-Use the given CP/M disk \fIformat\fP instead of the default format.
-.IP "\fB\-T\fP \fIlibdsk-type\fP"
-libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images
-(requires building cpmtools with support for libdsk).
-.IP "\fB\-u\fP"
-Show all CP/M file names in upper case.
-.\"}}}
-.SH "RETURN VALUE" .\"{{{
-Upon successful completion, exit code 0 is returned.
-.\"}}}
-.SH ERRORS .\"{{{
-Any errors are indicated by exit code 1.
-.\"}}}
-.SH ENVIRONMENT \"{{{
-CPMTOOLSFMT Default format
-.\"}}}
-.SH FILES .\"{{{
-${prefix}/share/diskdefs CP/M disk format definitions
-.\"}}}
-.SH AUTHORS \"{{{
-This program is copyright 1997\(en2021 Michael Haardt
-<michael@moria.de>. The Windows port is copyright 2000, 2001, 2011 John Elliott
-<jce@seasip.demon.co.uk>.
-.PP
-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.
-.PP
-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.
-.PP
-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.
-.\"}}}
-.SH "SEE ALSO" .\"{{{
-.IR fsck.cpm (1),
-.IR mkfs.cpm (1),
-.IR cpmls (1),
-.IR cpm (5)
-.\"}}}
+++ /dev/null
-.TH MKFS.CPM 1 "October 10, 2022" "CP/M tools" "User commands"
-.SH NAME \"{{{roff}}}\"{{{
-mkfs.cpm \- make a CP/M file system
-.\"}}}
-.SH SYNOPSIS \"{{{
-.ad l
-.B mkfs.cpm
-.RB [ \-f
-.IR format ]
-.RB [ \-b
-.IR boot ]
-.RB [ \-L
-.IR label ]
-.RB [ \-t ]
-.RB [ \-u ]
-.I image
-.ad b
-.\"}}}
-.SH DESCRIPTION \"{{{
-\fBmkfs.cpm\fP makes a CP/M file system on an image file or device.
-.\"}}}
-.SH OPTIONS \"{{{
-.IP "\fB\-f\fP \fIformat\fP"
-Use the given CP/M disk \fIformat\fP instead of the default format.
-.IP "\fB\-b\fP \fIbootblock\fP"
-Write the contents of the file \fIbootblock\fP 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.
-.IP "\fB\-L\fP \fIlabel\fP"
-Label the file system. This is only supported by CP/M Plus.
-.IP "\fB\-t\fP"
-Create time stamps.
-.IP "\fB\-u\fP"
-Show all CP/M file names in upper case.
-.\"}}}
-.SH "RETURN VALUE" \"{{{
-Upon successful completion, exit code 0 is returned.
-.\"}}}
-.SH ERRORS \"{{{
-Any errors are indicated by exit code 1.
-.\"}}}
-.SH ENVIRONMENT \"{{{
-CPMTOOLSFMT Default format
-.\"}}}
-.SH FILES \"{{{
-${prefix}/share/diskdefs CP/M disk format definitions
-.\"}}}
-.SH AUTHORS \"{{{
-This program is copyright 1997\(en2021 Michael Haardt
-<michael@moria.de>. The Windows port is copyright 2000, 2001, 2011 John Elliott
-<jce@seasip.demon.co.uk>.
-.PP
-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.
-.PP
-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.
-.PP
-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.
-.\"}}}
-.SH "SEE ALSO" \"{{{
-.IR fsck.cpm (1),
-.IR cpmls (1),
-.IR mkfs (1),
-.IR cpm (5)
-.\"}}}
projects / debian / cpmtools / commitdiff