| |||
| Home > Using Streamline on the Command Line > 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.
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
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.
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, -?,
-helpOutputs help information to the console, listing each mode and option as well as the required syntax.
-v, -versionDisplays the program version information.
-o, -output <output>Sends all output text to the specified file.
The following options are unique to report mode:
-allOutputs the contents of the Timeline, Call Paths, Functions, Stack, and Log views. This is the default option.
-timelineOutputs the data from the Timeline view.
-callpathOutputs the contents of the table data of the Call Paths view. Subordinate functions are indented.
-functionOutputs the contents of the Functions view.
-stackOutputs the contents of the Stack view.
-logOutputs 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 Analysis
Report.threads_001_001.apd