Received: from list by lists.gnu.org with archive (Exim 4.90_1) id 1iMpqI-0006xh-I5 for mharc-grub-devel@gnu.org; Tue, 22 Oct 2019 04:48:38 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:48896) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iMpqB-0006oq-51 for grub-devel@gnu.org; Tue, 22 Oct 2019 04:48:36 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iMpq9-0004sl-V6 for grub-devel@gnu.org; Tue, 22 Oct 2019 04:48:31 -0400 Received: from mx1.redhat.com ([209.132.183.28]:59084) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iMpq9-0004sT-NB for grub-devel@gnu.org; Tue, 22 Oct 2019 04:48:29 -0400 Received: from mail-wr1-f70.google.com (mail-wr1-f70.google.com [209.85.221.70]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id CCEFD5AFE9 for ; Tue, 22 Oct 2019 08:48:28 +0000 (UTC) Received: by mail-wr1-f70.google.com with SMTP id s17so3131034wrp.17 for ; Tue, 22 Oct 2019 01:48:28 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=Wjr7v+2m8ftb+TWuzK6nm03GgXGVmHFU6rJR5ZoNPoI=; b=XBcNyyfa955+i4kicY/t9jBxZXRRPCcGF4puozwCubi5bC6JDa01bDJxULMuYpdNKX wm0xlRGQMPd2wruz0yHXlhAjs/G6POW72xZP1PDZMT0kGbKXG9bgq0GgpAS0XNcljO34 2J1m8TeIfapfoaTHh1X9lTVyMj5NGomNpVcQZ0p58+0HW3lyjZYSofie5iyzeHnhVP+j T9R7C2ILZ0EuzIu71OePXzt0nK46KaspOowiPsGmD3ut0dioE0qtIIYFcnbuS8lrOogY VdpEyVk5B+C1U2eST8uGBvCnahcxgcN22K+YFEdhht3WZ7OU2j6rYn9c0KYJEXX6tAPc ynCA== X-Gm-Message-State: APjAAAVgPf9PZzC4BbDBPHQ1sosAIAQ29+jEeOT5txQCW6t+k9xEUZsY +QS9hAcXu45Nl5EPMm0uLiqNy+PO0B+8r3g8IpEhdMcx4v+DiehBJldlj17B6XBJ/+xmGko+nX/ 371W4Q28Wplw= X-Received: by 2002:a5d:678e:: with SMTP id v14mr2289844wru.393.1571734107243; Tue, 22 Oct 2019 01:48:27 -0700 (PDT) X-Google-Smtp-Source: APXvYqwhWyVJWuCcU8g+gP1ORkxteIXM+Vper5EI8Lh702M9ONWVwFsMB7HYIIWsRKvpzje/v93a7g== X-Received: by 2002:a5d:678e:: with SMTP id v14mr2289825wru.393.1571734106993; Tue, 22 Oct 2019 01:48:26 -0700 (PDT) Received: from minerva.redhat.com ([90.168.169.92]) by smtp.gmail.com with ESMTPSA id u1sm28276092wru.90.2019.10.22.01.48.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 22 Oct 2019 01:48:26 -0700 (PDT) From: Javier Martinez Canillas To: grub-devel@gnu.org Cc: Vladimir Serbinenko , Daniel Kiper , Paulo Flabiano Smorigo , Robert Marshall , 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 Message-Id: <20191022084814.8071-6-javierm@redhat.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20191022084814.8071-1-javierm@redhat.com> References: <20191022084814.8071-1-javierm@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.132.183.28 X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 22 Oct 2019 08:48:36 -0000 From: Robert Marshall 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 Signed-off-by: Javier Martinez Canillas --- 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=3D/srv/tftp --subdir= =3D/boot/grub -d /usr/lib/grub/i38 Then follow instructions printed out by grub-mknetdir on configuring you= r DHCP server. =20 +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 appende= d +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, how= ever, +it will try the IPv4 multiple times. The concrete example below shows wh= at +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. =20 --=20 2.21.0