comman74.htm

ST20 Embedded Toolset R2.0.5用于开发基于ST20芯片机顶盒软件的开发平台,2.0.5版本,国内找不到的.在国外论坛上花了N天才找到!

<dl><dl>    <dl>
      <dt> <a name="1230220"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">Delete the program</font>
    </dl>
</dl></dl>
<p>
  <a name="1230222"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-u[pdate]</strong></font></b></font>
<br>

<dl><dl>    <dl>
      <dt> <a name="1237048"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">Reload debugging information into the debugger from the (possibly modified) debug file.</font>
    </dl>
</dl></dl>
<p>
  <a name="1237056"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-current </strong></font><font size=2 face=Courier><strong><em>[programid]</em></strong></font></b></font>
<br>

<dl><dl>    <dl>
      <dt> <a name="1263200"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">Specify the current program as <font size=2 face=Courier><strong><em>programid</em></strong></font> or the filename given in the <font  face="Verdana, Arial, Helvetica, sans-serif"><b>dbg</b></font> option or the <font size=2 face=Courier><strong><em>key</em></strong></font> in the <font size=2 face=Courier><strong>uid</strong></font> option.</font>
    </dl>
</dl></dl>
<p>
  <a name="1263201"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-disable </strong></font><font size=2 face=Courier><strong><em>[programid]</em></strong></font></b></font>
<br>

<dl><dl>    <dl>
      <dt> <a name="1237086"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">Disable a program</font>
    </dl>
</dl></dl>
<p>
  <a name="1237080"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-enable	 </strong></font><font size=2 face=Courier><strong><em>[programid]</em></strong></font></b></font>
<br>

<dl><dl>    <dl>
      <dt> <a name="1237082"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">Enable a program</font>
    </dl>
</dl></dl>
<p>
  <a name="1237076"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-dbg </strong></font><font size=2 face=Courier><strong><em>filename</em></strong></font></b></font>
<br>

<dl><dl>    <dl>
      <dt> <a name="1237078"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">Specify a <font size=2 face=Courier><strong>.dbg</strong></font> file for use with <font  face="Verdana, Arial, Helvetica, sans-serif"><b>current</b></font>, <font size=2 face=Courier><strong>enable</strong></font> and <font  face="Verdana, Arial, Helvetica, sans-serif"><b>disable</b></font> options</font>
    </dl>
</dl></dl>
<p>
  <a name="1237072"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-uid </strong></font><font size=2 face=Courier><strong><em>key</em></strong></font></b></font>
<br>

<dl><dl>    <dl>
      <dt> <a name="1237074"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">Specify a unique ID for use with <font  face="Verdana, Arial, Helvetica, sans-serif"><b>current</b></font>, <font size=2 face=Courier><strong>enable</strong></font> and <font  face="Verdana, Arial, Helvetica, sans-serif"><b>disable</b></font> options</font>
    </dl>
</dl></dl>
<p>
  <a name="1237140"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-detail </strong></font><font size=2 face=Courier><strong><em>[programid]</em></strong></font></b></font>
<br>


<p>
  <a name="1237068"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif"><b></b></font>
<br>

<dl><dl>    <dl>
      <dt> <a name="1237070"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">When listing programs, show whether a program is enabled or disabled and show its program <font size=2 face=Courier><strong><em>key</em></strong></font></font>
    </dl>
</dl></dl>
<h3>
  <a name="1207380"> </a><font color="#003366"  face="Verdana, Arial, Helvetica, sans-serif">Debugger context</font>
</h3>


<p>
  <a name="1207381"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">The <font size=2 face=Courier><strong>programid</strong></font> from the debugger context specifies the program the command applies to.</font>
</p>


<h3>
  <a name="1207382"> </a><font color="#003366"  face="Verdana, Arial, Helvetica, sans-serif">Returns</font>
</h3>


<p>
  <a name="1207383"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">The program identifier</font>
</p>


<h3>
  <a name="1207384"> </a><font color="#003366"  face="Verdana, Arial, Helvetica, sans-serif">Description</font>
</h3>


<p>
  <a name="1207385"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">The command <font size=2 face=Courier><strong>program</strong></font> displays information about the program specified with the supplied <font size=2 face=Courier><strong><em>programid</em></strong></font>, or the program specified in the debugger context if a <font size=2 face=Courier><strong><em>programid</em></strong></font> is not supplied. The <font  face="Verdana, Arial, Helvetica, sans-serif"><b>n[ew]</b></font> option loads symbolic debug information from the <font size=2 face=Courier><strong>.dbg</strong></font> filename. If the <font size=2 face=Courier><strong>.dbg</strong></font> file corresponds to a relocatable code unit (RCU) file then the <font size=2 face=Courier><strong>code</strong></font>, <font  face="Verdana, Arial, Helvetica, sans-serif"><b>data</b></font> and <font  face="Verdana, Arial, Helvetica, sans-serif"><b>bss</b></font> options should be supplied. The <font  face="Verdana, Arial, Helvetica, sans-serif"><b>d[elete]</b></font> option removes a program from the debugger. The <font size=2 face=Courier><strong>update</strong></font> option updates a program from its <font size=2 face=Courier><strong>.dbg</strong></font> file. The <font  face="Verdana, Arial, Helvetica, sans-serif"><b>a[ll]</b></font> option can be used to delete or update all programs the debugger knows about.</font>
</p>


<p>
  <a name="1247596"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">The options <font  face="Verdana, Arial, Helvetica, sans-serif"><b>current</b></font>, <font  face="Verdana, Arial, Helvetica, sans-serif"><b>disable</b></font> and <font  face="Verdana, Arial, Helvetica, sans-serif"><b>enable</b></font> specify a <strong>current</strong> program, disable a program and enable a program respectively. These options may either take a <font size=2 face=Courier><strong><em>programid</em></strong></font>, or may be used in conjunction with the <font  face="Verdana, Arial, Helvetica, sans-serif"><b>dbg</b></font> or <font  face="Verdana, Arial, Helvetica, sans-serif"><b>uid</b></font> options. The current program is searched first when looking for symbolic information. Disabled programs are not searched when looking for symbolic information.</font>
</p>


<p>
  <a name="1247598"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">The <font  face="Verdana, Arial, Helvetica, sans-serif"><b>dbg</b></font> option is used to specify the filename of a <font size=2 face=Courier><strong>.dbg</strong></font> file with the <font  face="Verdana, Arial, Helvetica, sans-serif"><b>current</b></font>, <font size=2 face=Courier><strong>disable</strong></font> and <font  face="Verdana, Arial, Helvetica, sans-serif"><b>enable</b></font> options. The <font  face="Verdana, Arial, Helvetica, sans-serif"><b>uid</b></font> option is used to specify a unique key to the <font  face="Verdana, Arial, Helvetica, sans-serif"><b>current</b></font>, <font size=2 face=Courier><strong>disable</strong></font> and <font  face="Verdana, Arial, Helvetica, sans-serif"><b>enable</b></font> options. A 32-bit unique key is generated by the linker for every program and this key is placed in a global integer in the application program with the name <font size=2 face=Courier><strong><em>_ST_ProgramIdentifier.</em></strong></font> The value specified with <font  face="Verdana, Arial, Helvetica, sans-serif"><b>uid</b></font> is compared with the contents of the variable <font size=2 face=Courier><strong><em>_ST_ProgramIdentifier</em></strong></font> for each program on the debugger's program list.</font>
</p>


<p>
  <a name="1207388"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">The <font  face="Verdana, Arial, Helvetica, sans-serif"><b>detail</b></font> option may be used with a <font size=2 face=Courier><strong><em>programid</em></strong></font> or with <font  face="Verdana, Arial, Helvetica, sans-serif"><b>a[ll]</b></font> to display the enable/disable status of a program and to extract the value of <font size=2 face=Courier><strong>_ST_ProgramIdentifier</strong></font>.</font>
</p>


<p>
  <a name="1242015"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><em>Note:	 If this symbol is not referenced by target code, it will not be present in the final linked output; linked units will not contain this symbol unless it is explicitly referenced by the application.</em></font>
</p>

<h3>
  <a name="1207389"> </a><font color="#003366"  face="Verdana, Arial, Helvetica, sans-serif">Example</font>
</h3>


<a name="1207390"> </a><font size=2 face=Courier><strong>&gt;program -a<br>program 0 hello.lku<br>program 1 fubar.lku<br>&gt;program -n hello.dbg<br>&gt;program -d 1<br></strong></font>



<p>
  <a name="1207396"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif">This examples lists all programs, adds a new program and deletes program 1 from the debugger.</font>
</p>


<h3>
  <a name="1207397"> </a><font color="#003366"  face="Verdana, Arial, Helvetica, sans-serif">See also</font>
</h3>


<p>
  <a name="1207398"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif"><a href="comman19.htm#1205212"><font  color="#0000ff" face="Verdana, Arial, Helvetica, sans-serif"><i>context</i></font></a>,</font>
</p>


<p>
  <a name="1207402"> </a><font size=2  face="Verdana, Arial, Helvetica, sans-serif"><a href="rom.htm#1204413"><font  color="#0000ff" face="Verdana, Arial, Helvetica, sans-serif"><i>Chapter