Booting PowerPC Macs from USB - Revision history

Huntertur: Add missing colon

2025-07-26T19:10:05Z

Add missing colon

← Older revision		Revision as of 19:10, 26 July 2025
Line 15:		Line 15:
	To find your USB mass storage device, you will need to inspect the tree of devices attached to each USB port. To do this, enter <code>dev usb0 ls</code>, replacing <code>usb0</code> with the port you are currently looking at.		To find your USB mass storage device, you will need to inspect the tree of devices attached to each USB port. To do this, enter <code>dev usb0 ls</code>, replacing <code>usb0</code> with the port you are currently looking at.

	If you see a <code>/disk@8</code> (or some other integer) node in the tree, this is your mass storage device. To boot, enter <code>boot usb0/disk@8,\\:tbxi</code>, substituting names as necessary.		If you see a <code>/disk@8</code> (or some other integer) node in the tree, this is your mass storage device. To boot, enter <code>boot usb0/disk@8:,\\:tbxi</code>, substituting names as necessary.

	This will attempt to boot the Mac by searching <code>usb0/disk@8</code> for a file with type <code>tbxi</code> (Toolbox Image). If this does not work, see the advanced section below.		This will attempt to boot the Mac by searching <code>usb0/disk@8</code> for a file with type <code>tbxi</code> (Toolbox Image). If this does not work, see the advanced section below.

Huntertur: /* Advanced Booting */ Fix casing

2023-09-26T02:31:07Z

Advanced Booting: Fix casing

← Older revision		Revision as of 02:31, 26 September 2023
Line 19:		Line 19:
	This will attempt to boot the Mac by searching <code>usb0/disk@8</code> for a file with type <code>tbxi</code> (Toolbox Image). If this does not work, see the advanced section below.		This will attempt to boot the Mac by searching <code>usb0/disk@8</code> for a file with type <code>tbxi</code> (Toolbox Image). If this does not work, see the advanced section below.

	== Advanced ~~Booting~~ ==		== Advanced booting ==

	You might need to trick the OS installer into seeing the USB mass storage device as an optical disc. I need to do this to get the Mac OS X 10.5 Leopard installer to boot. Additionally, you might need to boot in a different way.		You might need to trick the OS installer into seeing the USB mass storage device as an optical disc. I need to do this to get the Mac OS X 10.5 Leopard installer to boot. Additionally, you might need to boot in a different way.

Huntertur: Add PowerPC Macs and Open Firmware categories

2021-12-22T20:47:57Z

Add PowerPC Macs and Open Firmware categories

← Older revision		Revision as of 20:47, 22 December 2021
Line 30:		Line 30:

	[[Category:Guides]]		[[Category:Guides]]
			[[Category:PowerPC Macs]]
			[[Category:Open Firmware]]

Huntertur: Migrate page from HTML

2021-12-22T20:46:50Z

Migrate page from HTML

New page

== Before starting ==

Not all PowerPC Macs that have USB ports support booting from USB. My Revision C tray-loading iMac G3, for instance, does not. Your USB mass storage device will not have a <code>/disk@#</code> (where <code>#</code> is an integer) node in the device tree if USB booting is unsupported.

Booting may be slow. If your Mac only supports USB 1.1, the fastest transfer speed you will get is 1.5 MB/s.

Some operating systems might refuse to boot from USB, even when doing the tricks listed below. I can't get the Mac OS X 10.2 (6C115) installer to boot past the "Waiting on root device" phase on any of my Macs when booting from USB.

== Simple booting ==

The USB mass storage device may not appear as a destination in Startup Disk. It might not show in the pre-boot device selection when you hold Option (if your Mac supports that). You will need to enter Open Firmware with Command-Option-O-F. This will bring you to a command-line interface. If your keyboard doesn't work here, try a different one; my wireless keyboard doesn't work here on most of my Macs.

In Open Firmware, the hardware in your Mac is arranged in a device tree. Paths in this device tree can become long, so there are some predefined aliases, such as <code>cd</code>. Aliases for USB ports should also be defined. To see these, take note of which aliases start with <code>usb</code> after entering <code>devalias</code>.

To find your USB mass storage device, you will need to inspect the tree of devices attached to each USB port. To do this, enter <code>dev usb0 ls</code>, replacing <code>usb0</code> with the port you are currently looking at.

If you see a <code>/disk@8</code> (or some other integer) node in the tree, this is your mass storage device. To boot, enter <code>boot usb0/disk@8,\\:tbxi</code>, substituting names as necessary.

This will attempt to boot the Mac by searching <code>usb0/disk@8</code> for a file with type <code>tbxi</code> (Toolbox Image). If this does not work, see the advanced section below.

== Advanced Booting ==

You might need to trick the OS installer into seeing the USB mass storage device as an optical disc. I need to do this to get the Mac OS X 10.5 Leopard installer to boot. Additionally, you might need to boot in a different way.

# Find the full path to your USB mass storage device in the device tree. <code>dev / ls</code>
# Replace the <code>cd</code> alias with this path. <code>devalias cd /path/to/device/disk@#</code>
# Set the boot device. <code>setenv boot-device cd:,\\:tbxi</code>
# Optionally, enable verbose logging. <code>setenv boot-args -v</code>
# Boot in another way. <code>mac-boot</code>

[[Category:Guides]]