Mercurial > hg > Members > kono > nitros9-code

comparison docs/nitros9guide/dsave.refentry @ 137:a6eb496dbc1e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Split up the commands into individual files.
author roug
date Sun, 07 Jul 2002 08:58:56 +0000
parents
children f9c66ad345d1
comparison
equal deleted inserted replaced
136:94476830df51 137:a6eb496dbc1e
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 &quot;makdir&quot;
39 and &quot;chd&quot; 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 &quot;subtree&quot;).
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 &quot;OS9Boot&quot; 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 &quot;OS9Boot&quot; 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 &quot;makdir&quot; 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 &quot;d2&quot; to &quot;d1&quot;:
99 </para>
100 <screen>
101 chd /d2 (select &quot;from&quot; directory)
102 dsave /d2 &gt;/d0/makecopy (make procedure file &quot;makecopy&quot;)
103 chd /d1 (select &quot;to&quot; directory)
104 /d0/makcopy (run procedure file)
105
106 chd /d0/MYFILES/STUFF
107 dsave -is32 /d0 /d1/BACKUP/STUFF &gt;saver
108 /d0/MYFILES/STUFF/saver
109 </screen>
110 </refsect1>
111 </refentry>
112