Functions

/home/mesh/mesh/include/mesh_trace.h File Reference

MESH trace functions. More...

Go to the source code of this file.

Functions

void mesh_trace_init (mesh_time start, mesh_time stop)
 Initializes printing out of debugging data by collecting traces of consume call blocks. Must be called before mesh_trace_print() is used, but after mesh_init(). Since trace data collection can potentially be very memory intensive, mesh_svg_init() takes in start and stop values as arguments.
void mesh_trace_print (gchar *filename)
 Prints out the debugging data as a text based trace file. Data collection must be turned on with mesh_trace_init() and the simulation must be run with mesh_kernel(). The trace file can be viewed using the java based MESH Viewer.
void mesh_ignore_trace_collection (mesh_resource *resource)
 Will disable the collection of trace information for a specific resource. This function is useful to ignore other resources when only a subset of resources are under examination, or to ignore ``phantom'' resources such as ones used to run testbenches. The mesh_create_tb_thread function uses this construct to remove itself from trace graphs.
void mesh_enable_trace_collection (mesh_resource *resource)
 Will enable the collection of trace information for a specific resource. This function can be used to start trace collection for a resource which has been disabled through mesh_ignore_trace_collection(). Since trace collection is turned on by default when mesh_create_resource() is run, this function does not need to be used in the common case.

Detailed Description

MESH trace functions.


Function Documentation

void mesh_enable_trace_collection ( mesh_resource *  resource  ) 

Will enable the collection of trace information for a specific resource. This function can be used to start trace collection for a resource which has been disabled through mesh_ignore_trace_collection(). Since trace collection is turned on by default when mesh_create_resource() is run, this function does not need to be used in the common case.

label mesh_enable_trace_collection

Parameters:
resource Pointer to the resource for which traces will be collected precond A valid mesh_resource must be created through the use of mesh_create_resource()
See also:
mesh_ignore_trace_collection()
void mesh_ignore_trace_collection ( mesh_resource *  resource  ) 

Will disable the collection of trace information for a specific resource. This function is useful to ignore other resources when only a subset of resources are under examination, or to ignore ``phantom'' resources such as ones used to run testbenches. The mesh_create_tb_thread function uses this construct to remove itself from trace graphs.

label mesh_ignore_trace_collection

Parameters:
resource Pointer to the resource for which traces will be collected precond A valid mesh_resource must be created through the use of mesh_create_resource()
See also:
mesh_enable_trace_collection()
void mesh_trace_init ( mesh_time  start,
mesh_time  stop 
)

Initializes printing out of debugging data by collecting traces of consume call blocks. Must be called before mesh_trace_print() is used, but after mesh_init(). Since trace data collection can potentially be very memory intensive, mesh_svg_init() takes in start and stop values as arguments.

label mesh_trace_init

Parameters:
start Simulation time at which the trace data collection will start
stop Simulation time at which the trace data collection will stop precond mesh_init() must be run
See also:
mesh_trace_print()
void mesh_trace_print ( gchar *  filename  ) 

Prints out the debugging data as a text based trace file. Data collection must be turned on with mesh_trace_init() and the simulation must be run with mesh_kernel(). The trace file can be viewed using the java based MESH Viewer.

label mesh_trace_print

Parameters:
filename Filename for the trace file output precond mesh_trace_init() and mesh_kernel() must be run
See also:
mesh_trace_init()
 All Files Functions