[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v3 5/5] docs: Update info with grub.cfg netboot selection order
From: |
Javier Martinez Canillas |
Subject: |
[PATCH v3 5/5] docs: Update info with grub.cfg netboot selection order |
Date: |
Tue, 22 Oct 2019 10:48:14 +0200 |
From: Robert Marshall <address@hidden>
Add documentation to the grub info page that specifies the order
netboot clients use to select a grub configuration file.
Signed-off-by: Robert Marshall <address@hidden>
Signed-off-by: Javier Martinez Canillas <address@hidden>
---
Changes in v3:
- Add a patch documenting the grub.cfg netboot selection order.
Changes in v2: None
docs/grub.texi | 42 ++++++++++++++++++++++++++++++++++++++++++
1 file changed, 42 insertions(+)
diff --git a/docs/grub.texi b/docs/grub.texi
index 5ac61c09d1b..e7c5b1968b3 100644
--- a/docs/grub.texi
+++ b/docs/grub.texi
@@ -2486,6 +2486,48 @@ grub-mknetdir --net-directory=/srv/tftp
--subdir=/boot/grub -d /usr/lib/grub/i38
Then follow instructions printed out by grub-mknetdir on configuring your DHCP
server.
+The grub.cfg file is placed in the same directory as the path output by
+grub-mknetdir hereafter referred to as FWPATH. GRUB will search for its
+configuration files in order using the following rules where the appended
+value corresponds to a value on the client machine.
+
+@example
+@group
+@samp{(FWPATH)}/grub.cfg-@samp{(UUID OF NIC)}
+@samp{(FWPATH)}/grub.cfg-@samp{(MAC ADDRESS OF NIC)}
+@samp{(FWPATH)}/grub.cfg-@samp{(IPv4 OR IPv6 ADDRESS)}
+@samp{(FWPATH)}/grub.cfg
+@end group
+@end example
+
+The client will only attempt to look up an IPv6 address config once, however,
+it will try the IPv4 multiple times. The concrete example below shows what
+would happen under the IPv4 case.
+
+@example
+@group
+UUID: 7726a678-7fc0-4853-a4f6-c85ac36a120a
+MAC: 52:54:00:ec:33:81
+IPV4: 10.0.0.130 (0A000082)
+@end group
+@end example
+
+@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-0A000082
+@samp{(FWPATH)}/grub.cfg-0A00008
+@samp{(FWPATH)}/grub.cfg-0A0000
+@samp{(FWPATH)}/grub.cfg-0A000
+@samp{(FWPATH)}/grub.cfg-0A00
+@samp{(FWPATH)}/grub.cfg-0A0
+@samp{(FWPATH)}/grub.cfg-0A
+@samp{(FWPATH)}/grub.cfg-0
+@samp{(FWPATH)}/grub.cfg
+@end group
+@end example
+
After GRUB has started, files on the TFTP server will be accessible via the
@samp{(tftp)} device.
--
2.21.0
- [PATCH v3 0/5] Search for specific config files using UUID, MAC and IP, Javier Martinez Canillas, 2019/10/22
- [PATCH v3 1/5] Add %X option to printf functions, Javier Martinez Canillas, 2019/10/22
- [PATCH v3 2/5] net/dhcp: Consistently use hexadecimal numbers for options enum, Javier Martinez Canillas, 2019/10/22
- [PATCH v3 3/5] net/dhcp: Set net_<interface>_client{id, uuid} variables from DHCP options, Javier Martinez Canillas, 2019/10/22
- [PATCH v3 4/5] normal/main: Search for specific config files for netboot, Javier Martinez Canillas, 2019/10/22
- [PATCH v3 5/5] docs: Update info with grub.cfg netboot selection order,
Javier Martinez Canillas <=