NAME
isl — initial system loader
DESCRIPTION
isl
implements the operating system independent portion of
the bootstrap process. It is loaded and executed
after self-test and initialization have completed
successfully.
The processor contains special purpose memory for
maintaining critical configuration related parameters
(e.g. Primary Boot, Alternate Boot, and Console Paths).
Two forms of memory are supported: Stable Storage
and Non-Volatile Memory (NVM).
Typically, when control is transferred to
isl,
an
autoboot
sequence takes place.
An
autoboot
sequence allows a complete bootstrap operation to occur
with no intervention from an operator.
isl
executes commands from the
autoexecute
file in a script-like fashion.
autoboot
is enabled by a flag in Stable Storage.
autosearch
is a mechanism that automatically locates the boot and console devices.
For further information, see
pdc(1M).
During an
autoboot
sequence,
isl
displays its revision and the name of any utility it executes.
However, if
autoboot
is disabled, after
isl
displays its revision, it then prompts for input from the console device.
Acceptable input is any
isl
command name or the name of any utility available on the system.
If a non-fatal error occurs or the executed utility returns,
isl
again prompts for input.
Commands
There are several commands available in
isl,
although not all commads are supported on cellular systems .
The following is a list with a short description.
Parameters may be entered on the command line following the command name.
They must be separated by spaces.
isl
prompts for any necessary parameters
that are not entered on the command line.
- ?, help
Help - List commands and available utilities
- listf, ls
List available utilities
- autoboot
Enable or disable the
autoboot
sequence
Parameter -
on
or
off
- autosearch
Enable or disable the
autosearch
sequence
Parameter -
on
or
off
- primpath
Modify the Primary Boot Path
Parameter - Primary Boot Path in decimal
- altpath
Modify the Alternate Boot Path
Parameter - Alternate Boot Path in decimal
- conspath
Modify the Console Path
Parameter - Console Path in decimal
- lsautofl, listautofl
List contents of the
autoexecute
file
- display
Display the Primary Boot, Alternate Boot, and Console Paths
- readnvm
Display the contents of one word of NVM in hexadecimal
Parameter - NVM address in decimal or standard hexadecimal notation
- readss
Display the contents of one word of Stable Storage in hexadecimal
Parameter - Stable Storage address in decimal or standard hexadecimal notation
DIAGNOSTICS
isl
displays diagnostic information through error messages
written on the console and display codes on the
LED
display.
For the display codes,
CE0x
are informative only.
CE1x
and
CE2x
indicate errors, some of which are fatal and cause the system to halt.
Other errors merely cause
isl
to display a message.
Non-fatal errors during an
autoboot
sequence cause the
autoboot
sequence to be aborted and
isl
to prompt for input.
After non-fatal errors during an interactive
isl
session,
isl
merely prompts for input.
Fatal errors cause the system to halt.
The problem must be corrected and the system
RESET
to recover.
- CE00
isl
is executing.
- CE01
isl
is
autobooting
from the
autoexecute
file.
- CE02
Cannot find an
autoexecute
file.
autoboot
aborted.
- CE03
No console found,
isl
can only
autoboot.
- CE05
Directory of utilities is too big,
isl
reads only 2K bytes.
- CE06
autoexecute
file is inconsistent.
autoboot
aborted.
- CE07
Utility file header inconsistent: SOM values invalid.
- CE08
autoexecute
file input string exceeds 2048 characters.
utoboot
aborted.
- CE09
isl
command or utility name exceeds 10 characters.
- CE0F
isl
has transferred control to the utility.
- CE10
Internal inconsistency: Volume label -
FATAL.
- CE11
Internal inconsistency: Directory -
FATAL.
- CE12
Error reading
autoexecute
file.
- CE13
Error reading from console -
FATAL.
- CE14
Error writing to console -
FATAL.
- CE15
Not an
isl
command or utility.
- CE16
Utility file header inconsistent: Invalid System ID.
- CE17
Error reading utility file header.
- CE18
Utility file header inconsistent: Bad magic number.
- CE19
Utility would overlay
isl
in memory.
- CE1A
Utility requires more memory than is configured.
- CE1B
Error reading utility into memory.
- CE1C
Incorrect checksum: Reading utility into memory.
- CE1D
Console needed -
FATAL.
- CE1E
Internal inconsistency: Boot device class -
FATAL.
- CE21
Destination memory address of utility is invalid.
- CE22
Utility file header inconsistent:
pdc_cache
entry.
- CE23
Internal inconsistency:
iodc_entry_init
-
FATAL.
- CE24
Internal inconsistency:
iodc_entry_init
-
console -
FATAL.
- CE25
Internal inconsistency:
iodc_entry_init
- boot device -
FATAL.
- CE26
Utility file header inconsistent: Bad
aux_id.
- CE27
Bad utility file type.