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).