From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.71) id 1cEOcL-00065Y-EI for mharc-grub-devel@gnu.org; Tue, 06 Dec 2016 17:53:45 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:52426) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cEOcH-00063X-5C for grub-devel@gnu.org; Tue, 06 Dec 2016 17:53:42 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cEOcE-0005kH-2n for grub-devel@gnu.org; Tue, 06 Dec 2016 17:53:41 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:33013) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cEOcD-0005jm-PI for grub-devel@gnu.org; Tue, 06 Dec 2016 17:53:37 -0500 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id uB6MrWhh002973 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 6 Dec 2016 22:53:33 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id uB6MrWEE012269 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 6 Dec 2016 22:53:32 GMT Received: from abhmp0009.oracle.com (abhmp0009.oracle.com [141.146.116.15]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id uB6MrWQt014777; Tue, 6 Dec 2016 22:53:32 GMT Received: from olila.local.net-space.pl (/10.175.227.19) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 06 Dec 2016 14:53:31 -0800 From: Daniel Kiper To: grub-devel@gnu.org, xen-devel@lists.xenproject.org Cc: andrew.cooper3@citrix.com, arvidjaar@gmail.com, eric.snowberg@oracle.com, jgross@suse.com, konrad.wilk@oracle.com, phcoder@gmail.com, seth.goldberg@oracle.com, tsoome@me.com Subject: [MULTIBOOT2 DOC PATCH v3 01/13] multiboot2: Replace u_phys with u32 Date: Tue, 6 Dec 2016 23:52:49 +0100 Message-Id: <1481064781-16949-2-git-send-email-daniel.kiper@oracle.com> X-Mailer: git-send-email 1.7.10.4 In-Reply-To: <1481064781-16949-1-git-send-email-daniel.kiper@oracle.com> References: <1481064781-16949-1-git-send-email-daniel.kiper@oracle.com> X-Source-IP: userv0022.oracle.com [156.151.31.74] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-Received-From: 141.146.126.69 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: Tue, 06 Dec 2016 22:53:42 -0000 u_phys is used just in two places and sometimes it may confuse reader. Additionally, GRUB multiboot2 implementation does not use u_phys anywhere. So, replace it with basic well defined and used in implementation u32 type. Signed-off-by: Daniel Kiper --- doc/multiboot.texi | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/doc/multiboot.texi b/doc/multiboot.texi index 4b92918..2bda9b7 100644 --- a/doc/multiboot.texi +++ b/doc/multiboot.texi @@ -299,9 +299,6 @@ little-endian, u32 is coded in little-endian. The type of unsigned 64-bit data. Because the target architecture is little-endian, u64 is coded in little-endian. -@item u_phys -The type of unsigned data of the same size as target architecture physical address size. - @item u_virt The type of unsigned data of the same size as target architecture virtual address size. @@ -840,8 +837,8 @@ zero-terminated UTF-8 string. +-------------------+ u32 | type = 3 | u32 | size | -u_phys | mod_start | -u_phys | mod_end | +u32 | mod_start | +u32 | mod_end | u8[n] | string | +-------------------+ @end group @@ -850,8 +847,8 @@ u8[n] | string | This tag indicates to the kernel what boot module was loaded along with the kernel image, and where it can be found. -The @samp{mod_start} and @samp{mod_end} contain the start and end addresses of the boot -module itself. The @samp{string} field provides an arbitrary string to +The @samp{mod_start} and @samp{mod_end} contain the start and end physical addresses +of the boot module itself. The @samp{string} field provides an arbitrary string to be associated with that particular boot module; it is a zero-terminated UTF-8 string, just like the kernel command line. Typically the string might be a command line (e.g. if the operating system treats boot -- 1.7.10.4