atl_start_trace()

Trace Probes for C

Purpose

Initializes the environment of an instance trace. This macro must be executed before any other probe macro. Ideally, it can be placed at the start of the application.

Syntax

atl_start_trace( <handle >, "<path>", <instance>, <size> )

where:

• <handle> is the handle of the media storage and the handle of the result file (.rio). It relates to the instance name. This handle is used by other macros for all messages sent or received by this instance. This parameter must be in a valid variable name format and a non existing variable.

• <path> is the path to the .rio file to which the traces are to be written (with quotes ""). It can be used to open the intermediate binary file.

• <instance> is the logical name of the life line showing messages sent or received by the application instance. it could be the process/thread name or the layer name.

• <size> specifies the memory size used in bytes in FIFO or USER mode.

Example

int main(int argc, char** argv)

{

...

atl_start_trace(atl_client, "../res/", client, 0);

atl_start_trace(atl_serv, "../res/", serv, 0);

...

atl_end_trace(atl_client);

atl_end_trace(atl_serv);

...

}

Related Topics

Probe macros | atl_end_trace()