Appendix C Unsupported Commands

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 loadabl`e 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 loadabl`e 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 loadabl`e 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 loadabl`e 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 loadabl`e 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@`.