Blame SOURCES/0155-Update-info-with-grub.cfg-netboot-selection-order-11.patch

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