diff options
Diffstat (limited to 'static/netbsd/man8/man8.macppc/ofwboot.8 3.html')
| -rw-r--r-- | static/netbsd/man8/man8.macppc/ofwboot.8 3.html | 367 |
1 files changed, 0 insertions, 367 deletions
diff --git a/static/netbsd/man8/man8.macppc/ofwboot.8 3.html b/static/netbsd/man8/man8.macppc/ofwboot.8 3.html deleted file mode 100644 index 3a16094d..00000000 --- a/static/netbsd/man8/man8.macppc/ofwboot.8 3.html +++ /dev/null @@ -1,367 +0,0 @@ -<table class="head"> - <tr> - <td class="head-ltitle">OFWBOOT(8)</td> - <td class="head-vol">System Manager's Manual (macppc)</td> - <td class="head-rtitle">OFWBOOT(8)</td> - </tr> -</table> -<div class="manual-text"> -<section class="Sh"> -<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> -<p class="Pp"><code class="Nm">ofwboot</code>, - <code class="Nm">ofwboot.elf</code>, <code class="Nm">ofwboot.xcf</code> - — <span class="Nd">Open Firmware boot command</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> -<table class="Nm"> - <tr> - <td><code class="Nm">ofwboot</code></td> - <td></td> - </tr> -</table> -</section> -<section class="Sh"> -<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> -<p class="Pp">Open Firmware is a FORTH-like command interpreter started by the - BootROM after the power-on self test (POST). This command interpreter allows - the user flexibility in choosing how their machine boots an operating - system. <span class="Ux">NetBSD</span> uses Open Firmware to initialize many - of the devices in a system and uses it to load the primary bootloader, - <code class="Nm">ofwboot</code>.</p> -<p class="Pp">The information in this man page should only serve as a guideline - for users. Apple has made many revisions to Open Firmware, and the earlier - versions had many problems and inconsistencies. You may find that a boot - command that works on one model will not work on another.</p> -<p class="Pp">In this man page, only one Open Firmware command will be - described, <code class="Ic">boot</code>, because it is used to pass - arguments to <code class="Nm">ofwboot</code>. The Open Firmware - <code class="Ic">boot</code> command takes up to three arguments:</p> -<div class="Bd Pp Bd-indent Li"> -<pre><code class="Ic">boot</code> [<var class="Ar">boot-device</var> [<var class="Ar">boot-file</var>]] [<var class="Ar">options</var>]</pre> -</div> -<p class="Pp">where</p> -<p class="Pp"></p> -<div class="Bd-indent"> -<dl class="Bl-tag Bl-compact"> - <dt><var class="Ar">boot-device</var></dt> - <dd>primary bootloader location</dd> - <dt><var class="Ar">boot-file</var></dt> - <dd>kernel location</dd> - <dt><var class="Ar">options</var></dt> - <dd>flags passed to the kernel (see below)</dd> -</dl> -</div> -<section class="Ss"> -<h2 class="Ss" id="boot-device"><a class="permalink" href="#boot-device">boot-device</a></h2> -<p class="Pp">The first argument, <var class="Ar">boot-device</var>, actually - designates the primary bootloader location and its name in the form:</p> -<div class="Bd Pp Bd-indent Li"> -<pre> -<var class="Ar">device</var><code class="Ic">:</code>[<var class="Ar">partition-num</var>][,\<var class="Ar">bootloader-filename</var>] -</pre> -</div> -<p class="Pp">A typical example, from a PowerBook (FireWire), is</p> -<p class="Pp"></p> -<div class="Bd - Bd-indent"><code class="Li">/pci@f2000000/mac-io@17/ata-4@1f000/@0:9,\ofwboot.xcf</code></div> -<p class="Pp">Note that colon (‘<code class="Li">:</code>’) - delimits the device to the left, and comma - (‘<code class="Li">,</code>’) separates the bootloader - filename from the first part. For Open Firmware versions before 3, the - primary bootloader is installed in partition “zero”, and it is - not necessary to specify the <var class="Ar">bootloader-filename</var>. For - Open Firmware version 3, you must specify the bootloader filename.</p> -<p class="Pp">Open Firmware stores aliases to common devices in NVRAM. In the - example the above, - <span class="Pa">/pci@f2000000/mac-io@17/ata-4@1f000/@0</span> is the path - on a PowerBook (FireWire) to the built-in ATA/100 hard drive. Use the - <code class="Ic">devalias</code> command in Open Firmware to print out a - list of common device names on a particular model. The - <var class="Ar">boot-device</var> above could then be simplified to:</p> -<p class="Pp"></p> -<div class="Bd Bd-indent"><code class="Li">hd:9,\ofwboot.xcf</code></div> -<p class="Pp"><var class="Ar">bootloader-filename</var> is usually - <code class="Nm">ofwboot.xcf</code>. See also the - <a class="Sx" href="#FILES">FILES</a> section for further discussion.</p> -<p class="Pp">If <var class="Ar">boot-device</var> is omitted from the - <code class="Ic">boot</code> command, the Open Firmware variable - <code class="Ev">boot-device</code> is used.</p> -</section> -<section class="Ss"> -<h2 class="Ss" id="boot-file"><a class="permalink" href="#boot-file">boot-file</a></h2> -<p class="Pp">It may be necessary to specify the <var class="Ar">boot-file</var> - if Open Firmware does not know where to find the kernel. The default is to - load the file named <span class="Pa">netbsd</span> on partition - “<span class="Pa">a</span>” from the device used to load the - primary bootloader.</p> -<p class="Pp">For systems with Open Firmware versions less than 3 which are set - up using <code class="Ic">sysinst</code>, the - <var class="Ar">boot-file</var> argument is not necessary. Systems with Open - Firmware version 3 may need to specify the - <var class="Ar">boot-file</var>.</p> -<p class="Pp">The syntax is similar to the <var class="Ar">boot-device</var> - argument:</p> -<div class="Bd Pp Bd-indent Li"> -<pre> -[<var class="Ar">boot-file-device</var><code class="Ic">:</code><var class="Ar">partition-num</var><code class="Ic">/</code>][<var class="Ar">kernel-name</var>] -</pre> -</div> -<p class="Pp">This is a little different, since a kernel-name may be specified - without listing a <var class="Ar">boot-file-device</var> and - <var class="Ar">partition-num</var>. Additionally, a - <var class="Ar">boot-file-device</var> and - <var class="Ar">partition-num</var> may need to be specified, while using - the default <var class="Ar">kernel-name</var>.</p> -<p class="Pp">If no <var class="Ar">kernel-name</var> is specified, the primary - bootloader will try to find kernels named either - <span class="Pa">netbsd</span> or <span class="Pa">netbsd.gz</span> on the - boot-device or (if specified) boot-file-device.</p> -</section> -<section class="Ss"> -<h2 class="Ss" id="options"><a class="permalink" href="#options">options</a></h2> -<p class="Pp">Possible options are:</p> -<dl class="Bl-tag"> - <dt id="a"><a class="permalink" href="#a"><code class="Fl">-a</code></a></dt> - <dd>ask for the boot device</dd> - <dt id="s"><a class="permalink" href="#s"><code class="Fl">-s</code></a></dt> - <dd>single-user mode boot</dd> - <dt id="d"><a class="permalink" href="#d"><code class="Fl">-d</code></a></dt> - <dd>debug mode</dd> - <dt id="exit"><a class="permalink" href="#exit"><code class="Cm">exit</code></a></dt> - <dd>exit to Open Firmware after processing arguments</dd> -</dl> -</section> -</section> -<section class="Sh"> -<h1 class="Sh" id="ENVIRONMENT"><a class="permalink" href="#ENVIRONMENT">ENVIRONMENT</a></h1> -<p class="Pp">If set, the following Open Firmware variables will be used to - determine which <var class="Ar">boot-device</var> and - <var class="Ar">boot-file</var> Open Firmware should use when booting a - system. If the user specifies arguments on the command line, these values - are overridden.</p> -<dl class="Bl-tag"> - <dt id="boot-device~2"><a class="permalink" href="#boot-device~2"><code class="Ev">boot-device</code></a></dt> - <dd>used as the first argument</dd> - <dt id="boot-file~2"><a class="permalink" href="#boot-file~2"><code class="Ev">boot-file</code></a></dt> - <dd>used as the second argument</dd> - <dt id="auto-boot?"><a class="permalink" href="#auto-boot?"><code class="Ev">auto-boot?</code></a></dt> - <dd>setting this variable to <code class="Ic">false</code> will present the - user with an Open Firmware command prompt after power-on reset. A value of - <code class="Ic">true</code> will automatically boot the system using the - variables <code class="Ev">boot-device</code> and - <code class="Ev">boot-file</code>. (This is not really related to the boot - command, but is included for completeness.)</dd> -</dl> -<p class="Pp">To restore these variables to their default values, use the - <code class="Ic">set-default</code> Open Firmware command:</p> -<p class="Pp"></p> -<div class="Bd Bd-indent"><code class="Li">set-default boot-device</code></div> -</section> -<section class="Sh"> -<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1> -<p class="Pp">The three files <code class="Nm">ofwboot</code>, - <code class="Nm">ofwboot.elf</code>, and <code class="Nm">ofwboot.xcf</code> - are the same program, in different executable formats.</p> -<dl class="Bl-tag"> - <dt><span class="Pa">ofwboot</span></dt> - <dd><code class="Nm">ofwboot</code> is installed via - <a class="Xr">installboot(8)</a> on systems with Open Firmware versions - less than 3. It is not necessary to specify this file name on the Open - Firmware <code class="Ic">boot</code> command, as it is stored in a - special location in the <span class="Ux">NetBSD</span> partition that is - marked “bootable” in the Apple partition map entry. The - bootable partition can be specified as partition “zero”. For - example, the following command might be used to boot from a SCSI device - with ID 2: <code class="Ic">0 >boot scsi-int/sd@2:0</code>.</dd> - <dt><span class="Pa">ofwboot.xcf</span></dt> - <dd><code class="Nm">ofwboot.xcf</code> is in XCOFF format. This file is used - on all Open Firmware 3 systems, and on Open Firmware systems prior to 3 - when the bootloader is not installed in partition “zero”, - such as from an ISO-9660 format CD-ROM.</dd> - <dt><span class="Pa">ofwboot.elf</span></dt> - <dd><code class="Nm">ofwboot.elf</code> is in <a class="Xr">elf(5)</a> format - and only functions on systems with Open Firmware version 3. To avoid - confusion, all users should be using <code class="Nm">ofwboot.xcf</code>, - as <code class="Nm">ofwboot.elf</code> offers no additional functionality. - It is only included for historical reasons.</dd> - <dt><span class="Pa">boot.fs</span></dt> - <dd>This 1.44 MB disk image contains everything necessary to boot and install - <span class="Ux">NetBSD</span>. It includes the partition - “zero” bootloader (<code class="Nm">ofwboot</code>), an - INSTALL kernel (with limited device drivers), and the - <code class="Ic">sysinst</code> utility in a RAM disk. Since Open Firmware - does not care what media files are loaded from, only whether they are - supported and in the correct format, this disk image may be placed on - media other than floppy disks, such as hard drives or Zip disks. Use - <a class="Xr">dd(1)</a> on Unix, or <code class="Ic">DiskCopy</code> on - MacOS 9.1 or later, or <code class="Ic">suntar</code> on any MacOS version - to copy this image onto the media.</dd> - <dt><span class="Pa">netbsd</span></dt> - <dd>production kernel, using the GENERIC set of devices which supports almost - all hardware available for this platform.</dd> - <dt><span class="Pa">netbsd_GENERIC_MD.gz</span></dt> - <dd>GENERIC kernel (the same as <var class="Ar">netbsd</var>), with RAM disk - and <code class="Ic">sysinst</code> included.</dd> - <dt><span class="Pa">NetBSD-{RELEASE}-macppc.iso</span></dt> - <dd>bootable CD-ROM image for all supported systems. Usually located at - <span class="Pa">https://cdn.NetBSD.org/pub/NetBSD/images/{RELEASE}/</span></dd> -</dl> -</section> -<section class="Sh"> -<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1> -<p class="Pp">In the following examples - ‘<code class="Li">0 > </code>’ is the Open - Firmware prompt.</p> -<ul class="Bl-item"> - <li>Boot the default installation into single user mode. - <div class="Bd Bd-indent"><code class="Li">0 > boot -s</code></div> - </li> - <li>Boot an Open Firmware 3 system, with <var class="Ar">netbsd</var> - installed on partition “<span class="Pa">a</span>”: - <div class="Bd Bd-indent"><code class="Li">0 > boot - hd:,\ofwboot.xcf</code></div> - </li> - <li>Boot the kernel named <span class="Pa">netbsd.new</span> from partition - “<span class="Pa">a</span>” of the hard disk into - <a class="Xr">ddb(4)</a> using ELF version of - <code class="Nm">ofwboot</code> from the USB flash drive: - <div class="Bd Bd-indent"><code class="Li">0 > boot - usb0/disk:,\ofwboot.elf hd/netbsd.new -d</code></div> - or - <div class="Bd Bd-indent"><code class="Li">0 > boot - usb1/disk:,\ofwboot.elf hd/netbsd.new -d</code></div> - Note: You can check which usb device name should be used by - “<code class="Ic">devalias</code>” and - “<code class="Ic">dev usb0 ls</code>” commands etc.</li> - <li>Boot from bootable CD-ROM of <span class="Ux">NetBSD</span> release with - Open Firmware 3 or higher: - <div class="Bd Bd-indent"><code class="Li">0 > boot - cd:,\ofwboot.xcf</code></div> - </li> - <li>Boot from bootable CD-ROM (internal SCSI, id=3) of - <span class="Ux">NetBSD</span> release with Open Firmware versions prior - to 3: - <div class="Bd Bd-indent"><code class="Li">0 > boot - scsi/sd@3:0</code></div> - </li> - <li>Boot from a USB flash drive containing a bootable CD-ROM ISO image of - <span class="Ux">NetBSD</span> release with Open Firmware 3 or higher: - <div class="Bd Bd-indent"><code class="Li">0 > boot - usb0/disk@1:3,\ofwboot.xcf</code></div> - or - <div class="Bd Bd-indent"><code class="Li">0 > boot - usb1/disk@1:3,\ofwboot.xcf</code></div> - Note: The partition number “<span class="Pa">3</span>” is an - ISO9660/HFS hybrid partition specified by the Apple partition map in the - macppc CD ISO image of <span class="Ux">NetBSD</span> release.</li> - <li>Boot from floppy disk: - <div class="Bd Bd-indent"><code class="Li">0 > boot fd:0</code></div> - </li> - <li>Boot from network, with bootps, <a class="Xr">bootptab(5)</a>, - <a class="Xr">tftpd(8)</a>, and <a class="Xr">nfsd(8)</a> server - available: - <div class="Bd Bd-indent"><code class="Li">0 > boot enet:0</code></div> - </li> - <li>Boot from network, but use internal root partition of second drive: - <div class="Bd Bd-indent"><code class="Li">0 > boot enet:0 - ultra1:0</code></div> - </li> - <li>Boot MacOS, looking for the first available bootable disk: - <div class="Bd Bd-indent"><code class="Li">0 > boot - hd:,\\:tbxi</code></div> - </li> - <li>Boot MacOS X residing on partition 10: - <div class="Bd Bd-indent"><code class="Li">0 > boot - hd:10,\\:tbxi</code></div> - </li> -</ul> -</section> -<section class="Sh"> -<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1> -<div class="Bd"> -<pre>DEFAULT CATCH!, code=FF00300 at %SRR0: FF80AD38 %SRR1: 00001070</pre> -</div> -<p class="Pp">Could be “device not found” or I/O errors on the - device. The numbers are just for example. If the error is caused by I/O - errors (especially on CD boot), retrying the same command after restarting - Open Firmware by <code class="Ic">reset-all</code> command might help.</p> -<div class="Bd Pp"> -<pre>CLAIM failed</pre> -</div> -Open Firmware got errors on memory allocation ops etc. This could also happen by - buggy Open Firmware implementation, or improper - <code class="Ev">real-base</code> variable settings. -<div class="Bd Pp"> -<pre>Can't LOAD from this device</pre> -</div> -Open Firmware found the device, but it is not supported by - <code class="Ic">load</code>. -<div class="Bd Pp"> -<pre>0 > boot yy:0/netbsd -RESETing to change Configuration!</pre> -</div> -<var class="Ar">yy:0</var> doesn't exist, so Open Firmware ignores the string - and uses the default parameters to boot MacOS; the MacOS boot routine then - clears some of the Open Firmware variables. -<div class="Bd Pp"> -<pre>0 > boot ata/ata-disk@0:9 specified partition is not bootable - ok</pre> -</div> -As it says. -<div class="Bd Pp"> -<pre>0 > boot ata/ata-disk@0:0 ->> NetBSD/macppc OpenFirmware Boot, Revision 1.3 ->> (root@nazuha, Fri Jun 8 22:21:55 JST 2001) -no active package3337696/</pre> -</div> -and hangs: See the real-base part in the FAQ. -<p class="Pp">Note: It is recommended to restart Open Firmware by - <code class="Ic">reset-all</code> command if you get these Open Firmware - errors, to avoid further unexpected random errors.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE - ALSO</a></h1> -<p class="Pp"><a class="Xr">installboot(8)</a></p> -<p class="Pp"><span class="Pa">INSTALL.html</span></p> -<p class="Pp"><a class="Lk" href="https://www.NetBSD.org/ports/macppc/faq.html">NetBSD/macppc - Frequently Asked Questions</a></p> -<p class="Pp"><a class="Lk" href="https://www.NetBSD.org/ports/macppc/partitioning.html">NetBSD/macppc - Partitioning HOW-TO</a></p> -<p class="Pp"><a class="Lk" href="https://www.NetBSD.org/ports/macppc/models.html">NetBSD/macppc - Model Support</a></p> -<p class="Pp"><a class="Lk" href="https://www.NetBSD.org/docs/network/netboot/">Diskless - NetBSD HOW-TO</a></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="STANDARDS"><a class="permalink" href="#STANDARDS">STANDARDS</a></h1> -<p class="Pp"><span class="St">IEEE Std 1275-1994 (“Open - Firmware”)</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> -<p class="Pp"><code class="Nm">ofwboot</code> can only boot from devices - recognized by Open Firmware.</p> -<p class="Pp">Early PowerMacintosh systems (particularly the 7500) seem to have - problems with netbooting. Adding an arp entry at the tftp server with</p> -<p class="Pp"></p> -<div class="Bd Bd-indent"><code class="Li">arp -s booting-host-name - its-ethernet-address</code></div> -<p class="Pp">may resolve this problem (see <a class="Xr">arp(8)</a>).</p> -<p class="Pp">Once boot failed,</p> -<div class="Bd Pp Bd-indent Li"> -<pre>0 > boot CLAIM failed - ok</pre> -</div> -<p class="Pp">successive boots may not be possible. You need to type - <code class="Ic">reset-all</code> or power-cycle to re-initialize Open - Firmware.</p> -</section> -</div> -<table class="foot"> - <tr> - <td class="foot-date">June 9, 2024</td> - <td class="foot-os">NetBSD 10.1</td> - </tr> -</table> |