mcopy - mtools utility to copy DOS files to and from a UNIX operating sys-
mcopy [-mntv] sourcefile targetfile
mcopy [-mntv] sourcefile [sourcefiles...] targetdirectory
-m Preserves the file modification time.
-n Specifies that a warning is not issued when an existing file is speci-
fied as the target file. If this option is not specified, the mcopy
command verifies whether or not to overwrite an existing file.
-t Specifies a text file transfer. Line terminators are converted to the
-v Specifies verbose mode. The new file name is displayed if the name
supplied is invalid.
The mcopy command copies the specified file to the named file, or copies
multiple files to the named directory. The specified files or directories
can be either DOS or UNIX files.
If the file is a text file line terminators are converted to the appropri-
Using a drive letter designation on the DOS files such as 'a:' determines
the direction of the transfer. A missing drive designation indicates a
UNIX file whose path starts in the current directory.
DOS subdirectory names that contain the '/' or '\' separator are supported.
If you use the '\' separator or wildcards, you must enclose file names in
quotes to protect them from the shell.
The mcd command can be used to establish the device and the current working
directory (relative to DOS), otherwise the default is A:\.
Not all UNIX file names are supported in the DOS world. The mcopy command
may have to change UNIX names to fit the DOS file name conventions. The
following table shows some examples of file name conversions:
UNIX name DOS name Reason for the change
thisisatest THISISAT file name too long
file.stuff FILE.STU extension too long
prn.txt XRN.TXT PRN is a device name
.abc X.ABC null file name
hot+cold HOTXCOLD illegal character
The following restrictions exist:
+ Omitting the destination directory is not supported.
+ Using the plus (+) operator is not supported.
+ Using a drive letter designation on DOS files is required with this
command only, not with other mtools.
The following exit values are returned:
The following environment variables affect the execution of mcopy:
If set, this variable names the file that contains the name of the
current mtools working directory as established by the mcd command. If
this variable is not set, the file $HOME/.mcwd is used.
Contains the name of the current mtools working directory as esta-
blished by the mcd command. If this file does not exist, the default
mtools working directory is A:\.
Commands: dos2unix(1), mcd(1), mdiskcopy(1), mread(1), mtools(1),