Table of Contents


mcopy - copy MSDOS files to/from Unix


mcopy [ -tnvm ] sourcefile targetfile

mcopy [ -tnvm ] sourcefile [ sourcefiles... ] targetdirectory

mcopy [ -tnvm ] MSDOSsourcefile


Mcopy copies the specified file to the named file, or copies multiple files to the named directory. The source and target can be either MSDOS or Unix files.

The use of a drive letter designation on the MSDOS files, 'a:' for example, determines the direction of the transfer. A missing drive designation implies a Unix file whose path starts in the current directory. If a source drive letter is specified with no attached file name (e.g. "mcopy a: ."), all files are copied from that drive.

If only a single, MSDOS source parameter is provided (e.g. "mcopy a:foo.exe"), an implied destination of the current directory (".") is assumed.

Mcopy will allow the following command line options:

Text file transfer. Mcopy will translate incoming carriage return/line feeds to line feeds.
No warning. Mcopy will not warn the user when overwriting an existing file.
Verbose mode.
Preserve the file modification time.

If the target file already exists, and the -n option is not in effect, mcopy asks whether or not to overwrite the file.

MSDOS subdirectory names are supported with either the '/' or '\' separator. The use of the '\' separator or wildcards will require the names to be enclosed in quotes to protect them from the shell.

The mcd command may be used to establish the device and the current working directory (relative to MSDOS), otherwise the default is A:/.

Mcopy returns 0 on success, 1 on utter failure, or 2 on partial failure.


mcd(1), mread(1), mwrite(1)


Unlike MSDOS, the destination directory may not be omitted.

The '+' operator (append) from MSDOS is not supported.

No other Mtools command requires the use of a drive letter designation on MSDOS files.

Table of Contents