annotate docs/nitros9guide/copy.refentry @ 321:2c0ddf807efa

Made some changes
author boisy
date Tue, 23 Jul 2002 23:43:29 +0000
parents 52af9581ef1e
children c565a4700689
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="copy">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname>COPY</refname>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Copy data from one path to another</refpurpose>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
6
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
9 <command>COPY</command>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="plain">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
11 &replstart;path&replend;
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
13 <arg choice="plain">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
14 &replstart;path&replend;
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
15 </arg>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
16 <arg choice="opt">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
17 <option>-s</option>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
18 </arg>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
19 </cmdsynopsis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
20 </refsynopsisdiv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
21
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
22 <refsect1><title>Description</title>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
23 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
24 This command copies data from the first file or device specified to
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
25 the second. The first file or device must already exist, the
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
26 second file is automatically created if the second path is a file on
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
27 a mass storage device. Data may be of any type and is NOT modified
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
28 in any way as it is copied.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
29 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
30 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
31 Data is transferred using large block reads and writes until end-of-file
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
32 occurs on the input path. Because block transfers are used,
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
33 normal output processing of data does not occur on character-oriented
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
34 devices such as terminals, printers, etc. Therefore, the
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
35 LIST command is preferred over COPY when a file consisting of text
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
36 is to be sent to a terminal or printer.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
37 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
38 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
39 The &quot;-s&quot; option causes COPY to perform a single drive copy
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
40 operation. The second pathlist must be a full pathlist if &quot;-s
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
41 appears. COPY will read a portion of the source disk into memory,
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
42 you remove the source disk and place the destination disk into the
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
43 drive, enter a &quot;C&quot; whereupon COPY writes on the destination disk,
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
44 this process continues until the entire file is copied.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
45 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
46 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
47 Using the shell's alternate memory size modifier to give a large
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
48 memory space will increase speed and reduce the number of media
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
49 exchanges required for single drive copies.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
50 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
51 </refsect1>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
52 <refsect1><title>Examples</title>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
53 <screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
54 copy file1 file2 #15k (copies file1 to file2)
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
55
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
56 copy /D1/joe/news /D0/peter/messages
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
57
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
58 copy /TERM /P (copies console to printer)
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
59
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
60 copy /d0/cat /d0/animals/cat -s #32k
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
61 Ready DESTINATION, hit C to continue: c
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
62 Ready SOURCE, hit C to continue: c
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
63 Ready DESTINATION, hit C to continue:c
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
64 </screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
65 </refsect1>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
66 </refentry>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
67