15.2 Streamline command line options

The streamline command has three different modes that enable you to use most features of Streamline outside of the DS-5 for Eclipse user interface.

Streamline command line modes

The streamline command is called in a Streamline-enabled shell using the following syntax: streamline <mode> [options] <file...>

Use any of the following modes directly after streamline on the command line:

Mode

Description

-capture

This mode initiates a capture session. You must enter a valid session.xml file with the capture mode declaration. The session.xml file defines your target hardware and the parameters of the capture session. For example:

streamline -capture session.xml

To create a session.xml file, enter your settings and then use the Export... option in the Capture Options dialog box within DS-5 for Eclipse.

-analyze

Use this mode to analyze existing Capture Data. You must enter a valid .apc capture file after -analyze. For example:

streamline -analyze threads_001.apc

-report

This mode reads data from an analysis report and outputs it your console. You can use options to define how that data appears in the console or define an output file to store the data to disk. You must enter a valid .apd file after the declaration of report mode. For example:

streamline -report threads_001_001.apd

Figure 15-1 A functions report generated using report mode

A functions report generated using report mode

Options common to every mode

Enter any option between the mode and file. The following options are available in any mode:

Mode

Description

-h, -?, -help

Outputs help information to the console, listing each mode and option as well as the required syntax.

-v, -version

Displays the program version information.

-o, -output, <output>

In capture mode, output defines the name of the capture file. In analyze mode, it defines the name of the Analysis Report and in report mode, it sends all output text to the specified file.

Capture mode option

The following option is available only in capture mode:

Mode

Description

-duration <seconds>

Use the duration option with capture mode to set a maximum length for the capture session. Enter the option with a the number of seconds that you want the capture to last. The capture automatically terminates when it reaches that length. For example, the following command triggers a 60 second capture session:

streamline -capture -duration 60 session.xml

Report mode options

The following options are unique to report mode:

Mode

Description

-all

Outputs the contents of the Timeline, Call Paths, Functions, Stack, and Log views. This is the default option.

-callpath

Outputs the contents of the table data of the Call Paths view. Subordinate functions are indented.

-function

Outputs the contents of the Functions view.

-stack

Outputs the contents of the Stack view.

-log

Outputs the contents of the Log view.

-timeline

Outputs the contents of the Timeline view.

-bookmarks

Outputs all bookmarks stored in an Analysis Report, listing the time index location of the bookmark and its text.

-template

Use this option with the location of a valid chart configuration file to list your customized charts on the command line. Use the Export snippet configuration to a file button in the Snippet menu of the Timeline view to create a valid configuration, then use that file with the -template option.

-per_cluster

When used with the -timeline option, this option forces Streamline to output per-cluster data. By default, it outputs aggregated data.

-per_core

Outputs per-core data when used with the -timeline option.

-start <seconds>

Filters output data to start at the specified time within the timeline. For example if you enter 0.005 with the start option, all data before the 5 millisecond mark is not included in the output.

-stop <seconds>

Filters output data to stop at the specified time within the timeline.

-bstart <name>

Filter the data to start at the first bookmark with the provided name. For example, if you enter -bstart redflag, all data before the first the first instance of the bookmark title redflag is filtered from the output.

-bstop <seconds>

Filter the data to end at the first bookmark with the provided name.

-format <space|tab|csv>

Use this option to specify the format of the output. Format the tables using spaces, tabs or comma-separated values. This can be useful if you want to easily convert output text files to your favorite spreadsheet program. The default format is spaces, making the tables easy to read when printed on the command line.

You can define multiple reports types using these options. For example, enter streamline -report -callpath -function thread_001_001.apd to output only the Call Paths and Functions data from the threads_001_001.apd Analysis Report.

Related tasks
Opening a Streamline-enabled command prompt or shell
Outputting command line data to a file
Non-ConfidentialPDF file icon PDF versionARM DUI0482M
Copyright © 2010-2013 ARM. All rights reserved.