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