From patchwork Wed Oct 5 21:29:36 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alistair Francis X-Patchwork-Id: 9363465 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 C9285600C8 for ; Wed, 5 Oct 2016 21:46:27 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B1B6628CC6 for ; Wed, 5 Oct 2016 21:46:27 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id A613528D05; Wed, 5 Oct 2016 21:46:27 +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=-6.8 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, DKIM_SIGNED, RCVD_IN_DNSWL_HI, T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id BB35728CE5 for ; Wed, 5 Oct 2016 21:46:26 +0000 (UTC) Received: from localhost ([::1]:51450 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bru1B-0007Ea-JU for patchwork-qemu-devel@patchwork.kernel.org; Wed, 05 Oct 2016 17:46:25 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:42648) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bru0t-0007EI-6f for qemu-devel@nongnu.org; Wed, 05 Oct 2016 17:46:08 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bru0o-0007k5-2w for qemu-devel@nongnu.org; Wed, 05 Oct 2016 17:46:07 -0400 Received: from mail-bn3nam01on0053.outbound.protection.outlook.com ([104.47.33.53]:29430 helo=NAM01-BN3-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bru0n-0007jm-SO for qemu-devel@nongnu.org; Wed, 05 Oct 2016 17:46:02 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xilinx.onmicrosoft.com; s=selector1-xilinx-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=WicLlWHhQwBvPzqiCKAO0ZNAaTKvicYE+Ag+gWi0PtE=; b=K/h36QCBJYBYE7aX5ep6X8iTd5fzZtfnqWn9YgiTagqBkOZnzRQsb/eTt3Ccy0o6tPyPCc7oh+VBA5XlKYd4SloCFgwXgwRbHu0oxXTXpNyG4yymsYStO04VH9gUJ94Yxku3S8CB7W67kH5z8ZwLEbe5TVNwEJYzIl15EPhFwfc= Received: from BN1PR02CA0037.namprd02.prod.outlook.com (10.141.56.37) by BN3PR02MB1157.namprd02.prod.outlook.com (10.162.168.150) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.649.16; Wed, 5 Oct 2016 21:30:54 +0000 Received: from BL2NAM02FT039.eop-nam02.prod.protection.outlook.com (2a01:111:f400:7e46::205) by BN1PR02CA0037.outlook.office365.com (2a01:111:e400:2a::37) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.649.16 via Frontend Transport; Wed, 5 Oct 2016 21:30:55 +0000 Authentication-Results: spf=fail (sender IP is 149.199.60.96) smtp.mailfrom=xilinx.com; redhat.com; dkim=none (message not signed) header.d=none; redhat.com; dmarc=none action=none header.from=xilinx.com; Received-SPF: Fail (protection.outlook.com: domain of xilinx.com does not designate 149.199.60.96 as permitted sender) receiver=protection.outlook.com; client-ip=149.199.60.96; helo=xsj-tvapsmtpgw01; Received: from xsj-tvapsmtpgw01 (149.199.60.96) by BL2NAM02FT039.mail.protection.outlook.com (10.152.77.152) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.629.5 via Frontend Transport; Wed, 5 Oct 2016 21:30:53 +0000 Received: from 172-16-1-203.xilinx.com ([172.16.1.203]:49633 helo=xsj-tvapsmtp02.xilinx.com) by xsj-tvapsmtpgw01 with esmtp (Exim 4.63) (envelope-from ) id 1brtm9-0001qZ-DF; Wed, 05 Oct 2016 14:30:53 -0700 Received: from [127.0.0.1] (port=46461 helo=tsj-smtp-dlp1.xlnx.xilinx.com) by xsj-tvapsmtp02.xilinx.com with esmtp (Exim 4.63) (envelope-from ) id 1brtm8-0007lt-Tg; Wed, 05 Oct 2016 14:30:53 -0700 Received: from xsj-tvapsmtp02 (xsj-tvapsmtp02.xilinx.com [172.16.1.203]) by tsj-smtp-dlp1.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id u95LNdw6032472; Wed, 5 Oct 2016 14:23:40 -0700 Received: from [172.19.74.182] (port=38950 helo=xsjalistai50.xilinx.com) by xsj-tvapsmtp02 with esmtp (Exim 4.63) (envelope-from ) id 1brtm8-0007lq-7h; Wed, 05 Oct 2016 14:30:52 -0700 From: Alistair Francis To: , , Date: Wed, 5 Oct 2016 14:29:36 -0700 Message-ID: X-Mailer: git-send-email 2.7.4 X-RCIS-Action: ALLOW X-TM-AS-MML: disable X-TM-AS-Product-Ver: IMSS-7.1.0.1679-8.0.0.1202-22618.005 X-TM-AS-Result: No--9.265-7.0-31-10 X-imss-scan-details: No--9.265-7.0-31-10 X-TMASE-MatchedRID: k/Skl+jnpzBn4EFWTwzgok1Wvi92YKnOveCbyZ3xax7Asr1WBnqxFwJj LDMzzZnzf/wfs2PypZNMFBLyjGb4lR1YpEPWJiyzFYJUGv4DL3yQoBr+SFneJK+gG1Tz5KUpN1L b3d91KD+SZ78Esi9X4IfZVTw70uXuGNqiTn06MuktwsCVUafM+veSCBLDenQDLsN5f1CPVxS2DQ N5h1Hbt00jThl/tkemoUjf3NgEUJ1AYS7mW5FtjZEbNXwHGDRxWuFm7TqL4eEHRc/Muy53ldli7 xXXodC7Y8pnlWhODINXW6gM8Ys8CB8TzIzimOwPC24oEZ6SpSkj80Za3RRg8MCzNgDOissooAe7 cshS7ojtbjAObFLoFbF1ahxvrHlbTndonrbftQg= X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:149.199.60.96; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(7916002)(2980300002)(1110001)(1109001)(339900001)(189002)(199003)(5660300001)(4326007)(356003)(50466002)(33646002)(8676002)(48376002)(2201001)(305945005)(71366001)(7846002)(85426001)(81156014)(81166006)(87936001)(6666003)(50986999)(586003)(626004)(2906002)(106466001)(36756003)(9786002)(229853001)(64026002)(118296001)(8936002)(5001770100001)(11100500001)(5003940100001)(92566002)(105606002)(19580395003)(86362001)(19580405001)(77096005)(47776003)(189998001)(50226002)(41533002)(107986001); DIR:OUT; SFP:1101; SCL:1; SRVR:BN3PR02MB1157; H:xsj-tvapsmtpgw01; FPR:; SPF:Fail; PTR:unknown-60-96.xilinx.com; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2NAM02FT039; 1:4rRElaBLJJgIghnQgxOmYd9/dla7xrYtR516vmxGol7u82oiswHLpeF3r7Vq6iU/OrBFTLu55hurjEs+/y84e38iOG7TybxWlG0jEE3hUcJEzsURLtJhyGr1Jj+cvda70UTBdexbrlN1aAyM6xpc7gyayn31FBNIBN23PEkbgkzzXxl4Fz6Db4vtQFYUvcA2Wqx6SJgiiaIgLby5IyBWZxLCS4AG/awImRA+T94t/NxZA5WX0TDaBIql6ageshKGd5qaMC2fCqE2X1ZVYtzf4bE6suBruBHBeCH8CiR+hX0GkmtyhKn1FpSg0ETMVL7QZWjeD2j9D6bPvv2xJtvkDSWqq7w8N54FLB7ap1JR7RqJe7LGp7IUcBqZnoj21kVdD9vIzA55uCWf3iQLkTOHcNY+LvF9lPz1zlLhARviSJEb7shoQ1BMKYMvMej1ATRxLrk/6JA5TaT8aA48BdyXcD8pD9nuWQKKLzdcpCOH12zrV6e2nzCk0c13QdIN6dqwDFc4KG2k3jDhj6u5wFgK9R3FKjK443WZQ4tLik/xhnnh8laQ7/1i5NGr/pAEIyjddAmcJXea9TV9xD65yVwsUbYwppyJ/Tx/nDEwDQxsC+8= MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: a6e62391-b66d-43a8-359e-08d3ed66e322 X-Microsoft-Exchange-Diagnostics: 1; BN3PR02MB1157; 2:5SQgFszGoykKL6ns434DDjcyd41QDkHax2WIc14aEYRxaX2hNKayF5Ok9+BLJfvE+9vzefTvde0rQYyQfWNbeYLbZEqnfR9GrPFjV2xOjkT/ld+5uHg1tLzNj05GPLnDyMnHenFwKmMQMcya1iRAhuJi+2ZsHynv7jU4dxcf7cMfafvaDJEKUrR3+M2CvqZFa5F7y5EQdU6et3xgB9G1vw==; 3:zBfr0af21vC3vyU89wU0/BNGLkRJawRvzkdu0Z70qXGx5hzzS+Hq3wtedXWYmQ42WUZWuRXssLtaaBGLObpJp/ja6+nflRc3JCEe/TVZ7fZLnXlj25wvTBBJkryy025fYiFML8AmrnlkJP+YyJpoHvf63QtkjLAnWg0uJj4ZQnqpHWL86S5dDfwkcXjt6+uUSYK0GGBiy7ZBhMA3KbZX6krbXHcwNmSkIhXgyj9RmaDxCjtwmYKQr0jPhYfkeYyf X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BN3PR02MB1157; X-Microsoft-Exchange-Diagnostics: 1; BN3PR02MB1157; 25:XPCUZNeHPUyjmkTlfmBIEs2CP6aUr3D8QRQDBG/dk2kwGrwmzrb0bEc3bpyiznU+JEJoJBUV/MBZ7m35Ci4JlsqBrgG9EjGNsgw0WwbMGeY9oVallwHHT6OPl+2oWtprrt4KrpUnzpkPdBS8I6J89KaKt6XoDXx60dlsP5I7dyhkbGat9ZiqJPFoOCA2E6lf+gANSn8RBrA3BefzdGnnopWirZDVfseQ+OxATToRpWTA4zJv9XkQNF11AdnGCaLDFkaUCBFJWhJvLa0yA9yF4rKSYi/JXkfNwiAFcnKChVFag9Ko5nKqxe5cKHILTN2WavDFJ0bNdI5FQLhn9G6XTOLlnx5o2x1yhxujN7EF2nqTo+WOLFkQQpvF4ARpLUtPVsaN5J5a5a88OP8vUqkHLED/T1cPhV6HH67SnOixwKEVgBqcv+v41EjkDokEWJqdzUXbZfecNOP75FLlhls9lubN+e3t/8l3CB8zBtZ2R6H/231pLVMZfJglHB5GEmxF1PGWeXWjGVdebqqC0xpVxwK/gXeWe5LO3f/vNAn2OV0x5j+/KdvvjFtjWeqif5GJgJFqfBH2tqx+gYHDVA0xV/NTbZIIJGIC/4YL3e91wvgNnMkjCKorx8ZQL9BkWSGg11r8SMsnshMLWu6sLorKNb1euLovoG+GkicrpChncdAM3Te8Um72HTbLRk7S1OSA7kkxaaCVh1MZ57Ca0QIMKEVJvUsX8ckymbjXBhWuA7lBVnUnU6cfATENEz+hqQC4aiK3ac2g4DxzisA1gYcIxffN9UvrOsUkve1SSgKg/vo= X-Microsoft-Exchange-Diagnostics: 1; BN3PR02MB1157; 31:jJZD626NwuCCwbXrLoY3bJJIragVuPfQfCZuLbKPIj0HpAJpAKTtMI9esjucVt/jM+0oZJ8VfK3fp8Bo7/9PF77RXbEDmmXbQR3D7Yb4HpRehXPQsXrY5JL99Zozu4zGOnqNsY/0yI1FQE3z8EfiMkOzLxydphkpvvP23gnyToBIRP+C8trx+Sk/l2H4TY9vFTdhWfqtNFJ/nsuSdwRFj2QnqlkAehpALBeFeAbseXRtPX/me+heosVdienuy77Bsv9mgMRWTqyadZvUtvf48Q==; 20:X52rdNyO9MB9uH43WEn6l9tIUvoJKMAc0LPbDOVQ5ABISueJVo+qVLCobpnb6hjs1MexXHJ2uILG5PK+3R6O1gsCb+oxacnBk94Ne02qO8PUG+wHCRWQ79N2kjqRAUng8IOUwicurPX9qNlHvrHUd2/Z9b4zLtkOQkUto+grzzih9LRRiIJBT7ounQun67R00zc3X7XGy201tgHurJm5+kgB2rUkbwJTgtCLyLDiOLcDinS7AQ8PLJzDPz4xiKvYpBeY4C9vfEen3g9GZaHjA1A/LKdMvKDRI0vWyLsC39HE8sFnUjEG/C2EI+dzX/gGzowvjhYn1XiayWSQkfbMUIvQ9KMBvO3grc7B1JqV4l0liI7LMy1fInDX6Or4/847cs+vGISuWtlaO3niY+CTtbdQqLzacjeyalL5o5jgqgT09QsmZJPMacQrYCg9OuXwBcuspu5omWTYYwmxmesRLFYQfExhZ4FBivEu/AfXDSwdwprGw8KGS7YtQVVYF/uA X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(192813158149592); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040176)(601004)(2401047)(5005006)(13017025)(8121501046)(13024025)(13018025)(13015025)(13023025)(3002001)(10201501046)(6055026); SRVR:BN3PR02MB1157; BCL:0; PCL:0; RULEID:; SRVR:BN3PR02MB1157; X-Microsoft-Exchange-Diagnostics: 1; BN3PR02MB1157; 4:TgPhTTayZa/ygi5CFNOsBDF1GihK1E57lU9Za0iPeIfzjLqGoseDMy/OuJ9vNHpGLVU6zu38528Gi4Edgq6Ai7gamWX4jM99DjN/3ZX2mWjHZRi87f5yBZf91gk+n4lWNv1dKn4n7FToFjbN/MCbICZK5wXGG0a5zXI98VGxLJJaJRw4GFN3i0Umqf3Let8BgPfn0zvtVYBRle8bl6awuFE5wbWX2UD8RbRAbfc9QsUcO8n/Jd14pjrf2qClrpzcCb29Ef3DohHM3eRjlwrLUoBHvB8vLRaMeBSvjRhvHtgyMBk0iI8StBAe6AEw94IjLOdupNT4zgsTcmFqQI4nopj/jcZtrRHkQVzvanUkma9f3eCjHBHsecFVKNOR4h5xbMHUI5GVCKXz38kUadsMlgrREQKym9N309INHGZeHOZ9NdNg5hgQbTnaIKPWwds+KpJD4V7hwjVOz2yfczi6KjcG9A3iawiF8eOnQ29IaPd/Xy2ryhTU1VFB9CGIj/Neh827TlYOdjaRXL/gtxN6/SscH9kC2Y7d+xx2eKkZ0HYORt0i+c2fFtC/URGJG1o9 X-Forefront-PRVS: 008663486A X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN3PR02MB1157; 23:fgiWFjzuLGdPSg0ZnKHTEbNg3xbBb9uNxy6u7rZ5V?= =?us-ascii?Q?Dk/iBXEC5dNTCytlnQbF7M+on7HLgIeeF5FL1Pu27rNsFRhKGgz2+kyYaaxA?= =?us-ascii?Q?90PXgBSK8qfOElX7pIMtw1FwHCoRD6pJjM01qQHmv3s1uX2A7cnWKu/qTsPp?= =?us-ascii?Q?YaS9Ge34fHdBpimlb0Nyl7fDzocxuSII/a3f76mbIZLmJQjuz586c9+x1rrF?= =?us-ascii?Q?zJV0QsaDSReUbTREVCJyz0eHOHYCXdNxh6lFwuIlbeX0l0DCH3HqsCcXuek/?= =?us-ascii?Q?yXjF1t6an/BBOewrs+3V95T5PjKNLkGTEyNL8/Rm9fveul9BcQHEISWaEO7T?= =?us-ascii?Q?Jy0wpMPwsPMWOmb0Qh29LZsSK2nKg3Sbptjm2BIwN+PBDw5Mmk7+IGKziqmt?= =?us-ascii?Q?09WWP5iGG7J2NdqeNtW4FZgvliPKhnwIyaWqfW7Jw/J24HASvMdve7QYt9tT?= =?us-ascii?Q?HUrtlXopYgQKDubdggXQGhaICl31XvkT7Ay7UZp3xi4FwHjqTw1iHqJ5HHnn?= =?us-ascii?Q?QkRAlMshOQgsqUmK2fRJT+Sgjo+jU7CJ+y2HlS/WJhFXqdg8Nxs57yz+SMBk?= =?us-ascii?Q?psSCDX1rJPz6vonuwhbUZDbnX18XdBD6E+mrYduYj84xC/S6Z5mufisdYEW2?= =?us-ascii?Q?7fceS/qHbazd405u10ByD/JcnYeIOR3ZPWTzyZN5Yx9OsxiCxHJenlxG/5cm?= =?us-ascii?Q?DNonW7/JbC+KVSsbnu4nLB3toD5TIk7o7HVgFVOLo5OJan6a1aYFLIUA+0TS?= =?us-ascii?Q?mMChZQN3qkpuruE6lf6dfvEEvdqPtr7UyoEKT3Fdx24O/NUs9o9yXNVaVodt?= =?us-ascii?Q?X4hajaKQ/QXyfcFu2i08q7e4pOkbs7jKZ7mdvLW9Kflu17hR4AFjYY6KqzPy?= =?us-ascii?Q?4ebeSX5KMzGfkUcCj6jn5ff1EvXe0ovPeHjJAEYw0o8k10vwbkDiZrNCsN/w?= =?us-ascii?Q?hwpABMVLGQ2TLzM0WwqgNb/Qfr4EI4F3W/c4YnMahHppwDgjPx4Q8KWr8pRi?= =?us-ascii?Q?8s9untADQXyDB+XPQpNCXKvhC1LPezn+3kox5ooifdtk23IkFVaToApRpHcu?= =?us-ascii?Q?oa8P9iMMCc4z7tKe270QhbawXG3tfCghqXJVT3CuOMHNnXhVC9qh1xA5pDRR?= =?us-ascii?Q?krrn1pSKDCoxqnhOf3dto+N/PRVOSbPd39EInAxJBI1fxpmi9Qpmsnk2T8KT?= =?us-ascii?Q?Qsvqe0UoiVirlA=3D?= X-Microsoft-Exchange-Diagnostics: 1; BN3PR02MB1157; 6:Z7DDxGd5FWSUv2DklfZH2TH9H5NS6RsJhjpjCfoxP+HaPqTkOUr09p3u7OSShRKA5jDC53Og+BMGuqukDltErBTL6HJZoFeZt+7h255aQE/uZ0kgxttqBWXLXmwxTcXxaIDd8SfYxHFNIeqE/YBscC3t/9M0oPToTa2JagKPldDLwwaI+4HvGUvmsYck17msesVm6Z8NNP+KqcI4Ns/vA4sTw4zqoHA6u3qWuYn+AotfFrYfK6j8q7wRs7LgfxMs/+TuWhE5+aWXQK2x2Rbwq0bzVQLlaVYdIYAytb6KiE4CG+Uzke5r3/XMQUHLqrJktROunVaQvyg85FkKQL5kTel0ebgarGNk6DQ/2G+67FA=; 5:3TpuqWWhxN5VkIYkrm/UWzS57+NmOd7uZaluSra/oZsTNpzsaquF4MScw4xlGDjP2DCunux6Lo5qL8XJpw4bqQAPl51yx8eJlV23RlV0ZNUbruHC/x6yCyCrSZqEStuzrCiIEcMcNv4tiNLcgiMga/MArgrXdRNXqwd7s97A+lU=; 24:r4MWgY+qWDBc6xuHheftNgMaJZTRpuzMxo2IjP5BcKUnWSOPoSXaQzOFsS7/4Vi7px/VHmE1g6B46NjvYQyq17Qh3B+jLqcFj3UtafQqR9E= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BN3PR02MB1157; 7:dLt04NMtqUucCo/4ZBtnJKK7cjNHKyEo7ODe8Er4M0vj+PL0lPt0AKVBwMVz/5hbsVlZGKyq/8LVGeEu7OHxqezA4DGD2V/NqpQgjj3M+6Ys7cTtBBdRIB0kn+CEfEicysQ0erdxHSOJxbARramux+ItzwLRdqYItcaT6k+JUWRk1AJTrD4caZyXzRCybL8+7r+xbXI9sehlusCJGkE9GBBY++qpnQiyYWNmgTlTJj14oMXp9mUzB2gmxGdtbXELjtF+F8XWtuBlsuzX1YiP4FGEzWTNYM2aAHWg0vHtzWzUin1bc0w1Mdpd/Ij4LbC2wwfKqMKY0bFBiHo9wjjIGg== X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Oct 2016 21:30:53.9989 (UTC) X-MS-Exchange-CrossTenant-Id: 657af505-d5df-48d0-8300-c31994686c5c X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=657af505-d5df-48d0-8300-c31994686c5c; Ip=[149.199.60.96]; Helo=[xsj-tvapsmtpgw01] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN3PR02MB1157 X-detected-operating-system: by eggs.gnu.org: Windows 7 or 8 [fuzzy] X-Received-From: 104.47.33.53 Subject: [Qemu-devel] [PATCH v3 1/1] docs/generic-loader: Update the document X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: armbru@redhat.com, alistair.francis@xilinx.com Errors-To: qemu-devel-bounces+patchwork-qemu-devel=patchwork.kernel.org@nongnu.org Sender: "Qemu-devel" X-Virus-Scanned: ClamAV using ClamSMTP This patch does three things: - It adds a list of restrictions and ToDos - It corrects the header --- lines to match the length of the header - It clarifies the force-raw option Signed-off-by: Alistair Francis Reviewed-by: Markus Armbruster --- This patch was previously called 'docs/generic-loader: Add restrictions and ToDos' V3: - Extend to fix some more comments V2: - Extend header --- lines docs/generic-loader.txt | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/docs/generic-loader.txt b/docs/generic-loader.txt index 8fcb550..31bbcd4 100644 --- a/docs/generic-loader.txt +++ b/docs/generic-loader.txt @@ -8,7 +8,7 @@ The 'loader' device allows the user to load multiple images or values into QEMU at startup. Loading Data into Memory Values ---------------------- +------------------------------- The loader device allows memory values to be set from the command line. This can be done by following the syntax below: @@ -36,7 +36,7 @@ An example of loading value 0x8000000e to address 0xfd1a0104 is: -device loader,addr=0xfd1a0104,data=0x8000000e,data-len=4 Setting a CPU's Program Counter ---------------------- +------------------------------- The loader device allows the CPU's PC to be set from the command line. This can be done by following the syntax below: @@ -55,9 +55,10 @@ An example of setting CPU 0's PC to 0x8000 is: -device loader,addr=0x8000,cpu-num=0 Loading Files ---------------------- -The loader device also allows files to be loaded into memory. This can be done -similarly to setting memory values. The syntax is shown below: +------------- +The loader device also allows files to be loaded into memory. It can load raw +files and ELF executable files. Raw files are loaded verbatim. ELF executable +files are loaded by an ELF loader. The syntax is shown below: -device loader,file=[,addr=][,cpu-num=][,force-raw=] @@ -72,8 +73,8 @@ similarly to setting memory values. The syntax is shown below: for the boot image. This will also cause the image to be written to the specified CPU's address space. If not specified, the default is CPU 0. - - Forces the file to be treated as a raw image. This can be - used to specify the load address of ELF files. + - Setting force-raw=on forces the file to be treated as a raw + image. This can be used to load ELF files as if they were raw. All values are parsed using the standard QemuOps parsing. This allows the user to specify any values in any format supported. By default the values @@ -82,3 +83,10 @@ with a '0x'. An example of loading an ELF file which CPU0 will boot is shown below: -device loader,file=./images/boot.elf,cpu-num=0 + +Restrictions and ToDos +---------------------- + - At the moment it is just assumed that if you specify a cpu-num then you + want to set the PC as well. This might not always be the case. In future + the internal state 'set_pc' (which exists in the generic loader now) should + be exposed to the user so that they can choose if the PC is set or not.