From nobody Mon Apr 04 17:51:42 2022 X-Original-To: dev-commits-src-branches@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 123661A8D1DB; Mon, 4 Apr 2022 17:51:43 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4KXJHf61N8z3KHh; Mon, 4 Apr 2022 17:51:42 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649094702; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Q+GvSfj29AuKPSssHXm0Y7z+KGqLPWp6ZVKNWYg42Zc=; b=h7zI9AsodvZpM9bDoSJTXP7erQB9182ObrBetUzjPJelHQwLmNmsmhB9pDubWdcpjySyyk RjlG0FcnZ15YPS1UZdXCtcOoEHe6LczO1iGvSuBmIHohx3Ul1s+m4CGSxS5hU5P1jKphkh 1XuW1mQpU9gPoU1yjT6P9pRaH6HpsHiwLvkKrbGaC+BHvm3zUgUktgaHBPafoigiqQ9AE9 2L5PCnjMbFPD6rbzk8wDsTIEKCvEgLmNT1cxr1rThVn0mXwjeQpdJsVD4AAZynHFnUmQme WsXOb9aT9c05BvsWgDJJjR6VC7qCJsy0HVUe1j+e63n7EjdgpSZ+Jx1/QoeWDw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id AEE7416A22; Mon, 4 Apr 2022 17:51:42 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 234HpgFi041970; Mon, 4 Apr 2022 17:51:42 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 234Hpgi0041969; Mon, 4 Apr 2022 17:51:42 GMT (envelope-from git) Date: Mon, 4 Apr 2022 17:51:42 GMT Message-Id: <202204041751.234Hpgi0041969@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: e92ad24da5a7 - stable/12 - loader.efi: Improve the manual page List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-branches@freebsd.org X-BeenThere: dev-commits-src-branches@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/stable/12 X-Git-Reftype: branch X-Git-Commit: e92ad24da5a7ea4cb1f74f5b11ffc004345f9b8a Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649094702; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Q+GvSfj29AuKPSssHXm0Y7z+KGqLPWp6ZVKNWYg42Zc=; b=gjFS6k1bauCBXVEPfC+gzikFTJUSZWLvWwL8X7vdPAjx+LbZzANcPBhYRwRok+GljVJSgd Y62+NhOIE/l1OqlGXvgv+TOjp5R29qHHoq93J3xnJ6iDAHznB/oHP9TBOnTqFkRQLooonB t1E9wkeaKI8vGQeaRSs1/Z67AjZvZMEo6pkFtdNkTPVBe1hukF31hbA3kXb1WYyjb4gD1c SP+GaLee9KQVcJtuWX/YzXG+TNWMnGNalWPRDGIceQ/pn5S8c7ldqKfHdi4R0fCST1bCMT H8OzMz2kCwR7F+YurT0jvrQvX/Y+fTFVp8nXTdJl8S3z3D7TnAv/c5Yj1ZBArQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1649094703; a=rsa-sha256; cv=none; b=wkjrBxRb3WKKHhIpYTugVtyINU4oMBBfJBKkqd73DGUDmkPX3UqbdLpwmSH4lxZEvXDcI9 T+j9kGkK5g/JrdCNs6zJYQy9QGMQ281YN3L2DPn0C1tVGHo7IOuf+NyisVpujzCtQmpFHx nKy0ne9EAbjzS/SadxGEIFhX2I+l6b1guDOQt3sjKvO3TLjcw9mOJzaDX3MllXsdyGvDWV vxK4Z0WoN1nFq6BgKg+0qXEMix7yImUipJj7G13cIGZZG05HMIMqNADhYtKh9J/CKuQarA PxSw+zYHA2SS8EDDFUSHqHq+CeeQTNknVCw+xHd4SCNEgp5VwXTdQliUMhpF1A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/12 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=e92ad24da5a7ea4cb1f74f5b11ffc004345f9b8a commit e92ad24da5a7ea4cb1f74f5b11ffc004345f9b8a Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-18 08:54:23 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-04-04 17:50:10 +0000 loader.efi: Improve the manual page - Add SPDX tag - Add a files section describing different locations related to the loader - Add an example explaining how to install a new loader.efi to ESP - Reference uefi(8) Reviewed by: tsoome Reviewed by: Pau Amma Reviewed by: Jose Luis Duran MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D34592 (cherry picked from commit 9ecf6e0f9f257279bb3a7762bc26efb72471c6ea) --- stand/man/loader.efi.8 | 73 ++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 62 insertions(+), 11 deletions(-) diff --git a/stand/man/loader.efi.8 b/stand/man/loader.efi.8 index 960264364c3d..2a19271017fa 100644 --- a/stand/man/loader.efi.8 +++ b/stand/man/loader.efi.8 @@ -1,5 +1,8 @@ .\" +.\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD +.\" .\" Copyright (c) 2019 Netflix, Inc +.\" Copyright (c) 2022 Mateusz Piotrowski <0mp@FreeBSD.org> .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions @@ -24,7 +27,7 @@ .\" .\" $FreeBSD$ .\" -.Dd September 1, 2020 +.Dd March 18, 2022 .Dt LOADER.EFI 8 .Os .Sh NAME @@ -34,17 +37,65 @@ 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 . +.Pp .Xr boot1.efi 8 is used to load .Nm when it is placed within the system. +.Sh FILES +.Bl -tag -width "/boot/loader.efi" +.It Pa /boot/loader.efi +The location of the UEFI kernel loader within the system. +.El +.Ss EFI System Partition +.Nm +is installed on ESP (EFI System Partition) in one of the following locations: +.Bl -tag -width "efi/freebsd/loader.efi" +.It Pa efi/boot/bootXXX.efi +The default location for any EFI loader +.Po see +.Xr uefi 8 +for values to replace +.Ql XXX +with +.Pc . +.It Pa efi/freebsd/loader.efi +The location reserved specifically for the +.Fx +EFI loader. +.El +.Pp +The default location for the ESP mount point is documented in +.Xr hier 7 . +.Sh EXAMPLES +.Ss Updating loader.efi on ESP +The following examples shows how to install a new +.Nm +on ESP. +.Pp +First, find the partition of type +.Dq efi : +.Bd -literal -offset indent +# gpart list | grep -Ew '(Name|efi)' +1. Name: nvd0p1 + type: efi +2. Name: nvd0p2 +3. Name: nvd0p3 +4. Name: nvd0p4 +1. Name: nvd0 +.Ed +.Pp +The name of ESP on this system is +.Pa nvd0p1 . +.Pp +Second, let's mount ESP, copy +.Nm +to the special location reserved for +.Fx +EFI loaders, and unmount once finished: +.Bd -literal -offset indent +# mount_msdosfs /dev/nvd0p1 /boot/efi +# cp /boot/loader.efi /boot/efi/efi/freebsd/loader.efi +# umount /boot/efi +.Sh SEE ALSO +.Xr uefi 8