|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
|
2 "http://www.w3.org/TR/html4/loose.dtd"> |
|
3 <html> |
|
4 <head> |
|
5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> |
|
6 <title>Using the Command-line</title> |
|
7 <link href="../../../book.css" rel="stylesheet" type="text/css"> |
|
8 </head> |
|
9 |
|
10 <body> |
|
11 <h2>Using the Command-line</h2> |
|
12 <p>Performance Investigator can be launched from the command line using <span class="code">eShell</span> or other device resident command-line tool to facilitate program testing. Using <span class="code">eShell</span>, you can start, stop, or perform timed actions on any application you want to profile. </p> |
|
13 <p align="center"><img src="images/cmd_line_eshell_example.png" width="267" height="109"></p> |
|
14 <p class="figure">Figure 1. eShell ready to start a 30-second timed Profiler session. </p> |
|
15 <p>Calls of the command line version of the Carbide.c++ Profiler have the following forms:</p> |
|
16 <p class="listing"> |
|
17 CProfApp_SISX start [<i>settings_file</i>]<br> |
|
18 CProfApp_SISX end [<i>settings_file</i>]<br> |
|
19 CProfApp_SISX timed <i>seconds</i> [<i>settings_file</i>]<br> |
|
20 CProfApp_SISX timed <i>settings_file</i> <i>seconds</i></p> |
|
21 <p>where:</p> |
|
22 <ul> |
|
23 <li><span class="code">start </span>— starts a Profiler session based on the settings file</li> |
|
24 <li><span class="code">end </span>— ends a Profiler session based on the settings file</li> |
|
25 <li><span class="code">timed </span>— starts a timed Profiler session based on the settings file</li> |
|
26 <li><i>settings_file</i> </span>— a file containing the session <a href="../settings.htm">settings</a>. The file name may be enclosed in double quote (") characters. If no settings file is specified, the default is <span class="code">C:\Data\CProfSettings.txt</span>.</li> |
|
27 <li><i>seconds</i> </span>— the decimal time in seconds for a timed Profiler session. It must be present for a timed session, and it must be greater than 0.</li> |
|
28 </ul> |
|
29 <p class="note"><b>NOTE</b> You can generate a valid configuration file by starting the Carbide.c++ Profiler GUI, selecting suitable settings, and then exiting the GUI. The settings file created is called <span class="code">C:\Data\CProfSettings.txt</span>.</p> |
|
30 <h5>Command examples</h5> |
|
31 <p>Starting and stopping a session:</p> |
|
32 <blockquote> |
|
33 <p class="listing"> cprofapp_sisx start c:\Data\cprofsettings.txt<br> |
|
34 cprofapp_sisx end c:\Data\cprofsettings.txt</p> |
|
35 </blockquote> |
|
36 <p>Executing a 30 second session:</p> |
|
37 <blockquote> |
|
38 <p class="listing"> cprofapp_sisx timed 30 c:\Data\cprofsettings.txt</p> |
|
39 </blockquote> |
|
40 <p><strong>Related references </strong></p> |
|
41 <ul> |
|
42 <li><a href="../settings.htm">Profiler Settings File </a></li> |
|
43 </ul> |
|
44 <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div> |
|
45 </body> |
|
46 </html> |