Content-type: text/html Man page of mcopy

mcopy

Section: User Commands (1)
Index Return to Main Contents
 

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 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 nameDOS nameReason for the change

thisisatestTHISISATfile name too long
file.stuffFILE.STUextension too long
prn.txtXRN.TXTPRN is a device name
.abcX.ABCnull file name
hot+coldHOTXCOLDillegal 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 established by the mcd command. If this file does not exist, the default mtools working directory is A:\. Executable file
 

SEE ALSO

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


 

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
RESTRICTIONS
EXIT STATUS
ENVIRONMENT VARIABLES
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:43:05 GMT, October 02, 2010