* reordered a little bit
[mascara-docs.git] / i86 / elks / elkscmd / mtools / Mcopy.1
blob12bf88082962e7f7e6795e873dec4415c1c0b510
1 .TH MCOPY 1 local
2 .SH NAME
3 mcopy \- copy MSDOS files to/from Unix
4 .SH SYNOPSIS
5 .B mcopy
7 .B -tnvm
8 ] unixfile a:msdosfile
9 .PP
10 .B mcopy
12 .B -tnvm
13 ] unixfile [ unixfiles... ] a:msdosdirectory
14 .PP
15 .B mcopy
17 .B -tnm
18 ] a:msdosfile unixfile
19 .PP
20 .B mcopy
22 .B -tnm
23 ] a:msdosfile [ a:msdosfiles... ] unixdirectory
24 .SH DESCRIPTION
25 In the first two forms,
26 .I mcopy
27 copies the specified Unix file to the named MSDOS file or copies
28 multiple Unix files to the named MSDOS directory.  The last two forms
29 copy MSDOS files to Unix.  MSDOS sub directories are supported with
30 either the '/' or '\e\' separator.  The use of the '\e\' separator or
31 wildcards will require the names to be enclosed in quotes to protect
32 them from the shell.
33 .PP
34 The use of the 'a:' drive designation on the MSDOS files determines the
35 direction of the transfer.  A missing drive designation implies a Unix
36 file whose path starts in the current directory 
37 .PP
38 .I Mcopy
39 will allow the following command line options:
40 .TP
41 .B t
42 Text file transfer.
43 .I Mcopy
44 will translate incoming carriage return/line feeds to line feeds.
45 .TP
46 .B n
47 No warning.
48 .I Mcopy
49 will not warn the user when overwriting an existing file.
50 .TP
51 .B v
52 verbose mode.
53 .TP
54 .B m
55 Preserve the file modification time.
56 .PP
57 If the target file already exists, and the
58 .I -n
59 option is not in effect,
60 .I mcopy
61 asks whether or not to overwrite the file.
62 .PP
63 The environmental variable MCWD may be used to establish a current
64 working directory (relative to the MSDOS diskette).
65 .SH SEE ALSO
66 mdir(1), mtype(1), mread(1), mwrite(1)
67 .SH BUGS
68 Wildcards are only applied to filenames, not to directory names.
69 Unlike MSDOS, the destination directory may not be omitted.