redboot_cmds.sgml

来自「ecos实时嵌入式操作系统」· SGML 代码 · 共 1,934 行 · 第 1/5 页

	  <colspec colname="c4">
	  <thead>
	    <row>
	      <entry>Name</entry>
	      <entry>Type</entry>
	      <entry>Description</entry>
	      <entry>Default</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry>on</entry>	     
	      <entry></entry>
	      <entry>Turn the caches on</entry>	     
	      <entry><emphasis>none</emphasis></entry>	     
	    </row>
	    <row>
	      <entry>off</entry>	     
	      <entry></entry>
	      <entry>Turn the caches off</entry>	     
	      <entry><emphasis>none</emphasis></entry>	     
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </refsect1>
    <refsect1>
      <title>Description</title>
      <para>The <command>cache</command> command is used to manipulate the caches on the processor. </para>
      <para>With no options, this command specifies the state of the system caches.</para>
      <para>When an option is given, the caches are turned off or on appropriately.</para>
    </refsect1>
    <refsect1>
      <title>Examples</title>
      <para>
Show the current cache state.
<screen> 
RedBoot> <userinput>cache</userinput>
Data cache: On, Instruction cache: On
</screen> 
</para>
<para>
Disable the caches.
<screen> 
RedBoot> <userinput>cache off</userinput>
RedBoot> <userinput>cache</userinput>
Data cache: Off, Instruction cache: Off
</screen> 
</para>
<para>
Enable the caches.
<screen> 
RedBoot> <userinput>cache on</userinput>
RedBoot> <userinput>cache</userinput>
Data cache: On, Instruction cache: On
</screen> 
      </para>
    </refsect1>
  </refentry>

<!-- ******** channel *************************************************** -->
  <refentry id="channel-command">
    <refnamediv>
      <refname>channel</refname>
      <refpurpose>Select the system console channel</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>channel</command>
	<group>
	  <arg>-1</arg>
	  <arg><replaceable>channel_number</replaceable></arg>
	</group>
      </cmdsynopsis>
    </refsynopsisdiv>
    <refsect1>
      <title>Arguments</title>
      <informaltable frame="all">
	<tgroup cols="4" colsep="1" rowsep="1" align="left">
	  <colspec colname="c1">
	  <colspec colname="c2">
	  <colspec colname="c3">
	  <colspec colname="c4">
	  <thead>
	    <row>
	      <entry>Name</entry>
	      <entry>Type</entry>
	      <entry>Description</entry>
	      <entry>Default</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry>-1</entry>	     
	      <entry></entry>
	      <entry>Reset the console channel</entry>	     
	      <entry><emphasis>none</emphasis></entry>	     
	    </row>
	    <row>
	      <entry>channel_number</entry>	     
	      <entry>Number</entry>
	      <entry>Select a channel</entry>	     
	      <entry><emphasis>none</emphasis></entry>	     
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </refsect1>
    <refsect1>
      <title>Description</title>
      <para>
With no arguments, the <command>channel</command> command displays the current console channel number.
</para><para>
When passed an argument of 0 upward, this command switches the console
channel to that channel number. The mapping between channel numbers and
physical channels is platform specific but will typically be something like
channel 0 is the first serial port, channel 1 is the second, etc.
</para><para>
When passed an argument of -1, this command reverts RedBoot to responding
to whatever channel receives input first, as happens when RedBoot initially
starts execution.
</para>
    </refsect1>
    <refsect1>
      <title>Examples</title>
      <para>
Show the current channel.
<screen> 
RedBoot> <userinput>channel</userinput>
Current console channel id: 0
</screen> 
</para>
<para>
Change to an invalid channel.
<screen> 
RedBoot> <userinput>channel 99</userinput>
**Error: bad channel number '99'
</screen> 
</para>
<para>
Revert to the default channel setting (any console mode).
<screen> 
RedBoot> <userinput>channel -1</userinput>
</screen> 
      </para>
    </refsect1>
  </refentry>

<!-- ******** cksum *************************************************** -->
  <refentry id="cksum-command">
    <refnamediv>
      <refname>cksum</refname>
      <refpurpose>Compute POSIX checksums</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>cksum</command>
	    <arg choice="req">-b <replaceable>location</replaceable></arg>
	    <arg choice="req">-l <replaceable>length</replaceable></arg>
      </cmdsynopsis>
    </refsynopsisdiv>
    <refsect1>
      <title>Arguments</title>
      <informaltable frame="all">
	<tgroup cols="4" colsep="1" rowsep="1" align="left">
	  <colspec colname="c1">
	  <colspec colname="c2">
	  <colspec colname="c3">
	  <colspec colname="c4">
	  <thead>
	    <row>
	      <entry>Name</entry>
	      <entry>Type</entry>
	      <entry>Description</entry>
	      <entry>Default</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry>-b <replaceable>location</replaceable></entry>	     
	      <entry>Memory address</entry>
	      <entry>Location in memory for stat of data.</entry>	     
	      <entry><emphasis>none</emphasis></entry>	     
	    </row>
	    <row>
	      <entry>-l <replaceable>length</replaceable></entry>	     
	      <entry>Number</entry>
	      <entry>Length of data</entry>	     
	      <entry><emphasis>none</emphasis></entry>	     
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </refsect1>
    <refsect1>
      <title>Description</title>
	  <para>Computes the POSIX checksum on a range of memory (either RAM or FLASH).
The values printed (decimal cksum, decimal length, hexadecimal cksum,
	  hexadecimal length) can be compared with the output from the Linux program 'cksum'.
</para>
    </refsect1>
    <refsect1>
      <title>Examples</title>
      <para>
Checksum a buffer.
<screen> 
RedBoot> <userinput>cksum -b 0x100000 -l 0x100</userinput>
POSIX cksum = 3286483632 256 (0xc3e3c2b0 0x00000100)
</screen> 
      </para>
      <para>
Checksum an area of memory after loading a file. Note that the base
address and length parameters are provided by the preceding
load command.
<screen> 
RedBoot> <userinput>load -r -b %{FREEMEMLO} redboot.bin</userinput>
Raw file loaded 0x06012800-0x0602f0a8
RedBoot> <userinput>cksum</userinput>
Computing cksum for area 0x06012800-0x0602f0a8
POSIX cksum = 2092197813 116904 (0x7cb467b5 0x0001c8a8)
</screen> 
      </para>
    </refsect1>
  </refentry>

<!-- ******** disks *************************************************** -->
  <refentry id="disks-command">
    <refnamediv>
      <refname>disks</refname>
      <refpurpose>List available disk partitions.</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>disks</command>
      </cmdsynopsis>
    </refsynopsisdiv>
    <refsect1>
      <title>Arguments</title>
<para>None.</para>
    </refsect1>
    <refsect1>
      <title>Description</title>
	<para>The <command>disks</command> command is used to list disk partitions recognized by RedBoot.</para>
    </refsect1>
    <refsect1>
      <title>Examples</title>
      <para>
Show what disk partitions are available.
<screen> 
RedBoot> <userinput>disks</userinput>
hda1     Linux Swap
hda2     Linux
00100000: 00 3E 00 06 00 06 00 06  00 00 00 00 00 00 00 00  |.>..............|
00100010: 00 00 00 78 00 70 00 60  00 60 00 60 00 60 00 60  |...x.p.`.`.`.`.`|
</screen> 
      </para>
    </refsect1>
  </refentry>

<!-- ******** dump *************************************************** -->
  <refentry id="dump-command">
    <refnamediv>
      <refname>dump</refname>
      <refpurpose>Display memory.</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>dump</command>
	    <arg choice="req">-b <replaceable>location</replaceable></arg>
	    <arg>-l <replaceable>length</replaceable></arg>
	    <arg>-s</arg>
	  <group>
	    <arg>-1</arg>
	    <arg>-2</arg>
	    <arg>-4</arg>
	  </group>
      </cmdsynopsis>
    </refsynopsisdiv>
    <refsect1>
      <title>Arguments</title>
      <informaltable frame="all">
	<tgroup cols="4" colsep="1" rowsep="1" align="left">
	  <colspec colname="c1">
	  <colspec colname="c2">
	  <colspec colname="c3">
	  <colspec colname="c4">
	  <thead>
	    <row>
	      <entry>Name</entry>
	      <entry>Type</entry>
	      <entry>Description</entry>
	      <entry>Default</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry>-b <replaceable>location</replaceable></entry>	     
	      <entry>Memory address</entry>
	      <entry>Location in memory for start of data.</entry>	     
	      <entry><emphasis>none</emphasis></entry>	     
	    </row>
	    <row>
	      <entry>-l <replaceable>length</replaceable></entry>	     
	      <entry>Number</entry>
	      <entry>Length of data</entry>	     
	      <entry>32</entry>	     
	    </row>
	    <row>
	      <entry>-s</entry>	     
	      <entry>Boolean</entry>
	      <entry>Format data using Motorola S-records.</entry>	     
	      <entry></entry>	     
	    </row>
	    <row>
	      <entry>-1</entry>	     
	      <entry></entry>
	      <entry>Access one byte (8 bits) at a time.  
Only the least significant 8 bits of the pattern will be used.</entry>	     
	      <entry>-1</entry>	     
	    </row>
	    <row>
	      <entry>-2</entry>	     
	      <entry></entry>
	      <entry>Access two bytes (16 bits) at a time.  
Only the least significant 16 bits of the pattern will be used.</entry>	     
	      <entry>-1</entry>	     
	    </row>
	    <row>
	      <entry>-4</entry>	     
	      <entry></entry>
	      <entry>Access one word (32 bits) at a time.</entry>	     
	      <entry>-1</entry>	     
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </refsect1>
    <refsect1>
      <title>Description</title>
	<para>Display a range of memory on the system console.</para>
	<para>The <command>x</command> is a synonym for <command>dump</command>.</para>
        <para>Note that this command could
be detrimental if used on memory mapped hardware registers. </para>
        <para>The memory is displayed at most sixteen bytes per line, first as the
raw hex value, followed by an ASCII interpretation of the data. </para>
    </refsect1>
    <refsect1>
      <title>Examples</title>
      <para>
Display a buffer, one byte at a time.
<screen> 
RedBoot> <userinput>mfill -b 0x100000 -l 0x20 -p 0xDEADFACE</userinput>
RedBoot> <userinput>x -b 0x100000</userinput>
00100000: CE FA AD DE CE FA AD DE  CE FA AD DE CE FA AD DE  |................|
00100010: CE FA AD DE CE FA AD DE  CE FA AD DE CE FA AD DE  |................|
</screen> 
</para>
<para>
Display a buffer, one short (16 bit) word at a time.  Note in this case that
the ASCII interpretation is suppressed.
<screen> 
RedBoot> <userinput>dump -b 0x100000 -2</userinput>
00100000: FACE DEAD FACE DEAD  FACE DEAD FACE DEAD 
00100010: FACE DEAD FACE DEAD  FACE DEAD FACE DEAD 
</screen> 
</para>
<para>
Display a buffer, one word (32 bit) word at a time.  Note in this case that
the ASCII interpretation is suppressed.
<screen> 
RedBoot> <userinput>dump -b 0x100000 -4</userinput>
00100000: DEADFACE DEADFACE DEADFACE DEADFACE 
00100010: DEADFACE DEADFACE DEADFACE DEADFACE 
</screen> 
</para>
<para>
Display the same buffer, using Motorola S-record format.
<screen> 
RedBoot> <userinput>dump -b 0x100000 -s</userinput>
S31500100000CEFAADDECEFAADDECEFAADDECEFAADDE8E
S31500100010CEFAADDECEFAADDECEFAADDECEFAADDE7E
</screen> 
</para>
<para>
Display a buffer, with visible ASCII strings.
<screen> 
RedBoot> <userinput>d -b 0xfe00b000 -l 0x80</userinput>