mcopy(1) [osf1 man page]
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)
Check Out this Related Man Page
mcopy(1) General Commands Manual mcopy(1) Name mcopy - copy MSDOS files to/from Unix Note of warning This manpage has been automatically generated from mtools's texinfo documentation, and may not be entirely accurate or complete. See the end of this man page for details. Description The mcopy command is used to copy MS-DOS files to and from Unix. It uses the following syntax: mcopy [-bspanvmQT] [-D clash_option] sourcefile targetfile mcopy [-bspanvmQT] [-D clash_option] sourcefile [ sourcefiles... ] targetdirectory mcopy [-tnvm] MSDOSsourcefile Mcopy copies the specified file to the named file, or copies multiple files to the named directory. The source and target can be either MS-DOS or Unix files. The use of a drive letter designation on the MS-DOS files, 'a:' for example, determines the direction of the transfer. A missing drive designation implies a Unix file whose path starts in the current directory. If a source drive letter is specified with no attached file name (e.g. mcopy a: .), all files are copied from that drive. If only a single, MS-DOS source parameter is provided (e.g. "mcopy a:foo.exe"), an implied destination of the current directory (`.') is assumed. A filename of `-' means standard input or standard output, depending on its position on the command line. Mcopy accepts the following command line options: t Text file transfer. Mcopy translates incoming carriage return/line feeds to line feeds when copying from MS-DOS to Unix, and vice- versa when copying from Unix to MS-DOS. b Batch mode. Optimized for huge recursive copies, but less secure if a crash happens during the copy. s Recursive copy. Also copies directories and their contents p Preserves the attributes of the copied files Q When mcopying multiple files, quits as soon as one copy fails (for example due to lacking storage space on the target disk) a Text (ASCII) file transfer. ASCII translates incoming carriage return/line feeds to line feeds. T Text (ASCII) file transfer with character set conversion. Differs from -a in the ASCII also translates incoming PC-8 characters to ISO-8859-1 equivalents as far as possible. When reading DOS files, untranslatable characters are replaced by '#'; when writing DOS files, untranslatable characters are replaced by '.'. n No confirmation when overwriting Unix files. ASCII doesn't warn the user when overwriting an existing Unix file. If the target file already exists, and the -n option is not in effect, mcopy asks whether to overwrite the file or to rename the new file (`name clashes') for details). In order to switch off confirmation for DOS files, use -o. m Preserve the file modification time. v Verbose. Displays the name of each file as it is copied. Bugs Unlike MS-DOS, the '+' operator (append) from MS-DOS is not supported. However, you may use mtype to produce the same effect: mtype a:file1 a:file2 a:file3 >unixfile mtype a:file1 a:file2 a:file3 | mcopy - a:msdosfile See Also Mtools' texinfo doc Viewing the texi doc This manpage has been automatically generated from mtools's texinfo documentation. However, this process is only approximative, and some items, such as crossreferences, footnotes and indices are lost in this translation process. Indeed, these items have no appropriate repre- sentation in the manpage format. Moreover, not all information has been translated into the manpage version. Thus I strongly advise you to use the original texinfo doc. See the end of this manpage for instructions how to view the texinfo doc. * To generate a printable copy from the texinfo doc, run the following commands: ./configure; make dvi; dvips mtools.dvi * To generate a html copy, run: ./configure; make html A premade html can be found at `http://www.gnu.org/software/mtools/manual/mtools.html' * To generate an info copy (browsable using emacs' info mode), run: ./configure; make info The texinfo doc looks most pretty when printed or as html. Indeed, in the info version certain examples are difficult to read due to the quoting conventions used in info. mtools-4.0.13 28Feb10 mcopy(1)