X-Git-Url: http://git.ozlabs.org/?p=yaboot.git;a=blobdiff_plain;f=man%2Fybin.8;h=7239882ba51999a6637d5bb254cb74a35b2238e7;hp=7489f94560571e4d71f44fdd8cd8beceb8edb4be;hb=86a488e2f3078a2a4e9942f1ec9d0fb1a3a632ad;hpb=f4ebbd9f7ea23e3f0fcbe098754580c220894628 diff --git a/man/ybin.8 b/man/ybin.8 index 7489f94..7239882 100644 --- a/man/ybin.8 +++ b/man/ybin.8 @@ -13,16 +13,16 @@ .\" 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\ ] @@ -34,30 +34,24 @@ .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 @@ -70,18 +64,18 @@ will also set the OpenFirmware boot-device variable to the device path 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 @@ -93,7 +87,7 @@ they should be kept. \fBYbin\fR will refuse to operate on the .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 @@ -165,38 +159,6 @@ HFS and MSDOS filesystems. 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 @@ -224,10 +186,9 @@ Print out the version number and exit. .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. @@ -238,19 +199,17 @@ root. It is also critical that \fI/etc/yaboot.conf\fR not be writable 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 -.br -Report bugs in \fByaboot\fR(8) to .SH SEE ALSO .BR bootstrap (8), .BR hfsutils (1),