1 04/05/85 verify_dump_volume
 2 
 3 Syntax as a command:  verify_dump_volume dvname {-control_args}
 4 
 5 
 6 Function:  checks the validity and readability of a dump volume
 7 produced by the volume dumper subsystem.  Optionally it will also
 8 produce a pathname list of the segments and directories, if known, on
 9 the dump volume.
10 
11 
12 Arguments:
13 dvname
14    is the name of the dump volume.
15 
16 
17 Control arguments:
18 -brief, -bf
19    produces a short form list of objects on the dump volume consisting
20    only of pathnames.
21 -input_volume_desc STR
22    uses the attach description STR (default attach description is
23    tape_mult_ ^a -system).  The volname is inserted at the first
24    occurrence of ^a in the attach description.
25 -long, -lg
26    produces a long form list of objects on the dump volume consisting
27    of pathname, object type, and other information where applicable.
28 -stop_vtocx N
29    stops the verification process when a VTOCE with octal index N is
30    encountered, calls the debug command, and prints a pointer to the
31    VTOCE.
32 
33 
34 Notes:  If no control argument is specified, the entire dump volume is
35 read and an error count message is printed at the end of the volume.
36 If read errors occur, the same resynchronization mechanism used by the
37 volume reloader and volume retriever is used.  If the pathname cannot
38 be determined, the string "UNKNOWN" is used.