NAME

bootrom − boot rom

DESCRIPTION

The boot rom accepts various commands for the following functions:

• Booting and starting programs

• Displaying and changing contents of memory

• Displaying and changing environment variables

• Miscellaneous utilities

COMMAND SET

Commands may be abbreviated to the shortest unique string.  Arguments can be specified for most commands.  On the command line, the arguments are separated by spaces or tabs.  Spaces, tabs, single quotes and double quotes can be included in an argument by enclosing them with single quotes or double quotes.  For example,

’"hello world"’

is interpreted as an argument

"hello world"

Decimal, octal and hex can be used for numeric arguments and `‘0x” and "0" must preceed hex and octal, respectively.

The following symbol is used in the following description:

{a}zero or more occurrences of a

boot [ filename ] [ -n ] [ -f filename ] [ -- ] { arg }
Boots the program specified by the environnment variable "DEFAULTBOOT" or "DIAGBOOT" depending on the diagnostic switch setting, and starts the booted program from the entry point specified by the entry field of the a.out header of the booted prgram.  Arguments specified by arg are passed to the booted program.  If the first argument does not start with -, the program specified by the first argument filename is booted.  If -n is specified, control isn’t transferred to the booted program.  If -f is specified, the program specified by filename is booted.  If -- is specified, all arguments following this flag are passed to the booted program. 

go [-e addr ] { arg }
Starts the program from the entry point. Arguments specified by arg are passed to the program.  If -e is specified, the entry point is set to the address specified by addr. 

examine [ -b | h | w ] [ -B | c | d | o | u | x | f ] { range }
Displays the content of ranges of memory. The width of memory location can be specified by the following flags:

-b:Byte (8 bits)
-h:Half word (16 bits)
-w:Word (32 bits)

The default width is Word. The format can be specified by the following flags:

-B:Binary
-c:Ascii character
-d:Decimal
-o:Octal
-u:Unsigned decimal
-x:Hex
-f:Floating point

The default format is Hex. A range is specified by the following format:

addr- One width-size from address addr
addr#count- count width-size from address addr
addr1:addr2- From address addr1 to address addr2

If range is not specified, one width-size from the current address is displayed. 

deposit [ -b | h | w ] addr=value
Changes the contents of memory at addr to value.  The width of memory location can be specified by the following fags. 

-b:Byte (8 bits)
-h:Half word (16 bits)
-w:Word (32 bits)

The default width is Word.

printenv { name }
Displays the value of the environment variable specified by name.  If name is not specified, all of the environment variables are displayed.  The format of output is name=value. 

setenv { name value }
Changes the value of the environment variable name to value.  Note that there is no = sign between name and value. 

unsetenv { name }
Delete the value of the environment variable specified by name.  If all is specifed, it deletes the values of all environment variables.  If arguments are not specified, this command does nothing. 

cp [ -b blocksize ] [ -c count ] source_file destination_file
Copies the contents of source_file to destination_file.  If -b is specified, the block size is set to blocksize.  The maximum blocksize is 65536 (= 64K) bytes and the default block size is 512 bytes.  If -c is specified, count blocks are copied.  Without the -c flag, source_file is copied until the eof is found. 

mode [ mode_type ]
If mode_type is specified, this command changes the access mode which is used by examine and deposit commands.  The following values are available for mode_type:

physical- Addresses are interpreted as physical addresses
virtual- Addresses are interpreted as virtual addresses
io- Addresses are interpreted as I/O addresses

reset reset_type
Calls the rom reset routine specified by reset_type.  The following values are available for reset_type:

cold- Do a power up reset
warm- Reset the rom state
halt- Halt the machine
autoboot- Autoboot the machine according to "DEFAULTBOOT"
cont- Continue previous program

help { command }
Prints the syntax of the command specified by command.  If command is not specified, the syntax of all commands are displayed. 

? { command }
Same as help. 

rdg Starts rdg, the rom diagnostic environment (used only by Solbourne personnel). 

date [ yymmddhhmm [ .ss ] ]
Without an argument, this command displays the current date and time. Otherwise the current date is set as specified by the argument. yy is the last two digits of the year; the first mm is the month number; dd is the day number in the month; the second mm is the minute number; .ss (optional) specifies seconds. 

ls [ directory ]
Prints a list of files in a directory specified by directory.  If directory is not specified, the following directory name is used: If the environment variable "DEFAULTROOT" has a value, this value is used as the device name; otherwise "sd.si()" is used.  The path name is given by the environment variable "DEFAULTBOOT". 

SEE ALSO

eeprom(8s)

System Diagnostic Manual and the Installation Manual for your Solbourne machine. 

Solbourne Computer, Inc.  —  27 January 1988