1 08/07/86 rebuild_disk
 2 
 3 Syntax as a command:  rebuild_disk volume_name drive_name1 -copy
 4    drive_name2 {-control_args}
 5 
 6 
 7 Function: rebuilds a disk by copying all information onto another disk
 8 and makes changes to partitions and/or to the VTOC as directed.  You
 9 can use it only in ring 1.
10 
11 
12 Arguments:
13 volume_name
14    is the name of a mounted physical volume.
15 drive_name1
16    is the source pack's drive in the form <subsys>_<nn>.
17 drive_name2
18    is the target pack's drive to be used for the copy, in the form
19    <subsys>_<nn>.
20 
21 
22 Control arguments:
23 -console
24    sends output to the bootload console instead of to the printer.
25 -copy
26    copies all information from the source pack's drive onto the target
27    pack's drive.  (Required)
28 -debug
29    is intended for system programmer use.
30 -dump
31    dumps damaged objects.
32 
33 
34 Notes: The disk being copied must be in a logical volume that is in
35 service (has been added to the system with the add_lv command).
36 
37 This command prints out the current extent and location of partitions
38 on the source pack, VTOC size, number of VTOC entries, and average
39 segment length.  The request loop of the init_vol command is then
40 entered to specify the partition extents and locations of the target
41 pack and VTOC size.
42 
43 
44 You can change some of the parameters of a volume, such as VTOC size,
45 paging region size, and partitions, using rebuild_disk.  Please note:
46    1. You can increase the VTOC size, as long as there is room to do
47       so.
48    2. You can decrease the VTOC size, provided that there are no active
49       VTOCEs in the truncated portion of the old VTOC.  The command
50       validates this condition and terminates with an error message if
51       there are active VTOCEs in the portion of the old VTOC that is to
52       be truncated.  You can use the sweep_pv command with -move and
53       -from to vacate a portion of the VTOC prior to running
54       rebuild_disk.
55 
56 
57 The disk rebuild operation takes about seven minutes per thousand VTOC
58 entries in use and one minute per thousand VTOC entries not in use.  A
59 progress message is reported to the bootload console as every thousand
60 VTOC entries are processed.
61 
62 The init_vol request loop assumes the same starting parameters whether
63 it is being used for a volume initialization or a disk rebuild; you
64 must not assume that the starting parameters of the target pack are in
65 any way derived from the source pack.
66 
67 This command queries you before destroying the label of any pack that
68 appears to be a validly labeled pack.  A message giving the pack's
69 physical volume name and time of last use is displayed.