From nobody Mon Jun 15 08:55:41 2026 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 4gf3qd5qn3z6hBBQ for ; Mon, 15 Jun 2026 08:55:41 +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 4gf3qd1lkjz40MW for ; Mon, 15 Jun 2026 08:55:41 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1781513741; 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=FzTIDMWAupW6cN9GqI/XD9kYYY2Fjv1stGeKQbDFeOY=; b=ogOieFcNYENjNGtXHqguw/5hHCylunmieCy04kt36FHNpUDnQx+tx2aO0/Fb1RcKjal8eU augZ5GsR3BRmxfIEiWdKYuP8YkdUn/pEGa/fAXaSENYfUjDxREXE0/GmQZ3g/HwlXETWMj 8wA+w6QBKy79T3NxC/Apbnikc20Q4meYXsdAToba+lA2wp3QPTHqcpRvwMEaICkkuJ1gcR N3fKDZMVwsBgLha0vUCwGFRMQAZpUYHISX2yf8nCeVoXymnH8e7keSImI20nG5rPareP8u FuzYTaVayB7pHgBakg+3wQbag8OkqZwHd6h1e1CoO3JzRVNkST3egjU8cP4LmA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1781513741; a=rsa-sha256; cv=none; b=s2PqJtk1FbyoeD7GQJ6WQCfIUbfiILT7/+whYXg48JTLJBj55jAEWr+rAJvVa0qc2lZvB9 vz4biEELMR54SsOdg7MY+68FPf0vkGm2aF3YB7qwwmvfam8YCUFD1GvfANnPigqT4ff80r JDlZDzRJti47KMQOmH70h4axmbZnJdXQo6XIoIs9lNtmv37ea+3/ch8fk3xbAmOZdI9eyW MN95OaJUvRDQu7TO1J0xo1Fic6f/sS57X+vauFwc5MpLolH4bvufdw0OSV9wmKvf5L6jjM 0RhuQGEWZXcLI1AW4j1c77O4lb64AFRCkBZ6soEZ1GDyVNUz2Kdp/UK5DHN7KA== 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=1781513741; 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=FzTIDMWAupW6cN9GqI/XD9kYYY2Fjv1stGeKQbDFeOY=; b=RfLmVHDgs0LH/DTvXaKu2Oq9mFBqzUSq5h7RaKdxBC0gNy0Ej6y6rjgz1WTZj2hjE5SU92 fEB43GhIGBUK0Qn7YSgDQH1xCE5xID4ymFBlnhmE3xAS4Uyll47r1v+UjeTMOTHTgv+sqn F+hY+mB6YAxdCM5YObk19VeSg7AVIADYtdk4AygQ/yTpHU5WnB7HgyjKb+saxFl0wdlguz A0v9BQhoi5LhZtxlHmo1jYGC0e2qjCPiC4N14FP0NZ4hGqyONxXLF5KaS9q55dfG3ddyKI RO85ey/+bfwLL4wN6vTKBinilbfWFzf7FvXfq8WNU9ohQzjgQ6mfz+xPa+RKzw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gf3qd0bmjzpPq for ; Mon, 15 Jun 2026 08:55:41 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3335b by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 15 Jun 2026 08:55:41 +0000 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: d32b6065fd7b - stable/15 - loader.efi.8: Address mandoc -Tlint errors 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: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@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/stable/15 X-Git-Reftype: branch X-Git-Commit: d32b6065fd7bb8d2d54a2fa1a970b670d5f9c896 Auto-Submitted: auto-generated Date: Mon, 15 Jun 2026 08:55:41 +0000 Message-Id: <6a2fbe0d.3335b.6e2b5e60@gitrepo.freebsd.org> The branch stable/15 has been updated by 0mp: URL: https://cgit.FreeBSD.org/src/commit/?id=d32b6065fd7bb8d2d54a2fa1a970b670d5f9c896 commit d32b6065fd7bb8d2d54a2fa1a970b670d5f9c896 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2026-06-12 12:27:04 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2026-06-15 08:55:26 +0000 loader.efi.8: Address mandoc -Tlint errors MFC after: 3 days (cherry picked from commit 8e1f5baa62d7f442a6cbd62d84dd4b4c80920153) --- 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