git: d51e35f3f6e6 - stable/12 - Very preliminary loader.efi(8) man page

From: Kyle Evans <kevans_at_FreeBSD.org>
Date: Fri, 08 Oct 2021 16:09:04 UTC
The branch stable/12 has been updated by kevans:

URL: https://cgit.FreeBSD.org/src/commit/?id=d51e35f3f6e64d15308fd1ac9e2c09bdc6592388

commit d51e35f3f6e64d15308fd1ac9e2c09bdc6592388
Author:     Warner Losh <imp@FreeBSD.org>
AuthorDate: 2020-09-01 07:54:09 +0000
Commit:     Kyle Evans <kevans@FreeBSD.org>
CommitDate: 2021-10-08 08:12:08 +0000

    Very preliminary loader.efi(8) man page
    
    (cherry picked from commit 2b6d38a1db31967572042a0fe01d980475eb32f1)
---
 stand/man/Makefile     |  3 +++
 stand/man/loader.efi.8 | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+)

diff --git a/stand/man/Makefile b/stand/man/Makefile
index 9f0d4fe108d2..73090ae6b1bf 100644
--- a/stand/man/Makefile
+++ b/stand/man/Makefile
@@ -3,5 +3,8 @@
 .include <bsd.init.mk>
 
 MAN+=	loader.8
+.if ${MK_EFI} != "no"
+MAN+=	loader.efi.8
+.endif
 
 .include <bsd.prog.mk>
diff --git a/stand/man/loader.efi.8 b/stand/man/loader.efi.8
new file mode 100644
index 000000000000..112f10b79cdb
--- /dev/null
+++ b/stand/man/loader.efi.8
@@ -0,0 +1,52 @@
+.\"
+.\" Copyright (c) 2019 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 April 25, 2019
+.Dt LOADER.EFI 8
+.Os
+.Sh NAME
+.Nm loader.efi
+.Nd UEFI kernel loader
+.Sh DESCRIPTION
+On UEFI systems,
+.Nm
+loads the kernel.
+It is installed into the ESP (EFI System Partition), either in the
+default location of
+.Pa /efi/boot/bootXXX.efi
+within the ESP, in the
+.Fx
+reserved area as
+.Pa /efi/freebsd/loader.efi
+within the ESP ,
+or within the system as
+.Pa /boot/loader.efi .
+.Xr boot1.efi 8
+is used to load
+.Nm
+when it is placed within the system.
+
+