[bug #65152] Documentation on format of netboot grub.cfg file name with MAC address is incorrect

[Patrick Zingerle]

URL:
  <https://savannah.gnu.org/bugs/?65152>

                 Summary: Documentation on format of netboot grub.cfg file
name with MAC address is incorrect
                   Group: GNU GRUB
               Submitter: zinga
               Submitted: Fri 12 Jan 2024 02:02:17 PM UTC
                Category: Network
                Severity: Major
                Priority: 5 - Normal
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
         Originator Name: 
        Originator Email: 
             Open/Closed: Open
                 Release: 1.99
                 Release: 
         Discussion Lock: Any
         Reproducibility: Every Time
         Planned Release: None


    _______________________________________________________

Follow-up Comments:


-------------------------------------------------------
Date: Fri 12 Jan 2024 02:02:17 PM UTC By: Patrick Zingerle <zinga>
Currently the documentation at
https://www.gnu.org/software/grub/manual/grub/grub.html#Network says that the
file name format of a grub.cfg to match a client machine via its MAC address
is

‘(FWPATH)’/grub.cfg-‘(MAC ADDRESS OF NIC)’

with an example for

MAC:  52:54:00:ec:33:81

giving

‘(FWPATH)’/grub.cfg-52-54-00-ec-33-81

but using this file name pattern doesn't work in my setup (instead the default
grub.cfg gets loaded).

When adding -01 before the MAC address, i.e. using the format

‘(FWPATH)’/grub.cfg-01-‘(MAC ADDRESS OF NIC)’

which would give

‘(FWPATH)’/grub.cfg-01-52-54-00-ec-33-81

in the example, then the machine specific config gets loaded for the
corresponding MAC address/machine as expected.

A quick glance at the source code at
https://git.savannah.gnu.org/cgit/grub.git/tree/grub-core/net/net.c#n1952 and
the commit message of cb2f15c544895e1f3d540dd39d36c4611bdf5b7b stating

_This procedure is similar to what is used by pxelinux..._

(and pxelinux also uses a format 01-‘(MAC ADDRESS OF NIC)’) this hints to
me that the documentation is incorrect.







    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?65152>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/