Capture mode

Initiate a capture session.

Note

For Android, Arm recommends using the streamline_me.py script instead of this command. Refer to Generate a headless capture in the Arm Streamline Target Setup Guide for Android for more details.

You must specify a valid session.xml file for this mode. This file defines your target hardware and the parameters of the capture session.

To create a session.xml file, enter your settings in the Capture Settings dialog box then click Export....

Syntax

streamline-cli -capture [options] <session.xml>

Options

-c, -config <configuration.xml>

The path to the configuration file to send to the target.

-clean-gatord

Stop and restart gatord if gatord is already running on target.

-duration <seconds>

The number of seconds that you want the capture to last. The capture automatically terminates after that duration.

-e, -events <events.xml>

The path to your events.xml file.

-include-libs

Include the relevant libraries when retrieving images from the target.

-o, -output <filename>

The name of the APC capture file to create.

-package <package_name> [-activity <activity name>] [-activity-args <arguments>]

Use with Android targets to specify the package to capture. Use -activity to specify the main activity to be launched. If -activity is not specified, the main activity from the package is used. If there is no activity or multiple main activities in the package, the capture will not be started. -activity-args Launch the activity with the specified arguments passed to the activity manager (am). The arguments must be provided as a single string.

-password <string>

The password to use when retrieving images from the target.

-p, -pmus <pmus.xml>

The path to your pmus.xml file.

-retrieve-image <regex>

A regular expression to match the processes to retrieve from the target.

-template <name_or_path>

The template to apply. Streamline searches each template in the following order:

  1. In the built-in templates.

  2. In the Templates directory.

  3. As a file path (*.st).

You can apply more than one -template option. To create a chart configuration template, see Create a chart configuration template.

-username <string>

The username to use when retrieving images from the target.

Returns

An APC capture file.

Example: 60 second capture session

Initiate a capture session that lasts for 60 seconds with the following command:

streamline-cli -capture -duration 60 session.xml