Mercurial > hg > Members > kono > nitros9-code

annotate docs/nitros9guide/dsave.refentry @ 1053:b5ff125a1d60

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Since this book was only typeset in fixed width, single-font, they used capitalization and quotes (") to show what was commands, files and just text. With today's formatting, this is not necessary, so everywhere capitalization was used to show a command the <command> element is now used instead, and everywhere a file is mentioned the <filename> element is used.
author roug
date Thu, 20 Mar 2003 20:19:53 +0000
parents c565a4700689
children 4dae346c4969
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">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 648
diff changeset
14 <replaceable>devname</replaceable>
137
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">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 648
diff changeset
17 <replaceable>path</replaceable>
137
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>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
30 When <command>dsave</command> is executed, it writes copy commands to
137
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
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 648
diff changeset
33 on <replaceable>devname</replaceable> (the default is /D0) to the directory
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 648
diff changeset
34 specified by <replaceable>path</replaceable>. If <replaceable>path</replaceable>
137
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
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
36 <emphasis>at the time the <command>dsave</command> procedure file is executed.</emphasis>
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
37 If <command>dsave</command>
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
38 encounters a directory file, it will automatically include <command>makdir</command>
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
39 and <command>chd</command> commands in the output before generating copy commands for
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
40 files in the subdirectory. Since <command>dsave</command> is recursive in operation,
137
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
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
47 the disk, <command>dsave</command> will create a procedure file that will backup the
137
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>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
53 Available <command>dsave</command> options are:
137
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">
648
f9c66ad345d1 XMLified.
roug
parents: 137
diff changeset
58 <colspec colwidth="1in"/>
f9c66ad345d1 XMLified.
roug
parents: 137
diff changeset
59 <colspec colwidth="4in"/>
137
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
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
64 <filename>OS9Boot</filename> file,. if present.</entry>
137
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>
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 648
diff changeset
67 <entry>-b=<replaceable>path</replaceable></entry>
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 648
diff changeset
68 <entry>make output disk a system disk using <replaceable>path</replaceable> as source
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
69 for the <filename>OS9Boot</filename> file.</entry>
137
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>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
81 <entry>do not include <command>makdir</command> commands in procedure file</entry>
137
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>
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 648
diff changeset
84 <entry>-s<replaceable>integer</replaceable></entry>
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 648
diff changeset
85 <entry>set copy size parameter to <replaceable>integer</replaceable> K</entry>
137
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