[PATCH 0/1] docs: Small Fixes for Network, Secure Boot, PXE

[PATCH 0/1] docs: Small Fixes for Network, Secure Boot, PXE

[Andrew Hamilton]

Currently the GRUB Manual has a few small issues captured in bug 
reports (54480, 62004, and 65152). These are related to issues in
documentation for environment variables "pxe_default_server",
"pxe_default_gateway"; incorrect statement that "chainloader" does
not support secure boot; and an issue in network boot documentation
for the searched grub.cfg name.

These issues have been updated in the grub manual (grub.texi).

From user perspective, this patch improve / correct / clarify
documentation around PXE, Secure Boot, and Network booting.

Andrew Hamilton (1):
  Correct documentation for pxe_default_server, pxe_default_gatway, and
    pxe_blksize. Only pxe_default_server is actually used (alias for
    net_default_server) so capture this, and remove the other two.
    Correct documentation for secure boot with UEFI to remove statement
    that chainloader does not work with secure boot, as this was added
    by a previous GRUB update. Correct the documentation for the
    grub.cfg searching via network that will be done based on a given
    MAC address (was missing the Ethernet Type - 01).

 docs/grub.texi | 35 ++++++++++++-----------------------
 1 file changed, 12 insertions(+), 23 deletions(-)


base-commit: b53ec06a1d6f22ffc1139cbfc0f292e4ca2da9cd
-- 
2.39.2


_______________________________________________
Grub-devel mailing list
Grub-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/grub-devel

[PATCH 1/1] docs: Small Fixes for Network, Secure Boot, PXE

[Andrew Hamilton]

Correct documentation for pxe_default_server, pxe_default_gatway, 
and pxe_blksize. Only pxe_default_server is actually used  (alias 
for net_default_server) so capture this, and remove the other two.
Correct documentation for secure boot with UEFI to remove statement 
that chainloader does not work with secure boot, as this was added 
by a previous GRUB update. Correct the documentation for the 
grub.cfg searching via network that will be done based on a given 
MAC address (was missing the Ethernet Type - 01).

Closes: https://savannah.gnu.org/bugs/?54480
Closes: https://savannah.gnu.org/bugs/?62004
Closes: https://savannah.gnu.org/bugs/?65152

Signed-off-by: Andrew Hamilton <adhamilt@gmail.com>
---
 docs/grub.texi | 35 ++++++++++++-----------------------
 1 file changed, 12 insertions(+), 23 deletions(-)

diff --git a/docs/grub.texi b/docs/grub.texi
index a050dc0fc..69ddf09e2 100644
--- a/docs/grub.texi
+++ b/docs/grub.texi
@@ -2571,7 +2571,7 @@ value corresponds to a value on the client machine.
 @example
 @group
 @samp{(FWPATH)}/grub.cfg-@samp{(UUID OF MACHINE)}
-@samp{(FWPATH)}/grub.cfg-@samp{(MAC ADDRESS OF NIC)}
+@samp{(FWPATH)}/grub.cfg-01-@samp{(MAC ADDRESS OF NIC)}
 @samp{(FWPATH)}/grub.cfg-@samp{(IPv4 OR IPv6 ADDRESS)}
 @samp{(FWPATH)}/grub.cfg
 @end group
@@ -2596,7 +2596,7 @@ IPV4: 10.0.0.130 (0A000082)
 @example
 @group
 @samp{(FWPATH)}/grub.cfg-7726a678-7fc0-4853-a4f6-c85ac36a120a
-@samp{(FWPATH)}/grub.cfg-52-54-00-ec-33-81
+@samp{(FWPATH)}/grub.cfg-01-52-54-00-ec-33-81
 @samp{(FWPATH)}/grub.cfg-0A000082
 @samp{(FWPATH)}/grub.cfg-0A00008
 @samp{(FWPATH)}/grub.cfg-0A0000
@@ -2680,6 +2680,9 @@ The default interface's MAC address.  Read-only.  This is alias for the
 The default server used by network drives (@pxref{Device syntax}).  Read-write,
 although setting this is only useful before opening a network device.
 
+@item pxe_default_server
+This performs the same function as @samp{net_default_server}.
+
 @end table
 
 
@@ -3310,8 +3313,6 @@ These variables have special meaning to GRUB.
 * net_default_server::
 * pager::
 * prefix::
-* pxe_blksize::
-* pxe_default_gateway::
 * pxe_default_server::
 * root::
 * shim_lock::
@@ -3755,18 +3756,6 @@ dynamically loaded from this directory, so it must be set correctly in order
 for many parts of GRUB to work.
 
 
-@node pxe_blksize
-@subsection pxe_blksize
-
-@xref{Network}.
-
-
-@node pxe_default_gateway
-@subsection pxe_default_gateway
-
-@xref{Network}.
-
-
 @node pxe_default_server
 @subsection pxe_default_server
 
@@ -6579,13 +6568,13 @@ secure boot chain.
 @node UEFI secure boot and shim
 @section UEFI secure boot and shim support
 
-The GRUB, except the @command{chainloader} command, works with the UEFI secure
-boot and the shim. This functionality is provided by the shim_lock verifier. It
-is built into the @file{core.img} and is registered if the UEFI secure boot is
-enabled. The @samp{shim_lock} variable is set to @samp{y} when shim_lock verifier
-is registered. If it is desired to use UEFI secure boot without shim, one can
-disable shim_lock by disabling shim verification with MokSbState UEFI variable
-or by building grub image with @samp{--disable-shim-lock} option.
+The GRUB works with UEFI secure boot and the shim. This functionality is
+provided by the shim_lock verifier. It is built into the @file{core.img} and is
+registered if the UEFI secure boot is enabled. The @samp{shim_lock} variable is
+set to @samp{y} when shim_lock verifier is registered. If it is desired to use
+UEFI secure boot without shim, one can disable shim_lock by disabling shim
+verification with MokSbState UEFI variable or by building grub image with
+@samp{--disable-shim-lock} option.
 
 All GRUB modules not stored in the @file{core.img}, OS kernels, ACPI tables,
 Device Trees, etc. have to be signed, e.g, using PGP. Additionally, the commands
-- 
2.39.2


_______________________________________________
Grub-devel mailing list
Grub-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/grub-devel

Re: [PATCH 0/1] docs: Small Fixes for Network, Secure Boot, PXE

[Andrew Hamilton]

[-- Attachment #1.1: Type: text/plain, Size: 1564 bytes --]

Any feedback on this? If needed and can make a new version against current
main branch.

Thanks,
Andrew

On Sun, Aug 18, 2024 at 11:21 AM Andrew Hamilton <adhamilt@gmail.com> wrote:

> Currently the GRUB Manual has a few small issues captured in bug
> reports (54480, 62004, and 65152). These are related to issues in
> documentation for environment variables "pxe_default_server",
> "pxe_default_gateway"; incorrect statement that "chainloader" does
> not support secure boot; and an issue in network boot documentation
> for the searched grub.cfg name.
>
> These issues have been updated in the grub manual (grub.texi).
>
> From user perspective, this patch improve / correct / clarify
> documentation around PXE, Secure Boot, and Network booting.
>
> Andrew Hamilton (1):
>   Correct documentation for pxe_default_server, pxe_default_gatway, and
>     pxe_blksize. Only pxe_default_server is actually used (alias for
>     net_default_server) so capture this, and remove the other two.
>     Correct documentation for secure boot with UEFI to remove statement
>     that chainloader does not work with secure boot, as this was added
>     by a previous GRUB update. Correct the documentation for the
>     grub.cfg searching via network that will be done based on a given
>     MAC address (was missing the Ethernet Type - 01).
>
>  docs/grub.texi | 35 ++++++++++++-----------------------
>  1 file changed, 12 insertions(+), 23 deletions(-)
>
>
> base-commit: b53ec06a1d6f22ffc1139cbfc0f292e4ca2da9cd
> --
> 2.39.2
>
>

[-- Attachment #1.2: Type: text/html, Size: 2007 bytes --]

[-- Attachment #2: Type: text/plain, Size: 141 bytes --]

_______________________________________________
Grub-devel mailing list
Grub-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/grub-devel

Re: [PATCH 0/1] docs: Small Fixes for Network, Secure Boot, PXE

[Daniel Kiper]

On Thu, Oct 03, 2024 at 09:05:46AM -0500, Andrew Hamilton wrote:
> Any feedback on this? If needed and can make a new version against current main
> branch.

Yes, please...

Daniel

_______________________________________________
Grub-devel mailing list
Grub-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/grub-devel

Re: [PATCH 0/1] docs: Small Fixes for Network, Secure Boot, PXE

[Andrew Hamilton]

Will do, sorry for the delay (was on vacation), I will submit a v2 shortly.

Thanks,
Andrew

On Wed, Oct 9, 2024 at 8:07 AM Daniel Kiper <dkiper@net-space.pl> wrote:
>
> On Thu, Oct 03, 2024 at 09:05:46AM -0500, Andrew Hamilton wrote:
> > Any feedback on this? If needed and can make a new version against current main
> > branch.
>
> Yes, please...
>
> Daniel

_______________________________________________
Grub-devel mailing list
Grub-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/grub-devel