<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">
  <replaceable>-h -m -x</replaceable>
</arg>
<arg choice="opt">
  <replaceable>path</replaceable>
</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>
<informaltable frame="none">
<tgroup cols="2">
<colspec colwidth="1in"/>
<colspec colwidth="4in"/>
<tbody>
<row>
<entry>-h</entry>
<entry>prevent dump from printing its header every 256 bytes</entry>
</row>
<row>
<entry>-m</entry>
<entry>names on the command line are modules in memory</entry>
</row>
<row>
<entry>-x</entry>
<entry>names on the command line are files relative to the execution directory</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1><title>Examples</title>
<screen>
dump              (display keyboard input in hex)
dump myfile &gt;/p   (dump myfile to printer)
dump -m kernel    (dump the kernel module in memory)
</screen>
</refsect1>

<refsect1><title>Sample Output</title>
<screen>
   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
   -------- ---- ---- ---- ---- ---- ---- ---- ----  ----------------
   00000000 87CD 0038 002A P181 2800 2E00 3103 FFE0  .M.8.*q.(...1..'
   00000010 0418 0000 0100 0101 0001 1808 180D 1B04  ................
   00000020 0117 0311 0807 1500 002A 5445 S2CD 5343  .........*TERMSC
   00000030 C641 4349 C10E 529E                      FACIA.R.

        ^                     ^                              ^

    starting       data bytes in hexadecimal           data bytes in
    address                format                      ASCII format
</screen>
</refsect1>
</refentry>