New upstream version 2.20
[debian/cpmtools] / mkfs.cpm.1
1 .TH MKFS.CPM 1 "October 25, 2014" "CP/M tools" "User commands"
2 .SH NAME \"{{{roff}}}\"{{{
3 mkfs.cpm \- make a CP/M file system
4 .\"}}}
5 .SH SYNOPSIS \"{{{
6 .ad l
7 .B mkfs.cpm
8 .RB [ \-f
9 .IR format ]
10 .RB [ \-b
11 .IR boot ]
12 .RB [ \-L
13 .IR label ]
14 .RB [ \-t ]
15 .I image
16 .ad b
17 .\"}}}
18 .SH DESCRIPTION \"{{{
19 \fBmkfs.cpm\fP makes a CP/M file system on an image file or device.
20 .\"}}}
21 .SH OPTIONS \"{{{
22 .IP "\fB\-f\fP \fIformat\fP"
23 Use the given CP/M disk \fIformat\fP instead of the default format.
24 .IP "\fB\-b\fP \fIbootblock\fP"
25 Write the contents of the file \fIbootblock\fP to the system tracks
26 instead of filling them with 0xe5.  This option can be used up to four
27 times.  The file contents (typically boot block, CCP, BDOS and BIOS)
28 are written to sequential sectors, padding with 0xe5 if needed.
29 .IP "\fB\-L\fP \fIlabel\fP"
30 Label the file system.  This is only supported by CP/M Plus.
31 .IP "\fB\-t\fP"
32 Create time stamps.
33 .\"}}}
34 .SH "RETURN VALUE" \"{{{
35 Upon successful completion, exit code 0 is returned.
36 .\"}}}
37 .SH ERRORS \"{{{
38 Any errors are indicated by exit code 1.
39 .\"}}}
40 .SH ENVIRONMENT \"{{{
41 CPMTOOLSFMT     Default format
42 .\"}}}
43 .SH FILES \"{{{
44 ${prefix}/share/diskdefs        CP/M disk format definitions
45 .\"}}}
46 .SH AUTHORS \"{{{
47 This program is copyright 1997\(en2012 Michael Haardt
48 <michael@moria.de>.  The Windows port is copyright 2000, 2001, 2011 John Elliott
49 <jce@seasip.demon.co.uk>.
50 .PP
51 This program is free software; you can redistribute it and/or modify
52 it under the terms of the GNU General Public License as published by
53 the Free Software Foundation; either version 3 of the License, or
54 (at your option) any later version.
55 .PP
56 This program is distributed in the hope that it will be useful,
57 but WITHOUT ANY WARRANTY; without even the implied warranty of
58 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
59 GNU General Public License for more details.
60 .PP
61 You should have received a copy of the GNU General Public License along
62 with this program.  If not, write to the Free Software Foundation, Inc.,
63 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
64 .\"}}}
65 .SH "SEE ALSO" \"{{{
66 .IR fsck.cpm (1),
67 .IR cpmls (1),
68 .IR mkfs (1),
69 .IR cpm (5)
70 .\"}}}