~ubuntu-branches/ubuntu/trusty/util-linux/trusty-proposed

« back to all changes in this revision

Viewing changes to text-utils/hexdump.1

  • Committer: Package Import Robot
  • Author(s): LaMont Jones
  • Date: 2011-11-03 15:38:23 UTC
  • mto: (4.5.5 sid) (1.6.4)
  • mto: This revision was merged to the branch mainline in revision 85.
  • Revision ID: package-import@ubuntu.com-20111103153823-10sx16jprzxlhkqf
ImportĀ upstreamĀ versionĀ 2.20.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
31
31
.\"
32
32
.\"     from: @(#)hexdump.1     8.2 (Berkeley) 4/18/94
33
33
.\"
34
 
.Dd April 18, 1994
35
 
.Dt HEXDUMP 1
36
 
.Os
 
34
.Dd July 2009 "  "
 
35
.Dt HEXDUMP(1) "" "User Commands"
 
36
.Os util-linux
37
37
.Sh NAME
38
38
.Nm hexdump
39
 
.Nd ascii, decimal, hexadecimal, octal dump
 
39
.Nd display file contents in ascii, decimal, hexadecimal, or octal
40
40
.Sh SYNOPSIS
41
41
.Nm
42
42
.Op Fl bcCdovx
54
54
.Ek
55
55
.Ar file ...
56
56
.Sh DESCRIPTION
57
 
The hexdump utility is a filter which displays the specified files, or
58
 
the standard input, if no files are specified, in a user specified
 
57
The
 
58
.Nm
 
59
utility is a filter which displays the specified files, or
 
60
standard input if no files are specified, in a user-specified
59
61
format.
60
62
.Pp
61
63
The options are as follows:
63
65
.It Fl b
64
66
.Em One-byte octal display .
65
67
Display the input offset in hexadecimal, followed by sixteen
66
 
space-separated, three column, zero-filled, bytes of input data,
 
68
space-separated, three-column, zero-filled bytes of input data,
67
69
in octal, per line.
68
70
.It Fl c
69
71
.Em One-byte character display .
70
72
Display the input offset in hexadecimal, followed by sixteen
71
 
space-separated, three column, space-filled, characters of input
 
73
space-separated, three-column, space-filled characters of input
72
74
data per line.
73
75
.It Fl C
74
76
.Em Canonical hex+ASCII display .
75
77
Display the input offset in hexadecimal, followed by sixteen
76
 
space-separated, two column, hexadecimal bytes, followed by the
 
78
space-separated, two-column, hexadecimal bytes, followed by the
77
79
same sixteen bytes in %_p format enclosed in ``|'' characters.
78
80
.It Fl d
79
81
.Em Two-byte decimal display .
80
82
Display the input offset in hexadecimal, followed by eight
81
 
space-separated, five column, zero-filled, two-byte units
 
83
space-separated, five-column, zero-filled, two-byte units
82
84
of input data, in unsigned decimal, per line.
83
85
.It Fl e Ar format_string
84
86
Specify a format string to be used for displaying data.
94
96
.It Fl o
95
97
.Em Two-byte octal display .
96
98
Display the input offset in hexadecimal, followed by eight
97
 
space-separated, six column, zero-filled, two byte quantities of
 
99
space-separated, six-column, zero-filled, two-byte quantities of
98
100
input data, in octal, per line.
99
101
.It Fl s Ar offset
100
102
Skip
129
131
.It Fl v
130
132
The
131
133
.Fl v
132
 
option causes hexdump to display all input data.
 
134
option causes
 
135
.Nm
 
136
to display all input data.
133
137
Without the
134
138
.Fl v
135
 
option, any number of groups of output lines, which would be
 
139
option, any number of groups of output lines which would be
136
140
identical to the immediately preceding group of output lines (except
137
141
for the input offsets), are replaced with a line comprised of a
138
142
single asterisk.
139
143
.It Fl x
140
144
.Em Two-byte hexadecimal display .
141
 
Display the input offset in hexadecimal, followed by eight, space
142
 
separated, four column, zero-filled, two-byte quantities of input
143
 
data, in hexadecimal, per line.
 
145
Display the input offset in hexadecimal, followed by eight
 
146
space-separated, four-column, zero-filled, two-byte quantities of
 
147
input data, in hexadecimal, per line.
144
148
.El
145
149
.Pp
146
150
For each input file,
206
210
.Ed
207
211
.El
208
212
.Pp
209
 
Hexdump also supports the following additional conversion strings:
 
213
The
 
214
.Nm
 
215
utility also supports the following additional conversion strings:
210
216
.Bl -tag -width Fl
211
217
.It Cm \&_a Ns Op Cm dox
212
218
Display the input offset, cumulative across input files, of the
225
231
once, when all of the input data has been processed.
226
232
.It Cm \&_c
227
233
Output characters in the default character set.
228
 
Nonprinting characters are displayed in three character, zero-padded
 
234
Nonprinting characters are displayed in three-character, zero-padded
229
235
octal, except for those representable by standard escape notation
230
236
(see above),
231
 
which are displayed as two character strings.
 
237
which are displayed as two-character strings.
232
238
.It Cm _p
233
239
Output characters in the default character set.
234
240
Nonprinting characters are displayed as a single
278
284
incremented until the entire input block has been processed or there
279
285
is not enough data remaining in the block to satisfy the format string.
280
286
.Pp
281
 
If, either as a result of user specification or hexdump modifying
282
 
the iteration count as described above, an iteration count is
 
287
If, either as a result of user specification or
 
288
.Nm
 
289
modifying the iteration count as described above, an iteration count is
283
290
greater than one, no trailing whitespace characters are output
284
291
during the last iteration.
285
292
.Pp