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 28AA0C433EF for ; Sun, 12 Jun 2022 04:20:47 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 7A26184410; Sun, 12 Jun 2022 06:20:20 +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="fmh8bON4"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id AB16984420; Sun, 12 Jun 2022 06:20:09 +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 AA9DE84411 for ; Sun, 12 Jun 2022 06:20:05 +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 a9so2301712qvt.6 for ; Sat, 11 Jun 2022 21:20:05 -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=Grh9Jx6RV0YUH52qJ66H0z76aIXOjQetvuupAeKz6KY=; b=fmh8bON4IVg4oEmDTytA9XhXM4OkEPpUi4rIVNah53au8dB9lOaA6+zKZd9Ux9IKKu UykOmiak5FkpljcStBU1lYkJp2InAxPJB5xhYcEKiHtUm2lp8QjcFpSrc7DTPzPiu9aK bZmEVeLBuXNALVjp0RYGUlsExscmyB17/e+0kltnSpDdVpOpfh+TwYPP8aLttuK/eEIW fmWg7m04v4d3OvnLqkT66upwwdafUTNEbmT9coDVbPzryGAK7osfxMH4agrFImxuM+Vn F3FbOWULVMDrPtAPKj/iA5V0G9oCjHYK4Yp2W/ab6rYNiccT5G7mYoNEDHYNpW2v5vAC NgQw== 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=Grh9Jx6RV0YUH52qJ66H0z76aIXOjQetvuupAeKz6KY=; b=bsgiNn9QzXpRtq4ZwfClzmEuPDrtQrFOQ3XkFON4NGUvh4wEQl2xn1GVqNbKLXqpSq wU3XHYbMWgEeTceaxsUgaWp3ce7V82cf6H2IzYJVjBAVBIyX9quA13fSgj0EvRlRW4J3 OoW0yMoampGwnkzBSQSyBBo6KSAy0bwnkXHtkoW6xP7v9CUE4JOBkjZRHzuegVXRVI+0 LNkkI6EsDzRMdjMGMXeTh+WdpuX43DAuAVHXR+ofKwCSxVV03eACJnm08bxzuam8HEkm 8s6ooEhSl5HO0JhYc5lBbw4ch1XplQ24l8hrAVX1j9AkWvRdsnW68dwY36N162APPUkG hdlg== X-Gm-Message-State: AOAM530BjUoPryg8++W8G7LwYNFyuBXkIGjlGNy8TYkXNaVMD0eorytr p6IYYfMJ625R8famWwa9DCdgmuKxilDT2FDN X-Google-Smtp-Source: ABdhPJx3yi0uH2vH+udW6P0wKqCM0lMnigyPQijGTBcIFi9pyVxSIFZZwylk9S2Bbdo4vYlF7dvvjA== X-Received: by 2002:a05:6214:4103:b0:46e:34e9:5034 with SMTP id kc3-20020a056214410300b0046e34e95034mr655261qvb.0.1655007604019; Sat, 11 Jun 2022 21:20:04 -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 d135-20020a37688d000000b006a6b0be0cfesm3237913qkc.10.2022.06.11.21.20.03 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sat, 11 Jun 2022 21:20:03 -0700 (PDT) From: Sean Anderson To: u-boot@lists.denx.de, Heinrich Schuchardt Cc: Simon Glass , Sean Anderson Subject: [PATCH 03/12] doc: mkimage: Add vertical/horizontal space to examples Date: Sun, 12 Jun 2022 00:19:50 -0400 Message-Id: <20220612041959.1538628-4-seanga2@gmail.com> X-Mailer: git-send-email 2.35.1 In-Reply-To: <20220612041959.1538628-1-seanga2@gmail.com> References: <20220612041959.1538628-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 puts each example in a new paragraph and uses a hanging indent for continued lines to increase clarity. Signed-off-by: Sean Anderson --- doc/mkimage.1 | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/doc/mkimage.1 b/doc/mkimage.1 index 5ae3d92508..b9ca416101 100644 --- a/doc/mkimage.1 +++ b/doc/mkimage.1 @@ -269,76 +269,111 @@ using the -f flag. But if the original input to mkimage is a binary file .SH EXAMPLES . List image information: +.P .nf +.in +4n .B mkimage -l uImage .fi +.in .P Create legacy image with compressed PowerPC Linux kernel: +.P .nf +.in +4n .B mkimage -A powerpc -O linux -T kernel -C gzip \\\\ .br +.in +4n .B -a 0 -e 0 -n Linux -d vmlinux.gz uImage .fi +.in .P Create FIT image with compressed PowerPC Linux kernel: +.P .nf +.in +4n .B mkimage -f kernel.its kernel.itb .fi +.in .P Create FIT image with compressed kernel and sign it with keys in the /public/signing-keys directory. Add corresponding public keys into u-boot.dtb, skipping those for which keys cannot be found. Also add a comment. +.P .nf +.in +4n .B mkimage -f kernel.its -k /public/signing-keys -K u-boot.dtb \\\\ .br +.in +4n .B -c """Kernel 3.8 image for production devices""" kernel.itb .fi +.in . .P Add public keys to u-boot.dtb without needing a FIT to sign. This will also create a FIT containing an images node with no data named unused.itb. +.P .nf +.in +4n .B mkimage -f auto -d /dev/null -k /public/signing-keys -g dev \\\\ .br +.in +4n .B -o sha256,rsa2048 -K u-boot.dtb unused.itb .fi +.in . .P Update an existing FIT image, signing it with additional keys. Add corresponding public keys into u-boot.dtb. This will resign all images with keys that are available in the new directory. Images that request signing with unavailable keys are skipped. +.P .nf +.in +4n .B mkimage -F -k /secret/signing-keys -K u-boot.dtb \\\\ .br +.in +4n .B -c """Kernel 3.8 image for production devices""" kernel.itb .fi +.in . .P Create a FIT image containing a kernel, using automatic mode. No .its file is required. +.P .nf +.in +4n .B mkimage -f auto -A arm -O linux -T kernel -C none -a 43e00000 -e 0 \\\\ .br +.in +4n .B -c """Kernel 4.4 image for production devices""" -d vmlinuz kernel.itb .fi +.in .P Create a FIT image containing a kernel and some device tree files, using automatic mode. No .its file is required. +.P .nf +.in +4n .B mkimage -f auto -A arm -O linux -T kernel -C none -a 43e00000 -e 0 \\\\ .br +.in +4n .B -c """Kernel 4.4 image for production devices""" -d vmlinuz \\\\ +.br .B -b /path/to/rk3288-firefly.dtb -b /path/to/rk3288-jerry.dtb kernel.itb .fi +.in .P Create a FIT image containing a signed kernel, using automatic mode. No .its file is required. +.P .nf +.in +4n .B mkimage -f auto -A arm -O linux -T kernel -C none -a 43e00000 -e 0 \\\\ .br +.in +4n .B -d vmlinuz -k /secret/signing-keys -g dev -o sha256,rsa2048 kernel.itb .fi +.in . .SH HOMEPAGE http://www.denx.de/wiki/U-Boot/WebHome -- 2.35.1