From nobody Mon Jun 15 08:55:39 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 4gf3qj638Dz6hBKw for ; Mon, 15 Jun 2026 08:55:45 +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 4gf3qj0nP8z40SY for ; Mon, 15 Jun 2026 08:55:45 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1781513745; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=NMaUGsu5uVghhyNXBFrCIxhZs/nipuy35vvhMTFDdjc=; b=AeGh2hsyxGCWTYYucit6akSYSmg+mKjsGjaI6tywKODEfXBlDLxmRwsujCRtuSFMouiyfm 9buxZjOzjYMHP/akJY6XpGzLiHl/gNvQe9hHOmWpQaVxmjGnzC/re3qFuN00zLbd/++5xy drmK3HL1j2wfarCiqLSRjWAO28lNVXVe2f6t1oQ8O5t+wefHj/5q4mE7UGhAlnm5oVuRbg z6jBzGv5XCCu5gc6uvNO6U6DM+vE6BxEdFV4pBU55rnMHT7ybpOso6xZmwfEpIQZDP0yfE E5nceMxn8K0Yyw967ro8Gw8HEppfRLne+Nfjq8dRQ4FtJoDtYNqbCZkCuax5Ng== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1781513745; a=rsa-sha256; cv=none; b=tzpgH8t3PKUnQXFzKA6YkfwRmrbzbic6tCjBTRJl3XYClaXDBXOv3096lfevKZpQid2vRn w7m0GNXQUUWa2ATbpoJmVvfVpYuv/vfnue896vT/Gd9WYhBQwoqw74Hp6l7kxYYr30WKwI x9OA6mpnxhOtlfbmvzTVjzQ3sp4yMSOVMc72skCXbtdKNBb/KhCdnzeGy8MfC9wRIv5JIk knSp7/MreoL1FZJffYQkzWP3RWSnnXlctyNzdFl7DhMPdDnO+ldqTrof0PkP89UsmY86vp zCV+5XZwoAachroV881hT4xvvi2m8mfVybXWBZKq0v6viE6LDEmT2cHRrP48Tw== 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=1781513745; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=NMaUGsu5uVghhyNXBFrCIxhZs/nipuy35vvhMTFDdjc=; b=QA72j/W3m2d06EKJ3hnf1N6gxXeMHWuh7PNetb4/dIEBNMY0PiunUyHXwsQqZTjlPeztWS X7Ng3pGoCwa6WM5qwadMLVeW+itm13kPO+vujns4gTesViIQFOcmzH6MQJ2DGWWZfBnsxz 1JeQlfi6rQQHeGpSrG5j0+drzbvA038mwoj8GiVRYZvG70HQ22xVPlPxrUtfYm1D7Q98/v EGPO19YRtSSomJ9s84QbOHer7HNaUPOlSk+6+vzghvI2dgNqGYEDr07oljUyGChCQOhp9s tm/1XctGFYYIl2N5MfXV7DRcZ8j/uosFW9Wz03koz7Eguf0ajArtKIWxeuF2xg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gf3qj0K9xzpLD for ; Mon, 15 Jun 2026 08:55:45 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3448f by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 15 Jun 2026 08:55:39 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Cc: Paarth Shirsat From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 3bd3b6b9fe4f - stable/15 - loader.efi(8): Document LoaderEnv and NextLoaderEnv EFI variables 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: 3bd3b6b9fe4f221a90a1bea2817d6c4a5f0b51a3 Auto-Submitted: auto-generated Date: Mon, 15 Jun 2026 08:55:39 +0000 Message-Id: <6a2fbe0b.3448f.6edff488@gitrepo.freebsd.org> The branch stable/15 has been updated by 0mp: URL: https://cgit.FreeBSD.org/src/commit/?id=3bd3b6b9fe4f221a90a1bea2817d6c4a5f0b51a3 commit 3bd3b6b9fe4f221a90a1bea2817d6c4a5f0b51a3 Author: Paarth Shirsat AuthorDate: 2026-04-25 15:10:27 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2026-06-15 08:55:26 +0000 loader.efi(8): Document LoaderEnv and NextLoaderEnv EFI variables Describe how the LoaderEnv and NextLoaderEnv variables can be used. PR: 293054 Reviewed by: imp Sponsored by: Wiesbaden Hackathon 202604 Differential Revision: https://reviews.freebsd.org/D56633 (cherry picked from commit 4137c673fa963fdf409eba2f48d615350c988ffe) --- stand/man/loader.efi.8 | 41 +++++++++++++++++++++++++++++++++++++---- 1 file changed, 37 insertions(+), 4 deletions(-) diff --git a/stand/man/loader.efi.8 b/stand/man/loader.efi.8 index 9ff31b02dcb6..d9ee55ee192e 100644 --- a/stand/man/loader.efi.8 +++ b/stand/man/loader.efi.8 @@ -217,14 +217,47 @@ functionality where we use the video console if a keyboard is connected and a serial console otherwise. .Ss Additional Environment Variables .Nm -loads some extra variables early in startup from -.Pa /efi/freebsd/loader.env -from the EFI partition. -Only simple variables can be set here. +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 +.Va LoaderEnv , +as in: +.Bd -literal -offset indent +echo -n /efi/freebsd/alt.env | efivar -w -t 7 \\ + -n cfee69ad-a0de-47a9-93a8-f63106f8ae99-LoaderEnv +.Ed +.Pp +After that is executed, the file +.Pa /efi/freebsd/alt.env +is used instead of +.Pa /efi/freebsd/loader.env . +See +.Xr efivar 8 +for more information on setting EFI variables. +.Pp +The EFI variable +.Va NextLoaderEnv +can be set to the pathname of a second startup file. +That variable is deleted immediately after its value is retrieved, +so setting it will affect only the next boot attempt. +For either variable, a missing file is silently ignored. +.Pp +Only simple variables can be set in the startup file. It can be useful to specify the root filesystem: .Bd -literal -offset indent rootdev=disk0s1a .Ed +.Pp +The startup file contains a series of assignments separated by spaces, +tabs, or newlines. +Quotes are not given any special treatment. +If no +.Li =value +is given, the value +.Li 1 +is used. +Invalid syntax and the like are silently ignored. .Ss Staging Slop The kernel must parse the firmware memory map tables to know what memory it can use.