Certain levels of IBM firmware will allow the system to boot from an
[yaboot.git] / man / yaboot.conf.5
index b1371bf8cfbb3bcafbbae397b7176004f3a5af82..ba7f12e587788aede6f5be2211730a603d9a25b5 100644 (file)
@@ -6,7 +6,7 @@
 .\" This program is distributed according to the Gnu General Public License.
 .\" See the file COPYING in the ybin source distribution.
 .\"
 .\" This program is distributed according to the Gnu General Public License.
 .\" See the file COPYING in the ybin source distribution.
 .\"
-.TH YABOOT.CONF 5 "25 October 2001" "GNU/Linux PowerPC" "File Formats"
+.TH YABOOT.CONF 5 "28 October 2001" "GNU/Linux PowerPC" "File Formats"
 .SH NAME
 .B yaboot.conf
 \- Configuration file format used by
 .SH NAME
 .B yaboot.conf
 \- Configuration file format used by
@@ -19,7 +19,7 @@ and
 The \fByaboot.conf\fP file is a configuration file for \fByaboot\fP
 which is read during booting, and for \fBybin\fR(8) to generate a boot
 menu and to properly install \fByaboot\fP onto the \fBbootstrap\fP(8)
 The \fByaboot.conf\fP file is a configuration file for \fByaboot\fP
 which is read during booting, and for \fBybin\fR(8) to generate a boot
 menu and to properly install \fByaboot\fP onto the \fBbootstrap\fP(8)
-partition. 
+partition.
 
 \fByaboot.conf\fP provides instructions for \fByaboot\fP. This
 includes which kernels to load and what options to pass to them.
 
 \fByaboot.conf\fP provides instructions for \fByaboot\fP. This
 includes which kernels to load and what options to pass to them.
@@ -63,7 +63,7 @@ is:
 The first form refers to a file or directory on some supported filesystem
 (currently \fIext2\fP, \fIhfs\fP, \fIhfs+\fP or \fIiso9660\fP), the latter
 refers to a range of 512B blocks on a device. For a device block range,
 The first form refers to a file or directory on some supported filesystem
 (currently \fIext2\fP, \fIhfs\fP, \fIhfs+\fP or \fIiso9660\fP), the latter
 refers to a range of 512B blocks on a device. For a device block range,
-either <devicename>, or <part>, or [<m>-<n>] must be given. 
+either <devicename>, or <part>, or [<m>-<n>] must be given.
 
 Optional <devicename> is the OpenFirmware name of the device the file or range
 is located on. See below for its syntax. For OpenFirmware the device
 
 Optional <devicename> is the OpenFirmware name of the device the file or range
 is located on. See below for its syntax. For OpenFirmware the device
@@ -251,8 +251,10 @@ Specifies a file containing a message that is displayed before the
 boot prompt.  You may specify either a plain pathname, in which case
 the default device and partition will be derived from the
 \fIdevice=\fR and \fIpartition=\fR lines in the global section of
 boot prompt.  You may specify either a plain pathname, in which case
 the default device and partition will be derived from the
 \fIdevice=\fR and \fIpartition=\fR lines in the global section of
-\fByaboot.conf\fR, or you can specify a full OpenFirmware device
-path.  Note: only the first 2000 bytes of this file will be read.
+\fByaboot.conf\fR, or you can specify a full OpenFirmware device path,
+the file may be on any \fByaboot\fR(8) supported filesystem.  The message
+file must be plain ASCII text with UNIX newlines.  Note: only the
+first 2000 bytes of this file will be read.
 .TP
 .BI "password=" password
 Protect booting by a password. The password is given in either
 .TP
 .BI "password=" password
 Protect booting by a password. The password is given in either
@@ -338,7 +340,7 @@ filesystem MacOS will mount and debless the OSX partition.  Add this
 option if the OSX menu entry breaks after booting MacOS.  You should
 not use this option if OSX is installed on a UFS filesystem, for UFS
 installs you specify the OSX bootstrap partition which is protected
 option if the OSX menu entry breaks after booting MacOS.  You should
 not use this option if OSX is installed on a UFS filesystem, for UFS
 installs you specify the OSX bootstrap partition which is protected
-against MacOS.  This option requires \fImacosx=\fR to be set.  
+against MacOS.  This option requires \fImacosx=\fR to be set.
 .TP
 .BI "darwin=" of-path
 The OpenFirmware or unix device path to a Darwin boot partition.
 .TP
 .BI "darwin=" of-path
 The OpenFirmware or unix device path to a Darwin boot partition.
@@ -351,7 +353,7 @@ use the \fBofpath\fR(8) utility to determine the OpenFirmware device
 path.
 .TP
 .B "enablecdboot"
 path.
 .TP
 .B "enablecdboot"
-This option adds an entry to the multiboot menu to boot from the CDROM drive. 
+This option adds an entry to the multiboot menu to boot from the CDROM drive.
 .TP
 .B "enablenetboot"
 This option adds an entry to the multiboot menu to boot from the network.
 .TP
 .B "enablenetboot"
 This option adds an entry to the multiboot menu to boot from the network.
@@ -616,7 +618,7 @@ macosx=/dev/hda10
 .SH NOTES
 The format defined in this man page will not work with versions of
 \fByaboot\fR(8) older then 0.6.  The color options only work with
 .SH NOTES
 The format defined in this man page will not work with versions of
 \fByaboot\fR(8) older then 0.6.  The color options only work with
-yaboot 1.0 and later. 
+yaboot 1.0 and later.
 .SH BUGS
 Some
 .B yaboot
 .SH BUGS
 Some
 .B yaboot