version 1.9, 1999/07/21 12:43:26 |
version 1.10, 2000/03/07 21:11:10 |
|
|
.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 |
.Pq Dq \&# |
.Pq Ql # |
are ignored. |
are ignored. |
.It Fl n Ar length |
.It Fl n Ar length |
Interpret only |
Interpret only |
|
|
option, any number of groups of output lines, which would be |
option, any number of groups of output lines, which would be |
identical to the immediately preceding group of output lines (except |
identical to the immediately preceding group of output lines (except |
for the input offsets), are replaced with a line comprised of a |
for the input offsets), are replaced with a line comprised of a |
single asterisk. |
single asterisk |
|
.Pq Ql * . |
.It Fl x |
.It Fl x |
.Em Two-byte hexadecimal display . |
.Em Two-byte hexadecimal display . |
Display the input offset in hexadecimal, followed by eight, space |
Display the input offset in hexadecimal, followed by eight, space |
|
|
each iteration of the format. |
each iteration of the format. |
.Pp |
.Pp |
If an iteration count and/or a byte count is specified, a single slash |
If an iteration count and/or a byte count is specified, a single slash |
|
.Pq Sq / |
must be placed after the iteration count and/or before the byte count |
must be placed after the iteration count and/or before the byte count |
to disambiguate them. |
to disambiguate them. |
Any whitespace before or after the slash is ignored. |
Any whitespace before or after the slash is ignored. |
.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. |
.Pq \&"\& \&" |
|
marks. |
It is interpreted as an 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 |
|
|
.It |
.It |
A byte count or field precision |
A byte count or field precision |
.Em is |
.Em is |
required for each ``s'' conversion |
required for each |
character (unlike the |
.Sq s |
|
conversion character (unlike the |
.Xr fprintf 3 |
.Xr fprintf 3 |
default which prints the entire string if the precision is unspecified). |
default which prints the entire string if the precision is unspecified). |
.It |
.It |
The conversion characters ``h'', ``n'', and ``p'' are not |
The conversion characters |
supported. |
.Sq h , |
|
.Sq n , |
|
and |
|
.Sq p |
|
are not supported. |
.It |
.It |
The single character escape sequences |
The single character escape sequences |
described in the C standard are supported: |
described in the C standard are supported: |
|
|
which are displayed as two character strings. |
which are displayed as two character strings. |
.It Cm _p |
.It Cm _p |
Output characters in the default character set. |
Output characters in the default character set. |
Nonprinting characters are displayed as a single |
Nonprinting characters are displayed as a single dot |
.Dq Cm \&. . |
.Ql \&. . |
.It Cm _u |
.It Cm _u |
Output US ASCII characters, with the exception that control characters are |
Output US ASCII characters, with the exception that control characters are |
displayed using the following, lower-case, names. |
displayed using the following, lower-case, names. |
|
|
byte count, or the iteration count times the number of bytes required by |
byte count, or the iteration count times the number of bytes required by |
the format if the byte count is not specified. |
the format if the byte count is not specified. |
.Pp |
.Pp |
The input is manipulated in ``blocks'', where a block is defined as the |
The input is manipulated in |
|
.Dq blocks , |
|
where a block is defined as the |
largest amount of data specified by any format string. |
largest amount of data specified by any format string. |
Format strings interpreting less than an input block's worth of data, |
Format strings interpreting less than an input block's worth of data, |
whose last format unit both interprets some number of bytes and does |
whose last format unit both interprets some number of bytes and does |
|
|
conversion character with the same field width |
conversion character with the same field width |
and precision as the original conversion character or conversion |
and precision as the original conversion character or conversion |
string but with any |
string but with any |
.Dq Li \&+ , |
.Ql + , |
.Dq \&\ \& , |
.Ql \&\ \& , |
.Dq Li \&# |
.Ql # |
conversion flag characters |
conversion flag characters |
removed, and referencing a NULL string. |
removed, and referencing a NULL string. |
.Pp |
.Pp |
|
|
"%07.7_Ax\en" |
"%07.7_Ax\en" |
"%07.7_ax " 8/2 "%04x " "\en" |
"%07.7_ax " 8/2 "%04x " "\en" |
.Ed |
.Ed |
|
.Sh SEE ALSO |
|
.Xr od 1 |
.Sh STANDARDS |
.Sh STANDARDS |
The |
The |
.Nm |
.Nm |