c_ls.htm

mips架构的bootloader,99左右的版本 但源代码现在没人更新了

<title>The ls Command</title>
<h1>ls</h1>

<!--INDEX "ls command" "list symbols" -->


The ls command lists the current symbols in the symbol table. <p>

</dl><h2>Format</h2><dl><dd>

The format for the ls command is:<p>

<pre>
	ls [-ln] [<var>sym</var>|[-[v|a] <var>adr</var>]
</pre><p>

where:<p>

<table><tr><td valign=top>
-l	</td><td>provides a long listing, showing the address value for each 
	symbol.

</td></tr><tr><td valign=top>
-n	</td><td>lists the symbols in ascending order of address.

</td></tr><tr><td valign=top>
<var>sym</var>	</td><td>is a pattern filter for the symbols to be shown. Both character 
	wildcards ("?") and word wildcards ("*") are permitted.

</td></tr><tr><td valign=top>
-v	</td><td>is the verbose option, showing the value in hexadecimal, 
	decimal, and octal.

</td></tr><tr><td valign=top>
-a	</td><td>shows the address in symbolic form.

</td></tr><tr><td valign=top>
<var>adr</var>	</td><td>is the address for which a symbol or offset from a symbol is 
	sought.
</td></tr></table><p>

Invoking the ls command without any options or parameters lists the 
symbols in alphabetical order without displaying the actual address 
for each symbol.<p>

</dl><h2>Functional Description</h2><dl><dd>

The ls command lists the symbols in the symbol table.<p>

The -l option produces a long listing, which includes the address value of 
each symbol. The -n option causes the symbols to be listed in ascending 
order of address. The -a adr option lists the symbol at the next lowest 
address. The -v adr option prints the result in hex, decimal, and octal. The 
-v option is useful for computing the value of an expression that may 
include registers, symbols, and absolute values. <p>

Examples illustrating the use of the ls command follow.<p>

<table><tr><td width=600><tt>
PMON> ls	<br>
flush_cache   start
</tt></td><td valign=top>
List symbols in alphabetic order.

</td></tr><tr><td><tt>
PMON> ls -l	<br>
9fc016f0 flush_cache <br>
9fc00240 start
</tt></td><td valign=top>
List symbols in alphabetic order with addresses. 

</td></tr><tr><td><tt>
PMON> ls -ln	<br>
9fc00240 start<br>
9fc016f0 flush_cache
</tt></td><td valign=top>
List symbols and addresses in ascending order of address.

</td></tr><tr><td><tt>
PMON> ls s*	<br>
start<br>
</tt></td><td valign=top>
List symbols starting with the letter "s."

</td></tr><tr><td><tt>
PMON> ls -a 9fc00260	<br>
9fc00240 start+0x20<br>
</tt></td><td valign=top>
List symbol at the next lowest address.

</td></tr><tr><td><tt>
PMON> ls -a @epc	<br>
a0020020 = start+0x20<br>
</tt></td><td valign=top>
List symbol at the next lowest address from EPC.

</td></tr><tr><td><tt>
PMON> ls -v @t0+0t10*4	<br>
0x800222e8 = 0t-2147343640 = 0o20000421350<br>
</tt></td><td valign=top>
Display the value of the expression "@t0+0t10*4":

</td></tr></table><p>

</dl><p><hr>
<b>Navigation:</b> 
<a href="index.htm">Document Home</a> | 
<a href="doctoc.htm">Document Contents</a> | 
<a href="docindex.htm">Document Index</a> <p>