From 5c7f0b25971fa492f0133b6b00818f63dd68f5ae Mon Sep 17 00:00:00 2001 From: Bdale Garbee Date: Wed, 28 Feb 2024 21:10:50 -0700 Subject: [PATCH] remove processed man pages from the repo since they get regenerated every time anyway --- cpm.5 | 315 ---------------------------------------------------- cpmchattr.1 | 95 ---------------- cpmchmod.1 | 66 ----------- cpmcp.1 | 109 ------------------ cpmls.1 | 78 ------------- cpmrm.1 | 62 ----------- diskdefs.5 | 52 --------- fsck.cpm.1 | 83 -------------- fsed.cpm.1 | 65 ----------- mkfs.cpm.1 | 73 ------------ 10 files changed, 998 deletions(-) delete mode 100644 cpm.5 delete mode 100644 cpmchattr.1 delete mode 100644 cpmchmod.1 delete mode 100644 cpmcp.1 delete mode 100644 cpmls.1 delete mode 100644 cpmrm.1 delete mode 100644 diskdefs.5 delete mode 100644 fsck.cpm.1 delete mode 100644 fsed.cpm.1 delete mode 100644 mkfs.cpm.1 diff --git a/cpm.5 b/cpm.5 deleted file mode 100644 index 4b14493..0000000 --- a/cpm.5 +++ /dev/null @@ -1,315 +0,0 @@ -.\" 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) -.\"}}} diff --git a/cpmchattr.1 b/cpmchattr.1 deleted file mode 100644 index 909b728..0000000 --- a/cpmchattr.1 +++ /dev/null @@ -1,95 +0,0 @@ -.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 - and copyright 2000, 2001, 2011 John Elliott -. -.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) -.\"}}} diff --git a/cpmchmod.1 b/cpmchmod.1 deleted file mode 100644 index 5481e45..0000000 --- a/cpmchmod.1 +++ /dev/null @@ -1,66 +0,0 @@ -.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 - and copyright 2000, 2001, 2011 John Elliott -. -.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) -.\"}}} diff --git a/cpmcp.1 b/cpmcp.1 deleted file mode 100644 index 87d0eb7..0000000 --- a/cpmcp.1 +++ /dev/null @@ -1,109 +0,0 @@ -.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 -. The Windows port is copyright 2000, 2001, 2011 John Elliott -. -.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) -.\"}}} diff --git a/cpmls.1 b/cpmls.1 deleted file mode 100644 index eb840ee..0000000 --- a/cpmls.1 +++ /dev/null @@ -1,78 +0,0 @@ -.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 -. The Windows port is copyright 2000, 2001, 2011 John Elliott -. -.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) -.\"}}} diff --git a/cpmrm.1 b/cpmrm.1 deleted file mode 100644 index 10e99f3..0000000 --- a/cpmrm.1 +++ /dev/null @@ -1,62 +0,0 @@ -.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 -. The Windows port is copyright 2000, 2001, 2011 John Elliott -. -.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) -.\"}}} diff --git a/diskdefs.5 b/diskdefs.5 deleted file mode 100644 index 43ad10e..0000000 --- a/diskdefs.5 +++ /dev/null @@ -1,52 +0,0 @@ -.\" 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) -.\"}}} diff --git a/fsck.cpm.1 b/fsck.cpm.1 deleted file mode 100644 index e88269a..0000000 --- a/fsck.cpm.1 +++ /dev/null @@ -1,83 +0,0 @@ -.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 -. The Windows port is copyright 2000, 2001, 2011 John Elliott -. -.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) -.\"}}} diff --git a/fsed.cpm.1 b/fsed.cpm.1 deleted file mode 100644 index 0c70d0c..0000000 --- a/fsed.cpm.1 +++ /dev/null @@ -1,65 +0,0 @@ -.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 -. The Windows port is copyright 2000, 2001, 2011 John Elliott -. -.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) -.\"}}} diff --git a/mkfs.cpm.1 b/mkfs.cpm.1 deleted file mode 100644 index 55f0596..0000000 --- a/mkfs.cpm.1 +++ /dev/null @@ -1,73 +0,0 @@ -.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 -. The Windows port is copyright 2000, 2001, 2011 John Elliott -. -.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) -.\"}}} -- 2.30.2