From: Bdale Garbee Date: Thu, 29 Feb 2024 04:10:50 +0000 (-0700) Subject: remove processed man pages from the repo since they get regenerated every time anyway X-Git-Tag: debian/2.23-5~3 X-Git-Url: https://git.gag.com/?p=debian%2Fcpmtools;a=commitdiff_plain;h=5c7f0b25971fa492f0133b6b00818f63dd68f5ae remove processed man pages from the repo since they get regenerated every time anyway --- 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) -.\"}}}