mcopy(1)						      General Commands Manual							  mcopy(1)

NAME

       mcopy - mtools utility to copy DOS files to and from a UNIX operating system

SYNOPSIS

       mcopy [-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  terminators 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 appropriate format.

       Using a drive letter designation on the DOS files such as 'a:' determines 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 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 conven-
       tions. 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
       -----------------------------------------------

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 cur-
       rent 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 established 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)