PATH
A short list of commands available through the Open Firmware user interface is shown in Table 5-9. Included within some of the command descriptions are examples that further illustrate command usage. Note that several of the commands are combinations of commands that can be used separately. The Open Firmware IEEE 1275 specification defines all of the commands and keywords.
Table 5-9 Commonly used Open Firmware user interface commands
| assign-addresses | Emulates the regular Open Firmware startup process of querying the system for resource requirements and adding an assigned-addresses property to the node that is the current package. |
| boot | Performs the startup process, using the currently chosen device. |
| ls dev / ls | List the children of the current node. Selects the root node and lists its children recursively, effectively dumping a name view of the device tree. Press Control-S to stop the text from scrolling off the screen. Restart the scrolling with Control-Q. |
| devalias | Show currently defined device aliases |
|
dev <
dev pathname
>
dev /bandit/gc .properties |
Selects the specified device in pathname and makes it the current node. Selects gc (the node representing the Bandit ASIC, which controls many Macintosh I/O features) as the active package and displays its properties. Bandit is used in the first PCI-based Power Macintosh models but may not be present in future models. For an illustration of its position in the device tree, see Listing 10-1. |
| show-devs < dev pathname > | Show devices beneath the device node specified in pathname. |
| dl | Sets the terminal emulator for downloading Forth code to RAM. Press Control-D to end the downloading process. |
| dump-device-tree | Lists properties and methods of all the device tree nodes. |
| FFC00000 100 dump | Dumps 0x100 bytes from virtual address 0xFFC00000, if that address is currently mapped in. |
| init-nvram | Resets data in NVRAM to default values. |
| properties | Show the names and values of the current device node properties. |
| make-properties | Emulates the regular Open Firmware startup process of querying the device's configuration space and adding the standard PCI properties to the node that is the current package. |
| printenv | Shows the current environment and default settings of Open Firmware configuration variables stored in NVRAM. |
| setenv param val | Sets the current environment parameter to the specified value. The value set by setenv persist across restarts. |
|
setenv auto-boot? false |
Sets the environment variable auto-boot? stored in NVRAM to false. This causes the computer to invoke the Open Firmware user interface automatically after subsequent restarts. |
| shut-down | Powers down the computer. |
| pwd | Displays the pathname of the current package. |
| reset-all | Resets the target computer. |
| see word | Displays the Forth source code for the word entered. |
| words | Lists variables, constants, and methods of the active package (as in Forth, but in the scope of the current package only). |