mcopy(1)mcopy(1)NAMEmcopy - mtools utility to copy DOS files to and from a UNIX operating
system
SYNOPSISmcopy [-mntv] sourcefile targetfile
mcopy [-mntv] sourcefile [sourcefiles...] targetdirectory
OPTIONS
Preserves the file modification time. Specifies that a warning is not
issued when an existing file is specified as the target file. If this
option is not specified, the mcopy command verifies whether or not to
overwrite an existing file. Specifies a text file transfer. Line ter‐
minators are converted to the appropriate format. Specifies verbose
mode. The new file name is displayed if the name supplied is invalid.
DESCRIPTION
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 appro‐
priate format.
Using a drive letter designation on the DOS files such as 'a:' deter‐
mines the direction of the transfer. A missing drive designation indi‐
cates a UNIX file whose path starts in the current directory.
DOS subdirectory names that contain the '/' or '\' separator are sup‐
ported. 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 com‐
mand may have to change UNIX names to fit the DOS file name conven‐
tions. The following table shows some examples of file name conver‐
sions:
───────────────────────────────────────────────
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
───────────────────────────────────────────────
RESTRICTIONS
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.
EXIT STATUS
The following exit values are returned: Success. Failure.
ENVIRONMENT VARIABLES
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.
FILES
Contains the name of the current mtools working directory as estab‐
lished by the mcd command. If this file does not exist, the default
mtools working directory is A:\. Executable file
SEE ALSO
Commands: dos2unix(1), mcd(1), mdiskcopy(1), mread(1), mtools(1),
mwrite(1), unix2dos(1)mcopy(1)
