doscp(1) doscp(1)
NAME
doscp - copy files between Reliant UNIX and MS-DOS
SYNOPSIS
doscp [-m] [-r] [-l] unixfile a:dospath Format 1
doscp [-m] [-r] [-l] unixfile ... a:dosdirectory Format 2
doscp [-m] [-r] [-l] a:dosfile unixpath Format 3
doscp [-m] [-r] [-l] a:dosfile ... unixdirectory Format 4
DESCRIPTION
doscp copies one or more Reliant UNIX files to an MS-DOS floppy disk,
or one or more MS-DOS files from an MS-DOS floppy to Reliant UNIX.
A distinction is made between the following four formats of the doscp
command:
- copy a Reliant UNIX file to MS-DOS (Format 1)
- copy several Reliant UNIX files to an MS-DOS directory (Format 2)
- copy an MS-DOS file to Reliant UNIX (Format 3)
- copy several MS-DOS files to a Reliant UNIX directory (Format 4)
OPTIONS
No option specified:
The code for line feed in MS-DOS text files is CR-NL; Reliant
UNIX files use NL only. When copying from MS-DOS to Reliant UNIX,
the sequence CR-NL is converted to NL. The DOS end-of-file char-
acter SUB ("1A") is eliminated.
When files are copied from Reliant UNIX to MS-DOS, NL is con-
verted to CR-NL, and the DOS end-of-file character SUB ("1A") is
added.
An MS-DOS text file is converted into a Reliant UNIX text file.
No character conversion is performed on binary files.
Note: To ensure that your requirements regarding character
conversion are met it is advisable to use the -m or -r
option as appropriate.
-m Forces character conversion, which means that the character
conversions described above are also performed for binary files.
-r doscp transfers data "raw", i.e. all characters remain unchanged
(including those in text files).
Page 1 Reliant UNIX 5.44 Printed 11/98
doscp(1) doscp(1)
-l When copying from Reliant UNIX to MS-DOS, the file names are con-
verted to uppercase automatically. When copying files from MS-DOS
to Reliant UNIX, the names remain the same, i.e. in uppercase.
The -l option can be used to convert all uppercase letters in
file names to lowercase when copying from MS-DOS to Reliant UNIX.
unixfile
Name of the Reliant UNIX file.
a:
A: As in DOS conventions, a: or A: designates the disk drive via
which the MS-DOS floppy disk is addressed. This string must be
prepended to each DOS path name. a: or A: addresses the first
floppy disk drive. If a second drive exists, it may be addressed
as b: or B:.
dospath
Path name of the MS-DOS directory on the MS-DOS floppy disk,
indicating the directory to which the Reliant UNIX file is to be
copied. The use of wild cards (*, ?, [ ]) is permitted but the
path name must be unique.
If there is already an MS-DOS file with the same name as the
Reliant UNIX file, dospath can also be used to give the Reliant
UNIX file a different name on the MS-DOS system.
dospath not specified:
doscp copies the Reliant UNIX file to the root directory on the
MS-DOS floppy.
dosdirectory
Name of the MS-DOS directory to which the Reliant UNIX file or
files is/are to be copied. The use of wild cards (*, ?, [ ]) is
permitted but the directory specified must be unique.
dosfile
Name or path name of the MS-DOS file on the MS-DOS floppy. The
use of wild cards (*, ?, [ ]) is permitted.
unixpath
Name of the Reliant UNIX directory or file.
unixdirectory
Name of the Reliant UNIX directory.
Page 2 Reliant UNIX 5.44 Printed 11/98
doscp(1) doscp(1)
Caution: To ensure that you data can be read on a DOS-based system,
special conventions must be observed when selecting MS-DOS
files names. In MS-DOS, file names may consist of a basename
comprising a maximum of 8 characters, optionally followed by
a period and a file name extension (i.e. suffix) of at most
3 characters. If excess characters are specified for the
basename and the extension, they are truncated to 8 and 3
characters respectively. Some extensions have special mean-
ings in DOS. Unlike Reliant UNIX, MS-DOS does not allow the
use of all special characters. Appropriate error messages
are issued in the event of errors. DOS does not distinguish
between uppercase and lowercase letters in file names. Thus,
if you specify names in lowercase, they will be converted to
uppercase on the disk and will appear in uppercase the next
time the floppy is read.
LOCALE
The LCMESSAGES environment variable governs the language in which
message texts are displayed. If LCMESSAGES is undefined or is defined
as the null string, it defaults to the value of LANG. If LANG is like-
wise undefined or null, the system acts as if it were not internation-
alized.
The LCALL environment variable governs the entire locale. LCALL
takes precedence over all the other environment variables which affect
internationalization.
EXAMPLES
Example 1
You want to copy the Reliant UNIX file schedule to the directory
user/jones on an MS-DOS floppy disk.
$ doscp schedule a:user/jones
Example 2
You want to copy the Reliant UNIX file schedule to an MS-DOS floppy
disk and simultaneously rename it to april.
$ doscp schedule a:april
Example 3
You want to copy all Reliant UNIX files that have names beginning with
max to an MS-DOS floppy disk.
$ doscp max* a:
Page 3 Reliant UNIX 5.44 Printed 11/98
doscp(1) doscp(1)
You can use the dosdir(1) or dosls(1) command to verify that the files
are actually on the MS-DOS floppy.
$ dosdir a:
MAX 1 712 1-20-86 5:09p
MAX 2 8075 1-20-86 5:09p
MAX 3 18727 1-20-86 5:09p
MAX 4 3417 1-20-86 5:10p
Example 4
You want to copy the MS-DOS file BOOKS to the Reliant UNIX directory
/usr/guest and rename it to library.
$ doscp a:BOOKS library
Example 5
You want to copy the files GAMES/WORM and USER/APRIL from the MS-DOS
floppy to your current Reliant UNIX directory.
$ doscp a:games/worm a:user/april .
Example 6
You want to copy the MS-DOS files SCHULTZ/CHARLIE and SCHULTZ/SNOOPY
and the files GRIMM/HANSEL and GRIMM/GRETEL to the Reliant UNIX direc-
tory usr/john/tales.
$ doscp a:schultz/charlie a:schultz/snoopy a:grimm/hansel a:grimm/gretel
/usr/john/tales
NOTES
If a directory contains more than 254 file names, the doscp command
may produce the error message "Error - too many filenames". In this
case, the user must limit the number of file names involved (for exam-
ple by not using "*.*").
SEE ALSO
dosdir(1), dosls(1).
Page 4 Reliant UNIX 5.44 Printed 11/98