view docs/nitros9guide/copy.refentry @ 1014:d9ed9d44b70c

Some character entities had missing semicolons. It's &CPU; The os9l1guide and os9l2guide are now much more modular simply because the sections that are not to be included in one of them is defined as the empty string in the <!ENTITY declaration Split exbin and binex pages so the occur at the right place in the manual. Got the content for wcreate from the Internet.
author roug
date Tue, 04 Mar 2003 20:05:50 +0000
parents 15a1a20b70ab
children b5ff125a1d60
line wrap: on
line source

<refentry id="copy">
<refnamediv>
<refname>COPY</refname>
<refpurpose>Copy data from one path to another</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>COPY</command>
<arg choice="plain">
  <replaceable>path</replaceable>
</arg>
<arg choice="plain">
  <replaceable>path</replaceable>
</arg>
<arg choice="opt">
  <option>-s</option>
</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para>
This command copies data from the first file or device specified to
the second. The first file or device must already exist, the
second file is automatically created if the second path is a file on
a mass storage device. Data may be of any type and is NOT modified
in any way as it is copied.
</para>
<para>
Data is transferred using large block reads and writes until end-of-file
occurs on the input path. Because block transfers are used,
normal output processing of data does not occur on character-oriented
devices such as terminals, printers, etc. Therefore, the
LIST command is preferred over COPY when a file consisting of text
is to be sent to a terminal or printer.
</para>
<para>
The &quot;-s&quot; option causes COPY to perform a single drive copy
operation. The second pathlist must be a full pathlist if &quot;-s
appears. COPY will read a portion of the source disk into memory,
you remove the source disk and place the destination disk into the
drive, enter a &quot;C&quot; whereupon COPY writes on the destination disk,
this process continues until the entire file is copied.
</para>
<para>
Using the shell's alternate memory size modifier to give a large
memory space will increase speed and reduce the number of media
exchanges required for single drive copies.
</para>
</refsect1>
<refsect1><title>Examples</title>
<screen>
copy file1 file2 #15k           (copies file1 to file2)

copy /d1/joe/news /D0/peter/messages

copy /term /p                   (copies console to printer)

copy /d0/cat /d0/animals/cat -s #32k
Ready DESTINATION, hit C to continue: c
Ready SOURCE, hit C to continue: c
Ready DESTINATION, hit C to continue:c
</screen>
</refsect1>
</refentry>