Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/dump.refentry @ 2322:61fb37b19edd
Edition #3 - for vtio instead of cc3io Willard Goosey
| author | aaronwolfe |
|---|---|
| date | Mon, 11 Jan 2010 04:20:41 +0000 |
| parents | b00cf13c9f61 |
| children |
| rev | line source |
|---|---|
| 138 | 1 <refentry id="dump"> |
| 2 <refnamediv> | |
| 3 <refname>DUMP</refname> | |
| 4 <refpurpose>Formatted File Data Dump in Hexadecimal and ASCII</refpurpose> | |
| 5 </refnamediv> | |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 9 <command>dump</command> |
| 138 | 10 <arg choice="opt"> |
| 1500 | 11 <replaceable>-h -m -x</replaceable> |
| 12 </arg> | |
| 13 <arg choice="opt"> | |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
138
diff
changeset
|
14 <replaceable>path</replaceable> |
| 138 | 15 </arg> |
| 16 </cmdsynopsis> | |
| 17 </refsynopsisdiv> | |
| 18 | |
| 19 <refsect1><title>Description</title> | |
| 20 <para> | |
| 21 This command produces a formatted display of the physical data | |
| 22 contents of the path specified which may be a mass storage file or | |
| 23 any other I/O device. If a pathlist is omitted, the standard input | |
| 24 path is used. The output is written to standard output. This command is | |
| 25 commonly used to examine the contents of non-text files. | |
| 26 </para> | |
| 27 <para> | |
| 28 The data is displayed 16 bytes per line in both hexadecimal and | |
| 29 ASCII character format. Data bytes that have non-displayable values | |
| 30 are represented by periods in the character area. | |
| 31 </para> | |
| 32 <para> | |
| 33 The addresses displayed on the dump are relative to the beginning of | |
| 34 the file. Because memory modules are position-independent and stored | |
| 35 on files exactly as they exist in memory, the addresses shown on the | |
| 36 dump correspond to the relative load addresses of memory-module | |
| 37 files. | |
| 38 </para> | |
| 1500 | 39 <informaltable frame="none"> |
| 40 <tgroup cols="2"> | |
| 41 <colspec colwidth="1in"/> | |
| 42 <colspec colwidth="4in"/> | |
| 43 <tbody> | |
| 44 <row> | |
| 45 <entry>-h</entry> | |
| 46 <entry>prevent dump from printing its header every 256 bytes</entry> | |
| 47 </row> | |
| 48 <row> | |
| 49 <entry>-m</entry> | |
| 50 <entry>names on the command line are modules in memory</entry> | |
| 51 </row> | |
| 52 <row> | |
| 53 <entry>-x</entry> | |
| 54 <entry>names on the command line are files relative to the execution directory</entry> | |
| 55 </row> | |
| 56 </tbody> | |
| 57 </tgroup> | |
| 58 </informaltable> | |
| 138 | 59 </refsect1> |
| 1500 | 60 |
| 138 | 61 <refsect1><title>Examples</title> |
| 62 <screen> | |
| 1500 | 63 dump (display keyboard input in hex) |
| 64 dump myfile >/p (dump myfile to printer) | |
| 65 dump -m kernel (dump the kernel module in memory) | |
| 138 | 66 </screen> |
| 67 </refsect1> | |
| 68 | |
| 69 <refsect1><title>Sample Output</title> | |
| 70 <screen> | |
| 1500 | 71 Address 0 1 2 3 4 5 6 7 8 9 A B C D E F 0 2 4 6 8 A C E |
| 72 -------- ---- ---- ---- ---- ---- ---- ---- ---- ---------------- | |
| 73 00000000 87CD 0038 002A P181 2800 2E00 3103 FFE0 .M.8.*q.(...1..' | |
| 74 00000010 0418 0000 0100 0101 0001 1808 180D 1B04 ................ | |
| 75 00000020 0117 0311 0807 1500 002A 5445 S2CD 5343 .........*TERMSC | |
| 76 00000030 C641 4349 C10E 529E FACIA.R. | |
| 138 | 77 |
| 1500 | 78 ^ ^ ^ |
| 138 | 79 |
| 1500 | 80 starting data bytes in hexadecimal data bytes in |
| 81 address format ASCII format | |
| 138 | 82 </screen> |
| 83 </refsect1> | |
| 84 </refentry> | |
| 85 |