You copied the Doc URL to your clipboard.

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.

Syntax

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

streamline 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 60. A functions report generated using report mode

A functions report generated using report mode

streamline 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 option is available only in capture mode:

-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

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.

Figure 61. The call paths report on the command line

The call paths report on the command line

-function

Outputs the contents of the Functions view.

-stack

Outputs the contents of the Stack view.

-log

Outputs the contents of the Log view.

-bookmarks

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

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.

Outputting data to a file

The reports generated by Streamline can be very large. You can add an output file to the command to send the large quantities of data to a .txt file. For example:

streamline -report -timeline capture_001_001.apd > output.txt

This creates a file, output.txt, if it does not already exist, and outputs the data to the new file instead of the command window.

Figure 62. The Timeline view in a text file

The Timeline view in a text file

Was this page helpful? Yes No