Clean up yabootconfig kernel/initrd code - Joseph Jezak <josejx@gentoo.org>
[yaboot.git] / man / ofpath.8
1 .\" Hey Emacs! This file is -*- nroff -*- source.
2 .\"
3 .\" ofpath: determine OpenFirmware path from unix device node
4 .\" Copyright (C) 2000, 2001 Ethan Benson
5 .\"
6 .\" Portions based on show_of_path.sh:
7 .\"
8 .\" Copyright (C) 2000 Olaf Hering <olh@suse.de>
9 .\"
10 .\" This program is free software; you can redistribute it and/or
11 .\" modify it under the terms of the GNU General Public License
12 .\" as published by the Free Software Foundation; either version 2
13 .\" of the License, or (at your option) any later version.
14 .\"
15 .\" This program is distributed in the hope that it will be useful,
16 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
17 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18 .\" GNU General Public License for more details.
19 .\"
20 .\" You should have received a copy of the GNU General Public License
21 .\" along with this program; if not, write to the Free Software
22 .\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
23 .\"
24 .TH OFPATH 8 "27 May 2001" "GNU/Linux PowerPC" "System Manager's Manual"
25 .SH NAME
26 .B ofpath
27 \- determine OpenFirmware path from unix device node.
28 .SH SYNOPSIS
29 .B ofpath
30 .RB [ \ \-\-debug\  ]
31 .RB [ \ \-h | \-\-help\  ]
32 .RB [ \ \-V | \-\-version\  ]
33 .IB FILE
34 .SH DESCRIPTION
35 This manual page explains
36 .BR ofpath ,
37 the utility used to find the OpenFirmware device path corresponding to
38 a unix device node, such as \fI/dev/hda2\fR.
39
40 .B ofpath
41 will work on NewWorld PowerMacs only if yaboot is used as the
42 bootloader.  It will \fInot\fR work on NewWorld macs booted with BootX.
43
44 .B ofpath
45 will also work on some OldWorld PowerMacs. Unlike NewWorld, it will
46 work on BootX-booted OldWorld machines. Note that OldWorld support is
47 not well tested and may not give accurate results.
48
49 \fBYbin\fR(8) uses this utility to automatically convert unix device
50 nodes to OpenFirmware paths as needed.
51 .SH OPTIONS
52 .TP
53 .BR \-\-debug
54 This option causes \fBofpath\fR to output some boring details useful
55 only for debugging \fBofpath\fR itself.
56 .TP
57 .BR \-h ,\  \-\-help
58 Print out usage information and exit.
59 .TP
60 .BR \-V ,\  \-\-version
61 Print out the version number and exit.
62
63 .SH BUGS
64 .B Ofpath
65 may not accurately find all SCSI devices, and does not support all
66 SCSI adapters/drivers.
67
68 .B Ofpath
69 also does not support all IDE devices.
70
71 .B Ofpath
72 does not support IBM hardware.  Send a tarball of /proc/device-tree
73 along with /proc/cpuinfo to <erbenson@alaska.net>
74 .SH AUTHORS
75 .B Ofpath
76 is based on show_of_path.sh written by Olaf Hering, it was
77 rewritten to work with /bin/ash and stripped down systems such as
78 boot/rescue floppies by Ethan Benson.  This man page was written by
79 Ethan Benson.
80 .SH REPORTING BUGS
81 Report bugs to <erbenson@alaska.net>
82 .SH SEE ALSO
83 .BR bootstrap (8),
84 .BR mkofboot (8),
85 .BR yaboot (8),
86 .BR yaboot.conf (5),
87 .BR ybin (8).