NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       mcopy [-mntv] sourcefile targetfile

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

OPTIONS    [Toc]    [Back]

       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    [Toc]    [Back]

       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 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
       -----------------------------------------------

RESTRICTIONS    [Toc]    [Back]

       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    [Toc]    [Back]

       The following exit values are returned: Success.  Failure.

ENVIRONMENT VARIABLES    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Commands:  dos2unix(1),  mcd(1),  mdiskcopy(1),  mread(1),
       mtools(1), mwrite(1), unix2dos(1)



                                                         mcopy(1)