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.
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.xmlfile defines your target hardware and the parameters of the capture session. For example:
streamline -capture session.xml
To create a
session.xmlfile, 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.xmlfile manually, see Capturing data on your target.
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.
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
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.
Displays the program version information.
Sends all output text to the specified file.
The following option is available only in capture mode:
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:
Outputs the contents of the Timeline, Call Paths, Functions, Stack, and Log views. This is the default option.
Outputs the data from the Timeline view.
Outputs the contents of the Functions view.
Outputs the contents of the Stack view.
Outputs the contents of the Log view.
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
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.