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 0A01CC433EF for ; Sat, 25 Jun 2022 17:15:00 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 251D9844D8; Sat, 25 Jun 2022 19:13: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=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="ZtrUa6G+"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id B438C84479; Sat, 25 Jun 2022 19:12:43 +0200 (CEST) Received: from mail-qk1-x72b.google.com (mail-qk1-x72b.google.com [IPv6:2607:f8b0:4864:20::72b]) (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 6C64184477 for ; Sat, 25 Jun 2022 19:12:39 +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-qk1-x72b.google.com with SMTP id u124so4160195qkb.12 for ; Sat, 25 Jun 2022 10:12:39 -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=LXF8jfefcmxNgAEP9GQ2fX9kdSpPKcarfs7Yq3ZVRT8=; b=ZtrUa6G+0e1optnWIoySQE8mz/JFTSDcTosgwCasiRPLIoG6Jtd2r5B6lxcsybX3I0 F+0URx3mFABjjkrr3yqnOOeNHmcc1SrRLuXSxMduHao4xiSOYwj+7XL+gu1/T//1o5rI cEq9urrEUyeXsDWPFJc9TwgmWRqoqMPpbKpD0RkL1l1WYow7lhvKs9v+YG5cCs6vnhgV RZd+jyao5hp6cUeQyoqQDegdIPcEKVAQoR2t14s05WsoSt1VhhdzZUB7uMmloChKux/l RTcqXFk1ZxJXvW+xJseJavsDepvWdymGZr0HJZipt8UP2pUln6HTVfh/G49hrN58j6XG Jwlw== 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=LXF8jfefcmxNgAEP9GQ2fX9kdSpPKcarfs7Yq3ZVRT8=; b=cueGAszPm/C8od5DFpyW0whPPAqRuVJLOCuGL/ELlHHnfZs3ni81X7hkJdEuiOCCS/ 32Z+zaooR8roEW5qefckzp6Uh6bp2o2EWNl8Jq0ULPDVe98LIDVg0zDKImFzT/Fd2+Un q3sq7qx/Dezzdoxv5boAGUOvJYlj2hdg2hYPXLJLLe3q+fhHOfEh3RDbxcNjbiLKtzkh f1MENXyofMRtTtGxlvAeezn3yEwlVHFZ4M95/ajSG4mTIbiLuFdTPkYrjQec/jdLrrj3 REi6BgCfEsMkRdfIPBj2kPC5ico3IyuSYNMe2nvNQgTdM566wLGhyEYIcEJ3ojrr/KA3 +QKA== X-Gm-Message-State: AJIora+pQZPqaV6M4AsRt3y4WbblnE/ciYnmryUjNS1LjQTlb/VXPu6b +XwY4jJHqCitYUZ5hJeLHnpQwZYWwTh99uRz X-Google-Smtp-Source: AGRyM1tqoVy8cHGtd+l0FARCuAT7rwztu5pDdedhIOhMZEoINpZpL91AA9nSOYQOfjfJUmZ9NdC3bQ== X-Received: by 2002:ae9:e209:0:b0:6af:122:b34e with SMTP id c9-20020ae9e209000000b006af0122b34emr3440502qkc.126.1656177157968; Sat, 25 Jun 2022 10:12:37 -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 k20-20020a05620a07f400b006a6ab259261sm4089563qkk.29.2022.06.25.10.12.37 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sat, 25 Jun 2022 10:12:37 -0700 (PDT) From: Sean Anderson To: u-boot@lists.denx.de, Heinrich Schuchardt Cc: Simon Glass , Sean Anderson Subject: [PATCH v3 14/14] doc: Add man page for dumpimage Date: Sat, 25 Jun 2022 13:12:21 -0400 Message-Id: <20220625171221.2391284-15-seanga2@gmail.com> X-Mailer: git-send-email 2.35.1 In-Reply-To: <20220625171221.2391284-1-seanga2@gmail.com> References: <20220625171221.2391284-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.6 at phobos.denx.de X-Virus-Status: Clean This tool seems a bit underloved. Unfortunately, it seems to be missing support for FIT images. Alas... Add a man page documenting it. The example is taken from commit a804b5ce2d ("Add dumpimage, a tool to extract data from U-Boot images"). Signed-off-by: Sean Anderson --- (no changes since v2) Changes in v2: - Ensure comments are requests doc/dumpimage.1 | 103 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 doc/dumpimage.1 diff --git a/doc/dumpimage.1 b/doc/dumpimage.1 new file mode 100644 index 0000000000..52a45a3404 --- /dev/null +++ b/doc/dumpimage.1 @@ -0,0 +1,103 @@ +.\" SPDX-License-Identifier: GPL-2.0 +.\" Copyright (C) 2022 Sean Anderson +.TH DUMPIMAGE 1 2022-06-11 U-Boot +.SH NAME +dumpimage \- extract data from U-Boot images +. +.SH SYNOPSIS +.SY dumpimage +.OP \-T type +.BI \-l\~ image +.YS +.SY dumpimage +.OP \-T type +.OP \-p position +.BI \-o\~ outfile +.I image +.YS +.SY dumpimage +.B \-h +.YS +.SY dumpimage +.B \-V +.YS +. +.SH DESCRIPTION +.B dumpimage +lists and extracts data from U-Boot images. If +.B \-l +is specified, +.B dumpimage +lists the components in +.IR image . +Otherwise, +.B dumpimage +extracts the component at +.IR position " to " outfile . +. +.SH OPTIONS +.TP +.B \-h +Print usage information and exit. +. +.TP +.B \-l +Print the header information for +.IR image , +including a list of components. +. +.TP +.BI \-o " outfile" +The file to write the dumped component to. +.TP +.BI \-p " position" +Specify the +.I position +of the component to dump. This should be a numeric index, starting at 0. If not +specified, the default +.I position +is 0. +. +.TP +.BI \-T " type" +Specify the +.I type +of the image. If not specified, the image type will be automatically detected. A +list of supported image types may be printed by running +.BR "mkimage\~\-T\~list" . +. +.TP +.B \-V +Print version information and exit. +. +.SH BUGS +Please report bugs to the +.UR https://\:source\:.denx\:.de/\:u-boot/\:u-boot/\:issues +U-Boot bug tracker +.UE . +.SH EXAMPLES +Create a multi-file image and then extract part of that image +.PP +.EX +.in +4 +$ \c +.B mkimage \-A x86 \-O linux \-T multi \-n x86 \\\\\& +.in +4 +.B \-d vmlinuz:initrd.img:System.map multi.img +.in +Image Name: x86 +Created: Thu Jul 25 10:29:13 2013 +Image Type: Intel x86 Linux Multi-File Image (gzip compressed) +Data Size: 13722956 Bytes = 13401.32 kB = 13.09 MB +Load Address: 00000000 +Entry Point: 00000000 +Contents: + Image 0: 4040128 Bytes = 3945.44 kB = 3.85 MB + Image 1: 7991719 Bytes = 7804.41 kB = 7.62 MB + Image 2: 1691092 Bytes = 1651.46 kB = 1.61 MB +$ \c +.B dumpimage -p 2 -o System.map multi.img +.EE +.in +.SH SEE ALSO +.BR mkimage (1) -- 2.35.1