redboot_cmds.sgml

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

0xFE00B000: 20 25 70 0A 00 00 00 00  41 74 74 65 6D 70 74 20 | %p.....Attempt |
0xFE00B010: 74 6F 20 6C 6F 61 64 20  53 2D 72 65 63 6F 72 64 |to load S-record|
0xFE00B020: 20 64 61 74 61 20 74 6F  20 61 64 64 72 65 73 73 | data to address|
0xFE00B030: 3A 20 25 70 20 5B 6E 6F  74 20 69 6E 20 52 41 4D |: %p [not in RAM|
0xFE00B040: 5D 0A 00 00 2A 2A 2A 20  57 61 72 6E 69 6E 67 21 |]...*** Warning!|
0xFE00B050: 20 43 68 65 63 6B 73 75  6D 20 66 61 69 6C 75 72 | Checksum failur|
0xFE00B060: 65 20 2D 20 41 64 64 72  3A 20 25 6C 78 2C 20 25 |e - Addr: %lx, %|
0xFE00B070: 30 32 6C 58 20 3C 3E 20  25 30 32 6C 58 0A 00 00 |02lX <> %02lX...|
0xFE00B080: 45 6E 74 72 79 20 70 6F  69 6E 74 3A 20 25 70 2C |Entry point: %p,|
</screen> 
      </para>
    </refsect1>
  </refentry>

<!-- ******** help *************************************************** -->
  <refentry id="help-command">
    <refnamediv>
      <refname>help</refname>
      <refpurpose>Display help on available commands</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>help</command>
	<arg><replaceable> topic</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><replaceable>topic</replaceable></entry>	     
	      <entry>String</entry>
	      <entry>Which command to provide help for.</entry>	     
	      <entry>All commands</entry>	     
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </refsect1>
    <refsect1>
      <title>Description</title>
      <para>
The <command>help</command> command displays information about the available
RedBoot commands.  If a <emphasis>topic</emphasis> is given, then the display
is restricted to information about that specific command.
      </para>
      <para>
If the command has sub-commands, e.g. <command>fis</command>, then the topic
specific display will print additional information about the available sub-commands.
special (ICMP) packets to a specific host. These packets should be automatically
returned by that host. The command will indicate how many of these round-trips
were successfully completed. 
      </para>
    </refsect1>
    <refsect1>
      <title>Examples</title>
      <para>
Show generic help.  Note that the contents of this display will depend on the various configuration
options for RedBoot when it was built.
<screen>
RedBoot> <userinput>help</userinput>
Manage aliases kept in FLASH memory
   alias name [value]
Manage machine caches
   cache [ON | OFF]
Display/switch console channel
   channel [-1|&lt;channel number&gt;]
Compute a 32bit checksum [POSIX algorithm] for a range of memory
   cksum -b &lt;location&gt; -l &lt;length&gt;
Display (hex dump) a range of memory
   dump -b &lt;location&gt; [-l &lt;length&gt;] [-s] [-1|2|4]
Manage FLASH images
   fis {cmds}
Manage configuration kept in FLASH memory
   fconfig [-i] [-l] [-n] [-f] [-d] | [-d] nickname [value]
Execute code at a location
   go [-w &lt;timeout&gt;] [entry]
Help about help?
   help [&lt;topic&gt;]
Set/change IP addresses
   ip_address [-l &lt;local_ip_address&gt;] [-h &lt;server_address&gt;]
Load a file
   load [-r] [-v] [-d] [-h &lt;host&gt;] [-m {TFTP | HTTP | {x|y}MODEM -c &lt;channel_number&gt;}]
        [-b &lt;base_address&gt;] &lt;file_name&gt;
Compare two blocks of memory
   mcmp -s &lt;location&gt; -d &lt;location&gt; -l &lt;length&gt; [-1|-2|-4]
Fill a block of memory with a pattern
   mfill -b &lt;location&gt; -l &lt;length&gt; -p &lt;pattern&gt; [-1|-2|-4]
Network connectivity test
   ping [-v] [-n &lt;count&gt;] [-l &lt;length&gt;] [-t &lt;timeout&gt;] [-r &lt;rate&gt;]
        [-i &lt;IP_addr&gt;] -h &lt;IP_addr&gt;
Reset the system
   reset 
Display RedBoot version information
   version 
Display (hex dump) a range of memory
   x -b &lt;location&gt; [-l &lt;length&gt;] [-s] [-1|2|4]
</screen> 
      </para>
      <para>
Help about a command with sub-commands.
<screen>
RedBoot> <userinput>help fis</userinput>
Manage FLASH images
   fis {cmds}
Create an image
  fis create -b &lt;mem_base&gt; -l &lt;image_length&gt; [-s &lt;data_length&gt;]
      [-f &lt;flash_addr&gt;] [-e &lt;entry_point&gt;] [-r &lt;ram_addr&gt;] [-n] &lt;name&gt;
Display an image from FLASH Image System [FIS]
  fis delete name
Erase FLASH contents
  fis erase -f &lt;flash_addr&gt; -l &lt;length&gt;
Display free [available] locations within FLASH Image System [FIS]
  fis free 
Initialize FLASH Image System [FIS]
  fis init [-f]
Display contents of FLASH Image System [FIS]
  fis list [-c] [-d]
Load image from FLASH Image System [FIS] into RAM
  fis load [-d] [-b &lt;memory_load_address&gt;] [-c] name
Write raw data directly to FLASH
  fis write -f &lt;flash_addr&gt; -b &lt;mem_base&gt; -l &lt;image_length&gt;
</screen> 
      </para>
    </refsect1>
  </refentry>

<!-- ******** ip_address *************************************************** -->
  <refentry id="ip-address-command">
    <refnamediv>
      <refname>ip_address</refname>
      <refpurpose>Set IP addresses</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>ip_address</command>
	<arg>-l <replaceable> local_IP_address</replaceable></arg>
	<arg>-h <replaceable> server_IP_address</replaceable></arg>
	<arg>-d <replaceable>
DNS_server_IP_address</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>-l <replaceable>
local_IP_address</replaceable></entry>	     
	      <entry>Numeric IP or DNS name</entry>
	      <entry>The IP address RedBoot should use.</entry>	     
	      <entry><emphasis>none</emphasis></entry>	     
	    </row>
	    <row>
	      <entry>-h <replaceable>
server_IP_address</replaceable></entry>	     
	      <entry>Numeric IP or DNS name</entry>
	      <entry>The IP address of the default server. Use of this
address is implied by other commands, such as
<command>load</command>.</entry>	     
	      <entry><emphasis>none</emphasis></entry>	     
	    </row>
	    <row>
	      <entry>-d <replaceable>
DNS_server_IP_address</replaceable></entry>	     
	      <entry>Numeric IP or DNS name</entry>
	      <entry>The IP address of the DNS server.</entry>	     
	      <entry><emphasis>none</emphasis></entry>	     
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </refsect1>
    <refsect1>
      <title>Description</title>
      <para>The <command>ip_address</command> command is used to show and/or change the basic IP
addresses used by RedBoot. IP addresses may be given as numeric
values, e.g. 192.168.1.67, or as symbolic names such as www.redhat.com
if DNS support is enabled.
      </para>
      <para>
The <option>-l</option> option is used to set the IP address used by
the target device.
      </para>
      <para>
The <option>-h</option> option is used to set the default server
address, such as is used by the <command>load</command> command.
      </para>
      <para>
The <option>-d</option> option is used to set the default DNS server
address which is used for resolving symbolic network addresses. Note
that an address of 0.0.0.0 will disable DNS lookups.
      </para>
    </refsect1>
    <refsect1>
      <title>Examples</title>
      <para>
Display the current network settings. 
<screen> 
RedBoot> <userinput>ip_address</userinput> 
IP: 192.168.1.31, Default server: 192.168.1.101, DNS server IP: 0.0.0.0 
</screen> 
</para>
<para>
Change the DNS server address. 
<screen> 
RedBoot> <userinput>ip_address -d 192.168.1.101</userinput> 
IP: 192.168.1.31, Default server: 192.168.1.101, DNS server IP: 192.168.1.101 
</screen> 
</para>
<para>
Change the default server address. 
<screen> 
RedBoot> <userinput>ip_address -h 192.168.1.104</userinput> 
IP: 192.168.1.31, Default server: 192.168.1.104, DNS server IP: 192.168.1.101
</screen>
      </para>
    </refsect1>
  </refentry>

<!-- ******** load *************************************************** -->
  <refentry id="download-command">
    <refnamediv>
      <refname>load</refname>
      <refpurpose>Download programs or data to the RedBoot platform</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <cmdsynopsis>
	<command>load</command>
	<arg>-v </arg>
	<arg>-d </arg>
	<arg>-r </arg>
	<arg>-m
          <group>
            <arg choice="req"><group>
              <arg>xmodem</arg>
              <arg>ymodem</arg>
            </group></arg>
            <arg>tftp</arg>
            <arg>disk</arg>
	  </group>
        </arg>  
	<arg>-h <replaceable> server_IP_address</replaceable></arg>
	<arg>-b <replaceable> location</replaceable></arg>
	<arg>-c <replaceable> channel</replaceable></arg>
        <arg><replaceable>file_name</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>-v</entry>	     
	      <entry>Boolean</entry>
	      <entry>Display a small spinner (indicator)
while the download is in  progress. This is just for feedback, especially
during long loads. Note that the option has no effect when using a
serial download method since it would interfere with the protocol.</entry>	     
	      <entry><emphasis>quiet</emphasis></entry>	     
	    </row>
	    <row>
	      <entry>-d</entry>	     
	      <entry>Boolean</entry>
	      <entry>Decompress data stream (gzip data)</entry>	     
	      <entry><emphasis>non-compressed data</emphasis></entry>	     
	    </row>
	    <row>
	      <entry>-r</entry>	     
	      <entry>Boolean</entry>
	      <entry>Raw (or binary) data</entry>	     
	      <entry><emphasis>formatted (S-records, ELF image, etc)</emphasis></entry>	     
	    </row>
	    <row>
	      <entry>-m tftp</entry>	     
	      <entry></entry>
	      <entry>Transfer data via the network using <acronym>TFTP</acronym> protocol.</entry>	     
	      <entry><acronym>TFTP</acronym></entry>	     
	    </row>
	    <row>
	      <entry>-m http</entry>	     
	      <entry></entry>
	      <entry>Transfer data via the network using <acronym>HTTP</acronym> protocol.</entry>	     
	      <entry><acronym>TFTP</acronym></entry>	     
	    </row>
	    <row>
	      <entry>-m xmodem</entry>	     
	      <entry></entry>
	      <entry>Transfer data using <emphasis>X-modem</emphasis> protocol.</entry>	     
	      <entry><acronym>TFTP</acronym></entry>	     
	    </row>
	    <row>
	      <entry>-m ymodem</entry>	     
	      <entry></entry>
	      <entry>Transfer data using <emphasis>Y-modem</emphasis> protocol.</entry>	     
	      <entry><acronym>TFTP</acronym></entry>	     
	    </row>
	    <row>
	      <entry>-m disk</entry>	     
	      <entry></entry>
	      <entry>Transfer data from a local disk.</entry>	     
	      <entry><acronym>TFTP</acronym></entry>	     
	    </row>
	    <row>
	      <entry>-h <replaceable>server_IP_address</replaceable></entry>	     
	      <entry>Numeric IP or DNS name</entry>
	      <entry>The IP address of the <acronym>TFTP</acronym> or <acronym>HTTP</acronym> server.</entry>	     
	      <entry>Value set by <command>ip_address</command></entry>	     
	    </row>
	    <row>
	      <entry>-b <replaceable>location</replaceable></entry>	     
	      <entry>Number</entry>
	      <entry>Address in memory to load the data.  Formatted data streams will have
an implied load address which this option may override.</entry>	     
	      <entry><emphasis>Depends on data format</emphasis></entry>	     
	    </row>
	    <row>
	      <entry>-c <replaceable>channel</replaceable></entry>	     
	      <entry>Number</entry>
	      <entry>Specify which I/O channel to
use for download.  This option is only supported when using either
xmodem or ymodem protocol.</entry>	     
	      <entry><emphasis>Depends on data format</emphasis></entry>	     
	    </row>
	    <row>
	      <entry><replaceable>file_name</replaceable></entry>	     
	      <entry>String</entry>
	      <entry>The name of the file on the <acronym>TFTP</acronym> or <acronym>HTTP</acronym>
server or the local disk. Details of how this is specified for <acronym>TFTP</acronym> are
host-specific. For local disk files, the name must be in <emphasis>disk</emphasis>:
<emphasis>filename</emphasis> format. The disk portion must match one of the disk
names listed by the <command>disks</command> command.</entry>	     
	      <entry><emphasis>None</emphasis></entry>	     
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </refsect1>
    <refsect1>
      <title>Description</title>
      <para>
The <command>load</command> command is used to download
data into the target system. Data can be loaded via a network connection,
using either the <acronym>TFTP</acronym> or <acronym>HTTP</acronym> protocols, or the console serial connection using the
X/Y modem protocol. Files may also be loaded directly from local filesystems
on disk. Files to be downloaded may either be executable images in 
ELF executable program format,