Mercurial > hg > Members > kono > nitros9-code
comparison 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 |
comparison
equal
deleted
inserted
replaced
| 137:a6eb496dbc1e | 138:d9631713b7cd |
|---|---|
| 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> | |
| 9 <command>DUMP</command> | |
| 10 <arg choice="opt"> | |
| 11 &replstart;path&replend; | |
| 12 </arg> | |
| 13 </cmdsynopsis> | |
| 14 </refsynopsisdiv> | |
| 15 | |
| 16 <refsect1><title>Description</title> | |
| 17 <para> | |
| 18 This command produces a formatted display of the physical data | |
| 19 contents of the path specified which may be a mass storage file or | |
| 20 any other I/O device. If a pathlist is omitted, the standard input | |
| 21 path is used. The output is written to standard output. This command is | |
| 22 commonly used to examine the contents of non-text files. | |
| 23 </para> | |
| 24 <para> | |
| 25 The data is displayed 16 bytes per line in both hexadecimal and | |
| 26 ASCII character format. Data bytes that have non-displayable values | |
| 27 are represented by periods in the character area. | |
| 28 </para> | |
| 29 <para> | |
| 30 The addresses displayed on the dump are relative to the beginning of | |
| 31 the file. Because memory modules are position-independent and stored | |
| 32 on files exactly as they exist in memory, the addresses shown on the | |
| 33 dump correspond to the relative load addresses of memory-module | |
| 34 files. | |
| 35 </para> | |
| 36 </refsect1> | |
| 37 <refsect1><title>Examples</title> | |
| 38 <screen> | |
| 39 DUMP (display keyboard input in hex) | |
| 40 DUMP myfile >/P (dump myfile to printer) | |
| 41 DUMP shortfile | |
| 42 </screen> | |
| 43 </refsect1> | |
| 44 | |
| 45 <refsect1><title>Sample Output</title> | |
| 46 <screen> | |
| 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 | |
| 48 ---- ---- ---- ---- ---- ---- ---- ---- ---- ---------------- | |
| 49 0000 87CD 0038 002A P181 2800 2E00 3103 FFE0 .M.8.*q.(...1..' | |
| 50 0010 0418 0000 0100 0101 0001 1808 180D 1B04 ................ | |
| 51 0020 0117 0311 0807 1500 002A 5445 S2CD 5343 .........*TERMSC | |
| 52 0030 C641 4349 C10E 529E FACIA.R. | |
| 53 | |
| 54 ^ ^ ^ | |
| 55 | |
| 56 starting data bytes in hexadecimal data bytes in | |
| 57 address format ASCII format | |
| 58 </screen> | |
| 59 </refsect1> | |
| 60 </refentry> | |
| 61 |