OSDN Git Service

* public snapshot of sid simulator
[pf3gnuchains/pf3gnuchains3x.git] / sid / component / tcl / README.misc
1 Sample tcl components
2 ---------------------
3
4 The "trace.tcl" script, when loaded into a tcl-bridge component, acts
5 as a tracing front-end component for any other selected sid component.
6 That component is identified to the script via a "victim" component
7 relationship.  Then this tracer tcl-based component can take the place
8 of the victim to the rest of the system.  It is almost a wrapper.
9
10 The script transparently passes through almost all sid API calls
11 between the "outside" and the chosen victim.  It is capable of tracing
12 all sid::pin/bus/component API traffic to that victim.  If the
13 "victim-trace?" attribute is set, it will log them to stdout.
14
15
16 The "tester.tcl" script acts as a tcl "read-eval-print" loop within
17 sid.  Every time its "command-io" pin is driven from the outside, it
18 presents a prompt, and evaluates a single tcl command entered there,
19 and prints the result back.  An external program can therefore make
20 arbitrary sid API calls, using this component as an interactive
21 command interpreter.  This script is used in dejagnu unit testing.