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.

  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

  • 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 an .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 lis tof available views.

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

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

  6. Double-click on the Capture Data in the ARM Streamline Data View.

  7. Add images using the Add ELF Image... button in the Analyze dialog box.

  8. Click Analyze.

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" 
Was this page helpful? Yes No