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

Made some changes
author boisy
date Tue, 23 Jul 2002 23:43:29 +0000
parents a6eb496dbc1e
children f9c66ad345d1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
137
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="dsave">
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname>DSAVE</refname>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Generate procedure file to copy files</refpurpose>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
6
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
9 <command>DSAVE</command>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="opt">
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
11 <option>-opts</option>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
13 <arg choice="opt">
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
14 &replstart;devname&replend;
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
15 </arg>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
16 <arg choice="opt">
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
17 &replstart;path&replend;
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
18 </arg>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
19 </cmdsynopsis>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
20 </refsynopsisdiv>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
21
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
22 <refsect1><title>Description</title>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
23 <para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
24 Dsave is used to backup or copy all files in one or more
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
25 directories. It is unlike most other commands in that it does NOT
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
26 directly affect the system, rather, it generates a procedure file
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
27 which is executed later to actually do the work.
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
28 </para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
29 <para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
30 When DSAVE is executed, it writes copy commands to
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
31 <emphasis>standard output</emphasis>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
32 to copy files from the current <emphasis>data</emphasis> directory
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
33 on &replstart;devname&replend; (the default is /D0) to the directory
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
34 specified by &replstart;path&replend;. If &replstart;path&replend;
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
35 does not appear, the copy is performed to the current data directory
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
36 <emphasis>at the time the DSAVE procedure file is executed.</emphasis>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
37 If DSAVE
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
38 encounters a directory file, it will automatically include &quot;makdir&quot;
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
39 and &quot;chd&quot; commands in the output before generating copy commands for
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
40 files in the subdirectory. Since DSAVE is recursive in operation,
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
41 the procedure file will exactly replicate all levels of the file
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
42 system from the current data directory downward (such a section of
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
43 the file system is called a &quot;subtree&quot;).
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
44 </para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
45 <para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
46 If the current working directory happens to be the root directory of
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
47 the disk, DSAVE will create a procedure file that will backup the
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
48 entire disk file by file. This is useful when it is necessary to
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
49 copy many files from different format disks, or from floppy disk to
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
50 a hard disk.
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
51 </para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
52 <para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
53 Available DSAVE options are:
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
54 </para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
55
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
56 <informaltable frame="none">
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
57 <tgroup cols="2">
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
58 <colspec colwidth="1in">
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
59 <colspec colwidth="4in">
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
60 <tbody>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
61 <row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
62 <entry>-b</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
63 <entry>make output disk a system disk by using source disk's
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
64 &quot;OS9Boot&quot; file,. if present.</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
65 </row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
66 <row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
67 <entry>-b=&replstart;path&replend;</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
68 <entry>make output disk a system disk using &replstart;path&replend; as source
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
69 for the &quot;OS9Boot&quot; file.</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
70 </row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
71 <row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
72 <entry>-i</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
73 <entry>indent for directory levels</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
74 </row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
75 <row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
76 <entry>-L</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
77 <entry>do not process directories below the current level</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
78 </row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
79 <row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
80 <entry>-m</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
81 <entry>do not include &quot;makdir&quot; commands in procedure file</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
82 </row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
83 <row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
84 <entry>-s&replstart;integer&replend;</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
85 <entry>set copy size parameter to &replstart;integer&replend; K</entry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
86 </row>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
87 </tbody>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
88 </tgroup>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
89 </informaltable>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
90
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
91
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
92 <para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
93 For more information see: 1.1.3
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
94 </para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
95 </refsect1>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
96 <refsect1><title>Examples</title>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
97 <para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
98 Example which copies all files on &quot;d2&quot; to &quot;d1&quot;:
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
99 </para>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
100 <screen>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
101 chd /d2 (select &quot;from&quot; directory)
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
102 dsave /d2 &gt;/d0/makecopy (make procedure file &quot;makecopy&quot;)
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
103 chd /d1 (select &quot;to&quot; directory)
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
104 /d0/makcopy (run procedure file)
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
105
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
106 chd /d0/MYFILES/STUFF
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
107 dsave -is32 /d0 /d1/BACKUP/STUFF &gt;saver
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
108 /d0/MYFILES/STUFF/saver
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
109 </screen>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
110 </refsect1>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
111 </refentry>
a6eb496dbc1e Split up the commands into individual files.
roug
parents:
diff changeset
112