1 02/28/84  comp_dir_info
 2 
 3 Syntax:  comp_dir_info path1 path2 {-control_args}
 4 
 5 
 6 Function: compares two directory information segments created by
 7 save_dir_info and reports on the differences.
 8 
 9 
10 Arguments:
11 path1
12    is the pathname of the old directory information segment.  The
13    dir_info suffix need not be given.
14 path2
15    is the pathname of the new directory information segment.  The
16    dir_info suffix need not be given.
17 
18 
19 Control arguments:
20 -brief, -bf
21    compares and prints minimum information (see "Notes.")
22 -verbose, -vb
23    compares and prints almost all information.  (Default)
24 -long, -lg
25    compares and prints all information.
26 
27 
28 Notes: Output is written on user_output.  Unless -brief is specified,
29 output is preceded by a formfeed character and a header identifying
30 the directories to be compared and the times that information was
31 saved by save_dir_info.  If no changes are found according to the
32 specified control arguments, the string "Identical." is printed.
33 
34 Output is in three sections--
35    modified entries
36    deleted entries
37    added entries
38 and is identified by entry type (dir, seg, or link) and entryname.
39 
40 
41 For deletions and additions a heading is printed of the form
42    deleted: type entryname
43 followed by a listing of the attributes of the deleted or added entry
44    item_name: value
45 
46 For segments that have been modified a heading is printed of the form
47    modified: type entryname
48 followed by either of the following:
49    item_name changed from value1 to value2
50    item_name added: value
51 
52 
53 The -brief, -verbose and -long control arguments print increasing
54 amounts of information.  In the list below, each control argument is
55 assumed to print all the information listed for it.
56 
57 Segments--
58 -bf: names, type, date used, date modified
59 -vb: date branch modified, volume, records used, bit count, bit count
60      author, max length, safety switch
61 -lg: ACL, date dumped, current length, copy switch, tpd switch, ring
62      brackets, unique id, author
63 
64 
65 Directories--
66 -bf: names, type, date used, date modified, sons volume, master dir
67 -vb: date branch modified, bit count, records used, quota, date dumped,
68      current length, ring brackets, unique id, author, bit count
69      author, max length, safety switch
70 -lg: ACL, initial seg ACL, initial dir ACL
71 
72 Links--
73 -bf: names, type, link target
74 -vb: date link modified
75 -lg: date link dumped
76 
77 
78 The following information is checked to decide whether an entry has
79 been modified:
80 
81 Segments--
82 -bf: names, ring brackets, deletion of ACL, truncation
83 -vb: safety switch, author, bit count author, ACL, date branch
84      modified, records used, max length
85 -lg: date modified, volume, bit count
86 
87 
88 Directories--
89 -bf: names, ring brackets, deletion of ACL, sons volume, master dir,
90      quota, bit count
91 -vb: safety switch, author, bit count author, ACL, initial seg ACL, in
92      dir ACL
93 -lg: date branch modified, date modified
94 
95 Links--
96 -bf: names, link target
97 -vb: date link modified