From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.90_1) id 1npchU-0005Pr-Rs for mharc-grub-devel@gnu.org; Fri, 13 May 2022 17:19:52 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:36664) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1npchS-0005PZ-Oc for grub-devel@gnu.org; Fri, 13 May 2022 17:19:50 -0400 Received: from mail-vk1-xa31.google.com ([2607:f8b0:4864:20::a31]:46757) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1npchQ-0001Pd-TG for grub-devel@gnu.org; Fri, 13 May 2022 17:19:50 -0400 Received: by mail-vk1-xa31.google.com with SMTP id m203so4789641vke.13 for ; Fri, 13 May 2022 14:19:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=efficientek-com.20210112.gappssmtp.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=bf8e1yhbVCQ/Jk3M6Qoxl4253FvUYTkn61hApHl6JYU=; b=teo3Z8y2exBrcXHyv7PZDxAeu5HiHbFXoA5auPDJGhwSfSXuRijEFGYHvS9tFMNs6Q R8r9BSZq9UqOALIon0ovxMaFr5kYCr2UNuNKk7cJHATZFBz7W4m9ogq+7hcT+zNkskk/ iOrIBP1ITVFJEJz3q3OjOzzbhSKQedzZR3k6VA7eMx/fipD6Htrzc9C4U6s9KA3oANIx AAxYKLax91dYDU4w/2gjHhUJDleWPjdN3/UkdHNBhcRNwBpCIaGwvAmhazypATK8YgGz u+LeBVAizry0nstRRGNKB+4fWuZyaONWusQ5J14/8ZPKsaPUGNCRCqFMQo+HpyQXbPK5 qctw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=bf8e1yhbVCQ/Jk3M6Qoxl4253FvUYTkn61hApHl6JYU=; b=s3sEcsedRj0AQInbAB296G7in+HFNeVaSco4nFUhktnal4ubMI/vRFoWF9Jqkr+VvI Qr1sXPQfwGEjqKLfcXQoe9PdOhpEnJJe7Gv8gGYnRnjTdkwz3SKgi6z+8MU+n3vtRGdv ti3RmnUcJGV2QUmi1gInUfzq/n+KUM81xkQ5Ie9HgPakTrnzUx5zqcrxk1RM5PolNU6r AaxiHZ1zmrQN+wecESGQ8gnDJrbiKr8VQrZ6i/58x3rEb3kPLcc+TkjF5R8LhBSN7ecs xxnXmBctjz3fax3D6xmpmOEa2S1/TERB+UxkgfL6DhqeLZgnR1DcOWjzvheon/PxMsFX APLQ== X-Gm-Message-State: AOAM531zF66rMq/U4K2KWKkf0akuuxMQea0x0zYJ1oozSwf5yYHywlqv 9DpgW91V1OJ/GkNjrcUTQtGX8XWrdTk1HPi5 X-Google-Smtp-Source: ABdhPJzpBy9esreyA+4EqRO3ILS6dzQGK72UWFHqnbEH13Y+r9qkTevc7hWgJGO8XoIfen2AtQF68g== X-Received: by 2002:a05:6122:695:b0:352:be3b:c07 with SMTP id n21-20020a056122069500b00352be3b0c07mr2998985vkq.40.1652476787078; Fri, 13 May 2022 14:19:47 -0700 (PDT) Received: from localhost.localdomain ([37.218.244.249]) by smtp.gmail.com with ESMTPSA id 188-20020a1f17c5000000b0034e6f1fd058sm402020vkx.34.2022.05.13.14.19.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 13 May 2022 14:19:46 -0700 (PDT) From: Glenn Washburn To: grub-devel@gnu.org, Daniel Kiper Cc: Glenn Washburn Subject: [PATCH] docs: Document undocumented variables Date: Fri, 13 May 2022 16:19:32 -0500 Message-Id: <20220513211932.3572698-1-development@efficientek.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2607:f8b0:4864:20::a31; envelope-from=development@efficientek.com; helo=mail-vk1-xa31.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 May 2022 21:19:50 -0000 Document the variables net__clientid, net__clientuuid, lockdown, and shim_lock in the list of special environment variables. Signed-off-by: Glenn Washburn --- docs/grub.texi | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/docs/grub.texi b/docs/grub.texi index 5de94d062..3c8bcd6ed 100644 --- a/docs/grub.texi +++ b/docs/grub.texi @@ -2613,6 +2613,12 @@ The network interface's IP address. Read-only. @item net_@var{}_mac The network interface's MAC address. Read-only. +@item net_@var{}_clientid +The client id provided by DHCP. Read-only. + +@item net_@var{}_clientuuid +The client uuid provided by DHCP. Read-only. + @item net_@var{}_hostname The client host name provided by DHCP. Read-only. @@ -3278,9 +3284,12 @@ These variables have special meaning to GRUB. * icondir:: * lang:: * locale_dir:: +* lockdown:: * menu_color_highlight:: * menu_color_normal:: * net_@var{}_boot_file:: +* net_@var{}_clientid:: +* net_@var{}_clientuuid:: * net_@var{}_dhcp_server_name:: * net_@var{}_domain:: * net_@var{}_extensionspath:: @@ -3299,6 +3308,7 @@ These variables have special meaning to GRUB. * pxe_default_gateway:: * pxe_default_server:: * root:: +* shim_lock:: * superusers:: * theme:: * timeout:: @@ -3593,6 +3603,13 @@ default for this variable if internationalization is needed and any translation files are available. +@node lockdown +@subsection lockdown + +If this variable is set to @samp{y}, it means that GRUB has entered +@pxref{Lockdown} mode. + + @node menu_color_highlight @subsection menu_color_highlight @@ -3622,6 +3639,18 @@ The default is the value of @samp{color_normal} (@pxref{color_normal}). @xref{Network}. +@node net_@var{}_clientid +@subsection net_@var{}_clientid + +@xref{Network}. + + +@node net_@var{}_clientuuid +@subsection net_@var{}_clientuuid + +@xref{Network}. + + @node net_@var{}_dhcp_server_name @subsection net_@var{}_dhcp_server_name @@ -3742,6 +3771,13 @@ disk, then @samp{prefix} might be set to @samp{(hd0,msdos1)/boot/grub} and @samp{root} to @samp{hd0,msdos1}. +@node shim_lock +@subsection shim_lock + +If this variable is set to @samp{y}, it means that the shim_lock verifier +is registered (see @pxref{UEFI secure boot and shim}). + + @node superusers @subsection superusers -- 2.34.1