Date: Tue, 1 Sep 2020 07:46:27 +0000 (UTC) From: Warner Losh <imp@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r365024 - head/stand/man Message-ID: <202009010746.0817kRAq015686@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: imp Date: Tue Sep 1 07:46:27 2020 New Revision: 365024 URL: https://svnweb.freebsd.org/changeset/base/365024 Log: Document boot1.efi Crude man page for boo1.efi. Added: head/stand/man/boot1.efi.8 (contents, props changed) Modified: head/stand/man/Makefile Modified: head/stand/man/Makefile ============================================================================== --- head/stand/man/Makefile Tue Sep 1 06:06:32 2020 (r365023) +++ head/stand/man/Makefile Tue Sep 1 07:46:27 2020 (r365024) @@ -2,6 +2,9 @@ .include <bsd.init.mk> +.if ${MK_EFI} != "no" +MAN+= boot1.efi.8 +.endif MAN+= loader.8 .include <bsd.prog.mk> Added: head/stand/man/boot1.efi.8 ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ head/stand/man/boot1.efi.8 Tue Sep 1 07:46:27 2020 (r365024) @@ -0,0 +1,99 @@ +.\" +.\" Copyright (c) 2020 Netflix, Inc +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd September 1, 2020 +.Dt BOOT1.EFI 8 +.Os +.Sh NAME +.Nm boot1.efi +.Nd UEFI chain loader +.Sh DESCRIPTION +.Nm +has been deprecated and will be removed from a future release. +.Xr loader.efi 8 handles all its former use cases with more flexibility. +.Pp +On UEFI systems, +.Nm +loads +.Pa /boot/loader.efi +from the default root file system and transfers execution there. +.Ss Initialization +Before looking for the boot device, +.Nm +does the following initialization +.Bl -bullet +.It +Sets up the console using the default UEFI console routines. +.It +Discovers all possible block devices on the system. +.It +Initializes all file system modules to read files from those devices +.El +.Ss Boot Device Selection +.Nm +uses the following sequence to determine the root file system for +booting: +.Bl -bullet +.It +If ZFS is configured, +.Nm +will search the for zpools that are bootable, preferring the zpool on +the boot device over the others. +.It +If UFS is configured, +.Nm +will search all UFS partitions for a bootable partition. +It will prefer the lowest numbered bootable partition on the boot +device over all other choices. +It will fall back to partitions on other devices if none are found. +.El +.Pp +A partition is considered bootable if it can load +.Pa /boot/loader.efi +from it. +Command line arguments to the next boot stage are +read from the first existing file of +.Pa /boot.config +or +.Pa /boot/config +in that order. +.Ss Caveats +.Bl -bullet +.It +The order in which file systems are tried is undefined. +.It +No encryption support is available. +.It +There's no way to interrupt the boot process to select booting from some +other location. +.It +When configuring a serial console for FreeBSD, but not for UEFI, no output +will show up on the serial console from boot1.efi. +.It +There's no support for marking partitions as the preferred one. +.It +There's no support for boot-once functionality. +.El
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202009010746.0817kRAq015686>