Mercurial > hg > Members > kono > nitros9-code
comparison docs/nitros9guide/copy.refentry @ 134:52af9581ef1e
Split up the commands into individual files.
| author | roug |
|---|---|
| date | Sun, 07 Jul 2002 08:58:56 +0000 |
| parents | |
| children | c565a4700689 |
comparison
equal
deleted
inserted
replaced
| 133:40f5c43c8c03 | 134:52af9581ef1e |
|---|---|
| 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> | |
| 9 <command>COPY</command> | |
| 10 <arg choice="plain"> | |
| 11 &replstart;path&replend; | |
| 12 </arg> | |
| 13 <arg choice="plain"> | |
| 14 &replstart;path&replend; | |
| 15 </arg> | |
| 16 <arg choice="opt"> | |
| 17 <option>-s</option> | |
| 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 | |
| 35 LIST command is preferred over COPY when a file consisting of text | |
| 36 is to be sent to a terminal or printer. | |
| 37 </para> | |
| 38 <para> | |
| 39 The "-s" option causes COPY to perform a single drive copy | |
| 40 operation. The second pathlist must be a full pathlist if "-s | |
| 41 appears. COPY will read a portion of the source disk into memory, | |
| 42 you remove the source disk and place the destination disk into the | |
| 43 drive, enter a "C" whereupon COPY writes on the destination disk, | |
| 44 this process continues until the entire file is copied. | |
| 45 </para> | |
| 46 <para> | |
| 47 Using the shell's alternate memory size modifier to give a large | |
| 48 memory space will increase speed and reduce the number of media | |
| 49 exchanges required for single drive copies. | |
| 50 </para> | |
| 51 </refsect1> | |
| 52 <refsect1><title>Examples</title> | |
| 53 <screen> | |
| 54 copy file1 file2 #15k (copies file1 to file2) | |
| 55 | |
| 56 copy /D1/joe/news /D0/peter/messages | |
| 57 | |
| 58 copy /TERM /P (copies console to printer) | |
| 59 | |
| 60 copy /d0/cat /d0/animals/cat -s #32k | |
| 61 Ready DESTINATION, hit C to continue: c | |
| 62 Ready SOURCE, hit C to continue: c | |
| 63 Ready DESTINATION, hit C to continue:c | |
| 64 </screen> | |
| 65 </refsect1> | |
| 66 </refentry> | |
| 67 |