.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
-.\" You should have received a copy of the GNU General Public License
-.\" along with this program; if not, write to the Free Software
+.\" You should have received a copy of the GNU General Public License
+.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
.\"
-.TH YBIN 8 "27 April 2001" "GNU/Linux PowerPC" "System Manager's Manual"
+.TH YBIN 8 "21 November 2001" "GNU/Linux PowerPC" "System Manager's Manual"
.SH NAME
.B ybin
\- install the yaboot boot loader to a bootstrap partition.
.SH SYNOPSIS
-.B ybin
+.B ybin
.RB [ \ \-b | \-\-boot\ \fIdevice\ ]
.RB [ \ \-o | \-\-ofboot\ \fIof-path\ ]
.RB [ \ \-i | \-\-install\ \fIboot-file\ ]
.RB [ \ \-\-hide\ ]
.RB [ \ \-\-protect\ ]
.RB [ \ \-\-nonvram\ ]
-.RB [ \ \-\-device\ \fIOF-dev\ ]
-.RB [ \ \-\-partition\ \fIroot-part-#\ ]
-.RB [ \ \-\-timeout\ \fItimeout\ ]
-.RB [ \ \-\-image\ \fIkernel\ ]
-.RB [ \ \-\-label\ \fIlabel\ ]
-.RB [ \ \-\-root\ \fIroot-dev\ ]
.RB [ \ \-\-force\ ]
.RB [ \ \-v | \-\-verbose\ ]
.RB [ \ \-\-debug\ ]
.RB [ \ \-h | \-\-help\ ]
.RB [ \ \-V | \-\-version\ ]
.SH DESCRIPTION
-This manual page explains
-.B ybin
-the installer for the
-.BR yaboot (8)
+This manual page explains
+.B ybin
+the installer for the
+.BR yaboot (8)
boot loader enabling GNU/Linux to be booted by OpenFirmware.
-Specifically it copies the
+Specifically it copies the
.B yaboot
-binary and
+binary and
.BR yaboot.conf (5)
-and usually a \*(lqmagicboot\*(rq script to a
+and usually a \*(lqmagicboot\*(rq script to a
.BR bootstrap (8)
-partition.
+partition.
.B Ybin
will set attributes on the boot loader files and to the
of the \fBbootstrap\fR(8) partition using \fBnvsetenv\fR(8) when a
NewWorld compatible version of \fBnvsetenv\fR(8) is available.
-.B Ybin
-requires that the
+.B Ybin
+requires that the
.BR bootstrap (8)
-partition have an HFS or MSDOS filesystem already on it. For IBM
+partition have an HFS filesystem already on it. For IBM
hardware there is no filesystem on the \fBbootstrap\fR(8) partition,
in this case use fstype=raw. When using the raw filesystem type
\fBybin\fR requires that an ELF binary have already been installed on
the \fBbootstrap\fR(8) partition. Use the companion
-.BR mkofboot (8)
-utility to install the boot loader onto a new
+.BR mkofboot (8)
+utility to install the boot loader onto a new
.BR bootstrap (8)
-partition.
+partition.
The \fBbootstrap\fR(8) need not and should not be mounted anywhere on
your filesystem, especially not on top of /boot. \fBYaboot\fR is able
.BR \-b ,\ \-\-boot\ \fIdevice
Install the boot loader onto the specified device, this device should
be that of your \fBbootstrap\fR(8) partition. For example, if your
-\fBbootstrap\fR partition is located on your first primary IDE drive in the
+\fBbootstrap\fR partition is located on your first primary IDE drive in the
second partition, your device would be: \fI/dev/hda2\fR.
.TP
.BR \-o ,\ \-\-ofboot\ \fIof-path
Prevent \fBybin\fR from setting the OpenFirmware boot-device
variable with \fBnvsetenv\fR(8).
.TP
-.BR \-\-device\ \fIopenfirmware-dev-path
-This option is used for auto-generation of a \fByaboot.conf\fR(5). This
-specifies the OpenFirmware device of the disk the system will boot
-from. The default is \*(lqhd:\*(rq.
-.TP
-.BR \-\-partition\ \fIroot-partition-number
-This option is used for auto-generation of a \fByaboot.conf\fR(5). This
-specifies the partition number of the root filesystem. Mac partition
-tables are considered a partition themselves, so the first real
-partition will be 2, usually the \fBbootstrap\fR(8) partition, followed
-by the root partition, number 3.
-.TP
-.BR \-\-timeout\ \fItimeout
-This option is used for auto-generation of a \fByaboot.conf\fR(5). This
-specifies the timeout value in tenths of a second. The timeout is how
-long \fByaboot\fR(8) will wait before booting the default (first listed)
-image.
-.TP
-.BR \-\-image\ \fIkernel-image
-This option is used for auto-generation of a \fByaboot.conf\fR(5). This
-specifies the path to the default kernel to be booted.
-.TP
-.BR \-\-label\ \fIlabel
-This option is used for auto-generation of a \fByaboot.conf\fR(5). This
-specifies the label used to boot the above kernel image. The default
-is Linux.
-.TP
-.BR \-\-root\ \fIroot-device
-This option is used for auto-generation of a \fByaboot.conf\fR(5). This
-specifies the Linux device for the root partition, this is passed to
-the kernel at boot time. The default is \fI/dev/hda3\fR.
-.TP
.BR \-v ,\ \-\-verbose
This option causes \fBybin\fR to be more verbose as it proceeds.
.TP
.br
The temporary directory \fBybin\fR will use.
.SH SECURITY
-The \fByaboot.conf\fR(5) auto generation requires a temporary file, this
-file is created with
+Temporary files are created with
.BR mktemp (1).
-It is important that your system use a secure
+It is important that your system use a secure
.BR mktemp (1)
program, otherwise \fBybin\fR will be vulnerable to race conditions.
The Debian mktemp is derived from OpenBSD and thus should be secure.
by anyone but root since a different \fIofboot\fR script could be
specified there.
.SH BUGS
-.B Ybin
+.B Ybin
should be able to take care of OpenFirmware variables as needed on IBM
hardware.
.SH AUTHORS
.B ybin
-and this man page was written by Ethan Benson.
+and this man page was written by Ethan Benson.
.br
.B yaboot
was written by Benjamin Herrenschmidt.
.SH REPORTING BUGS
Report bugs to <erbenson@alaska.net>
-.br
-Report bugs in \fByaboot\fR(8) to <benh@kernel.crashing.org>
.SH SEE ALSO
.BR bootstrap (8),
.BR hfsutils (1),