COBHAM GRMON3 - Page 122

GRMON3-UM
June 2019, Version 3.1.0
122 www.cobham.com/gaisler
31. ei - syntax
NAME
ei - Inject errors in CPU cache and register files
SYNOPSIS
ei subcommand ?args...?
DESCRIPTION
Errors will be injected according to the CPU configuration. Injection of errors in ITAG, IDATA, DTAG, DDATA,
STAG, IU register file and FP register file is supported.
ei un ?nr t?
Enable error injection, uniform error distribution mode. nr errors are inserted during the time period of t
minutes. Errors are uniformly distributed over the time period.
ei av ?r?
Enable error injection, average error rate mode. Errors will be inserted during the whole program execution.
Average error rate is r errors per second.
ei disable
Disable error injection.
ei log ?filename?
ei log disable
Enable/disable error injection log. The error injection log is saved in file log_file.
ei stat
ei stat ?enable?
ei stat ?disable?
Show, enable or disable error injection statistics. When enabled, the SEU correction counters are modified.
This option should not be used with software which itself monitors SEU error counters.
ei prob
ei prob itag dtag idata ddata stag iurf fprf ?cpu#?
Show or set probability of each error injection target. Each injection target has an associated probability
value from 0.0 to 1.0. The value 0.0 means that no errors will be injected in the target. A value higher than
0.0 means that the error will be injected with the specified probability.
When no parameter is given to ei prob, then the currently configured values are listed. The second form
configures the probabilities from user supplied decimal numbers. Target CPU is selected with the cpu#
parameter. If no CPU parameter is given, then the current CPU is used.
RETURN VALUE
Command ei has no return value.
EXAMPLE
Configure ei to inject errors only in the data cache tags and instruction cache tags (DTAG and ITAG) of cpu0:
grmon3> ei prob 1.0 1.0 0.0 0.0 0.0 0.0 0.0 cpu0
grmon3> ei prob 0.0 0.0 0.0 0.0 0.0 0.0 0.0 cpu1
List the currently configured target probabilities:
grmon3> ei prob
SEE ALSO
Section 3.10.2, “LEON3-FT error injection”
icache