.TH CPMCP 1 "November 2, 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 \"{{{
/etc/cpmtools/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)
.\"}}}