9074bf3
From 10cb311daec38e6098c583f48136d9c24db58624 Mon Sep 17 00:00:00 2001
f4c76c0
From: Robert Marshall <rmarshall@redhat.com>
f4c76c0
Date: Mon, 16 Mar 2015 16:34:51 -0400
f4c76c0
Subject: [PATCH 68/74] Update info with grub.cfg netboot selection order
f4c76c0
 (#1148650)
f4c76c0
f4c76c0
Added documentation to the grub info page that specifies the order
f4c76c0
netboot clients will use to select a grub configuration file.
f4c76c0
f4c76c0
Resolves rhbz#1148650
f4c76c0
---
f4c76c0
 docs/grub.texi | 42 ++++++++++++++++++++++++++++++++++++++++++
f4c76c0
 1 file changed, 42 insertions(+)
f4c76c0
f4c76c0
diff --git a/docs/grub.texi b/docs/grub.texi
f4c76c0
index 0d34036..367b8f7 100644
f4c76c0
--- a/docs/grub.texi
f4c76c0
+++ b/docs/grub.texi
f4c76c0
@@ -2414,6 +2414,48 @@ grub-mknetdir --net-directory=/srv/tftp --subdir=/boot/grub -d /usr/lib/grub/i38
f4c76c0
 Then follow instructions printed out by grub-mknetdir on configuring your DHCP
f4c76c0
 server.
f4c76c0
 
f4c76c0
+The grub.cfg file is placed in the same directory as the path output by
f4c76c0
+grub-mknetdir hereafter referred to as FWPATH. GRUB will search for its 
f4c76c0
+configuration files in order using the following rules where the appended
f4c76c0
+value corresponds to a value on the client machine.
f4c76c0
+
f4c76c0
+@example
f4c76c0
+@group
f4c76c0
+@samp{(FWPATH)}/grub.cfg-@samp{(UUID OF NIC)}
f4c76c0
+@samp{(FWPATH)}/grub.cfg-@samp{(MAC ADDRESS OF NIC)}
f4c76c0
+@samp{(FWPATH)}/grub.cfg-@samp{(IPv4 OR IPv6 ADDRESS)}
f4c76c0
+@samp{(FWPATH)}/grub.cfg
f4c76c0
+@end group
f4c76c0
+@end example
f4c76c0
+
f4c76c0
+The client will only attempt to look up an IPv6 address config once, however,
f4c76c0
+it will try the IPv4 multiple times. The concrete example below shows what
f4c76c0
+would happen under the IPv4 case.
f4c76c0
+
f4c76c0
+@example
f4c76c0
+@group
f4c76c0
+UUID: 7726a678-7fc0-4853-a4f6-c85ac36a120a
f4c76c0
+MAC:  52:54:00:ec:33:81
f4c76c0
+IPV4: 10.0.0.130 (0A000082)
f4c76c0
+@end group
f4c76c0
+@end example
f4c76c0
+
f4c76c0
+@example
f4c76c0
+@group
f4c76c0
+@samp{(FWPATH)}/grub.cfg-7726a678-7fc0-4853-a4f6-c85ac36a120a
f4c76c0
+@samp{(FWPATH)}/grub.cfg-52-54-00-ec-33-81
f4c76c0
+@samp{(FWPATH)}/grub.cfg-0A000082
f4c76c0
+@samp{(FWPATH)}/grub.cfg-0A00008
f4c76c0
+@samp{(FWPATH)}/grub.cfg-0A0000
f4c76c0
+@samp{(FWPATH)}/grub.cfg-0A000
f4c76c0
+@samp{(FWPATH)}/grub.cfg-0A00
f4c76c0
+@samp{(FWPATH)}/grub.cfg-0A0
f4c76c0
+@samp{(FWPATH)}/grub.cfg-0A
f4c76c0
+@samp{(FWPATH)}/grub.cfg-0
f4c76c0
+@samp{(FWPATH)}/grub.cfg
f4c76c0
+@end group
f4c76c0
+@end example
f4c76c0
+
f4c76c0
 After GRUB has started, files on the TFTP server will be accessible via the
f4c76c0
 @samp{(tftp)} device.
f4c76c0
 
f4c76c0
-- 
f4c76c0
2.4.3
f4c76c0