From patchwork Mon May 16 20:11:07 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sean Anderson X-Patchwork-Id: 1631826 X-Patchwork-Delegate: trini@ti.com Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=seco.com header.i=@seco.com header.a=rsa-sha256 header.s=selector1 header.b=0L3AiQRT; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de (client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; helo=phobos.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Received: from phobos.denx.de (phobos.denx.de [IPv6:2a01:238:438b:c500:173d:9f52:ddab:ee01]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by bilbo.ozlabs.org (Postfix) with ESMTPS id 4L29Pp1lTFz9s5V for ; Tue, 17 May 2022 06:11:42 +1000 (AEST) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 933C484191; Mon, 16 May 2022 22:11:26 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=reject dis=none) header.from=seco.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (2048-bit key; unprotected) header.d=seco.com header.i=@seco.com header.b="0L3AiQRT"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 1F7E4841CB; Mon, 16 May 2022 22:11:24 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_PASS,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.2 Received: from EUR05-DB8-obe.outbound.protection.outlook.com (mail-db8eur05on20630.outbound.protection.outlook.com [IPv6:2a01:111:f400:7e1a::630]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id BB604841F3 for ; Mon, 16 May 2022 22:11:19 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=reject dis=none) header.from=seco.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=sean.anderson@seco.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=B7jn5cI8JiN7ehRYhYoiPjf8/n7PKaCHdqIRf1Y2RDfXwKYiE0ny6PcN6xtzImJyn+kQoFeeITjKexzn/XusiZRz+oIp2tPI8cx4wJnoSqgxKnjG9s4WQ+z+GpYVAdxqkw9BoGV0DgEnflaQzDUeYbiGu+jaqu2IiyKneNxUNq+mTNszTEANAqYAlVyFT4cluaDgqKYhuGHR66q7s3HHyyZlHcWnKpT/7vM3vkyEPID+AKNGf2DPKZVtRVh4FSzPVh6HOgW+eEbZTpail5gglcDeVMO1qlqjzWH0PX/5Zp6blIfv6d4B0WRmqwQx0U+1xbJyfim0+YfBCMDDuNpxhA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=NDXDqLXBSR/bjSw4AJXD/vEis/UEtE1DaEeSGn+rotA=; b=lM1ZZkpzWnk9HRIAF0BiSyceUn+hLvuth/+fCM5/JrkHdeZE49jEgyg6g2Rb5nAGTD7YQ9bOvODtfPYQWwnXz4Fk+lnSBAAzw7mA1t+Rrp3cPDwTefsu4BmWFrjiFjynNXvGibx3k36WcJvpmL84K1knzacZw7wz4MJatejBfuchauGy3lXIMeH0eBC3FrnXBT2NYQoaqaBhLmFT7+4DcZNPjW9DEhGyg2q+yvCRvFs1qPBzURNq+fMsfgW/pDB6GF5wPtNh5MlWdwxgVaNA7ZW23Y2wTYmHuOINtOEIQfJv9A4XHYLY75LBY7v9RcNXlucVTRs4gL+D96YsW9GlvQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=seco.com; dmarc=pass action=none header.from=seco.com; dkim=pass header.d=seco.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=seco.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=NDXDqLXBSR/bjSw4AJXD/vEis/UEtE1DaEeSGn+rotA=; b=0L3AiQRTr8mZbcs4cVXxDtEmsnij0xaTxrpD/iRXpUP8XuuKKMH3CyngoALfrvPXNykkBEkQ77aq5+0bC+SzyGsv/y3Idxxkb/sLQa8rdTCHT4lxJOKo6qRywdAlCjMl795aeMLQ/WS1p9EOkV47HNPv4k2uJXQBA7c/FrYrxQ4r26pufkdKfN+ue/3voFIXAMSUUMf0jUUnwcgNIa4RfH/L3hIl0C+KZCOJgvG8ERQjeaAFOCzDAcHZC+mCUYuQY4BaNzG8OLrMUvhtJ72e0KGZqSQNmx5ytO18SLp2MSDZiEnwCyKltaU89q9SrNES8xy3OYJhDnaZQGVklIOV6w== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=seco.com; Received: from DB7PR03MB4972.eurprd03.prod.outlook.com (2603:10a6:10:7d::22) by DB7PR03MB3595.eurprd03.prod.outlook.com (2603:10a6:5:5::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5250.18; Mon, 16 May 2022 20:11:18 +0000 Received: from DB7PR03MB4972.eurprd03.prod.outlook.com ([fe80::cc0b:c665:8330:89bc]) by DB7PR03MB4972.eurprd03.prod.outlook.com ([fe80::cc0b:c665:8330:89bc%3]) with mapi id 15.20.5250.018; Mon, 16 May 2022 20:11:17 +0000 From: Sean Anderson To: Simon Glass , u-boot@lists.denx.de Cc: Heinrich Schuchardt , Sean Anderson Subject: [PATCH v3 1/2] mkimage: Document more misc options Date: Mon, 16 May 2022 16:11:07 -0400 Message-Id: <20220516201108.4070444-1-sean.anderson@seco.com> X-Mailer: git-send-email 2.35.1.1320.gc452695387.dirty X-ClientProxiedBy: MN2PR19CA0071.namprd19.prod.outlook.com (2603:10b6:208:19b::48) To DB7PR03MB4972.eurprd03.prod.outlook.com (2603:10a6:10:7d::22) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: f496385c-1139-461d-cd8e-08da37783c81 X-MS-TrafficTypeDiagnostic: DB7PR03MB3595:EE_ X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: brmv+GLHxEzGeeCKLp7kdouTo4eCbcBwX0RzlxnDYpqTf8J2idCy0EbLGy3P+0LoggtAHLm7uNRSbSSXw1g3xVtfEn/ZDXSiemzN5JjiJh147PSKRPjXAep09g16uvNsZm5e9RP4KTk9ameJdveggaXU4U63cKOFI/GcJHVWG/+h9B0cPlHQ+v3BmrwJaJQhh5/KNeYToXLYtjMKw6Xdu4nOmbXs53zJzzmEXN6k7G7WMEC39N0EWpSDJnTZTxjaouMoqVF8OV158Psxotl6j1gkYl/7+qk+2qX+50usA3dC0psRNLIMhjEs+daPFmdZCereV1hCbIJqaIzLXzkuPtYBe+Bja6dN+z3GYMVQBNV/8nRcCvIEl9EV9YgtpoavKlU6Mf278wk+FS+HGHMYaPmG9uv0MQJ5JUVOq5Ph1KVze9LIupv7/qIgRwCIZLdgcPbBO/+GaFke80mSAj4cRH6jCmR9Zmdom2QZF0P8cPlbOg29Sw6DaPqPNLMzY9nk+570Z0ZAE5yXN2iSXX/dQnNczSJkb7rWcE584EkyeOuwesm+cWzbf+9fQhJwRaV2+QHF4tjYY/wqOMpyMIbkjCactbN6/dKCWRAikgezuKfNfv6cP36g/s2rzc21tPXT+Ha8j6QQBkI4pWy3y0v4Z4KxRlUFZEE17iKdUZnBGGAQS3nKPeLH+SlBhDJ0y8jKSRkrttJcI0Wix2GtgyKuQg== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DB7PR03MB4972.eurprd03.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230001)(366004)(66946007)(8676002)(4326008)(66556008)(66476007)(6666004)(2616005)(38350700002)(38100700002)(86362001)(83380400001)(8936002)(5660300002)(107886003)(1076003)(186003)(6506007)(36756003)(6512007)(6486002)(26005)(52116002)(2906002)(44832011)(508600001)(54906003)(316002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: j0IC3dbKJy3+WZuzC+iLtlsG9wTDK/BtsorlZl4YYldZNhSpAhpwgljiTsj8x0Ix/o5P6RO2gpD99olx0dxVFV+vckbBgq97WNsLJDR7gg7mdasBhOWHm/xGHOeP8jMfdP0gUcQtg0hA1iNLwzzIzjJH5awssVjsGvD25aMPOvwazvwjlw0Pu6Wpx6v5TZTg54kRD8n597rJcT5DXFJtvLuvpLYw2186Mzh+YnmLjXNrDkqjI2lPLWLJWeE93CWfP9oqPCXVavvysIZH0TWA7ltUu04sNCe2Y1o1fLu/CsZEmBwJUYAFsvAYNsxh5p+xA3yONSTF7dgLMYZZkODZchEJI8Pn3uoWydvi+6PSUD8ZcnB4PZH/2nTfR3gV/dW4C7Vwsl7FKF3Sz4FkzRGmYo3LAREVJfNlkPy/117KOkXFK5KXOu+jy/vhf+2jC+gL1XkdFk5jDkY06GDkphoL1VYcK32N5SuEY56QPsgW7C5qMZ2eX3AEFqvzlJ3tmymEGzlQP89j9VL7SnYl+Lureid3ueKi4/5Lw+0kPsma1izzaXrR6SZcJAPTG5kAJugdMrbx16qfavKkrw4yTdFeb/X2GbdhKOIfItyqubgWyXko1e3BsT0XoADt5n8UHZRnWWiwr+H7fCCmKgRTRFJ7W6qdsBV7w0Zybac4w/Bj/KA0xYcxc3GokVklZJBa2CMc2w97fg8622v0g/01/LFZE4VRDB+l8NjmdIOHU4fGx+h+oEElvUs5Oqx2VJEe8zfHDszY6ax7fJJstMgZy3uaexeEkoEXNpPFkaW7/KbNdvVX5rXwvVyUBF6nU0qUkBrW6p/hTn6jq57Se3mod6pCzkK8r92tWGaJwP9PsqnefeBylUB8rY65naz7UgUN+rL7rrTVeDD070rLpr03NnU1DDHR4FsK31ECWS+b+1h9vN6QsqgWDAm93O80T/7u2hgx8eLfB1S5uLqYX9tcMiBJ/KmsU7WFU9jOKhh83iope2/vsD+wJt2ZlZ36hgXMSto/O9Gg2dpPjW1mIAja06lbHuadehh3AnXyHWUsC/Em2vrI6/KbjFvykLdE56fLUqWYMwV0Q9daCMvWq7X+3D0y+NwZyz844luXBbmCulmzYMLZP3aRV6yNU9WmnF2xvOpUow/WfRmEC1Xo2p/6e5/0WnZCv/ONo0UP/jAVoo6/ihXcYor+pCWuwHuSL09TDwUrkJ1icp5vuNG8se0wVdAU8OxcZmHHh63OpbD0RWb2Lde6eyCUgFEEBl2hEtovydyFLyXPXzbkgwUCXL9IWWvulUjxJsE91u79xT734d+PiFdZm0Mb4OlMbxo/8keOWDBrfHnkLJrIgMExyTKchNoDahl9zREagusszBIE1qL6EXmn6ERDJRM7hw/Ci61kv+xc+3ASgtI0knOLd/9zSSJKPAmAvNix6Dq3nl7xx4KZhxVDB37w+fzZ/mQcZufEbbzgPS2FcRQE7XS8kBgm9sl+K5sa0fzdY5ZVTi7oiryXnfLzmhhpsSJK/i9WPQXan1w/+3GyFgV6+5bP60bAsGbBOm/1+OeKU1aHTPJtSKBhg+NhB5Yg4SS+EsImAkNRTijSqzwtmDMViLt1fFzobbFGoBLPI4dfoNgOaN/Ux7IPI1wVNUkDtnth1cpnAw2aJ+jAmJ33YMLrDaMdPnjkn84NACr3VZOWT0GghNscjZsSA6hwRZXsOAxI0Dvyzu8NJdGuGc7RCYDo8B0MAwJ13pYQ3JOWQN35WzTGyRsRQOy1H20= X-OriginatorOrg: seco.com X-MS-Exchange-CrossTenant-Network-Message-Id: f496385c-1139-461d-cd8e-08da37783c81 X-MS-Exchange-CrossTenant-AuthSource: DB7PR03MB4972.eurprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 May 2022 20:11:17.8183 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: bebe97c3-6438-442e-ade3-ff17aa50e733 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: WWbukDj4bJmiJ0Gz0mBhi0hb/Z4B3A3O958pK6NQObwc3yiZtQkPOyndOMXHbQr4PQCyhklt71s4nljavp2HIw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR03MB3595 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.5 at phobos.denx.de X-Virus-Status: Clean Document -G and the secondary image types which can be used with -R. Also reword the documentation of -s for clarity. Signed-off-by: Sean Anderson --- Changes in v3: - Rebased onto u-boot/master, as v1 was applied instead of v2 - Reworded commit message to reflect this Changes in v2: - Document secondary image types - Move -G directly after -k - Reword documentation for -s doc/mkimage.1 | 33 +++++++++++++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/doc/mkimage.1 b/doc/mkimage.1 index c92e133732..878db90475 100644 --- a/doc/mkimage.1 +++ b/doc/mkimage.1 @@ -99,6 +99,30 @@ Set image name to 'image name'. .BI "\-R [" "secondary image name" "]" Some image types support a second image for additional data. For these types, use \-R to specify this second image. +.TS +allbox; +lb lbx +l l. +Image Type Secondary Image Description +pblimage Additional RCW-style header, typically used for PBI commands. +zynqimage, zynqmpimage T{ +Initialization parameters, one per line. Each parameter has the form +.sp +.ti 4 +.I address data +.sp +where +.I address +and +.I data +are hexadecimal integers. The boot ROM will write each +.I data +to +.I address +when loading the image. At most 256 parameters may be specified in this +manner. +T} +.TE .TP .BI "\-d [" "image data file" "]" @@ -110,8 +134,8 @@ Set XIP (execute in place) flag. .TP .BI "\-s" -Create an image with no data. The header will be created, but the image itself -will not contain data (such as U-Boot or any specified kernel). +Don't copy in the image data. Depending on the image type, this may create +just the header, everything but the image data, or nothing at all. .TP .BI "\-v" @@ -176,6 +200,11 @@ Specifies the directory containing keys to use for signing. This directory should contain a private key file .key for use with signing and a certificate .crt (containing the public key) for use with verification. +.TP +.BI "\-G [" "key_file" "]" +Specifies the private key file to use when signing. This option may be used +instead of \-k. + .TP .BI "\-K [" "key_destination" "]" Specifies a compiled device tree binary file (typically .dtb) to write