Mercurial > hg > Members > kono > nitros9-code

annotate docs/nitros9guide/dump.refentry @ 1093:4dae346c4969

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added crossreferences and lowercased synopsises
author roug
date Mon, 07 Apr 2003 21:01:46 +0000
parents c565a4700689
children b00cf13c9f61
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>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 975
diff changeset
9 <command>dump</command>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="opt">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 138
diff changeset
11 <replaceable>path</replaceable>
138
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