bless.1   [plain text]


.TH BLESS 1 "June 4, 2001" "Apple Computer, Inc."
.SH NAME
bless \- set boot options for volumes and Open Firmware
.SH SYNOPSIS
.B bless
-info
.I mountpoint
[
-plist
]
[
-verbose
] [
-bootBlocks
]

.B bless
[
-bootinfo
.I "arg"
] [
-bootBlocks
] [
-noexec
] [
-folder
.I folder
] [
-folder9
.I folder
] [
-quiet
] [
-setOF
] [
-use9
] [
-verbose
]
.SH DESCRIPTION
The
.I bless
command modifies on-disk an Open Firmware-based parameters used during the
boot sequence. It allows folders the be \(lqblessed\(rq in the volume header, which
allows OF to find the loader program (usually BootX).
.I bless
also sets Open Firmware variables to boot off the volume specified.
.PP
In the first usage, the following flags apply:
.TP
.B \-bootBlocks
Display important data from the boot blocks for the specified volume
.TP
.B \-info mountpoint
Choose the volume mounted at
.I mountpoint
to print information about.
.TP
.B \-plist
Display the requested information as a Property List using the
CoreFoundation API.
.TP
.B \-verbose
Be verbose while collecting data and accessing the volume.
.PP
Root privelege is not required to collect this information, although you must
have read access to the volume.
.PP
The second form of the command can take:
.TP
.B \-bootinfo arg
Create a new BootX file in the folder specified by
.B \-folder.
.B arg
should point to a
.I bootx.bootinfo
file, most commonly /System/Library/CoreServices/bootx.bootinfo
.TP
.B \-bootBlocks
Create boot blocks for the specified volume by extracting them from the
'boot' 1 resource of the
.I System
file contained in
.B \-folder9. Write these boot blocks to the volume.
.TP
.B \-noexec
Simulate execution of
.B bless
without performing any permanent changes to the system.
This flag is used by default when
.B bless
is run by a non-root user.
.TP
.B \-folder folder
The Mac OS X/Darwin folder to by blessed. This folder should have
a valid BootX file (unless
.B \-bootinfo
was also specified to create a new one). The folder's volume is what
all disk operations will be performed on. This is most commonly
/System/Library/CoreServices
.TP
.B \-folder9 folder
The Mac OS 9 System folder to bless. This folder should have a valid
System file and Finder. If
.I CarbonCore
is available, the
.B \-bootBlocks
option is also available. 
.TP
.B \-quiet
Don't print out any information except errors
.TP
.B \-setOF
Using the volume where
.B \-folder
resides (or both
.B \-folder
and
.B \-folder9,
if both were specified), set Open Firmware variables to boot off this device.
.TP
.B \-use9
If both
.B \-folder
and
.B \-folder9
were specified, prefer
.B \-folder9
as the primary blessed folder.
.TP
.B \-verbose
Be verbose while collecting data and accessing the volume.

.SH EXAMPLES

Darwin and Mac OS 9 are on seperate partitions, and want to boot into OS 9:

bless -folder9 "/Volumes/Mac OS 9/System Folder" -setOF

Darwin and Mac OS 9 on the same partition, and want to boot into OS 9:

bless -folder "/System/Library/CoreServices" -folder9 "/Volumes/Mac OS 9/System Folder"

Darwin and Mac OS X  on seperate partitions, and want to boot into Mac OS X:

bless -folder "/Volumes/Mac OS X/System/Library/CoreServices" -setOF

BootX file needs to be created (for creating a bootable partition):

bless -folder "/Volumes/Test/System/Library/CoreServices" -bootinfo /usr/standalone/ppc/bootx.bootinfo

.SH BUGS
.B bless
is only intelligent enough to deal with HFS+ volumes for most cases. It will
detect external booters, but other functionality may not work and has not been well-tested.