The streamline command

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.

Show/hideSyntax

streamline <mode> [options] <file...>

Show/hidestreamline command modes

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

-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 desired settings and then use the Export... option in the Capture Options dialog box within DS-5 for Eclipse. For instructions on how to create a session.xml file manually, see Capturing data on your target.

-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

For more information on the analyze feature, see Using Stored Streamline Capture Data to create new Streamline Analysis Reports.

-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.

streamline -report threads_001_001.apd

Figure 53. The report mode

The report mode

Show/hidestreamline command options

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

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

Sends all output text to the specified file.

The following options are unique to report mode:

-all

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

-timeline

Outputs the data from the Timeline view.

-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.

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.

Show/hideSee also

Copyright © 2010-2011 ARM. All rights reserved.ARM DUI 0482F
Non-ConfidentialID111711