Commit yaboot 1.3.0
[yaboot.git] / doc / README.ofpath
1 This utility is used to find the OpenFirmware device path to a unix
2 device node (ie /dev/hda2).  
3
4 Ofpath will work on Newworld PowerMacs only if yaboot is used as the
5 bootloader, it will not work on newworld macs booted with BootX.
6
7 Ofpath will also work on most Oldworld PowerMacs, unlike Newworld, it
8 will work on BootX booted Oldworld machines. Note that oldworld
9 support is not well tested and may not give accurate results.
10
11 ofpath supports the following command line switches:
12
13       --debug                print boring junk only useful for debugging
14   -h, --help                 display this help and exit
15   -V, --version              output version information and exit
16
17 Ybin will use this utility automatically to find the OpenFirmware
18 device path when macos=, macosx= are set to unix device nodes in
19 /etc/yaboot.conf, and/or if ofboot= is not defined.
20
21 ofpath is based on show_of_path.sh written by Olaf Hering, this
22 version unlike show_of_path.sh works with /bin/ash and is fully
23 functional on stripped down systems such as boot or rescue floppies.
24 It has been tested on the Debian GNU/Linux 2.2 (potato) boot
25 floppies.