Imported Upstream version 2.17
[debian/cpmtools] / cpmcp.1.in
1 .TH CPMCP 1 "@UPDATED@" "CP/M tools" "User commands"
2 .SH NAME \"{{{roff}}}\"{{{
3 cpmcp \- copy files from and to CP/M disks
4 .\"}}}
5 .SH SYNOPSIS \"{{{
6 .ad l
7 .B cpmcp
8 .RB [ \-f
9 .IR format ]
10 .RB [ \-p ]
11 .RB [ \-t ]
12 .I image
13 \fIuser\fP\fB:\fP\fIfile\fP \fIfile\fP
14 .br
15 .B cpmcp
16 .RB [ \-f
17 .IR format ]
18 .RB [ \-p ]
19 .RB [ \-t ]
20 .I image
21 \fIuser\fP\fB:\fP\fIfile\fP ... \fIdirectory\fP
22 .br
23 .B cpmcp
24 .RB [ \-f
25 .IR format ]
26 .RB [ \-p ]
27 .RB [ \-t ]
28 .I image
29 \fIfile\fP \fIuser\fP\fB:\fP\fIfile\fP
30 .br
31 .B cpmcp
32 .RB [ \-f
33 .IR format ]
34 .RB [ \-p ]
35 .RB [ \-t ]
36 .I image
37 \fIfile\fP ... \fIuser\fP\fB:\fP
38 .ad b
39 .\"}}}
40 .SH DESCRIPTION \"{{{
41 \fBcpmcp\fP copies one or more files to or from a CP/M disk.  When copying
42 multiple files, the last argument must be a drive or directory.  The drive
43 letter does not matter because the device is specified by the image, it is
44 only used to specify which direction you want to copy.  The user number is
45 specified after the drive letter, if omitted user 0 is used.
46 .PP
47 You can use \fB*\fP and \fB?\fP in CP/M file names, which have the same
48 meaning in
49 .IR sh (1)
50 file name patterns.
51 .\"}}}
52 .SH OPTIONS \"{{{
53 .IP "\fB\-f\fP \fIformat\fP"
54 Use the given CP/M disk \fIformat\fP instead of the default format.
55 .IP \fB\-p\fP
56 Preserve time stamps when copying files from CP/M to UNIX (not
57 implemented for copying the other way so far).
58 .IP \fB\-t\fP
59 Convert text files between CP/M and UNIX conventions.
60 .\"}}}
61 .SH "RETURN VALUE" \"{{{
62 Upon successful completion, exit code 0 is returned.
63 .\"}}}
64 .SH ERRORS \"{{{
65 Any errors are indicated by exit code 1.
66 .\"}}}
67 .SH ENVIRONMENT \"{{{
68 CPMTOOLSFMT     Default format
69 .\"}}}
70 .SH FILES \"{{{
71 @DATADIR@/diskdefs      CP/M disk format definitions
72 .\"}}}
73 .SH AUTHORS \"{{{
74 This program is copyright 1997\(en2012 Michael Haardt
75 <michael@moria.de>.  The Windows port is copyright 2000, 2001, 2011 John Elliott
76 <jce@seasip.demon.co.uk>.
77 .PP
78 This program is free software; you can redistribute it and/or modify
79 it under the terms of the GNU General Public License as published by
80 the Free Software Foundation; either version 3 of the License, or
81 (at your option) any later version.
82 .PP
83 This program is distributed in the hope that it will be useful,
84 but WITHOUT ANY WARRANTY; without even the implied warranty of
85 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
86 GNU General Public License for more details.
87 .PP
88 You should have received a copy of the GNU General Public License along
89 with this program.  If not, write to the Free Software Foundation, Inc.,
90 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
91 .\"}}}
92 .SH "SEE ALSO" \"{{{
93 .IR cpmls (1),
94 .IR cpm (5)
95 .\"}}}