1mcopy(1)                    General Commands Manual                   mcopy(1)
2
3
4

Name

6       mcopy - copy MSDOS files to/from Unix
7
8
9

Note of warning

11       This  manpage  has  been  automatically generated from mtools's texinfo
12       documentation, and may not be entirely accurate or complete.   See  the
13       end of this man page for details.
14

Description

16       The  mcopy  command  is  used to copy MS-DOS files to and from Unix. It
17       uses the following syntax:
18
19          mcopy [-bspanvmQT] [-D clash_option] sourcefile targetfile
20          mcopy [-bspanvmQT] [-D clash_option] sourcefile [ sourcefiles... ] targetdirectory
21          mcopy [-tnvm] MSDOSsourcefile
22
23
24
25       Mcopy copies the specified file to the named file, or  copies  multiple
26       files  to the named directory.  The source and target can be either MS-
27       DOS or Unix files.
28
29       The use of a drive letter designation on the  MS-DOS  files,  'a:'  for
30       example,  determines  the  direction  of the transfer.  A missing drive
31       designation implies a Unix file whose path starts in the current direc‐
32       tory.  If a source drive letter is specified with no attached file name
33       (e.g. mcopy a: .), all files are copied from that drive.
34
35       If only a single, MS-DOS source  parameter  is  provided  (e.g.  "mcopy
36       a:foo.exe"),  an  implied destination of the current directory (`.') is
37       assumed.
38
39       A filename of `-' means standard input or standard output, depending on
40       its position on the command line.
41
42       Mcopy accepts the following command line options:
43
44       t      Text   file   transfer.    Mcopy  translates  incoming  carriage
45              return/line feeds to line feeds when copying from Dos  to  Unix,
46              and vice-versa when copying from Unix to Dos.
47
48       b      Batch mode. Optimized for huge recursive copies, but less secure
49              if a crash happens during the copy.
50
51       s      Recursive copy.  Also copies directories and their contents
52
53       p      Preserves the attributes of the copied files
54
55       Q      When mcopying multiple files, quits as soon as  one  copy  fails
56              (for example due to lacking storage space on the target disk)
57
58       a      Text  (Ascii) file transfer.  Mcopy translates incoming carriage
59              return/line feeds to line feeds.
60
61       T      Text (Ascii) file transfer  with  charset  conversion.   Differs
62              from -a in the Mcopy also translates incoming PC-8 characters to
63              ISO-8859-1 equivalents as far as  possible.   When  reading  DOS
64              files, untranslatable characters are replaced by '#'; when writ‐
65              ing DOS files, untranslatable characters are replaced by '.'.
66
67       n      No confirmation when overwriting Unix files.  Mcopy doesn't warn
68              the  user  when overwriting an existing Unix file. If the target
69              file already exists, and the -n option is not in  effect,  mcopy
70              asks  whether  to  overwrite  the file or to rename the new file
71              (`name clashes') for details).  In order to switch off confirma‐
72              tion for DOS files, use -o.
73
74       m      Preserve the file modification time.
75
76       v      Verbose. Displays the name of each file as it is copied.
77

Bugs

79       Unlike  MS-DOS, the '+' operator (append) from MS-DOS is not supported.
80       However, you may use mtype to produce the same effect:
81
82          mtype a:file1 a:file2 a:file3 >unixfile
83          mtype a:file1 a:file2 a:file3 | mcopy - a:msdosfile
84
85
86

See Also

88       Mtools' texinfo doc
89

Viewing the texi doc

91       This manpage has been automatically  generated  from  mtools's  texinfo
92       documentation.  However,  this  process is only approximative, and some
93       items, such as crossreferences, footnotes and indices are lost in  this
94       translation process.  Indeed, these items have no appropriate represen‐
95       tation in the manpage format.  Moreover, not all information  has  been
96       translated into the manpage version.  Thus I strongly advise you to use
97       the original texinfo doc.  See the end of this manpage for instructions
98       how to view the texinfo doc.
99
100       *      To  generate a printable copy from the texinfo doc, run the fol‐
101              lowing commands:
102
103                     ./configure; make dvi; dvips mtools.dvi
104
105
106
107       *      To generate a html copy,  run:
108
109                     ./configure; make html
110
111              A  premade  html  can  be  found  at   `http://www.gnu.org/soft‐
112              ware/mtools/manual/mtools.html'
113
114       *      To  generate  an  info  copy (browsable using emacs' info mode),
115              run:
116
117                     ./configure; make info
118
119
120
121       The texinfo doc looks most pretty when printed or as html.  Indeed,  in
122       the  info  version  certain  examples  are difficult to read due to the
123       quoting conventions used in info.
124
125mtools-4.0.12                       03Nov09                           mcopy(1)