From nobody Fri Jun 12 12:28:21 2026 X-Original-To: dev-commits-src-main@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 4gcJhP2B4qz6hjns for ; Fri, 12 Jun 2026 12:28:21 +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 "R13" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gcJhP1SvWz3JJG for ; Fri, 12 Jun 2026 12:28:21 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1781267301; 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=bclGnsCG2Oza8eWvU1lyRM2nNUW7gdDb+A2ElnpaMPE=; b=edrjwSuJwRxLAbaf+tXcvzFRK3fG/o2VgLr07DGPoWJq2mQ/LFXrnOtcHKTf67tyR52gvR zw/GFLkZUl8x1wHs3SCehXwtNS2GIKgZJtMWIqPbRM40wVrSJ4KHrjlMRkYvtJ7LF2pPLt CjOCG6+jZxmy5kQU82uVUST+rK0Hrlq6hcLqcevdtPkGvbwCtMSM+XKWpWnq8r3baSYZq6 MxmAGg5XWQbMSPkPfl3GA7dClUTQM4OV4TgnKQ61CrSqUDhGmd8I+AycGJMKJ2yiQTOAls fByu6OLmCl4jbMLgycuKAW9xzNy0F+ijxCwNoskYovv0AhItzW2hWdceLIsGQA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1781267301; a=rsa-sha256; cv=none; b=C4XBXONlV8ZBdC5rDehcIIGut8wFR3JT4eeWD7ogmdTDyzrN8mKCBLNw8zfps1c72gP1sG Yb9Q734j6iQmmYLvF0HC9hUqdI5s0606zd2H+zUY1dgxBS/DghGSJswkxeCjCGZfIQ/DhX +YVXrmc9KXaKctxlAfRHrcCLMBwSmHR/ppjc7pIYXVKE8aOkklmht9x12VyGyFHDzwCMQT j7wfvILmUr1KQg0zndJG928v5q4OXHMsaVYqdE5O3v8/2q8/V0T3XeiQ5U90pngTs6EBdk D2TbCVyhXtYCFLUABG8wlsL+InzKnq0MJU+Edse43DXc3auyKI49Xx5ur2f4nA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1781267301; 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=bclGnsCG2Oza8eWvU1lyRM2nNUW7gdDb+A2ElnpaMPE=; b=kOLwZEG/eFSb3N4pJoVzV3HIH9qRZH66T63pU286pqGfvMo0cyAkT5QZMM/lFyfJxHoiRj 2rtufUUXxCLIJJWpeynRvYVqJ5Bl/xfzam7f9EfOJ2KvanfpTDU616BrNzMTXXK1hpHi9/ olqyaOsO59Ddj1ivE9rgBNQuOL2lGFKn5z1/7HeV0No4pHJ+dXGsagtO3XxV8OLxxo/knU rqGr91YJa+F95j09qhuQ9bY8SwQpKdqMpAkOr5soGNRD+UH5WyRsqe+1RHurOK/2y/ybK5 Dcvdqb0H641DYY2tomtYG+kfZwhdfYo+TKKxOizWdjFhYHS/jmfFItqqWsVzOA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gcJhP0wWfzcnd for ; Fri, 12 Jun 2026 12:28:21 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 44859 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 12 Jun 2026 12:28:21 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 8e1f5baa62d7 - main - loader.efi.8: Address mandoc -Tlint errors List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list 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/main X-Git-Reftype: branch X-Git-Commit: 8e1f5baa62d7f442a6cbd62d84dd4b4c80920153 Auto-Submitted: auto-generated Date: Fri, 12 Jun 2026 12:28:21 +0000 Message-Id: <6a2bfb65.44859.1d7a1b33@gitrepo.freebsd.org> The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/src/commit/?id=8e1f5baa62d7f442a6cbd62d84dd4b4c80920153 commit 8e1f5baa62d7f442a6cbd62d84dd4b4c80920153 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2026-06-12 12:27:04 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2026-06-12 12:27:38 +0000 loader.efi.8: Address mandoc -Tlint errors MFC after: 3 days --- stand/man/loader.efi.8 | 51 ++++++++++++++++++++++++++++++-------------------- 1 file changed, 31 insertions(+), 20 deletions(-) diff --git a/stand/man/loader.efi.8 b/stand/man/loader.efi.8 index d9ee55ee192e..0c6f7a98429d 100644 --- a/stand/man/loader.efi.8 +++ b/stand/man/loader.efi.8 @@ -2,7 +2,7 @@ .\" SPDX-License-Identifier: BSD-2-Clause .\" .\" Copyright (c) 2019-2022 Netflix, Inc -.\" Copyright (c) 2022 Mateusz Piotrowski <0mp@FreeBSD.org> +.\" Copyright (c) 2022-2026 Mateusz Piotrowski <0mp@FreeBSD.org> .\" Copyright 2022 The FreeBSD Foundation .\" .\" Part of this documentation was written by @@ -30,7 +30,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd April 11, 2026 +.Dd June 8, 2026 .Dt LOADER.EFI 8 .Os .Sh NAME @@ -50,13 +50,15 @@ when installed as the default EFI boot program as described in or when configured as an EFI boot entry with .Xr efibootmgr 8 . .Pp -On systems upgraded from FreeBSD 10 or earlier, the EFI System Partition (ESP) +On systems upgraded from +.Fx 10 +or earlier, the EFI System Partition (ESP) can be too small to accommodate .Nm . In such cases, .Xr boot1.efi 8 -may be retained as the firmware boot program. It -will chain-load the current +may be retained as the firmware boot program. +It will chain-load the current .Pa /boot/loader.efi , which is updated during the .Cm installworld @@ -159,7 +161,7 @@ with the proper port address. PCI or memory mapped ports are beyond the scope of this man page. .Pp The serial ports are assigned as follows on IBM PC compatible systems: -.Bl -column -offset indent ".Sy Windows Name" ".Sy I/O Port Address" ".Sy Typical FreeBSD device" +.Bl -column -offset indent "Windows Name" "I/O Port Address" "Typical FreeBSD device" .It Sy Windows Name Ta Sy I/O Port Address Ta Sy Typical FreeBSD device .It COM1 Ta 0x3f8 Ta Pa /dev/uart0 .It COM2 Ta 0x2f8 Ta Pa /dev/uart1 @@ -172,7 +174,6 @@ Though and .Dv COM4 can vary. -.Pp .Ss Primary Console The primary console is set using the boot flags. These command line arguments set corresponding flags for the kernel. @@ -185,8 +186,8 @@ Boot flags may be set on the command line to the boot command. Inside the kernel, the RB_ flags are used to control behavior, sometimes in architecturally specific ways and are included to aid in discovery of any behavior not covered in this document. -.Bl -column -offset indent ".Sy boot flag" ".Sy loader variable" ".Sy Kernel RB_ flag" -.It Sy boot flag Ta Sy loader variable Ta Sy Kernel RB_ flag +.Bl -column -offset indent "boot flag" "loader variable" "Kernel RB_ flag" +.It Sy Boot Flag Ta Sy Loader Variable Ta Sy Kernel RB_ Flag .It Fl a Ta Dv boot_askme Ta Va RB_ASKNAME .It Fl c Ta Dv boot_cdrom Ta Va RB_CDROM .It Fl d Ta Dv boot_ddb Ta Va RB_KDB @@ -202,7 +203,7 @@ of any behavior not covered in this document. .El .Pp And the following flags determine the primary console: -.Bl -column -offset xxx "Flags" "RB_SERIAL | RB_MULTIPLE" "Kernel Consoles" "Primary Console" +.Bl -column -offset indent "Flags" "RB_SERIAL | RB_MULTIPLE" "Kernel Consoles" "Primary Console" .It Sy Flags Ta Sy Kernel Flags Ta Sy Kernel Consoles Ta Sy Primary Console .It none Ta 0 Ta Video Ta Video .It Fl h Ta RB_SERIAL Ta Serial Ta Serial @@ -220,7 +221,9 @@ serial console otherwise. can set variables early in startup from a file on the EFI partition. By default, that file is .Pa /efi/freebsd/loader.env . -It can be changed by setting the FreeBSD EFI variable +It can be changed by setting the +.Fx +EFI variable .Va LoaderEnv , as in: .Bd -literal -offset indent @@ -317,9 +320,8 @@ Riscv, 32-bit arm and arm64 have always loaded at any .Ad 2MB aligned location, so do not provide .Ic copy_staging . -.Pp .Bd -ragged -offset indent -.Sy Note. +.Sy Note . BIOS loaders on i386 and amd64 put the staging area starting at the physical address .Ad 2M , @@ -378,7 +380,8 @@ The location of the UEFI kernel loader within the system. .El .Ss EFI System Partition .Nm -is installed on the ESP (EFI System Partition) in one of the following locations: +is installed on the 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 @@ -470,7 +473,9 @@ However, care must be taken: some multiple-boot environments rely on a special to function. Before updating a .Pa bootXXX.efi -file, make sure it is the FreeBSD boot loader before updating it: +file, make sure it is the +.Fx +boot loader before updating it: .Bd -literal -offset indent # strings /boot/efi/EFI/BOOT/BOOTX64.EFI | grep FreeBSD | grep EFI FreeBSD/amd64 EFI loader, Revision 3.0 @@ -523,12 +528,18 @@ In addition, .Pa efibootmgr is not supported on armv7 or riscv. In these instances, the user has to understand what was booted to update -it properly (and in most cases, it will be the FreeBSD path and the UEFI default +it properly (and in most cases, it will be the +.Fx +path and the UEFI default so just copy loader.efi there if there are loaders there). -Typically in these embedded situations, there is only one .efi file (loader.efi -or a copy of loader.efi). +Typically in these embedded situations, there is only one +.Pa .efi +file ( +.Pa loader.efi +or a copy of +.Pa loader.efi ) . The path to this file is typically the default removable path above. .Pp -Managing booting multiple OSes on UEFI varies greatly, so extra caution is required +Managing booting multiple OSes on UEFI varies greatly, +so extra caution is required when updating the UEFI default loader. -.Pp