16 January 2020
If you run into issues while modifying properties within Open Firmware, the following commands can help:
reset-nvram set-defaults reset-all
If you believe you have bricked your computer, and it no longer boots due to changes made within Open Firmware refer to the Resetting Open Firmware guide.
help- List main help categories.
help [category]- Show help for all commands in the category. Use only the first word of the category description.
help [command]- Show help for individual command (where available).
devalias- Display all current device alias names for key hardware devices.
devalias [alias]- Display the device path name corresponding to alias.
devalias [alias device-path]- Define an alias representing the device path. If an alias with the same name already exists, the new value supersedes the old.
.properties- Display the names and values of the current node’s properties.
dev [device-path]- Select the indicated device node, making it the current node.
dev [node-name]- Search for a node with the given name in the subtree below the current node, and select the first such node found.
dev ..- Select the device node that is the parent of the current node.
dev /- Select the root machine node.
device-end- De-select the current device node, leaving no node selected.
ls- Display the names of the current node’s children.
pwd- Display the device path name that names the current node.
show-devs [device-path]- Display all the devices known to the system directly beneath a given level in the device hierarchy. (Without a device-path, it shows the entire device tree.)
words- Display the names of the current node’s methods/forth scripts.
see- Displays the source code for a particular forth script.
sift-devs [ccc]- Search all device nodes and show all method names that contain the sequence of characters
nvedit- Enter the NVRAMRC editor. If data remains in the temporary buffer from a previous
nveditsession, resume editing those previous contents. If not, read the contents of NVRAMRC into the temporary buffer and begin editing it. Press Control + C to exit the NVRAMRC editor.
nvalias [alias device-path]- Define a persistent alias (stored in NVRAM). The alias persists until the
set-defaultscommands are executed.
nvunalias [alias]- Delete a persistent alias from NVRAM.
nvrun- Execute the contents of the temporary buffer.
printenv [variable]- If variable is given, show its current value. Otherwise show all configuration variables and their current and default values.
setenv [variable value]- Set variable to the given decimal or text value. Changes are permanent, but sometimes they only take effect after a reset. Some systems let you create new user-defined configuration variables.
set-default [variable]- Set variable to its default value.
set-defaults- Set all configuration variables to their default values.
unsetenv [variable]- Delete a user-defined configuration variable.
nvramrc- Contents of NVRAMRC script.
use-nvramrc? [true/false]- If true, execute commands in NVRAMRC during system start-up.
probe-scsi- Identify devices attached to the built-in SCSI bus.
probe-scsi-all [device-path]- Perform probe-scsi on all SCSI buses installed in the system below the specified node. (If device-path is absent, the root node is used.)
diag-switch? [true/false]- If true, run in diagnostic mode.
selftest-[#megs]- Megabytes of RAM to test. Ignored if diag-switch? is true.
test [device-specifier]- Execute the specified device’s self-test method.Examples:
test floppy- test the floppy drive, if installed.
test /memory- test number of megabytes specified in
selftest-#megs; or test all of memory if
test net- test the network connection.
test-all [device-specifier]Test all devices (that have a built-in self-test method) below the specified node. (If device-specifier is absent, the root node is used.)
watch-clock- Test the clock function.
watch-net- Monitor the network connection passively. Displays a period for each packet received.
source- Executes a particular forth script.
load- Loads a image from disk, cd, network or another device.
go- Begin executing a previously-loaded binary program, or resume executing an interrupted program. (Called automatically by boot .)
byte-load [adr span --]- Interpret a loaded FCode binary file. span is usually 1.
dl- Load a Forth file over a serial line with TIP and interpret. Type:~C cat filename^-D
dlbin- Load a binary file over a serial line with TIP. Type: ~C cat filename
dload [filename]- Load specified file over Ethernet at given address.
init-program- Prepare a loaded program for execution. (Called automatically by load and boot.)
load-base- Address where load first places the data it reads from a device. The program image may be moved elsewhere as init-program prepares it for execution.