From patchwork Fri Sep 30 00:25:28 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alistair Francis X-Patchwork-Id: 676825 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.gnu.org (lists.gnu.org [IPv6:2001:4830:134:3::11]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 3slXYH5B4cz9sBg for ; Fri, 30 Sep 2016 10:36:03 +1000 (AEST) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=xilinx.onmicrosoft.com header.i=@xilinx.onmicrosoft.com header.b=3jWz0AFk; dkim-atps=neutral Received: from localhost ([::1]:41015 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bplo0-0001fE-MS for incoming@patchwork.ozlabs.org; Thu, 29 Sep 2016 20:36:00 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:42735) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bplfA-0002Ts-QJ for qemu-devel@nongnu.org; Thu, 29 Sep 2016 20:26:56 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bplf5-0004KN-ME for qemu-devel@nongnu.org; Thu, 29 Sep 2016 20:26:51 -0400 Received: from mail-by2nam03on0079.outbound.protection.outlook.com ([104.47.42.79]:20848 helo=NAM03-BY2-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bplf5-0004KF-CT for qemu-devel@nongnu.org; Thu, 29 Sep 2016 20:26:47 -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=WgxxduDjwEHPoK4p+ys7Hv9Gw0uXgM6xJ0DjCOk40uo=; b=3jWz0AFkgVL6DO3V8fGEU4s5TpcEgOhHwYr1GL15yuTtuWKT5n460YS1m1FH3By+hH/PRQBDTZ7kZLaKK4mBAnJBqVvkt+LJAYtXLc8G9vinOQhdoPfZyKXMMsWpe47SYnx1z79ZJlxM0gyNm9rum5gmPmR9iWAu4RZTZS8T644= Received: from MWHPR02CA0016.namprd02.prod.outlook.com (10.168.209.154) by SN1PR02MB1695.namprd02.prod.outlook.com (10.162.129.25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.639.5; Fri, 30 Sep 2016 00:26:45 +0000 Received: from BL2NAM02FT030.eop-nam02.prod.protection.outlook.com (2a01:111:f400:7e46::209) by MWHPR02CA0016.outlook.office365.com (2603:10b6:300:4b::26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.639.5 via Frontend Transport; Fri, 30 Sep 2016 00:26:44 +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 BL2NAM02FT030.mail.protection.outlook.com (10.152.77.172) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.629.5 via Frontend Transport; Fri, 30 Sep 2016 00:26:44 +0000 Received: from 172-16-1-203.xilinx.com ([172.16.1.203]:39424 helo=xsj-tvapsmtp02.xilinx.com) by xsj-tvapsmtpgw01 with esmtp (Exim 4.63) (envelope-from ) id 1bplf1-0008Lw-8e; Thu, 29 Sep 2016 17:26:43 -0700 Received: from [127.0.0.1] (port=36251 helo=tsj-smtp-dlp1.xlnx.xilinx.com) by xsj-tvapsmtp02.xilinx.com with esmtp (Exim 4.63) (envelope-from ) id 1bplf1-0008U5-4w; Thu, 29 Sep 2016 17:26:43 -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 u8U0JWVa019976; Thu, 29 Sep 2016 17:19:32 -0700 Received: from [172.19.74.182] (port=35396 helo=xsjalistai50.xilinx.com) by xsj-tvapsmtp02 with esmtp (Exim 4.63) (envelope-from ) id 1bplf0-0008U2-Bk; Thu, 29 Sep 2016 17:26:42 -0700 From: Alistair Francis To: , Date: Thu, 29 Sep 2016 17:25:28 -0700 Message-ID: <9d991a2df990cf55e2630410a5a03ea48930af5d.1475195078.git.alistair.francis@xilinx.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: References: X-RCIS-Action: ALLOW X-TM-AS-MML: disable X-TM-AS-Product-Ver: IMSS-7.1.0.1679-8.0.0.1202-22606.005 X-TM-AS-Result: No--9.751-7.0-31-10 X-imss-scan-details: No--9.751-7.0-31-10 X-TMASE-MatchedRID: i7UlBGywMyI1q9FqrlFgYJY9D0/NRxoqvtVce6w5+K8bk1a5Asxcj7Zu s9PbYFMYxOdqqwQEYeuMb1GZ4s/DHEdKOOEsFcbS7IO+KGapOnwBmf/gD11vZLuqk4cq52pzEW4 +DfKR/mEqegugNzsJfcWDu5tI+hS7KUxKcmS9d16EwZM25BMds/NYQxCOihTNN1kwvmT/10ovde H8wIZynVNtlBwEjTNCctEQSoOABqTzm/ciiIjcjBuZoNKc6pl+GbQ3lnmFAkq5ZjHyzYrpGli5r +TKtIsrm/3MR/qmGzAXeMr+M2fH4CUhLCVrsmAhsyw+ZJnFumSl9VzHf0qr7o1Oeo4wEgnh5R1u 10cEPTN8M9Wvz9lxUhad69TdARtpwV5ZD2sQLdXIOn6NK8S1a1MmmN8EkjBQBEySnwJH1MLMbpY z2ROa+UvuLUFcu0Mo2CgafktSp1ydXNOCtK/uyZ3iEJrvFJmhYtmTggNRdcebKItl61J/yZ+inT K0bC9eKrauXd3MZDWhNyaOMoiE/PFrvOtKYfD8szj2fzHq/uT5Rsr/R0CU8LZl9oPF4oOJ 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)(1109001)(1110001)(339900001)(189002)(199003)(50986999)(76176999)(86362001)(118296001)(106466001)(105606002)(8676002)(2906002)(33646002)(81166006)(19580405001)(19580395003)(64026002)(229853001)(48376002)(81156014)(50466002)(9786002)(50226002)(36756003)(71366001)(6666003)(626004)(87936001)(92566002)(5660300001)(8936002)(47776003)(85426001)(189998001)(7846002)(4326007)(305945005)(77096005)(2950100002)(5003940100001)(586003)(5001770100001)(11100500001)(356003)(41533002)(107986001); DIR:OUT; SFP:1101; SCL:1; SRVR:SN1PR02MB1695; H:xsj-tvapsmtpgw01; FPR:; SPF:Fail; PTR:unknown-60-96.xilinx.com; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2NAM02FT030; 1:ykSYO9/dlxAvWeczXYvyGp8dlRkmTB6JJEYHpBVcuoYdEWUXkwyBC0tw1au3AQnAA6dPowrSQEmhdUhBERVgM965OwwoErp+hF157RRZenUP8J6L26zbNAbaWHrEvUJCyymGf7ReGzRMEqpELIUrZz+bEZRnJ+VWANAXL+sKjfEQHIyD2eMRSst1/r+S4xJqe6j11mzt223slxN4eK50dBzqxAfFixeAczN1qZ5cXpvr/R5Uvahqlt7jfWSkIegb1389gUc9Tdt7TC+2ldo90GfpEOlWm72jEgUaLqMXVccIr153IZK7k8An4m750Dz3m7e53gNvM3kpLyAH2qyg9JwnZTiCajXLWb/thfs2+ZTvMDuM7F40NCEPMD4skYYgsGrHMuRGsXV9K1GRGJsHdks9upgdSDzsaunBEeGFWzQxlwy3vB6/o3siM1R3gxSxE402Nyq1HWj1WP3dFAo9CdQiduQM++bbeOP7tGfs+X3rQcuuFKHfwk+pTaDtJ9gePWKrwavNIXAzkIZqH7X/8LhXUxZ9Vgcvu6rm+3wMibka6CEnCDw5WFjpJzr9jwcw71qOcUez0nQuyGBr6/ZhVBMiAH3YYxrHoumiAEvi0E4= MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 7b042c26-9e4d-4a2a-f07f-08d3e8c874f4 X-Microsoft-Exchange-Diagnostics: 1; SN1PR02MB1695; 2:ktDAhOf8EoxU2zqeEUN0pdAR0R4BD4RGF2DEI7bJhPMwaLteBgCJYhZpw5G1Y8lGRFzaauNV5VIzbAfUnKXiEj/RbXBoxyURHq6ZHbJPgpDkcRCGJHNkyVcLOva/razO1WBLBbFZZl9abrhY2KhfaSIeJUM3QGcAnxJeL2Ly1nn7h/25Q9plhsUQ4GQJgUtB; 3:cur7LROT6o9KvvyuWSbVNyhVwhIOQPZigSQZwEiP4EHcMb3byUM9ISGeh47KU8LfJsOnywqjEch/YFojvEPcGf4cs+3KnqLY5mA/AF+6ZLr83iy8nSc/Feaj+/EwGyE2UBE2QliKFwktodbahQxc3Op8nXCYlSXuv8SRd71C4d4VMuEUyXEGnzFTEbO+y3YeUaDzb5TstFzAE13BIYKD0Tnc2EOaxfTqN9f0NMMXfXk=; 25:n4Y9UPg00KnEbvlL+DNom4rHDoGyFLRWeQFa21H/4IA3H44mhKX4nVcLm5n6G9miUE2JcJog3pIZ7OXyTLj6VVMdNbOV/CrVMAnp9LlhHEWkPR9PdeJOI3xwJzWV05ThUqHeRhrdXHZROsRcH3g5pF/AUt8ZwX6YBYL7xret8FTtmgLpGvMYi8sdU07/J+OzDiuen6jaJHGqpkuZ3Nd5dEXHu651PgUjbh29zxLLXerJaFSjR6X5ZCaifbBkCivpCkKb38KStvwQLEmjISyEpLDBBY+L1/dwoZwYsqIdBTnLOREP8kp4fomuPTOJeGfZ6x9UDkjgZaywNeFopqrwzJvLr1o4EbSoUlrDhnHPp1gn9wFyf8nrZoeV/6Smw3NFLSj5H4PrJKOHNXCceKTuTQunPK+1PCcoYC/v5r2X4i4= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:SN1PR02MB1695; X-Microsoft-Exchange-Diagnostics: 1; SN1PR02MB1695; 31:UVa3F1o/XgMCnpmV4b3t0UPGCOCWQsGotHHFNcFvLyjyl25M7VrrZz7XXDb6fX6wk8UIuWZfOslulhmnFanOZ4DHXBx1yVSD5XawTPvghod/2X64pjIP9KicLb7fVniI4NMK7qe9WE/WfgTgRCU+g1K+wHqIAg9mXXyu+cTOb6Pf4euYBjL1A7qBxbbuCS3Cx9W6HFCG4w9ZVyWOD74hu+CeGtgYBG6ZCpjfqww5CaA=; 20:ztzzZO+UMaiK114BNS1y4NuQT3mrpX/aS9vEx2wtTOJKytX7VjsZkxkwqc9VaPVK+u8iqjeZcHcxjIhUAYpqiTtqS2o02tfwB276A3hFAcA6XDXLJGm52sMsjovBSylcNO+uD5aa8J0djwPk9VDk/gv5be0y5JKqRSu7B6sdtqTyCA+A8Yjnk8l9sk0e30nLIr3vq5fUBvlfG8xhEbTYTF6TmgN1Ue0+ERQbxA1/LuNuesWZ0cgNnKDP6O++wRZNCavsUKJbdDdS2rakQbSnp+BkyPAr4TNxpb/mZ4Yu6Ca5K7XVY4MQST7fX7g8ha6K5QuF9CgKSHErzgNElUCyvvk2mWKxaHlQ7ERxXQGcHN5eSaBVYkne4I7G1wokyFJWWUASoJk3C07VR9lVulUJTa3BDGjJQmlmUunJUsnbAMBw/akpo6RsL2lywVfEjC2rUS+ghrJmGNKjBRs+3wv198xDO++ssG2LmkmdGTz9EKUxiyMTDggm2FxVRtO+nEs/ 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)(8121501046)(13018025)(13023025)(13024025)(13015025)(13017025)(10201501046)(3002001)(6055026); SRVR:SN1PR02MB1695; BCL:0; PCL:0; RULEID:; SRVR:SN1PR02MB1695; X-Microsoft-Exchange-Diagnostics: 1; SN1PR02MB1695; 4:1SnUJq4WIHcHdQ66ItpEpkAzklLKUXAUJfjUlZi6cGrkEQneSfprQa3Oh5CzRBoMa2m7ZK1AgqWoUSxVehRpSsiQRjj/qAIEIoPxqfIGjtRyy0912W8cQKOIJr7BVtWO4K92mdrrLl3HSFd60XQw+8DD86gbFP8tEGVxTog3WegUOeTk2tZyf32J5kEuQyjhwxkspaVRZFUuPRvpgqW/Ads5ZyE0k/ONcW40za+wHlSPY8hhp4gh+UllEDyhuactwetlfTXYI6iE7XcxhrLlnDxUzxISCkrCezJOZxdm6URdPNs7yRZTadefKq6o7+00aA17p/X/saVOqb52WFyPvm9rSaLYNlYY4CkvBzQMWh/rtgX9WFB9XiyPFVm24H9GjuXfjzEhLAS5rLeYXXowg6+HwCd3Shko3NUCvRHTB2LDUaPXBR+F+3Yd1vux/FAdiiAjVMCT33l6UnkLXJK+3gSWezoyxBJS5FQvKeLKk2lSMwLBRTYxVxjMWJAcsD6YV7VnvpgSUwvf1ZluDzi/bfbyhmTocWovJsqDnkoJb7M= X-Forefront-PRVS: 008184426E X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; SN1PR02MB1695; 23:IKZtgjJUcQi2YDBjvFeRa1Is30giakF9yQvZecQW0?= =?us-ascii?Q?9cYhSIEpXM0WMKORkuWShC32lY5kFYBLukWISejKsEvNvBzCwrSKXyq5LLqs?= =?us-ascii?Q?8fvUuMlIYPLleI9uKsjJLv3LlRnGGyHT/iP/IBWKMGIPZmmVxU6XrpKVLpxD?= =?us-ascii?Q?Tn9RhL0KWzl9PKCfkitAJedykUMobkNa0k/5uzAs91X+7hRweOvx38/0SIGk?= =?us-ascii?Q?Zam+Idhd+7iDByxzmErgz+OyGmKwx6ht0Au5LGHsTG11KcFQRp7J0d0dHKRq?= =?us-ascii?Q?jmGwnDIntQfxI3qW0UqDMgkZXKIOWSlAechH8uOQlo1MI9Opod2rHbboO4kM?= =?us-ascii?Q?w9oddsJwT3kbGyU6pG0N928LyZpSRsf8/yl8O/7eaHkTprFRvh5cNNvoatQI?= =?us-ascii?Q?C+v7KWmeWs+bpYvTQefrYw42lNvOyj8CUPNJEW0mO7utP2soIG82mqg+mF7Y?= =?us-ascii?Q?j8A8bzu1Obg/sD7hiH7pZR02rOKCIAAfe/3LK2IdMIMoBt5lw+ca6Snpnqg0?= =?us-ascii?Q?jvSH5R/DcKa/WxkVCDvOL8I2uRTLzQLgV4XiF4lu3bZDirH5Rph+7KNqp5/O?= =?us-ascii?Q?3RpdmO3HvSW6uahAxK7++Ej6udGsb3O0FGCRxpzKUNDiwUpJcWiGfncQKXql?= =?us-ascii?Q?U42yhLPeBiwuDFv3mfyX66LFFI+0OA2nxHaic7xvHT654hkaQ1/re6LEO+sb?= =?us-ascii?Q?XyWCM2X1kULkxp8AYphpzC5KpVrVIwRyPSSJf1rUGWaaPzsfzm46n7c8kytq?= =?us-ascii?Q?J03UYmm1jaTrKab76DeGTQ7lIfnRlfylTcXiwxjNYfsM/mx6etmmZS15lgLh?= =?us-ascii?Q?G9z/OIw9pIf4iuBWhIGOlh/WsFA7KrcFeHrXYc8tMtko2Pl1PATGgL8MHB1t?= =?us-ascii?Q?kBMREFgLj8e9v3EXZo/x4WT1jqkXMrJ6MdZQr5lW9ealZv8smvhrYMyJNTmg?= =?us-ascii?Q?x60T7yLEGxVGSYHcIo3XKYiZj+rFf+lzxjdqTbNyybnkfCPSyHxr475AeFQC?= =?us-ascii?Q?mxaiUQDmZ2Dvq3C5ArHvKSaoOKyZaFTitlXxz5Hsd1N6corAX7Tyl7mEf7/4?= =?us-ascii?Q?TgG4AenmYY7vHC8A/Dwk9HOH49gX3TKH0JQlXNO26XOMujAG4gWU0NgTVoSc?= =?us-ascii?Q?PNja6/1UA/sGZxpKdGXdMdtZpRaNZMFnDCbu9ncuB+f74zA8ncnm6rifzC1H?= =?us-ascii?Q?qYhzi4yMGUodPvjTtoAjm6MWD+plI+Bf16q?= X-Microsoft-Exchange-Diagnostics: 1; SN1PR02MB1695; 6:tcMppfMM/KErTV4abqGcU2D06e2QgBatgWS+4QOKw0ggIPWseB+CGx/Z8J51bEZ92B30rHcHeeP9fa/kTfPU/omdW6OeWBWg+A2ijpnKsfzYNq67TRTUl+erx6cA8iQ0q9MNVw9ELNErpgGtcfimBe3D3UetcKfU9dsnocdBY/xclVhfxG1iaBDewLCSdWCS/IqFd7y9ZFBlmrGczJVAcfx17dMKUKtkO30TX6kqJRtDSwAGCuCJ7wunnySxN74hnFcMUNZg18947V9C0QdllbDOQnoSHyglx4WsHBN3qYipMqUGmWZdevzwyLgiJ61ZZLxZ0n88zx9TOiAvDmAcVA==; 5:hFUJ/sJhY9ZfZGimFJTMFx37sWj2WZrem8y3HWmji5uJdUvZ9JlDqLUHm39gV1ikFzDeXwFgtidKdBVYw0Rlmf+EoAbb1QxQ8YFYulOXXSk6qIchftlL0AMyrWdWYHQYGvV2OvoQHTv3IxFdq7O7Mg==; 24:A+AcWFOEbgVo3iQF9o+nTs3i66UG36RHKWWQXIsdnjWZjydbC1yG/iItjTmHrjAb2Io6lX19+wF2qLn8w3Q0zRAijOTt0pCNaT7PQ98KToo=; 7:DmB8PZVy1Z4pD8hOyWD0h9pH6GInLpTzRA4Ok1IrAVHmtGIXZvRQ/vgt+NLBYSjMaXJ/JpdQbomHx0aTcepXwhMomJxptos81F8IbbRnMVJStwIK4miq2Hr9bRPOO3fkqG+KNrzwxD2fSmyi0B5xvpSncX5xFMREc+CTYdeDglo6F4VslVtnM8N/fFmxYkEezix6tekboB3wlvtu0dL4cyNnhgtMtZVtcLoUMqOY4LeyHqwF3DCgr02zMqADBzYDZoKln/6joinPzZap6lmgi8wDa8+ujAK2/PpQvYgTRMtpZAZDuD3MwYGPMFo+maD7 SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Sep 2016 00:26:44.0028 (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: SN1PR02MB1695 X-detected-operating-system: by eggs.gnu.org: Windows 7 or 8 [fuzzy] X-Received-From: 104.47.42.79 Subject: [Qemu-devel] [PATCH v13 2/2] docs: Add a generic loader explanation 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: cov@codeaurora.org, crosthwaitepeter@gmail.com, pbonzini@redhat.com, armbru@redhat.com, alistair.francis@xilinx.com Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: "Qemu-devel" Signed-off-by: Alistair Francis Reviewed-by: Peter Maydell --- V11: - Fix corrections V10: - Split the data loading and PC setting V9: - Clarify the image loading options V8: - Improve documentation V6: - Fixup documentation V4: - Re-write to be more comprehensive docs/generic-loader.txt | 84 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 docs/generic-loader.txt diff --git a/docs/generic-loader.txt b/docs/generic-loader.txt new file mode 100644 index 0000000..8fcb550 --- /dev/null +++ b/docs/generic-loader.txt @@ -0,0 +1,84 @@ +Copyright (c) 2016 Xilinx Inc. + +This work is licensed under the terms of the GNU GPL, version 2 or later. See +the COPYING file in the top-level directory. + + +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: + + -device loader,addr=,data=,data-len= + [,data-be=][,cpu-num=] + + - The address to store the data in. + - The value to be written to the address. The maximum size of + the data is 8 bytes. + - The length of the data in bytes. This argument must be + included if the data argument is. + - Set to true if the data to be stored on the guest should be + written as big endian data. The default is to write little + endian data. + - The number of the CPU's address space where the data should + be loaded. If not specified the address space of the first + CPU is used. + +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 +will be parsed as decimal. To use hex values the user should prefix the number +with a '0x'. + +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: + + -device loader,addr=,cpu-num= + + - The value to use as the CPU's PC. + - The number of the CPU whose PC should be set to the + specified value. + +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 +will be parsed as decimal. To use hex values the user should prefix the number +with a '0x'. + +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: + + -device loader,file=[,addr=][,cpu-num=][,force-raw=] + + - A file to be loaded into memory + - The addr in memory that the file should be loaded. This is + ignored if you are using an ELF (unless force-raw is true). + This is required if you aren't loading an ELF. + - This specifies the CPU that should be used. This is an + optional argument and will cause the CPU's PC to be set to + where the image is stored or in the case of an ELF file to + the value in the header. This option should only be used + 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. + +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 +will be parsed as decimal. To use hex values the user should prefix the number +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