📄 redboot_cmds.sgml
字号:
<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>
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|<channel number>]
Compute a 32bit checksum [POSIX algorithm] for a range of memory
cksum -b <location> -l <length>
Display (hex dump) a range of memory
dump -b <location> [-l <length>] [-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 <timeout>] [entry]
Help about help?
help [<topic>]
Set/change IP addresses
ip_address [-l <local_ip_address>[/<mask_length>]] [-h <server_address>]
Load a file
load [-r] [-v] [-d] [-h <host>] [-m {TFTP | HTTP | {x|y}MODEM -c <channel_number>}]
[-b <base_address>] <file_name>
Compare two blocks of memory
mcmp -s <location> -d <location> -l <length> [-1|-2|-4]
Fill a block of memory with a pattern
mfill -b <location> -l <length> -p <pattern> [-1|-2|-4]
Network connectivity test
ping [-v] [-n <count>] [-l <length>] [-t <timeout>] [-r <rate>]
[-i <IP_addr>] -h <IP_addr>
Reset the system
reset
Display RedBoot version information
version
Display (hex dump) a range of memory
x -b <location> [-l <length>] [-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 <mem_base> -l <image_length> [-s <data_length>]
[-f <flash_addr>] [-e <entry_point>] [-r <ram_addr>] [-n] <name>
Display an image from FLASH Image System [FIS]
fis delete name
Erase FLASH contents
fis erase -f <flash_addr> -l <length>
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 <memory_load_address>] [-c] name
Write raw data directly to FLASH
fis write -f <flash_addr> -b <mem_base> -l <image_length>
</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 choice=opt>/<replaceable>netmask_length</replaceable></arg> </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><option>[<replaceable>/netmask_length</replaceable>]</option></entry>
<entry>Numeric IP or DNS name</entry>
<entry>The IP address RedBoot should use, optionally
with the network mask length.</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. The network mask length can also be specified
</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>
<para>
Set the IP address to something new, with a 255.255.255.0 netmask
<screen>
RedBoot> <userinput>ip_address -l 192.168.1.32/24</userinput>
IP: 192.168.1.32, 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>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -