Changeset View
Changeset View
Standalone View
Standalone View
stand/man/boot1.efi.8
Show All 18 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" 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 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd September 1, 2020 | .Dd April 6, 2021 | ||||
.Dt BOOT1.EFI 8 | .Dt BOOT1.EFI 8 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm boot1.efi | .Nm boot1.efi | ||||
.Nd UEFI chain loader | .Nd UEFI chain loader | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
.Nm | .Nm | ||||
has been deprecated and will be removed from a future release. | has been deprecated and will be removed from a future release. | ||||
.Xr loader.efi 8 handles all its former use cases with more flexibility. | .Xr loader.efi 8 | ||||
handles all its former use cases with more flexibility. | |||||
.Pp | .Pp | ||||
On UEFI systems, | On UEFI systems, | ||||
.Nm | .Nm | ||||
loads | loads | ||||
.Pa /boot/loader.efi | .Pa /boot/loader.efi | ||||
from the default root file system and transfers execution there. | from the default root file system and transfers execution there. | ||||
Some systems may need to use | |||||
.Xr gptboot.efi 8 | |||||
when | |||||
.Xr loader.efi 8 | |||||
cannot be used directly on the ESP (EFI System Partition). | |||||
.Ss Initialization | .Ss Initialization | ||||
Before looking for the boot device, | Before looking for the boot device, | ||||
.Nm | .Nm | ||||
does the following initialization | does the following initialization | ||||
.Bl -bullet | .Bl -bullet | ||||
.It | .It | ||||
Sets up the console using the default UEFI console routines. | Sets up the console using the default UEFI console routines. | ||||
.It | .It | ||||
Show All 38 Lines | |||||
.It | .It | ||||
There's no way to interrupt the boot process to select booting from some | There's no way to interrupt the boot process to select booting from some | ||||
other location. | other location. | ||||
.It | .It | ||||
When configuring a serial console for FreeBSD, but not for UEFI, no output | When configuring a serial console for FreeBSD, but not for UEFI, no output | ||||
will show up on the serial console from boot1.efi. | will show up on the serial console from boot1.efi. | ||||
.It | .It | ||||
There's no support for marking partitions as the preferred one. | There's no support for marking partitions as the preferred one. | ||||
See | |||||
.Xr gptboot.efi 8 . | |||||
.It | .It | ||||
There's no support for boot-once functionality. | There's no support for boot-once functionality. | ||||
See | |||||
.Xr gptboot.efi 8 . | |||||
.El | .El |