ARM Technical Support Knowledge Articles

How do I use local capture with ARM Streamline?

Applies to: DS-5


Usually ARM Streamline sends captured data from the target to the host using a network connection. However, if this is not possible because of the limitations of 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.  After running Streamline for some time, you then stop the capture and transfer the generated .apc file from your target to your host.

Please note: The target will need to have a configurations.xml file present where gatord is installed.

session.xml file

If you are using Eclipse for DS-5 5.12 or earlier:

You will need to manually create a session.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 is local-test_001.apc.

Below 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"

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

./gatord session.xml

If you are using Eclipse for DS-5 version 5.13 or later:

You can use the Capture & Analysis Options dialog box to set your capture options, then click the Export... button to save the new session.xml file instead of creating one manually.

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

./gatord -s session.xml_location/session.xml -o YourFileName.apc &

The -s option defines the location of session.xml, while the -o option defines the name and location of the resulting .apc output file.

Stopping the capture

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:

  1. Specify a duration using the duration attribute in session.xml.
  2. Set the value of buffer_mode to something other than streaming.
  3. Press Ctrl-C on the console to interrupt the daemon. The daemon must be running in the foreground.
  4. 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.


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.

Article last edited on: 2014-03-24 14:32:09

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
Copyright © 2011 ARM Limited. All rights reserved. External (Open), Non-Confidential