1 02/25/85 meter_signal
 2 
 3 Syntax as a command:  meter_signal {-control_args}
 4 
 5 
 6 Function:  measures the performance of the Multics signalling
 7 mechanism.  It sets up an environment of condition handlers and stack
 8 frames, and then causes a specified number of zerodivide faults to
 9 occur.  The calendar clock is read before each fault and again as the
10 first operation in the zerodivide condition handler.  The difference
11 between these values is recorded and printed on the terminal.  The mean
12 and minimum values for all zerodivide faults caused in an invocation
13 are computed.
14 
15 
16 Control arguments:
17 Each control argument must include a decimal value (N) and can be
18 specified in any order.
19 -nfaults N
20    specifies how many zerodivide faults to cause.  One zerodivide fault
21    is the default.
22 -nframes N
23    specifies the number of stack frames to be established between the
24    frame containing the zerodivide handler and the frame that causes
25    the fault.  The fault occurs in the same frame that established the
26    handler if the value is one; this is the default.
27 
28 
29 -nhandlers N
30    specifies the number of handlers for dummy conditions to be
31    established in each stack frame.  Handlers are established for the
32    conditions meter_signal1 through meter_signalN where N is the value
33    specified.  The default is that no dummy interrupt handler is
34    established.
35 -unclaimed N
36    specifies that an unclaimed_signal handler should be established
37    instead of the zerodivide handler.  The unclaimed_signal handler is
38    established in the Nth frame where N is the value specified.  Stack
39    frames are numbered from 1 to p, where p is the number in the
40    -nframe control argument.  The default is that no unclaimed_signal
41    handler is established.