Some features of the OpenBoot firmware may not be available in early systems. If you want to use a documented command that is not available in your system, refer to this appendix for a possible workaround.
Table C-1 Workarounds for Unsupported Commands
Command |
Availability |
Workaround |
---|---|---|
" embedded bytes |
Not supported in earlier systems. |
Use other array-creation mechanisms, such as alloc-mem and c, . |
.attributes |
Not supported until OpenBoot 2.0. |
A loadable showdevs utility, which provides some of this functionality, is available from the Sun SBus Support Group. |
alloc-mem |
See workaround. |
Pre-2.0, size is restricted to total remaining FORTH dictionary space. Using more than several hundred bytes is dangerous. Use dma-alloc ( size -- virt ) instead. |
boot-device boot-file |
Not supported until OpenBoot 2.0. |
Use boot-from to indicate boot device and boot file. |
cd |
Not supported until OpenBoot 2.0. |
A loadable showdevs utility, which provides some of this functionality, is available from the Sun SBus Support Group. |
Command completion |
Not supported in early systems. |
Type the entire command name. |
cpeek cpoke |
Not supported in early systems. |
probe words exist in early systems to provide a similar functionality, as: cprobe ( adr -- ok? ) Test for data exception using c@. |
d! d? d@ |
Not supported in early systems. |
Use combinations of 32-bit accesses. |
diag-device diag-file |
Not supported until OpenBoot 2.0. |
Use boot-from-diag to indicate diagnostic boot device and boot file. |
lpeek lpoke |
Not supported in early systems. |
probe words exist in early systems to provide a similar functionality, as: lprobe ( adr32 -- ok? ) Test for data exception using l@. |
ls |
Not supported until OpenBoot 2.0. |
A loadable showdevs utility, which provides some of this functionality, is available from the Sun SBus Support Group. |
NVRAMRC |
Not supported until OpenBoot 2.0. |
No workaround. A different version exists in OpenBoot 1.6; do not use this version. |
nvalias nvunalias |
Not supported until OpenBoot 2.6. |
Manually edit NVRAMRC. |
nodefault-bytes |
Not supported until OpenBoot 2.0. |
No workaround. |
patch |
See workaround. |
Pre-2.6, patch would patch words but not numbers within definitions. To patch numbers, use : npatch word-to-patch ( new-n old-n -- ). |
probe-scsi-all |
Not supported until OpenBoot 2.6. |
No workaround. |
pwd |
Not supported until OpenBoot 2.0. |
A loadable showdevs utility, which provides some of this functionality, is available from the Sun SBus Support Group. |
show-devs |
Not supported until OpenBoot 2.0. |
A loadable showdevs utility, which provides some of this functionality, is available from the Sun SBus Support Group. |
show-sbus |
Not supported until OpenBoot 2.3. |
Use: ok cd /sbus ok ls(Similar information is presented, but in a different format.) |
showstack |
Does not toggle (turn off) until OpenBoot 2.6. |
To turn off showstack, either reset the system or type: [`] noop is status |
spaced? |
Not supported until OpenBoot 2.6. |
Use spaced@ and "." |
Stop-F Stop-D Stop-N |
Not supported until OpenBoot 2.0. |
No workaround. |
test xxx |
Not supported until OpenBoot 2.0. |
It is possible to test certain devices on OpenBoot 1.x systems with: test-memory ( -- ) (similar to: test /memory). Some plug-in devices can also be tested by directly entering the appropriate test name (on OpenBoot 1.x only). |
User-added device aliases |
Not supported until OpenBoot 2.0. |
No workaround. |
watch-net |
Not supported in OpenBoot 1.3 through 2.2. |
No workaround. |
wpeek wpoke |
Not supported in early systems. |
probe words exist in early systems to provide a similar functionality, as: wprobe ( adr16 -- ok? ) Test for data exception using w@. |