Click this button to go to the index for this section.

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

FLAGS
  -m  Preserves the file modification time.

  -n  Specifies that a warning is not issued when an existing file is
      specified as the target file.  If this flag 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
      appropriate format.

  -v  Specifies verbose mode.  The new filename 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 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 filenames 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 filenames are supported in the DOS world.  The mcopy command
  may have to change UNIX names to fit the DOS filename conventions.  The
  following table shows some examples of filename conversions:

  ______________________________________________
  UNIX name	DOS name   Reason for the change
  ______________________________________________
  ______________________________________________
  thisisatest	THISISAT   filename too long
  file.stuff	FILE.STU   extension too long
  prn.txt	XRN.TXT	   PRN is a device name
  .abc		X.ABC	   null filename
  hot+cold	HOTXCOLD   illegal character
  ______________________________________________

ENVIRONMENT VARIABLES
  The following environment variables affect the execution of mcopy:

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

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 VALUES
  The following exit values are returned:

  0   Success

  1   failure

FILES
  $HOME/.mcwd  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:\.

  /usr/bin/mtools/mcopy
	       Executable file

RELATED INFORMATION
  Commands: mcd(1), mread(1), mtools(1), mwrite(1)