% avrora -help analyze-stack
Avrora [Beta 1.6.0] - (c) 2003-2005 UCLA Compilers Group
Usage: avrora [-action=action] [options]
Usage: avrora -help [category]
ACTION OVERVIEW
The "analyze-stack" option invokes the built-in stack analysis tool on the
specified program. It uses an abstract interpretation of the program to
determine the possible interrupt masks at each program point and determines
the worst-case stack depth in the presence of interrupts.
OPTIONS
Help for the specific options accepted by this action is below.
-dump-state-space: boolean = false
This option causes the stack analyzer to print a dump of all
the reachable abstract states in the state space, as well as
all edges between states. This can be used for a post-mortem
analysis.
-monitor-states: boolean = false
This option is used to monitor the progress of a long-running
stack analysis problem. The analyzer will report the count of
states, edges, and propagation information produced every 5
seconds.
-reserve: long = 0
This option is used for reserving a small portion of memory
before the analysis begins, in case the Java heap space is
exhausted. This can happen with very large analyses. By
reserving some space up front, there is space left so that
post mortem graph analysis can be run. The units given are
megabytes.
-show-path: boolean = false
This option causes the stack analyzer to print out the
execution path corresponding to the maximal stack depth.
-trace: boolean = false
This option causes the stack analyzer to print a trace of each
abstract state produced, every edge between states that is
inserted, and all propagations performed during the analysis.
-trace-summary: boolean = true
This option is used to reduce the amount of output by
summarizing the error tracethat yields the maximal stack
depth. When true, the analysis will shorten the error trace by
not reporting edges between states of adjacent instructions
that do not change the stack height.
-use-isea: boolean = false
This option enables the use of information from
inter-procedural side effect analysis that may help in
reducing the memory usage during state exploration, without
affecting stack analysis precision. When this option is
enabled, the stack analyzer will consult the ISEA analysis
subsystem for each procedure call that it encounters in the
program.
For more information, see the online documentation at
http://compilers.cs.ucla.edu/avrora
To report bugs or seek help, consult the Avrora mailing list:
http://lists.ucla.edu/cgi-bin/mailman/listinfo/avrora
Please include the version number [Beta 1.6.0] when posting to the list.
|