From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.71) id 1UZm25-0001A7-Fj for mharc-grub-devel@gnu.org; Tue, 07 May 2013 13:50:33 -0400 Received: from eggs.gnu.org ([208.118.235.92]:40175) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UZm1z-00012y-Qg for grub-devel@gnu.org; Tue, 07 May 2013 13:50:30 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UZm1x-0001yD-AC for grub-devel@gnu.org; Tue, 07 May 2013 13:50:27 -0400 Received: from mail-lb0-f174.google.com ([209.85.217.174]:51724) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UZm1w-0001xL-Lt for grub-devel@gnu.org; Tue, 07 May 2013 13:50:25 -0400 Received: by mail-lb0-f174.google.com with SMTP id r10so1008924lbi.5 for ; Tue, 07 May 2013 10:50:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:date:from:to:subject:message-id:in-reply-to:references :x-mailer:mime-version:content-type; bh=dkHHKoVc75Cq7FRFkL1d58YMzHwHCkROuH1xzeZErCU=; b=oecTjCBtmJsL0lc6TCn5VaAiCBFA4lyez0MBXpJbR5ocAUa0izJNunLBD9HID81aku w5sd3fBRB4Ha8zsV2G4sc50ORONHT9Yv4Nghn4SP99i4wpwY6R1QBgP1qATcVuvTKoHs XsLw1Jn2PQNtnGsop+2McUoCBOQ9JajyLBxwDwLsKnlIMHRNgMVk4QeikQOo9e0TGP7b 2jHZKS6AArrem8MVuzQNmvn3kgHPEgHNbBmfDdP1jklMwzJRd1jNII82ZFjQtN+EZ7OF AhO3jSDP/1m2RxEYwux0uLCAnwqyZ5HJd5pOf3BRUTva6A08SKGqM+ExWEbeb+PGeG1d AF4Q== X-Received: by 10.112.148.166 with SMTP id tt6mr1466326lbb.129.1367949022262; Tue, 07 May 2013 10:50:22 -0700 (PDT) Received: from opensuse.site ([94.29.72.160]) by mx.google.com with ESMTPSA id n5sm6132559lbe.15.2013.05.07.10.50.21 for (version=SSLv3 cipher=RC4-SHA bits=128/128); Tue, 07 May 2013 10:50:21 -0700 (PDT) Date: Tue, 7 May 2013 21:50:20 +0400 From: Andrey Borzenkov To: grub-devel@gnu.org Subject: Documentation for (Re: Obtaining the MAC address of the boot NIC for a PXE boot) Message-ID: <20130507215020.5771cd87@opensuse.site> In-Reply-To: <5188D187.3040302@gmail.com> References: <1367240132.58582.YahooMailNeo@web120204.mail.ne1.yahoo.com> <20130501185934.3f2b9c28@opensuse.site> <518578B3.5040003@gmail.com> <51857B76.6080001@gmail.com> <20130505091708.13b0a8c8@opensuse.site> <5188D187.3040302@gmail.com> X-Mailer: Claws Mail 3.9.0 (GTK+ 2.24.14; x86_64-suse-linux-gnu) Mime-Version: 1.0 Content-Type: multipart/signed; micalg=PGP-SHA1; boundary="Sig_/7Yb8b0H65OaFuQLmH75yESL"; protocol="application/pgp-signature" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.85.217.174 X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: The development of GNU GRUB List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 07 May 2013 17:50:31 -0000 --Sig_/7Yb8b0H65OaFuQLmH75yESL Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable =D0=92 Tue, 07 May 2013 12:03:51 +0200 Vladimir '=CF=86-coder/phcoder' Serbinenko =D0=BF=D0=B8= =D1=88=D0=B5=D1=82: > Fixed this and another problem with it, tested and now comitting. >=20 Below documentation for new variables. It also changes variables description to indicate that they contain variable interface name (do we need to list possible values?). OK to commit? From: Andrey Borzenkov To: grub-devel@gnu.org Subject: [PATCH] document new net_default_(interface|ip|mac) variables Also generalize description to indicate that other variables may apply to more than pxe interface. Signed-off-by: Andrey Borzenkov --- docs/grub.texi | 111 +++++++++++++++++++++++++++++++++++++++--------------= ---- 1 file changed, 76 insertions(+), 35 deletions(-) diff --git a/docs/grub.texi b/docs/grub.texi index bfd42ee..79bbcb0 100644 --- a/docs/grub.texi +++ b/docs/grub.texi @@ -2134,36 +2134,49 @@ this should be changed both in the prefix and in an= y references to the device name in the configuration file. =20 GRUB provides several environment variables which may be used to inspect or -change the behaviour of the PXE device: +change the behaviour of the PXE device. In the following description +@var{} is placeholder for the name of network interface (platfo= rm +dependent): =20 @table @samp -@item net_pxe_ip -The IP address of this machine. Read-only. +@item net_@var{}_ip +The network interface's IP address. Read-only. =20 -@item net_pxe_mac +@item net_@var{}_mac The network interface's MAC address. Read-only. =20 -@item net_pxe_hostname +@item net_@var{}_hostname The client host name provided by DHCP. Read-only. =20 -@item net_pxe_domain +@item net_@var{}_domain The client domain name provided by DHCP. Read-only. =20 -@item net_pxe_rootpath +@item net_@var{}_rootpath The path to the client's root disk provided by DHCP. Read-only. =20 -@item net_pxe_extensionspath +@item net_@var{}_extensionspath The path to additional DHCP vendor extensions provided by DHCP. Read-only. =20 -@item net_pxe_boot_file +@item net_@var{}_boot_file The boot file name provided by DHCP. Read-only. =20 -@item net_pxe_dhcp_server_name +@item net_@var{}_dhcp_server_name The name of the DHCP server responsible for these boot parameters. Read-only. =20 +@item net_default_interface +The name of interface that was used to load grub. Read-only. + +@item net_default_ip +The IP address of default interface. Read-only. This is alias for the +@samp{net_$@{net_default_interface@}_ip}. + +@item net_default_mac +The default interface's MAC address. Read-only. This is alias for the +@samp{net_$@{net_default_interface@}_mac}. + @item net_default_server -The default server. Read-write, although setting this is only useful +The default TFTP server. Read-write, although setting this is only useful before opening a network device. =20 @end table @@ -2735,14 +2748,18 @@ These variables have special meaning to GRUB. * locale_dir:: * menu_color_highlight:: * menu_color_normal:: -* net_pxe_boot_file:: -* net_pxe_dhcp_server_name:: -* net_pxe_domain:: -* net_pxe_extensionspath:: -* net_pxe_hostname:: -* net_pxe_ip:: -* net_pxe_mac:: -* net_pxe_rootpath:: +* net_@var{}_boot_file:: +* net_@var{}_dhcp_server_name:: +* net_@var{}_domain:: +* net_@var{}_extensionspath:: +* net_@var{}_hostname:: +* net_@var{}_ip:: +* net_@var{}_mac:: +* net_@var{}_rootpath:: +* net_default_interface:: +* net_default_ip:: +* net_default_mac:: +* net_default_server:: * pager:: * prefix:: * pxe_blksize:: @@ -3009,50 +3026,74 @@ variable changes those colors. For the available c= olor names, The default is the value of @samp{color_normal} (@pxref{color_normal}). =20 =20 -@node net_pxe_boot_file -@subsection net_pxe_boot_file +@node net_@var{}_boot_file +@subsection net_@var{}_boot_file + +@xref{Network}. + + +@node net_@var{}_dhcp_server_name +@subsection net_@var{}_dhcp_server_name + +@xref{Network}. + + +@node net_@var{}_domain +@subsection net_@var{}_domain + +@xref{Network}. + + +@node net_@var{}_extensionspath +@subsection net_@var{}_extensionspath + +@xref{Network}. + + +@node net_@var{}_hostname +@subsection net_@var{}_hostname =20 @xref{Network}. =20 =20 -@node net_pxe_dhcp_server_name -@subsection net_pxe_dhcp_server_name +@node net_@var{}_ip +@subsection net_@var{}_ip =20 @xref{Network}. =20 =20 -@node net_pxe_domain -@subsection net_pxe_domain +@node net_@var{}_mac +@subsection net_@var{}_mac =20 @xref{Network}. =20 =20 -@node net_pxe_extensionspath -@subsection net_pxe_extensionspath +@node net_@var{}_rootpath +@subsection net_@var{}_rootpath =20 @xref{Network}. =20 =20 -@node net_pxe_hostname -@subsection net_pxe_hostname +@node net_default_interface +@subsection net_default_interface =20 @xref{Network}. =20 =20 -@node net_pxe_ip -@subsection net_pxe_ip +@node net_default_ip +@subsection net_default_ip =20 @xref{Network}. =20 =20 -@node net_pxe_mac -@subsection net_pxe_mac +@node net_default_mac +@subsection net_default_mac =20 @xref{Network}. =20 =20 -@node net_pxe_rootpath -@subsection net_pxe_rootpath +@node net_default_server +@subsection net_default_server =20 @xref{Network}. =20 --=20 tg: (48f959f..) u/default_interface (depends on: master) --Sig_/7Yb8b0H65OaFuQLmH75yESL Content-Type: application/pgp-signature; name=signature.asc Content-Disposition: attachment; filename=signature.asc -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.19 (GNU/Linux) iEYEARECAAYFAlGJPtwACgkQR6LMutpd94yLewCgrAM3hTyJssJJPK63Ryad7Qob 0mMAoNDnDdVz9fJrGOeXV/BQgM28XX/2 =OmLU -----END PGP SIGNATURE----- --Sig_/7Yb8b0H65OaFuQLmH75yESL--