Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 1AEB3C43334 for ; Sun, 12 Jun 2022 22:15:32 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 8252884453; Mon, 13 Jun 2022 00:14:41 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=gmail.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=gmail.com header.i=@gmail.com header.b="oJqZf3VV"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id E15C38443E; Mon, 13 Jun 2022 00:14:25 +0200 (CEST) Received: from mail-qv1-xf31.google.com (mail-qv1-xf31.google.com [IPv6:2607:f8b0:4864:20::f31]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id F2F5684425 for ; Mon, 13 Jun 2022 00:14:21 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=seanga2@gmail.com Received: by mail-qv1-xf31.google.com with SMTP id q104so3278459qvq.8 for ; Sun, 12 Jun 2022 15:14:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=vfqcb1S0LWjkN2ffcXYF5PqfJml+Lv1FoHA9d/U1+Qs=; b=oJqZf3VVgACnQwvZZoiuTOeE59BLdRH1r2vkdDN9gYz3JHzgMEhgAUb+Fio4Pq4pP0 p7adoKP/03OUi+lRfxwpYuRKYQ2gHPwhJamBK6deznPqLrzdvZj5zKeAEFvuQWMFgQP0 nPkvaN/wFCU3+EQKeWVnkZB8sQj4Er7lhCuK0wmXUU/pdkpXHkMzul3SZn3f/+aJVJV6 Fyq3+SyN4u9wgL5sw0dZxQ5v6+XMS4hx0A2mWvW9umM5jjrzEBkcdhspq2Eb1EiNQf0K 4Wf61ZegncPe3e93jlYQ5KiykXQetpGKDxfPEPxM7Fazl+ipmDYBKfj51RvWYg8vYnVO pwrg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=vfqcb1S0LWjkN2ffcXYF5PqfJml+Lv1FoHA9d/U1+Qs=; b=RUpcy8ri2zz1fwZkvPCZMAGZhxAh66XvtIxuiAkWhmzBqypWUVdBT5Dj2EJDn0oWO6 EmLHuAPQohrCnne6SDe1+/KElufWpOYufkaiKJpOwi+DuezGTHGM93Mk4nHm5TAg75jE 9iBId30KYJuD/j46RePMHAoxjyFdxGYM/POeC0QIy75bUgFvlb6yvsyXr87Z37JyZgcV gSiVcj/OuwWnOZbOgqP8l7E7TaXFnrvUqdpS1TzUvVira3eGZ3v5hZRJqX7jGM2Hu8zo at9vl7rJ45kYxbNMMvykHS/IAdyTHVnYkkInspkkXVDtnAHPxq94k7lEcAGhy/fYflzj qlxg== X-Gm-Message-State: AOAM530WfBe1uGwwFlVaIXyfogXTgwz5wAvTqYmzozft9LSF07uQ3RvD h3C4japYqcZYqesuEPGSeJM+sekc8gjWgmdM X-Google-Smtp-Source: ABdhPJwSmeG3hBqh/ULFWCzmuUMpeyVY1wNbKTDIRJH/qImVtoLVAuXHNbQktiAjC177W0TxSZ1oAg== X-Received: by 2002:ad4:594a:0:b0:46b:8c02:5dc0 with SMTP id eo10-20020ad4594a000000b0046b8c025dc0mr30186900qvb.74.1655072060464; Sun, 12 Jun 2022 15:14:20 -0700 (PDT) Received: from localhost (pool-173-73-95-180.washdc.fios.verizon.net. [173.73.95.180]) by smtp.gmail.com with UTF8SMTPSA id t4-20020a05622a01c400b00304ef50af9fsm3911880qtw.2.2022.06.12.15.14.19 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 12 Jun 2022 15:14:20 -0700 (PDT) From: Sean Anderson To: u-boot@lists.denx.de, Heinrich Schuchardt Cc: Simon Glass , Sean Anderson Subject: [PATCH v2 06/14] doc: mkimage: Rearrange/remove some options Date: Sun, 12 Jun 2022 18:14:03 -0400 Message-Id: <20220612221411.1608406-7-seanga2@gmail.com> X-Mailer: git-send-email 2.35.1 In-Reply-To: <20220612221411.1608406-1-seanga2@gmail.com> References: <20220612221411.1608406-1-seanga2@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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 This moves some options which work in any mode to the general options section. -p is moved to after -E/-B since those options are related. This also adds documentation for -h and -V. The -F, -l, and -G options are documented twice. Remove the second documentation in each case. The synopsis for -l also suggests an implied second uimage-file-name parameter. E.g. mkimage [-l uimage-file-name] uimage-file-name This is misleading, so remove it. Wrap a few lines to 80 characters as well. Signed-off-by: Sean Anderson --- Changes in v2: - Document -h and -V - Rearrange more options doc/mkimage.1 | 62 ++++++++++++++++++++++++--------------------------- 1 file changed, 29 insertions(+), 33 deletions(-) diff --git a/doc/mkimage.1 b/doc/mkimage.1 index 8b96011f90..6c649f6cbf 100644 --- a/doc/mkimage.1 +++ b/doc/mkimage.1 @@ -54,8 +54,18 @@ supports verified boot. .SS General options . .TP -.BI \-l " uimage-file-name" -mkimage lists the information contained in the header of an existing U-Boot image. +.B \-h +Print a help message and exit. +. +.TP +.B \-l +mkimage lists the information contained in the header of an existing U-Boot +image. +. +.TP +.B \-s +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 \-T " image-type" @@ -65,13 +75,22 @@ Without this option image type is autodetected. . .TP .B \-q -Quiet. Don't print the image header on successful verification. +Quiet. Don't print the image header. +. +.TP +.B \-v +Verbose. Print file names as they are added to the image. +. +.TP +.B \-V +Print version information and exit. . .SS Options for creating legacy or \(lqauto\(rq images . .TP .BI \-A " architecture" -Set architecture. Pass \-h as the architecture to see the list of supported architectures. +Set architecture. Pass \-h as the architecture to see the list of supported +architectures. . .TP .BI \-O " os" @@ -79,11 +98,6 @@ Set operating system. bootm command of u-boot changes boot method by os type. Pass \-h as the OS to see the list of supported OS. . .TP -.BI \-T " image-type" -Set image type. -Pass \-h as the image to see the list of supported image type. -. -.TP .BI \-C " compression-type" Set compression type. Pass \-h as the compression to see the list of supported compression type. @@ -97,10 +111,6 @@ Set load address with a hex number. Set entry point with a hex number. . .TP -.B \-l -List the contents of an image. -. -.TP .BI \-n " image-name" Set image name to 'image name'. . @@ -141,15 +151,6 @@ Use image data from 'image data file'. .B \-x Set XIP (execute in place) flag. . -.TP -.B \-s -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 -.B \-v -Verbose. Print file names as they are added to the image. -. .SS Options for creating FIT images . .TP @@ -182,6 +183,12 @@ The alignment, in hexadecimal, that external data will be aligned to. This option only has an effect when \-E is specified. . .TP +.BI \-p " external-position" +Place external data at a static external position. See \-E. Instead of writing +a 'data-offset' property defining the offset from the end of the FIT, \-p will +use 'data-position' as the absolute position from the base of the FIT. +. +.TP .BI \-f " image-tree-source-file" Image tree source file that describes the structure and contents of the FIT image. @@ -222,11 +229,6 @@ verification. Typically the file here is the device tree binary used by CONFIG_OF_CONTROL in U-Boot. . .TP -.BI \-G " key-file" -Specifies the private key file to use when signing. This option may be used -instead of \-k. -. -.TP .BI \-g " key-name-hint" Sets the key-name-hint property when used with \-f auto. This is the part of the key. The directory part is set by \-k. This option also indicates @@ -239,12 +241,6 @@ Specifies the algorithm to be used for signing a FIT image. The default is taken from the signature node's 'algo' property. . .TP -.BI \-p " external-position" -Place external data at a static external position. See \-E. Instead of writing -a 'data-offset' property defining the offset from the end of the FIT, \-p will -use 'data-position' as the absolute position from the base of the FIT. -. -.TP .B \-r Specifies that keys used to sign the FIT are required. This means that they must be verified for the image to boot. Without this option, the verification -- 2.35.1