|[ Home | What's New | Contents | Overview | Contributors | Distribution | Examples | Documentation | Manual | Publications | Mailing List Archive | Problems ]||This page was last updated by Axel Belinfante on 2006-06-30|
|TorX Test Tool Information|
Actually, mctrl is a shell-level command that uses a running mctrlsrv to create or reuse a scrollbar window, and animate it using animation commands received over the mcast connection. The connection between mctrl and a running mctrlsrv will not be closed until the complete standard input of the mctrl command has been processed by mctrlsrv. If mctrl cannot find a running mctrlsrv, it will start a new one. In general, it should not be necessary to start mctrlsrv by hand. However, if startup time of mctrl is an issue, it may be advantageous to start mctrlsrv (by hand) in advance, because a starting mctrlsrv may spend some time to check if another mctrlsrv is already running.
To display a new scrollbar, mctrlsrv will reuse windows that contain a completed animation and have the Reuse toggle activated. If more windows are needed, they are created.
The -r command line option of mctrl will activate the Reuse toggle button for the mctrl window.
The animation in the window will follow the step numbers read from standard input and the animation commands read from the mcast connection. The animation can be be done manually using the scrollbar, and/or with the Step up and down arrow buttons (as discussed below).
As stated above, the animation can be remotely controlled. Using the -m mcastid command line option, if given, or environment variable TORXMCASTID if set, mctrl will attempt to make a remote control connection to the tcp address in mcastid. (If neither -m mcastid is given nor TORXMCASTID if set, mctrl will exit with a usage message.) If it succeeds, it will then interpret lines of text read from the remote control connection consisting of a single number as commands to show the corresponding step in the animation. Additionally, whenever the user uses the scrollbar and/or navigation commands to show a different step, its step number is written to the remote control connection. The remote control connection allows multiple viewers to show the same test step.
To stop a running mctrlsrv, invoke mctrl with the -exit command line option.
It should be possible to replay an animation or torx-log(4) using the timing information present in the original animation or log (i.e. use the same time between the steps as during the original test run).
A more appropriate name might be anictrl.
Table of Contents
|Prev||Table of Contents||Next|
|Appendix D: TorX Manual Pages: mctrl(1) - animation progress scrollbar||Appendix D: TorX Manual Pages: mkprimer-aut(1) - generate a torx primer for aut using autexp|