From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.90_1) id 1qOjam-0005Rt-4Q for mharc-grub-devel@gnu.org; Wed, 26 Jul 2023 14:50:36 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qOjah-0005RI-HM for grub-devel@gnu.org; Wed, 26 Jul 2023 14:50:32 -0400 Received: from mail-vk1-xa30.google.com ([2607:f8b0:4864:20::a30]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qOjaf-00040o-Kz for grub-devel@gnu.org; Wed, 26 Jul 2023 14:50:31 -0400 Received: by mail-vk1-xa30.google.com with SMTP id 71dfb90a1353d-4864992dc37so50979e0c.3 for ; Wed, 26 Jul 2023 11:50:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=efficientek-com.20221208.gappssmtp.com; s=20221208; t=1690397428; x=1691002228; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=PnySSwHZxpjq6PVf50MhRDphR9nFeY5xUtoKAaasrXk=; b=ATaTzcgHziLMm5h4guZboNLoarVasy7VLm904nBQ2BqUQy9x7ctaYlHBcQ41zxPr9a R3zFWhM4hYwS5+7kSDsKgesPhESnHA6JS62V3PPn5QN5i4JC9hGB4NCe+44R2exk4nLC 5WvSgciSMlolBsSO26cH7UP2wm8U/lLwO2tOOpBbmYr7xUxd70GpL+YXZNkSkAZ8dApn y7aaKhbVNI5UkT8Hr05zF1YZs7fAAxueJhA9jXplgu7WSFChGrm03vSJtUzYFUUIs/6p 2hzxEWsjbxgkkorrosyuvJDZviufPIVTkjRGOkezmhgY3KfXWuQH+X+1ibNV112iDbx7 D0hw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1690397428; x=1691002228; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=PnySSwHZxpjq6PVf50MhRDphR9nFeY5xUtoKAaasrXk=; b=YUVCOLIyYvlQAW8jzyFW6G+hzb69naZX/0HLa/oIXbNo3P5saJICkNza6qzq3XV3nS 9G/G0Duu9UtSQzgsIOPXkIKCQsAyWD3OmDqzk9c97ZDuwtTayoRSPZD9bjnpgAho0Md+ yHn7HlFxFZzy4cjgLhBJZ3kHkCrog0i0J+1otU+4hykyBqc2mi2wdO7vJCTGGuJQbiIv 1Vk9o+yh2p8tVrWqBtLpgoL75pkDL3URAzHyDF3+NQlQeL04lVEPl/fMG0AS+C6yfsQm h+Ai6l6TgatQdoE43O3ClnY6QQnes/4kjzKzTpDf5eIXT4ngW66lQPnZxpqf8TZXQxBZ XNIQ== X-Gm-Message-State: ABy/qLZl7JPuwwpxFBynPqe0Ezs63m/NRkbyMvcQspCIApSXStiG4EI2 nOlQIohealFVfz8kZe5T/bedoWq14mkR7kdYi30= X-Google-Smtp-Source: APBJJlF6pEU0t/2KchDSBzpBpMbVqYmJUG3D5/w3oNUjnqcYJZhIPunz8eyNTm7yHkN7CguB8gZHEQ== X-Received: by 2002:a1f:41c9:0:b0:46e:7158:1cf0 with SMTP id o192-20020a1f41c9000000b0046e71581cf0mr1516541vka.10.1690397428117; Wed, 26 Jul 2023 11:50:28 -0700 (PDT) Received: from localhost.localdomain ([37.218.244.249]) by smtp.gmail.com with ESMTPSA id m24-20020ac5c218000000b00481830391a0sm2153670vkk.34.2023.07.26.11.50.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 26 Jul 2023 11:50:27 -0700 (PDT) From: Glenn Washburn To: grub-devel@gnu.org, Daniel Kiper Cc: Glenn Washburn Subject: [PATCH 1/2] docs: Document hexdump command Date: Wed, 26 Jul 2023 13:50:11 -0500 Message-Id: X-Mailer: git-send-email 2.34.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2607:f8b0:4864:20::a30; envelope-from=development@efficientek.com; helo=mail-vk1-xa30.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 26 Jul 2023 18:50:32 -0000 Signed-off-by: Glenn Washburn --- docs/grub.texi | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/grub.texi b/docs/grub.texi index dae10621b99f..5f6f0895ef4f 100644 --- a/docs/grub.texi +++ b/docs/grub.texi @@ -4361,6 +4361,7 @@ you forget a command, you can run the command @command{help} * halt:: Shut down your computer * hashsum:: Compute or check hash checksum * help:: Show help messages +* hexdump:: Show raw contents of a file or memory * insmod:: Insert a module * keystatus:: Check key modifier status * list_env:: List variables in environment block @@ -4979,6 +4980,20 @@ about each of the commands whose names begin with those @var{patterns}. @end deffn +@node hexdump +@subsection hexdump + +@deffn Command hexdump [--skip offset] [--length len] FILE_OR_DEVICE +Show raw contents of a file or memory. When option @option{--skip} is given, +@samp{offset} number of bytes are skipped from the start of the device or +file given. And @option{--length} allows specifying a maximum number of bytes +to be shown. + +If given the special device named @samp{(mem)}, then the @samp{offset} given to +@option{--skip} is treated as the address of a memory location to dump from. +@end deffn + + @node insmod @subsection insmod @@ -6170,7 +6185,6 @@ GRUB shell may provide more information on parameters and usage. @item @command{gdbstub} - Start GDB stub on given port @item @command{gdbstub_stop} - Stop GDB stub @item @command{hdparm} - Get/set ATA disk parameters. -@item @command{hexdump} - Show raw contents of a file or memory. @item @command{hexdump_random} - Hexdump random data. @item @command{inb} - Read 8-bit value from PORT. @item @command{inl} - Read 32-bit value from PORT. -- 2.34.1