Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/dsave.refentry @ 2112:cfb3a637a000
Fixed lack of H6309 flag
| author | boisy |
|---|---|
| date | Tue, 21 Aug 2007 17:05:14 +0000 |
| parents | b00cf13c9f61 |
| children |
| rev | line source |
|---|---|
| 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> | |
| 1093 | 9 <command>dsave</command> |
| 137 | 10 <arg choice="opt"> |
| 1500 | 11 <option>opts</option> |
| 137 | 12 </arg> |
| 13 <arg choice="opt"> | |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
648
diff
changeset
|
14 <replaceable>path</replaceable> |
| 137 | 15 </arg> |
| 16 </cmdsynopsis> | |
| 17 </refsynopsisdiv> | |
| 18 | |
| 19 <refsect1><title>Description</title> | |
| 20 <para> | |
| 21 Dsave is used to backup or copy all files in one or more | |
| 1500 | 22 directories. It does not execute the commands; instead, it echos commands |
| 23 to standard output. This output can be redirected to a file and executed later as a procedure file. | |
| 137 | 24 </para> |
| 25 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
26 When <command>dsave</command> is executed, it writes copy commands to |
| 137 | 27 <emphasis>standard output</emphasis> |
| 28 to copy files from the current <emphasis>data</emphasis> directory | |
| 1500 | 29 to the directory specified by <replaceable>path</replaceable>. |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
30 If <command>dsave</command> |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
31 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
|
32 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
|
33 files in the subdirectory. Since <command>dsave</command> is recursive in operation, |
| 137 | 34 the procedure file will exactly replicate all levels of the file |
| 35 system from the current data directory downward (such a section of | |
| 36 the file system is called a "subtree"). | |
| 37 </para> | |
| 38 <para> | |
| 39 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
|
40 the disk, <command>dsave</command> will create a procedure file that will backup the |
| 137 | 41 entire disk file by file. This is useful when it is necessary to |
| 42 copy many files from different format disks, or from floppy disk to | |
| 43 a hard disk. | |
| 44 </para> | |
| 45 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
46 Available <command>dsave</command> options are: |
| 137 | 47 </para> |
| 48 | |
| 49 <informaltable frame="none"> | |
| 50 <tgroup cols="2"> | |
| 648 | 51 <colspec colwidth="1in"/> |
| 52 <colspec colwidth="4in"/> | |
| 137 | 53 <tbody> |
| 54 <row> | |
| 55 <entry>-b</entry> | |
| 56 <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
|
57 <filename>OS9Boot</filename> file,. if present.</entry> |
| 137 | 58 </row> |
| 59 <row> | |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
648
diff
changeset
|
60 <entry>-b=<replaceable>path</replaceable></entry> |
|
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
648
diff
changeset
|
61 <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
|
62 for the <filename>OS9Boot</filename> file.</entry> |
| 137 | 63 </row> |
| 64 <row> | |
| 65 <entry>-i</entry> | |
| 66 <entry>indent for directory levels</entry> | |
| 67 </row> | |
| 68 <row> | |
| 1500 | 69 <entry>-l</entry> |
| 137 | 70 <entry>do not process directories below the current level</entry> |
| 71 </row> | |
| 72 <row> | |
| 73 <entry>-m</entry> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
74 <entry>do not include <command>makdir</command> commands in procedure file</entry> |
| 137 | 75 </row> |
| 76 <row> | |
| 1500 | 77 <entry>-r</entry> |
| 78 <entry>forces the copy command to rewrite the file at its destination if it already exists</entry> | |
| 79 </row> | |
| 80 <row> | |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
648
diff
changeset
|
81 <entry>-s<replaceable>integer</replaceable></entry> |
|
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
648
diff
changeset
|
82 <entry>set copy size parameter to <replaceable>integer</replaceable> K</entry> |
| 137 | 83 </row> |
| 84 </tbody> | |
| 85 </tgroup> | |
| 86 </informaltable> | |
| 87 | |
| 88 | |
| 89 <para> | |
| 1093 | 90 For more information see: <xref linkend="sec2.3"/> |
| 137 | 91 </para> |
| 92 </refsect1> | |
| 93 <refsect1><title>Examples</title> | |
| 94 <para> | |
| 95 Example which copies all files on "d2" to "d1": | |
| 96 </para> | |
| 97 <screen> | |
| 1500 | 98 chd /d0 (select "from" directory) |
| 99 dsave /d1 >/d0/makecopy (make procedure file "makecopy") | |
| 137 | 100 /d0/makcopy (run procedure file) |
| 101 | |
| 102 chd /d0/MYFILES/STUFF | |
| 1500 | 103 dsave -is32 /d1/BACKUP/STUFF >saver |
| 137 | 104 /d0/MYFILES/STUFF/saver |
| 105 </screen> | |
| 106 </refsect1> | |
| 107 </refentry> | |
| 108 |