How do I use local capture with ARM Streamline?

Applies to: DS-5

Answer

Usually ARM Streamline sends captured data from the target to the host using a network connection. However, if this is not possible because of limitations with your target, you can save the data to local target storage for manual transfer to your host.

How it Works

To capture data locally, create a session.xml file and pass it as a parameter to gatord on the command line. Instead of setting profiling options in the Run Configuration dialog box of Eclispe for DS-5, you can set them by adding options directly to this XML file.

Replacing the output_path with target_path in the session.xml file tells gatord to store the .apc file on the target instead of attempting to send it to the host.

Note: The target_path attribute accepts the @F and @N codes. @F adds the value of the title attribute to the file name and @N adds a sequential number. In the following example, the first .apc generated would be called local-test_001.apc.

Normally, you click the Stop button in the ARM Streamline data view to stop a capture. Capturing data locally prohibits that method, so use one of the following options to terminate the capture:

Specify a duration using the duration attribute in session.xml.
Set the value of buffer_mode to something other than streaming.
Press Ctrl-C on the console to interrupt the daemon. The daemon must be running in the foreground.
Enter the kill process_id command to end the process.

When the capture stops, ARM Streamline creates an .apc directory on the target with the data and XML files. Transfer the directory to your host and open the .apc capture file in Eclipse for DS-5 to view the captured data in the ARM Streamline interface.

Example

Here is an example session.xml file:

<?xml version="1.0" encoding="US-ASCII" ?>
<session version="1" title="local-test" call_stack_unwinding="yes"
 buffer_mode="streaming" sample_rate="normal" target_path="@F_@N"
 duration="6"/>

To run gatord using this session file, enter the following in your shell:

./gatord session.xml

Summary

Streamline local capture provides the ability to obtain the capture data without a TCP/IP connection between Streamline and the target. Although not the normal use case, it permits analysis of a system that does not have, or cannot use, TCP/IP communication peripherals. By passing in an XML file as the parameter to gatord, you can control all the options of the tool, including the destination of the captured data.

Article last edited on: 2011-01-26 15:51:48

Rate this article

Disagree? Move your mouse over the bar and click

Did you find this article helpful? Yes No

How can we improve this article?

Link to this article

ARM Technical Support Knowledge Articles