GRMON3-UM
June 2019, Version 3.1.0
154 www.cobham.com/gaisler
56. l4stat - syntax
NAME
l4stat - Control Leon4 statistics unit
SYNOPSIS
l4stat subcommand ?args...?
l4stat index subcommand ?args...?
DESCRIPTION
This command provides functions to control the L4STAT core. If more than one core exists in the system, then the
index of the core to control should be specified after the l4stat command (before the subcommand). The 'info
sys' command lists the device indexes.
l4stat events
Show all events that can be selected/counted
l4stat status
Display status of all available counters.
l4stat clear cnt
Clear the counter cnt.
l4stat set cnt cpu event ?enable? ?clearonread?
Count the event using counter cnt on processor cpu. The optional enable parameter defaults to 1 if
left out. The optional clearonread parameter defaults to 0 if left out.
l4stat duration cnt enable ?lvl?
Enable the counter cnt to save maximum time the selected event has been at lvl. When enabling the lvl
parameter must be present, but when disabling it be left out.
l4stat poll start stop interval hold
Continuously poll counters between start and stop. The interval parameter sets how many seconds
between each iteration. If hold is set to 1, then it will block until the first counter is enabled by other means
(i.e. software). The polling stops when the first counter is disabled or a SIGINT signal (Ctrl-C) is sent to
GRMON.
l4stat runpoll start stop interval
Setup counters between start and stop to be polled while running an application (i.e. 'run, 'go' or 'cont'
commands). The interval argument in this case does not specify the poll interval seconds but rather in
terms of iterations when GRMON polls the Debug Support Unit to monitor execution. A suitable value for
the int argument in this case depends on the speed of the host computer, debug link and target system.
EXAMPLE
Enable maximum time count, on counter 1, when no instruction cache misses has occurred.
grmon3> l4stat set 1 0 icmiss
grmon3> l4stat duration 1 1 0
Disable maximum time count on counter 1.
grmon3> l4stat duration 1 0
Poll for cache misses when running.
grmon3> l4stat set 0 0 dcmiss
grmon3> l4stat set 1 0 icmiss
grmon3> l4stat runpoll 0 1 5000
grmon3> run