Mercurial > hg > Members > kono > nitros9-code

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Split up the commands into individual files.
author roug
date Sun, 07 Jul 2002 08:58:56 +0000
parents
children c565a4700689
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="dump">
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname>DUMP</refname>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Formatted File Data Dump in Hexadecimal and ASCII</refpurpose>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
6
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
9 <command>DUMP</command>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="opt">
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
11 &replstart;path&replend;
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
13 </cmdsynopsis>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
14 </refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
15
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
16 <refsect1><title>Description</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
17 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
18 This command produces a formatted display of the physical data
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
19 contents of the path specified which may be a mass storage file or
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
20 any other I/O device. If a pathlist is omitted, the standard input
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
21 path is used. The output is written to standard output. This command is
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
22 commonly used to examine the contents of non-text files.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
23 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
24 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
25 The data is displayed 16 bytes per line in both hexadecimal and
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
26 ASCII character format. Data bytes that have non-displayable values
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
27 are represented by periods in the character area.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
28 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
29 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
30 The addresses displayed on the dump are relative to the beginning of
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
31 the file. Because memory modules are position-independent and stored
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
32 on files exactly as they exist in memory, the addresses shown on the
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
33 dump correspond to the relative load addresses of memory-module
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
34 files.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
35 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
36 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
37 <refsect1><title>Examples</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
38 <screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
39 DUMP (display keyboard input in hex)
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
40 DUMP myfile &gt;/P (dump myfile to printer)
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
41 DUMP shortfile
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
42 </screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
43 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
44
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
45 <refsect1><title>Sample Output</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
46 <screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
47 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
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
48 ---- ---- ---- ---- ---- ---- ---- ---- ---- ----------------
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
49 0000 87CD 0038 002A P181 2800 2E00 3103 FFE0 .M.8.*q.(...1..'
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
50 0010 0418 0000 0100 0101 0001 1808 180D 1B04 ................
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
51 0020 0117 0311 0807 1500 002A 5445 S2CD 5343 .........*TERMSC
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
52 0030 C641 4349 C10E 529E FACIA.R.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
53
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
54 ^ ^ ^
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
55
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
56 starting data bytes in hexadecimal data bytes in
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
57 address format ASCII format
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
58 </screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
59 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
60 </refentry>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
61