You copied the Doc URL to your clipboard.

Streamline command-line options

The streamline command has 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:




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 & Analysis Options dialog box within DS-5 for Eclipse.


This mode reads data from a capture 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 .apc file after the declaration of report mode. For example:

streamline -report threads_001.apc

Figure 14-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:



-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, defines the name of the capture file.

Capture mode option

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

Report mode options

The following options are unique to report mode:




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


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


Outputs the contents of the Functions view.


Outputs the contents of the Log view.


Outputs the contents of the Timeline view.


Outputs the contents of the OpenCL table.


To export OpenCL data, the report must contain OpenCL annotations.

Outputs all bookmarks stored in a capture, listing the time index location of the bookmark and its text.


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.


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


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.apc to output only the Call Paths and Functions data from the thread_001.apc capture.

Was this page helpful? Yes No