From patchwork Tue Dec 6 22:52:49 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Kiper X-Patchwork-Id: 9463363 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id BF94360231 for ; Tue, 6 Dec 2016 22:57:11 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B14B727CF5 for ; Tue, 6 Dec 2016 22:57:11 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id A5C26284C0; Tue, 6 Dec 2016 22:57:11 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=2.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, UNPARSEABLE_RELAY autolearn=ham version=3.3.1 Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 5C26A27CF5 for ; Tue, 6 Dec 2016 22:57:11 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cEOcI-0007JK-AO; Tue, 06 Dec 2016 22:53:42 +0000 Received: from mail6.bemta6.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cEOcH-0007J9-3v for xen-devel@lists.xenproject.org; Tue, 06 Dec 2016 22:53:41 +0000 Received: from [193.109.254.147] by server-6.bemta-6.messagelabs.com id A3/F7-28843-47147485; Tue, 06 Dec 2016 22:53:40 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrLLMWRWlGSWpSXmKPExsXSO6nOVbfY0T3 C4M9dS4vvWyYzOTB6HP5whSWAMYo1My8pvyKBNWPHpRuMBZv4Kzo2HmJpYGzj6WLk4hASmMAk 8X/HQkYI5w+jxNWGOSwQzgZGiVNNZ1i7GDlByhglFi2KAbHZBHQkLn55yA5iiwiYSTyb2QDWz SxwkFGiadsWJpCEsICPxMFzNxhBbBYBVYnVHbPAGngF3CWeb9wDZksIKEp0P5vABmJzCnhI/P n1hxlimbvEiYYLrBA1hhKfNy5lnsDIt4CRYRWjRnFqUVlqka6RhV5SUWZ6RkluYmaOrqGBmV5 uanFxYnpqTmJSsV5yfu4mRmCwMADBDsbzawMPMUpyMCmJ8ooruEcI8SXlp1RmJBZnxBeV5qQW H2KU4eBQkuC1dQDKCRalpqdWpGXmAMMWJi3BwaMkwrvJDijNW1yQmFucmQ6ROsWoKCXOywjSJ wCSyCjNg2uDxcolRlkpYV5GoEOEeApSi3IzS1DlXzGKczAqCfOygEzhycwrgZv+CmgxE9DiE8 edQRaXJCKkpBoYWZhSLs/YLupx0WTru/8Nxvunvp3S7rlArnNu+Ryly2+yZl/h/7OuvO+LQd+ 2yY9naAgq5PyqPBd24bFdUTiHQOPbx7k9PxqvvZ9Vtey51E0By+uJ3hLKCxLW31nat/tf4sHv rNE81xpWVQQpaq2Zu6lx/9ScZXUH5aYs/RB4gb/VXqlCstSCUYmlOCPRUIu5qDgRAPDNMHeQA gAA X-Env-Sender: daniel.kiper@oracle.com X-Msg-Ref: server-3.tower-27.messagelabs.com!1481064818!75748073!1 X-Originating-IP: [141.146.126.69] X-SpamReason: No, hits=0.0 required=7.0 tests=sa_preprocessor: VHJ1c3RlZCBJUDogMTQxLjE0Ni4xMjYuNjkgPT4gMjc3MjE4\n X-StarScan-Received: X-StarScan-Version: 9.0.16; banners=-,-,- X-VirusChecked: Checked Received: (qmail 59075 invoked from network); 6 Dec 2016 22:53:39 -0000 Received: from aserp1040.oracle.com (HELO aserp1040.oracle.com) (141.146.126.69) by server-3.tower-27.messagelabs.com with DHE-RSA-AES256-GCM-SHA384 encrypted SMTP; 6 Dec 2016 22:53:39 -0000 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 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] Cc: jgross@suse.com, eric.snowberg@oracle.com, arvidjaar@gmail.com, andrew.cooper3@citrix.com, tsoome@me.com, seth.goldberg@oracle.com, phcoder@gmail.com Subject: [Xen-devel] [MULTIBOOT2 DOC PATCH v3 01/13] multiboot2: Replace u_phys with u32 X-BeenThere: xen-devel@lists.xen.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" X-Virus-Scanned: ClamAV using ClamSMTP 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