You copied the Doc URL to your clipboard.

Capturing data on your target

Typically, ARM Streamline uses an active network connection to send captured data from the target to the host. 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.

To capture data locally:

  1. Create a session.xml file. For an example session.xml file, see the end of this topic.

  2. Make sure to replace the output_path variable in session.xml with target_path. This ensures that Streamline saves the capture data locally. The session.xml example at the end of this topic includes the target_path declaration.

  3. To pass the new session.xml file as a parameter to gatord on the command line, enter: ./gatord session.xml &


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 Streamline Capture Data generated would be called local-test_001.apc.

Normally, you can click the Stop button in the ARM Streamline Data view to stop a capture. Capturing data locally prohibits this method because you are not connecting to your target using the interface of Streamline. Use one of the following options to terminate the capture:

  • Specify a duration using the duration attribute in session.xml.

  • In session.xml, set the value of the buffer_mode variable to something other than streaming. Use one of the following values: Large, Normal, or Small. A Large store-and-forward buffer is 16MB, while Normal is 4MB and Small is 1MB. The profiling session terminates automatically when it reaches the set buffer size.

  • Press Ctrl+C on the console to interrupt the gator daemon. The daemon must be running in the foreground.

  • Determine the process id of gatord and enter the kill command: kill process_ID.

When the capture stops, Streamline creates a .apc directory on the target with the data and .xml files. To view your Capture Data in Eclipse for DS-5, do the following:

  1. Transfer the directory to your host.

  2. Open Eclipse for DS-5.

  3. If the ARM Streamline Data view is not already open, select Window → Show View → Other and choose ARM Streamline Data from the list of available views.

  4. Click the Edit Locations... button in the upper right of the ARM Streamline Data View.

  5. Choose the directory that contains the .apc directory that you transferred from your target.

  6. Double-click on the .apc directory in the ARM Streamline Data view to open the Analyze dialog box.

  7. Define your image files using the Analyze dialog box. Image files must match the images that you ran on your target during the local capture session.


    For more information on using a stored capture session to generate a new Streamline Analysis Report, see Using Stored Streamline Capture Data to create new Streamline Analysis Reports.

  8. Click Analyze.

  9. Double-click on the Streamline Analysis Report in the ARM Streamline Data View.


You can also use the .apc capture directory to create a new analysis report. Double-click on the .apc directory in the ARM Streamline Data view to open the Analyze dialog box.

Example session.xml

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