unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



mcopy(1)							     mcopy(1)



NAME

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

SYNOPSIS

  mcopy	[-mntv]	sourcefile targetfile

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

OPTIONS

  -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
      appropriate format.

  -v  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 appropri-
  ate 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

  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:

  0   Success.

  1   Failure.

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.

FILES

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

  /usr/bin/mtools/mcopy
      Executable file

SEE ALSO

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