Mercurial > hg > Members > kono > nitros9-code

annotate docs/nitros9guide/backup.refentry @ 2934:0bd529f1d860

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update mkdskimage script to recognize DW images DriveWire image names were changed from _dw3.dsk to _dw.dsk.
author Tormod Volden <debian.tormod@gmail.com>
date Tue, 21 Jan 2014 20:47:47 +0100
parents 4dae346c4969
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="backup">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname id="backupname">BACKUP</refname>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Make a backup copy of a disk</refpurpose>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
6
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
9 <command>backup</command>
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="opt">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
11 <option>e</option>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
13 <arg choice="opt">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
14 <option>s</option>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
15 </arg>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
16 <arg choice="opt">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
17 <option>-v</option>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
18 </arg>
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 134
diff changeset
19 <arg choice="opt"><replaceable>devname</replaceable>
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 134
diff changeset
20 <arg choice="opt"><replaceable>devname</replaceable></arg></arg>
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
21 </cmdsynopsis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
22 </refsynopsisdiv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
23
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
24 <refsect1><title>Description</title>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
25 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
26 This command is used to physically copy all data from one device to
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
27 another. A physical copy is performed sector by sector without
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
28 regard to file structures. In almost all cases the devices
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
29 specified mun.t have the exact same format (size, density, etc.) and
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
30 must not have defective sectors.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
31 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
32 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
33 If both device name are omitted the names &quot;/d0&quot; and &quot;/d1&quot; are
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
34 assumed. If the second device name is omitted, a single unit backup
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
35 will be performed on the drive specified.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
36 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
37 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
38 The options are:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
39 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
40 <literallayout>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
41 E = Exit if any read error occurs.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
42 S = Print single drive prompt message.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
43 -V = Do not verify.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
44 #nK = more memory makes backup run faster
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
45 </literallayout>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
46 </refsect1>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
47 <refsect1><title>Examples</title>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
48 <screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
49 backup /D2 /D3
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
50
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
51 backup -V
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
52
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
53
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
54
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
55 OS9: backup
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
56
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
57 Ready to BACKUP from /D0 to /D1 ?: Y
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
58 MYDISK is being scratched
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
59 OK ?: Y
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
60 Number of sectors copied: $04D0
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
61 Verify pass
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
62 Number of sectors verified: $04D0
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
63 OS9:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
64 </screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
65 <para>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
66 Below is an example of a single drive backup. <command>backup</command> will read a
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
67 portion of the source disk into memory, you remove the source disk
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
68 and place the destination disk into the drive, <command>backup</command> writes on the
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
69 destination disk, you remove the destination disk and place the
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
70 source disk into the drive. This continues until the entire disk
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
71 has been copied. Giving <command>backup</command> as much memory as possible will cause
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
72 fewer disk exchanges to be required.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
73 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
74 <para>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
75 For more information see: <xref linkend="sec1.1.2"/>
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
76 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
77 <screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
78 OS9:backup /D0 #10k
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
79
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
80 Ready to BACKUP from /D0 to /D0 ?: Y
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
81 Ready DESTINATION, hit a key:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
82 MYDISK is being scratched
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
83 OK ?: Y
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
84 Ready SOURCE, hit a key:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
85 Ready DESTINATION, hit a key:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
86 Ready SOURCE, hit a key:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
87 Ready DESTINATION, hit a key:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
88
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
89 (several repetitions)
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
90
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
91 Ready DESTINATION, hit a key:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
92 Number of sectors copied: $4D0
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
93 Verify pass
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
94 Number of sectors verified: $4D0
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
95 </screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
96 </refsect1>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
97 </refentry>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
98