Mercurial > hg > Members > kono > nitros9-code

annotate docs/nitros9guide/copy.refentry @ 1053:b5ff125a1d60

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Since this book was only typeset in fixed width, single-font, they used capitalization and quotes (") to show what was commands, files and just text. With today's formatting, this is not necessary, so everywhere capitalization was used to show a command the <command> element is now used instead, and everywhere a file is mentioned the <filename> element is used.
author roug
date Thu, 20 Mar 2003 20:19:53 +0000
parents 15a1a20b70ab
children 4dae346c4969
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">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 134
diff changeset
11 <replaceable>path</replaceable>
134
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">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 134
diff changeset
14 <replaceable>path</replaceable>
134
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
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 1013
diff changeset
35 <command>list</command> command is preferred over <command>copy</command> when a file consisting of text
134
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>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 1013
diff changeset
39 The &quot;-s&quot; option causes <command>copy</command> to perform a single drive copy
134
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
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 1013
diff changeset
41 appears. <command>Copy</command> will read a portion of the source disk into memory,
134
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
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 1013
diff changeset
43 drive, enter a &quot;C&quot; whereupon <command>copy</command> writes on the destination disk,
134
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
1013
15a1a20b70ab More changes
boisy
parents: 975
diff changeset
56 copy /d1/joe/news /D0/peter/messages
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
57
1013
15a1a20b70ab More changes
boisy
parents: 975
diff changeset
58 copy /term /p (copies console to printer)
134
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