User guide

4.3. COMMANDS 125
stats TO/K,PROFILE/S,ANALYSIS/S CIN:y, POS:y, NAT:y
This command controls the tallying facili ty which counts the ex e cut i on of i ndi v i du al
Cintcode instructions. If no arguments are given, stats turns on tallying by clearing
the tally vector and causing tallyi ng to be enabled for the next command to be executed.
Subsequent commands are not tallied, making it possible to process the tally vector
while it is in a static state. Typical usage of the stats command is illustrated below:
preload queens Preload the program to study
stats Enable stats gathering on next command
queens Execute the command to study
interpreter Select the fast interpreter (cintasm)
stats automatically selects the slow one
stats to STATS Send instruction frequencies to file
or
stats profile to PROFILE Send detailed profile info to file
or
stats analysis to ANALYSIS Generate statistical analysis to file
status TASK,FULL/S,TCB/S,SEGS/S,CLI=ALL/S CIN:n, POS:y, NAT:n
This Cintpos command outputs information about all currently existing Cintpos
tasks.
syncdemo CIN:n, POS:y, NAT:n
This is a program to d emon st rat e various synchronisation mechanisms imple me nted
using coroutines and multi-event tasks.
sysdebug FROM CIN:y, POS:y, NAT:y
This i s an interactive debugger that allows the user to inspect a given Cintsys
memory dump file. The default file name is DUMP.mem. See dumpmem descr i bed above.
taskid FORMAT CIN:n, POS:y, NAT:n
This command calls writef with the given format and the current task number as
the second argument. The default format is "Taskid=%n*n".
tcpaddr HOST,PORT CIN:n, POS:y, NAT:n
This attempts to output the IP address and port number given the names of the
host and port.
tcpbench -n/K,-k/K,-s/K,-h/K,-t/S,master/s,slave/s CIN:n, POS:y, NAT:n
This is a benchmark program to test the efficiency of TCP/IP communication. For
information about what it does and how to use it, see the comments at the start of the
source code.
tcpcli PORT,NOPROMPT/S CIN:n, POS:y, NAT:n
This command creates a new CLI task communicating through the given port. The
default port number is 8000. If NOPROMPT is specified the newly created CLI will not
issue prompts.