version 1.4, 1997/09/02 15:31:51 |
version 1.5, 1998/09/26 19:54:51 |
|
|
.Bk -words |
.Bk -words |
.Op Fl s Ar skip |
.Op Fl s Ar skip |
.Ek |
.Ek |
.Ar file ... |
.Ar file Op Ar ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The hexdump utility is a filter which displays the specified files, or |
The |
the standard input, if no files are specified, in a user specified |
.Nm hexdump |
|
utility is a filter which displays the specified files, or |
|
the standard input, if no files are specified, in a user-specified |
format. |
format. |
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
|
|
space-separated, three column, space-filled, characters of input |
space-separated, three column, space-filled, characters of input |
data per line. |
data per line. |
.It Fl d |
.It Fl d |
.Em Two-byte decimal display. |
.Em Two-byte decimal display . |
Display the input offset in hexadecimal, followed by eight |
Display the input offset in hexadecimal, followed by eight |
space-separated, five column, zero-filled, two-byte units |
space-separated, five column, zero-filled, two-byte units |
of input data, in unsigned decimal, per line. |
of input data, in unsigned decimal, per line. |
|
|
.It Fl f Ar format_file |
.It Fl f Ar format_file |
Specify a file that contains one or more newline separated format strings. |
Specify a file that contains one or more newline separated format strings. |
Empty lines and lines whose first non-blank character is a hash mark |
Empty lines and lines whose first non-blank character is a hash mark |
.Pf ( Cm \&# ) |
.Pq Dq \&# |
are ignored. |
are ignored. |
.It Fl n Ar length |
.It Fl n Ar length |
Interpret only |
Interpret only |
|
|
.Pp |
.Pp |
The format is required and must be surrounded by double quote |
The format is required and must be surrounded by double quote |
(" ") marks. |
(" ") marks. |
It is interpreted as a fprintf-style format string (see |
It is interpreted as an fprintf-style format string (see |
.Xr fprintf 3 ) , |
.Xr fprintf 3 ) , |
with the |
with the |
following exceptions: |
following exceptions: |
|
|
.Ed |
.Ed |
.El |
.El |
.Pp |
.Pp |
Hexdump also supports the following additional conversion strings: |
.Nm hexdump |
|
also supports the following additional conversion strings: |
.Bl -tag -width Fl |
.Bl -tag -width Fl |
.It Cm \&_a Ns Op Cm dox |
.It Cm \&_a Ns Op Cm dox |
Display the input offset, cumulative across input files, of the |
Display the input offset, cumulative across input files, of the |
|
|
option. |
option. |
.Pp |
.Pp |
.Nm hexdump |
.Nm hexdump |
exits 0 on success and >0 if an error occurred. |
exits 0 on success or >0 if an error occurred. |
.Sh EXAMPLES |
.Sh EXAMPLES |
Display the input in perusal format: |
Display the input in perusal format: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |