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  MS-DOS  to
46              Unix, and vice-versa when copying from Unix to MS-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.  ASCII translates incoming carriage
59              return/line feeds to line feeds.
60
61       T      Text (ASCII) file transfer with character set conversion.   Dif‐
62              fers  from -a in the ASCII also translates incoming PC-8 charac‐
63              ters to ISO-8859-1 equivalents as far as possible.  When reading
64              DOS  files,  untranslatable characters are replaced by '#'; when
65              writing DOS files, untranslatable  characters  are  replaced  by
66              '.'.
67
68       n      No confirmation when overwriting Unix files.  ASCII doesn't warn
69              the user when overwriting an existing Unix file. If  the  target
70              file  already  exists, and the -n option is not in effect, mcopy
71              asks whether to overwrite the file or to  rename  the  new  file
72              (`name clashes') for details).  In order to switch off confirma‐
73              tion for DOS files, use -o.
74
75       m      Preserve the file modification time.
76
77       v      Verbose. Displays the name of each file as it is copied.
78

Bugs

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

See Also

89       Mtools' texinfo doc
90

Viewing the texi doc

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