diff docs/nitros9guide/dump.refentry @ 138:d9631713b7cd

Split up the commands into individual files.
author roug
date Sun, 07 Jul 2002 08:58:56 +0000
parents
children c565a4700689
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/nitros9guide/dump.refentry	Sun Jul 07 08:58:56 2002 +0000
@@ -0,0 +1,61 @@
+<refentry id="dump">
+<refnamediv>
+<refname>DUMP</refname>
+<refpurpose>Formatted File Data Dump in Hexadecimal and ASCII</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>DUMP</command>
+<arg choice="opt">
+  &replstart;path&replend;
+</arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+This command produces a formatted display of the physical data
+contents of the path specified which may be a mass storage file or
+any other I/O device. If a pathlist is omitted, the standard input
+path is used. The output is written to standard output. This command is
+commonly used to examine the contents of non-text files.
+</para>
+<para>
+The data is displayed 16 bytes per line in both hexadecimal and
+ASCII character format. Data bytes that have non-displayable values
+are represented by periods in the character area.
+</para>
+<para>
+The addresses displayed on the dump are relative to the beginning of
+the file. Because memory modules are position-independent and stored
+on files exactly as they exist in memory, the addresses shown on the
+dump correspond to the relative load addresses of memory-module
+files.
+</para>
+</refsect1>
+<refsect1><title>Examples</title>
+<screen>
+DUMP              (display keyboard input in hex)
+DUMP myfile &gt;/P   (dump myfile to printer)
+DUMP shortfile
+</screen>
+</refsect1>
+
+<refsect1><title>Sample Output</title>
+<screen>
+   Addr  0 1  2 3  4 5  6 7  8 9  A B  C D  E F   0 2 4 6 8 A C E
+   ---- ---- ---- ---- ---- ---- ---- ---- ----  ----------------
+   0000 87CD 0038 002A P181 2800 2E00 3103 FFE0  .M.8.*q.(...1..'
+   0010 0418 0000 0100 0101 0001 1808 180D 1B04  ................
+   0020 0117 0311 0807 1500 002A 5445 S2CD 5343  .........*TERMSC
+   0030 C641 4349 C10E 529E                      FACIA.R.
+
+    ^                     ^                              ^
+
+starting       data bytes in hexadecimal           data bytes in
+address                format                      ASCII format
+</screen>
+</refsect1>
+</refentry>
+