git.gag.com Git - debian/cpmtools/blob - cpmcp.1

   1 .TH CPMCP 1 "October 10, 2022" "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 .RB [ \-u ]
  14 \fIuser\fP\fB:\fP\fIfile\fP \fIfile\fP
  15 .br
  16 .B cpmcp
  17 .RB [ \-f
  18 .IR format ]
  19 .RB [ \-p ]
  20 .RB [ \-t ]
  21 .I image
  22 .RB [ \-u ]
  23 \fIuser\fP\fB:\fP\fIfile\fP ... \fIdirectory\fP
  24 .br
  25 .B cpmcp
  26 .RB [ \-f
  27 .IR format ]
  28 .RB [ \-p ]
  29 .RB [ \-t ]
  30 .I image
  31 .RB [ \-u ]
  32 \fIfile\fP \fIuser\fP\fB:\fP\fIfile\fP
  33 .br
  34 .B cpmcp
  35 .RB [ \-f
  36 .IR format ]
  37 .RB [ \-p ]
  38 .RB [ \-t ]
  39 .I image
  40 .RB [ \-u ]
  41 \fIfile\fP ... \fIuser\fP\fB:\fP
  42 .ad b
  43 .\"}}}
  44 .SH DESCRIPTION \"{{{
  45 \fBcpmcp\fP copies one or more files to or from a CP/M disk.  When copying
  46 multiple files, the last argument must be a drive or directory.  The drive
  47 letter does not matter because the device is specified by the image, it is
  48 only used to specify which direction you want to copy.  The user number is
  49 specified after the drive letter, if omitted user 0 is used.
  50 .PP
  51 You can use \fB*\fP and \fB?\fP in CP/M file names, which have the same
  52 meaning in
  53 .IR sh (1)
  54 file name patterns.
  55 .PP
  56 On CP/M, the slash is a legal file name character.  When copying such files
  57 to the host, it is translated to a comma.  Filenames with a comma have that
  58 translated back to a slash on CP/M.  That is no restriction, because a comma
  59 is not a legal CP/M filename character.
  60 .\"}}}
  61 .SH OPTIONS \"{{{
  62 .IP "\fB\-f\fP \fIformat\fP"
  63 Use the given CP/M disk \fIformat\fP instead of the default format.
  64 .IP "\fB\-T\fP \fIlibdsk-type\fP"
  65 libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images
  66 (requires building cpmtools with support for libdsk).
  67 .IP \fB\-p\fP
  68 Preserve time stamps when copying files from CP/M to UNIX (not
  69 implemented for copying the other way so far).
  70 .IP \fB\-t\fP
  71 Convert text files between CP/M and UNIX conventions.
  72 .IP "\fB\-u\fP"
  73 Show all CP/M file names in upper case.
  74 .\"}}}
  75 .SH "RETURN VALUE" \"{{{
  76 Upon successful completion, exit code 0 is returned.
  77 .\"}}}
  78 .SH ERRORS \"{{{
  79 Any errors are indicated by exit code 1.
  80 .\"}}}
  81 .SH ENVIRONMENT \"{{{
  82 CPMTOOLSFMT     Default format
  83 .\"}}}
  84 .SH FILES \"{{{
  85 ${prefix}/share/diskdefs        CP/M disk format definitions
  86 .\"}}}
  87 .SH AUTHORS \"{{{
  88 This program is copyright 1997\(en2021 Michael Haardt
  89 <michael@moria.de>.  The Windows port is copyright 2000, 2001, 2011 John Elliott
  90 <jce@seasip.demon.co.uk>.
  91 .PP
  92 This program is free software; you can redistribute it and/or modify
  93 it under the terms of the GNU General Public License as published by
  94 the Free Software Foundation; either version 3 of the License, or
  95 (at your option) any later version.
  96 .PP
  97 This program is distributed in the hope that it will be useful,
  98 but WITHOUT ANY WARRANTY; without even the implied warranty of
  99 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 100 GNU General Public License for more details.
 101 .PP
 102 You should have received a copy of the GNU General Public License along
 103 with this program.  If not, write to the Free Software Foundation, Inc.,
 104 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 105 .\"}}}
 106 .SH "SEE ALSO" \"{{{
 107 .IR cpmls (1),
 108 .IR cpm (5)
 109 .\"}}}