From patchwork Wed Aug 3 20:06:53 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alistair Francis X-Patchwork-Id: 9262173 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 9A1D460754 for ; Wed, 3 Aug 2016 20:15:18 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 8B16D28210 for ; Wed, 3 Aug 2016 20:15:18 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 7FAFA2823D; Wed, 3 Aug 2016 20:15:18 +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.9 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, RCVD_IN_DNSWL_HI 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 59A7128236 for ; Wed, 3 Aug 2016 20:15:16 +0000 (UTC) Received: from localhost ([::1]:36493 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bV2ZP-0008OV-9E for patchwork-qemu-devel@patchwork.kernel.org; Wed, 03 Aug 2016 16:15:15 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:32930) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bV2S6-0000oz-TS for qemu-devel@nongnu.org; Wed, 03 Aug 2016 16:07:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bV2S2-0001eC-NM for qemu-devel@nongnu.org; Wed, 03 Aug 2016 16:07:41 -0400 Received: from mail-sn1nam02on0067.outbound.protection.outlook.com ([104.47.36.67]:18400 helo=NAM02-SN1-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bV2S2-0001e7-C8 for qemu-devel@nongnu.org; Wed, 03 Aug 2016 16:07:38 -0400 Received: from BL2NAM02FT058.eop-nam02.prod.protection.outlook.com (10.152.76.54) by BL2NAM02HT247.eop-nam02.prod.protection.outlook.com (10.152.77.185) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA_P384) id 15.1.557.8; Wed, 3 Aug 2016 20:07:36 +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 BL2NAM02FT058.mail.protection.outlook.com (10.152.76.176) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.567.7 via Frontend Transport; Wed, 3 Aug 2016 20:07:35 +0000 Received: from 172-16-1-203.xilinx.com ([172.16.1.203]:39016 helo=xsj-tvapsmtp02.xilinx.com) by xsj-tvapsmtpgw01 with esmtp (Exim 4.63) (envelope-from ) id 1bV2Rz-00026W-2H; Wed, 03 Aug 2016 13:07:35 -0700 Received: from [127.0.0.1] (port=35844 helo=tsj-smtp-dlp1.xlnx.xilinx.com) by xsj-tvapsmtp02.xilinx.com with esmtp (Exim 4.63) (envelope-from ) id 1bV2Ry-0000lq-Vd; Wed, 03 Aug 2016 13:07:35 -0700 Received: from xsj-tvapsmtp02 (smtptest.xilinx.com [172.16.1.203]) by tsj-smtp-dlp1.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id u73K0kLv006738; Wed, 3 Aug 2016 13:00:47 -0700 Received: from [172.19.74.182] (port=45304 helo=xsjalistai50.xilinx.com) by xsj-tvapsmtp02 with esmtp (Exim 4.63) (envelope-from ) id 1bV2Ry-0000ln-7u; Wed, 03 Aug 2016 13:07:34 -0700 From: Alistair Francis To: , Date: Wed, 3 Aug 2016 13:06:53 -0700 Message-ID: <57b1517b17bdfcdb905a33d38383dfd9b55cec68.1470253246.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-22490.005 X-TM-AS-Result: No--11.948-7.0-31-10 X-imss-scan-details: No--11.948-7.0-31-10 X-TMASE-MatchedRID: TzL0DiA+Z4voiGs9ehFzsyEvcFYBr/WYFuNF4lJG6xtFDR0AKGX+XNSz 0bT6zOowhWig9YT7qvDNYHrYf448jdUMAwTDOBnsA9lly13c/gHljSRvSGpq3Pqh2SbpugCfhk7 QzQ7HhKxw8g/FGoBzob8xMT96f31tAFPU1cTdlYIVglQa/gMvfJCgGv5IWd4kr6AbVPPkpSnlyq utjoNp8xs9u85pk8chigSdHW5gE9J5F2Bxez3bFwwfhKwa9GwDoprEeoZHCQIcXmBZ3mI5Sfm6Y BuSxOzzJaKQlvxMh80DPxO2AHqvcTRn2xdwrsXpyDp+jSvEtWvk1ikmy0JzSJdJaXKXfLEpM68H tAUlI6CmKMa2bvnGXnKRVRgGYOAljlL/hujrw1tNVr4vdmCpzr3gm8md8WsejU56jjASCeEfjQE ImGeZ2eLzNWBegCW2wgn7iDBesS0gBwKKRHe+r/7hORG4/w2bS6HevgsRJqV0vvIWgpaaasgG5L t0uORpb/YiXwFtTcI= 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)(36756003)(118296001)(11100500001)(356003)(106466001)(7696003)(47776003)(19580405001)(19580395003)(9786002)(8676002)(81166006)(85426001)(48376002)(77096005)(50226002)(229853001)(50466002)(5003940100001)(7846002)(81156014)(92566002)(4326007)(33646002)(8936002)(305945005)(86362001)(76176999)(2906002)(87936001)(2950100001)(50986999)(189998001)(5001770100001)(64026002)(71366001)(586003)(105606002)(41533002)(107986001); DIR:OUT; SFP:1101; SCL:1; SRVR:BL2NAM02HT247; H:xsj-tvapsmtpgw01; FPR:; SPF:Fail; PTR:unknown-60-96.xilinx.com; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2NAM02FT058; 1:MlNjTp/7hs/IehMYMaDJB6JdKO8k4+4K7sjelSIai1nOBw9SEV+NaSYYQYqdgMciedHcICFO8dGU/FZsL8qPX4o9Csz5po605X4v11a/bh4yWBz++w4PPNRCNNUt7U3szroCD6Ru6ZgLFfTBu0eKG/gALr58ZXSg8h9CeZijlXQYx1XT5uUN7AgYORy7v3PEZlipUQOJXsdIU7nCWDiFXhJgbzvwMNuiCkwqXbsJywrWa0dTPzQGCtXdumeEBhh4i+h+MQiZhG6YXVd3DAT7GKd/mDKNU1Ybpq6L5BDrliKu9NicUPhxrELrgdMMqksYNTwXZb0G5zjyIUPgJXaagSZcVVsRbPJLIb6dCULqYAMUZedu7Bv9AZG6sWDYXE+tGbPI57OEQAaP3c0HiqYP1AgrI3d+qMsA4OuMMv6HUGUbsK9ne1s2On4VacA2Ax8kaFHmr4TTUgDXZMKjYfAcpD/wI9+Yk2ExzAtZ2sa6ULanZwx0jo2LV9uu1UZI6YDyXCWUrIGMUKcQlQQaGhB1VPZriDJ9ll7fBuTiSIlQXuaqB+f69SnYYSTwqWSN2RjiI6F+xzS7/bC+c/vMi+gk4EWA3Yr78y4YU37IIGvMlJo= MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: e98a84bf-18ea-4f05-0291-08d3bbd9cffd X-Microsoft-Exchange-Diagnostics: 1; BL2NAM02HT247; 2:q6qfP1H7kMidcN2r8IRm2OrhKaZwa2LtauQ1tpe3UAftQoBboYcwXph1KJx+vjQW8Uuk/8rQ/fTh5sSx3K9D8JFWlgaNHSIyrEnDoOGey3rHKYthnfYXgFMw2fS15haPDtbGvbtwUmEBSBskRAg/BgotWPrmu9XAPEfVZTLuNLCmrmQNubPqGDvFxUpDEQ8+; 3:3oDAUcBwwcnWmqE+TKY36cO5fh8gITlKs/mf0YrHEhvbpF7mueA+FPciZwYyh/VRWo0i8DBVWmuh7NqZtr5Mt6sJgHhmDLQgf8a546PF/6pTQrRyRZOYVH/i0+e/hufg+QQI2TWoUWxFzQuBbOcx7gNgo0VMUMGjDUqGzh/uPuMN/b6A6i9UcI5MMRHOJfhunp8cr0MORDjxtkSQUDaFb3vNJKXnVeJsQfFj6CytMZo=; 25:Zfu7oLJp2vRyog0mXrn0gWDBp4OEjxagE/ZCLB2OgAhECzwfDKbxnp1TjPlnKAqdFYA/8+sxUvnHH/FOoNTkitaiEbvz4cBVtTUtyCvxe124dJUduU46ZaCP83tqogQuZCrq6V0bJB98/WVLEO5hiTlHfgfQLBCg0VQQFZPWEEkrNc/rM6sv50d8cPWcKqwXFRhWo0HaZa0e21vt2fwtTeZm96hhmdmcjyMmGwVEYZCj0CYcvE14czGzS0ccHiz31sHbb+uwMlYrKmiPXnJ2j5cx3lGpf6u4Cl+LasjT07ynDruHkL0bYvxlGc9U9ZQJISmqYk69i0aO7WbXiBkQmjfcKmvoAO1HhK8dvfL428fu0HVEVghGuIohqIwC4q4xfGodw/JXpfE+/ZRKye+Y9Q== X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BL2NAM02HT247; X-Microsoft-Exchange-Diagnostics: 1; BL2NAM02HT247; 31:sPVlmKrSnuMlIRsGuETIYxOf4M5oh5S+eJMGzJigWQUSyyQxJgLW7PFUZoqolA8tayGfsR7rlR631PmOW14FkqYwB2aFiQQAVAD1Qh0w/z9nlP2Jp/4S2H6BmJ+RX8tUZPd4AgQvHqozHD3dq5lF30vTw9Vtngda0E0pOh1ce2/AVbIRWvJZSb4Llw5EdGfl6GmFQDRdxqKphgqErYvIRSaTdQ0n6zlwiYBKJ9+STbs=; 20:bPr5f9cYgIM0KPGX/zyIL/g426eaCVe4OOQkvrXVgmxqwXpH/k1mMOi054FgrA7ysaq0JVzgG39pS1AO8tYycuO1fbIwS/2rXGWV3H7dxsc6YmziNPIunJKOsW7Tmg10LsijHIiQoP5ZSoDWaMkbwogxJcRMc4skHkMGKtQ8z94E0Dn/BMUQ6H+ioDcO/f7SX5HW8lCZRMKxOh1nPZZ/qv9lwVxlf7iGIxaMTczJjwAcPre+pMl3pVnbQkX34Spt1lh3ScpDXuUBOrC/gN7SmMlnktYgOgbA6QJ52GSFm0Ggoa/ffhKlmh2Ftx+JkjJrCGQCi6YCht92F4MtgFw04ahZtTZ/8lABBN4tpN6GqmZbW2kPjdJ6Ii9bI6+lDNzKhqF//KMQ62f0eCaww0yzc9SNC428FZkjDPnYJYR9wmQ9eJ/fDhxwkIYGtnpjMBqlR+keHPnLIkrkgfRIqbTo+Ec20UPtUuEPYXP9DleVl5uGL7wctMbQctvzYu2m7ziZ X-Microsoft-Antispam-PRVS: <0c9129ab39fb4cab949b62daa1f1ba64@BL2NAM02HT247.eop-nam02.prod.protection.outlook.com> X-Exchange-Antispam-Report-Test: UriScan:(192813158149592); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040151)(601004)(2401047)(5005006)(13017025)(8121501046)(13018025)(13023025)(13024025)(13015025)(10201501046)(3002001)(6055026); SRVR:BL2NAM02HT247; BCL:0; PCL:0; RULEID:; SRVR:BL2NAM02HT247; X-Microsoft-Exchange-Diagnostics: 1; BL2NAM02HT247; 4:wySgvKBAxhXA3vVXhdwsaOoCSH50O641ETrOi9kdKxviBblmbS0YVZgARLOyU3YwNfPfjYCMjOSWAuRAyMbj58WUbgIn7V3/VJEGdMR7nY5rIykOiWb5BozkPFDMKrgJ56koon5Jl1N314XPz210vPNvN8nML5jEosf87rO+wVIM6jp2VzBCKSvDrm8YHwvAtvEElrLYQWpjZ2qJGP866nosXRajJc9MiqhBw1TzxMH19jT29KO8f78BTF9S8vl3SqTXwVNtqfEaIif45PtCFI+cmxHXoGkBRqwaRJi0KZBKjnkIS77eD5kGLhU9pq3RuhX91HPDbx3Uu1bZVBVDnuFFA322MbsKYziZbV4K/kZY73/cQXYaL5hYGcchdrCYQIZJTXbobwjKJW7Tm4rL3BRyTxz/bKKzzUZReMNaDgVynLV1bvaGYVS3DUkieIXlCEEBujzyRvO2UNQ1vWsioDvUQNbgL60BUV5OAcmhs5Qk7YxQ/Ym1f1NRERD4/ZfAfiXBjABp3bIiZe7nxC7RjyaqbAwRs9A5kZQXSuUVahc= X-Forefront-PRVS: 00235A1EEF X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BL2NAM02HT247; 23:DbvRvZMs28l2Or7XTIQIP/EBHXF7AS1bSjzPfc32/?= =?us-ascii?Q?L+lC7TFlSpkFGkD0simMnXZejelCsalqY73pslIswLgJyDCp9a12NrKp59In?= =?us-ascii?Q?tlO+rSxrW9xGzbpLlbPLxUcNAAyAbotM6pmrN2GWH5QEciS/DoCsdE5bPHJC?= =?us-ascii?Q?g24/xf/PruINPmikGUxW57hWhb4bkPDOEAWL//HoUWeAueck2yrIyP39VddV?= =?us-ascii?Q?sw3rdp0pmXUXjPnWPDxQOdAK2rqe1Zor6jJxxFcxQxAeTpABp7/dFX3j+7je?= =?us-ascii?Q?9nMM7kzdfVN4ZNHAB2EPZlsh6nU8Pay/p1DJ8AL5EkoZC9aquebPRc/OoEPf?= =?us-ascii?Q?ehrvrUKN6qvNQAdZraJQXWO9EiRNopeR2uzrWQq3TN+fElFwmlUoobco4WaK?= =?us-ascii?Q?4LFzv9QaqD5LW6vB40VvVblmYhf4OIJJSM/JNMixMlI5aso4b2Ee7LeMBuqO?= =?us-ascii?Q?gJd5FmFV/yPgrPOBcgme3cAiL9z3j55NHVvhk3QEQpldQG193kTTAw0WuAOR?= =?us-ascii?Q?Itblf+ErwFrgs3Gt7XbDqtSx3KHkdd8K2fG8mEmZy+z+hL8BKinxyJkrmJ8I?= =?us-ascii?Q?+n2DE2qm6Ue9+Vf38fCm5YVB82vRVErb70lqV/XXWuM7laV2+Q9gOPi9jICE?= =?us-ascii?Q?1rjR/I0Vbw669nc/nknn4ljZypzjlcNeyrRwaSnmgE8be1Y/0a5YCWcauZkA?= =?us-ascii?Q?I1J0uy5GIjHL3iFnkW5/wpXKXfQwas1MBA9K0yHvDSPlewBsG9W9ClMmmE6O?= =?us-ascii?Q?/gNTTfRaCBi9qqWgmJeutgeLb52bd3zp1vi1HiKgobj+V1aMU00C6y7M35Oj?= =?us-ascii?Q?zzPxbVAUe94Vpv/7m5mmFmVO0uUPthQAbuGSDQVXzLc2HJpHRsBOKr0d8q6e?= =?us-ascii?Q?odqVUmVjHAIxirAUuj3mb9/aD+bzPg5RvZoV5BPiTP5C/0hMGfKDenexYYlT?= =?us-ascii?Q?0xeTvIc2NlRYVM5C6ksLrYIC9JHKUMw+bbV9JKXb2wIYmPpHmyjJURIxwqWu?= =?us-ascii?Q?w3y7NNwjBwUruQIKzroNMoINXsGBBch+CPitwgolAOmNEvIX69eBA0kgotG7?= =?us-ascii?Q?CIlHBZYLMJrQJenKrv7X6UMjuWCcbRsUN+nzwoXdnJSe9mbexqCHAaMMmRks?= =?us-ascii?Q?lq3qtviGiDLiymG6XTmSTJ0RYwVFXN94wZKjwirfAA/bb1yLgbPWjwgHS6a/?= =?us-ascii?Q?4lLJwNKeiODroAxeD3fnGWiQgjlmgMLGsJm?= X-Microsoft-Exchange-Diagnostics: 1; BL2NAM02HT247; 6:bflYPVBuDaT3GeI0hAaiN/SgKU/koPNCyNQGWcFT8n8lk0u7Ty5pBjOuqmAwGOdLGDijkUE/ZeB3CBmF8sK9CIBSMmGTQ1VrtDTuclK+wJ/bc/yG9vNZbmALVVbi6+u4caZ5lStrO4ZoPyta5hoxVnTawgHCcbikyuALsQun/AbrsFlwHkSCLaELjEgnEsxu5GXmPPbVREmCOQn9D432UhNZ8pdBkFPqjwGr0ivjVcph1ShY497L9EIDyPB8QcHxgv57QlBrTnWhsb2PdnI1JspSJNr5vPTgGkQsUi8vTBOuUTsyK+tx7hR5S3NlFkYkzMcopdMvmIwyd9QJdd61Ug==; 5:GwM7TaKjhcGxZnYlBJtTgjBLBsvw6sL6ZZUdIu43FxXalPA7UFdrJt1J+AE/PeKG4fTZu92+GQNbpVSq/MN8m4Evi6awdys+Y3ea0ieaAcjHRYlx2MW91vetgmqblLNK2TW1YTWmApTIIpRXKYwilw==; 24:36trhxuWGb5FC20NsnkPKgJJitIfIqJioXttFnDj0DUmzso5rXY7YQu7iq+z5VyGLAD3FrUkqUuLCgLwJ8Th+zzE2Q/mo4bKNESn6PHf7wQ=; 7:gQnHjF3u7+m8m1wchCejuLTm153x5BO8339kavWIMUuguJ4dM/Hgz8osqY3eD0kKbABoID28p/GZ6n/BxlDrfb1CDC/0rceLh4C/PsLJVc0XLJnoR42sIqJL0lBhJI9etZsTTDd35l5rnVwU5q7QsQ81eCob11vOXmcGhb5mSBVXNEBB3FVB/Cfm6obzaYAggPX1YWQwDs/4+34dofGFK9LZkCyFJfRstMl89XzDCppnj3JyIQrstl61MT8Y++Jr SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Aug 2016 20:07:35.8458 (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: BL2NAM02HT247 X-detected-operating-system: by eggs.gnu.org: Windows 7 or 8 [fuzzy] X-Received-From: 104.47.36.67 Subject: [Qemu-devel] [PATCH v10 8/8] 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+patchwork-qemu-devel=patchwork.kernel.org@nongnu.org Sender: "Qemu-devel" X-Virus-Scanned: ClamAV using ClamSMTP Signed-off-by: Alistair Francis Reviewed-by: Peter Maydell --- 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 | 81 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 81 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..cbb57f7 --- /dev/null +++ b/docs/generic-loader.txt @@ -0,0 +1,81 @@ +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 sepcified the default address space is + used. + +For all values both hex and decimal values are allowed. 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. + - This will cause the CPU to be reset and the PC to be set to + the value of addr. + +For all values both hex and decimal values are allowed. 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=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 + CPUs address space. + - Forces the file to be treated as a raw image. This can be + used to specify the load address of ELF files. + +For all values both hex and decimal values are allowed. 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