Unsupported Commands

C

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

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.

Table C-1

Command	Availability	Workaround
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.

Table C-1

Command	Availability	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@.