From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.71) id 1fSLKB-0007Wp-8D for mharc-grub-devel@gnu.org; Mon, 11 Jun 2018 07:49:27 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:39477) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fSLK8-0007WA-9n for grub-devel@gnu.org; Mon, 11 Jun 2018 07:49:25 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fSLK5-0006r9-85 for grub-devel@gnu.org; Mon, 11 Jun 2018 07:49:24 -0400 Received: from smtp03.citrix.com ([162.221.156.55]:40166) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fSLK4-0006pm-W9 for grub-devel@gnu.org; Mon, 11 Jun 2018 07:49:21 -0400 X-IronPort-AV: E=Sophos;i="5.49,501,1520899200"; d="scan'208";a="56945402" From: Roger Pau Monne To: CC: Roger Pau Monne , Daniel Kiper , Subject: [PATCH v3] multiboot2: clarify usage of the address tag Date: Mon, 11 Jun 2018 13:49:02 +0200 Message-ID: <20180611114902.48124-1-roger.pau@citrix.com> X-Mailer: git-send-email 2.17.1 MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8bit X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 162.221.156.55 X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 11 Jun 2018 11:49:25 -0000 Add a note to spell out that if the address tag is not present the file should be loaded using the elf header. Signed-off-by: Roger Pau Monné --- Cc: Daniel Kiper Cc: xen-devel@lists.xenproject.org --- Changes since v2: - Clarify that the address tag must be used if present. Changes since v1: - s/elf/@sc{elf}/ - s/Multiboot/Multiboot2/ --- doc/multiboot.texi | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/multiboot.texi b/doc/multiboot.texi index 2e2d7e74a..df8a0d056 100644 --- a/doc/multiboot.texi +++ b/doc/multiboot.texi @@ -509,6 +509,14 @@ assumes that no bss segment is present. @end table +Note: This information does not need to be provided if the kernel image +is in @sc{elf} format, but it must be provided if the image is in a.out +format or in some other format. When the address tag is present it must +be used in order to load the image, regardless of whether an @sc{elf} +header is also present. Compliant boot loaders must be able to load +images that are either in @sc{elf} format or contain the address tag +embedded in the Multiboot2 header. + @subsection The entry address tag of Multiboot2 header @example -- 2.17.1