Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/copy.refentry @ 1892:77d83b367eba
reduced labeltab size so os9boot would link
| author | robert |
|---|---|
| date | Fri, 14 Oct 2005 01:56:25 +0000 |
| parents | b00cf13c9f61 |
| children |
| rev | line source |
|---|---|
| 134 | 1 <refentry id="copy"> |
| 2 <refnamediv> | |
| 3 <refname>COPY</refname> | |
| 4 <refpurpose>Copy data from one path to another</refpurpose> | |
| 5 </refnamediv> | |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 9 <command>copy</command> |
| 134 | 10 <arg choice="plain"> |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
134
diff
changeset
|
11 <replaceable>path</replaceable> |
| 134 | 12 </arg> |
| 13 <arg choice="plain"> | |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
134
diff
changeset
|
14 <replaceable>path</replaceable> |
| 134 | 15 </arg> |
| 16 <arg choice="opt"> | |
| 1500 | 17 <option>-a -p -r -s -w=<dir> -x</option> |
| 134 | 18 </arg> |
| 19 </cmdsynopsis> | |
| 20 </refsynopsisdiv> | |
| 21 | |
| 22 <refsect1><title>Description</title> | |
| 23 <para> | |
| 24 This command copies data from the first file or device specified to | |
| 25 the second. The first file or device must already exist, the | |
| 26 second file is automatically created if the second path is a file on | |
| 27 a mass storage device. Data may be of any type and is NOT modified | |
| 28 in any way as it is copied. | |
| 29 </para> | |
| 30 <para> | |
| 31 Data is transferred using large block reads and writes until end-of-file | |
| 32 occurs on the input path. Because block transfers are used, | |
| 33 normal output processing of data does not occur on character-oriented | |
| 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 | 36 is to be sent to a terminal or printer. |
| 37 </para> | |
| 38 <para> | |
| 1500 | 39 The "-a" option will force <command>copy</command> to abort its operation if it receives an error during the copy of a file. If this option is not specified, copy will continue to attempt to copy any other files specified on its command line. |
| 40 </para> | |
| 41 <para> | |
| 42 The "-p" option prevents copy from echoing the filenames that it is copying (used in conjunction with -w). | |
| 43 </para> | |
| 44 <para> | |
| 45 The "-r" option allows copy to rewrite the destination file if it matches the name of a source file that is being copied. If this option is not used, then the user will be prompted to overwrite a file of the same name. | |
| 46 </para> | |
| 47 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1013
diff
changeset
|
48 The "-s" option causes <command>copy</command> to perform a single drive copy |
| 134 | 49 operation. The second pathlist must be a full pathlist if "-s |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1013
diff
changeset
|
50 appears. <command>Copy</command> will read a portion of the source disk into memory, |
| 134 | 51 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
|
52 drive, enter a "C" whereupon <command>copy</command> writes on the destination disk, |
| 134 | 53 this process continues until the entire file is copied. |
| 54 </para> | |
| 55 <para> | |
| 1500 | 56 The "-w=<dir>" option allows you to specify a destination directory where all the files will be copied to. Use this option when specifing multiple filenames on the command line. |
| 57 </para> | |
| 58 <para> | |
| 59 The "-x=<dir>" will cause the files to be copied to an execution-relative directory. | |
| 60 </para> | |
| 61 <para> | |
| 134 | 62 Using the shell's alternate memory size modifier to give a large |
| 63 memory space will increase speed and reduce the number of media | |
| 64 exchanges required for single drive copies. | |
| 65 </para> | |
| 66 </refsect1> | |
| 67 <refsect1><title>Examples</title> | |
| 68 <screen> | |
| 69 copy file1 file2 #15k (copies file1 to file2) | |
| 70 | |
| 1013 | 71 copy /d1/joe/news /D0/peter/messages |
| 134 | 72 |
| 1500 | 73 copy /d1/joe/news /d1/joe/weather -w=/D0/peter (where /D0/peter is a directory) |
| 74 | |
| 1013 | 75 copy /term /p (copies console to printer) |
| 134 | 76 |
| 77 copy /d0/cat /d0/animals/cat -s #32k | |
| 78 Ready DESTINATION, hit C to continue: c | |
| 79 Ready SOURCE, hit C to continue: c | |
| 80 Ready DESTINATION, hit C to continue:c | |
| 81 </screen> | |
| 82 </refsect1> | |
| 83 </refentry> | |
| 84 |