1 07/12/83  print_sample_refs
 2 
 3 Syntax:  print_sample_refs name {-control_arg}
 4 
 5 
 6 Function:  interprets the three data segments produced by the
 7 sample_refs command, and produces a printable output segment that
 8 contains the following information:  a detailed trace of segment
 9 references, a segment number to pathname dictionary, and histograms of
10 the Procedure Segment Register (PSR) and Temporary Segment Register
11 (TSR) segment reference distributions.  (See the description of the
12 sample_refs command.)
13 
14 
15 Arguments:
16 name
17    specifies the names of the data segments to be interpreted, as well
18    as the name of the output segment to be produced.  This argument can
19    be either an absolute or relative pathname.  If name does not end
20    with the suffix srf, it is assumed.
21 
22    The appropriate directory is searched for three segments with
23    entrynames as follows:
24       (entry portion of) name.srf1
25       (entry portion of) name.srf2
26       (entry portion of) name.srf3
27 
28    The output segment is placed in the user's working directory with
29    the entryname:
30       (entry portion of) name.list
31 
32 
33 Control arguments:
34 -brief, -bf
35    specifies that the detailed trace of segment references is not to be
36    generated.
37 
38 
39 Notes:  The print_sample_refs command is able to detect a reused
40 segment number.  The appearance of a parenthesized integer preceding a
41 segment number indicates reusage.